devduck 0.7.0__py3-none-any.whl → 1.1.0__py3-none-any.whl

devduck/__init__.py

@@ -20,7 +20,7 @@ from logging.handlers import RotatingFileHandler
 warnings.filterwarnings("ignore", message=".*pkg_resources is deprecated.*")
 warnings.filterwarnings("ignore", message=".*cache_prompt is deprecated.*")
 
-os.environ["BYPASS_TOOL_CONSENT"] = "true"
+os.environ["BYPASS_TOOL_CONSENT"] = os.getenv("BYPASS_TOOL_CONSENT", "true")
 os.environ["STRANDS_TOOL_CONSOLE_MODE"] = "enabled"
 os.environ["EDITOR_DISABLE_BACKUP"] = "true"
 
@@ -189,18 +189,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"}]}
@@ -633,7 +622,7 @@ class DevDuck:
 
             # 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_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"
 
             tools_config = os.getenv("DEVDUCK_TOOLS", default_tools)
             logger.info(f"Loading tools from config: {tools_config}")
@@ -657,7 +646,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
@@ -679,9 +679,9 @@ class DevDuck:
             self.agent_model, self.model = self._select_model()
 
             # Create agent with self-healing
-            # load_tools_from_directory controlled by DEVDUCK_LOAD_TOOLS_FROM_DIR (default: false)
+            # load_tools_from_directory controlled by DEVDUCK_LOAD_TOOLS_FROM_DIR (default: true)
             load_from_dir = (
-                os.getenv("DEVDUCK_LOAD_TOOLS_FROM_DIR", "false").lower() == "true"
+                os.getenv("DEVDUCK_LOAD_TOOLS_FROM_DIR", "true").lower() == "true"
             )
 
             self.agent = Agent(
@@ -715,39 +715,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
@@ -863,25 +863,83 @@ class DevDuck:
 
     def _select_model(self):
         """
-        Smart model selection with fallback: Bedrock → MLX → Ollama
+        Smart model selection with fallback based on available credentials.
+
+        Priority: Bedrock → Anthropic → OpenAI → GitHub → Gemini → Cohere →
+                  Writer → Mistral → LiteLLM → LlamaAPI → SageMaker →
+                  LlamaCpp → MLX → Ollama
 
         Returns:
             Tuple of (model_instance, model_name)
         """
         provider = os.getenv("MODEL_PROVIDER")
 
+        # Read common model parameters from environment
+        max_tokens = int(os.getenv("STRANDS_MAX_TOKENS", "60000"))
+        temperature = float(os.getenv("STRANDS_TEMPERATURE", "1.0"))
+
         if not provider:
-            # Auto-detect: Bedrock → MLX → Ollama
+            # Auto-detect based on API keys and credentials
+            # 1. Try Bedrock (AWS bearer token or STS credentials)
             try:
-                # Try Bedrock if AWS credentials available
-                import boto3
+                # Check for bearer token first
+                if os.getenv("AWS_BEARER_TOKEN_BEDROCK"):
+                    provider = "bedrock"
+                    print("🦆 Using Bedrock (bearer token)")
+                else:
+                    # Try STS credentials
+                    import boto3
 
-                boto3.client("sts").get_caller_identity()
-                provider = "bedrock"
-                print("🦆 Using Bedrock")
+                    boto3.client("sts").get_caller_identity()
+                    provider = "bedrock"
+                    print("🦆 Using Bedrock")
             except:
-                # Try MLX on Apple Silicon
-                if platform.system() == "Darwin" and platform.machine() in [
+                # 2. Try Anthropic
+                if os.getenv("ANTHROPIC_API_KEY"):
+                    provider = "anthropic"
+                    print("🦆 Using Anthropic")
+                # 3. Try OpenAI
+                elif os.getenv("OPENAI_API_KEY"):
+                    provider = "openai"
+                    print("🦆 Using OpenAI")
+                # 4. Try GitHub Models
+                elif os.getenv("GITHUB_TOKEN") or os.getenv("PAT_TOKEN"):
+                    provider = "github"
+                    print("🦆 Using GitHub Models")
+                # 5. Try Gemini
+                elif os.getenv("GOOGLE_API_KEY") or os.getenv("GEMINI_API_KEY"):
+                    provider = "gemini"
+                    print("🦆 Using Gemini")
+                # 6. Try Cohere
+                elif os.getenv("COHERE_API_KEY"):
+                    provider = "cohere"
+                    print("🦆 Using Cohere")
+                # 7. Try Writer
+                elif os.getenv("WRITER_API_KEY"):
+                    provider = "writer"
+                    print("🦆 Using Writer")
+                # 8. Try Mistral
+                elif os.getenv("MISTRAL_API_KEY"):
+                    provider = "mistral"
+                    print("🦆 Using Mistral")
+                # 9. Try LiteLLM
+                elif os.getenv("LITELLM_API_KEY"):
+                    provider = "litellm"
+                    print("🦆 Using LiteLLM")
+                # 10. Try LlamaAPI
+                elif os.getenv("LLAMAAPI_API_KEY"):
+                    provider = "llamaapi"
+                    print("🦆 Using LlamaAPI")
+                # 11. Try SageMaker
+                elif os.getenv("SAGEMAKER_ENDPOINT_NAME"):
+                    provider = "sagemaker"
+                    print("🦆 Using SageMaker")
+                # 12. Try LlamaCpp
+                elif os.getenv("LLAMACPP_MODEL_PATH"):
+                    provider = "llamacpp"
+                    print("🦆 Using LlamaCpp")
+                # 13. Try MLX on Apple Silicon
+                elif platform.system() == "Darwin" and platform.machine() in [
                     "arm64",
                     "aarch64",
                 ]:
@@ -889,48 +947,72 @@ class DevDuck:
                         from strands_mlx import MLXModel
 
                         provider = "mlx"
-                        print("🦆 Using MLX")
+                        print("🦆 Using MLX (Apple Silicon)")
                     except ImportError:
                         provider = "ollama"
-                        print("🦆 Using Ollama")
+                        print("🦆 Using Ollama (fallback)")
+                # 14. Fallback to Ollama
                 else:
                     provider = "ollama"
-                    print("🦆 Using Ollama")
+                    print("🦆 Using Ollama (fallback)")
 
         # Create model based on provider
         if provider == "mlx":
             from strands_mlx import MLXModel
 
-            model_name = "mlx-community/Qwen3-1.7B-4bit"
-            return MLXModel(model_id=model_name, temperature=1), model_name
+            model_name = os.getenv("STRANDS_MODEL_ID", "mlx-community/Qwen3-1.7B-4bit")
+            return (
+                MLXModel(
+                    model_id=model_name,
+                    params={"temperature": temperature, "max_tokens": max_tokens},
+                ),
+                model_name,
+            )
+
+        elif provider == "gemini":
+            from strands.models.gemini import GeminiModel
+
+            model_name = os.getenv("STRANDS_MODEL_ID", "gemini-2.5-flash")
+            api_key = os.getenv("GOOGLE_API_KEY") or os.getenv("GEMINI_API_KEY")
+            return (
+                GeminiModel(
+                    client_args={"api_key": api_key},
+                    model_id=model_name,
+                    params={"temperature": temperature, "max_tokens": max_tokens},
+                ),
+                model_name,
+            )
 
         elif provider == "ollama":
             from strands.models.ollama import OllamaModel
 
+            # Smart model selection based on OS
             os_type = platform.system()
             if os_type == "Darwin":
-                model_name = "qwen3:1.7b"
+                model_name = os.getenv("STRANDS_MODEL_ID", "qwen3:1.7b")
             elif os_type == "Linux":
-                model_name = "qwen3:30b"
+                model_name = os.getenv("STRANDS_MODEL_ID", "qwen3:30b")
             else:
-                model_name = "qwen3:8b"
+                model_name = os.getenv("STRANDS_MODEL_ID", "qwen3:8b")
 
             return (
                 OllamaModel(
-                    host="http://localhost:11434",
+                    host=os.getenv("OLLAMA_HOST", "http://localhost:11434"),
                     model_id=model_name,
-                    temperature=1,
+                    temperature=temperature,
+                    num_predict=max_tokens,
                     keep_alive="5m",
                 ),
                 model_name,
             )
 
         else:
-            # Bedrock or other providers via create_model
+            # All other providers via create_model utility
+            # Supports: bedrock, anthropic, openai, github, cohere, writer, mistral, litellm
             from strands_tools.utils.models.model import create_model
 
             model = create_model(provider=provider)
-            model_name = os.getenv("STRANDS_MODEL_ID", "bedrock")
+            model_name = os.getenv("STRANDS_MODEL_ID", provider)
             return model, model_name
 
     def _build_system_prompt(self):
@@ -1012,9 +1094,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

devduck/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.7.0'
-__version_tuple__ = version_tuple = (0, 7, 0)
+__version__ = version = '1.1.0'
+__version_tuple__ = version_tuple = (1, 1, 0)
 
 __commit_id__ = commit_id = None