devduck 0.5.4__py3-none-any.whl → 0.6.0__py3-none-any.whl

devduck/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.5.4'
-__version_tuple__ = version_tuple = (0, 5, 4)
+__version__ = version = '0.6.0'
+__version_tuple__ = version_tuple = (0, 6, 0)
 
 __commit_id__ = commit_id = None

devduck/tools/__init__.py

@@ -11,6 +11,7 @@ from .use_github import use_github
 from .create_subagent import create_subagent
 from .store_in_kb import store_in_kb
 from .system_prompt import system_prompt
+from .state_manager import state_manager
 
 # AgentCore tools (conditionally available)
 try:
@@ -29,6 +30,7 @@ try:
         "create_subagent",
         "store_in_kb",
         "system_prompt",
+        "state_manager",
         "tray",
         "ambient",
         "agentcore_config",
@@ -47,6 +49,7 @@ except ImportError:
         "create_subagent",
         "store_in_kb",
         "system_prompt",
+        "state_manager",
         "tray",
         "ambient",
     ]

devduck/tools/agentcore_config.py

@@ -1,4 +1,5 @@
 """AgentCore Configuration and Launch Tool"""
+
 import os
 import subprocess
 from pathlib import Path

devduck/tools/ipc.py

@@ -322,8 +322,11 @@ def handle_ipc_client(client_socket, client_id, system_prompt: str, socket_path:
                         )
                         continue
 
+    except BrokenPipeError:
+        # Normal disconnect - client closed connection
+        logger.debug(f"IPC client {client_id} disconnected")
     except Exception as e:
-        logger.error(f"Error handling IPC client {client_id}: {e}", exc_info=True)
+        logger.error(f"Error handling IPC client {client_id}: {e}")
     finally:
         try:
             client_socket.close()

devduck/tools/state_manager.py

