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

[max-parke-scale]

Stacked on #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, 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.

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

• Isolated mkdocs build renders green against agentex-sdk 0.12.0 (verified locally via the build(docs): isolate docs build from the workspace lock #286 build path).
• ::: agentex.protocol.acp.* mkdocstrings directives resolve at the new path.

🧑‍💻🤖 — posted via Claude Code

Greptile Summary

This PR updates all agentex mkdocs documentation to use the new canonical agentex.protocol.acp import path in place of the legacy agentex.lib.types.acp path for the five protocol-shape types (CreateTaskParams, SendMessageParams, SendEventParams, CancelTaskParams, and the referenced variants). No content or behavioral changes are made; only import paths in code samples and mkdocstrings directives are touched.

• 9 Python code snippets across 8 files updated from from agentex.lib.types.acp import ... to from agentex.protocol.acp import ....
• 13 mkdocstrings directives across 5 files updated from ::: agentex.lib.types.acp.X to ::: agentex.protocol.acp.X.
• A post-diff grep confirms no remaining agentex.lib.types.acp references exist anywhere in the docs tree.

Confidence Score: 5/5

Purely mechanical doc-path update with no logic changes; all old references have been replaced and none remain in the docs tree.

Every changed line is a string substitution in markdown files — no executable code, no schema changes, no API surface changes. A post-diff grep confirms zero remaining agentex.lib.types.acp references in the docs directory, so the migration is complete and consistent.

No files require special attention.

Important Files Changed

Filename	Overview
agentex/docs/docs/api/types.md	Updates 4 mkdocstrings directives in the comprehensive API types reference to the new canonical path.
agentex/docs/docs/acp/agentic/base.md	Updates 3 mkdocstrings directives (CreateTaskParams, SendEventParams, CancelTaskParams) to the new canonical path.
agentex/docs/docs/agent_types/async/base.md	Updates one Python import snippet and 3 mkdocstrings directives for the async base agent type to the new canonical path.
agentex/docs/docs/agent_types/async/temporal.md	Updates one Python import snippet and 2 mkdocstrings directives for the async Temporal agent type to the new canonical path.
agentex/docs/docs/getting_started/project_structure.md	Updates two Python import snippets (sync and async sections) to the new canonical path.
agentex/docs/docs/agent_types/sync.md	Updates one Python import snippet and one mkdocstrings directive for SendMessageParams to the new canonical path.
agentex/docs/docs/api/overview.md	Updates one Python import snippet for the API overview page to the new canonical path.
agentex/docs/docs/acp/agentic/temporal.md	Updates one Python import snippet from agentex.lib.types.acp to agentex.protocol.acp.
agentex/docs/docs/concepts/streaming.md	Updates one Python import snippet for SendEventParams in the streaming concept guide to the new canonical path.
agentex/docs/docs/temporal_development/openai_integration.md	Updates one Python import snippet for SendEventParams in the OpenAI integration guide to the new canonical path.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["10 markdown doc files\n(code samples + mkdocstrings directives)"]
    B["agentex.lib.types.acp\n(legacy path — back-compat shim)"]
    C["agentex.protocol.acp\n(canonical path — agentex-sdk ≥ 0.12.0)"]
    D["Types migrated:\nCreateTaskParams\nSendMessageParams\nSendEventParams\nCancelTaskParams"]

    A -->|"old import path"| B
    A -->|"new import path ✅"| C
    B -.->|"re-exports via shim"| C
    C --> D

Loading

_{Reviews (6): Last reviewed commit: "Merge branch 'main' into maxparke/agx1-2..." | Re-trigger Greptile}