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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devduck
-Version: 0.5.4
+Version: 0.7.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,19 @@ Dynamic: license-file
 
 One Python file that adapts to your environment, fixes itself, and expands capabilities at runtime.
 
+Learn more: https://duck.nyc
+
+## 🎬 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 +114,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 +126,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]
@@ -165,7 +178,7 @@ devduck("refactor my code to use async/await")
 
 | Provider | Setup | When to Use |
 |----------|-------|-------------|
-| **Bedrock** (auto-detected) | [Get API key](https://console.aws.amazon.com/bedrock) → `export AWS_BEARER_TOKEN_BEDROCK=...` | Production (auto-selected if credentials found) |
+| **Bedrock** (auto-detected) | [Get API key](https://console.aws.amazon.com/bedrock) → `export AWS_BEARER_TOKEN_BEDROCK=...` | Auto-selected if credentials found |
 | **MLX** (macOS auto-detected) | Auto-detected on Apple Silicon | Local, optimized for M-series Macs |
 | **Ollama** (fallback) | `ollama pull qwen3:1.7b` | Local, free, private (used if Bedrock/MLX unavailable) |
 | **Anthropic** | `export ANTHROPIC_API_KEY=...` | Claude API direct access |
@@ -187,8 +200,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 +217,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 +239,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
@@ -286,22 +306,75 @@ No restart. No configuration. Just works.
 |----------|---------|---------|
 | `MODEL_PROVIDER` | Auto-detect | `bedrock`, `anthropic`, `github`, `mlx`, `ollama` |
 | `STRANDS_MODEL_ID` | Auto | Model name (e.g., `qwen3:1.7b`, `claude-sonnet-4`) |
-| `DEVDUCK_TOOLS` | All | `pkg:tool1,tool2:pkg2:tool3` |
+| `DEVDUCK_TOOLS` | 37 default tools | `package:tool1,tool2:package2:tool3` format |
+| `DEVDUCK_LOAD_TOOLS_FROM_DIR` | `false` | `true`/`false` - Auto-load tools from `./tools/` directory |
 | `DEVDUCK_KNOWLEDGE_BASE_ID` | - | Bedrock KB ID for auto-RAG |
 | `DEVDUCK_TCP_PORT` | `9999` | TCP server port |
 | `DEVDUCK_ENABLE_TCP` | `true` | Enable/disable TCP |
 
-**Minimal config (shell + editor only):**
+### Tool Configuration Format
+
+**Format:** `package:tool1,tool2:package2:tool3`
+
+**Directory Auto-Loading:**
+
+By default, DevDuck **does not** automatically load tools from the `./tools/` directory. This gives you explicit control over which tools are loaded. To enable automatic loading of tools from `./tools/`, set:
+
+```bash
+export DEVDUCK_LOAD_TOOLS_FROM_DIR=true
+devduck
+```
+
+When enabled, any `.py` file in `./tools/` with a `@tool` decorator will be loaded automatically. When disabled (default), you control tool loading via `DEVDUCK_TOOLS` or runtime `manage_tools()` calls.
+
+**Examples:**
 ```bash
+# Minimal (shell + editor only)
 export DEVDUCK_TOOLS="strands_tools:shell,editor"
+
+# Dev tools only
+export DEVDUCK_TOOLS="strands_tools:shell,editor,file_read,file_write,calculator"
+
+# Full DevDuck + Strands (no fun tools)
+export DEVDUCK_TOOLS="devduck.tools:tcp,websocket,mcp_server,use_github:strands_tools:shell,editor,file_read"
+
+# Custom package
+export DEVDUCK_TOOLS="my_tools:custom_tool,another_tool:strands_tools:shell"
+
 devduck
 ```
 
+**Runtime tool management:**
+```python
+# List loaded tools
+manage_tools(action="list")
+
+# Add tools at runtime
+manage_tools(action="add", package="strands_fun_tools", tool_names="cursor,clipboard")
+
+# Remove tools
+manage_tools(action="remove", tool_names="cursor,clipboard")
+
+# Reload specific tools
+manage_tools(action="reload", tool_names="shell,editor")
+
+# Reload all (restart agent)
+manage_tools(action="reload")
+```
+
+**Discover tools before loading:**
+```python
+# List available tools in a package
+install_tools(action="list_available", package="strands-fun-tools", module="strands_fun_tools")
+```
+
 ---
 
 
 ## MCP Integration
 
+### Expose DevDuck as MCP Server
+
 **Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
 ```json
 {
@@ -316,6 +389,83 @@ devduck
 
 Restart Claude → DevDuck tools appear automatically.
 
+### Load External MCP Servers
+
+DevDuck can act as an MCP client and load tools from external MCP servers automatically.
+
+**Setup:**
+```bash
+export MCP_SERVERS='{
+  "mcpServers": {
+    "strands": {
+      "command": "uvx",
+      "args": ["strands-agents-mcp-server"]
+    }
+  }
+}'
+devduck
+```
+
+**Supported Transport Types:**
+
+| Transport | Configuration | Example |
+|-----------|--------------|---------|
+| **stdio** | `command`, `args`, `env` | Executables via stdin/stdout |
+| **HTTP** | `url`, `headers` | Remote servers via HTTP |
+| **SSE** | `url` (with `/sse` path) | Server-Sent Events streaming |
+
+**Examples:**
+
+```bash
+# Stdio server
+export MCP_SERVERS='{
+  "mcpServers": {
+    "myserver": {
+      "command": "python",
+      "args": ["server.py"],
+      "env": {"API_KEY": "secret"}
+    }
+  }
+}'
+
+# HTTP server
+export MCP_SERVERS='{
+  "mcpServers": {
+    "remote": {
+      "url": "https://api.example.com/mcp",
+      "headers": {"Authorization": "Bearer token"}
+    }
+  }
+}'
+
+# SSE server
+export MCP_SERVERS='{
+  "mcpServers": {
+    "events": {
+      "url": "https://api.example.com/sse"
+    }
+  }
+}'
+
+# Multiple servers
+export MCP_SERVERS='{
+  "mcpServers": {
+    "strands": {
+      "command": "uvx",
+      "args": ["strands-agents-mcp-server"]
+    },
+    "remote": {
+      "url": "https://api.example.com/mcp"
+    }
+  }
+}'
+
+devduck
+# Tools from all MCP servers automatically available
+```
+
+**Tool Prefixing:** Each MCP server's tools are prefixed with the server name (e.g., `strands_tool_name`)
+
 ---
 
 ## Troubleshooting

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

@@ -1,29 +1,30 @@
-devduck/__init__.py,sha256=wtpaq3t6k1z0AT5RyW3-O9evSNV7Taaxw6xyiup022k,38867
+devduck/__init__.py,sha256=okf01FoPFrPpiwuGdQcx9Y7kLndn22JuVkA117L6g-4,67753
 devduck/__main__.py,sha256=aeF2RR4k7lzSR2X1QKV9XQPCKhtsH0JYUv2etBBqmL0,145
-devduck/_version.py,sha256=OrfVZdCDQ-QC6dUnxdROooJjwvLfeDMedTBstpAdSBU,704
+devduck/_version.py,sha256=uLbRjFSUZAgfl7V7O8zKV5Db36k7tz87ZIVq3l2SWs0,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_invoke.py,sha256=SMKqVAig_cZEBL-W5gfumUpPFIHC9CSRSY9BJbnx6wY,17449
+devduck/tools/agentcore_config.py,sha256=sUD1SrLAqTHjgHctZtVRDz_BvLG_nRB3z6g3EcrcvTM,14780
+devduck/tools/agentcore_invoke.py,sha256=iHOeV8mh1QeJ_dj06MRHbJ1VnvY4WIQxqruxIDw0mz0,17469
 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/install_tools.py,sha256=3uzRg5lEHX-L6gxnFn3mIKjGYDJ3h_AdwGnEwKA9qR0,14284
+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.7.0.dist-info/licenses/LICENSE,sha256=UANcoWwfVeuM9597WUkjEQbzqIUH0bJoE9Tpwgj_LvU,11345
+devduck-0.7.0.dist-info/METADATA,sha256=I7la6VIQ76TqoZkaJ-GbY09Mt5duZ_rMGtW8D1lD-OM,17748
+devduck-0.7.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+devduck-0.7.0.dist-info/entry_points.txt,sha256=BAMQaIg_BLZQOTk12bT7hy1dE9oGPLt-_dTbI4cnBnQ,40
+devduck-0.7.0.dist-info/top_level.txt,sha256=ySXWlVronp8xHYfQ_Hdfr463e0EnbWuqyuxs94EU7yk,8
+devduck-0.7.0.dist-info/RECORD,,