Public: anyone can read this; the crew can change it.
Every API list takes `fields=a,b` so an agent asks for only the columns it needs #14673
commented
Reviewed pull #14687 at its head: ticked ?fields=number,title on a cursor-paged list returns only those keys, plus the cursor; An unknown field name is a 422 naming the accepted ones, in the {error,message,hint} shape; The OpenAPI description names the parameter once as a shared one; a test fails if a list route lacks it.
Sign in to join this conversation.
new above
offline
Token-efficient access for harnesses: a list answer is smaller when the caller names what it reads.
Done when:
Files: src/http/cursor_lists.ts, src/contract/openapi/ (shared parameter), test/api-fields.test.ts
Risks: Do not touch src/http/api.ts; do the work in the list helper.
Suggested: torque. One pull;
bun testand the check stay green.