@@ -0,0 +1,292 @@
+"""DevDuck State Manager - Time-travel for agent conversations"""
+
+import os
+import tempfile
+import dill
+from pathlib import Path
+from datetime import datetime
+from typing import Dict, Any
+from strands import tool
+
+base_dir = Path(os.getenv("DEVDUCK_HOME", tempfile.gettempdir()))
+states_dir = base_dir / ".devduck" / "states"
+states_dir.mkdir(parents=True, exist_ok=True)
+
+
+@tool
+def state_manager(
+    action: str,
+    state_file: str = None,
+    query: str = None,
+    metadata: dict = None,
+    agent=None,  # Parent agent injection
+) -> Dict[str, Any]:
+    """Agent state management with time-travel capabilities.
+
+    Inspired by cagataycali/research-agent state export pattern.
+
+    Actions:
+    - export: Save current agent state to pkl
+    - load: Load and display state from pkl
+    - list: List available saved states
+    - resume: Load state and continue with new query (ephemeral)
+    - modify: Update pkl file metadata
+    - delete: Remove saved state
+
+    Args:
+        action: Operation to perform
+        state_file: Path to pkl file (auto-generated for export)
+        query: New query for resume action
+        metadata: Additional metadata for export/modify
+        agent: Parent agent (auto-injected by Strands)
+
+    Returns:
+        Dict with status and content
+
+    Examples:
+        # Save current state
+        state_manager(action="export", metadata={"note": "before refactor"})
+
+        # List saved states
+        state_manager(action="list")
+
+        # Resume from previous state (ephemeral, no mutation)
+        state_manager(action="resume", state_file="~/.devduck/states/devduck_20250116_032000.pkl", query="continue analysis")
+
+        # Modify state metadata
+        state_manager(action="modify", state_file="path/to/state.pkl", metadata={"tags": ["important", "refactor"]})
+    """
+    try:
+        if action == "export":
+            # Capture current agent state
+            timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+            state_file = states_dir / f"devduck_{timestamp}.pkl"
+
+            # Safe state extraction (avoid complex objects)
+            state_data = {
+                "version": "1.0",
+                "timestamp": datetime.now().isoformat(),
+                "system_prompt": agent.system_prompt,
+                "tools": list(agent.tool_names),
+                "model": {
+                    "model_id": getattr(agent.model, "model_id", "unknown"),
+                    "temperature": getattr(agent.model, "temperature", None),
+                    "provider": getattr(agent.model, "provider", "unknown"),
+                },
+                "metadata": metadata or {},
+                "environment": {
+                    "cwd": str(Path.cwd()),
+                    "devduck_version": "0.6.0",
+                },
+            }
+
+            # Try to capture conversation history if available
+            if hasattr(agent, "conversation_history"):
+                state_data["conversation_history"] = agent.conversation_history
+            elif hasattr(agent, "messages"):
+                state_data["conversation_history"] = agent.messages
+
+            # Save with dill
+            with open(state_file, "wb") as f:
+                dill.dump(state_data, f)
+
+            size = state_file.stat().st_size
+            return {
+                "status": "success",
+                "content": [
+                    {
+                        "text": f"✅ State exported: {state_file}\n"
+                        f"📦 Size: {size} bytes\n"
+                        f"🔧 Tools: {len(state_data['tools'])}\n"
+                        f"📝 Metadata: {metadata or 'none'}"
+                    }
+                ],
+            }
+
+        elif action == "list":
+            # List all saved states
+            states = sorted(
+                states_dir.glob("devduck_*.pkl"),
+                key=lambda p: p.stat().st_mtime,
+                reverse=True,
+            )
+
+            if not states:
+                return {
+                    "status": "success",
+                    "content": [{"text": "No saved states found"}],
+                }
+
+            output = f"📚 Found {len(states)} saved states:\n\n"
+            for i, state_path in enumerate(states[:10], 1):  # Show last 10
+                try:
+                    with open(state_path, "rb") as f:
+                        state_data = dill.load(f)
+
+                    timestamp = state_data.get("timestamp", "unknown")
+                    tools_count = len(state_data.get("tools", []))
+                    meta = state_data.get("metadata", {})
+
+                    output += f"{i}. {state_path.name}\n"
+                    output += f"   📅 {timestamp}\n"
+                    output += f"   🔧 {tools_count} tools\n"
+                    if meta:
+                        output += f"   📝 {meta}\n"
+                    output += "\n"
+                except:
+                    output += f"{i}. {state_path.name} (corrupted)\n\n"
+
+            return {"status": "success", "content": [{"text": output}]}
+
+        elif action == "load":
+            # Load and display state
+            if not state_file:
+                return {
+                    "status": "error",
+                    "content": [{"text": "state_file required for load"}],
+                }
+
+            state_path = Path(state_file).expanduser()
+            if not state_path.exists():
+                return {
+                    "status": "error",
+                    "content": [{"text": f"State file not found: {state_path}"}],
+                }
+
+            with open(state_path, "rb") as f:
+                state_data = dill.load(f)
+
+            # Pretty format
+            output = f"📦 State: {state_path.name}\n\n"
+            output += f"📅 Timestamp: {state_data.get('timestamp')}\n"
+            output += f"🤖 Model: {state_data.get('model', {}).get('model_id')}\n"
+            output += f"🔧 Tools ({len(state_data.get('tools', []))}): {', '.join(state_data.get('tools', []))}\n"
+            output += f"📝 Metadata: {state_data.get('metadata', {})}\n"
+
+            if "conversation_history" in state_data:
+                history = state_data["conversation_history"]
+                output += f"\n💬 Conversation: {len(history)} messages\n"
+
+            return {"status": "success", "content": [{"text": output}]}
+
+        elif action == "resume":
+            # Time-travel: Load state and continue with ephemeral agent
+            if not state_file or not query:
+                return {
+                    "status": "error",
+                    "content": [{"text": "state_file and query required for resume"}],
+                }
+
+            state_path = Path(state_file).expanduser()
+            if not state_path.exists():
+                return {
+                    "status": "error",
+                    "content": [{"text": f"State file not found: {state_path}"}],
+                }
+
+            with open(state_path, "rb") as f:
+                state_data = dill.load(f)
+
+            # ✅ Create ephemeral DevDuck instance (no mutation!)
+            try:
+                from devduck import DevDuck
+
+                ephemeral_duck = DevDuck(auto_start_servers=False)
+                ephemeral_agent = ephemeral_duck.agent
+            except Exception as e:
+                return {
+                    "status": "error",
+                    "content": [{"text": f"Failed to create ephemeral DevDuck: {e}"}],
+                }
+
+            # Load saved state into ephemeral agent
+            ephemeral_agent.system_prompt = state_data["system_prompt"]
+
+            # Restore conversation history
+            if "conversation_history" in state_data:
+                saved_history = state_data["conversation_history"]
+
+                if hasattr(ephemeral_agent, "conversation_history"):
+                    ephemeral_agent.conversation_history = saved_history
+                elif hasattr(ephemeral_agent, "messages"):
+                    ephemeral_agent.messages = saved_history
+
+            # Build continuation prompt with context
+            continuation_context = f"""
+[Resumed from state: {state_path.name}]
+[Original timestamp: {state_data.get('timestamp')}]
+
+{query}
+"""
+            # Run ephemeral agent (parent agent unchanged!)
+            result = ephemeral_agent(continuation_context)
+
+            return {
+                "status": "success",
+                "content": [{"text": f"🔄 Resumed from {state_path.name}\n\n{result}"}],
+            }
+
+        elif action == "modify":
+            # Modify state metadata
+            if not state_file:
+                return {
+                    "status": "error",
+                    "content": [{"text": "state_file required for modify"}],
+                }
+
+            state_path = Path(state_file).expanduser()
+            if not state_path.exists():
+                return {
+                    "status": "error",
+                    "content": [{"text": f"State file not found: {state_path}"}],
+                }
+
+            with open(state_path, "rb") as f:
+                state_data = dill.load(f)
+
+            # Update metadata
+            if metadata:
+                state_data["metadata"].update(metadata)
+
+            # Save back
+            with open(state_path, "wb") as f:
+                dill.dump(state_data, f)
+
+            return {
+                "status": "success",
+                "content": [
+                    {
+                        "text": f"✅ Modified {state_path.name}\n📝 New metadata: {state_data['metadata']}"
+                    }
+                ],
+            }
+
+        elif action == "delete":
+            # Delete saved state
+            if not state_file:
+                return {
+                    "status": "error",
+                    "content": [{"text": "state_file required for delete"}],
+                }
+
+            state_path = Path(state_file).expanduser()
+            if not state_path.exists():
+                return {
+                    "status": "error",
+                    "content": [{"text": f"State file not found: {state_path}"}],
+                }
+
+            state_path.unlink()
+            return {
+                "status": "success",
+                "content": [{"text": f"🗑️  Deleted {state_path.name}"}],
+            }
+
+        else:
+            return {
+                "status": "error",
+                "content": [{"text": f"Unknown action: {action}"}],
+            }
+
+    except Exception as e:
+        return {"status": "error", "content": [{"text": f"Error: {e}"}]}

