devduck 0.3.0__py3-none-any.whl → 0.4.1__py3-none-any.whl

devduck/__init__.py

@@ -126,168 +126,6 @@ def get_own_source_code():
     except Exception as e:
         return f"Error reading own source code: {e}"
 
-
-# 🛠️ System prompt tool (with .prompt file persistence)
-def system_prompt_tool(
-    action: str,
-    prompt: str | None = None,
-    context: str | None = None,
-    variable_name: str = "SYSTEM_PROMPT",
-) -> Dict[str, Any]:
-    """
-    Manage the agent's system prompt dynamically with file persistence.
-
-    Args:
-        action: "view", "update", "add_context", or "reset"
-        prompt: New system prompt text (required for "update")
-        context: Additional context to prepend (for "add_context")
-        variable_name: Environment variable name (default: SYSTEM_PROMPT)
-
-    Returns:
-        Dict with status and content
-    """
-    from pathlib import Path
-    import tempfile
-
-    def _get_prompt_file_path() -> Path:
-        """Get the .prompt file path in temp directory."""
-        temp_dir = Path(tempfile.gettempdir()) / ".devduck"
-        temp_dir.mkdir(exist_ok=True, mode=0o700)  # Create with restrictive permissions
-        return temp_dir / ".prompt"
-
-    def _write_prompt_file(prompt_text: str) -> None:
-        """Write prompt to .prompt file in temp directory."""
-        prompt_file = _get_prompt_file_path()
-        try:
-            # Create file with restrictive permissions
-            with open(
-                prompt_file,
-                "w",
-                encoding="utf-8",
-                opener=lambda path, flags: os.open(path, flags, 0o600),
-            ) as f:
-                f.write(prompt_text)
-        except (OSError, PermissionError):
-            try:
-                prompt_file.write_text(prompt_text, encoding="utf-8")
-                prompt_file.chmod(0o600)
-            except (OSError, PermissionError):
-                prompt_file.write_text(prompt_text, encoding="utf-8")
-
-    def _get_system_prompt(var_name: str) -> str:
-        """Get current system prompt from environment variable."""
-        return os.environ.get(var_name, "")
-
-    def _update_system_prompt(new_prompt: str, var_name: str) -> None:
-        """Update system prompt in both environment and .prompt file."""
-        os.environ[var_name] = new_prompt
-        if var_name == "SYSTEM_PROMPT":
-            _write_prompt_file(new_prompt)
-
-    try:
-        if action == "view":
-            current = _get_system_prompt(variable_name)
-            return {
-                "status": "success",
-                "content": [
-                    {"text": f"Current system prompt from {variable_name}:{current}"}
-                ],
-            }
-
-        elif action == "update":
-            if not prompt:
-                return {
-                    "status": "error",
-                    "content": [
-                        {"text": "Error: prompt parameter required for update action"}
-                    ],
-                }
-
-            _update_system_prompt(prompt, variable_name)
-
-            if variable_name == "SYSTEM_PROMPT":
-                message = f"System prompt updated (env: {variable_name}, file: .prompt)"
-            else:
-                message = f"System prompt updated (env: {variable_name})"
-
-            return {"status": "success", "content": [{"text": message}]}
-
-        elif action == "add_context":
-            if not context:
-                return {
-                    "status": "error",
-                    "content": [
-                        {
-                            "text": "Error: context parameter required for add_context action"
-                        }
-                    ],
-                }
-
-            current = _get_system_prompt(variable_name)
-            new_prompt = f"{current} {context}" if current else context
-            _update_system_prompt(new_prompt, variable_name)
-
-            if variable_name == "SYSTEM_PROMPT":
-                message = f"Context added to system prompt (env: {variable_name}, file: .prompt)"
-            else:
-                message = f"Context added to system prompt (env: {variable_name})"
-
-            return {"status": "success", "content": [{"text": message}]}
-
-        elif action == "reset":
-            os.environ.pop(variable_name, None)
-
-            if variable_name == "SYSTEM_PROMPT":
-                prompt_file = _get_prompt_file_path()
-                if prompt_file.exists():
-                    try:
-                        prompt_file.unlink()
-                    except (OSError, PermissionError):
-                        pass
-                message = (
-                    f"System prompt reset (env: {variable_name}, file: .prompt cleared)"
-                )
-            else:
-                message = f"System prompt reset (env: {variable_name})"
-
-            return {"status": "success", "content": [{"text": message}]}
-
-        elif action == "get":
-            # Backward compatibility
-            current = _get_system_prompt(variable_name)
-            return {
-                "status": "success",
-                "content": [{"text": f"System prompt: {current}"}],
-            }
-
-        elif action == "set":
-            # Backward compatibility
-            if prompt is None:
-                return {"status": "error", "content": [{"text": "No prompt provided"}]}
-
-            if context:
-                prompt = f"{context} {prompt}"
-
-            _update_system_prompt(prompt, variable_name)
-            return {
-                "status": "success",
-                "content": [{"text": "System prompt updated successfully"}],
-            }
-
-        else:
-            return {
-                "status": "error",
-                "content": [
-                    {
-                        "text": f"Unknown action '{action}'. Valid: view, update, add_context, reset"
-                    }
-                ],
-            }
-
-    except Exception as e:
-        return {"status": "error", "content": [{"text": f"Error: {str(e)}"}]}
-
-
 def view_logs_tool(
     action: str = "view",
     lines: int = 100,
@@ -661,6 +499,7 @@ class DevDuck:
                     use_github,
                     create_subagent,
                     store_in_kb,
+                    system_prompt,
                 )
 
                 core_tools.extend(
@@ -672,34 +511,39 @@ class DevDuck:
                         use_github,
                         create_subagent,
                         store_in_kb,
+                        system_prompt
                     ]
                 )
             except ImportError as e:
                 logger.warning(f"devduck.tools import failed: {e}")
 
