django-ag-ui 0.1.0__tar.gz

django_ag_ui-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,54 @@
+name: release
+
+# Main-triggered: every merge to `main` runs `release-publish-prepare`, which
+# short-circuits to a no-op unless the version in source has been bumped past
+# the most recent `vX.Y.Z` tag.
+on:
+  push:
+    branches: [main]
+
+concurrency:
+  group: release-main
+  cancel-in-progress: false
+
+jobs:
+  release:
+    name: release
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/django-ag-ui
+    permissions:
+      id-token: write   # PyPI OIDC trusted publishing
+      contents: write   # tag push + gh release create
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+      - uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+      - name: Install
+        run: uv sync --all-groups
+
+      - name: Prepare release (version check, test, build dist)
+        id: prepare
+        run: make release-publish-prepare
+
+      - name: Publish to PyPI
+        if: steps.prepare.outputs.released == 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+      - name: Tag + GitHub Release
+        if: steps.prepare.outputs.released == 'true'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: make release-publish-finalize
+
+      - name: Deploy docs to gh-pages
+        if: steps.prepare.outputs.released == 'true' && hashFiles('mkdocs.yml') != ''
+        run: |
+          git config user.name 'github-actions[bot]'
+          git config user.email '41898282+github-actions[bot]@users.noreply.github.com'
+          DJANGO_SETTINGS_MODULE=tests.conftest_settings \
+            uv run mkdocs gh-deploy --force --clean --config-file mkdocs.yml

django_ag_ui-0.1.0/.github/workflows/tests.yml

