Adapters ↔ Contracts — Compatibility Matrix
This matrix maps client adapters to canonical contracts and surfaces.
| Adapter | Request Contract | Response Contract | Errors/Recovery | Metrics Surface | Notes |
|---|---|---|---|---|---|
| HTTP (POST /api/v1/orchestration/render) | render_request.v0 | render_context_reply.v0 | error.options[] returned in body with HTTP 200 when possible; transport 4xx/5xx only for hard failures | planner_ms, used_tokens (if available) in body; latency via server logs | Privacy honored (allow |
| MCP (command: mnemoverse/render) | render_request.v0 | render_context_reply.v0 | error.options[] in body; MCP-level failure only for transport/session errors | Same as HTTP | Host forwards correlation IDs |
Contracts
- Request: ../contracts/schemas.md (render_request.v0)
- Response: ../contracts/schemas.md (render_context_reply.v0)
- Retry Actions: ../orchestration/retry-actions.md
- Metrics: ../orchestration/metrics.md