devduck 0.2.0__tar.gz → 0.4.0__tar.gz

devduck-0.4.0/.github/workflows/agent.yml

@@ -0,0 +1,163 @@
+name: DevDuck
+
+on:
+  schedule:
+    - cron: '0 8 * * *'
+  issues:
+    types: [opened, edited, closed, reopened, assigned, unassigned, labeled, unlabeled]
+  issue_comment:
+    types: [created, edited, deleted]
+  pull_request:
+    types: [opened, closed, edited, reopened, synchronize, ready_for_review]
+  pull_request_review:
+    types: [submitted, edited]
+  discussion:
+    types: [created, edited, answered, unanswered, category_changed, labeled, unlabeled, transferred, pinned, unpinned, locked, unlocked]
+  discussion_comment:
+    types: [created, edited, deleted]
+  pull_request_review_comment:
+    types: [created, edited]
+  workflow_dispatch:
+    inputs:
+      task:
+        description: 'Task'
+        required: false
+        type: string
+      system_prompt:
+        description: 'System prompt'
+        required: false
+        type: string
+      tools:
+        description: 'Comma-separated list of tools to enable for the agent'
+        required: false
+        type: string
+      provider:
+        description: 'Provider'
+        default: "bedrock"
+        required: false
+        type: choice
+        options:
+          - bedrock
+          - openai
+          - github
+          - anthropic
+          - litellm
+          - llamaapi
+      model:
+        description: 'Model ID'
+        default: "us.anthropic.claude-sonnet-4-5-20250929-v1:0"
+        required: false
+        type: string
+      max_tokens:
+        description: 'Max tokens'
+        default: "60000"
+        required: false
+        type: string
+      temperature:
+        description: 'Temperature (0.0-1.0)'
+        default: "1"
+        required: false
+        type: string
+      mcp_servers:
+        description: 'MCP servers configuration (JSON string)'
+        required: false
+        type: string
+        default: '{"mcpServers":{"strands-docs":{"command":"uvx","args":["strands-agents-mcp-server"],"timeout":30000}}}'
+      additional_request_fields:
+        description: 'Additional request fields JSON (e.g., thinking, anthropic_beta)'
+        required: false
+        type: string
+
+permissions: write-all
+
+jobs:
+  check-permissions:
+    runs-on: ubuntu-latest
+    outputs:
+      authorized: ${{ steps.check.outputs.authorized }}
+    steps:
+      - name: Check user authorization
+        id: check  
+        run: |
+          # 🔐 CONFIGURE AUTHORIZED USERS HERE
+          # Add your authorized usernames (comma-separated)
+          AUTHORIZED_USERS="${{ secrets.AUTHORIZED_USERS }}"
+          
+          echo "Checking authorization for user: ${{ github.actor }}"
+          
+          # Check if the triggering user is in the authorized list
+          if [[ ",$AUTHORIZED_USERS," == *",${{ github.actor }},"* ]]; then
+            echo "✅ User ${{ github.actor }} is authorized"
+            echo "authorized=true" >> $GITHUB_OUTPUT
+          else
+            echo "❌ User ${{ github.actor }} is NOT authorized"
+            echo "Authorized users: $AUTHORIZED_USERS"
+            echo "authorized=false" >> $GITHUB_OUTPUT
+          fi
+
+  agent:
+    needs: check-permissions
+    runs-on: ubuntu-latest
+    # Only run if user is authorized
+    if: needs.check-permissions.outputs.authorized == 'true'
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.PAT_TOKEN }}
+
+      - name: Run Strands Agent
+        uses: ./
+        env:
+          PAT_TOKEN: ${{ secrets.PAT_TOKEN }}
+          MODEL_PROVIDER: "bedrock"
+        with:
+          task: |
+            ${{ 
+              github.event.inputs.task ||
+              'I received a GitHub event and am running autonomously. I will analyze the context and take appropriate action. I have full GitHub event details available.'
+            }}
+
+          # Model configuration
+          provider: ${{ github.event.inputs.provider || vars.STRANDS_PROVIDER || 'bedrock' }}
+          model: ${{ github.event.inputs.model || vars.STRANDS_MODEL_ID || 'us.anthropic.claude-sonnet-4-5-20250929-v1:0' }}
+          max_tokens: ${{ github.event.inputs.max_tokens || vars.STRANDS_MAX_TOKENS || '60000' }}
+          temperature: ${{ github.event.inputs.temperature || vars.STRANDS_TEMPERATURE || '1' }}
+
+          # System prompt configuration
+          system_prompt: ${{ github.event.inputs.system_prompt || vars.SYSTEM_PROMPT || vars.INPUT_SYSTEM_PROMPT || 'You are a restricted GitHub agent for this repository, powered by Strands Agents SDK. Only authorized users can trigger your execution.' }}
+
+          # Tool configuration
+          tools: ${{ github.event.inputs.tools || vars.STRANDS_TOOLS}}
+
+          # AWS configuration
+          aws_role_arn: ${{ secrets.AWS_ROLE_ARN }}
+          aws_region: ${{ secrets.AWS_REGION || 'us-west-2' }}
+
+          # Knowledge base
+          knowledge_base_id: ${{ secrets.STRANDS_KNOWLEDGE_BASE_ID }}
+
+          # Advanced configuration
+          additional_request_fields: ${{ github.event.inputs.additional_request_fields || vars.STRANDS_ADDITIONAL_REQUEST_FIELDS }}
+          bypass_tool_consent: "true"
+
+          # MCP configuration
+          mcp_servers: ${{ github.event.inputs.mcp_servers || vars.MCP_SERVERS }}
+
+  unauthorized-notice:
+    needs: check-permissions
+    runs-on: ubuntu-latest
+    # Only run if user is NOT authorized
+    if: needs.check-permissions.outputs.authorized == 'false'
+    steps:
+      - name: Unauthorized access attempt
+        run: |
+          echo "🚫 UNAUTHORIZED ACCESS ATTEMPT"
+          echo "User: ${{ github.actor }}"
+          echo "Repository: ${{ github.repository }}"
+          echo "Event: ${{ github.event_name }}"
+          echo "Time: $(date)"
+          echo ""
+          echo "This incident has been logged."
+          echo "Contact repository administrators for access."
+          exit 1

