C2AI2X Protocol Docs

This directory is the public documentation source for docs.zhenrobot.com/protocols/c2ai2x/.

It explains the external integration surface without redefining the upstream standard or runtime ownership.

Boundary

• protocol standard source of truth: zhen-protocol-c2ai2x
• public runtime ingress: zhen-platform-core
• execution runtime: zhen-brain-core
• vertical samples and mappings: business frontends

This directory is the official public explanation layer for external integrators.

Fixed reminder:

• the protocol is not the only entry product
• no-code Hosted Inbox and low-code Widget Embed sit above the protocol as productized access surfaces
• direct protocol execution still uses the live zhen-platform-core ingress contract

Recommended Reading Order

1. overview.md
2. first-request.md
3. quickstart.md
4. execution-lifecycle.md
5. core-objects.md
6. auth-and-scopes.md
7. trust-boundary.md
8. error-model.md
9. api-reference.md
10. webhooks.md
11. production-readiness.md
12. conformance.md
13. examples.md
14. changelog.md

Upstream Binding

This directory stays aligned with:

1. /www/wwwroot/zhen-protocol-c2ai2x/README.md
2. /www/wwwroot/zhen-protocol-c2ai2x/docs/architecture/ADR-001-protocol-standard-boundary.md
3. zhen-platform-core live ingress contract for POST /api/execute
4. /www/wwwroot/zhen-platform-core/spec/openapi.yaml
5. /www/wwwroot/zhen-brain-core/docs/c2ai2x-runtime-consumption.md

If this directory conflicts with the standard repository or the platform live contract, the upstream standard and platform ingress contract win.