Merge branch 'main' into features/elicitation-callback

Author: yamanahlawat

.claude/settings.json

@@ -0,0 +1,26 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(rg:*)",
+      "Bash(make:*)",
+      "Bash(uv run pytest:*)",
+      "Bash(uv run:*)",
+      "Bash(git push:*)",
+      "Bash(git checkout:*)",
+      "Bash(gh pr create:*)",
+      "Bash(gh pr view:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(gh pr comment:*)",
+      "Bash(gh pr checks:*)",
+      "Bash(gh run view:*)",
+      "Bash(gh pr list:*)",
+      "Bash(gh api:*)",
+      "Bash(pre-commit run:*)",
+      "Bash(grep:*)",
+      "Bash(find:*)",
+      "Bash(coverage:*)"
+    ],
+    "deny": []
+  }
+}

.github/workflows/ci.yml

@@ -131,14 +131,20 @@ jobs:
           CO_API_KEY: ${{ secrets.COHERE_API_KEY }}
 
   test:
-    name: test on ${{ matrix.python-version }} (${{ matrix.install }})
+    name: test on ${{ matrix.python-version }} (${{ matrix.install.name }})
     runs-on: ubuntu-latest
     timeout-minutes: 10
     strategy:
       fail-fast: false
       matrix:
         python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
-        install: ["slim", "standard", "all-extras"]
+        install:
+          - name: pydantic-ai-slim
+            command: "--package pydantic-ai-slim"
+          - name: standard
+            command: ""
+          - name: all-extras
+            command: "--all-extras"
     env:
       UV_PYTHON: ${{ matrix.python-version }}
       CI: true
@@ -154,29 +160,18 @@ jobs:
         with:
           deno-version: v2.x
 
-      - name: choose install command
-        run: |
-          if [ "${{ matrix.install }}" = "slim" ]; then
-            echo "install-command=--package pydantic-ai-slim" >> $GITHUB_OUTPUT
-          elif [ "${{ matrix.install }}" = "standard" ]; then
-            echo "install-command=" >> $GITHUB_OUTPUT
-          elif [ "${{ matrix.install }}" = "all-extras" ]; then
-            echo "install-command=--all-extras" >> $GITHUB_OUTPUT
-          fi
-        id: install-command
-
       - run: mkdir .coverage
 
-      - run: uv sync --group dev
-      - run: uv run ${{ steps.install-command.outputs.install-command }} coverage run -m pytest -n auto --dist=loadgroup
+      - run: uv sync --only-dev
+      - run: uv run ${{ matrix.install.command }} coverage run -m pytest --durations=100 -n auto --dist=loadgroup
         env:
-          COVERAGE_FILE: .coverage/.coverage.${{ matrix.python-version }}-${{ matrix.install }}
+          COVERAGE_FILE: .coverage/.coverage.${{ matrix.python-version }}-${{ matrix.install.name }}
 
       - name: store coverage files
         uses: actions/upload-artifact@v4
         if: matrix.python-version != '3.9'
         with:
-          name: coverage-${{ matrix.python-version }}-${{ matrix.install }}
+          name: coverage-${{ matrix.python-version }}-${{ matrix.install.name }}
           path: .coverage
           include-hidden-files: true
 
@@ -209,7 +204,7 @@ jobs:
 
       - run: unset UV_FROZEN
 
-      - run: uv run --all-extras --resolution lowest-direct coverage run -m pytest -n auto --dist=loadgroup
+      - run: uv run --all-extras --resolution lowest-direct coverage run -m pytest --durations=100 -n auto --dist=loadgroup
         env:
           COVERAGE_FILE: .coverage/.coverage.${{matrix.python-version}}-lowest-versions
 

.hyperlint/config.yaml

@@ -5,23 +5,18 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 ## Development Commands
 
 ### Core Development Tasks
+
 - **Install dependencies**: `make install` (requires uv, pre-commit, and deno)
-- **Run all checks**: `make` (format, lint, typecheck, test with coverage)
-- **Format code**: `make format`
-- **Lint code**: `make lint`
-- **Type checking**: `make typecheck` (uses pyright) or `make typecheck-both` (pyright + mypy)
-- **Run tests**: `make test` (with coverage)
+- **Run all checks**: `pre-commit run --all-files`
+- **Run tests**: `make test`
 - **Build docs**: `make docs` or `make docs-serve` (local development)
 
 ### Single Test Commands
+
 - **Run specific test**: `uv run pytest tests/test_agent.py::test_function_name -v`
 - **Run test file**: `uv run pytest tests/test_agent.py -v`
 - **Run with debug**: `uv run pytest tests/test_agent.py -v -s`
 
-### Multi-Python Testing
-- **Install all Python versions**: `make install-all-python`
-- **Test all Python versions**: `make test-all-python`
-
 ## Project Architecture
 
 ### Core Components
@@ -125,3 +120,43 @@ This is a uv workspace with multiple packages:
 - **Lock file**: `uv.lock` (commit this file)
 - **Sync command**: `make sync` to update dependencies
 - **Optional extras**: Define groups in `pyproject.toml` optional-dependencies
+
+## Best Practices
+
+This is the list of best practices for working with the codebase.
+
+### Rename a class
+
+When asked to rename a class, you need to rename the class in the code and add a deprecation warning to the old class.
+
+```python
+from typing_extensions import deprecated
+
+class NewClass: ...  # This class was renamed from OldClass.
+
+@deprecated("Use `NewClass` instead")
+class OldClass(NewClass): ...
+```
+
+In the test suite, you MUST use the `NewClass` instead of the `OldClass`, and create a new test to verify the
+deprecation warning:
+
+```python
+def test_old_class_is_deprecated():
+    with pytest.warns(DeprecationWarning, match="Use `NewClass` instead"):
+        OldClass()
+```
+
+In the documentation, you should not have references to the old class, only the new class.
+
+### Writing documentation
+
+Always reference Python objects with the "`" (backticks) around them, and link to the API reference, for example:
+
+```markdown
+The [`Agent`][pydantic_ai.agent.Agent] class is the main entry point for creating and running agents.
+```
+
+### Coverage
+
+Every pull request MUST have 100% coverage. You can check the coverage by running `make test`.

CLAUDE.md

@@ -255,6 +255,7 @@ The following providers have dedicated documentation on Pydantic AI:
 - [Opik](https://www.comet.com/docs/opik/tracing/integrations/pydantic-ai)
 - [mlflow](https://mlflow.org/docs/latest/genai/tracing/integrations/listing/pydantic_ai)
 - [Agenta](https://docs.agenta.ai/observability/integrations/pydanticai)
+- [Confident AI](https://documentation.confident-ai.com/docs/llm-tracing/integrations/pydanticai)
 
 ## Advanced usage