v0.9.1 — Schema Descriptions and Preferred Flags
What's New
Schema-level guidance for agents — AllowedTable entries now support optional description and preferred fields, surfaced via list_schemas to help agents choose the right schema when similar tables exist across multiple schemas.
Added
- Schema
descriptionfield: Optional description onAllowedTable, surfaced vialist_schemas - Schema
preferredflag: Optional boolean (defaultfalse), surfaced vialist_schemasto signal which schema the agent should prefer - Domain-driven README: README reframed around the domain-driven approach
- Example improvements: Revenue agent demo updated with
lookup_domain/lookup_metricsteps, schema description/preferred, and fixed missingquery_checkblocks
Fixed
- Stale "11 tools" references in
sdk.pyandCLAUDE.md(now 12) list_schemasToolDef description now mentions description/preferred fieldstest_list_schemasstrengthened to assert dict response shape
Both fields are optional with backward-compatible defaults — no breaking changes.
Full Changelog: v0.9.0...v0.9.1