docs(agentex): use canonical agentex.protocol.acp import paths (#254)

> **Stacked on
[#286](#286 (isolate
docs build from the workspace lock) — merge that first. This PR is only
the doc-path changes; #286 makes the doc build resolve
`agentex-sdk>=0.12.0` in an isolated env, so `agentex.protocol.*`
resolves without touching backend deps.

## Summary

Updates the agentex mkdocs site to use the new canonical
`agentex.protocol.acp` import paths for protocol-shape types
(`RPCMethod`, `CreateTaskParams`, `SendMessageParams`,
`SendEventParams`, `CancelTaskParams`).

Companion to
[scaleapi/scale-agentex-python#371](scaleapi/scale-agentex-python#371),
which moved these types out of `agentex.lib.types.*` into the new
slim-safe `agentex.protocol.*` package. The old path still works via a
back-compat shim — this PR isn't fixing a breakage, it's making sure
scaffolded user code following these docs starts on the canonical path.

Requested in [a review comment on
#371](scaleapi/scale-agentex-python#371 (review)).

## Changes

10 markdown files in `agentex/docs/`:

| Pattern | Count |
|---|---|
| `from agentex.lib.types.acp import ...` → `from agentex.protocol.acp
import ...` | 8 code samples |
| `::: agentex.lib.types.acp.X` → `::: agentex.protocol.acp.X` | 2
mkdocstrings cross-refs (in `agent_types/sync.md` and `api/types.md`) |

No content / behavior changes; same classes, new import path.

## What's not touched

Other `agentex.lib.types.*` modules (`tracing`, `agent_card`,
`credentials`, `fastacp`, `llm_messages`, `converters`) stay on the old
path because they have heavier transitive deps and weren't migrated by
#371. No doc references to those needed updates.

## Test plan

- [x] Isolated `mkdocs build` renders green against `agentex-sdk` 0.12.0
(verified locally via the #286 build path).
- [x] `::: agentex.protocol.acp.*` mkdocstrings directives resolve at
the new path.

🧑‍💻🤖 — posted via [Claude Code](https://claude.com/claude-code)
<!-- claude-code -->

<!-- greptile_comment -->

<h3>Greptile Summary</h3>

This PR updates 10 documentation markdown files to use the new canonical
`agentex.protocol.acp` import paths, replacing the old
`agentex.lib.types.acp` references in both Python code samples and
mkdocstrings directives.

- Replaces `from agentex.lib.types.acp import ...` with `from
agentex.protocol.acp import ...` in 10 code sample blocks across 8
files.
- Updates 13 mkdocstrings `::: agentex.lib.types.acp.X` directives to
`::: agentex.protocol.acp.X` across 5 files, covering
`CreateTaskParams`, `SendMessageParams`, `SendEventParams`, and
`CancelTaskParams`.
- A grep confirms no remaining `agentex.lib.types.acp` references exist
anywhere in the docs tree after this PR.

<details><summary><h3>Confidence Score: 5/5</h3></summary>

Safe to merge — purely mechanical doc path updates with no remaining
old-path references in the docs tree.

All 23 occurrences of agentex.lib.types.acp across 10 files have been
correctly replaced with agentex.protocol.acp. A grep of the entire docs
directory confirms zero leftover old-path references. No logic,
behavior, or non-doc files are touched.

No files require special attention.
</details>

<h3>Important Files Changed</h3>

| Filename | Overview |
|----------|----------|
| agentex/docs/docs/api/types.md | 4 mkdocstrings directives updated
from old to new canonical path; no issues. |
| agentex/docs/docs/agent_types/async/base.md | 1 import and 3
mkdocstrings directives updated; no issues. |
| agentex/docs/docs/agent_types/async/temporal.md | 1 import and 2
mkdocstrings directives updated; no issues. |
| agentex/docs/docs/acp/agentic/base.md | 3 mkdocstrings directives
updated; no issues. |
| agentex/docs/docs/getting_started/project_structure.md | 3 import
statements updated across different agent-type examples; no issues. |
| agentex/docs/docs/agent_types/sync.md | 1 import and 1 mkdocstrings
directive updated; no issues. |
| agentex/docs/docs/api/overview.md | 1 import statement updated; no
issues. |
| agentex/docs/docs/concepts/streaming.md | 1 import statement updated;
no issues. |
| agentex/docs/docs/acp/agentic/temporal.md | 1 import statement
updated; no issues. |
| agentex/docs/docs/temporal_development/openai_integration.md | 1
import statement updated; no issues. |

</details>

<details><summary><h3>Flowchart</h3></summary>

```mermaid
%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["Doc code samples & mkdocstrings refs\n(10 markdown files)"] --> B{"Import path"}
    B -- "Before" --> C["agentex.lib.types.acp\n(back-compat shim)"]
    B -- "After" --> D["agentex.protocol.acp\n(canonical path)"]
    D --> E["CreateTaskParams"]
    D --> F["SendMessageParams"]
    D --> G["SendEventParams"]
    D --> H["CancelTaskParams"]
```
</details>

<sub>Reviews (5): Last reviewed commit: ["docs(agentex): use canonical
agentex.pro..."](5a42081)
| [Re-trigger
Greptile](https://app.greptile.com/api/retrigger?id=34170925)</sub>

<!-- /greptile_comment -->

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: max-parke-scale

agentex/docs/docs/acp/agentic/base.md

@@ -157,7 +157,7 @@ async def process_workflow_step(params: SendEventParams):
 
 Used in `@acp.on_task_create` for task initialization:
 
-::: agentex.lib.types.acp.CreateTaskParams
+::: agentex.protocol.acp.CreateTaskParams
     options:
       heading_level: 4
       show_root_heading: false
@@ -167,7 +167,7 @@ Used in `@acp.on_task_create` for task initialization:
 
 Used in `@acp.on_task_event_send` for processing events:
 
-::: agentex.lib.types.acp.SendEventParams
+::: agentex.protocol.acp.SendEventParams
     options:
       heading_level: 4
       show_root_heading: false
@@ -177,7 +177,7 @@ Used in `@acp.on_task_event_send` for processing events:
 
 Used in `@acp.on_task_cancel` for cleanup:
 
-::: agentex.lib.types.acp.CancelTaskParams
+::: agentex.protocol.acp.CancelTaskParams
     options:
       heading_level: 4
       show_root_heading: false

agentex/docs/docs/acp/agentic/temporal.md

@@ -48,7 +48,7 @@ Instead of ACP handlers, you implement standard Temporal workflows:
 ```python
 from temporalio import workflow
 from agentex import adk
-from agentex.lib.types.acp import CreateTaskParams, SendEventParams
+from agentex.protocol.acp import CreateTaskParams, SendEventParams
 from agentex.core.temporal.workflows.workflow import BaseWorkflow
 from agentex.core.temporal.types.workflow import SignalName
 from agentex.types.message_author import MessageAuthor

agentex/docs/docs/agent_types/async/base.md

@@ -39,7 +39,7 @@ sequenceDiagram
 ```python
 from agentex.lib.sdk.fastacp.fastacp import FastACP
 from agentex.lib.types.fastacp import AsyncACPConfig
-from agentex.lib.types.acp import CreateTaskParams, SendEventParams, CancelTaskParams
+from agentex.protocol.acp import CreateTaskParams, SendEventParams, CancelTaskParams
 from agentex.lib import adk
 
 # Create Base Async ACP server
@@ -78,7 +78,7 @@ async def handle_task_cancel(params: CancelTaskParams) -> None:
 
 Used in `@acp.on_task_create` for task initialization:
 
-::: agentex.lib.types.acp.CreateTaskParams
+::: agentex.protocol.acp.CreateTaskParams
     options:
       heading_level: 4
       show_root_heading: false
@@ -88,7 +88,7 @@ Used in `@acp.on_task_create` for task initialization:
 
 Used in `@acp.on_task_event_send` for processing events:
 
-::: agentex.lib.types.acp.SendEventParams
+::: agentex.protocol.acp.SendEventParams
     options:
       heading_level: 4
       show_root_heading: false
@@ -98,7 +98,7 @@ Used in `@acp.on_task_event_send` for processing events:
 
 Used in `@acp.on_task_cancel` for cleanup:
 
-::: agentex.lib.types.acp.CancelTaskParams
+::: agentex.protocol.acp.CancelTaskParams
     options:
       heading_level: 4
       show_root_heading: false

agentex/docs/docs/agent_types/async/temporal.md

@@ -51,7 +51,7 @@ sequenceDiagram
 ```python
 from temporalio import workflow
 from agentex import adk
-from agentex.lib.types.acp import CreateTaskParams, SendEventParams
+from agentex.protocol.acp import CreateTaskParams, SendEventParams
 from agentex.core.temporal.workflows.workflow import BaseWorkflow
 from agentex.core.temporal.types.workflow import SignalName
 from agentex.types.message_author import MessageAuthor
@@ -159,7 +159,7 @@ if __name__ == "__main__":
 
 Used in `@workflow.run` (replaces `@acp.on_task_create`):
 
-::: agentex.lib.types.acp.CreateTaskParams
+::: agentex.protocol.acp.CreateTaskParams
     options:
       heading_level: 4
       show_root_heading: false
@@ -169,7 +169,7 @@ Used in `@workflow.run` (replaces `@acp.on_task_create`):
 
 Used in `@workflow.signal(name=SignalName.RECEIVE_EVENT)` (replaces `@acp.on_task_event_send`):
 
-::: agentex.lib.types.acp.SendEventParams
+::: agentex.protocol.acp.SendEventParams
     options:
       heading_level: 4
       show_root_heading: false

agentex/docs/docs/agent_types/sync.md

@@ -31,7 +31,7 @@ sequenceDiagram
 
 ```python
 from agentex.lib.sdk.fastacp.fastacp import FastACP
-from agentex.lib.types.acp import SendMessageParams
+from agentex.protocol.acp import SendMessageParams
 from agentex.types.text_content import TextContent
 from agentex.types.message_author import MessageAuthor
 
@@ -61,7 +61,7 @@ async def handle_message(params: SendMessageParams):
 
 The `@acp.on_message_send` handler receives:
 
-::: agentex.lib.types.acp.SendMessageParams
+::: agentex.protocol.acp.SendMessageParams
     options:
       heading_level: 4
       show_root_heading: false

agentex/docs/docs/api/overview.md

@@ -62,7 +62,7 @@ Python library for use **WITHIN** your agent code. The ADK provides high-level a
 from agentex.types.task_message_content import TaskMessageContent
 from agentex.types.text_content import TextContent
 from agentex.types.message_author import MessageAuthor
-from agentex.lib.types.acp import SendMessageParams, CreateTaskParams, SendEventParams
+from agentex.protocol.acp import SendMessageParams, CreateTaskParams, SendEventParams
 from agentex.types.task import Task
 from agentex.types.event import Event
 ```

agentex/docs/docs/api/types.md

@@ -6,19 +6,19 @@ Comprehensive API reference for all core object types in Agentex. These types ar
 
 ### CreateTaskParams
 
-::: agentex.lib.types.acp.CreateTaskParams
+::: agentex.protocol.acp.CreateTaskParams
 
 ### SendMessageParams
 
-::: agentex.lib.types.acp.SendMessageParams
+::: agentex.protocol.acp.SendMessageParams
 
 ### SendEventParams
 
-::: agentex.lib.types.acp.SendEventParams
+::: agentex.protocol.acp.SendEventParams
 
 ### CancelTaskParams
 
-::: agentex.lib.types.acp.CancelTaskParams
+::: agentex.protocol.acp.CancelTaskParams
 
 ## Agent
 

agentex/docs/docs/concepts/streaming.md

@@ -146,7 +146,7 @@ Here's a complete example showing how to stream content in an Async Agent:
 
 ```python
 from agentex.lib import adk
-from agentex.lib.types.acp import SendEventParams
+from agentex.protocol.acp import SendEventParams
 from agentex.types.text_content import TextContent
 from agentex.types.task_message_delta import TextDelta
 from agentex.types.task_message_update import (

agentex/docs/docs/getting_started/project_structure.md

@@ -42,7 +42,7 @@ Your ACP server defines how the agent responds to incoming messages. For sync ag
 
 ```python
 from agentex.lib.sdk.fastacp.fastacp import FastACP
-from agentex.lib.types.acp import SendMessageParams
+from agentex.protocol.acp import SendMessageParams
 from agentex.types.task_message_content import TaskMessageContent
 from agentex.types.text_content import TextContent
 
@@ -111,7 +111,7 @@ The base async ACP server gives you a starting point for custom async implementa
 ```python
 from agentex.lib.sdk.fastacp.fastacp import FastACP
 from agentex.lib.types.fastacp import AgenticBaseACPConfig
-from agentex.lib.types.acp import CreateTaskParams, SendEventParams, CancelTaskParams
+from agentex.protocol.acp import CreateTaskParams, SendEventParams, CancelTaskParams
 
 # Create a base agentic ACP server
 acp = FastACP.create(
@@ -216,7 +216,7 @@ Your workflow is where all the agent logic lives. It's a class that Temporal man
 import json
 from temporalio import workflow
 from agentex.lib import adk
-from agentex.lib.types.acp import CreateTaskParams, SendEventParams
+from agentex.protocol.acp import CreateTaskParams, SendEventParams
 from agentex.lib.core.temporal.workflows.workflow import BaseWorkflow
 from agentex.lib.core.temporal.types.workflow import SignalName
 from agentex.types.text_content import TextContent

agentex/docs/docs/temporal_development/openai_integration.md

@@ -146,7 +146,7 @@ The new streaming implementation uses Temporal's interceptor pattern to enable r
 # workflow.py
 from agents import Agent, Runner
 from agentex import adk
-from agentex.lib.types.acp import SendEventParams
+from agentex.protocol.acp import SendEventParams
 from agentex.lib.core.temporal.types.workflow import SignalName
 from agentex.types.text_content import TextContent
 from temporalio import workflow