Support Valibot for Structured Outputs

[fabian-hiller]

Confirm this is a feature request for the Node library and not the underlying OpenAI API.

• This is a feature request for the Node library

Describe the feature or improvement you're requesting

Hi, I am the creator of Valibot and would like to ask if you are interested in supporting Valibot for Structured Outputs besides Zod. If so, I would be happy to help with implementation and documentation.

Valibot is a newer schema validation library for TypeScript that I developed about a year ago as part of my bachelor thesis. Since then, the project has grown a lot and is slowly becoming a popular alternative to Zod. Among our partners are two universities as well as companies like Vercel, Netlify and DigitalOcean. I expect to release our v1 RC in the next 2 weeks. This might be the perfect time to integrate it into the OpenAI Node library.

Feel free to check out our website: https://valibot.dev/

Additional context

We are currently in the process of implementing an official toJsonSchema function for Valibot.

[RobertCraigie]

Hey @fabian-hiller, yes of course structured outputs helpers for Valibot is a great idea that we'd be happy to support!

How far along are you with an official toJsonSchema function?

[fabian-hiller]

I expect to finish the implementation of our official toJsonSchema function next week. Should I follow the implementation for Zod in this repository and create a PR with similar code for Valibot? Have you implemented a custom conversion from Zod to JSON Schema instead of using a community package because Structured Outputs does not support the full JSON Schema spec?

[RobertCraigie]

I'm not sure if we'd want to go with the exact same implementation to be honest.

The motivation for using our own zod-to-json-schema were:

• so we could massage the output to be Structured Outputs compatible
• to avoid adding a new dependency
• minor dx improvement that users don't have to install zod-to-json-schema themselves

I don't think we'd want to vendor our own json-schema converter for valibot just to keep the SDK from getting too big. Instead we'd likely go with something more similar to our Python SDK where we have a function that ensures a JSON schema is Structured Outputs compatible, instead of baking that into the JSON schema conversion library itelf.

How does that sound to you?

[fabian-hiller]

For us as a project, it would be an honor and short-term marketing advantage to be part of this library, but otherwise I fully agree that OpenAI should not be forced to maintain an adapter for every schema library.

Should such a function check every schema passed to response_format? Should there be an option to skip this check? Should I create a PR or do you prefer to create this function yourself?

[fabian-hiller]

We will probably release the first version of our toJsonSchema function tomorrow and would be ready to proceed with the integration into OpenAI's SDK.

[fabian-hiller]

v0.1.0 of our official toJsonSchema function is now available:

• https://github.com/fabian-hiller/valibot/tree/main/packages/to-json-schema
• https://www.npmjs.com/package/@valibot/to-json-schema
• https://jsr.io/@valibot/[email protected]