voice-mode 4.3.1__tar.gz → 4.4.0__tar.gz

{voice_mode-4.3.1 → voice_mode-4.4.0}/CHANGELOG.md

@@ -7,10 +7,65 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [4.4.0] - 2025-09-10
+
+### Added
+- **MCP Registry Support**
+  - Add server.json configuration for MCP registry publication
+  - Add mcp-name field to README for PyPI package validation
+  - Integrate MCP registry publishing into CI/CD workflow
+  - Support DNS-based namespace authentication (com.failmode/voicemode)
+  - Update Makefile to sync server.json version during releases
+  
+- **Cloudflare Worker for voicemode.sh**
+  - Serve install script via custom domain
+  - Smart user-agent detection for CLI vs browser
+  - Cached script delivery with fallback
+  
+- **Selective Tool Loading**
+  - Reduce token usage by loading tools on demand
+  - Implement smart tool filtering based on context
+  - Add tool loading configuration options
+
+- **Documentation Improvements**
+  - Complete documentation reorganization
+  - Add tutorials, guides, and reference sections
+  - Improve getting-started guide with clear paths
+  - Add universal installer as primary quick start
+  - Archive outdated documentation
+
+- **Three Bears Agent Support**
+  - Add baby-bear, mama-bear, and papa-bear agent configurations
+  - Integrate with sound fonts for agent-specific audio feedback
+
+### Changed
+- Consolidate PyPI and MCP Registry publishing workflows
+- Update branch references from 'main' to 'master'
+- Improve Cloudflare Worker error handling and caching
+- Rename hook to hooks, stdin-receiver to receiver
+
+### Fixed
+- Fix broken documentation links after refactor
+- Restore minimal claude command group for hook support
+- Fix Claude settings.json path configuration
+
+## [4.3.2] - 2025-09-03
+
+### Fixed
+- Add missing pyyaml dependency to pyproject.toml
+- Remove macOS-only restriction from package
+- Add Claude hooks configuration to repository settings
+
 ## [4.3.1] - 2025-09-03
 
+### Fixed
+- Minor bug fixes and improvements
+
 ## [4.3.0] - 2025-09-03
 
+### Added
+- Sound fonts with MP3 support and Three Bears sounds integration
+
 ## [4.2.0] - 2025-09-03
 
 ### Added
@@ -24,7 +79,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **🔊 Sound Fonts Integration - Audio Feedback for Every Action**
   - Play custom sounds for tool operations, errors, and completions
   - Filesystem-based sound font system with automatic discovery
-  - Claude Code integration via stdin-receiver for hook-based audio
+  - Claude Code integration via receiver for hook-based audio
   - CLI command `play-sound` with theme, action, and sound selection
   - Enhances user experience with auditory feedback during operations
   - MP3 support added for 90% file size reduction over WAV

