ai-sdk-provider-codex-cli 0.5.0 → 0.5.2

package/README.md

@@ -10,7 +10,7 @@
 [![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/ben-vargas/ai-sdk-provider-codex-cli/issues)
 [![Latest Release](https://img.shields.io/github/v/release/ben-vargas/ai-sdk-provider-codex-cli?display_name=tag)](https://github.com/ben-vargas/ai-sdk-provider-codex-cli/releases/latest)
 
-A community provider for Vercel AI SDK v5 that uses OpenAI’s Codex CLI (non‑interactive `codex exec`) to talk to GPT‑5 class models (`gpt-5` and the Codex-specific `gpt-5-codex` slug) with your ChatGPT Plus/Pro subscription. The provider spawns the Codex CLI process, parses its JSONL output, and adapts it to the AI SDK LanguageModelV2 interface.
+A community provider for Vercel AI SDK v5 that uses OpenAI’s Codex CLI (non‑interactive `codex exec`) to talk to GPT‑5.1 class models (`gpt-5.1`, the Codex-specific `gpt-5.1-codex`, the flagship `gpt-5.1-codex-max`, and the lightweight `gpt-5.1-codex-mini` slugs) with your ChatGPT Plus/Pro subscription. The provider spawns the Codex CLI process, parses its JSONL output, and adapts it to the AI SDK LanguageModelV2 interface. Legacy GPT-5 / GPT-5-codex slugs remain compatible for existing workflows.
 
 - Works with `generateText`, `streamText`, and `generateObject` (native JSON Schema support via `--output-schema`)
 - Uses ChatGPT OAuth from `codex login` (tokens in `~/.codex/auth.json`) or `OPENAI_API_KEY`
@@ -28,7 +28,7 @@ npm i -g @openai/codex
 codex login   # or set OPENAI_API_KEY
 ```
 
-> **⚠️ Version Requirement**: Requires Codex CLI **>= 0.42.0** for `--experimental-json` and `--output-schema` support. **>= 0.44.0 recommended** for full usage tracking and tool streaming support. Check your version with `codex --version` and upgrade if needed:
+> **⚠️ Version Requirement**: Requires Codex CLI **>= 0.42.0** for `--experimental-json` and `--output-schema` support. **>= 0.60.0 recommended** for `gpt-5.1-codex-max` and `xhigh` reasoning effort. If you supply your own Codex CLI (global install or custom `codexPath`/`allowNpx`), check it with `codex --version` and upgrade if needed. The optional dependency `@openai/codex` in this package pulls a compatible version automatically.
 >
 > ```bash
 > npm i -g @openai/codex@latest
@@ -48,7 +48,7 @@ Text generation
 import { generateText } from 'ai';
 import { codexCli } from 'ai-sdk-provider-codex-cli';
 
-const model = codexCli('gpt-5-codex', {
+const model = codexCli('gpt-5.1-codex', {
   allowNpx: true,
   skipGitRepoCheck: true,
   approvalMode: 'on-failure',
@@ -68,10 +68,10 @@ Streaming
 import { streamText } from 'ai';
 import { codexCli } from 'ai-sdk-provider-codex-cli';
 
-// The provider works with both `gpt-5` and `gpt-5-codex`; use the latter for
-// the Codex CLI specific slug.
+// The provider works with both `gpt-5.1` and `gpt-5.1-codex`; use the latter for
+// the Codex CLI specific slug. Legacy `gpt-5` slugs still work if you need them.
 const { textStream } = await streamText({
-  model: codexCli('gpt-5-codex', { allowNpx: true, skipGitRepoCheck: true }),
+  model: codexCli('gpt-5.1-codex', { allowNpx: true, skipGitRepoCheck: true }),
   prompt: 'Write two short lines of encouragement.',
 });
 for await (const chunk of textStream) process.stdout.write(chunk);
@@ -86,7 +86,7 @@ import { codexCli } from 'ai-sdk-provider-codex-cli';
 
 const schema = z.object({ name: z.string(), age: z.number().int() });
 const { object } = await generateObject({
-  model: codexCli('gpt-5-codex', { allowNpx: true, skipGitRepoCheck: true }),
+  model: codexCli('gpt-5.1-codex', { allowNpx: true, skipGitRepoCheck: true }),
   schema,
   prompt: 'Generate a small user profile.',
 });
@@ -114,7 +114,7 @@ import { streamText } from 'ai';
 import { codexCli } from 'ai-sdk-provider-codex-cli';
 
 const result = await streamText({
-  model: codexCli('gpt-5-codex', { allowNpx: true, skipGitRepoCheck: true }),
+  model: codexCli('gpt-5.1-codex', { allowNpx: true, skipGitRepoCheck: true }),
   prompt: 'List files and count lines in the largest one',
 });
 
@@ -145,20 +145,20 @@ Control logging verbosity and integrate with your observability stack:
 import { codexCli } from 'ai-sdk-provider-codex-cli';
 
 // Default: warn/error only (clean production output)
-const model = codexCli('gpt-5-codex', {
+const model = codexCli('gpt-5.1-codex', {
   allowNpx: true,
   skipGitRepoCheck: true,
 });
 
 // Verbose mode: enable debug/info logs for troubleshooting
-const verboseModel = codexCli('gpt-5-codex', {
+const verboseModel = codexCli('gpt-5.1-codex', {
   allowNpx: true,
   skipGitRepoCheck: true,
   verbose: true, // Shows all log levels
 });
 
 // Custom logger: integrate with Winston, Pino, Datadog, etc.
-const customModel = codexCli('gpt-5-codex', {
+const customModel = codexCli('gpt-5.1-codex', {
   allowNpx: true,
   skipGitRepoCheck: true,
   verbose: true,
@@ -171,7 +171,7 @@ const customModel = codexCli('gpt-5-codex', {
 });
 
 // Silent: disable all logging
-const silentModel = codexCli('gpt-5-codex', {
+const silentModel = codexCli('gpt-5.1-codex', {
   allowNpx: true,
   skipGitRepoCheck: true,
   logger: false, // No logs at all
@@ -243,12 +243,12 @@ Control reasoning effort, verbosity, and advanced Codex features at model creati
 ```ts
 import { codexCli } from 'ai-sdk-provider-codex-cli';
 
-const model = codexCli('gpt-5-codex', {
+const model = codexCli('gpt-5.1-codex', {
   allowNpx: true,
   skipGitRepoCheck: true,
 
   // Reasoning & verbosity
-  reasoningEffort: 'medium', // minimal | low | medium | high
+  reasoningEffort: 'medium', // minimal | low | medium | high | xhigh (xhigh only on gpt-5.1-codex-max)
   reasoningSummary: 'auto', // auto | detailed (Note: 'concise' and 'none' are rejected by API)
   reasoningSummaryFormat: 'none', // none | experimental
   modelVerbosity: 'high', // low | medium | high
@@ -279,7 +279,7 @@ values take precedence over constructor defaults while leaving other settings in
 import { generateText } from 'ai';
 import { codexCli } from 'ai-sdk-provider-codex-cli';
 
-const model = codexCli('gpt-5-codex', {
+const model = codexCli('gpt-5.1-codex', {
   allowNpx: true,
   reasoningEffort: 'medium',
   modelVerbosity: 'medium',

package/dist/index.cjs

@@ -82,7 +82,7 @@ var settingsSchema = zod.z.object({
   verbose: zod.z.boolean().optional(),
   logger: zod.z.union([zod.z.literal(false), loggerFunctionSchema]).optional(),
   // NEW: Reasoning & Verbosity
-  reasoningEffort: zod.z.enum(["minimal", "low", "medium", "high"]).optional(),
+  reasoningEffort: zod.z.enum(["minimal", "low", "medium", "high", "xhigh"]).optional(),
   // Note: API rejects 'concise' and 'none' despite error messages claiming they're valid
   reasoningSummary: zod.z.enum(["auto", "detailed"]).optional(),
   reasoningSummaryFormat: zod.z.enum(["none", "experimental"]).optional(),
@@ -231,7 +231,7 @@ function isAuthenticationError(err) {
 
 // src/codex-cli-language-model.ts
 var codexCliProviderOptionsSchema = zod.z.object({
-  reasoningEffort: zod.z.enum(["minimal", "low", "medium", "high"]).optional(),
+  reasoningEffort: zod.z.enum(["minimal", "low", "medium", "high", "xhigh"]).optional(),
   reasoningSummary: zod.z.enum(["auto", "detailed"]).optional(),
   reasoningSummaryFormat: zod.z.enum(["none", "experimental"]).optional(),
   textVerbosity: zod.z.enum(["low", "medium", "high"]).optional(),

package/dist/index.d.cts

@@ -37,7 +37,7 @@ interface Logger {
 }
 type ApprovalMode = 'untrusted' | 'on-failure' | 'on-request' | 'never';
 type SandboxMode = 'read-only' | 'workspace-write' | 'danger-full-access';
-type ReasoningEffort = 'minimal' | 'low' | 'medium' | 'high';
+type ReasoningEffort = 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
 /**
  * Reasoning summary detail level.
  * Note: The API error messages claim 'concise' and 'none' are valid, but they are
@@ -61,8 +61,12 @@ interface CodexCliSettings {
     verbose?: boolean;
     logger?: Logger | false;
     /**
-     * Controls reasoning effort for reasoning-capable models (o3, o4-mini, gpt-5, gpt-5-codex).
-     * Higher effort produces more thorough reasoning at the cost of latency.
+     * Controls reasoning effort for reasoning-capable models (o3, o4-mini, the GPT-5.1 family,
+     * and legacy GPT-5 slugs). Higher effort produces more thorough reasoning at the cost of latency.
+     *
+     * Codex CLI model presets currently expose `low`/`medium`/`high` for `gpt-5.1` and `gpt-5.1-codex`.
+     * `gpt-5.1-codex-max` additionally supports `xhigh`. `gpt-5.1-codex-mini` only offers `medium`/`high`.
+     * The legacy `gpt-5` slug still allowed `minimal`, but GPT-5.1 rejects it.
      *
      * Maps to: `-c model_reasoning_effort=<value>`
      * @see https://platform.openai.com/docs/guides/reasoning
@@ -86,7 +90,8 @@ interface CodexCliSettings {
      */
     reasoningSummaryFormat?: ReasoningSummaryFormat;
     /**
-     * Controls output length/detail for GPT-5 family models.
+     * Controls output length/detail for GPT-5.1 (non-Codex) and legacy GPT-5 models.
+     * Codex-specific slugs ignore this flag because the CLI disables verbosity for them.
      * Only applies to models using the Responses API.
      *
      * Maps to: `-c model_verbosity=<value>`

package/dist/index.d.ts

@@ -37,7 +37,7 @@ interface Logger {
 }
 type ApprovalMode = 'untrusted' | 'on-failure' | 'on-request' | 'never';
 type SandboxMode = 'read-only' | 'workspace-write' | 'danger-full-access';
-type ReasoningEffort = 'minimal' | 'low' | 'medium' | 'high';
+type ReasoningEffort = 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
 /**
  * Reasoning summary detail level.
  * Note: The API error messages claim 'concise' and 'none' are valid, but they are
@@ -61,8 +61,12 @@ interface CodexCliSettings {
     verbose?: boolean;
     logger?: Logger | false;
     /**
-     * Controls reasoning effort for reasoning-capable models (o3, o4-mini, gpt-5, gpt-5-codex).
-     * Higher effort produces more thorough reasoning at the cost of latency.
+     * Controls reasoning effort for reasoning-capable models (o3, o4-mini, the GPT-5.1 family,
+     * and legacy GPT-5 slugs). Higher effort produces more thorough reasoning at the cost of latency.
+     *
+     * Codex CLI model presets currently expose `low`/`medium`/`high` for `gpt-5.1` and `gpt-5.1-codex`.
+     * `gpt-5.1-codex-max` additionally supports `xhigh`. `gpt-5.1-codex-mini` only offers `medium`/`high`.
+     * The legacy `gpt-5` slug still allowed `minimal`, but GPT-5.1 rejects it.
      *
      * Maps to: `-c model_reasoning_effort=<value>`
      * @see https://platform.openai.com/docs/guides/reasoning
@@ -86,7 +90,8 @@ interface CodexCliSettings {
      */
     reasoningSummaryFormat?: ReasoningSummaryFormat;
     /**
-     * Controls output length/detail for GPT-5 family models.
+     * Controls output length/detail for GPT-5.1 (non-Codex) and legacy GPT-5 models.
+     * Codex-specific slugs ignore this flag because the CLI disables verbosity for them.
      * Only applies to models using the Responses API.
      *
      * Maps to: `-c model_verbosity=<value>`

package/dist/index.js

@@ -79,7 +79,7 @@ var settingsSchema = z.object({
   verbose: z.boolean().optional(),
   logger: z.union([z.literal(false), loggerFunctionSchema]).optional(),
   // NEW: Reasoning & Verbosity
-  reasoningEffort: z.enum(["minimal", "low", "medium", "high"]).optional(),
+  reasoningEffort: z.enum(["minimal", "low", "medium", "high", "xhigh"]).optional(),
   // Note: API rejects 'concise' and 'none' despite error messages claiming they're valid
   reasoningSummary: z.enum(["auto", "detailed"]).optional(),
   reasoningSummaryFormat: z.enum(["none", "experimental"]).optional(),
@@ -228,7 +228,7 @@ function isAuthenticationError(err) {
 
 // src/codex-cli-language-model.ts
 var codexCliProviderOptionsSchema = z.object({
-  reasoningEffort: z.enum(["minimal", "low", "medium", "high"]).optional(),
+  reasoningEffort: z.enum(["minimal", "low", "medium", "high", "xhigh"]).optional(),
   reasoningSummary: z.enum(["auto", "detailed"]).optional(),
   reasoningSummaryFormat: z.enum(["none", "experimental"]).optional(),
   textVerbosity: z.enum(["low", "medium", "high"]).optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-sdk-provider-codex-cli",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "AI SDK v5 provider for OpenAI Codex CLI with native JSON Schema support",
   "keywords": [
     "ai-sdk",
@@ -9,6 +9,9 @@
     "cli",
     "language-model",
     "gpt-5",
+    "gpt-5.1",
+    "gpt-5.1-codex",
+    "gpt-5.1-codex-max",
     "provider"
   ],
   "homepage": "https://github.com/ben-vargas/ai-sdk-provider-codex-cli",
@@ -61,20 +64,20 @@
     "jsonc-parser": "^3.3.1"
   },
   "optionalDependencies": {
-    "@openai/codex": "^0.44.0"
+    "@openai/codex": "^0.60.1"
   },
   "devDependencies": {
     "@eslint/js": "^9.14.0",
-    "@types/node": "20.17.24",
+    "@types/node": "20.19.6",
     "@vitest/coverage-v8": "^3.2.4",
-    "ai": "5.0.14",
+    "ai": "5.0.93",
     "eslint": "^9.14.0",
     "prettier": "^3.3.3",
     "tsup": "8.5.0",
     "typescript": "5.6.3",
     "vitest": "^3.2.4",
     "typescript-eslint": "^8.6.0",
-    "zod": "^4.0.17"
+    "zod": "^4.1.8"
   },
   "peerDependencies": {
     "zod": "^3.0.0 || ^4.0.0"