spryng-agent 0.1.1__tar.gz

spryng_agent-0.1.1/.env.example

@@ -0,0 +1,40 @@
+# claude-code-runner — operator config.
+#
+# Copy to .env, fill in values, then `uvicorn runner.main:app`.
+
+# Bind address. 0.0.0.0:8088 for a sidecar container; 127.0.0.1:8088
+# behind a reverse proxy.
+RUNNER_HOST=0.0.0.0
+RUNNER_PORT=8088
+
+# Bearer token Spryng's adapter sends in the `Authorization` header
+# on every `POST /jobs` and `POST /jobs/<id>/cancel`. Pick a random
+# string (32+ bytes) and put the same value in the AgentRuntimeConfig
+# row in Spryng under "Credential".
+RUNNER_AUTH_TOKEN=CHANGE_ME
+
+# Where the `claude` CLI lives. Defaults to `claude` on PATH. Point at
+# a specific binary if you have multiple installs.
+CLAUDE_CLI_BINARY=claude
+
+# Working-directory root. Every job gets a fresh subdirectory under
+# this path; cleaned up after the job terminates. Use a fast local
+# volume (not NFS) for best subprocess performance.
+RUNNER_WORKDIR_ROOT=/tmp/spryng-runs
+
+# Job retention: how long completed/failed/cancelled jobs stay in the
+# in-memory store before they're GC'd. Spryng polls during the run
+# itself, so 1h is comfortably more than enough.
+RUNNER_JOB_TTL_SECONDS=3600
+
+# How often the runner polls Spryng's `/agent-runs/<id>/` to detect
+# state transitions (e.g. awaiting_approval -> executing after a
+# human approves). Lower = more responsive, higher = less load.
+RUNNER_SPRYNG_POLL_INTERVAL_SECONDS=15
+
+# Safety cap on outbound callbacks. The Spryng base URL is supplied
+# in every job payload; this regex is matched against `scheme://host`
+# to prevent SSRF if a malicious payload tries to redirect callbacks
+# elsewhere. Comma-separated list of allowed hosts; '*' allows all
+# (NOT recommended in prod).
+RUNNER_ALLOWED_CALLBACK_HOSTS=app.spryng.io,qa.spryng.io

spryng_agent-0.1.1/.github/workflows/publish-image.yml

@@ -0,0 +1,58 @@
+# Build + publish the runner image to GitHub Container Registry (GHCR) so
+# customers can pull it for self-hosting (no access to the private repo / our
+# ECR needed). Runs on a version tag (v0.1.0) and can be dispatched manually.
+#
+# After the first run, make the package public:
+#   GitHub → Packages → claude-code-runner → Package settings → Visibility: Public.
+name: publish-image
+
+on:
+  push:
+    tags: ['v*']
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'Image tag (e.g. 0.1.0)'
+        required: true
+        default: '0.1.0'
+
+jobs:
+  build-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Resolve tag + image (GHCR requires a lowercase repo name)
+        id: meta
+        run: |
+          if [ "${{ github.event_name }}" = "push" ]; then
+            echo "value=${GITHUB_REF_NAME#v}" >> "$GITHUB_OUTPUT"
+          else
+            echo "value=${{ github.event.inputs.tag }}" >> "$GITHUB_OUTPUT"
+          fi
+          owner_lc="$(echo "${{ github.repository_owner }}" | tr '[:upper:]' '[:lower:]')"
+          echo "image=ghcr.io/${owner_lc}/claude-code-runner" >> "$GITHUB_OUTPUT"
+
+      - 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: Build + push
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          platforms: linux/amd64
+          push: true
+          tags: |
+            ${{ steps.meta.outputs.image }}:${{ steps.meta.outputs.value }}
+            ${{ steps.meta.outputs.image }}:latest
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

spryng_agent-0.1.1/.github/workflows/publish-pypi.yml

@@ -0,0 +1,37 @@
+# Publish the `spryng-agent` package to PyPI on a version tag, via PyPI
+# Trusted Publishing (OIDC) — no API token stored anywhere.
+#
+# ONE-TIME SETUP (PyPI side, see RELEASING.md):
+#   PyPI → your account → Publishing → "Add a pending publisher":
+#     PyPI project name: spryng-agent
+#     Owner:             ScrumDoLLC
+#     Repository:        claude-code-runner
+#     Workflow name:     publish-pypi.yml
+#   The first tagged run then creates + publishes the project.
+name: publish-pypi
+
+on:
+  push:
+    tags: ['v*']
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build-publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write   # required for PyPI Trusted Publishing
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - name: Build sdist + wheel
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

spryng_agent-0.1.1/.gitignore

@@ -0,0 +1,19 @@
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+.eggs/
+build/
+dist/
+
+.env
+.venv/
+venv/
+
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+
+# Job workdirs
+/tmp/spryng-runs/