{voice_mode-4.3.1 → voice_mode-4.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: voice-mode
-Version: 4.3.1
+Version: 4.4.0
 Summary: VoiceMode - Voice interaction capabilities for AI assistants (formerly voice-mcp)
 Project-URL: Homepage, https://github.com/mbailey/voicemode
 Project-URL: Repository, https://github.com/mbailey/voicemode
@@ -33,6 +33,7 @@ Requires-Dist: numpy
 Requires-Dist: openai>=1.0.0
 Requires-Dist: psutil>=5.9.0
 Requires-Dist: pydub
+Requires-Dist: pyyaml>=6.0.0
 Requires-Dist: scipy
 Requires-Dist: setuptools
 Requires-Dist: simpleaudio
@@ -77,6 +78,8 @@ Description-Content-Type: text/markdown
 
 # Voice Mode
 
+mcp-name: com.failmode/voicemode
+
 > **Install via:** `uvx voice-mode` | `pip install voice-mode` | [getvoicemode.com](https://getvoicemode.com)
 
 [![PyPI Downloads](https://static.pepy.tech/badge/voice-mode)](https://pepy.tech/project/voice-mode)
@@ -112,7 +115,7 @@ Natural voice conversations for AI assistants. Voice Mode brings human-like voic
 
 ## Quick Start
 
-> 📖 **Using a different tool?** See our [Integration Guides](docs/integrations/README.md) for Cursor, VS Code, Gemini CLI, and more!
+> 📖 **Using a different tool?** See our [Getting Started Guide](docs/tutorials/getting-started.md) for setup instructions!
 
 ### Automatic Installation (Recommended)
 
@@ -139,7 +142,7 @@ This installer will:
 
 ### Manual Installation
 
-For manual setup steps, see the [Claude Code Integration Guide](docs/integrations/claude-code/README.md).
+For manual setup steps, see the [Getting Started Guide](docs/tutorials/getting-started.md).
 
 ## 🎬 Demo
 
@@ -179,16 +182,16 @@ The `converse` function makes voice interactions natural - it automatically wait
 
 Voice Mode works with your favorite AI coding assistants:
 
-- 🤖 **[Claude Code](docs/integrations/claude-code/README.md)** - Anthropic's official CLI
-- 🖥️ **[Claude Desktop](docs/integrations/claude-desktop/README.md)** - Desktop application
-- 🌟 **[Gemini CLI](docs/integrations/gemini-cli/README.md)** - Google's CLI tool
-- ⚡ **[Cursor](docs/integrations/cursor/README.md)** - AI-first code editor
-- 💻 **[VS Code](docs/integrations/vscode/README.md)** - With MCP preview support
-- 🦘 **[Roo Code](docs/integrations/roo-code/README.md)** - AI dev team in VS Code
-- 🔧 **[Cline](docs/integrations/cline/README.md)** - Autonomous coding agent
-- ⚡ **[Zed](docs/integrations/zed/README.md)** - High-performance editor
-- 🏄 **[Windsurf](docs/integrations/windsurf/README.md)** - Agentic IDE by Codeium
-- 🔄 **[Continue](docs/integrations/continue/README.md)** - Open-source AI assistant
+- 🤖 **Claude Code** - Anthropic's official CLI
+- 🖥️ **Claude Desktop** - Desktop application
+- 🌟 **Gemini CLI** - Google's CLI tool
+- ⚡ **Cursor** - AI-first code editor
+- 💻 **VS Code** - With MCP preview support
+- 🦘 **Roo Code** - AI dev team in VS Code
+- 🔧 **Cline** - Autonomous coding agent
+- ⚡ **Zed** - High-performance editor
+- 🏄 **Windsurf** - Agentic IDE by Codeium
+- 🔄 **Continue** - Open-source AI assistant
 
 ## Installation
 
@@ -207,7 +210,7 @@ sudo apt update
 sudo apt install -y python3-dev libasound2-dev libasound2-plugins libportaudio2 portaudio19-dev ffmpeg pulseaudio pulseaudio-utils
 ```
 
-**Note for WSL2 users**: WSL2 requires additional audio packages (pulseaudio, libasound2-plugins) for microphone access. See our [WSL2 Microphone Access Guide](docs/troubleshooting/wsl2-microphone-access.md) if you encounter issues.
+**Note for WSL2 users**: WSL2 requires additional audio packages (pulseaudio, libasound2-plugins) for microphone access.
 </details>
 
 <details>
@@ -270,7 +273,7 @@ nix run github:mbailey/voicemode
 
 ### Configuration for AI Coding Assistants
 
-> 📖 **Looking for detailed setup instructions?** Check our comprehensive [Integration Guides](docs/integrations/README.md) for step-by-step instructions for each tool!
+> 📖 **Looking for detailed setup instructions?** Check our comprehensive [Getting Started Guide](docs/tutorials/getting-started.md) for step-by-step instructions!
 
 Below are quick configuration snippets. For full installation and setup instructions, see the integration guides above.
 
@@ -548,12 +551,12 @@ nix run github:mbailey/voicemode
 
 **Note:** The `converse` tool is the primary interface for voice interactions, combining speaking and listening in a natural flow.
 
-**New:** The `install_whisper_cpp` and `install_kokoro_fastapi` tools help you set up free, private, open-source voice services locally. See [Installation Tools Documentation](docs/installation-tools.md) for detailed usage.
+**New:** The `install_whisper_cpp` and `install_kokoro_fastapi` tools help you set up free, private, open-source voice services locally.
 
 ## Configuration
 
-- 📖 **[Integration Guides](docs/integrations/README.md)** - Step-by-step setup for each tool
-- 🔧 **[Configuration Reference](docs/configuration.md)** - All environment variables
+- 📖 **[Getting Started](docs/tutorials/getting-started.md)** - Step-by-step setup guide
+- 🔧 **[Configuration Reference](docs/guides/configuration.md)** - All environment variables
 - 📁 **[Config Examples](config-examples/)** - Ready-to-use configuration files
 
 ### Quick Setup
@@ -615,8 +618,8 @@ The audio format is automatically validated against provider capabilities and wi
 
 For privacy-focused or offline usage, Voice Mode supports local speech services:
 
-- **[Whisper.cpp](docs/whisper.cpp.md)** - Local speech-to-text with OpenAI-compatible API
-- **[Kokoro](docs/kokoro.md)** - Local text-to-speech with multiple voice options
+- **[Whisper.cpp](docs/guides/whisper-setup.md)** - Local speech-to-text with OpenAI-compatible API
+- **[Kokoro](docs/guides/kokoro-setup.md)** - Local text-to-speech with multiple voice options
 
 These services provide the same API interface as OpenAI, allowing seamless switching between cloud and local processing.
 
@@ -662,7 +665,7 @@ The OpenAI SDK handles this automatically - no Voice Mode configuration needed!
 ### Common Issues
 
 - **No microphone access**: Check system permissions for terminal/application
-  - **WSL2 Users**: See [WSL2 Microphone Access Guide](docs/troubleshooting/wsl2-microphone-access.md)
+  - **WSL2 Users**: Additional audio packages (pulseaudio, libasound2-plugins) required for microphone access
 - **UV not found**: Install with `curl -LsSf https://astral.sh/uv/install.sh | sh`
 - **OpenAI API error**: Verify your `OPENAI_API_KEY` is set correctly
 - **No audio output**: Check system audio settings and available devices
@@ -702,24 +705,17 @@ Audio files are saved to: `~/.voicemode/audio/YYYY/MM/` with timestamps in the f
 📚 **[Read the full documentation at voice-mode.readthedocs.io](https://voice-mode.readthedocs.io)**
 
 ### Getting Started
-- **[Integration Guides](docs/integrations/README.md)** - Step-by-step setup for all supported tools
-- **[Configuration Guide](docs/configuration.md)** - Complete environment variable reference
+- **[Getting Started](docs/tutorials/getting-started.md)** - Step-by-step setup for all supported tools
+- **[Configuration Guide](docs/guides/configuration.md)** - Complete environment variable reference
 
 ### Development
-- **[Using uv/uvx](docs/uv.md)** - Package management with uv and uvx
-- **[Local Development](docs/local-development-uvx.md)** - Development setup guide
-- **[Audio Formats](docs/audio-format-migration.md)** - Audio format configuration and migration
-- **[Statistics Dashboard](docs/statistics-dashboard.md)** - Performance monitoring and metrics
+- **[Development Setup](docs/tutorials/development-setup.md)** - Local development guide
 
 ### Service Guides
-- **[Whisper.cpp Setup](docs/whisper.cpp.md)** - Local speech-to-text configuration
-- **[Kokoro Setup](docs/kokoro.md)** - Local text-to-speech configuration
-- **[Service Health Checks](docs/service-health-checks.md)** - Service readiness and health monitoring
-- **[LiveKit Integration](docs/livekit/README.md)** - Real-time voice communication
+- **[Whisper.cpp Setup](docs/guides/whisper-setup.md)** - Local speech-to-text configuration
+- **[Kokoro Setup](docs/guides/kokoro-setup.md)** - Local text-to-speech configuration
+- **[LiveKit Integration](docs/guides/livekit-setup.md)** - Real-time voice communication
 
-### Troubleshooting
-- **[WSL2 Microphone Access](docs/troubleshooting/wsl2-microphone-access.md)** - WSL2 audio setup
-- **[Migration Guide](docs/migration-guide.md)** - Upgrading from older versions
 
 ## Links
 
@@ -737,15 +733,12 @@ Audio files are saved to: `~/.voicemode/audio/YYYY/MM/` with timestamps in the f
 
 ## See Also
 
-- 🚀 [Integration Guides](docs/integrations/README.md) - Setup instructions for all supported tools
-- 🔧 [Configuration Reference](docs/configuration.md) - Environment variables and options
-- 🎤 [Local Services Setup](docs/kokoro.md) - Run TTS/STT locally for privacy
-- 🐛 [Troubleshooting](docs/troubleshooting/README.md) - Common issues and solutions
+- 🚀 [Getting Started](docs/tutorials/getting-started.md) - Setup instructions for all supported tools
+- 🔧 [Configuration Reference](docs/guides/configuration.md) - Environment variables and options
+- 🎤 [Local Services Setup](docs/guides/kokoro-setup.md) - Run TTS/STT locally for privacy
 
 ## License
 
 MIT - A [Failmode](https://failmode.com) Project
 
 ---
-
-<sub>[Project Statistics](docs/project-stats/README.md)</sub>

{voice_mode-4.3.1 → voice_mode-4.4.0}/README.md

@@ -1,5 +1,7 @@
 # Voice Mode
 
+mcp-name: com.failmode/voicemode
+
 > **Install via:** `uvx voice-mode` | `pip install voice-mode` | [getvoicemode.com](https://getvoicemode.com)
 
 [![PyPI Downloads](https://static.pepy.tech/badge/voice-mode)](https://pepy.tech/project/voice-mode)
@@ -35,7 +37,7 @@ Natural voice conversations for AI assistants. Voice Mode brings human-like voic
 
 ## Quick Start
 
-> 📖 **Using a different tool?** See our [Integration Guides](docs/integrations/README.md) for Cursor, VS Code, Gemini CLI, and more!
+> 📖 **Using a different tool?** See our [Getting Started Guide](docs/tutorials/getting-started.md) for setup instructions!
 
 ### Automatic Installation (Recommended)
 
@@ -62,7 +64,7 @@ This installer will:
 
 ### Manual Installation
 
-For manual setup steps, see the [Claude Code Integration Guide](docs/integrations/claude-code/README.md).
+For manual setup steps, see the [Getting Started Guide](docs/tutorials/getting-started.md).
 
 ## 🎬 Demo
 
@@ -102,16 +104,16 @@ The `converse` function makes voice interactions natural - it automatically wait
 
 Voice Mode works with your favorite AI coding assistants:
 
-- 🤖 **[Claude Code](docs/integrations/claude-code/README.md)** - Anthropic's official CLI
-- 🖥️ **[Claude Desktop](docs/integrations/claude-desktop/README.md)** - Desktop application
-- 🌟 **[Gemini CLI](docs/integrations/gemini-cli/README.md)** - Google's CLI tool
-- ⚡ **[Cursor](docs/integrations/cursor/README.md)** - AI-first code editor
-- 💻 **[VS Code](docs/integrations/vscode/README.md)** - With MCP preview support
-- 🦘 **[Roo Code](docs/integrations/roo-code/README.md)** - AI dev team in VS Code
-- 🔧 **[Cline](docs/integrations/cline/README.md)** - Autonomous coding agent
-- ⚡ **[Zed](docs/integrations/zed/README.md)** - High-performance editor
-- 🏄 **[Windsurf](docs/integrations/windsurf/README.md)** - Agentic IDE by Codeium
-- 🔄 **[Continue](docs/integrations/continue/README.md)** - Open-source AI assistant
+- 🤖 **Claude Code** - Anthropic's official CLI
+- 🖥️ **Claude Desktop** - Desktop application
+- 🌟 **Gemini CLI** - Google's CLI tool
+- ⚡ **Cursor** - AI-first code editor
+- 💻 **VS Code** - With MCP preview support
+- 🦘 **Roo Code** - AI dev team in VS Code
+- 🔧 **Cline** - Autonomous coding agent
+- ⚡ **Zed** - High-performance editor
+- 🏄 **Windsurf** - Agentic IDE by Codeium
+- 🔄 **Continue** - Open-source AI assistant
 
 ## Installation
 
@@ -130,7 +132,7 @@ sudo apt update
 sudo apt install -y python3-dev libasound2-dev libasound2-plugins libportaudio2 portaudio19-dev ffmpeg pulseaudio pulseaudio-utils
 ```
 
-**Note for WSL2 users**: WSL2 requires additional audio packages (pulseaudio, libasound2-plugins) for microphone access. See our [WSL2 Microphone Access Guide](docs/troubleshooting/wsl2-microphone-access.md) if you encounter issues.
+**Note for WSL2 users**: WSL2 requires additional audio packages (pulseaudio, libasound2-plugins) for microphone access.
 </details>
 
 <details>
@@ -193,7 +195,7 @@ nix run github:mbailey/voicemode
 
 ### Configuration for AI Coding Assistants
 
-> 📖 **Looking for detailed setup instructions?** Check our comprehensive [Integration Guides](docs/integrations/README.md) for step-by-step instructions for each tool!
+> 📖 **Looking for detailed setup instructions?** Check our comprehensive [Getting Started Guide](docs/tutorials/getting-started.md) for step-by-step instructions!
 
 Below are quick configuration snippets. For full installation and setup instructions, see the integration guides above.
 
@@ -471,12 +473,12 @@ nix run github:mbailey/voicemode
 
 **Note:** The `converse` tool is the primary interface for voice interactions, combining speaking and listening in a natural flow.
 
-**New:** The `install_whisper_cpp` and `install_kokoro_fastapi` tools help you set up free, private, open-source voice services locally. See [Installation Tools Documentation](docs/installation-tools.md) for detailed usage.
+**New:** The `install_whisper_cpp` and `install_kokoro_fastapi` tools help you set up free, private, open-source voice services locally.
 
 ## Configuration
 
-- 📖 **[Integration Guides](docs/integrations/README.md)** - Step-by-step setup for each tool
-- 🔧 **[Configuration Reference](docs/configuration.md)** - All environment variables
+- 📖 **[Getting Started](docs/tutorials/getting-started.md)** - Step-by-step setup guide
+- 🔧 **[Configuration Reference](docs/guides/configuration.md)** - All environment variables
 - 📁 **[Config Examples](config-examples/)** - Ready-to-use configuration files
 
 ### Quick Setup
@@ -538,8 +540,8 @@ The audio format is automatically validated against provider capabilities and wi
 
 For privacy-focused or offline usage, Voice Mode supports local speech services:
 
-- **[Whisper.cpp](docs/whisper.cpp.md)** - Local speech-to-text with OpenAI-compatible API
-- **[Kokoro](docs/kokoro.md)** - Local text-to-speech with multiple voice options
+- **[Whisper.cpp](docs/guides/whisper-setup.md)** - Local speech-to-text with OpenAI-compatible API
+- **[Kokoro](docs/guides/kokoro-setup.md)** - Local text-to-speech with multiple voice options
 
 These services provide the same API interface as OpenAI, allowing seamless switching between cloud and local processing.
 
@@ -585,7 +587,7 @@ The OpenAI SDK handles this automatically - no Voice Mode configuration needed!
 ### Common Issues
 
 - **No microphone access**: Check system permissions for terminal/application
-  - **WSL2 Users**: See [WSL2 Microphone Access Guide](docs/troubleshooting/wsl2-microphone-access.md)
+  - **WSL2 Users**: Additional audio packages (pulseaudio, libasound2-plugins) required for microphone access
 - **UV not found**: Install with `curl -LsSf https://astral.sh/uv/install.sh | sh`
 - **OpenAI API error**: Verify your `OPENAI_API_KEY` is set correctly
 - **No audio output**: Check system audio settings and available devices
@@ -625,24 +627,17 @@ Audio files are saved to: `~/.voicemode/audio/YYYY/MM/` with timestamps in the f
 📚 **[Read the full documentation at voice-mode.readthedocs.io](https://voice-mode.readthedocs.io)**
 
 ### Getting Started
-- **[Integration Guides](docs/integrations/README.md)** - Step-by-step setup for all supported tools
-- **[Configuration Guide](docs/configuration.md)** - Complete environment variable reference
+- **[Getting Started](docs/tutorials/getting-started.md)** - Step-by-step setup for all supported tools
+- **[Configuration Guide](docs/guides/configuration.md)** - Complete environment variable reference
 
 ### Development
-- **[Using uv/uvx](docs/uv.md)** - Package management with uv and uvx
-- **[Local Development](docs/local-development-uvx.md)** - Development setup guide
-- **[Audio Formats](docs/audio-format-migration.md)** - Audio format configuration and migration
-- **[Statistics Dashboard](docs/statistics-dashboard.md)** - Performance monitoring and metrics
+- **[Development Setup](docs/tutorials/development-setup.md)** - Local development guide
 
 ### Service Guides
-- **[Whisper.cpp Setup](docs/whisper.cpp.md)** - Local speech-to-text configuration
-- **[Kokoro Setup](docs/kokoro.md)** - Local text-to-speech configuration
-- **[Service Health Checks](docs/service-health-checks.md)** - Service readiness and health monitoring
-- **[LiveKit Integration](docs/livekit/README.md)** - Real-time voice communication
+- **[Whisper.cpp Setup](docs/guides/whisper-setup.md)** - Local speech-to-text configuration
+- **[Kokoro Setup](docs/guides/kokoro-setup.md)** - Local text-to-speech configuration
+- **[LiveKit Integration](docs/guides/livekit-setup.md)** - Real-time voice communication
 
-### Troubleshooting
-- **[WSL2 Microphone Access](docs/troubleshooting/wsl2-microphone-access.md)** - WSL2 audio setup
-- **[Migration Guide](docs/migration-guide.md)** - Upgrading from older versions
 
 ## Links
 
@@ -660,15 +655,12 @@ Audio files are saved to: `~/.voicemode/audio/YYYY/MM/` with timestamps in the f
 
 ## See Also
 
-- 🚀 [Integration Guides](docs/integrations/README.md) - Setup instructions for all supported tools
-- 🔧 [Configuration Reference](docs/configuration.md) - Environment variables and options
-- 🎤 [Local Services Setup](docs/kokoro.md) - Run TTS/STT locally for privacy
-- 🐛 [Troubleshooting](docs/troubleshooting/README.md) - Common issues and solutions
+- 🚀 [Getting Started](docs/tutorials/getting-started.md) - Setup instructions for all supported tools
+- 🔧 [Configuration Reference](docs/guides/configuration.md) - Environment variables and options
+- 🎤 [Local Services Setup](docs/guides/kokoro-setup.md) - Run TTS/STT locally for privacy
 
 ## License
 
 MIT - A [Failmode](https://failmode.com) Project
 
 ---
-
-<sub>[Project Statistics](docs/project-stats/README.md)</sub>

{voice_mode-4.3.1 → voice_mode-4.4.0}/pyproject.toml

@@ -47,6 +47,7 @@ dependencies = [
     "livekit-plugins-openai>=0.10.1",
     "livekit-plugins-silero>=0.6.5",
     "click>=8.0.0",
+    "pyyaml>=6.0.0",
 ]
 
 [project.optional-dependencies]

{voice_mode-4.3.1 → voice_mode-4.4.0}/voice_mode/__version__.py

@@ -1,3 +1,3 @@
 # This file is automatically updated by 'make release'
 # Do not edit manually
-__version__ = "4.3.1"
+__version__ = "4.4.0"

{voice_mode-4.3.1 → voice_mode-4.4.0}/voice_mode/cli.py

@@ -1394,8 +1394,9 @@ transcribe_audio_cmd = transcribe_cmd.transcribe.commands['audio']
 transcribe_audio_cmd.name = 'transcribe'
 audio.add_command(transcribe_audio_cmd)
 
-# Add hook command under claude group  
-claude.claude_group.add_command(hook_cmd.hook)
+# Add hooks command under claude group
+from voice_mode.cli_commands.hook import hooks
+claude.claude_group.add_command(hooks)
 
 # Add pronounce under config group
 config.add_command(pronounce_commands.pronounce_group)

voice_mode-4.4.0/voice_mode/cli_commands/claude.py

@@ -0,0 +1,15 @@
+"""CLI commands for Claude-related functionality."""
+
+import click
+
+
+@click.group(name='claude')
+def claude_group():
+    """Claude-related commands."""
+    pass
+
+
+@click.group(name='hooks')
+def hooks_group():
+    """Manage Voice Mode hooks and event handlers for Claude Code."""
+    pass

{voice_mode-4.3.1 → voice_mode-4.4.0}/voice_mode/cli_commands/hook.py

@@ -12,18 +12,18 @@ from typing import Optional
 
 @click.group()
 @click.help_option('-h', '--help', help='Show this message and exit')
-def hook():
+def hooks():
     """Manage Voice Mode hooks and event handlers."""
     pass
 
 
-@hook.command('stdin-receiver')
+@hooks.command('receiver')
 @click.option('--tool-name', help='Override tool name (for testing)')
 @click.option('--action', type=click.Choice(['start', 'end']), help='Override action (for testing)')
 @click.option('--subagent-type', help='Override subagent type (for testing)')
 @click.option('--event', type=click.Choice(['PreToolUse', 'PostToolUse']), help='Override event (for testing)')
 @click.option('--debug', is_flag=True, help='Enable debug output')
-def stdin_receiver(tool_name, action, subagent_type, event, debug):
+def receiver(tool_name, action, subagent_type, event, debug):
     """Receive and process hook events from Claude Code via stdin.
     
     This command reads JSON from stdin when called by Claude Code hooks,
@@ -34,13 +34,13 @@ def stdin_receiver(tool_name, action, subagent_type, event, debug):
     
     Examples:
         # Called by Claude Code (reads JSON from stdin)
-        voicemode hook stdin-receiver
+        voicemode claude hooks receiver
         
         # Testing with defaults
-        voicemode hook stdin-receiver --debug
+        voicemode claude hooks receiver --debug
         
         # Testing with specific values
-        voicemode hook stdin-receiver --tool-name Task --action start --subagent-type mama-bear
+        voicemode claude hooks receiver --tool-name Task --action start --subagent-type mama-bear
     """
     from voice_mode.tools.sound_fonts.audio_player import Player
     
@@ -188,22 +188,19 @@ def find_sound_file(event: str, tool: str, subagent: Optional[str] = None) -> Op
     return None
 
 
-# Keep the old receiver command for backwards compatibility (deprecated)
-@hook.command('receiver', hidden=True)
+# Keep the old stdin-receiver command for backwards compatibility (deprecated)
+@hooks.command('stdin-receiver', hidden=True)
 @click.argument('tool_name')
 @click.argument('action', type=click.Choice(['start', 'end', 'complete']))
 @click.argument('subagent_type', required=False)
 @click.option('--debug', is_flag=True, help='Enable debug output')
-def receiver_deprecated(tool_name, action, subagent_type, debug):
-    """[DEPRECATED] Use stdin-receiver instead."""
-    # Map old action to event
-    event = 'PreToolUse' if action == 'start' else 'PostToolUse'
-    
-    # Call the new command
+def stdin_receiver_deprecated(tool_name, action, subagent_type, event, debug):
+    """[DEPRECATED] Use receiver instead."""
+    # Call the new receiver command
     ctx = click.get_current_context()
-    ctx.invoke(stdin_receiver, 
+    ctx.invoke(receiver, 
                tool_name=tool_name,
-               action=action if action != 'complete' else 'end',
+               action=action,
                subagent_type=subagent_type,
                event=event,
                debug=debug)

voice_mode-4.4.0/voice_mode/statistics_tracking.py

@@ -0,0 +1,42 @@
+"""Statistics tracking functions used by voice tools.
+
+This module contains tracking functions that can be imported by tools
+without causing the statistics tools themselves to be loaded.
+"""
+
+from typing import Optional
+from .statistics import track_conversation
+from .config import logger
+
+
+def track_voice_interaction(message: str, 
+                           response: str,
+                           timing_str: Optional[str] = None,
+                           transport: Optional[str] = None,
+                           voice_provider: Optional[str] = None,
+                           voice_name: Optional[str] = None,
+                           model: Optional[str] = None,
+                           success: bool = True,
+                           error_message: Optional[str] = None) -> None:
+    """
+    Track a voice interaction for statistics.
+    
+    This function should be called from conversation tools to record metrics.
+    """
+    try:
+        track_conversation(
+            message=message,
+            response=response,
+            timing_str=timing_str,
+            transport=transport,
+            voice_provider=voice_provider,
+            voice_name=voice_name,
+            model=model,
+            success=success,
+            error_message=error_message
+        )
+        logger.debug(f"Tracked voice interaction: {len(message)} chars, success={success}")
+        
+    except Exception as e:
+        logger.error(f"Error tracking voice interaction: {e}")
+        # Don't raise the error - statistics tracking shouldn't break the main flow

voice_mode-4.4.0/voice_mode/tools/__init__.py

@@ -0,0 +1,50 @@
+"""Auto-import all tools for registration with FastMCP."""
+import os
+import importlib
+from pathlib import Path
+import logging
+
+logger = logging.getLogger("voice-mode")
+
+# Get the directory containing this file
+tools_dir = Path(__file__).parent
+
+# Check if we should only load specific tools
+# This can be set in .voicemode.env, shell environment, or .mcp.json
+allowed_tools = os.environ.get("VOICEMODE_TOOLS", "").strip()
+
+if allowed_tools:
+    # Only load specified tools (comma-separated list)
+    tool_list = [t.strip() for t in allowed_tools.split(",")]
+    
+    logger.info(f"Selective tool loading enabled. Loading only: {', '.join(tool_list)}")
+    
+    for tool_name in tool_list:
+        tool_file = tools_dir / f"{tool_name}.py"
+        if tool_file.exists():
+            logger.debug(f"Loading tool: {tool_name}")
+            importlib.import_module(f".{tool_name}", package=__name__)
+        else:
+            logger.warning(f"Tool module not found: {tool_name}.py")
+else:
+    # Default behavior: load all tools
+    logger.info("Loading all available tools (set VOICEMODE_TOOLS to limit)")
+    
+    # Import all Python files in this directory (except __init__.py)
+    for file in tools_dir.glob("*.py"):
+        if file.name != "__init__.py" and not file.name.startswith("_"):
+            module_name = file.stem
+            logger.debug(f"Loading tool: {module_name}")
+            importlib.import_module(f".{module_name}", package=__name__)
+
+    # Import all service tools from subdirectories
+    services_dir = tools_dir / "services"
+    if services_dir.exists():
+        for service_dir in services_dir.iterdir():
+            if service_dir.is_dir() and not service_dir.name.startswith("_"):
+                # Import all Python files in each service directory
+                for file in service_dir.glob("*.py"):
+                    if file.name != "__init__.py" and not file.name.startswith("_") and file.name != "helpers.py":
+                        module_path = f".services.{service_dir.name}.{file.stem}"
+                        logger.debug(f"Loading service tool: {module_path}")
+                        importlib.import_module(module_path, package=__name__)

{voice_mode-4.3.1 → voice_mode-4.4.0}/voice_mode/tools/converse.py

@@ -75,7 +75,7 @@ from voice_mode.core import (
     play_chime_start,
     play_chime_end
 )
-from voice_mode.tools.statistics import track_voice_interaction
+from voice_mode.statistics_tracking import track_voice_interaction
 from voice_mode.utils import (
     get_event_logger,
     log_recording_start,