devduck 0.7.2__tar.gz → 1.1.3__tar.gz

{devduck-0.7.2 → devduck-1.1.3}/.github/workflows/agent.yml

@@ -1,8 +1,8 @@
 name: DevDuck
 
 on:
-  schedule:
-    - cron: '0 8 * * *'
+  # schedule:
+  #   - cron: '0 8 * * *'
   issues:
     types: [opened, edited, closed, reopened, assigned, unassigned, labeled, unlabeled]
   issue_comment:

{devduck-0.7.2 → devduck-1.1.3}/.gitignore

@@ -7,4 +7,7 @@ dist/
 build
 _version.py
 .bedrock_agentcore.yaml
-.bedrock_agentcore
+.bedrock_agentcore
+google_*.json
+gmail_*.json
+.DS_Store

{devduck-0.7.2 → devduck-1.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devduck
-Version: 0.7.2
+Version: 1.1.3
 Summary: 🦆 Extreme minimalist self-adapting AI agent - one file, self-healing, runtime dependencies
 Author-email: Cagatay Cali <cagataycali@icloud.com>
 License: Apache-2.0
@@ -31,6 +31,7 @@ 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]; sys_platform == "darwin"
 Requires-Dist: strands-agents[otel]
 Requires-Dist: strands-agents-tools
 Requires-Dist: strands-fun-tools[all]; sys_platform == "darwin"
@@ -39,6 +40,7 @@ Requires-Dist: beautifulsoup4
 Requires-Dist: colorama
 Requires-Dist: websockets
 Requires-Dist: strands-mcp-server
+Requires-Dist: strands-google
 Requires-Dist: bedrock-agentcore-starter-toolkit
 Requires-Dist: bedrock-agentcore
 Requires-Dist: rumps; sys_platform == "darwin"
@@ -239,7 +241,7 @@ install_tools(action="list_loaded")
 
 ### Static Tool Configuration
 
-**Format:** `package:tool1,tool2:package2:tool3`
+**Format:** `package1:tool1,tool2;package2:tool3,tool4`
 
 ```bash
 # Minimal (shell + editor only)
@@ -249,7 +251,7 @@ export DEVDUCK_TOOLS="strands_tools:shell,editor"
 export DEVDUCK_TOOLS="strands_tools:shell,editor,file_read,file_write,calculator"
 
 # Full stack + GitHub
-export DEVDUCK_TOOLS="devduck.tools:tcp,websocket,mcp_server,use_github:strands_tools:shell,editor,file_read"
+export DEVDUCK_TOOLS="devduck.tools:tcp,websocket,mcp_server,use_github;strands_tools:shell,editor,file_read"
 
 devduck
 ```
@@ -572,7 +574,7 @@ devduck
 | `LITELLM_API_KEY` | - | LiteLLM API key (auto-detected) |
 | `LLAMAAPI_API_KEY` | - | LlamaAPI key (auto-detected) |
 | **Tools** | | |
-| `DEVDUCK_TOOLS` | 38 tools | Format: `package:tool1,tool2:package2:tool3` |
+| `DEVDUCK_TOOLS` | 38 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 |

{devduck-0.7.2 → devduck-1.1.3}/README.md

@@ -192,7 +192,7 @@ install_tools(action="list_loaded")
 
 ### Static Tool Configuration
 
-**Format:** `package:tool1,tool2:package2:tool3`
+**Format:** `package1:tool1,tool2;package2:tool3,tool4`
 
 ```bash
 # Minimal (shell + editor only)
@@ -202,7 +202,7 @@ export DEVDUCK_TOOLS="strands_tools:shell,editor"
 export DEVDUCK_TOOLS="strands_tools:shell,editor,file_read,file_write,calculator"
 
 # Full stack + GitHub
-export DEVDUCK_TOOLS="devduck.tools:tcp,websocket,mcp_server,use_github:strands_tools:shell,editor,file_read"
+export DEVDUCK_TOOLS="devduck.tools:tcp,websocket,mcp_server,use_github;strands_tools:shell,editor,file_read"
 
 devduck
 ```
@@ -525,7 +525,7 @@ devduck
 | `LITELLM_API_KEY` | - | LiteLLM API key (auto-detected) |
 | `LLAMAAPI_API_KEY` | - | LlamaAPI key (auto-detected) |
 | **Tools** | | |
-| `DEVDUCK_TOOLS` | 38 tools | Format: `package:tool1,tool2:package2:tool3` |
+| `DEVDUCK_TOOLS` | 38 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 |

{devduck-0.7.2 → devduck-1.1.3}/action.yml

@@ -42,7 +42,7 @@ inputs:
   tools:
     description: 'Comma-separated list of tools to enable'
     required: false
-    default: 'current_time'
+    default: 'strands_tools:current_time'
   
   # Authentication & Access
   github_token:

{devduck-0.7.2 → devduck-1.1.3}/devduck/__init__.py

@@ -3,19 +3,31 @@
 🦆 devduck - extreme minimalist self-adapting agent
 one file. self-healing. runtime dependencies. adaptive.
 """
+import os
 import sys
 import subprocess
-import os
+import threading
 import platform
 import socket
 import logging
 import tempfile
 import time
 import warnings
+import json
 from pathlib import Path
 from datetime import datetime
 from typing import Dict, Any
 from logging.handlers import RotatingFileHandler
+from strands import Agent, tool
+
+# Import system prompt helper for loading prompts from files
+try:
+    from devduck.tools.system_prompt import _get_system_prompt
+except ImportError:
+    # Fallback if tools module not available yet
+    def _get_system_prompt(repository=None, variable_name="SYSTEM_PROMPT"):
+        return os.getenv(variable_name, "")
+
 
 warnings.filterwarnings("ignore", message=".*pkg_resources is deprecated.*")
 warnings.filterwarnings("ignore", message=".*cache_prompt is deprecated.*")
@@ -189,18 +201,7 @@ def manage_tools_func(
     tool_names: str = None,
     tool_path: str = None,
 ) -> Dict[str, Any]:
-    """
-    Manage the agent's tool set at runtime using ToolRegistry.
-
-    Args:
-        action: Action to perform - "list", "add", "remove", "reload"
-        package: Package name to load tools from (e.g., "strands_tools", "strands_fun_tools")
-        tool_names: Comma-separated tool names (e.g., "shell,editor,calculator")
-        tool_path: Path to a .py file to load as a tool
-
-    Returns:
-        Dict with status and content
-    """
+    """Manage the agent's tool set at runtime - add, remove, list, reload tools on the fly."""
     try:
         if not hasattr(devduck, "agent") or not devduck.agent:
             return {"status": "error", "content": [{"text": "Agent not initialized"}]}
@@ -605,7 +606,7 @@ class DevDuck:
                 servers = {
                     "tcp": {
                         "port": int(os.getenv("DEVDUCK_TCP_PORT", "9999")),
-                        "enabled": os.getenv("DEVDUCK_ENABLE_TCP", "true").lower()
+                        "enabled": os.getenv("DEVDUCK_ENABLE_TCP", "false").lower()
                         == "true",
                     },
                     "ws": {
@@ -615,25 +616,93 @@ class DevDuck:
                     },
                     "mcp": {
                         "port": int(os.getenv("DEVDUCK_MCP_PORT", "8000")),
-                        "enabled": os.getenv("DEVDUCK_ENABLE_MCP", "true").lower()
+                        "enabled": os.getenv("DEVDUCK_ENABLE_MCP", "false").lower()
                         == "true",
                     },
                     "ipc": {
                         "socket_path": os.getenv(
                             "DEVDUCK_IPC_SOCKET", "/tmp/devduck_main.sock"
                         ),
-                        "enabled": os.getenv("DEVDUCK_ENABLE_IPC", "true").lower()
+                        "enabled": os.getenv("DEVDUCK_ENABLE_IPC", "false").lower()
                         == "true",
                     },
                 }
 