devduck/tools/tcp.py

@@ -316,6 +316,12 @@ def run_server(
                 if SERVER_THREADS[port]["running"]:
                     logger.error(f"Error accepting connection: {e}")
 
+    except OSError as e:
+        # Port conflict - handled upstream, no need for scary errors
+        if "Address already in use" in str(e):
+            logger.debug(f"Port {port} unavailable (handled upstream)")
+        else:
+            logger.error(f"Server error on {host}:{port}: {e}")
     except Exception as e:
         logger.error(f"Server error on {host}:{port}: {e}")
     finally:

devduck/tools/websocket.py

@@ -347,8 +347,14 @@ def run_websocket_server(
         asyncio.set_event_loop(loop)
         WS_SERVER_THREADS[port]["loop"] = loop
         loop.run_until_complete(start_server())
+    except OSError as e:
+        # Port conflict - handled upstream, no need for scary errors
+        if "Address already in use" in str(e) or "address already in use" in str(e):
+            logger.debug(f"Port {port} unavailable (handled upstream)")
+        else:
+            logger.error(f"WebSocket server error on {host}:{port}: {e}")
     except Exception as e:
-        logger.error(f"WebSocket server error on {host}:{port}: {e}", exc_info=True)
+        logger.error(f"WebSocket server error on {host}:{port}: {e}")
     finally:
         logger.info(f"WebSocket Server on {host}:{port} stopped")
         WS_SERVER_THREADS[port]["running"] = False

{devduck-0.5.4.dist-info → devduck-0.6.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devduck
-Version: 0.5.4
+Version: 0.6.0
 Summary: 🦆 Extreme minimalist self-adapting AI agent - one file, self-healing, runtime dependencies
 Author-email: Cagatay Cali <cagataycali@icloud.com>
 License: Apache-2.0
@@ -53,6 +53,17 @@ Dynamic: license-file
 
 One Python file that adapts to your environment, fixes itself, and expands capabilities at runtime.
 
+## 🎬 See It In Action
+
+| Feature | What You'll See | Video |
+|---------|----------------|-------|
+| 🔥 **Hot-Reload** | Agent detects code changes and restarts instantly—no manual intervention needed. Edit your agent code or tools while running, save the file, and watch it reload automatically. | [Watch Demo](https://redduck.dev/videos/hot-reload.mp4) |
+| 🌐 **Web UI** | Clean, modern web interface for chatting with DevDuck. Real-time streaming responses, tool execution visibility, and beautiful markdown rendering. | [Watch Demo](https://redduck.dev/videos/web-ui.mp4) |
+| 🛠️ **Dynamic Tool Creation** | Create a new tool by simply saving a `.py` file in the `./tools/` directory. No restart, no configuration—the agent loads it instantly and starts using it. Pure hot-reload magic. | [Watch Demo](https://redduck.dev/videos/dynamic-tool-creation.mp4) |
+| 🌊 **TCP Streaming Server** | Connect from any client (netcat, custom apps, other agents) via TCP. Real-time streaming responses with parallel tool execution. Multi-protocol access to the same agent. | [Watch Demo](https://redduck.dev/videos/tcp.mp4) |
+| 🔌 **IPC & macOS Tray** | Unix socket-based inter-process communication with native macOS menu bar integration. DevDuck runs in your menu bar with quick actions, status indicators, and seamless IPC streaming via `/tmp/devduck_main.sock`. | ![Demo](docs/mac-os-tray.jpg) |
+| 💬 **Ambient Overlay** | Floating AI input overlay with glassmorphism UI. Real-time IPC streaming from devduck, auto-focus with blinking cursor, and ESC to hide / Enter to send. Perfect for desktop AI interactions. | [Watch Demo](https://redduck.dev/videos/floating-input.mp4) |
+
 ---
 
 ## Install & Run
@@ -101,7 +112,7 @@ devduck
 | 🧠 **Auto-RAG** | Remembers past conversations | "I prefer FastAPI" → later uses FastAPI automatically |
 | 🌊 **Multi-Protocol** | CLI, Python, TCP, WebSocket, MCP, IPC | `devduck "query"` or `nc localhost 9999` |
 | ☁️ **AWS Deploy** | One-command serverless deployment | `agentcore_config(auto_launch=True)` |
-| 🛠️ **30+ Tools** | Shell, GitHub, file editing, math, UI control | `devduck("create GitHub issue")` |
+| 🛠️ **35+ Tools** | Shell, GitHub, file editing, math, UI control | `devduck("create GitHub issue")` |
 | 🎛️ **Flexible Config** | Load only tools you need | `DEVDUCK_TOOLS="strands_tools:shell,editor"` |
 
 ---
@@ -113,7 +124,7 @@ graph TB
     A[User Input] -->|CLI/TCP/WS/MCP/IPC| B[DevDuck Core]
     B -->|Auto RAG| C[Knowledge Base]
     C -.->|Context Retrieval| B
-    B -->|Tool Calls| D[30+ Built-in Tools]
+    B -->|Tool Calls| D[35+ Built-in Tools]
     D --> E[shell/editor/calculator]
     D --> F[GitHub/AgentCore]
     D --> G[TCP/WebSocket/MCP/IPC]
@@ -187,8 +198,8 @@ devduck
 | **Dev** | `shell`, `editor`, `file_read`, `calculator` | Code, test, debug |
 | **GitHub** | `use_github`, `create_subagent` | Issues, PRs, CI/CD automation |
 | **Network** | `tcp`, `websocket`, `mcp_server`, `ipc` | Serve agents over protocols |
-| **AWS** | `agentcore_config`, `agentcore_invoke`, `agentcore_logs` | Deploy to serverless |
-| **AI** | `use_agent`, `retrieve`, `store_in_kb` | Multi-agent, memory |
+| **AWS** | `agentcore_config`, `agentcore_invoke`, `agentcore_logs`, `agentcore_agents` | Deploy to serverless |
+| **AI** | `use_agent`, `retrieve`, `store_in_kb`, `state_manager` | Multi-agent, memory, state |
 | **UI** (macOS) | `tray`, `ambient`, `cursor`, `clipboard` | Desktop automation |
 
 <details>
@@ -204,6 +215,7 @@ devduck
 - `create_subagent` - Spawn sub-agents via GitHub Actions
 - `store_in_kb` - Store content in Bedrock Knowledge Base
 - `system_prompt` - Manage agent system prompt
+- `state_manager` - Agent state management with time-travel capabilities
 - `tray` - System tray app control (macOS)
 - `ambient` - Ambient AI input overlay (macOS)
 
@@ -225,6 +237,12 @@ devduck
 - `environment` - Environment variable management
 - `mcp_client` - Connect to external MCP servers
 - `retrieve` - Bedrock Knowledge Base retrieval
+- `scraper` - HTML/XML parsing with BeautifulSoup4
+- `fetch_github_tool` - Fetch and load tools from GitHub
+- `gist` - Comprehensive GitHub Gist management
+- `add_comment` - Add comments to GitHub issues/PRs
+- `list_issues` - List GitHub issues
+- `list_pull_requests` - List GitHub pull requests
 
 ### strands-fun-tools (macOS)
 - `listen` - Background speech transcription with Whisper

{devduck-0.5.4.dist-info → devduck-0.6.0.dist-info}/RECORD

@@ -1,29 +1,30 @@
-devduck/__init__.py,sha256=wtpaq3t6k1z0AT5RyW3-O9evSNV7Taaxw6xyiup022k,38867
+devduck/__init__.py,sha256=mRu9U3EYnxYhFs2xi_a8fX6-peFLgoeM31zlFGbXb3k,57904
 devduck/__main__.py,sha256=aeF2RR4k7lzSR2X1QKV9XQPCKhtsH0JYUv2etBBqmL0,145
-devduck/_version.py,sha256=OrfVZdCDQ-QC6dUnxdROooJjwvLfeDMedTBstpAdSBU,704
+devduck/_version.py,sha256=MAYWefOLb6kbIRub18WSzK6ggSjz1LNLy9aDRlX9Ea4,704
 devduck/agentcore_handler.py,sha256=0DKJTTjoH9P8a70G0f5dOIIwy6bjqaN46voAWaSOpDY,2221
 devduck/test_redduck.py,sha256=ILtKKMuoyVfmhnibmbojpbOsqbcKooZv4j9qtE2LWdw,1750
-devduck/tools/__init__.py,sha256=vmfaz6785obybPDzJhdgO1e0Ty-bBtk5jSb0MskyyWQ,1276
+devduck/tools/__init__.py,sha256=AmIy8MInaClaZ71fqzy4EQJnBWsLkrv4QW9IIN7UQyw,1367
 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
-devduck/tools/agentcore_config.py,sha256=pVJzhGtQQW7R_n4R8F0SKL8iHkoBNsHl4Ppir0WzZ0A,14779
+devduck/tools/agentcore_config.py,sha256=sUD1SrLAqTHjgHctZtVRDz_BvLG_nRB3z6g3EcrcvTM,14780
 devduck/tools/agentcore_invoke.py,sha256=SMKqVAig_cZEBL-W5gfumUpPFIHC9CSRSY9BJbnx6wY,17449
 devduck/tools/agentcore_logs.py,sha256=A3YQIoRErJtvzeaMSPNqOLX1BH-vYTbYKs1NXoCnC5E,10222
 devduck/tools/ambient.py,sha256=HB1ZhfeOdOaMU0xe4e44VNUT_-DQ5SY7sl3r4r-4X44,4806
 devduck/tools/create_subagent.py,sha256=UzRz9BmU4PbTveZROEpZ311aH-u-i6x89gttu-CniAE,24687
 devduck/tools/install_tools.py,sha256=wm_67b9IfY-2wRuWgxuEKhaSIV5vNfbGmZL3G9dGi2A,10348
-devduck/tools/ipc.py,sha256=4YARnIwAkvUwTKUG534hfiZjEL4Km63ykJ_6DnJ72Dc,18478
+devduck/tools/ipc.py,sha256=e3KJeR2HmCKEtVLGNOtf6CeFi3pTDehwd7Fu4JJ19Ms,18607
 devduck/tools/mcp_server.py,sha256=Ybp0PcJKW2TOvghsRL-i8Guqc9WokPwOD2bhVgzoj6Q,21490
+devduck/tools/state_manager.py,sha256=hrleqdVoCboNd8R3wDRUXVKYCZdGoe1j925i948LTHc,10563
 devduck/tools/store_in_kb.py,sha256=-JM-oRQKR3FBubKHFHmXRnZSvi9dVgHxG0lismMgG2k,6861
 devduck/tools/system_prompt.py,sha256=waAdmvRhyulorw_tLqpqUJN_AahuaeF2rXqjMqN7IRY,16905
-devduck/tools/tcp.py,sha256=f74xWa9pgBgQ3icr-KsRVM8GEEs6Wi9B4eP_ZYlKxhQ,21726
+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=lRJZt813iHorVr5UI66Lq-lmaFuLYAfpodeV2gtda7k,16635
-devduck-0.5.4.dist-info/licenses/LICENSE,sha256=UANcoWwfVeuM9597WUkjEQbzqIUH0bJoE9Tpwgj_LvU,11345
-devduck-0.5.4.dist-info/METADATA,sha256=4cI4EZFU_ZIvrJoaWRsrQWuXZCYjPRBQTobMIPpUz0w,12412
-devduck-0.5.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-devduck-0.5.4.dist-info/entry_points.txt,sha256=BAMQaIg_BLZQOTk12bT7hy1dE9oGPLt-_dTbI4cnBnQ,40
-devduck-0.5.4.dist-info/top_level.txt,sha256=ySXWlVronp8xHYfQ_Hdfr463e0EnbWuqyuxs94EU7yk,8
-devduck-0.5.4.dist-info/RECORD,,
+devduck/tools/websocket.py,sha256=A8bqgdDZs8hcf2HctkJzQOzMvb5mXUC7YZ-xqkOyn94,16959
+devduck-0.6.0.dist-info/licenses/LICENSE,sha256=UANcoWwfVeuM9597WUkjEQbzqIUH0bJoE9Tpwgj_LvU,11345
+devduck-0.6.0.dist-info/METADATA,sha256=u3rog7cs0uapLjeO8Oi8bZkoOjeOSQkWKRj65vwggkw,14518
+devduck-0.6.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+devduck-0.6.0.dist-info/entry_points.txt,sha256=BAMQaIg_BLZQOTk12bT7hy1dE9oGPLt-_dTbI4cnBnQ,40
+devduck-0.6.0.dist-info/top_level.txt,sha256=ySXWlVronp8xHYfQ_Hdfr463e0EnbWuqyuxs94EU7yk,8
+devduck-0.6.0.dist-info/RECORD,,