Skip to content

rust(docs): document bracket syntax for metadata filters - #829

Merged
bill-sift merged 1 commit into
mainfrom
claude/keen-shannon-8th1di
Oct 14, 2026
Merged

bill-sift merged 1 commit into
mainfrom
claude/keen-shannon-8th1di

Conversation

@bill-sift

Copy link
Copy Markdown
Contributor

The list tool descriptions told agents to filter metadata with metadata.{key}. The service only accepts metadata["<key>"] and rejects the dot form, so an agent that followed the description hit a compile error and told the user runs can't be filtered on metadata.

  • Swap metadata.{key} for metadata["<key>"] in every tool description that documents metadata filtering, examples included.
  • Add the same sentence to list_test_steps, list_test_measurements, count_test_steps and count_test_measurements, which named metadata as filterable without saying how to reference a key. Their proto comments document the syntax.
  • Add a test that every tool whose filter mentions metadata shows the bracket form and that no description shows a dot-form key.

alexa-sift
alexa-sift previously approved these changes Oct 13, 2026
The list tool descriptions told agents to filter metadata with
`metadata.{key}`. The service only accepts `metadata["<key>"]` and
rejects the dot form, so an agent that followed the description hit a
compile error and told the user runs can't be filtered on metadata.

- Swap `metadata.{key}` for `metadata["<key>"]` in every tool
  description that documents metadata filtering, examples included.
- Add the same sentence to list_test_steps, list_test_measurements,
  count_test_steps and count_test_measurements, which named `metadata`
  as filterable without saying how to reference a key. Their proto
  comments document the syntax.
- Update the authoring guide in sift_mcp/CLAUDE.md to show the bracket
  form as the metadata-key syntax to preserve.
- Add a test that every tool whose `filter` mentions metadata shows the
  bracket form and that no description shows a dot-form key.

ENG-15442
@bill-sift
bill-sift merged commit d7122ab into main Oct 14, 2026
22 checks passed
@bill-sift
bill-sift deleted the claude/keen-shannon-8th1di branch October 14, 2026 16:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants