Skip to content

feat: read tools — server info, entity discovery, metadata-validated queries, composite-key gets (train 3) - #3

Merged
leonagente merged 1 commit into
mainfrom
train/3-read-tools
Aug 29, 2026
Merged

feat: read tools — server info, entity discovery, metadata-validated queries, composite-key gets (train 3)#3
leonagente merged 1 commit into
mainfrom
train/3-read-tools

Conversation

@leonagente

@leonagente leonagente commented Aug 29, 2026

Copy link
Copy Markdown
Member

Summary

  • priority_get_server_info: version + login + GETCOMPANIES (≤3 requests)
  • priority_list_entities via service root doc (NOT $metadata — 30s+ timeout verified); priority_get_entity_schema via MetadataStore with subforms convenience array
  • priority_query_records: EVERY filterField/select/orderBy field validated against entity metadata BEFORE HTTP; rawFilter escape hatch (token-validated, quotes-aware); $since UTC-Z enforced
  • priority_get_record: composite-key aware (key fields must exactly match schema.keyFields)
  • READ_ANNOTATIONS on all tools (readOnlyHint/idempotentHint/destructiveHint/openWorldHint)
  • 134 unit tests + 4 live integration cases

Live verification (orchestrator-run, raw in session)

  • a) server_info: Priority 25.x + companies ✔ (817ms)
  • b) LOGPART TYPE=P filter: all rows typed P, ≤5 ✔ (1201ms)
  • c) filterField=ZZZNOPE → typed validation_error in 2ms = ZERO HTTP calls — silent-swallow guard proven live ✔
  • d) AINVOICES composite-key get ✔ (1409ms)

@leonagente
leonagente merged commit e533e0b into main Aug 29, 2026
3 checks passed
@leonagente
leonagente deleted the train/3-read-tools branch August 29, 2026 11:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@leonagente