superbrowser-sdk 2.0.0__tar.gz

superbrowser_sdk-2.0.0/.env.example

@@ -0,0 +1,26 @@
+# Super Browser Environment Variables
+# Copy this file to .env and fill in your values.
+# Config.from_env() reads these automatically.
+
+# --- LLM Provider ---
+# Required: Your AI provider API key
+ANTHROPIC_API_KEY=
+OPENAI_API_KEY=
+
+# Optional: Override the default provider ("anthropic" or "openai")
+LLM_PROVIDER=anthropic
+
+# Optional: Override the default model
+LLM_MODEL=claude-sonnet-4-20250514
+
+# --- Budget ---
+# Maximum daily spend in USD (default: 10.0)
+BUDGET_DAILY_CAP_USD=10.0
+
+# --- Browser ---
+# Run browser in headless mode (default: true)
+HEADLESS=true
+
+# --- Debug ---
+# Enable debug mode with screenshots and DOM snapshots
+DEBUG=false

superbrowser_sdk-2.0.0/.github/workflows/dco.yml

@@ -0,0 +1,58 @@
+name: DCO
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Verify DCO Sign-off
+        run: |
+          BASE="${{ github.base_ref }}"
+          unsigned=""
+          count=0
+
+          while IFS= read -r commit; do
+            subject=$(git log -1 --format="%s" "$commit")
+            if ! git log -1 --format="%B" "$commit" | grep -qE "^Signed-off-by:"; then
+              unsigned="${unsigned}  • ${subject}\n  https://github.com/${{ github.repository }}/commit/${commit}\n\n"
+              count=$((count + 1))
+            fi
+          done < <(git log "origin/${BASE}..HEAD" --no-merges --format="%H")
+
+          if [ -n "$unsigned" ]; then
+            echo ""
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo "❌ DCO check failed: ${count} commit(s) missing Signed-off-by"
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo ""
+            echo "The following commits need a sign-off:"
+            echo ""
+            echo -e "$unsigned"
+            echo "How to fix:"
+            echo ""
+            echo "  1. Add your sign-off to the latest commit:"
+            echo "     \$ git commit --amend --signoff"
+            echo ""
+            echo "  2. If you have multiple unsigned commits, sign all of them:"
+            echo "     \$ git rebase --signoff origin/${BASE}"
+            echo ""
+            echo "  3. Force-push your branch:"
+            echo "     \$ git push --force-with-lease"
+            echo ""
+            echo "What is DCO?"
+            echo "  https://developercertificate.org/"
+            echo ""
+            echo "By signing off, you certify that you wrote or have the right"
+            echo "to submit the code under the project's license."
+            echo ""
+            exit 1
+          fi
+
+          echo "✅ All commits have proper DCO sign-off"

superbrowser_sdk-2.0.0/.github/workflows/publish.yml

@@ -0,0 +1,32 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # Trusted publisher
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Verify package
+        run: twine check dist/*
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        # Uses trusted publisher (no API token needed)

superbrowser_sdk-2.0.0/.github/workflows/test.yml

@@ -0,0 +1,79 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install ruff
+      - run: ruff check src/ tests/
+
+  mypy-check:
+    needs: lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install package with dev deps
+        run: pip install -e ".[dev,all]"
+      - name: Type-check protocols and backends
+        run: >
+          python -m mypy
+          src/super_browser/browser/engine.py
+          src/super_browser/browser/backends/
+          --ignore-missing-imports
+
+  test:
+    needs: [lint, mypy-check]
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-latest, macos-latest, ubuntu-latest]
+        python-version: ["3.11", "3.12"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package with dev deps
+        run: pip install -e ".[dev,all]"
+
+      - name: Install Patchright browser
+        run: python -m patchright install chromium
+
+      - name: Run tests
+        run: >
+          python -m pytest tests/
+          -p no:benchmark
+          -m "not flaky"
+          --ignore=tests/e2e_full_journey.py
+          --ignore=tests/e2e_advanced.py
+          --ignore=tests/e2e_quickstart.py
+          --ignore=tests/e2e_edge_cases.py
+          --ignore=tests/e2e/
+          --ignore=tests/pattern_validation.py
+          --ignore=tests/stealth_detection/
+          --ignore=tests/discovery/
+          -q
+        env:
+          PYTHONIOENCODING: utf-8
+
+      - name: Upload coverage
+        if: matrix.python-version == '3.12' && matrix.os == 'ubuntu-latest'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: .coverage

superbrowser_sdk-2.0.0/.gitignore

@@ -0,0 +1,63 @@
+# Python bytecode
+__pycache__/
+*.pyc
+*.pyo
+*.py[cod]
+
+# Test / type caches
+.pytest_cache/
+.mypy_cache/
+.benchmarks/
+.coverage
+htmlcov/
+
+# Build artifacts
+dist/
+build/
+*.egg-info/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+
+# Environment / secrets
+.env
+*.env.local
+
+# IDE
+.vscode/
+.idea/
+.claude-plugin/
+statuses/
+
+# Logs
+*.log
+
+# AIV working documents (per-Batch docs)
+docs/aiv/
+!docs/aiv/AIV_FRAMEWORK_v5.3.md
+
+# Session data
+sessions/
+views.json
+/config.json
+=10.0
+Analysis-Framework/
+*.png
+!Super-Browser.png
+
+# Lock files
+uv.lock
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Spill directory
+~/.super-browser/spill/
+*/__pycache__/
+NUL
+sessions/
+sources/
+events.jsonl

superbrowser_sdk-2.0.0/.pre-commit-config.yaml

@@ -0,0 +1,14 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.4.10
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.10.0
+    hooks:
+      - id: mypy
+        args: [--ignore-missing-imports]
+        additional_dependencies: []