akgentic-team 1.3.5__tar.gz

akgentic_team-1.3.5/.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.3.5/.github/workflows/ci.yml

@@ -0,0 +1,97 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+    branches: [master]
+  workflow_dispatch:
+
+env:
+  NO_COLOR: "1"
+
+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 workspace
+        uses: actions/checkout@v6
+        with:
+          repository: b12consulting/akgentic-quick-start
+          # Pin to the 1.x-compatible workspace; the default branch (master) is
+          # stale and not compatible with the enterprise alpha line.
+          ref: feat/enterprise-alpha-release-4
+          submodules: recursive
+          token: ${{ secrets.GH_PAT }}
+
+      - name: Override team submodule with current branch
+        working-directory: packages/akgentic-team
+        run: |
+          git fetch origin ${{ github.head_ref || github.ref_name }}
+          git checkout FETCH_HEAD
+
+      - name: Ensure team package in workspace
+        run: |
+          if ! grep -q 'akgentic-team' pyproject.toml; then
+            sed -i 's/"akgentic-catalog",/"akgentic-catalog",\n    "akgentic-team",/' pyproject.toml
+            sed -i 's|"packages/akgentic-catalog",|"packages/akgentic-catalog",\n    "packages/akgentic-team",|' pyproject.toml
+            sed -i 's/akgentic-catalog = { workspace = true }/akgentic-catalog = { workspace = true }\nakgentic-team = { workspace = true }/' pyproject.toml
+          fi
+
+      - 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: Install dependencies
+        run: uv sync --all-packages --all-extras
+
+      - name: Type checking
+        run: uv run mypy packages/akgentic-team/src/
+
+      - name: Linting
+        run: uv run ruff check packages/akgentic-team/src/
+
+      - name: Run tests with coverage
+        run: >
+          uv run pytest packages/akgentic-team/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.3.5/.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.3.5/.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/