-            self.servers = servers
+            # Show server configuration status
+            enabled_servers = []
+            disabled_servers = []
+            for server_name, config in servers.items():
+                if config.get("enabled", False):
+                    if "port" in config:
+                        enabled_servers.append(
+                            f"{server_name.upper()}:{config['port']}"
+                        )
+                    else:
+                        enabled_servers.append(server_name.upper())
+                else:
+                    disabled_servers.append(server_name.upper())
 
-            from strands import Agent, tool
+            logger.debug(
+                f"🦆 Server config: {', '.join(enabled_servers) if enabled_servers else 'none enabled'}"
+            )
+            if disabled_servers:
+                logger.debug(f"🦆 Disabled: {', '.join(disabled_servers)}")
+
+            self.servers = servers
 
             # Load tools with flexible configuration
-            # Default tool config - user can override with DEVDUCK_TOOLS env var
-            default_tools = "devduck.tools:system_prompt,store_in_kb,ipc,tcp,websocket,mcp_server,state_manager,tray,ambient,agentcore_config,agentcore_invoke,agentcore_logs,agentcore_agents,install_tools,create_subagent,use_github:strands_tools:shell,editor,file_read,file_write,image_reader,load_tool,retrieve,calculator,use_agent,environment,mcp_client,speak,slack:strands_fun_tools:listen,cursor,clipboard,screen_reader,bluetooth,yolo_vision"
+            # Default tool config
+            # Agent can load additional tools on-demand via fetch_github_tool
+
+            # 🔧 Available DevDuck Tools (load on-demand):
+            # - system_prompt: https://github.com/cagataycali/devduck/blob/main/devduck/tools/system_prompt.py
+            # - store_in_kb: https://github.com/cagataycali/devduck/blob/main/devduck/tools/store_in_kb.py
+            # - ipc: https://github.com/cagataycali/devduck/blob/main/devduck/tools/ipc.py
+            # - tcp: https://github.com/cagataycali/devduck/blob/main/devduck/tools/tcp.py
+            # - websocket: https://github.com/cagataycali/devduck/blob/main/devduck/tools/websocket.py
+            # - mcp_server: https://github.com/cagataycali/devduck/blob/main/devduck/tools/mcp_server.py
+            # - scraper: https://github.com/cagataycali/devduck/blob/main/devduck/tools/scraper.py
+            # - tray: https://github.com/cagataycali/devduck/blob/main/devduck/tools/tray.py
+            # - ambient: https://github.com/cagataycali/devduck/blob/main/devduck/tools/ambient.py
+            # - agentcore_config: https://github.com/cagataycali/devduck/blob/main/devduck/tools/agentcore_config.py
+            # - agentcore_invoke: https://github.com/cagataycali/devduck/blob/main/devduck/tools/agentcore_invoke.py
+            # - agentcore_logs: https://github.com/cagataycali/devduck/blob/main/devduck/tools/agentcore_logs.py
+            # - agentcore_agents: https://github.com/cagataycali/devduck/blob/main/devduck/tools/agentcore_agents.py
+            # - create_subagent: https://github.com/cagataycali/devduck/blob/main/devduck/tools/create_subagent.py
+            # - use_github: https://github.com/cagataycali/devduck/blob/main/devduck/tools/use_github.py
+            # - speech_to_speech: https://github.com/cagataycali/devduck/blob/main/devduck/tools/speech_to_speech.py
+            # - state_manager: https://github.com/cagataycali/devduck/blob/main/devduck/tools/state_manager.py
+
+            # 📦 Strands Tools
+            # - editor, file_read, file_write, image_reader, load_tool, retrieve
+            # - calculator, use_agent, environment, mcp_client, speak, slack
+
+            # 🎮 Strands Fun Tools
+            # - listen, cursor, clipboard, screen_reader, bluetooth, yolo_vision
+
+            # 🔍 Strands Google
+            # - use_google, google_auth
+
+            # 🔧 Auto-append server tools based on enabled servers
+            server_tools_needed = []
+            if servers.get("tcp", {}).get("enabled", False):
+                server_tools_needed.append("tcp")
+            if servers.get("ws", {}).get("enabled", False):
+                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):
+                server_tools_needed.append("ipc")
+
+            # 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"
+                logger.info(f"Auto-added server tools: {server_tools_str}")
+            else:
+                default_tools = (
+                    "devduck.tools:system_prompt,fetch_github_tool;strands_tools:shell"
+                )
 
             tools_config = os.getenv("DEVDUCK_TOOLS", default_tools)
             logger.info(f"Loading tools from config: {tools_config}")
