akgentic-team 1.5.0__tar.gz

akgentic_team-1.5.0/.env.example

@@ -0,0 +1,21 @@
+# Example environment variables for akgentic-team storage backends.
+# Copy to .env and fill in values for your deployment. The team library
+# itself does NOT read these — env-var resolution happens at the wiring
+# layer (application startup / infra code). NagraEventStore takes a
+# plain connection string directly.
+
+# Nagra / PostgreSQL backend — used by the `[postgres]` extra.
+# Shared verbatim with akgentic-catalog (same DB, disjoint tables:
+#   catalog owns  template_entries / tool_entries / agent_entries / team_entries
+#   team owns     team_process_entries / event_entries / agent_state_entries
+# ).
+POSTGRES_SERVER=
+POSTGRES_PORT=5432
+POSTGRES_USER=
+POSTGRES_PASSWORD=
+POSTGRES_DB=
+# Full libpq URL; what NagraEventStore receives as `conn_string`.
+DB_CONN_STRING_PERSISTENCE=
+
+# MongoDB backend — used by the `[mongo]` extra.
+MONGO_URI=

akgentic_team-1.5.0/.github/workflows/ci.yml

@@ -0,0 +1,106 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+    branches: [master]
+  workflow_dispatch:
+
+env:
+  NO_COLOR: "1"
+  # Release channel for akgentic-* dependencies. On a release branch set this
+  # to that branch (e.g. version-1.x); sibling akgentic-* packages are built
+  # from this branch into the local wheelhouse.
+  RELEASE_BRANCH: master
+  # Transitive closure of akgentic-* dependencies, space-separated. uv resolves
+  # the graph from the wheelhouse, so order does not matter.
+  AKGENTIC_DEPS: "akgentic-core"
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    services:
+      postgres:
+        image: postgres:16-alpine
+        env:
+          POSTGRES_USER: akgentic
+          POSTGRES_PASSWORD: akgentic
+          POSTGRES_DB: akgentic_test
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd="pg_isready -U akgentic"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=5
+    env:
+      POSTGRES_SERVER: localhost
+      POSTGRES_PORT: "5432"
+      POSTGRES_USER: akgentic
+      POSTGRES_PASSWORD: akgentic
+      POSTGRES_DB: akgentic_test
+      DB_CONN_STRING_PERSISTENCE: postgresql://akgentic:akgentic@localhost:5432/akgentic_test
+    steps:
+      - name: Checkout akgentic-team
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          version: "latest"
+
+      - name: Set up Python 3.12
+        run: uv python install 3.12
+
+      # Build every akgentic-* dependency from RELEASE_BRANCH into a local
+      # wheelhouse. uv pip install --find-links then resolves them from there;
+      # all other (PyPI) deps still come from the default index.
+      - name: Build akgentic-* dependency wheelhouse
+        run: |
+          mkdir -p wheelhouse
+          for dep in ${AKGENTIC_DEPS}; do
+            echo "::group::build ${dep} @ ${RELEASE_BRANCH}"
+            git clone --depth 1 --branch "${RELEASE_BRANCH}" \
+              "https://github.com/b12consulting/${dep}.git" "/tmp/${dep}"
+            uv build --wheel --out-dir wheelhouse "/tmp/${dep}"
+            echo "::endgroup::"
+          done
+          ls -1 wheelhouse
+
+      - name: Create virtual environment
+        run: uv venv
+
+      # Install the package editable, resolving akgentic-* deps from the
+      # wheelhouse and everything else from PyPI. All optional extras are
+      # listed so mypy can analyze their imports (postgres, mongo, cli).
+      - name: Install dependencies
+        run: uv pip install --find-links wheelhouse -e ".[dev,mongo,postgres,cli]"
+
+      # --no-sync: run in the wheelhouse-built venv without re-resolving from a
+      # lockfile (there is no project lockfile in this install model).
+      - name: Type checking
+        run: uv run --no-sync mypy src/
+
+      - name: Linting
+        run: uv run --no-sync ruff check src/
+
+      - name: Run tests with coverage
+        run: >
+          uv run --no-sync pytest tests/
+          --cov=akgentic.team
+          --cov-report=term-missing
+          --cov-report=json:coverage.json
+          --cov-fail-under=80
+
+      - name: Update coverage badge
+        if: github.ref_name == 'master' && github.event_name == 'push'
+        run: |
+          COVERAGE=$(python -c "import json; print(round(float(json.load(open('coverage.json'))['totals']['percent_covered_display'])))")
+          if [ "$COVERAGE" -ge 90 ]; then COLOR="brightgreen"
+          elif [ "$COVERAGE" -ge 80 ]; then COLOR="green"
+          elif [ "$COVERAGE" -ge 70 ]; then COLOR="yellow"
+          else COLOR="red"; fi
+          echo "{\"schemaVersion\":1,\"label\":\"coverage\",\"message\":\"${COVERAGE}%\",\"color\":\"${COLOR}\"}" > badge.json
+          gh gist edit 708bb547b8679308d083be7beaf4448a -f coverage.json badge.json
+        env:
+          GH_TOKEN: ${{ secrets.GH_PAT }}

akgentic_team-1.5.0/.github/workflows/release.yml

@@ -0,0 +1,69 @@
+name: Release
+
+# Manual release: reads version from pyproject.toml on master, tags master HEAD,
+# builds the wheel, and creates a GitHub Release with the wheel attached.
+#
+# Bumping the version is a separate maintainer action via a normal PR. This
+# workflow does NOT push commits to master — branch protection blocks that.
+# The release flow is therefore two-step:
+#   1. Open a "chore: bump version to X.Y.Z" PR; merge it.
+#   2. Trigger this workflow from the Actions tab.
+
+on:
+  workflow_dispatch:
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout master
+        uses: actions/checkout@v6
+        with:
+          ref: master
+          fetch-depth: 0
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          version: "latest"
+
+      - name: Set up Python 3.12
+        run: uv python install 3.12
+
+      - name: Read version from pyproject.toml
+        id: version
+        run: |
+          VERSION=$(grep -E '^version = ' pyproject.toml | sed -E 's/version = "(.*)"/\1/')
+          echo "Releasing version: $VERSION"
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+
+      - name: Verify tag does not already exist
+        env:
+          VERSION: ${{ steps.version.outputs.version }}
+        run: |
+          if git rev-parse "v$VERSION" >/dev/null 2>&1; then
+            echo "::error::Tag v$VERSION already exists. Bump the version in pyproject.toml first."
+            exit 1
+          fi
+
+      - name: Tag master HEAD
+        env:
+          VERSION: ${{ steps.version.outputs.version }}
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git tag "v$VERSION"
+          git push origin "v$VERSION"
+
+      - name: Build wheel
+        run: uv build --wheel --out-dir dist/
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: "v${{ steps.version.outputs.version }}"
+          name: "v${{ steps.version.outputs.version }}"
+          files: dist/*.whl
+          generate_release_notes: true

akgentic_team-1.5.0/.gitignore

@@ -0,0 +1,27 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+**/settings.local.json
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Type checking
+.mypy_cache/
+.dmypy.json
+
+# Virtual environments
+.venv/
+venv/
+
+# IDE
+.vscode/
+.idea/