{devduck-0.2.0 → devduck-0.4.0}/.gitignore

@@ -3,4 +3,6 @@
 *.egg-info
 __pycache__
 *.bak
-dist/
+dist/
+build
+_version.py

devduck-0.4.0/PKG-INFO

@@ -0,0 +1,260 @@
+Metadata-Version: 2.4
+Name: devduck
+Version: 0.4.0
+Summary: 🦆 Extreme minimalist self-adapting AI agent - one file, self-healing, runtime dependencies
+Author-email: duck <hey@devduck.dev>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/cagataycali/devduck
+Project-URL: Repository, https://github.com/cagataycali/devduck.git
+Project-URL: Documentation, https://github.com/cagataycali/devduck#readme
+Project-URL: Bug Tracker, https://github.com/cagataycali/devduck/issues
+Keywords: ai,agent,minimalist,self-healing,ollama,strands-agents
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: strands-agents
+Requires-Dist: prompt_toolkit
+Requires-Dist: strands-agents[ollama]
+Requires-Dist: strands-agents-tools
+Requires-Dist: strands-agentcore-tools
+Requires-Dist: beautifulsoup4
+Requires-Dist: colorama
+Requires-Dist: websockets
+Requires-Dist: strands-mcp-server
+Provides-Extra: all
+Requires-Dist: strands-agents[openai]; extra == "all"
+Requires-Dist: strands-agents[anthropic]; extra == "all"
+Requires-Dist: strands-fun-tools[audio]; extra == "all"
+Requires-Dist: strands-fun-tools[vision]; extra == "all"
+Requires-Dist: strands-fun-tools[all]; extra == "all"
+Dynamic: license-file
+
+# 🦆 DevDuck
+
+**Self-healing agent. One file. Zero config.**
+
+Minimalist AI that adapts to your environment and fixes itself when things break.
+
+## Install
+
+```bash
+pipx install "devduck[all]"  # Full install (recommended)
+```
+
+Requires: Python 3.10+, Ollama (or set `MODEL_PROVIDER`)
+
+## Quick Start
+
+```bash
+devduck                      # Interactive mode (auto-starts servers)
+devduck "analyze this code"  # CLI mode
+```
+
+```python
+import devduck
+devduck("calculate 2+2")  # Python API
+```
+
+## Core Features
+
+- **🔧 Self-healing** - Auto-fixes dependencies, models, errors
+- **🔥 Hot-reload** - Save `.py` files in `./tools/`, use instantly (no restart)
+- **🧠 RAG memory** - Set `STRANDS_KNOWLEDGE_BASE_ID` for automatic context retrieval/storage
+- **🌍 Multi-protocol** - TCP (9999), WebSocket (8080), MCP (8000), CLI, Python
+- **📚 19+ tools** - shell, editor, calculator, python, GitHub, subagents, and more
+- **🎯 Adaptive** - Auto-selects model by OS (macOS: 1.7b, Linux: 30b)
+
+## Auto-Started Servers
+
+When you run `devduck`, 3 servers start automatically:
+
+| Server | Endpoint | Usage |
+|--------|----------|-------|
+| 🌐 **Web UI** | [cagataycali.github.io/devduck](http://cagataycali.github.io/devduck) | Browser interface |
+| 🔌 **TCP** | `localhost:9999` | `nc localhost 9999` |
+| 🌊 **WebSocket** | `ws://localhost:8080` | Structured JSON messages |
+| 🔗 **MCP** | `http://localhost:8000/mcp` | Model Context Protocol |
+
+**Customize ports:**
+```bash
+devduck --tcp-port 9000 --ws-port 8001 --mcp-port 3000
+devduck --no-tcp --no-ws  # Disable specific servers
+```
+
+## Connect Options
+
+### MCP Client (Claude Desktop)
+
+**Simple stdio mode (recommended):**
+```json
+{
+  "mcpServers": {
+    "devduck": {
+      "command": "uvx",
+      "args": ["devduck", "--mcp"]
+    }
+  }
+}
+```
+
+**Proxy mode (if devduck already running):**
+```json
+{
+  "mcpServers": {
+    "devduck": {
+      "command": "uvx",
+      "args": ["strands-mcp-server", "--upstream-url", "http://localhost:8000/mcp/"]
+    }
+  }
+}
+```
+
+### Terminal (TCP)
+```bash
+nc localhost 9999
+> analyze logs
+```
+
+### Shell Prefix
+```bash
+devduck
+🦆 ! git status  # Run shell commands with !
+```
+
+## Hot-Reload Tool Creation
+
+Create tools instantly—no restart needed:
+
+```python
+# ./tools/tip_calc.py
+from strands import tool
+
+@tool
+def calculate_tip(amount: float, percent: float = 15.0) -> str:
+    """Calculate restaurant tip."""
+    tip = amount * (percent / 100)
+    return f"Tip: ${tip:.2f} | Total: ${amount + tip:.2f}"
+```
+
+Save → Available instantly → Use: `devduck "calculate tip for $42"`
+
+## Built-in Tools (19+)
+
+| Category | Tools |
+|----------|-------|
+| **Development** | shell, editor, python_repl, load_tool, environment |
+| **GitHub** | use_github, create_subagent, gist, add_comment, list_issues |
+| **Network** | tcp, websocket, mcp_server, mcp_client, http_request |
+| **AI** | use_agent, install_tools, retrieve, store_in_kb |
+| **Utilities** | calculator, image_reader, scraper, system_prompt, view_logs |
+
+## Multi-Model Support
+
+Switch models via environment variables:
+
+```bash
+# Bedrock (Claude)
+export MODEL_PROVIDER="bedrock"
+export STRANDS_MODEL_ID="us.anthropic.claude-sonnet-4-5-20250929-v1:0"
+export STRANDS_MAX_TOKENS="64000"
+
+# Anthropic API
+export MODEL_PROVIDER="anthropic"
+export STRANDS_MODEL_ID="claude-sonnet-4-20250514"
+
+# Ollama (default)
+export MODEL_PROVIDER="ollama"
+export OLLAMA_HOST="http://localhost:11434"
+```
+
+## Knowledge Base (RAG)
+
+Enable automatic memory across sessions:
+
+```bash
+export STRANDS_KNOWLEDGE_BASE_ID="your-kb-id"
+devduck  # Auto-retrieves context before queries, stores after responses
+```
+
+Works with AWS Bedrock Knowledge Bases.
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `MODEL_PROVIDER` | `ollama` | Model provider (bedrock, anthropic, ollama) |
+| `STRANDS_KNOWLEDGE_BASE_ID` | - | Enable auto-RAG with KB ID |
+| `DEVDUCK_TCP_PORT` | `9999` | TCP server port |
+| `DEVDUCK_WS_PORT` | `8080` | WebSocket port |
+| `DEVDUCK_MCP_PORT` | `8000` | MCP server port |
+| `DEVDUCK_ENABLE_TCP` | `true` | Enable TCP server |
+| `DEVDUCK_ENABLE_WS` | `true` | Enable WebSocket |
+| `DEVDUCK_ENABLE_MCP` | `true` | Enable MCP server |
+| `DEVDUCK_LOG_LINE_COUNT` | `50` | Log lines in context |
+| `SYSTEM_PROMPT` | - | Custom system prompt |
+
+## Dynamic Tool Loading
+
+Load tools from any Python package at runtime:
+
+```python
+devduck
+🦆 install_tools(action="install_and_load", 
+              package="strands-fun-tools", 
+              module="strands_fun_tools")
+```
+
+No restart required—tools available immediately.
+
+## System Prompt Management
+
+Modify agent behavior dynamically:
+
+```bash
+devduck
+🦆 system_prompt(action="update", prompt="You are a senior Python expert.")
+🦆 system_prompt(action="view")  # See current prompt
+```
+
+## Logs
+
+```bash
+devduck
+🦆 view_logs(action="view", lines=100)
+🦆 view_logs(action="search", pattern="error")
+🦆 view_logs(action="stats")
+```
+
+Log location: `/tmp/devduck/logs/devduck.log`
+
+## GitHub Actions
+
+Run DevDuck in CI/CD:
+
+```yaml
+- name: DevDuck Analysis
+  uses: cagataycali/devduck@main
+  with:
+    query: "analyze test coverage"
+    model: "us.anthropic.claude-sonnet-4-20250514-v1:0"
+```
+
+---
+
+**One file. 19+ tools. Self-healing. Hot-reload. RAG memory.**
+
+*Built with [Strands Agents SDK](https://github.com/strands-agents/sdk-python)*

devduck-0.4.0/README.md

@@ -0,0 +1,215 @@
+# 🦆 DevDuck
+
+**Self-healing agent. One file. Zero config.**
+
+Minimalist AI that adapts to your environment and fixes itself when things break.
+
+## Install
+
+```bash
+pipx install "devduck[all]"  # Full install (recommended)
+```
+
+Requires: Python 3.10+, Ollama (or set `MODEL_PROVIDER`)
+
+## Quick Start
+
+```bash
+devduck                      # Interactive mode (auto-starts servers)
+devduck "analyze this code"  # CLI mode
+```
+
+```python
+import devduck
+devduck("calculate 2+2")  # Python API
+```
+
+## Core Features
+
+- **🔧 Self-healing** - Auto-fixes dependencies, models, errors
+- **🔥 Hot-reload** - Save `.py` files in `./tools/`, use instantly (no restart)
+- **🧠 RAG memory** - Set `STRANDS_KNOWLEDGE_BASE_ID` for automatic context retrieval/storage
+- **🌍 Multi-protocol** - TCP (9999), WebSocket (8080), MCP (8000), CLI, Python
+- **📚 19+ tools** - shell, editor, calculator, python, GitHub, subagents, and more
+- **🎯 Adaptive** - Auto-selects model by OS (macOS: 1.7b, Linux: 30b)
+
+## Auto-Started Servers
+
+When you run `devduck`, 3 servers start automatically:
+
+| Server | Endpoint | Usage |
+|--------|----------|-------|
+| 🌐 **Web UI** | [cagataycali.github.io/devduck](http://cagataycali.github.io/devduck) | Browser interface |
+| 🔌 **TCP** | `localhost:9999` | `nc localhost 9999` |
+| 🌊 **WebSocket** | `ws://localhost:8080` | Structured JSON messages |
+| 🔗 **MCP** | `http://localhost:8000/mcp` | Model Context Protocol |
+
+**Customize ports:**
+```bash
+devduck --tcp-port 9000 --ws-port 8001 --mcp-port 3000
+devduck --no-tcp --no-ws  # Disable specific servers
+```
+
+## Connect Options
+
+### MCP Client (Claude Desktop)
+
+**Simple stdio mode (recommended):**
+```json
+{
+  "mcpServers": {
+    "devduck": {
+      "command": "uvx",
+      "args": ["devduck", "--mcp"]
+    }
+  }
+}
+```
+
+**Proxy mode (if devduck already running):**
+```json
+{
+  "mcpServers": {
+    "devduck": {
+      "command": "uvx",
+      "args": ["strands-mcp-server", "--upstream-url", "http://localhost:8000/mcp/"]
+    }
+  }
+}
+```
+
+### Terminal (TCP)
+```bash
+nc localhost 9999
+> analyze logs
+```
+
+### Shell Prefix
+```bash
+devduck
+🦆 ! git status  # Run shell commands with !
+```
+
+## Hot-Reload Tool Creation
+
+Create tools instantly—no restart needed:
+
+```python
+# ./tools/tip_calc.py
+from strands import tool
+
+@tool
+def calculate_tip(amount: float, percent: float = 15.0) -> str:
+    """Calculate restaurant tip."""
+    tip = amount * (percent / 100)
+    return f"Tip: ${tip:.2f} | Total: ${amount + tip:.2f}"
+```
+
+Save → Available instantly → Use: `devduck "calculate tip for $42"`
+
+## Built-in Tools (19+)
+
+| Category | Tools |
+|----------|-------|
+| **Development** | shell, editor, python_repl, load_tool, environment |
+| **GitHub** | use_github, create_subagent, gist, add_comment, list_issues |
+| **Network** | tcp, websocket, mcp_server, mcp_client, http_request |
+| **AI** | use_agent, install_tools, retrieve, store_in_kb |
+| **Utilities** | calculator, image_reader, scraper, system_prompt, view_logs |
+
+## Multi-Model Support
+
+Switch models via environment variables:
+
+```bash
+# Bedrock (Claude)
+export MODEL_PROVIDER="bedrock"
+export STRANDS_MODEL_ID="us.anthropic.claude-sonnet-4-5-20250929-v1:0"
+export STRANDS_MAX_TOKENS="64000"
+
+# Anthropic API
+export MODEL_PROVIDER="anthropic"
+export STRANDS_MODEL_ID="claude-sonnet-4-20250514"
+
+# Ollama (default)
+export MODEL_PROVIDER="ollama"
+export OLLAMA_HOST="http://localhost:11434"
+```
+
+## Knowledge Base (RAG)
+
+Enable automatic memory across sessions:
+
+```bash
+export STRANDS_KNOWLEDGE_BASE_ID="your-kb-id"
+devduck  # Auto-retrieves context before queries, stores after responses
+```
+
+Works with AWS Bedrock Knowledge Bases.
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `MODEL_PROVIDER` | `ollama` | Model provider (bedrock, anthropic, ollama) |
+| `STRANDS_KNOWLEDGE_BASE_ID` | - | Enable auto-RAG with KB ID |
+| `DEVDUCK_TCP_PORT` | `9999` | TCP server port |
+| `DEVDUCK_WS_PORT` | `8080` | WebSocket port |
+| `DEVDUCK_MCP_PORT` | `8000` | MCP server port |
+| `DEVDUCK_ENABLE_TCP` | `true` | Enable TCP server |
+| `DEVDUCK_ENABLE_WS` | `true` | Enable WebSocket |
+| `DEVDUCK_ENABLE_MCP` | `true` | Enable MCP server |
+| `DEVDUCK_LOG_LINE_COUNT` | `50` | Log lines in context |
+| `SYSTEM_PROMPT` | - | Custom system prompt |
+
+## Dynamic Tool Loading
+
+Load tools from any Python package at runtime:
+
+```python
+devduck
+🦆 install_tools(action="install_and_load", 
+              package="strands-fun-tools", 
+              module="strands_fun_tools")
+```
+
+No restart required—tools available immediately.
+
+## System Prompt Management
+
+Modify agent behavior dynamically:
+
+```bash
+devduck
+🦆 system_prompt(action="update", prompt="You are a senior Python expert.")
+🦆 system_prompt(action="view")  # See current prompt
+```
+
+## Logs
+
+```bash
+devduck
+🦆 view_logs(action="view", lines=100)
+🦆 view_logs(action="search", pattern="error")
+🦆 view_logs(action="stats")
+```
+
+Log location: `/tmp/devduck/logs/devduck.log`
+
+## GitHub Actions
+
+Run DevDuck in CI/CD:
+
+```yaml
+- name: DevDuck Analysis
+  uses: cagataycali/devduck@main
+  with:
+    query: "analyze test coverage"
+    model: "us.anthropic.claude-sonnet-4-20250514-v1:0"
+```
+
+---
+
+**One file. 19+ tools. Self-healing. Hot-reload. RAG memory.**
+
+*Built with [Strands Agents SDK](https://github.com/strands-agents/sdk-python)*