ai-sdk-provider-codex-cli 2.0.0 → 2.1.1

package/README.md

@@ -64,7 +64,7 @@ npm i ai@^6 ai-sdk-provider-codex-cli@ai-sdk-v6
 npm i ai@^5.0.0 ai-sdk-provider-codex-cli@ai-sdk-v5
 ```
 
-> **⚠️ Codex CLI Version**: Requires the current stable Codex CLI **0.142.x** for full support of both provider modes (`codexExec` and `codexAppServer`). This package pins its optional `@openai/codex` dependency to `^0.142.5`, the latest non-alpha release validated for this release line. If you supply your own Codex CLI (global install or custom `codexPath`), check it with `codex --version` and upgrade if needed.
+> **⚠️ Codex CLI Version**: Requires the current stable Codex CLI **0.144.x** for full support of both provider modes (`codexExec` and `codexAppServer`). This package pins its optional `@openai/codex` dependency to `^0.144.0`, the latest non-alpha release line validated for this release line. If you supply your own Codex CLI (global install or custom `codexPath`), check it with `codex --version` and upgrade if needed.
 >
 > ```bash
 > npm i -g @openai/codex@latest
@@ -100,7 +100,7 @@ import { createCodexAppServer } from 'ai-sdk-provider-codex-cli';
 
 const provider = createCodexAppServer({
   defaultSettings: {
-    minCodexVersion: '0.142.5',
+    minCodexVersion: '0.144.0',
     autoApprove: false,
     personality: 'pragmatic',
   },

package/dist/index.d.ts

@@ -854,7 +854,7 @@ interface CodexAppServerProvider extends ProviderV4 {
  * @example
  * ```ts
  * const provider = createCodexAppServer({
- *   defaultSettings: { minCodexVersion: '0.142.5' },
+ *   defaultSettings: { minCodexVersion: '0.144.0' },
  * });
  *
  * try {

package/dist/index.js

@@ -4827,6 +4827,7 @@ var AppServerRpcClient = class extends EventEmitter {
   activeRequestContextsByTurn = /* @__PURE__ */ new Map();
   completedTurnIds = /* @__PURE__ */ new Set();
   lastStderr = "";
+  lastCrashHadStderr = false;
   idleTimer;
   serverCapabilities;
   expectedExitSignal;
@@ -4921,7 +4922,7 @@ var AppServerRpcClient = class extends EventEmitter {
     if (this.serverCapabilities?.modelList === false) {
       throw new UnsupportedFeatureError({
         feature: "model/list",
-        minCodexVersion: this.settings.minCodexVersion ?? "0.142.5",
+        minCodexVersion: this.settings.minCodexVersion ?? "0.144.0",
         serverVersion: this.serverVersion
       });
     }
@@ -4934,7 +4935,7 @@ var AppServerRpcClient = class extends EventEmitter {
       if (error instanceof JsonRpcRequestError && error.code === -32601) {
         throw new UnsupportedFeatureError({
           feature: "model/list",
-          minCodexVersion: this.settings.minCodexVersion ?? "0.142.5",
+          minCodexVersion: this.settings.minCodexVersion ?? "0.144.0",
           serverVersion: this.serverVersion
         });
       }
@@ -5033,6 +5034,7 @@ var AppServerRpcClient = class extends EventEmitter {
     const base = resolveCodexPath2(this.settings.codexPath);
     const args = [...base.args, "app-server", "--listen", "stdio://"];
     this.lastStderr = "";
+    this.lastCrashHadStderr = false;
     this.expectedExitSignal = void 0;
     this.child = spawn(base.cmd, args, {
       stdio: ["pipe", "pipe", "pipe"],
@@ -5043,18 +5045,23 @@ var AppServerRpcClient = class extends EventEmitter {
       },
       cwd: this.settings.cwd
     });
-    this.child.stderr.setEncoding("utf8");
-    this.child.stderr.on("data", (chunk) => {
-      this.lastStderr += String(chunk);
-      if (this.lastStderr.length > 4e3) {
-        this.lastStderr = this.lastStderr.slice(-4e3);
+    const child = this.child;
+    let stderrBuf = "";
+    child.stderr.setEncoding("utf8");
+    child.stderr.on("data", (chunk) => {
+      stderrBuf = (stderrBuf + String(chunk)).slice(-4e3);
+      if (this.child === child) {
+        this.lastStderr = stderrBuf;
       }
     });
-    this.child.on("error", (error) => {
+    child.on("error", (error) => {
       this.logger.error(`[codex-app-server] process error: ${String(error)}`);
-      this.handleCrash(error);
+      const base2 = String(error);
+      const message = this.withStderrTail(base2, stderrBuf);
+      this.lastCrashHadStderr = message !== base2;
+      this.handleCrash(new Error(message));
     });
-    this.child.on("exit", (code, signal) => {
+    child.on("exit", (code, signal) => {
       const message = `codex app-server exited (code=${String(code)}, signal=${String(signal)})`;
       const expected = this.state === "closed" || signal !== null && signal === this.expectedExitSignal;
       this.expectedExitSignal = void 0;
@@ -5062,11 +5069,29 @@ var AppServerRpcClient = class extends EventEmitter {
         this.logger.info(`[codex-app-server] ${message}`);
         return;
       }
-      this.logger.warn(`[codex-app-server] ${message}`);
-      this.handleCrash(new Error(message));
+      const crashedPending = this.markCrashed();
+      if (!crashedPending) return;
+      let settled = false;
+      const finish = () => {
+        if (settled) return;
+        settled = true;
+        child.off("close", finish);
+        clearTimeout(timer);
+        const base2 = `codex app-server exited (code=${String(code)}, signal=${String(signal)})`;
+        const crashMessage = this.withStderrTail(base2, stderrBuf);
+        if (this.child === void 0) {
+          this.lastStderr = stderrBuf;
+          this.lastCrashHadStderr = crashMessage !== base2;
+        }
+        this.logger.warn(`[codex-app-server] ${crashMessage}`);
+        this.rejectCrashedPending(crashedPending, new Error(crashMessage));
+      };
+      child.once("close", finish);
+      const timer = setTimeout(finish, 120);
+      timer.unref?.();
     });
     this.stdoutReader = readline.createInterface({
-      input: this.child.stdout,
+      input: child.stdout,
       crlfDelay: Infinity
     });
     this.stdoutReader.on("line", (line) => this.handleLine(line));
@@ -5088,12 +5113,22 @@ var AppServerRpcClient = class extends EventEmitter {
         this.settings.connectionTimeoutMs ?? this.requestTimeoutMs
       );
     } catch (error) {
-      const message = String(error?.message ?? error);
-      if (message.includes("ENOENT") || message.includes("unknown subcommand")) {
+      const raw = String(error?.message ?? error);
+      if (raw.includes("unknown subcommand") || this.lastStderr.includes("unknown subcommand")) {
+        throw new Error(
+          this.withStderrTail(
+            "codex app-server requires codex CLI >= 0.144.0. Run 'codex --version' to check."
+          )
+        );
+      }
+      if (raw.includes("ENOENT") || this.lastStderr.includes("ENOENT")) {
         throw new Error(
-          "codex app-server requires codex CLI >= 0.142.5. Run 'codex --version' to check."
+          this.withStderrTail(
+            "codex app-server failed to start: codex executable not found (ENOENT). Check that the codex CLI is installed and its native binary is intact \u2014 a corrupted @openai/codex npm install can cause this. Run 'codex --version' to verify."
+          )
         );
       }
+      const message = this.lastCrashHadStderr ? raw : this.withStderrTail(raw);
       throw createAPICallError({
         message: `Failed to initialize codex app-server: ${message}`,
         stderr: this.lastStderr,
@@ -5113,7 +5148,7 @@ var AppServerRpcClient = class extends EventEmitter {
       return;
     }
     this.serverVersion = detected;
-    const minVersion = this.settings.minCodexVersion ?? "0.142.5";
+    const minVersion = this.settings.minCodexVersion ?? "0.144.0";
     const compared = compareSemver(detected, minVersion);
     if (compared === void 0) {
       this.logger.warn(
@@ -5155,8 +5190,8 @@ var AppServerRpcClient = class extends EventEmitter {
     }
     this.writeQueue = Promise.resolve();
   }
-  handleCrash(error) {
-    if (this.state === "closed") return;
+  markCrashed() {
+    if (this.state === "closed" || this.state === "error") return void 0;
     this.state = "error";
     this.clearIdleTimer();
     this.stdoutReader?.close();
@@ -5166,11 +5201,9 @@ var AppServerRpcClient = class extends EventEmitter {
       this.child.kill("SIGTERM");
       this.child = void 0;
     }
-    for (const [id, pending] of this.pending.entries()) {
-      clearTimeout(pending.timer);
-      pending.reject(
-        new Error(`Request ${String(id)} failed after app-server crash: ${String(error)}`)
-      );
+    const pending = new Map(this.pending);
+    for (const [, entry] of pending) {
+      clearTimeout(entry.timer);
     }
     this.pending.clear();
     this.threadLocks.clear();
@@ -5180,6 +5213,41 @@ var AppServerRpcClient = class extends EventEmitter {
     this.completedTurnIds.clear();
     this.serverCapabilities = void 0;
     this.writeQueue = Promise.resolve();
+    return pending;
+  }
+  rejectCrashedPending(pending, error) {
+    for (const [id, entry] of pending) {
+      entry.reject(
+        new Error(`Request ${String(id)} failed after app-server crash: ${String(error)}`)
+      );
+    }
+  }
+  handleCrash(error) {
+    const pending = this.markCrashed();
+    if (!pending) return;
+    this.rejectCrashedPending(pending, error);
+  }
+  stderrExcerpt(raw) {
+    if (!raw) return "";
+    const escape = String.fromCharCode(27);
+    const ansiEscapeSequence = new RegExp(
+      `${escape}(?:\\[[0-?]*[ -/]*[@-~]|\\][^\\u0007]*(?:\\u0007|${escape}\\\\))`,
+      "g"
+    );
+    const withoutAnsi = raw.replace(ansiEscapeSequence, "");
+    const withoutControls = Array.from(withoutAnsi).filter((character) => {
+      const code = character.charCodeAt(0);
+      return character === "\n" || code >= 32 && (code < 127 || code > 159);
+    }).join("");
+    const excerpt = withoutControls.split(/\r?\n/).map((line) => line.trim()).filter(Boolean).slice(-5).join("; ");
+    if (excerpt.length > 600) {
+      return `\u2026${excerpt.slice(-600)}`;
+    }
+    return excerpt;
+  }
+  withStderrTail(message, raw = this.lastStderr) {
+    const excerpt = this.stderrExcerpt(raw);
+    return excerpt ? `${message} | stderr (tail): ${excerpt}` : message;
   }
   handleLine(line) {
     const trimmed = line.trim();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-sdk-provider-codex-cli",
-  "version": "2.0.0",
+  "version": "2.1.1",
   "description": "AI SDK v7 provider for OpenAI Codex CLI (use ChatGPT Plus/Pro subscription)",
   "keywords": [
     "ai-sdk",
@@ -61,7 +61,7 @@
     "jsonc-parser": "^3.3.1"
   },
   "optionalDependencies": {
-    "@openai/codex": "^0.142.5"
+    "@openai/codex": "^0.144.0"
   },
   "devDependencies": {
     "@eslint/js": "^9.14.0",