devsper 2.1.6__tar.gz

devsper-2.1.6/.env.example

@@ -0,0 +1,28 @@
+# Copy to .env and set your API keys.
+# python-dotenv loads these when the provider router is used (and in examples/_config.py).
+# For worker/planner models and paths, you can use ~/.config/devsper/config.toml instead
+# (see README Configuration). API keys stay in .env or environment only.
+
+OPENAI_API_KEY=
+ANTHROPIC_API_KEY=
+GOOGLE_API_KEY=
+
+# --- Azure OpenAI (GPT: gpt-4o, gpt-5-mini on same endpoint) ---
+# When set, GPT models use Azure; deployment name = model name (e.g. gpt-4o, gpt-5-mini).
+# Use the CHAT COMPLETIONS base URL, not the Responses API URL:
+#   - Correct (Azure Foundry): https://your-resource.cognitiveservices.azure.com/openai/v1
+#   - Wrong:  .../openai/responses (Responses API; causes 404 DeploymentNotFound)
+# AZURE_OPENAI_ENDPOINT=https://your-resource.cognitiveservices.azure.com/openai/v1
+# AZURE_OPENAI_API_KEY=
+# AZURE_OPENAI_API_VERSION=2025-04-01-preview
+# Optional default deployment if not passing model name: AZURE_OPENAI_DEPLOYMENT_NAME=gpt-5-mini
+
+# --- Azure Anthropic (Claude: e.g. claude-opus-4-6-2) ---
+# When set, Claude models use Azure Foundry instead of native Anthropic.
+# AZURE_ANTHROPIC_ENDPOINT=https://your-resource.services.ai.azure.com/anthropic/v1/messages
+# AZURE_ANTHROPIC_API_KEY=
+# AZURE_ANTHROPIC_DEPLOYMENT_NAME=claude-opus-4-6-2
+
+# --- Override models used by examples (default with Azure: gpt-4o / gpt-5-mini, claude-opus-4-6-2) ---
+# DEVSPER_WORKER_MODEL=gpt-5-mini
+# DEVSPER_PLANNER_MODEL=gpt-4o

devsper-2.1.6/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: [rithulkamesh]

devsper-2.1.6/.github/workflows/docs-deploy.yml

