devduck 1.1.5__py3-none-any.whl → 1.1.7__py3-none-any.whl

devduck/__init__.py

@@ -687,8 +687,6 @@ class DevDuck:
             server_tools_needed = []
             if servers.get("tcp", {}).get("enabled", False):
                 server_tools_needed.append("tcp")
-            if servers.get("ws", {}).get("enabled", True):
-                server_tools_needed.append("websocket")
             if servers.get("mcp", {}).get("enabled", False):
                 server_tools_needed.append("mcp_server")
             if servers.get("ipc", {}).get("enabled", False):
@@ -697,11 +695,11 @@ class DevDuck:
             # Append to default tools if any server tools are needed
             if server_tools_needed:
                 server_tools_str = ",".join(server_tools_needed)
-                default_tools = f"devduck.tools:system_prompt,fetch_github_tool,{server_tools_str};strands_tools:shell"
+                default_tools = f"devduck.tools:system_prompt,fetch_github_tool,websocket,{server_tools_str};strands_tools:shell"
                 logger.info(f"Auto-added server tools: {server_tools_str}")
             else:
                 default_tools = (
-                    "devduck.tools:system_prompt,fetch_github_tool;strands_tools:shell"
+                    "devduck.tools:system_prompt,fetch_github_tool,websocket;strands_tools:shell"
                 )
 
             tools_config = os.getenv("DEVDUCK_TOOLS", default_tools)

devduck/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '1.1.5'
-__version_tuple__ = version_tuple = (1, 1, 5)
+__version__ = version = '1.1.7'
+__version_tuple__ = version_tuple = (1, 1, 7)
 
 __commit_id__ = commit_id = None

devduck/tools/__init__.py

@@ -15,7 +15,6 @@ from .install_tools import install_tools
 from .ipc import ipc
 from .mcp_server import mcp_server
 from .scraper import scraper
-from .speech_to_speech import speech_to_speech
 from .state_manager import state_manager
 from .store_in_kb import store_in_kb
 from .system_prompt import system_prompt
@@ -24,24 +23,51 @@ from .tray import tray
 from .use_github import use_github
 from .websocket import websocket
 
-__all__ = [
-    "agentcore_agents",
-    "agentcore_config",
-    "agentcore_invoke",
-    "agentcore_logs",
-    "ambient",
-    "create_subagent",
-    "fetch_github_tool",
-    "install_tools",
-    "ipc",
-    "mcp_server",
-    "scraper",
-    "speech_to_speech",
-    "state_manager",
-    "store_in_kb",
-    "system_prompt",
-    "tcp",
-    "tray",
-    "use_github",
-    "websocket",
-]
+# Optional Tools
+try:
+    from .speech_to_speech import speech_to_speech
+
+    __all__ = [
+        "agentcore_agents",
+        "agentcore_config",
+        "agentcore_invoke",
+        "agentcore_logs",
+        "ambient",
+        "create_subagent",
+        "fetch_github_tool",
+        "install_tools",
+        "ipc",
+        "mcp_server",
+        "scraper",
+        "speech_to_speech",
+        "state_manager",
+        "store_in_kb",
+        "system_prompt",
+        "tcp",
+        "tray",
+        "use_github",
+        "websocket",
+    ]
+except ImportError:
+    __all__ = [
+        "agentcore_agents",
+        "agentcore_config",
+        "agentcore_invoke",
+        "agentcore_logs",
+        "ambient",
+        "create_subagent",
+        "fetch_github_tool",
+        "install_tools",
+        "ipc",
+        "mcp_server",
+        "scraper",
+        "state_manager",
+        "store_in_kb",
+        "system_prompt",
+        "tcp",
+        "tray",
+        "use_github",
+        "websocket",
+    ]
+
+

