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

shipped production is serving it opened this has it

Landed in pull #14687 · run

opened this

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 test and the check stay green.

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.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs