docs(ag-ui): add warning about tool order

Add a warning about the use of PydanticAI tool followed by a AG-UI as
this will not work as expected.

Author: stevenh

docs/ag-ui.md

@@ -194,6 +194,12 @@ convenience method, it accepts the same arguments as the
 AG-UI tools are seamlessly provided to the PydanticAI agent, enabling rich
 use experiences with frontend user interfaces.
 
+!!! warning "Requests requiring PydanticAI and AG-UI tools"
+    Agent requests which require a PydanticAI tool use followed by an
+    AG-UI tool will currently fail to process correctly, as the response from
+    AG-UI will not include details about the PydanticAI tool request / response.
+    This will be fixed in a future release
+
 #### Events
 
 The adapter provides the ability for PydanticAI tools to send

pydantic_ai_ag_ui/pydantic_ai_ag_ui/adapter.py

@@ -108,8 +108,15 @@ class Adapter(Generic[AgentDepsT, OutputDataT]):
     an adapter for running agents with Server-Sent Event (SSE) streaming
     responses using the AG-UI protocol.
 
-    Example:
+    # Warning
 
+    Agent requests which require a PydanticAI tool use followed by an AG-UI
+    tool will currently fail to process correctly, as the response from AG-UI
+    will not include details about the PydanticAI tool request / response.
+    This will be fixed in a future release
+
+    Examples:
+    This is an example of base usage with FastAPI.
     .. code-block:: python
         from __future__ import annotations
 
@@ -142,8 +149,6 @@ async def root(input_data: RunAgentInput, accept: Annotated[str, Header()] = SSE
     PydanticAI tools which return AG-UI events will be sent to the client
     as part of the event stream, single events and event iterables are
     supported.
-
-    Examples:
     .. code-block:: python
         @agent.tool
         def update_state(ctx: RunContext[StateDeps[DocumentState]]) -> StateSnapshotEvent: