ai-sdk-provider-codex-cli 1.0.0-beta.1 → 1.0.1

package/README.md

@@ -4,33 +4,31 @@
 [![npm downloads](https://img.shields.io/npm/dm/ai-sdk-provider-codex-cli.svg)](https://www.npmjs.com/package/ai-sdk-provider-codex-cli)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 ![Node >= 18](https://img.shields.io/badge/node-%3E%3D18-43853d?logo=node.js&logoColor=white)
-![AI SDK v6 beta](https://img.shields.io/badge/AI%20SDK-v6%20beta-000?logo=vercel&logoColor=white)
+![AI SDK v6](https://img.shields.io/badge/AI%20SDK-v6-000?logo=vercel&logoColor=white)
 ![Modules: ESM + CJS](https://img.shields.io/badge/modules-ESM%20%2B%20CJS-3178c6)
 ![TypeScript](https://img.shields.io/badge/TypeScript-blue)
 [![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 v6 (beta) 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 LanguageModelV3 interface. Legacy GPT-5 / GPT-5-codex slugs remain compatible for existing workflows.
-
-> **⚠️ AI SDK v6 Beta**: This version (`1.0.0-beta.x`) requires AI SDK v6 beta packages. For AI SDK v5, use the `0.x` releases from the main branch.
+A community provider for Vercel AI SDK v6 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 LanguageModelV3 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`
 - Node-only (spawns a local process); supports CI and local dev
-- **v1.0.0-beta.1**: AI SDK v6 migration with LanguageModelV3 interface
+- **v1.0.0**: AI SDK v6 stable migration with LanguageModelV3 interface
 - **v0.5.0**: Adds comprehensive logging system with verbose mode and custom logger support
 - **v0.3.0**: Adds comprehensive tool streaming support for monitoring autonomous tool execution
 
 ## Version Compatibility
 
-| Provider Version | AI SDK Version | NPM Tag   | Status | Branch       |
-| ---------------- | -------------- | --------- | ------ | ------------ |
-| 1.x.x-beta       | v6 (beta)      | `beta`    | Beta   | `ai-sdk-v6`  |
-| 0.x.x            | v5             | `latest`  | Stable | `main`       |
+| Provider Version | AI SDK Version | NPM Tag      | NPM Installation |
+| ---------------- | -------------- | ------------ | ---------------- |
+| 1.x.x            | v6             | `latest`     | `npm i ai-sdk-provider-codex-cli ai@^6.0.0` |
+| 0.x.x            | v5             | `ai-sdk-v5`  | `npm i ai-sdk-provider-codex-cli@ai-sdk-v5 ai@^5.0.0` |
 
 ## Installation
 
-### For AI SDK v6 (beta)
+### For AI SDK v6 (default)
 
 1. Install and authenticate Codex CLI
 
@@ -39,16 +37,16 @@ npm i -g @openai/codex
 codex login   # or set OPENAI_API_KEY
 ```
 
-2. Install provider and AI SDK v6 beta
+2. Install provider and AI SDK v6
 
 ```bash
-npm i ai@beta ai-sdk-provider-codex-cli@beta
+npm i ai ai-sdk-provider-codex-cli
 ```
 
-### For AI SDK v5 (stable)
+### For AI SDK v5
 
 ```bash
-npm i ai ai-sdk-provider-codex-cli
+npm i ai@^5.0.0 ai-sdk-provider-codex-cli@ai-sdk-v5
 ```
 
 > **⚠️ Codex CLI Version**: 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.
@@ -315,7 +313,6 @@ const model = codexCli('gpt-5.1-codex', {
   modelVerbosity: 'high', // low | medium | high
 
   // Advanced features
-  includePlanTool: true, // adds --include-plan-tool
   profile: 'production', // adds --profile production
   oss: false, // adds --oss when true
   webSearch: true, // maps to -c tools.web_search=true

package/dist/index.cjs

@@ -117,7 +117,6 @@ var settingsSchema = zod.z.object({
   reasoningSummaryFormat: zod.z.enum(["none", "experimental"]).optional(),
   modelVerbosity: zod.z.enum(["low", "medium", "high"]).optional(),
   // NEW: Advanced features
-  includePlanTool: zod.z.boolean().optional(),
   profile: zod.z.string().optional(),
   oss: zod.z.boolean().optional(),
   webSearch: zod.z.boolean().optional(),
@@ -356,6 +355,41 @@ function isAuthenticationError(err) {
 }
 
 // src/codex-cli-language-model.ts
+function createEmptyCodexUsage() {
+  return {
+    inputTokens: {
+      total: 0,
+      noCache: 0,
+      cacheRead: 0,
+      cacheWrite: 0
+    },
+    outputTokens: {
+      total: 0,
+      text: void 0,
+      reasoning: void 0
+    },
+    raw: void 0
+  };
+}
+function mapCodexCliFinishReason(reason) {
+  switch (reason) {
+    case "stop":
+    case "end_turn":
+    case void 0:
+      return { unified: "stop", raw: reason };
+    case "length":
+    case "max_tokens":
+      return { unified: "length", raw: reason };
+    case "content_filter":
+      return { unified: "content-filter", raw: reason };
+    case "tool_calls":
+      return { unified: "tool-calls", raw: reason };
+    case "error":
+      return { unified: "error", raw: reason };
+    default:
+      return { unified: "other", raw: reason };
+  }
+}
 var codexCliProviderOptionsSchema = zod.z.object({
   reasoningEffort: zod.z.enum(["minimal", "low", "medium", "high", "xhigh"]).optional(),
   reasoningSummary: zod.z.enum(["auto", "detailed"]).optional(),
@@ -527,9 +561,6 @@ var CodexCliLanguageModel = class {
     if (settings.modelVerbosity) {
       args.push("-c", `model_verbosity=${settings.modelVerbosity}`);
     }
-    if (settings.includePlanTool) {
-      args.push("--include-plan-tool");
-    }
     if (settings.profile) {
       args.push("--profile", settings.profile);
     }
@@ -759,13 +790,14 @@ var CodexCliLanguageModel = class {
         total: inputTotal,
         noCache: inputTotal - cachedInputTokens,
         cacheRead: cachedInputTokens,
-        cacheWrite: void 0
+        cacheWrite: 0
       },
       outputTokens: {
         total: outputTotal,
-        text: outputTotal,
+        text: void 0,
         reasoning: void 0
-      }
+      },
+      raw: reported
     };
   }
   getToolName(item) {
@@ -963,11 +995,8 @@ var CodexCliLanguageModel = class {
       `[codex-cli] Executing Codex CLI: ${cmd} with ${args.length} arguments, cwd: ${cwd ?? "default"}`
     );
     let text = "";
-    let usage = {
-      inputTokens: { total: 0, noCache: 0, cacheRead: 0, cacheWrite: void 0 },
-      outputTokens: { total: 0, text: 0, reasoning: void 0 }
-    };
-    const finishReason = "stop";
+    let usage = createEmptyCodexUsage();
+    let finishReason = mapCodexCliFinishReason(void 0);
     const startTime = Date.now();
     const child = child_process.spawn(cmd, args, { env, cwd, stdio: ["ignore", "pipe", "pipe"] });
     let onAbort;
@@ -1280,10 +1309,7 @@ var CodexCliLanguageModel = class {
             controller.enqueue({ type: "text-delta", id: textId, delta: finalText });
             controller.enqueue({ type: "text-end", id: textId });
           }
-          const usageSummary = lastUsage ?? {
-            inputTokens: { total: 0, noCache: 0, cacheRead: 0, cacheWrite: void 0 },
-            outputTokens: { total: 0, text: 0, reasoning: void 0 }
-          };
+          const usageSummary = lastUsage ?? createEmptyCodexUsage();
           const totalTokens = (usageSummary.inputTokens.total ?? 0) + (usageSummary.outputTokens.total ?? 0);
           this.logger.info(
             `[codex-cli] Stream completed - Session: ${this.sessionId ?? "N/A"}, Duration: ${duration}ms, Tokens: ${totalTokens}`
@@ -1293,7 +1319,7 @@ var CodexCliLanguageModel = class {
           );
           controller.enqueue({
             type: "finish",
-            finishReason: "stop",
+            finishReason: mapCodexCliFinishReason(void 0),
             usage: usageSummary
           });
           controller.close();

package/dist/index.d.cts

@@ -158,12 +158,6 @@ interface CodexCliSettings {
      * Maps to: `-c features.rmcp_client=true`
      */
     rmcpClient?: boolean;
-    /**
-     * Include experimental plan tool that the model can use to update its current plan.
-     *
-     * Maps to: `--include-plan-tool`
-     */
-    includePlanTool?: boolean;
     /**
      * Configuration profile from config.toml to specify default options.
      *

package/dist/index.d.ts

@@ -158,12 +158,6 @@ interface CodexCliSettings {
      * Maps to: `-c features.rmcp_client=true`
      */
     rmcpClient?: boolean;
-    /**
-     * Include experimental plan tool that the model can use to update its current plan.
-     *
-     * Maps to: `--include-plan-tool`
-     */
-    includePlanTool?: boolean;
     /**
      * Configuration profile from config.toml to specify default options.
      *

package/dist/index.js

@@ -114,7 +114,6 @@ var settingsSchema = z.object({
   reasoningSummaryFormat: z.enum(["none", "experimental"]).optional(),
   modelVerbosity: z.enum(["low", "medium", "high"]).optional(),
   // NEW: Advanced features
-  includePlanTool: z.boolean().optional(),
   profile: z.string().optional(),
   oss: z.boolean().optional(),
   webSearch: z.boolean().optional(),
@@ -353,6 +352,41 @@ function isAuthenticationError(err) {
 }
 
 // src/codex-cli-language-model.ts
+function createEmptyCodexUsage() {
+  return {
+    inputTokens: {
+      total: 0,
+      noCache: 0,
+      cacheRead: 0,
+      cacheWrite: 0
+    },
+    outputTokens: {
+      total: 0,
+      text: void 0,
+      reasoning: void 0
+    },
+    raw: void 0
+  };
+}
+function mapCodexCliFinishReason(reason) {
+  switch (reason) {
+    case "stop":
+    case "end_turn":
+    case void 0:
+      return { unified: "stop", raw: reason };
+    case "length":
+    case "max_tokens":
+      return { unified: "length", raw: reason };
+    case "content_filter":
+      return { unified: "content-filter", raw: reason };
+    case "tool_calls":
+      return { unified: "tool-calls", raw: reason };
+    case "error":
+      return { unified: "error", raw: reason };
+    default:
+      return { unified: "other", raw: reason };
+  }
+}
 var codexCliProviderOptionsSchema = z.object({
   reasoningEffort: z.enum(["minimal", "low", "medium", "high", "xhigh"]).optional(),
   reasoningSummary: z.enum(["auto", "detailed"]).optional(),
@@ -524,9 +558,6 @@ var CodexCliLanguageModel = class {
     if (settings.modelVerbosity) {
       args.push("-c", `model_verbosity=${settings.modelVerbosity}`);
     }
-    if (settings.includePlanTool) {
-      args.push("--include-plan-tool");
-    }
     if (settings.profile) {
       args.push("--profile", settings.profile);
     }
@@ -756,13 +787,14 @@ var CodexCliLanguageModel = class {
         total: inputTotal,
         noCache: inputTotal - cachedInputTokens,
         cacheRead: cachedInputTokens,
-        cacheWrite: void 0
+        cacheWrite: 0
       },
       outputTokens: {
         total: outputTotal,
-        text: outputTotal,
+        text: void 0,
         reasoning: void 0
-      }
+      },
+      raw: reported
     };
   }
   getToolName(item) {
@@ -960,11 +992,8 @@ var CodexCliLanguageModel = class {
       `[codex-cli] Executing Codex CLI: ${cmd} with ${args.length} arguments, cwd: ${cwd ?? "default"}`
     );
     let text = "";
-    let usage = {
-      inputTokens: { total: 0, noCache: 0, cacheRead: 0, cacheWrite: void 0 },
-      outputTokens: { total: 0, text: 0, reasoning: void 0 }
-    };
-    const finishReason = "stop";
+    let usage = createEmptyCodexUsage();
+    let finishReason = mapCodexCliFinishReason(void 0);
     const startTime = Date.now();
     const child = spawn(cmd, args, { env, cwd, stdio: ["ignore", "pipe", "pipe"] });
     let onAbort;
@@ -1277,10 +1306,7 @@ var CodexCliLanguageModel = class {
             controller.enqueue({ type: "text-delta", id: textId, delta: finalText });
             controller.enqueue({ type: "text-end", id: textId });
           }
-          const usageSummary = lastUsage ?? {
-            inputTokens: { total: 0, noCache: 0, cacheRead: 0, cacheWrite: void 0 },
-            outputTokens: { total: 0, text: 0, reasoning: void 0 }
-          };
+          const usageSummary = lastUsage ?? createEmptyCodexUsage();
           const totalTokens = (usageSummary.inputTokens.total ?? 0) + (usageSummary.outputTokens.total ?? 0);
           this.logger.info(
             `[codex-cli] Stream completed - Session: ${this.sessionId ?? "N/A"}, Duration: ${duration}ms, Tokens: ${totalTokens}`
@@ -1290,7 +1316,7 @@ var CodexCliLanguageModel = class {
           );
           controller.enqueue({
             type: "finish",
-            finishReason: "stop",
+            finishReason: mapCodexCliFinishReason(void 0),
             usage: usageSummary
           });
           controller.close();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ai-sdk-provider-codex-cli",
-  "version": "1.0.0-beta.1",
-  "description": "AI SDK v6 provider for OpenAI Codex CLI with native JSON Schema support",
+  "version": "1.0.1",
+  "description": "AI SDK v6 provider for OpenAI Codex CLI (use ChatGPT Plus/Pro subscription)",
   "keywords": [
     "ai-sdk",
     "codex",
@@ -59,18 +59,18 @@
     "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
-    "@ai-sdk/provider": "3.0.0-beta.26",
-    "@ai-sdk/provider-utils": "4.0.0-beta.51",
+    "@ai-sdk/provider": "^3.0.0",
+    "@ai-sdk/provider-utils": "^4.0.1",
     "jsonc-parser": "^3.3.1"
   },
   "optionalDependencies": {
-    "@openai/codex": "^0.60.1"
+    "@openai/codex": "^0.77.0"
   },
   "devDependencies": {
     "@eslint/js": "^9.14.0",
     "@types/node": "20.19.6",
     "@vitest/coverage-v8": "^3.2.4",
-    "ai": "6.0.0-beta.156",
+    "ai": "^6.0.3",
     "eslint": "^9.14.0",
     "prettier": "^3.3.3",
     "tsup": "8.5.0",