What to build
agents-api's contract gains its missing error codes, its four undeclared real-time endpoints, and a pagination convention for its unbounded collections.
agents-api is the best of the three today — 8 error responses across 52 operations, and it already emits ProblemDetail/FieldError — but four endpoints that agents-ui depends on in production appear nowhere in the spec: two EventSource streams, one fetch-reader stream, and a WebSocket. Nothing gates changes to their payload shapes.
Acceptance criteria
Blocked by
- Declare ProblemDetail responses on every operation (kotlin-spring-commons tracker)
What to build
agents-api's contract gains its missing error codes, its four undeclared real-time endpoints, and a pagination convention for its unbounded collections.agents-apiis the best of the three today — 8 error responses across 52 operations, and it already emitsProblemDetail/FieldError— but four endpoints thatagents-uidepends on in production appear nowhere in the spec: two EventSource streams, one fetch-reader stream, and a WebSocket. Nothing gates changes to their payload shapes.Acceptance criteria
oasdiffbreaking changes are intentional and called out, not incidentalBlocked by