{devduck-1.1.5.dist-info → devduck-1.1.7.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: devduck
-Version: 1.1.5
-Summary: 🦆 Extreme minimalist self-adapting AI agent - one file, self-healing, runtime dependencies
+Version: 1.1.7
+Summary: 🦆 Self-adapting agent - one file.
 Author-email: Cagatay Cali <cagataycali@icloud.com>
 License: Apache-2.0
 Project-URL: Homepage, https://github.com/cagataycali/devduck
@@ -31,7 +31,6 @@ Requires-Dist: prompt_toolkit
 Requires-Dist: strands-agents[ollama]
 Requires-Dist: strands-agents[anthropic]
 Requires-Dist: strands-agents[openai]
-Requires-Dist: strands-agents[bidi-all]
 Requires-Dist: strands-agents[otel]
 Requires-Dist: strands-agents-tools
 Requires-Dist: beautifulsoup4
@@ -43,6 +42,8 @@ Requires-Dist: bedrock-agentcore-starter-toolkit
 Requires-Dist: bedrock-agentcore
 Requires-Dist: rumps; sys_platform == "darwin"
 Requires-Dist: strands-mlx; sys_platform == "darwin"
+Provides-Extra: speech
+Requires-Dist: strands-agents[bidi-all]; extra == "speech"
 Dynamic: license-file
 
 # 🦆 DevDuck
@@ -74,6 +75,9 @@ Learn more: https://duck.nyc
 # Install & run
 pipx install devduck && devduck
 
+# With speech-to-speech capabilities (optional)
+pipx install "devduck[speech]" && devduck
+
 # One-shot query
 devduck "create a REST API with FastAPI"
 
@@ -83,6 +87,9 @@ python -c "import devduck; devduck('analyze this code')"
 
 **Requirements:** Python 3.10-3.13, AWS credentials (or Ollama/Anthropic/GitHub/MLX)
 
+**Optional extras:**
+- `devduck[speech]` - Real-time speech-to-speech conversations (Nova Sonic, OpenAI Realtime, Gemini Live)
+
 ---
 
 ## Core Capabilities
@@ -98,6 +105,7 @@ python -c "import devduck; devduck('analyze this code')"
 | 💾 **State Time-Travel** | Save/restore agent state | `state_manager(action="export")` |
 | 📝 **Self-Improvement** | Updates own system prompt | `system_prompt(action="add_context", ...)` |
 | ☁️ **AWS Deploy** | One-command serverless | `agentcore_config(auto_launch=True)` |
+| 🎤 **Speech-to-Speech** | Real-time voice conversations | `pip install devduck[speech]` |
 
 ---
 
@@ -108,7 +116,13 @@ git clone git@github.com:cagataycali/devduck.git
 cd devduck
 python3.13 -m venv .venv
 source .venv/bin/activate
+
+# Basic install
 .venv/bin/pip3.13 install -e .
+
+# With speech capabilities
+.venv/bin/pip3.13 install -e ".[speech]"
+
 devduck
 ```
 
@@ -279,6 +293,67 @@ devduck
 
 ---
 
+## Speech-to-Speech (Optional)
+
+**Install speech capabilities:**
+```bash
+pip install "devduck[speech]"
+```
+
+**Real-time voice conversations** with multiple providers:
+
+```python
+# Start speech session with Nova Sonic (AWS Bedrock)
+speech_to_speech(action="start", provider="novasonic")
+
+# Start with OpenAI Realtime API
+speech_to_speech(action="start", provider="openai")
+
+# Start with Gemini Live
+speech_to_speech(action="start", provider="gemini_live")
+
+# Custom voice and settings
+speech_to_speech(
+    action="start",
+    provider="novasonic",
+    model_settings={
+        "provider_config": {"audio": {"voice": "matthew"}},
+        "client_config": {"region": "us-east-1"}
+    }
+)
+
+# Stop session
+speech_to_speech(action="stop", session_id="speech_20250126_140000")
+
+# Check status
+speech_to_speech(action="status")
+
+# List conversation histories
+speech_to_speech(action="list_history")
+
+# List available audio devices
+speech_to_speech(action="list_audio_devices")
+```
+
+**Supported Providers:**
+- **Nova Sonic (AWS Bedrock):** 11 voices (English, French, Italian, German, Spanish)
+- **OpenAI Realtime API:** GPT-4o Realtime models
+- **Gemini Live:** Native audio streaming
+
+**Environment Variables:**
+- `OPENAI_API_KEY` - For OpenAI Realtime
+- `GOOGLE_API_KEY` or `GEMINI_API_KEY` - For Gemini Live
+- AWS credentials - For Nova Sonic (boto3 default credential chain)
+
+**Features:**
+- Background execution (parent agent stays responsive)
+- Tool inheritance from parent agent
+- Conversation history saved automatically
+- Natural interruption with VAD
+- Custom audio device selection
+
+---
+
 ## MCP Integration
 
 ### As MCP Server (Expose DevDuck)
@@ -445,9 +520,9 @@ create_subagent(action="list", repository="owner/repo", workflow_id="agent.yml")
 ---
 
 <details>
-<summary><strong>📋 All Built-in Tools (38 total)</strong></summary>
+<summary><strong>📋 All Built-in Tools (39 total)</strong></summary>
 
-### DevDuck Core (17 tools)
+### DevDuck Core (18 tools)
 - `system_prompt` - Update agent's system prompt (GitHub sync support)
 - `store_in_kb` - Store content in Bedrock Knowledge Base
 - `state_manager` - Save/restore agent state (time-travel)
@@ -466,6 +541,7 @@ create_subagent(action="list", repository="owner/repo", workflow_id="agent.yml")
 - `agentcore_agents` - List/manage agent runtimes
 - `manage_tools` - Runtime tool add/remove/reload
 - `view_logs` - View/search/clear DevDuck logs
+- `speech_to_speech` - Real-time speech-to-speech conversations (optional - install with `pip install devduck[speech]`)
 
 ### Strands Tools (13 tools)
 - `shell` - Interactive shell with PTY support
@@ -572,7 +648,7 @@ devduck
 | `LITELLM_API_KEY` | - | LiteLLM API key (auto-detected) |
 | `LLAMAAPI_API_KEY` | - | LlamaAPI key (auto-detected) |
 | **Tools** | | |
-| `DEVDUCK_TOOLS` | 38 tools | Format: `package1:tool1,tool2;package2:tool3` |
+| `DEVDUCK_TOOLS` | 39 tools | Format: `package1:tool1,tool2;package2:tool3` |
 | `DEVDUCK_LOAD_TOOLS_FROM_DIR` | `false` | Auto-load from `./tools/` directory |
 | **Memory** | | |
 | `DEVDUCK_KNOWLEDGE_BASE_ID` | - | Bedrock KB ID for auto-RAG |
@@ -588,6 +664,8 @@ devduck
 | `DEVDUCK_ENABLE_WS` | `true` | Enable WebSocket server |
 | `DEVDUCK_ENABLE_MCP` | `true` | Enable MCP server |
 | `DEVDUCK_ENABLE_IPC` | `true` | Enable IPC server |
+| **Speech** | | |
+| `BIDI_MODEL_ID` | Provider default | Override bidi model (e.g., `amazon.nova-2-sonic-v1:0`) |
 | **Context** | | |
 | `DEVDUCK_LOG_LINE_COUNT` | `50` | Recent log lines in context |
 | `DEVDUCK_LAST_MESSAGE_COUNT` | `200` | Recent messages in context |
@@ -630,6 +708,15 @@ export DEVDUCK_LOG_LINE_COUNT=20
 export DEVDUCK_LAST_MESSAGE_COUNT=50
 ```
 
+**Speech dependencies not found:**
+```bash
+# Install speech extras
+pip install "devduck[speech]"
+
+# Or with pipx
+pipx install "devduck[speech]"
+```
+
 **Ambient overlay not starting:**
 ```bash
 # Make sure tkinter is installed

{devduck-1.1.5.dist-info → devduck-1.1.7.dist-info}/RECORD

@@ -1,9 +1,9 @@
-devduck/__init__.py,sha256=CVG9qHRG-63ZNI6nLGFyAqvv4m9mgSB46s5XAVM9HOM,75958
+devduck/__init__.py,sha256=4yV11upjpY7xL0KZHERZw8zkDJTk6AlPV5qZve0Q7ho,75863
 devduck/__main__.py,sha256=aeF2RR4k7lzSR2X1QKV9XQPCKhtsH0JYUv2etBBqmL0,145
-devduck/_version.py,sha256=SBXhEAFQbfcjLb_eXnqg0cn0I8-y4wDGA3DkPBmBv2s,704
+devduck/_version.py,sha256=XScxAJn_hLwoilMyvvJG_0tPX3X-Jhde5mefhI8pVSM,704
 devduck/agentcore_handler.py,sha256=0DKJTTjoH9P8a70G0f5dOIIwy6bjqaN46voAWaSOpDY,2221
 devduck/test_redduck.py,sha256=ILtKKMuoyVfmhnibmbojpbOsqbcKooZv4j9qtE2LWdw,1750
-devduck/tools/__init__.py,sha256=GtqhtyTeWz3Glwj7MJ1ncKIQf_0KFu33AmtBOeIm3XY,1176
+devduck/tools/__init__.py,sha256=xoLphnkrIo1vwXohLwHxHgAtCNaTfAtPv-oSS7JMu8Q,1744
 devduck/tools/_ambient_input.py,sha256=3lBgLO81BvkxjgTrQc-EuxNLXmO1oPUt2Ysg1jR4Fsk,13897
 devduck/tools/_tray_app.py,sha256=E4rtJcegRsBs_FdQVGdA-0Ax7uxVb6AbuyqjwCArHj0,19405
 devduck/tools/agentcore_agents.py,sha256=fiDNhl7R2tVbp1mEOySJTfGXwap5q3COenYOjiJDE_g,6488
@@ -25,9 +25,9 @@ devduck/tools/tcp.py,sha256=w2m_Jf6vZ4NYu0AwgZd7C7eKs4No2EVHZ2WYIl_Bt0A,22017
 devduck/tools/tray.py,sha256=FgVhUtLdsdv5_ERK-RyAIpDE8Zb0IfoqhHQdwMxrHUQ,7547
 devduck/tools/use_github.py,sha256=nr3JSGk48mKUobpgW__2gu6lFyUj93a1XRs3I6vH8W4,13682
 devduck/tools/websocket.py,sha256=A8bqgdDZs8hcf2HctkJzQOzMvb5mXUC7YZ-xqkOyn94,16959
-devduck-1.1.5.dist-info/licenses/LICENSE,sha256=UANcoWwfVeuM9597WUkjEQbzqIUH0bJoE9Tpwgj_LvU,11345
-devduck-1.1.5.dist-info/METADATA,sha256=ZcfCUGNHo62mWRffSh_UUePWZcQuR9yYVSdLdNVOncM,21729
-devduck-1.1.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-devduck-1.1.5.dist-info/entry_points.txt,sha256=PJ8gvdi2MnKEK8yCwcmZDeLQ-lx94EV_jp4-v8AKuTA,58
-devduck-1.1.5.dist-info/top_level.txt,sha256=ySXWlVronp8xHYfQ_Hdfr463e0EnbWuqyuxs94EU7yk,8
-devduck-1.1.5.dist-info/RECORD,,
+devduck-1.1.7.dist-info/licenses/LICENSE,sha256=UANcoWwfVeuM9597WUkjEQbzqIUH0bJoE9Tpwgj_LvU,11345
+devduck-1.1.7.dist-info/METADATA,sha256=FTF9VSKqQKNrqCo11fJYWmoCpXa7dppmC48VsCGesnk,24090
+devduck-1.1.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+devduck-1.1.7.dist-info/entry_points.txt,sha256=PJ8gvdi2MnKEK8yCwcmZDeLQ-lx94EV_jp4-v8AKuTA,58
+devduck-1.1.7.dist-info/top_level.txt,sha256=ySXWlVronp8xHYfQ_Hdfr463e0EnbWuqyuxs94EU7yk,8
+devduck-1.1.7.dist-info/RECORD,,