-            try:
-                from strands_fun_tools import (
-                    listen,
-                    cursor,
-                    clipboard,
-                    screen_reader,
-                    yolo_vision,
-                )
+            # Skip fun tools in --mcp mode (they're not needed for MCP server)
+            if "--mcp" not in sys.argv:
+                try:
+                    from strands_fun_tools import (
+                        listen,
+                        cursor,
+                        clipboard,
+                        screen_reader,
+                        yolo_vision,
+                    )
 
-                core_tools.extend(
-                    [listen, cursor, clipboard, screen_reader, yolo_vision]
-                )
-            except ImportError:
-                logger.info(
-                    "strands-fun-tools not installed - vision/audio tools unavailable (install with: pip install devduck[all])"
-                )
+                    core_tools.extend(
+                        [listen, cursor, clipboard, screen_reader, yolo_vision]
+                    )
+                except ImportError:
+                    logger.info(
+                        "strands-fun-tools not installed - vision/audio tools unavailable (install with: pip install devduck[all])"
+                    )
+            else:
+                logger.info("--mcp mode: skipping vision/audio tools")
 
             try:
                 from strands_tools import (
                     shell,
                     editor,
                     calculator,
-                    python_repl,
+                    # python_repl,
                     image_reader,
                     use_agent,
                     load_tool,
@@ -713,7 +557,7 @@ class DevDuck:
                         shell,
                         editor,
                         calculator,
-                        python_repl,
+                        # python_repl,
                         image_reader,
                         use_agent,
                         load_tool,
@@ -727,17 +571,6 @@ class DevDuck:
                     "strands-agents-tools not installed - core tools unavailable (install with: pip install devduck[all])"
                 )
 
