0.8.0 - Lean reads & bundled Payload knowledge

Two DX/UX improvements, bundled.

Lean reads + read-size guard (fixes the slow query)

A query like "which products have no stock?" could fetch documents with their full relationships populated and return megabytes — one real case hit ~2.3 MB / ~470k prompt tokens / a ~12-minute turn.

• find, findByID, and findGlobal now take a depth option and default to depth: 0: relationship and upload fields return as ids, not populated documents.
• Read results over ~100 KB are rejected with a recoverable error that tells the agent to narrow the query (where/select/limit/depth).

Bundled Payload reference

The agent now ships with a compact, prompt-cached reference to Payload's query API and data shapes — the where operators, depth/select, sort, the find result shape, and per-field shapes (relationships/uploads, blocks blockType, arrays, groups, named/unnamed tabs, select, date, point) — so it queries and writes data correctly instead of by trial and error. Every fact is verified against the Payload 3.85 source.

Note

Reads default to depth: 0 now (relationship/upload fields come back as ids); the agent raises depth when it needs related data inline.