@@ -0,0 +1,74 @@
+# Deploy docs to EC2 (docs.devsper.com)
+# Builds Docusaurus from website/, rsyncs to EC2, reloads Caddy.
+#
+# Prerequisite on EC2:
+#   sudo mkdir -p /opt/devsper-docs && sudo chown ubuntu:ubuntu /opt/devsper-docs
+#   Caddy must have a server block for docs.devsper.com (see deploy/Caddyfile).
+
+name: Docs Deploy
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "website/**"
+      - ".github/workflows/docs-deploy.yml"
+  workflow_dispatch:
+
+concurrency:
+  group: docs-deploy
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    env:
+      EC2_HOST: ${{ vars.REGISTRY_EC2_HOST }}
+      EC2_INSTANCE_ID: ${{ vars.REGISTRY_EC2_INSTANCE_ID }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+          cache-dependency-path: website/package-lock.json
+
+      - name: Install and build
+        run: |
+          cd website
+          npm ci
+          npm run build
+
+      - uses: aws-actions/configure-aws-credentials@v4
+        with:
+          role-to-assume: arn:aws:iam::${{ vars.AWS_ACCOUNT_ID }}:role/devsper-deploy
+          aws-region: us-east-1
+
+      - name: Deploy to EC2 via Instance Connect
+        run: |
+          # Generate ephemeral SSH key
+          ssh-keygen -t ed25519 -f /tmp/deploy_key -N "" -q
+          aws ec2-instance-connect send-ssh-public-key \
+            --instance-id "$EC2_INSTANCE_ID" \
+            --instance-os-user ubuntu \
+            --ssh-public-key file:///tmp/deploy_key.pub
+
+          # Rsync build output to EC2
+          rsync -azP --delete \
+            -e "ssh -i /tmp/deploy_key -o StrictHostKeyChecking=no" \
+            website/build/ \
+            ubuntu@"$EC2_HOST":/opt/devsper-docs/
+
+          rm -f /tmp/deploy_key /tmp/deploy_key.pub
+
+      - name: Verify deployment
+        run: |
+          sleep 3
+          curl -sf --retry 3 --retry-delay 5 "https://docs.devsper.com/" || \
+            { echo "FAIL: docs site not responding"; exit 1; }
+          echo "Docs deployment verified"

devsper-2.1.6/.github/workflows/publish-plugin.yml

@@ -0,0 +1,35 @@
+name: Publish to devsper Registry
+
+on:
+  push:
+    tags: ["v*.*.*"]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with: { python-version: "3.12" }
+
+      - name: Install build tools
+        run: pip install build devsper
+
+      - name: Validate plugin
+        run: |
+          python -c "
+          import tomllib, sys
+          data = tomllib.load(open('pyproject.toml','rb'))
+          eps = data.get('project',{}).get('entry-points',{})
+          if 'devsper.plugins' not in eps:
+              print('ERROR: No devsper.plugins entry point found')
+              sys.exit(1)
+          print('Plugin entry point found:', eps['devsper.plugins'])
+          "
+
+      - name: Build and publish
+        env:
+          DEVSPER_API_KEY: ${{ secrets.DEVSPER_API_KEY }}
+          DEVSPER_REGISTRY_URL: https://registry.devsper.com
+        run: devsper plugins publish

devsper-2.1.6/.github/workflows/pypi-publish.yml

@@ -0,0 +1,36 @@
+# Publish to PyPI on version tag push using Trusted Publisher (OIDC).
+# PyPI Trusted Publisher config: workflow filename = pypi-publish.yml
+#
+# Triggered by: git tag v1.6.0 && git push origin v1.6.0
+
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  pypi-publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true

devsper-2.1.6/.github/workflows/release-on-tag.yml

@@ -0,0 +1,99 @@
+# When you push a version tag (e.g. v1.6.0), create a GitHub Release, push versioned docs to main, and publish to PyPI.
+# Note: Creating a release with GITHUB_TOKEN does NOT trigger other workflows, so we run versioned-docs and PyPI here.
+#
+# Usage:
+#   git tag v1.6.0
+#   git push origin v1.6.0
+#
+# PyPI: Add a Trusted Publisher on PyPI with workflow filename release-on-tag.yml (job: pypi-publish).
+
+name: Release on tag
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Get version from tag
+        id: version
+        run: |
+          V="${GITHUB_REF#refs/tags/v}"
+          echo "version=$V" >> $GITHUB_OUTPUT
+          echo "Tag: v$V"
+
+      - name: Extract changelog section
+        run: |
+          V="${{ steps.version.outputs.version }}"
+          awk -v ver="$V" '
+            $0 ~ "^## \\[" ver "\\]" { found=1; next }
+            found && /^## \[/ { exit }
+            found { print }
+          ' CHANGELOG.md > release_notes.md
+          [ -s release_notes.md ] || echo "See CHANGELOG.md for details." > release_notes.md
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          name: v${{ steps.version.outputs.version }}
+          body_path: release_notes.md
+          draft: false
+          generate_release_notes: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  push-version-docs:
+    needs: release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout main
+        uses: actions/checkout@v4
+        with:
+          ref: main
+          fetch-depth: 0
+
+      - name: Set up Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+          cache-dependency-path: website/package-lock.json
+
+      - name: Get version from tag
+        id: version
+        run: |
+          V="${GITHUB_REF#refs/tags/v}"
+          echo "version=$V" >> $GITHUB_OUTPUT
+
+      - name: Install and add docs version
+        run: |
+          cd website
+          npm ci
+          V="${{ steps.version.outputs.version }}"
+          if [ -d "versioned_docs/version-$V" ]; then
+            echo "Docs version $V already exists, skipping."
+          else
+            npx docusaurus docs:version "$V"
+          fi
+
+      - name: Push versioned docs to main
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add website/versioned_docs website/versioned_sidebars website/versions.json
+          git diff --staged --quiet || git commit -m "chore(docs): add version ${{ steps.version.outputs.version }}"
+          git push origin HEAD:main
+
+

devsper-2.1.6/.github/workflows/worker-release.yml

@@ -0,0 +1,106 @@
+name: Worker build and release
+
+on:
+  push:
+    branches: [main]
+    tags: ['worker-v*.*.*']
+    paths: ['worker/**']
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    services:
+      redis:
+        image: redis:7-alpine
+        ports: ["6379:6379"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: 1.78.0
+      - uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: worker
+      - name: Test
+        run: cd worker && cargo test
+      - name: Clippy
+        run: cd worker && cargo clippy -- -D warnings
+      - name: Format
+        run: cd worker && cargo fmt --check
+
+  build-and-push:
+    needs: test
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+      - name: Log in to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - name: Get version from tag
+        id: ver
+        run: |
+          if [[ "$GITHUB_REF" == refs/tags/worker-v* ]]; then
+            echo "version=${GITHUB_REF#refs/tags/worker-v}" >> $GITHUB_OUTPUT
+          else
+            echo "version=latest" >> $GITHUB_OUTPUT
+          fi
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ghcr.io/${{ github.repository_owner }}/devsper-worker
+          tags: |
+            type=raw,value=latest,enable=${{ github.ref == 'refs/heads/main' }}
+            type=raw,value=${{ steps.ver.outputs.version }},enable=${{ startsWith(github.ref, 'refs/tags/') }}
+            type=sha,prefix=sha-
+      - name: Build and push
+        id: push
+        uses: docker/build-push-action@v6
+        with:
+          context: worker
+          platforms: linux/amd64,linux/arm64
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+      - name: Generate SBOM
+        uses: anchore/sbom-action@v0.15.0
+        with:
+          image: ghcr.io/${{ github.repository_owner }}/devsper-worker@${{ steps.push.outputs.digest }}
+          format: spdx-json
+          output-file: sbom.spdx.json
+      - name: Sign image
+        uses: sigstore/cosign-installer@v3
+      - run: cosign sign --yes ghcr.io/${{ github.repository_owner }}/devsper-worker@${{ steps.push.outputs.digest }}
+
+  update-docs:
+    needs: build-and-push
+    if: startsWith(github.ref, 'refs/tags/worker-v')
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Extract version
+        id: ver
+        run: echo "version=${GITHUB_REF#refs/tags/worker-v}" >> $GITHUB_OUTPUT
+      - name: Update worker README pull example
+        run: |
+          sed -i "s/:latest/:${{ steps.ver.outputs.version }}/" worker/README.md
+          sed -i "s/:latest/:${{ steps.ver.outputs.version }}/" worker/README.md || true
+      - name: Commit and push
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add worker/README.md
+          git diff --staged --quiet || git commit -m "chore: update worker image tag to ${{ steps.ver.outputs.version }}"
+          git push || true

devsper-2.1.6/.gitignore

@@ -0,0 +1,59 @@
+# Python
+__pycache__/
+*.py[oc]
+*.egg-info
+build/
+dist/
+wheels/
+.ruff_cache
+.pytest_cache
+.mypy_cache/
+
+# Virtual environments
+.venv
+.venv/
+venv/
+env/
+
+# Environment and secrets
+.env
+.env.local
+.env.*.local
+.env.registry
+.env.registry.dev
+registry/.env
+
+# Hivemind runtime and output
+.hivemind/
+.events/
+
+# Example outputs (generated)
+examples/output/
+
+# MkDocs build output
+site/
+
+# Docusaurus (website/)
+website/node_modules/
+website/build/
+website/.docusaurus/
+website/.cache/
+
+# System
+.DS_Store
+Thumbs.db
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+.cursor/
+
+tmp
+**/build-errors.log
+
+node_modules
+
+# Rust (worker crate)
+worker/target/

devsper-2.1.6/.python-version

@@ -0,0 +1 @@
+3.12