chore(ag-ui): python 3.9 support

Eliminate the use of match statement and dataclass(kw_only=True) to
ensure compatibility with Python 3.9.

Remove duplicate import of starlette outside try block, causing tests to
fail when it's not installed.

Author: stevenh

.github/workflows/ci.yml

@@ -204,6 +204,7 @@ jobs:
           enable-cache: true
 
       - run: uv sync --package pydantic-ai-slim --only-dev
+      - run: rm coverage/.coverage.*-py3.9-* # Exclude 3.9 coverage as it gets the wrong line numbers, causing invalid failures.
       - run: uv run coverage combine coverage
 
       - run: uv run coverage html --show-contexts --title "PydanticAI coverage for ${{ github.sha }}"

docs/ag-ui.md

@@ -225,7 +225,7 @@ def custom_events() -> list[CustomEvent]:
 ### Examples
 
 For more examples of how to use [`Adapter`][pydantic_ai.ag_ui.Adapter] see
-[`pydantic_ai.ag_ui_examples`](https://github.com/pydantic/pydantic-ai/tree/main/examples/pydantic_ai.ag_ui_examples),
+[`pydantic_ai_ag_ui_examples`](https://github.com/pydantic/pydantic-ai/tree/main/examples/pydantic_ai_ag_ui_examples),
 which includes working server for the with the
 [AG-UI Dojo](https://docs.ag-ui.com/tutorials/debugging#the-ag-ui-dojo) which
 can be run from a clone of the repo or with the `pydantic-ai-examples` package
@@ -238,7 +238,7 @@ pip/uv-add pydantic-ai-examples
 Direct, which supports command line flags:
 
 ```shell
-python -m pydantic_ai.ag_ui_examples.dojo_server --help
+python -m pydantic_ai_ag_ui_examples.dojo_server --help
 usage: dojo_server.py [-h] [--port PORT] [--reload] [--no-reload] [--log-level {critical,error,warning,info,debug,trace}]
 
 PydanticAI AG-UI Dojo server

examples/pydantic_ai_ag_ui_examples/README.md

@@ -7,34 +7,36 @@ Implementation of the AG-UI protocol for PydanticAI.
 This example uses a PydanticAI agent using an OpenAI model and the AG-UI dojo.
 
 1. An [OpenAI API key](https://help.openai.com/en/articles/4936850-where-do-i-find-my-openai-api-key)
-2. A clone of this repository
-3. A clone of the [AG-UI protocol repository](https://github.com/ag-ui-protocol/ag-ui)
+2. A clone of the [AG-UI protocol repository](https://github.com/ag-ui-protocol/ag-ui)
 
 ## Running
 
 To run this integration you need to:
 
-1. Make a copy of `jobs-agent/.env.local-example` as `.env`
+1. Make a copy of `.env-sample` as `.env` in the `typescript-sdk/integrations/pydantic-ai` directory
 2. Open it in your editor and set `OPENAI_API_KEY` to a valid OpenAI key
-3. Open terminal in the root directory of this repository clone
-4. Install the required modules and run the server
+3. Open terminal in the `typescript-sdk/integrations/pydantic-ai` of the `ag-ui` repo
+4. Install the `pydantic-ai-examples` package
 
     ```shell
-    cd jobs-agent
-    just install-deps
-    source .venv/bin/activate
-    python -m examples.pydantic_ai_ag_ui_examples.dojo_server
+    pip/uv-add pydantic-ai-examples
     ```
 
-5. Open another terminal in root directory of the `ag-ui` repository clone
-6. Start the integration ag-ui dojo:
+5. Run the example dojo server
+
+    ```shell
+    python -m pydantic_ai_ag_ui_examples.dojo_server
+    ```
+
+6. Open another terminal in root directory of the `ag-ui` repository clone
+7. Start the integration ag-ui dojo:
 
     ```shell
     cd typescript-sdk
     pnpm install && pnpm run dev
     ```
 
-7. Finally visit [http://localhost:3000/pydantic-ai](http://localhost:3000/pydantic-ai)
+8. Finally visit [http://localhost:3000/pydantic-ai](http://localhost:3000/pydantic-ai)
 
 ## Feature Demos
 
@@ -97,7 +99,8 @@ Generate a list of steps for cleaning a car for me to review
 ### [Predictive State Updates](http://localhost:3000/pydantic-ai/feature/predictive_state_updates)
 
 Demonstrates how to use the predictive state updates feature to update the state
-of the UI based on agent responses, including user interaction via git aconfirmation.
+of the UI based on agent responses, including user interaction via user
+confirmation.
 
 #### Story Tools