Summary
The Engine API placeholder routes (trust, audit, agents, decisions) return 200 OK with spec-conformant empty payloads. Studio consumers cannot tell a real empty result from a not-yet-implemented backend without inspecting the body.
Context
Raised as a non-blocking follow-up in the review of PR #3085 (issue #3066). Returning 200 with an empty collection (rather than 501) is intentional and contract-conformant, but it hides the placeholder status from clients.
Proposal
Emit an X-AGT-Backend-Status: placeholder response header on the routes whose backend is not yet wired, so Studio consumers have a signal without polling items. Remove the header per route as each real backend lands.
Scope
agent-governance-python/agent-mesh/src/agentmesh/engine_api/routes/ (trust, audit, agents, decisions)- Tests asserting the header is present on placeholder routes and absent once a backend is implemented.
Follow-up from PR #3085, issue #3066.
Summary
The Engine API placeholder routes (trust, audit, agents, decisions) return
200 OKwith spec-conformant empty payloads. Studio consumers cannot tell a real empty result from a not-yet-implemented backend without inspecting the body.Context
Raised as a non-blocking follow-up in the review of PR #3085 (issue #3066). Returning
200with an empty collection (rather than501) is intentional and contract-conformant, but it hides the placeholder status from clients.Proposal
Emit an
X-AGT-Backend-Status: placeholderresponse header on the routes whose backend is not yet wired, so Studio consumers have a signal without pollingitems. Remove the header per route as each real backend lands.Scope
agent-governance-python/agent-mesh/src/agentmesh/engine_api/routes/(trust, audit, agents, decisions)Follow-up from PR #3085, issue #3066.