@@ -657,7 +726,18 @@ class DevDuck:
                 tool_names: str = None,
                 tool_path: str = None,
             ) -> Dict[str, Any]:
-                """Manage the agent's tool set at runtime - add, remove, list, reload tools on the fly."""
+                """
+                Manage the agent's tool set at runtime using ToolRegistry.
+
+                Args:
+                    action: Action to perform - "list", "add", "remove", "reload"
+                    package: Package name to load tools from (e.g., "strands_tools", "strands_fun_tools") or "devduck.tools:speech_to_speech,system_prompt,..."
+                    tool_names: Comma-separated tool names (e.g., "shell,editor,calculator")
+                    tool_path: Path to a .py file to load as a tool
+
+                Returns:
+                    Dict with status and content
+                """
                 return manage_tools_func(action, package, tool_names, tool_path)
 
             # Add built-in tools to the toolset
@@ -715,39 +795,39 @@ class DevDuck:
         """
         Load tools based on DEVDUCK_TOOLS configuration.
 
-        Format: package:tool1,tool2:package2:tool3
-        Example: strands_tools:shell,editor:strands_fun_tools:clipboard
+        Format: package1:tool1,tool2;package2:tool3,tool4
+        Examples:
+          - strands_tools:shell,editor;strands_action:use_github
+          - strands_action:use_github;strands_tools:shell,use_aws
 
         Note: Only loads what's specified in config - no automatic additions
         """
         tools = []
-        current_package = None
-
-        for segment in config.split(":"):
-            segment = segment.strip()
-
-            # Check if segment is a package name (contains '.' or '_' and no ',')
-            is_package = "," not in segment and ("." in segment or "_" in segment)
-
-            if is_package:
-                # This is a package name - set as current package
-                current_package = segment
-                logger.debug(f"Switched to package: {current_package}")
-            elif "," in segment:
-                # Tool list from current package
-                if current_package:
-                    for tool_name in segment.split(","):
-                        tool_name = tool_name.strip()
-                        tool = self._load_single_tool(current_package, tool_name)
-                        if tool:
-                            tools.append(tool)
-            elif current_package:
-                # Single tool from current package
-                tool = self._load_single_tool(current_package, segment)
+
+        # Split by semicolon to get package groups
+        groups = config.split(";")
+
+        for group in groups:
+            group = group.strip()
+            if not group:
+                continue
+
+            # Split by colon to get package:tools
+            parts = group.split(":", 1)
+            if len(parts) != 2:
+                logger.warning(f"Invalid format: {group}")
+                continue
+
+            package = parts[0].strip()
+            tools_str = parts[1].strip()
+
+            # Parse tools (comma-separated)
+            tool_names = [t.strip() for t in tools_str.split(",") if t.strip()]
+
+            for tool_name in tool_names:
+                tool = self._load_single_tool(package, tool_name)
                 if tool:
                     tools.append(tool)
-            else:
-                logger.warning(f"Skipping segment '{segment}' - no package set")
 
         logger.info(f"Loaded {len(tools)} tools from configuration")
         return tools
