chore(ag-ui): add adapter-ag-ui to docs group

Add adapter-ag-ui to the documentation group in the project so mkdocs
has access to the module and can generate the documentation.

Some improvements to the ag-ui documentation were also made.

Author: stevenh

docs/ag-ui.md

@@ -50,23 +50,23 @@ You can run the example with:
 uvicorn agent_to_ag_ui:app --host 0.0.0.0 --port 8000
 ```
 
-This will expose the agent as an AG-UI server, and you can start sending requests to it.
-
-See more about [exposing PydanticAI agents as AG-UI servers](#pydanticai-agent-to-ag-ui-server).
+This will expose the agent as an AG-UI server, and you can start sending
+requests to it.
 
 ## Adapter AG UI
 
-**AdapterAGUI** is an adapter between PydanticAI agents and the AG-UI protocol
-written in Python.
+[AdapterAGUI][adapter_ag_ui.AdapterAGUI]is an adapter between PydanticAI agents
+and the AG-UI protocol written in Python.
 
 ### Design
 
 The adapter receives messages in the form of a
-[`RunAgentInput.state`](https://docs.ag-ui.com/sdk/js/core/types#runagentinput)
+[`RunAgentInput`](https://docs.ag-ui.com/sdk/js/core/types#runagentinput)
 which describes the details of a request being passed to the agent including
-messages and state. These are then translated to PydanticAI types, passed to the
-provided agent when then process the request. Results from the agent are then
-streamed back to the caller.
+messages and state. These are then converted to PydanticAI types, passed to the
+provided agent which then process the request. Results from the agent are
+converted from PydanticAI types to AG-UI events and streamed back to the caller
+as Server-Sent Events (SSE).
 
 A user request may require multiple round trips between client UI and PydanticAI
 server, depending on the tools and events needed.

pyproject.toml

@@ -86,6 +86,7 @@ members = [
 # dev dependencies are defined in `pydantic-ai-slim/pyproject.toml` to allow for minimal testing
 lint = ["mypy>=1.11.2", "pyright>=1.1.390", "ruff>=0.6.9"]
 docs = [
+    "adapter-ag-ui>=0.3.4",
     "black>=24.10.0",
     "mkdocs>=1.6.1",
     "mkdocs-glightbox>=0.4.0",