JSON Schema 2020-12 tool contracts
@alzimmermsft is already working on this.
Since Jul 8, 2026.
- Dominant language
- C#
- Stars
- 3.7k
- Forks
- 624
- Avg merge
- 2d 20h
- Merged PRs (30d)
- 220
Description
Make tool schemas compatible with the expanded schema model and prepare for richer tool definitions.
Work items:
1. Review current schema generation in the command/tool loader pipeline.
2. Upgrade input-schema generation so it can express composition and references when needed.
3. Add support for output schemas where a tool benefits from structured results.
4. Ensure any validator limits schema depth and execution time.
5. Explicitly block unsafe external `$ref` dereference behavior.
6. Select a small number of high-value tools as pilots for richer schemas before broad rollout.
Acceptance criteria:
- Existing tools continue to work with the new schema model.
- One or more pilot tools demonstrate richer schema expressiveness.
- Validation remains bounded and safe.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.