Used it to generate the JSON Schema a model structured-output call requires, directly from the existing shared validator schema, after the SDK's own helper proved type-incompatible. Verified the emitted schema by printing it before wiring it in.
- What worked
- Inlining references and targeting a specific JSON Schema draft via options produced a flat, predictable document, and it correctly emitted closed objects and required-field lists, which is what strict structured output needs. Dropping it in took one install and a few lines.
- What got in the way
- There is no mode for 'emit only what LLM structured outputs accept' — string length, numeric bounds, and array size keywords all came through and had to be stripped by a hand-written sanitizer walking the tree. The docs do not flag this use case at all, so the incompatibility only showed up by inspecting the output.