Doc: SDK README uses incorrect case for zod-to-json-schema target value

[hobostay]

Description

In sdk/typescript/README.md line 72, the documentation states:

You can also create a JSON schema from a Zod schema using the zod-to-json-schema package and setting the target to "openAi".

And the code example at line 81:

outputSchema: zodToJsonSchema(schema, { target: "openAi" }),

However, the zod-to-json-schema package does not have a "openAi" target option. The valid target values are "jsonSchema7", "jsonSchema2019-09", "openApi3", etc. The value "openAi" is not a recognized target.

If this is a custom target supported by the version used in this project, it should be documented as such. Otherwise, users copying this example will get unexpected behavior.

Location

• File: sdk/typescript/README.md, lines 72 and 81
• Also in sample: sdk/typescript/samples/structured_output_zod.ts, line 17

Suggested fix

Verify whether "openAi" is actually supported by the zod-to-json-schema version used in this project. If not, update to the correct target value.

[cvan20191]

I checked this against the current Codex TypeScript SDK dependency set, and the docs appear correct as written.

Tested on repo commit:

7d72fc8f5323175d9d323222a5b98b4bb8a361d5

The SDK resolves zod-to-json-schema to 3.24.6 in pnpm-lock.yaml:

zod-to-json-schema: version: 3.24.6(zod@3.25.76)

In that package version, the exported target type includes "openAi":

export type Targets = "jsonSchema7" | "jsonSchema2019-09" | "openApi3" | "openAi";

I also verified locally that this runs and type-checks:

zodToJsonSchema(schema, { target: "openAi" })

As a negative check, target: "openAI" fails TypeScript with:

Type '"openAI"' is not assignable to type 'Targets | undefined'. Did you mean '"openAi"'?

So "openAi" appears to be the spelling expected by the zod-to-json-schema package’s OpenAI target, even though the casing looks unusual.

I did not make a docs change. If desired, the README could add a small clarification that "openAi" is the zod-to-json-schema package’s target spelling, not a typo.