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

[max-parke-scale]

Note: this is blocked and will fail CI until 371 lands in a release

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

• Local mkdocs serve renders without broken references.
• Anchor links from ::: agentex.protocol.acp.SendMessageParams resolve in the rendered HTML (mkdocstrings can find the symbol at the new path).

Greptile Summary

This PR updates 10 markdown documentation files in agentex/docs/ to use the canonical agentex.protocol.acp import path instead of the legacy agentex.lib.types.acp path, companion to the Python SDK migration in scale-agentex-python#371.

• 8 code sample imports updated across sync, async, Temporal, and streaming docs, replacing from agentex.lib.types.acp import ... with from agentex.protocol.acp import ....
• 6 mkdocstrings ::: directives updated in agent_types/sync.md, agent_types/async/base.md, agent_types/async/temporal.md, acp/agentic/base.md, acp/agentic/temporal.md, and api/types.md to resolve symbols at the new path.
• Other agentex.lib.types.* modules (fastacp, tracing, etc.) are intentionally left unchanged as they were not part of the upstream migration.

Confidence Score: 5/5

Safe to merge — all changes are documentation only, mechanically replacing one import path string with another across 10 markdown files.

Every change is a verbatim string substitution in doc code samples and mkdocstrings directives. The old path still works via a back-compat shim, so the docs remain accurate even before the new path resolves in a reader's environment. No runtime code is touched.

No files require special attention. The intentional omission of agentex.lib.types.fastacp and similar modules is clearly scoped and matches the upstream Python SDK migration.

Important Files Changed

Filename	Overview
agentex/docs/docs/acp/agentic/base.md	Updated three mkdocstrings ::: directives from agentex.lib.types.acp to agentex.protocol.acp for CreateTaskParams, SendEventParams, and CancelTaskParams.
agentex/docs/docs/acp/agentic/temporal.md	Updated one code sample import of CreateTaskParams, SendEventParams to the canonical agentex.protocol.acp path.
agentex/docs/docs/agent_types/async/base.md	Updated one code sample import and three mkdocstrings ::: directives for CreateTaskParams, SendEventParams, and CancelTaskParams; AsyncACPConfig intentionally left on the old path per PR scope.
agentex/docs/docs/agent_types/async/temporal.md	Updated one code sample import and two mkdocstrings ::: directives for CreateTaskParams and SendEventParams.
agentex/docs/docs/agent_types/sync.md	Updated one code sample import and one mkdocstrings ::: directive for SendMessageParams to the canonical agentex.protocol.acp path.
agentex/docs/docs/api/overview.md	Updated one code sample import of SendMessageParams, CreateTaskParams, and SendEventParams to the canonical agentex.protocol.acp path.
agentex/docs/docs/api/types.md	Updated four mkdocstrings ::: directives for CreateTaskParams, SendMessageParams, SendEventParams, and CancelTaskParams to the canonical path.
agentex/docs/docs/concepts/streaming.md	Updated one code sample import of SendEventParams to the canonical agentex.protocol.acp path.
agentex/docs/docs/getting_started/project_structure.md	Updated three code sample imports across sync, async, and Temporal sections to use agentex.protocol.acp.
agentex/docs/docs/temporal_development/openai_integration.md	Updated one code sample import of SendEventParams to the canonical agentex.protocol.acp path in the OpenAI streaming integration example.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Docs code samples & mkdocstrings] --> B{Import path}
    B -->|Before| C["agentex.lib.types.acp\n(back-compat shim)"]
    B -->|After this PR| D["agentex.protocol.acp\n(canonical path)"]
    C -.->|re-exports via shim| E[RPCMethod\nCreateTaskParams\nSendMessageParams\nSendEventParams\nCancelTaskParams]
    D --> E
    F["Other agentex.lib.types.*\n(fastacp, tracing, etc.)"] -->|unchanged — not migrated| G[Stays on old path]

Loading

_{Reviews (1): Last reviewed commit: "docs(agentex): use canonical agentex.pro..." | Re-trigger Greptile}