akgentic-core 1.5.0__tar.gz

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

@@ -0,0 +1,55 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+    branches: [master]
+  workflow_dispatch:
+
+env:
+  NO_COLOR: "1"
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout akgentic-core
+        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
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Type checking
+        run: uv run mypy src/
+
+      - name: Linting
+        run: uv run ruff check src/
+
+      - name: Run tests with coverage
+        run: >
+          uv run pytest tests/
+          --cov=akgentic.core
+          --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(int(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 5fae2fa4f4f3cd3fc5cc08f5d2a7da44 -f coverage.json badge.json
+        env:
+          GH_TOKEN: ${{ secrets.GH_PAT }}

akgentic_core-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_core-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/

akgentic_core-1.5.0/.python-version

@@ -0,0 +1 @@
+3.12

akgentic_core-1.5.0/CONTRIBUTING.md

@@ -0,0 +1,94 @@
+# Contributing to Akgentic v2
+
+## Development Setup
+
+1. Clone the repository
+2. Install uv: https://docs.astral.sh/uv/getting-started/installation/
+3. Install dependencies:
+   ```bash
+   cd akgentic-core
+   uv sync --dev
+   ```
+
+## Code Quality Requirements
+
+All contributions must pass these checks before merging:
+
+### Type Checking (mypy)
+
+```bash
+uv run mypy src/
+```
+
+- Strict mode enabled (no untyped definitions allowed)
+- All public APIs must have complete type annotations
+- Use Python 3.12+ type syntax (`|` for unions, not `Optional`)
+
+### Linting (ruff)
+
+```bash
+# Check for issues
+uv run ruff check src/
+
+# Auto-fix issues
+uv run ruff check --fix src/
+```
+
+- Rules enforced: E, F, I, N, UP, ANN, ASYNC
+- Line length: 100 characters
+
+### Testing (pytest)
+
+```bash
+# Run tests
+uv run pytest
+
+# Run with coverage
+uv run pytest --cov=src/akgentic --cov-report=term-missing
+```
+
+- Minimum 80% code coverage required
+- All public APIs must have unit tests
+
+## Type Hint Guidelines
+
+Use modern Python 3.12+ type syntax:
+
+```python
+# Correct
+def get_agent(self, agent_id: str) -> ActorRef | None: ...
+self.state_dict: dict[str, BaseState | dict] = {}
+
+# Incorrect (old style)
+from typing import Optional, Dict, Union
+def get_agent(self, agent_id: str) -> Optional[ActorRef]: ...
+```
+
+## Docstring Style
+
+Use Google-style docstrings for all public APIs:
+
+```python
+def create_agent(self, config: AgentConfig) -> ActorRef:
+    """Create and start a new agent actor.
+
+    Args:
+        config: Configuration object for the agent
+
+    Returns:
+        Reference to the created actor
+
+    Raises:
+        ValueError: If config is invalid
+    """
+```
+
+## Pull Request Checklist
+
+Before submitting a PR:
+
+- [ ] `uv run mypy src/` passes with zero errors
+- [ ] `uv run ruff check src/` passes with zero violations
+- [ ] `uv run pytest` passes with 80%+ coverage
+- [ ] All public APIs have type hints
+- [ ] All public APIs have Google-style docstrings