@@ -0,0 +1,95 @@
+name: tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+concurrency:
+  group: tests-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+      - name: Install
+        run: uv sync --all-groups
+      - name: ruff check
+        run: uv run ruff check .
+      - name: ruff format check
+        run: uv run ruff format --check --diff .
+      - name: ty
+        run: uv run ty check django_ag_ui
+
+  docs:
+    name: docs build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+      - name: Install with docs group
+        run: uv sync --all-groups
+      - name: mkdocs build --strict
+        run: DJANGO_SETTINGS_MODULE=tests.conftest_settings uv run mkdocs build --strict
+
+  test:
+    name: ${{ matrix.python-version }} / Django ${{ matrix.django-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+        django-version: ["4.2", "5.0", "5.1", "5.2", "6.0"]
+        exclude:
+          # Django 4.2 supports Python 3.8–3.12
+          - python-version: "3.13"
+            django-version: "4.2"
+          - python-version: "3.14"
+            django-version: "4.2"
+          # Django 5.0 supports Python 3.10–3.12
+          - python-version: "3.13"
+            django-version: "5.0"
+          - python-version: "3.14"
+            django-version: "5.0"
+          # Django 5.1 supports Python 3.10–3.13
+          - python-version: "3.14"
+            django-version: "5.1"
+          # Django 6.0 requires Python 3.12+
+          - python-version: "3.10"
+            django-version: "6.0"
+          - python-version: "3.11"
+            django-version: "6.0"
+
+    steps:
+      - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+      - name: Install Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+      - name: Sync dev deps
+        run: uv sync --all-groups --python ${{ matrix.python-version }}
+      - name: Pin Django ${{ matrix.django-version }}
+        run: uv pip install --reinstall-package django "django~=${{ matrix.django-version }}.0"
+      - name: pytest
+        run: |
+          uv run --no-sync pytest \
+            --cov-report=xml:coverage.xml \
+            --cov-report=html:htmlcov
+      - name: Upload coverage artifact
+        if: always()
+        uses: actions/upload-artifact@v5
+        with:
+          name: coverage-py${{ matrix.python-version }}-django${{ matrix.django-version }}
+          path: |
+            coverage.xml
+            htmlcov/
+          if-no-files-found: ignore

django_ag_ui-0.1.0/.gitignore

@@ -0,0 +1,122 @@
+# 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
+*.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/
+coverage*.json
+coverage*.xml
+
+# release.yml renders this at workflow-time and drops it under docs/ so
+# mkdocs gh-deploy carries it to the gh-pages root.
+docs/coverage.json
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Sphinx documentation
+docs/_build/
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Virtualenv-style scripts dirs (we re-include the repo-root scripts/ directory).
+[Ss]cripts
+!/scripts/
+pyvenv.cfg
+.Python
+[Bb]in
+[Ii]nclude
+[Ll]ib
+[Ll]ib64
+[Ll]ocal
+
+# uv
+.uv-cache/
+
+# mkdocs
+/site
+
+# Type checkers
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyre/
+.pytype/
+.ruff_cache/
+.ty_cache/
+
+# IDE
+.vscode/
+.idea/
+*.iml
+*.code-workspace
+.history/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Release metadata (rendered by scripts/release-publish.sh during CI)
+.release-metadata/
+
+# AI-specific items
+.ai/
+.claude/

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

@@ -0,0 +1,32 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+        args: ["--maxkb=2000"]
+
+  - repo: local
+    hooks:
+      - id: ruff-check
+        name: "ruff check --fix"
+        entry: make lint-fix
+        pass_filenames: false
+        language: system
+        stages: [pre-commit]
+
+      - id: ruff-format
+        name: "ruff format"
+        entry: make format
+        pass_filenames: false
+        language: system
+        stages: [pre-commit]
+
+      - id: backend-type-check
+        name: "type check (ty)"
+        entry: make type-check
+        pass_filenames: false
+        language: system
+        stages: [pre-commit]

django_ag_ui-0.1.0/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] — 2026-06-01
+
+### Added
+- `ToolRegistry` + the `@tool` decorator (`destructive=` / `category=`), with
+  JSON-Schema derived from signatures and `x-destructive` / `x-category`
+  extensions.
+- `DjangoAGUIView`, an async endpoint over Pydantic-AI's `AGUIAdapter` (SSE),
+  plus `get_urls()` for mounting.
+- `AgentConfig` + `build_agent`, and the `DJANGO_AG_UI` settings (`MODEL`,
+  `MODEL_SETTINGS`, `RETRIES`, `AGENT_FACTORY`, `TOOLSETS`, `CAPABILITIES`,
+  `AUTO_CONFIRM`, `SYSTEM_PROMPT`).
+- `AuditLogger` protocol with `NullAuditLogger` / `LoggingAuditLogger`.
+- Opt-in server-side conversation persistence: the `ConversationStore` protocol,
+  `NullConversationStore` (default, stateless), `DjangoSessionConversationStore`,
+  and the abstract `ModelConversationStore` base.
+- In-process `drf-mcp` toolset bridge behind the `[drf-mcp]` extra.
+
+[Unreleased]: https://github.com/Artui/django-ag-ui/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/Artui/django-ag-ui/releases/tag/v0.1.0

django_ag_ui-0.1.0/CLAUDE.md

@@ -0,0 +1,173 @@
+# Repo conventions for `django-ag-ui`
+
+This file is the single source of truth for how to write code in this package.
+Rules are non-negotiable unless flagged as a heuristic.
+
+## What this package is
+
+A Django ↔ Pydantic-AI ↔ [AG-UI](https://docs.ag-ui.com) integration. Provides:
+- A tool registry (`ToolRegistry`, `@tool` decorator) with `destructive=` and `category=`
+  metadata, and a `build_input_schema` helper that emits an `x-destructive` JSON-Schema
+  extension when set.
+- An async Django view (`DjangoAGUIView`) that wraps Pydantic-AI's
+  `pydantic_ai.ui.ag_ui.AGUIAdapter` and returns a `StreamingHttpResponse` of AG-UI events.
+- An `AuditLogger` Protocol with `NullAuditLogger` and `LoggingAuditLogger` implementations.
+- `conf.py` reading the `DJANGO_AG_UI` settings dict.
+
+Downstream packages (e.g. `django-admin-agent`) build on this. **No admin specifics live in
+this package.**
+
+The design is at `/Users/arturveres/code/opensource/docs/plans/django-ag-ui-plan.md`.
+
+## Commands
+
+| Target | What it does |
+| --- | --- |
+| `make init` | `uv sync --all-groups` + install pre-commit hooks |
+| `make test` | pytest with 100% line+branch coverage gate |
+| `make lint` | `ruff check .` + `ty check django_ag_ui` |
+| `make format` | `ruff format .` |
+| `make docs-serve` | live-reload mkdocs at `localhost:8000` |
+| `make docs-build` | `mkdocs build --strict` |
+| `make release-bump VERSION=X.Y.Z` | rewrite `version.py` + promote `[Unreleased]` in CHANGELOG |
+| `make release-publish` | end-to-end workstation release |
+
+## Structural rules
+
+1. **One exported class or function per file.** File name = `snake_case` of the symbol.
+   `ToolRegistry` → `tool_registry.py`; `build_input_schema` → `build_input_schema.py`.
+   **Exception:** `django_ag_ui/constants.py` is the package's single home for enums and
+   constant-like module-level values, and is the only file allowed to export multiple symbols.
+2. **Private helpers used in only one file** stay there with a leading `_`.
+3. **Non-exported helpers shared across files** go into a sibling `utils.py`. Classes are
+   allowed in `utils.py` if they are internal infrastructure.
+4. **Top-level imports only.** No function-local / lazy imports unless a circular import is
+   genuine and documented inline at the import site, **or** the dependency is optional —
+   those imports go inside the function body with a clear `ImportError` message.
+5. **Full type annotations on every function and method signature.** `Any` is allowed only at
+   Django/Pydantic-AI boundaries where the type genuinely is `Any`.
+6. **`__init__.py` is the only re-export point.** Each `__init__.py` lists the public surface
+   in `__all__`. Internal modules import from leaf paths, never from the package's `__init__`.
+7. **Always `from __future__ import annotations`** at the top of any file with type
+   annotations. Python 3.10+, so no PEP 695 `type` statements.
+8. **Absolute imports only.** Imports are ordered stdlib → third-party → first-party
+   (`django_ag_ui`). Within each block, alphabetical.
+9. **NEVER use relative imports.** `from . import x`, `from .foo import bar`, any dotted-
+   relative form is forbidden everywhere in the package, including `__init__.py`. Always
+   write the full absolute path (`from django_ag_ui.foo import bar`).
+10. **Types and functionality live in separate sub-packages.** When a directory contains both
+    type declarations (dataclasses, Protocols, frozen wire-shape records) and functionality
+    (callables, registries, dispatch helpers), the types move into a `types/` sibling.
+    `constants.py` remains the multi-export exception.
+
+## API style rules
+
+11. **Always dataclasses over `dict[str, Any]` for structured data.** Every wire-shape
+    payload, response envelope, configuration record, and tool spec field is a frozen
+    `@dataclass` with explicit field types. `dict[str, Any]` survives only at genuine
+    serialisation boundaries.
+12. **Tool callables are typed.** Every registered tool declares typed parameters and a typed
+    return — no `**kwargs: Any` escape hatches. The registry uses signatures to derive JSON
+    Schema for AG-UI's tool definitions; an untyped tool breaks the schema.
+
+## Security boundary
+
+Per-tool `destructive: bool` metadata is the surfaced risk signal. The registry stamps it into
+the JSON Schema as `x-destructive: true`; client-side AG-UI consumers (e.g. the
+`@artui/ag-ui-web-component`) gate execution behind a confirmation modal. The wire stays
+vanilla AG-UI.
+
+The `AuditLogger` Protocol is the audit boundary. `LoggingAuditLogger` is the default;
+projects supply their own (Sentry, Honeycomb, custom) by setting `DJANGO_AG_UI["AUDIT_LOGGER"]`
+to a dotted path.
+
+## No module-level or class-level mutable state
+
+State lives on instances. Module-level constants (lookup tables, regexes, frozen settings
+defaults, dispatch tables) are fine — module-level **mutable** state is not.
+
+- No module-level mutable singletons (registries, caches, "warned-once" flags).
+- No class-level mutable attributes declared on the class body. Initialise mutables in
+  `__init__`.
+- The `ToolRegistry` is an instance: a `DjangoAGUIView` holds one; tests build a fresh
+  registry per scenario.
+
+## Tests
+
+- `make test` runs pytest with `--cov=django_ag_ui --cov-fail-under=100` (line + branch).
+  Restructure rather than reach for `# pragma: no cover`.
+- Test layout mirrors the source tree under `tests/`. `django_ag_ui/foo/bar.py` →
+  `tests/foo/test_bar.py`.
+- `tests/conftest_settings.py` is the Django settings module pytest uses (set via
+  `DJANGO_SETTINGS_MODULE` in `pyproject.toml`).
+- Async tests: `async def test_...` with pytest-asyncio (`asyncio_mode = "auto"`).
+- For the async view, use `httpx.AsyncClient` against the ASGI app to drive `RunAgentInput`
+  POSTs and parse the SSE event stream.
+
+## Lint and types
+
+- `make lint` runs `ruff check .` + `ty check django_ag_ui`. CI fails on either.
+- `ruff format` is the source of truth for layout.
+- Pre-commit runs `make lint-fix`, `make format`, `make type-check`. Commits must be clean
+  before push — never `--no-verify`.
+- `ty` is scoped to `django_ag_ui/` only (not tests).
+
+## Boundaries
+
+- The package depends on `pydantic-ai[ag-ui]` for the AGUIAdapter. The AG-UI wire types come
+  from there; don't re-implement them.
+- No admin specifics. Anything that touches `django.contrib.admin` belongs in
+  `django-admin-agent`, not here.
+- The `agent/` layer does not import from `registry/types`; it imports the public re-exports
+  from `django_ag_ui.registry`.
+
+## Compatibility floor
+
+| Component | Floor | Tested |
+| --- | --- | --- |
+| Python | 3.10 | 3.10, 3.11, 3.12, 3.13, 3.14 |
+| Django | 4.2 LTS | 4.2, 5.0, 5.1, 5.2, 6.0 |
+| Pydantic-AI | 1.0 (with `[ag-ui]` extra) | latest in matrix |
+
+## Branching
+
+When working on a new feature or version bump, **ALWAYS** switch to a new branch first
+(`git checkout -b feat/...` or `release/vX.Y.Z`) and push to that branch. Never commit
+feature work or version bumps directly to `main`, and never push to `main` from the local
+checkout — `main` only advances via merged PRs (or, for releases, the tagged commit produced
+on the release branch).
+
+## Releases
+
+Merge-to-main triggered. `.github/workflows/release.yml` runs on every push to `main` and
+calls `make release-publish-prepare`. The script in `scripts/release-publish.sh` is the
+single source of truth:
+
+1. Extract version from `django_ag_ui/version.py`.
+2. Short-circuit if `vX.Y.Z` already exists locally or on origin.
+3. Run `uv run pytest` as a final gate.
+4. `uv build` into `dist/`.
+5. Extract the `## [X.Y.Z]` section from `CHANGELOG.md` into release notes.
+6. Emit `released=true`.
+
+If released:
+- Publish to PyPI via OIDC trusted publishing.
+- Tag, push, create GitHub Release.
+- `mkdocs gh-deploy` to `gh-pages`.
+
+### Cutting a release
+
+```bash
+make release-bump VERSION=0.2.0
+git diff
+git commit -am "Release 0.2.0"
+git push -u origin release/0.2.0
+gh pr create
+# Merge to main; release.yml fires on the merge commit.
+```
+
+### One-time setup (manual)
+
+1. **PyPI Trusted Publisher** — `Artui/django-ag-ui`, workflow `release.yml`, environment `pypi`.
+2. **GitHub Environment** — create `pypi` (no secrets; OIDC).
+3. **GitHub Pages** — branch `gh-pages` (created on first release with docs).

django_ag_ui-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Artur Veres
+
+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.

django_ag_ui-0.1.0/Makefile

@@ -0,0 +1,79 @@
+.PHONY: help init test lint lint-fix format format-check type-check deps-bump docs-serve docs-build release-bump release-publish release-publish-prepare release-publish-finalize
+
+help:
+	@echo "Available targets:"
+	@echo "  init             Sync deps (all groups) and install pre-commit hooks"
+	@echo "  test             Run pytest with coverage (100% required)"
+	@echo "  lint             Run ruff check + ty check"
+	@echo "  lint-fix         Auto-fix lint issues with ruff"
+	@echo "  format           Format with ruff"
+	@echo "  format-check     Verify formatting"
+	@echo "  type-check       Run ty over the package"
+	@echo "  deps-bump        Upgrade pinned dependencies"
+	@echo "  docs-serve       Live-reload docs at http://localhost:8000 (needs mkdocs.yml)"
+	@echo "  docs-build       Build docs into ./site (strict — fails on broken links)"
+	@echo "  release-bump     Bump version files + CHANGELOG. Usage: make release-bump VERSION=X.Y.Z"
+	@echo "  release-publish  prepare → uv publish → finalize (workstation release)"
+	@echo "  release-publish-prepare   Run by release.yml on push to main (no-op unless bumped)"
+	@echo "  release-publish-finalize  Tag vX.Y.Z + create GitHub Release after PyPI publish"
+
+init:
+	uv sync --all-groups
+	uv run pre-commit install
+
+test:
+	uv run pytest
+
+lint:
+	uv run ruff check .
+	uv run ty check django_ag_ui
+
+lint-fix:
+	uv run ruff check --fix .
+
+format:
+	uv run ruff format .
+
+format-check:
+	uv run ruff format --check --diff .
+
+type-check:
+	uv run ty check django_ag_ui
+
+deps-bump:
+	uvx uv-upx upgrade run --profile with_pinned
+
+docs-serve:
+	uv run --group docs mkdocs serve
+
+docs-build:
+	uv run --group docs mkdocs build --strict
+
+release-bump:
+	@if [ -z "$(VERSION)" ]; then \
+		echo "Usage: make release-bump VERSION=X.Y.Z"; exit 1; \
+	fi
+	uvx bump-my-version bump --new-version "$(VERSION)" patch
+	@echo ""
+	@echo "Bumped to $(VERSION). Edit CHANGELOG.md to fill the new section,"
+	@echo "review with 'git diff', then run 'make release-publish'."
+
+# Release pipeline. Version lives in django_ag_ui/version.py
+# (pyproject pulls it in via [tool.hatch.version] dynamic).
+RELEASE_PACKAGE_NAME := django-ag-ui
+RELEASE_VERSION_FILES := django_ag_ui/version.py|^__version__[^=]*= *
+
+release-publish:
+	@PACKAGE_NAME='$(RELEASE_PACKAGE_NAME)' \
+	VERSION_FILES="$$(printf '$(RELEASE_VERSION_FILES)')" \
+		bash scripts/release-publish.sh all
+
+release-publish-prepare:
+	@PACKAGE_NAME='$(RELEASE_PACKAGE_NAME)' \
+	VERSION_FILES="$$(printf '$(RELEASE_VERSION_FILES)')" \
+		bash scripts/release-publish.sh prepare
+
+release-publish-finalize:
+	@PACKAGE_NAME='$(RELEASE_PACKAGE_NAME)' \
+	VERSION_FILES="$$(printf '$(RELEASE_VERSION_FILES)')" \
+		bash scripts/release-publish.sh finalize

django_ag_ui-0.1.0/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: django-ag-ui
+Version: 0.1.0
+Summary: Django ↔ Pydantic-AI ↔ AG-UI integration: async view, tool registry, audit logger.
+Project-URL: Homepage, https://github.com/Artui/django-ag-ui
+Project-URL: Repository, https://github.com/Artui/django-ag-ui
+Project-URL: Issues, https://github.com/Artui/django-ag-ui/issues
+Author-email: Artur Veres <artur8118@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: ag-ui,agent,ai,django,llm,pydantic-ai
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Framework :: Django :: 5.1
+Classifier: Framework :: Django :: 5.2
+Classifier: Framework :: Django :: 6.0
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: django>=4.2
+Requires-Dist: pydantic-ai[ag-ui]>=1.0
+Provides-Extra: drf-mcp
+Requires-Dist: djangorestframework-mcp-server>=0.5; extra == 'drf-mcp'
+Description-Content-Type: text/markdown
+
+# django-ag-ui
+
+[![CI](https://github.com/Artui/django-ag-ui/workflows/tests/badge.svg)](https://github.com/Artui/django-ag-ui/actions/workflows/tests.yml)
+[![PyPI](https://img.shields.io/pypi/v/django-ag-ui.svg)](https://pypi.org/project/django-ag-ui/)
+[![Python versions](https://img.shields.io/pypi/pyversions/django-ag-ui.svg)](https://pypi.org/project/django-ag-ui/)
+[![Django versions](https://img.shields.io/pypi/djversions/django-ag-ui.svg)](https://pypi.org/project/django-ag-ui/)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![License](https://img.shields.io/pypi/l/django-ag-ui.svg)](https://github.com/Artui/django-ag-ui/blob/main/LICENSE)
+
+Django ↔ [Pydantic-AI](https://ai.pydantic.dev) ↔ [AG-UI](https://docs.ag-ui.com) integration: async view, tool registry with `destructive`/`category` metadata, audit logger.
+
+```bash
+pip install django-ag-ui
+```
+
+See the [docs](https://artui.github.io/django-ag-ui/) for the full surface.

django_ag_ui-0.1.0/README.md

@@ -0,0 +1,16 @@
+# django-ag-ui
+
+[![CI](https://github.com/Artui/django-ag-ui/workflows/tests/badge.svg)](https://github.com/Artui/django-ag-ui/actions/workflows/tests.yml)
+[![PyPI](https://img.shields.io/pypi/v/django-ag-ui.svg)](https://pypi.org/project/django-ag-ui/)
+[![Python versions](https://img.shields.io/pypi/pyversions/django-ag-ui.svg)](https://pypi.org/project/django-ag-ui/)
+[![Django versions](https://img.shields.io/pypi/djversions/django-ag-ui.svg)](https://pypi.org/project/django-ag-ui/)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![License](https://img.shields.io/pypi/l/django-ag-ui.svg)](https://github.com/Artui/django-ag-ui/blob/main/LICENSE)
+
+Django ↔ [Pydantic-AI](https://ai.pydantic.dev) ↔ [AG-UI](https://docs.ag-ui.com) integration: async view, tool registry with `destructive`/`category` metadata, audit logger.
+
+```bash
+pip install django-ag-ui
+```
+
+See the [docs](https://artui.github.io/django-ag-ui/) for the full surface.