agent-circus 0.1.0__tar.gz

agent_circus-0.1.0/.envrc.dist

@@ -0,0 +1,15 @@
+eval "$(devenv direnvrc)"
+
+use devenv
+
+if [ -f .env.enc ]; then
+    set -a
+    eval $(sops --decrypt --input-type dotenv --output-type dotenv .env.enc)
+    set +a
+fi
+
+if [ -f .env ]; then
+    set -a
+    . .env
+    set +a
+fi

agent_circus-0.1.0/.github/dependabot.yml

@@ -0,0 +1,58 @@
+version: 2
+
+updates:
+  - package-ecosystem: uv
+    directory: /
+    target-branch: develop
+    schedule:
+      interval: weekly
+      day: monday
+      time: "06:00"
+      timezone: Europe/Vienna
+    open-pull-requests-limit: 5
+    groups:
+      python-dependencies:
+        patterns:
+          - "*"
+
+  - package-ecosystem: uv
+    directory: /src/agent_circus/templates/agent-circus
+    target-branch: develop
+    schedule:
+      interval: weekly
+      day: monday
+      time: "06:15"
+      timezone: Europe/Vienna
+    open-pull-requests-limit: 5
+    groups:
+      template-python-dependencies:
+        patterns:
+          - "*"
+
+  - package-ecosystem: github-actions
+    directory: /
+    target-branch: develop
+    schedule:
+      interval: weekly
+      day: monday
+      time: "06:30"
+      timezone: Europe/Vienna
+    open-pull-requests-limit: 5
+    groups:
+      github-actions:
+        patterns:
+          - "*"
+
+  - package-ecosystem: docker
+    directory: /src/agent_circus/templates/agent-circus
+    target-branch: develop
+    schedule:
+      interval: weekly
+      day: monday
+      time: "06:45"
+      timezone: Europe/Vienna
+    open-pull-requests-limit: 5
+    groups:
+      docker-images:
+        patterns:
+          - "*"

agent_circus-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,43 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - develop
+      - main
+  pull_request:
+    branches:
+      - develop
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  checks:
+    name: Checks
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v7
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v10.0.1
+        with:
+          enable-cache: true
+          version: latest-known
+
+      - name: Install Python
+        run: uv python install 3.14
+
+      - name: Install dependencies
+        run: uv sync --locked --all-groups
+
+      - name: Run checks
+        run: make check

agent_circus-0.1.0/.github/workflows/publish-pypi.yml

@@ -0,0 +1,106 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build and verify distributions
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out release tag
+        uses: actions/checkout@v7
+        with:
+          ref: ${{ github.event.release.tag_name }}
+          persist-credentials: false
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v10.0.1
+        with:
+          enable-cache: false
+          version: latest-known
+
+      - name: Install Python
+        run: uv python install 3.14
+
+      - name: Validate release version
+        env:
+          RELEASE_TAG: ${{ github.event.release.tag_name }}
+        run: |
+          if [[ ! "$RELEASE_TAG" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "Release tag must be a stable vMAJOR.MINOR.PATCH tag: $RELEASE_TAG" >&2
+            exit 1
+          fi
+
+          uv run --no-project --python 3.14 python - <<'PY'
+          import os
+          import pathlib
+          import tomllib
+
+          tag_version = os.environ["RELEASE_TAG"].removeprefix("v")
+          with pathlib.Path("pyproject.toml").open("rb") as file:
+              project_version = tomllib.load(file)["project"]["version"]
+
+          if tag_version != project_version:
+              raise SystemExit(
+                  "Release version does not match: "
+                  f"release tag={tag_version!r}, pyproject.toml={project_version!r}"
+              )
+
+          print(f"Validated release version {tag_version}")
+          PY
+
+      - name: Build distributions
+        run: uv build --no-sources
+
+      - name: Validate distribution metadata
+        run: uv run --with twine twine check --strict dist/*
+
+      - name: Smoke test wheel
+        run: uv run --isolated --no-project --with dist/*.whl tests/smoke_test_package.py
+
+      - name: Smoke test source distribution
+        run: uv run --isolated --no-project --with dist/*.tar.gz tests/smoke_test_package.py
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v7
+        with:
+          name: distributions
+          path: dist/
+          if-no-files-found: error
+          retention-days: 7
+
+  publish:
+    name: Publish distributions
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/agent-circus/
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v10.0.1
+        with:
+          enable-cache: false
+          version: latest-known
+
+      - name: Download distributions
+        uses: actions/download-artifact@v8
+        with:
+          name: distributions
+          path: dist/
+
+      - name: Generate PEP 740 attestations
+        uses: astral-sh/attest-action@v0.0.6
+
+      - name: Publish to PyPI
+        run: uv publish

agent_circus-0.1.0/.github/workflows/publish-testpypi.yml

@@ -0,0 +1,77 @@
+name: Publish to TestPyPI
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build and verify distributions
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v10.0.1
+        with:
+          enable-cache: false
+          version: latest-known
+
+      - name: Install Python
+        run: uv python install 3.14
+
+      - name: Build distributions
+        run: uv build --no-sources
+
+      - name: Validate distribution metadata
+        run: uv run --with twine twine check --strict dist/*
+
+      - name: Smoke test wheel
+        run: uv run --isolated --no-project --with dist/*.whl tests/smoke_test_package.py
+
+      - name: Smoke test source distribution
+        run: uv run --isolated --no-project --with dist/*.tar.gz tests/smoke_test_package.py
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v7
+        with:
+          name: distributions
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    name: Publish distributions
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/project/agent-circus/
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v10.0.1
+        with:
+          enable-cache: false
+          version: latest-known
+
+      - name: Download distributions
+        uses: actions/download-artifact@v8
+        with:
+          name: distributions
+          path: dist/
+
+      - name: Publish to TestPyPI
+        run: uv publish --index testpypi

agent_circus-0.1.0/.github/workflows/security.yml

@@ -0,0 +1,57 @@
+name: Security
+
+on:
+  push:
+    branches:
+      - develop
+      - main
+  pull_request:
+    branches:
+      - develop
+      - main
+  schedule:
+    - cron: "27 5 * * 1"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pull-requests: read
+
+concurrency:
+  group: security-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  dependency-review:
+    name: Dependency review
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request'
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v7
+
+      - name: Review dependency changes
+        uses: actions/dependency-review-action@v5
+        with:
+          fail-on-severity: moderate
+
+  uv-audit:
+    name: uv audit
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v7
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v10.0.1
+        with:
+          enable-cache: true
+          version: latest-known
+
+      - name: Install Python
+        run: uv python install 3.14
+
+      - name: Audit locked dependencies
+        run: make audit

agent_circus-0.1.0/.gitignore

@@ -0,0 +1,179 @@
+# ---> Python
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# AI
+.agent-shell/
+.claude/
+
+# others
+.direnv/
+.devenv/
+
+# Node
+node_modules/
+
+# agent-circus
+.agent-circus/
+

agent_circus-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,33 @@
+---
+repos:
+- repo: https://github.com/astral-sh/ruff-pre-commit
+  rev: v0.15.0
+  hooks:
+  - id: ruff-check
+    args: [--fix]
+  - id: ruff-format
+- repo: https://github.com/astral-sh/ty-pre-commit
+  # ty version.
+  rev: v0.0.58
+  hooks:
+  - id: ty
+- repo: local
+  hooks:
+  - id: pytest
+    name: pytest
+    entry: uv run pytest
+    language: system
+    pass_filenames: false
+    always_run: true
+  - id: uv-audit
+    name: uv audit (root)
+    entry: uv audit --locked
+    language: system
+    pass_filenames: false
+    files: ^(pyproject\.toml|uv\.lock)$
+  - id: uv-audit-agent-circus-template
+    name: uv audit (agent-circus template)
+    entry: uv --directory src/agent_circus/templates/agent-circus audit --locked
+    language: system
+    pass_filenames: false
+    files: ^src/agent_circus/templates/agent-circus/(pyproject\.toml|uv\.lock)$

agent_circus-0.1.0/.yamlfmt

@@ -0,0 +1,27 @@
+continue_on_error: false
+doublestar: false
+exclude: []
+extensions:
+  - yaml
+  - yml
+gitignore_excludes: false
+gitignore_path: .gitignore
+include: []
+line_ending: lf
+output_format: default
+regex_exclude: []
+formatter:
+  disallow_anchors: false
+  drop_merge_tag: false
+  eof_newline: false
+  include_document_start: true
+  indent: 2
+  indentless_arrays: true
+  line_ending: lf
+  max_line_length: 0
+  pad_line_comments: 2
+  retain_line_breaks: true
+  retain_line_breaks_single: true
+  scan_folded_as_literal: false
+  trim_trailing_whitespace: false
+  type: basic

agent_circus-0.1.0/.yamllint.yaml

@@ -0,0 +1,12 @@
+---
+extends: default
+
+rules:
+  indentation:
+    spaces: 2
+    indent-sequences: false
+  line-length:
+    allow-non-breakable-words: true
+    max: 120
+
+  document-start: disable

agent_circus-0.1.0/AGENTS.md

@@ -0,0 +1,61 @@
+# AGENTS.md
+
+## Repository Overview
+
+- Purpose: CLI tool for running AI coding agents in sandboxed Docker containers.
+- Core tech: Python, Docker, Docker Compose, Typer, pytest, uv, ruff, ty.
+
+Used (minimum) versions can be found in pyproject.toml.
+
+## Layout
+
+- `tests/`: unit tests for the agent-circus tool.
+- `src/`: source code of this repository/agent-circus
+- `src/agent_circus/templates`: dependencies and versions for containerized agents/libraries
+- `pyproject.toml`: formal description of the project environment/dependencies
+
+## Common Commands
+
+Always prefix any python-related command with `uv run`, e.g.:
+
+- Run tests: `uv run pytest`
+  - Run test "name": `uv run pytest -k name`
+  - Run test with marker "marker": `uv run pytest -m marker`
+  - Run test in specific path "tests/file.py": `uv run pytest tests/file.py`
+- Collect tests: `uv run pytest --co`
+- Lint/format: `uv run ruff check`, `uv run ruff format --check`, `uv run ty check`
+
+## Commit Messages
+
+For agent template dependency update commits, use this format:
+
+```text
+chore: update agent template dependencies
+
+Updated versions:
+
+- <tool>: <old> -> <new>
+
+Python dependency updates:
+
+- <package>: <old> -> <new>
+
+Signed-off-by: <name> <email>
+```
+
+- Omit a section if there are no entries for it.
+- Use the package/tool names as they appear in the project where practical, preserving established capitalization from previous dependency update commits.
+- Include transitive Python dependency changes from `uv.lock` under "Python dependency updates".
+
+## Testing Patterns
+
+- Naming: `test_<feature>_<scenario>.py`, test functions `test_<action>_<expected_outcome>`
+- Create tests for utility functions such as parsing functions.
+- You won't be able to run any docker-related commands because you are running inside a container and you don't have the docker socket mounted into it.
+
+## Implementation Details
+
+- Add concise/precise docstrings to utility functions.
+  - Docstrings use Python Sphinx format (e.g. `:param foo:`, `:returns:`, `:raises ValueError:`).
+- Add Python typing hints where possible.
+- Prefer pragmatic solutions; if a shortcut is taken, call out the shortcomings explicitly.

agent_circus-0.1.0/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

agent_circus-0.1.0/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 rpoisel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.