devduck 0.2.0__tar.gz → 0.3.0__tar.gz

devduck-0.3.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.3.0}/.gitignore

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

{devduck-0.2.0/devduck.egg-info → devduck-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devduck
-Version: 0.2.0
+Version: 0.3.0
 Summary: 🦆 Extreme minimalist self-adapting AI agent - one file, self-healing, runtime dependencies
 Author-email: duck <hey@devduck.dev>
 License-Expression: MIT
@@ -27,15 +27,20 @@ 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[openai]
-Requires-Dist: strands-agents[anthropic]
 Requires-Dist: strands-agents-tools
-Requires-Dist: strands-fun-tools[audio]
-Requires-Dist: strands-fun-tools[vision]
-Requires-Dist: strands-fun-tools[all]
+Requires-Dist: strands-agentcore-tools
+Requires-Dist: beautifulsoup4
+Requires-Dist: colorama
 Requires-Dist: websockets
-Requires-Dist: prompt_toolkit
+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"
+Requires-Dist: strands-mcp-server; extra == "all"
 Dynamic: license-file
 
 # 🦆 DevDuck
@@ -47,10 +52,14 @@ Minimalist AI agent that fixes itself when things break.
 ## Install
 
 ```bash
+# Minimal install
 pipx install devduck
+
+# Full install (all tools)
+pipx install "devduck[all]"
 ```
 
-Requires: Python 3.10+, Ollama running
+Requires: Python 3.10+, Ollama running (or set MODEL_PROVIDER)
 
 ## Use
 

{devduck-0.2.0 → devduck-0.3.0}/README.md

@@ -7,10 +7,14 @@ Minimalist AI agent that fixes itself when things break.
 ## Install
 
 ```bash
+# Minimal install
 pipx install devduck
+
+# Full install (all tools)
+pipx install "devduck[all]"
 ```
 
-Requires: Python 3.10+, Ollama running
+Requires: Python 3.10+, Ollama running (or set MODEL_PROVIDER)
 
 ## Use
 

devduck-0.3.0/action.yml

@@ -0,0 +1,212 @@
+name: 'DevDuck'
+description: 'Quack.'
+author: 'Cagatay Cali'
+
+branding:
+  icon: 'bot'
+  color: 'blue'
+
+inputs:
+  # Core Task Configuration
+  task:
+    description: 'Specific task for the agent to perform'
+    required: true
+  
+  system_prompt:
+    description: 'Additional system prompt instructions for the agent'
+    required: false
+    default: ''
+  
+  # Model Configuration
+  provider:
+    description: 'Model provider (bedrock, openai, github, anthropic, litellm, llamaapi)'
+    required: false
+    default: 'bedrock'
+  
+  model:
+    description: 'Model ID to use'
+    required: false
+    default: 'us.anthropic.claude-sonnet-4-20250514-v1:0'
+  
+  max_tokens:
+    description: 'Maximum tokens for the model'
+    required: false
+    default: '32768'
+  
+  temperature:
+    description: 'Temperature for model generation (0.0-1.0)'
+    required: false
+    default: '1'
+  
+  # Tool Configuration
+  tools:
+    description: 'Comma-separated list of tools to enable'
+    required: false
+    default: 'current_time'
+  
+  # Authentication & Access
+  github_token:
+    description: 'GitHub token for API access'
+    required: false
+    default: ${{ github.token }}
+  
+  # AWS Configuration (for Bedrock)
+  aws_region:
+    description: 'AWS region for Bedrock'
+    required: false
+    default: 'us-west-2'
+  
+  aws_role_arn:
+    description: 'AWS role ARN for OIDC authentication'
+    required: false
+  
+  # Knowledge Base Configuration
+  knowledge_base_id:
+    description: 'Strands Knowledge Base ID for memory'
+    required: false
+  
+  # Advanced Configuration
+  additional_request_fields:
+    description: 'Additional request fields JSON (e.g., thinking, anthropic_beta)'
+    required: false
+    default: ''
+  
+  bypass_tool_consent:
+    description: 'Skip tool consent prompts'
+    required: false
+    default: 'true'
+
+  # MCP Configuration
+  mcp_servers:
+    description: 'MCP servers configuration (JSON string)'
+    required: false
+    # default: '{"mcpServers":{"strands-docs":{"command":"uvx","args":["strands-agents-mcp-server"],"timeout":30000}}}'
+
+  # Agent Runner Configuration
+  agent_runner:
+    description: 'URL to custom agent_runner.py script. Falls back to repository variable AGENT_RUNNER, then default gist'
+    required: false
+
+outputs:
+  result:
+    description: 'Result from the agent execution'
+  
+  success:
+    description: 'Whether the agent execution was successful'
+  
+  error:
+    description: 'Error message if execution failed'
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Use Homebrew Python 3.13
+      if: runner.os == 'macOS'
+      shell: bash
+      run: |
+        echo "/opt/homebrew/opt/python@3.13/libexec/bin" >> $GITHUB_PATH
+        echo "/opt/homebrew/bin" >> $GITHUB_PATH
+
+    - name: Set up Python
+      if: runner.os != 'macOS'
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.13'
+
+    - name: Cache UV dependencies
+      uses: actions/cache@v4
+      with:
+        path: |
+          ~/.cache/uv
+        key: ${{ runner.os }}-python${{ matrix.python-version || '3.13' }}-uv-${{ hashFiles('requirements.txt', 'requirements-local.txt') }}-v2
+        restore-keys: |
+          ${{ runner.os }}-python${{ matrix.python-version || '3.13' }}-uv-
+
+    - name: Clean UV cache on failure
+      if: failure()
+      shell: bash
+      run: |
+        uv cache clean || true
+        rm -rf ~/.cache/uv/* || true
+
+    - name: Install UV
+      shell: bash
+      run: |
+        curl -LsSf https://astral.sh/uv/install.sh | sh
+        echo "$HOME/.cargo/bin" >> $GITHUB_PATH
+
+    - name: Install Strands Agents
+      shell: bash
+      run: |
+        uv pip install --system -r requirements.txt --quiet
+
+    - name: Install Local Dependencies
+      if: runner.os == 'macOS'
+      shell: bash
+      run: |
+        uv pip install --system -r requirements-local.txt --quiet
+
+    - name: Configure Git
+      shell: bash
+      run: |
+        git config --global user.name "DevDuck" 2>/dev/null
+        git config --global user.email "hey@strands.my" 2>/dev/null
+
+    - name: Configure AWS credentials
+      if: inputs.aws_role_arn != ''
+      uses: aws-actions/configure-aws-credentials@v4
+      with:
+        role-to-assume: ${{ inputs.aws_role_arn }}
+        role-session-name: GitHubActions-StrandsAgent-${{ github.run_id }}
+        aws-region: ${{ inputs.aws_region }}
+        mask-aws-account-id: true
+
+    - name: Download agent script
+      shell: bash
+      env:
+        # GitHub Configuration - Priority: Input > Repository Variable > Default Gist
+        AGENT_RUNNER: ${{ inputs.agent_runner || 'https://gist.githubusercontent.com/cagataycali/f67df59c34c0d7ff13adbba3b0f8d3d9/raw/bb324e37d19948f0d36d0ca9ce721ca64deb13a1/agent_runner.py' }}
+      run: |
+        curl -s -o agent_runner.py $AGENT_RUNNER
+
+    - name: Run Strands Agent
+      shell: bash
+      env:
+        # GitHub Configuration
+        GITHUB_TOKEN: ${{ inputs.github_token }}
+        GITHUB_CONTEXT: ${{ toJson(github) }}
+        GITHUB_REPOSITORY: ${{ github.repository }}
+        GITHUB_EVENT_NAME: ${{ github.event_name }}
+        GITHUB_ACTOR: ${{ github.actor }}
+
+        # Model Configuration
+        STRANDS_PROVIDER: ${{ inputs.provider }}
+        STRANDS_MODEL_ID: ${{ inputs.model }}
+        STRANDS_MAX_TOKENS: ${{ inputs.max_tokens }}
+        STRANDS_TEMPERATURE: ${{ inputs.temperature }}
+        STRANDS_ADDITIONAL_REQUEST_FIELDS: ${{ inputs.additional_request_fields }}
+
+        # Tool Configuration
+        STRANDS_TOOLS: ${{ inputs.tools }}
+        BYPASS_TOOL_CONSENT: ${{ inputs.bypass_tool_consent }}
+        STRANDS_TOOL_CONSOLE_MODE: "enabled"
+
+        # Task Configuration
+        INPUT_TASK: ${{ inputs.task }}
+        INPUT_SYSTEM_PROMPT: ${{ inputs.system_prompt }}
+        
+        # AWS Configuration
+        AWS_REGION: ${{ inputs.aws_region }}
+
+        # Knowledge Base
+        STRANDS_KNOWLEDGE_BASE_ID: ${{ inputs.knowledge_base_id }}
+        
+        # MCP Configuration
+        MCP_SERVERS: ${{ inputs.mcp_servers }}
+      run: |
+        AGENT_INPUT="$INPUT_TASK"
+        
+        echo "🤖 Starting Strands Agent..."
+        
+        # Run the agent with UV
+        uv run agent_runner.py "$AGENT_INPUT"

devduck-0.3.0/agent_runner.py

@@ -0,0 +1,206 @@
+#!/usr/bin/env python3
+"""
+Minimal DevDuck GitHub Agent Runner
+Uses DevDuck with GitHub context, MCP tools, and knowledge base integration.
+
+Examples:
+  echo "analyze this data" | python agent_runner.py
+  python agent_runner.py "what can you do"
+  INPUT_TASK="search papers" python agent_runner.py
+"""
+
+import json
+import os
+import sys
+import datetime
+
+# Disable auto-start servers for DevDuck singleton before import
+os.environ["DEVDUCK_AUTO_START_SERVERS"] = "false"
+os.environ["BYPASS_TOOL_CONSENT"] = "true"
+os.environ["STRANDS_TOOL_CONSOLE_MODE"] = "enabled"
+
+from mcp import StdioServerParameters, stdio_client
+from strands.tools.mcp import MCPClient
+
+# HTTP transport imports
+try:
+    from mcp.client.sse import sse_client
+    from mcp.client.streamable_http import streamablehttp_client
+
+    HTTP_TRANSPORT_AVAILABLE = True
+except ImportError:
+    HTTP_TRANSPORT_AVAILABLE = False
+
+# DevDuck is required
+from devduck import DevDuck
+
+
+def load_mcp_config() -> dict:
+    """Load MCP server configuration from JSON file or environment variable."""
+    mcp_servers_env = os.getenv("MCP_SERVERS")
+    if mcp_servers_env:
+        try:
+            config = json.loads(mcp_servers_env)
+            return config.get("mcpServers", {})
+        except json.JSONDecodeError:
+            pass
+
+    # Fallback: hardcoded strands-agents-mcp-server
+    return {"strands-agents": {"command": "uvx", "args": ["strands-agents-mcp-server"]}}
+
+
+def create_mcp_clients() -> list:
+    """Create MCP clients from configuration."""
+    mcp_config = load_mcp_config()
+    clients = []
+
+    for server_name, server_config in mcp_config.items():
+        try:
+            command = server_config.get("command")
+            if command:
+                args = server_config.get("args", [])
+                env = server_config.get("env", {})
+
+                client = MCPClient(
+                    lambda cmd=command, arguments=args, environment=env: stdio_client(
+                        StdioServerParameters(
+                            command=cmd,
+                            args=arguments,
+                            env=environment if environment else None,
+                        )
+                    )
+                )
+                clients.append((server_name, client))
+
+            elif server_config.get("url") and HTTP_TRANSPORT_AVAILABLE:
+                url = server_config.get("url")
+                headers = server_config.get("headers", {})
+
+                try:
+                    client = MCPClient(lambda: sse_client(url, headers=headers))
+                    clients.append((server_name, client))
+                except Exception:
+                    try:
+                        client = MCPClient(
+                            lambda: streamablehttp_client(url, headers=headers)
+                        )
+                        clients.append((server_name, client))
+                    except Exception:
+                        continue
+        except Exception:
+            continue
+
+    return clients
+
+
+def build_system_prompt() -> str:
+    """Build system prompt from environment variables."""
+    base_prompt = os.getenv("SYSTEM_PROMPT", "")
+    if not base_prompt:
+        base_prompt = "You are an autonomous GitHub agent powered by DevDuck."
+
+    input_system_prompt = os.getenv("INPUT_SYSTEM_PROMPT", "")
+    if input_system_prompt:
+        base_prompt = f"{base_prompt}\n\n{input_system_prompt}"
+
+    github_context = os.environ.get("GITHUB_CONTEXT", "")
+    if github_context:
+        base_prompt = f"{base_prompt}\n\nGitHub Context:\n{github_context}"
+
+    return base_prompt
+
+
+def run_agent(query: str) -> str:
+    """Run DevDuck agent with GitHub context and MCP tools."""
+
+    print("🦆 Creating DevDuck agent...")
+
+    # Create a new DevDuck instance without auto-starting servers
+    duck = DevDuck(auto_start_servers=False)
+    agent = duck.agent
+
+    # Build and append GitHub context to DevDuck's system prompt
+    github_system_prompt = build_system_prompt()
+    if agent and github_system_prompt:
+        agent.system_prompt += "\n\nCustom system prompt:" + github_system_prompt
+        print("✅ GitHub context appended to DevDuck's system prompt")
+
+    # Get MCP clients
+    mcp_clients = create_mcp_clients()
+
+    # Run agent with MCP context
+    # NOTE: KB retrieval/storage now handled automatically in DevDuck.__call__
+    result = None
+    if mcp_clients:
+        print(f"🔗 Loading {len(mcp_clients)} MCP servers...")
+
+        def run_with_mcp(clients, current_agent):
+            if not clients:
+                return current_agent(query)
+
+            server_name, client = clients[0]
+            remaining = clients[1:]
+
+            with client:
+                try:
+                    mcp_tools = client.list_tools_sync()
+                    print(f"✓ {server_name}: {len(mcp_tools)} tools loaded")
+                except Exception as e:
+                    print(f"⚠️  {server_name} failed: {e}")
+
+                return run_with_mcp(remaining, current_agent)
+
+        result = run_with_mcp(mcp_clients, agent)
+    else:
+        result = agent(query)
+
+    return result
+
+
+def main():
+    """Main entry point."""
+
+    # Multi-input task collection (priority-based)
+    tasks = {}
+
+    # Priority 1: Piped input (stdin)
+    if not sys.stdin.isatty():
+        try:
+            pipe_task = sys.stdin.read().strip()
+            if pipe_task:
+                tasks["pipe"] = pipe_task
+        except Exception:
+            pass
+
+    # Priority 2: Command line arguments
+    if len(sys.argv) > 1:
+        cmd_task = " ".join(sys.argv[1:])
+        if cmd_task:
+            tasks["command_line"] = cmd_task
+
+    # Priority 3: Environment variable
+    env_task = os.getenv("INPUT_TASK")
+    if env_task:
+        tasks["environment"] = env_task
+
+    # No tasks found
+    if not tasks:
+        print(
+            "❌ Error: No task provided. Use command line args, stdin, or INPUT_TASK env var."
+        )
+        sys.exit(1)
+
+    # Combine all tasks
+    combined_task = "\n\n".join(tasks.values())
+
+    try:
+        result = run_agent(combined_task)
+        print(f"\n✅ Agent Execution Complete!")
+        print(f"📝 Result: {result}")
+    except Exception as e:
+        print(f"❌ Fatal error: {e}")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()