-            # Wrap system_prompt_tool with @tool decorator
-            @tool
-            def system_prompt(
-                action: str,
-                prompt: str = None,
-                context: str = None,
-                variable_name: str = "SYSTEM_PROMPT",
-            ) -> Dict[str, Any]:
-                """Manage agent system prompt dynamically."""
-                return system_prompt_tool(action, prompt, context, variable_name)
-
             # Wrap view_logs_tool with @tool decorator
             @tool
             def view_logs(
@@ -749,7 +582,7 @@ class DevDuck:
                 return view_logs_tool(action, lines, pattern)
 
             # Add built-in tools to the toolset
-            core_tools.extend([system_prompt, view_logs])
+            core_tools.extend([view_logs])
 
             # Assign tools
             self.tools = core_tools
@@ -976,9 +809,20 @@ def weather(action: str, location: str = None) -> Dict[str, Any]:
 ```
 
 ## System Prompt Management:
-- Use system_prompt(action='get') to view current prompt
-- Use system_prompt(action='set', prompt='new text') to update
-- Changes persist in SYSTEM_PROMPT environment variable
+- **View**: system_prompt(action='view') - See current prompt
+- **Update Local**: system_prompt(action='update', prompt='new text') - Updates env var + .prompt file
+- **Update GitHub**: system_prompt(action='update', prompt='text', repository='cagataycali/devduck') - Syncs to repo variables
+- **Variable Name**: system_prompt(action='update', prompt='text', variable_name='CUSTOM_PROMPT') - Use custom var
+- **Add Context**: system_prompt(action='add_context', context='new learning') - Append without replacing
+
+### 🧠 Self-Improvement Pattern:
+When you learn something valuable during conversations:
+1. Identify the new insight or pattern
+2. Use system_prompt(action='add_context', context='...')  to append it
+3. Sync to GitHub: system_prompt(action='update', prompt=new_full_prompt, repository='owner/repo')
+4. New learnings persist across sessions via SYSTEM_PROMPT env var
+
+**Repository Integration**: Set repository='cagataycali/devduck' to sync prompts across deployments
 
 ## Shell Commands:
 - Prefix with ! to execute shell commands directly
@@ -1267,7 +1111,13 @@ def weather(action: str, location: str = None) -> Dict[str, Any]:
 
 # 🦆 Auto-initialize when imported
 # Check environment variables to control server configuration
+# Also check if --mcp flag is present to skip auto-starting servers
 _auto_start = os.getenv("DEVDUCK_AUTO_START_SERVERS", "true").lower() == "true"
+
+# Disable auto-start if --mcp flag is present (stdio mode)
+if "--mcp" in sys.argv:
+    _auto_start = False
+
 _tcp_port = int(os.getenv("DEVDUCK_TCP_PORT", "9999"))
 _ws_port = int(os.getenv("DEVDUCK_WS_PORT", "8080"))
 _mcp_port = int(os.getenv("DEVDUCK_MCP_PORT", "8000"))
@@ -1510,9 +1360,20 @@ You have full access to your own source code for self-awareness and self-modific
   - Full bidirectional communication
 
 ## System Prompt Management:
-- Use system_prompt(action='get') to view current prompt
-- Use system_prompt(action='set', prompt='new text') to update
-- Changes persist in SYSTEM_PROMPT environment variable
+- **View**: system_prompt(action='view') - See current prompt
+- **Update Local**: system_prompt(action='update', prompt='new text') - Updates env var + .prompt file
+- **Update GitHub**: system_prompt(action='update', prompt='text', repository='cagataycali/devduck') - Syncs to repo variables
+- **Variable Name**: system_prompt(action='update', prompt='text', variable_name='CUSTOM_PROMPT') - Use custom var
+- **Add Context**: system_prompt(action='add_context', context='new learning') - Append without replacing
+
+### 🧠 Self-Improvement Pattern:
+When you learn something valuable during conversations:
+1. Identify the new insight or pattern
+2. Use system_prompt(action='add_context', context='...')  to append it
+3. Optionally sync to GitHub: system_prompt(action='update', prompt=new_full_prompt, repository='owner/repo')
+4. New learnings persist across sessions via SYSTEM_PROMPT env var
+
+**Repository Integration**: Set repository='cagataycali/devduck' to sync prompts across deployments
 
 ## Shell Commands:
 - Prefix with ! to execute shell commands directly
@@ -1561,15 +1422,33 @@ def cli():
 Examples:
   devduck                          # Start interactive mode
   devduck "your query here"        # One-shot query
+  devduck --mcp                    # MCP stdio mode (for Claude Desktop)
   devduck --tcp-port 9000          # Custom TCP port
   devduck --no-tcp --no-ws         # Disable TCP and WebSocket
   devduck --mcp-port 3000          # Custom MCP port
+
+Claude Desktop Config:
+  {
+    "mcpServers": {
+      "devduck": {
+        "command": "uvx",
+        "args": ["devduck", "--mcp"]
+      }
+    }
+  }
         """,
     )
 
     # Query argument
     parser.add_argument("query", nargs="*", help="Query to send to the agent")
 
+    # MCP stdio mode flag
+    parser.add_argument(
+        "--mcp",
+        action="store_true",
+        help="Start MCP server in stdio mode (for Claude Desktop integration)",
+    )
+
     # Server configuration
     parser.add_argument(
         "--tcp-port", type=int, default=9999, help="TCP server port (default: 9999)"
@@ -1601,6 +1480,30 @@ Examples:
 
     logger.info("CLI mode started")
 
+    # Handle --mcp flag for stdio mode
+    if args.mcp:
+        logger.info("Starting MCP server in stdio mode (blocking, foreground)")
+        print("🦆 Starting MCP stdio server...", file=sys.stderr)
+
+        # Don't auto-start HTTP/TCP/WS servers for stdio mode
+        if devduck.agent:
+            try:
+                # Start MCP server in stdio mode - this BLOCKS until terminated
+                devduck.agent.tool.mcp_server(
+                    action="start",
+                    transport="stdio",
+                    expose_agent=True,
+                    agent=devduck.agent,
+                )
+            except Exception as e:
+                logger.error(f"Failed to start MCP stdio server: {e}")
+                print(f"🦆 Error: {e}", file=sys.stderr)
+                sys.exit(1)
+        else:
+            print("🦆 Agent not available", file=sys.stderr)
+            sys.exit(1)
+        return
+
     if args.query:
         query = " ".join(args.query)
         logger.info(f"CLI query: {query}")

devduck/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.3.0'
-__version_tuple__ = version_tuple = (0, 3, 0)
+__version__ = version = '0.4.1'
+__version_tuple__ = version_tuple = (0, 4, 1)
 
 __commit_id__ = commit_id = None

devduck/tools/mcp_server.py

@@ -190,9 +190,11 @@ def _start_mcp_server(
             agent_invoke_tool = types.Tool(
                 name="devduck",
                 description=(
-                    "Invoke the full DevDuck agent with a natural language prompt. "
-                    "Use this for complex queries that require reasoning across multiple tools "
-                    "or when you need a conversational response from the agent."
+                    "Invoke a FULL DevDuck instance with complete capabilities. "
+                    "Each invocation creates a fresh DevDuck agent with self-healing, "
+                    "hot-reload, all tools, knowledge base integration, and system prompt building. "
+                    "Use this for complex queries requiring reasoning, multi-tool orchestration, "
+                    "or when you need the complete DevDuck experience via MCP."
                 ),
                 inputSchema={
                     "type": "object",
@@ -228,7 +230,7 @@ def _start_mcp_server(
             try:
                 logger.debug(f"call_tool: name={name}, arguments={arguments}")
 
-                # Handle agent invocation tool - use the devduck instance directly
+                # Handle agent invocation tool - create a full DevDuck instance
                 if name == "devduck" and expose_agent:
                     prompt = arguments.get("prompt")
                     if not prompt:
@@ -241,8 +243,34 @@ def _start_mcp_server(
 
                     logger.debug(f"Invoking devduck with prompt: {prompt[:100]}...")
 
-                    # Use the devduck agent directly (don't create a new instance)
-                    result = agent(prompt)
+                    # Create a NEW DevDuck instance for this MCP invocation
+                    # This gives full DevDuck power: self-healing, hot-reload, all tools, etc.
+                    try:
+                        from devduck import DevDuck
+
+                        # Create fresh DevDuck instance (no auto-start to avoid recursion)
+                        mcp_devduck = DevDuck(auto_start_servers=False)
+                        mcp_agent = mcp_devduck.agent
+
+                        if not mcp_agent:
+                            return [
+                                types.TextContent(
+                                    type="text",
+                                    text="❌ Error: Failed to create DevDuck instance",
+                                )
+                            ]
+
+                        # Execute with full DevDuck capabilities
+                        result = mcp_agent(prompt)
+
+                    except Exception as e:
+                        logger.error(f"DevDuck creation failed: {e}", exc_info=True)
+                        return [
+                            types.TextContent(
+                                type="text",
+                                text=f"❌ Error creating DevDuck instance: {str(e)}",
+                            )
+                        ]
 
                     # Extract text response from agent result
                     response_text = str(result)