@@ -776,8 +856,6 @@ class DevDuck:
         Returns:
             List of MCPClient instances ready for direct use in Agent
         """
-        import json
-
         mcp_servers_json = os.getenv("MCP_SERVERS")
         if not mcp_servers_json:
             logger.debug("No MCP_SERVERS environment variable found")
@@ -1094,9 +1172,11 @@ You have full access to your own source code for self-awareness and self-modific
 
 ## Tool Configuration:
 Set DEVDUCK_TOOLS for custom tools:
-- Format: package:tool1,tool2:package2:tool3
-- Example: strands_tools:shell,editor:strands_fun_tools:clipboard
+- Format: package1:tool1,tool2;package2:tool3,tool4
+- Example: strands_tools:shell,editor;strands_fun_tools:clipboard
 - Tools are filtered - only specified tools are loaded
+- Load the speech_to_speech tool when it's needed
+- Offload the tools when you don't need
 
 ## MCP Integration:
 - **Expose as MCP Server** - Use mcp_server() to expose devduck via MCP protocol
@@ -1143,7 +1223,7 @@ When you learn something valuable during conversations:
 - Communication: **MINIMAL WORDS**
 - Efficiency: **Speed is paramount**
 
-{os.getenv('SYSTEM_PROMPT', '')}"""
+{_get_system_prompt()}"""
 
     def _self_heal(self, error):
         """Attempt self-healing when errors occur"""
@@ -1190,7 +1270,6 @@ When you learn something valuable during conversations:
 
     def _is_socket_available(self, socket_path):
         """Check if a Unix socket is available"""
-        import os
 
         # If socket file doesn't exist, it's available
         if not os.path.exists(socket_path):
@@ -1428,11 +1507,11 @@ When you learn something valuable during conversations:
     def restart(self):
         """Restart the agent"""
         print("\n🦆 Restarting...")
+        logger.debug("\n🦆 Restarting...")
         self.__init__()
 
     def _start_file_watcher(self):
         """Start background file watcher for auto hot-reload"""
-        import threading
 
         logger.info("Starting file watcher for hot-reload")
         # Get the path to this file
@@ -1532,6 +1611,7 @@ When you learn something valuable during conversations:
                 self._watcher_running = False
 
             print("\n🦆 Restarting process with fresh code...")
+            logger.debug("\n🦆 Restarting process with fresh code...")
 
             # Restart the entire Python process
             # This ensures all code is freshly loaded
@@ -1675,7 +1755,7 @@ def interactive():
     print(f"📝 Logs: {LOG_DIR}")
     print("Type 'exit', 'quit', or 'q' to quit.")
     print("Prefix with ! to run shell commands (e.g., ! ls -la)")
-    print("-" * 50)
+    print("\n\n")
     logger.info("Interactive mode started")
 
     # Set up prompt_toolkit with history
@@ -1703,7 +1783,6 @@ def interactive():
                 auto_suggest=AutoSuggestFromHistory(),
                 completer=completer,
                 complete_while_typing=True,
-                mouse_support=False,  # breaks scrolling when enabled
             )
 
             # Reset interrupt count on successful prompt
@@ -1731,6 +1810,10 @@ def interactive():
                         )
                         devduck._agent_executing = False
 
+                        # Reset terminal to fix rendering issues after command output
+                        print("\r", end="", flush=True)
+                        sys.stdout.flush()
+
                         # Append shell command to history
                         append_to_shell_history(q, result["content"][0]["text"])
 
@@ -1745,6 +1828,9 @@ def interactive():
                 except Exception as e:
                     devduck._agent_executing = False  # Reset on error
                     print(f"🦆 Shell command error: {e}")
+                    # Reset terminal on error too
+                    print("\r", end="", flush=True)
+                    sys.stdout.flush()
                 continue
 
             # Execute the agent with user input

{devduck-0.7.2 → devduck-1.1.3}/devduck/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.7.2'
-__version_tuple__ = version_tuple = (0, 7, 2)
+__version__ = version = '1.1.3'
+__version_tuple__ = version_tuple = (1, 1, 3)
 
-__commit_id__ = commit_id = 'gadb5e74d2'
+__commit_id__ = commit_id = 'gacfc41193'

devduck-1.1.3/devduck/tools/__init__.py

@@ -0,0 +1,47 @@
+"""
+DevDuck Tools Package
+
+This module exports all available tools for devduck.
+"""
+
+from .agentcore_agents import agentcore_agents
+from .agentcore_config import agentcore_config
+from .agentcore_invoke import agentcore_invoke
+from .agentcore_logs import agentcore_logs
+from .ambient import ambient
+from .create_subagent import create_subagent
+from .fetch_github_tool import fetch_github_tool
+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
+from .tcp import tcp
+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",
+]