ai-sdk-provider-codex-cli 1.2.2 → 1.3.1

package/README.md

@@ -54,7 +54,7 @@ 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 the current stable Codex CLI **0.130.x** for full support of both provider modes (`codexExec` and `codexAppServer`). This package pins its optional `@openai/codex` dependency to `^0.130.0`, the latest non-alpha release validated for this maintenance update. 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 maintenance update. 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
@@ -90,7 +90,7 @@ import { createCodexAppServer } from 'ai-sdk-provider-codex-cli';
 
 const provider = createCodexAppServer({
   defaultSettings: {
-    minCodexVersion: '0.130.0',
+    minCodexVersion: '0.144.0',
     autoApprove: false,
     personality: 'pragmatic',
   },

package/dist/index.cjs

@@ -4573,6 +4573,7 @@ var AppServerRpcClient = class extends events.EventEmitter {
   activeRequestContextsByTurn = /* @__PURE__ */ new Map();
   completedTurnIds = /* @__PURE__ */ new Set();
   lastStderr = "";
+  lastCrashHadStderr = false;
   idleTimer;
   serverCapabilities;
   expectedExitSignal;
@@ -4667,7 +4668,7 @@ var AppServerRpcClient = class extends events.EventEmitter {
     if (this.serverCapabilities?.modelList === false) {
       throw new UnsupportedFeatureError({
         feature: "model/list",
-        minCodexVersion: this.settings.minCodexVersion ?? "0.130.0",
+        minCodexVersion: this.settings.minCodexVersion ?? "0.144.0",
         serverVersion: this.serverVersion
       });
     }
@@ -4680,7 +4681,7 @@ var AppServerRpcClient = class extends events.EventEmitter {
       if (error instanceof JsonRpcRequestError && error.code === -32601) {
         throw new UnsupportedFeatureError({
           feature: "model/list",
-          minCodexVersion: this.settings.minCodexVersion ?? "0.130.0",
+          minCodexVersion: this.settings.minCodexVersion ?? "0.144.0",
           serverVersion: this.serverVersion
         });
       }
@@ -4779,6 +4780,7 @@ var AppServerRpcClient = class extends events.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 = child_process.spawn(base.cmd, args, {
       stdio: ["pipe", "pipe", "pipe"],
@@ -4789,18 +4791,23 @@ var AppServerRpcClient = class extends events.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;
@@ -4808,11 +4815,29 @@ var AppServerRpcClient = class extends events.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__default.default.createInterface({
-      input: this.child.stdout,
+      input: child.stdout,
       crlfDelay: Infinity
     });
     this.stdoutReader.on("line", (line) => this.handleLine(line));
@@ -4834,12 +4859,22 @@ var AppServerRpcClient = class extends events.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.130.0. 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,
@@ -4859,7 +4894,7 @@ var AppServerRpcClient = class extends events.EventEmitter {
       return;
     }
     this.serverVersion = detected;
-    const minVersion = this.settings.minCodexVersion ?? "0.130.0";
+    const minVersion = this.settings.minCodexVersion ?? "0.144.0";
     const compared = compareSemver(detected, minVersion);
     if (compared === void 0) {
       this.logger.warn(
@@ -4901,8 +4936,8 @@ var AppServerRpcClient = class extends events.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();
@@ -4912,11 +4947,9 @@ var AppServerRpcClient = class extends events.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();
@@ -4926,6 +4959,41 @@ var AppServerRpcClient = class extends events.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/dist/index.d.cts

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

package/dist/index.d.ts

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

package/dist/index.js

@@ -4565,6 +4565,7 @@ var AppServerRpcClient = class extends EventEmitter {
   activeRequestContextsByTurn = /* @__PURE__ */ new Map();
   completedTurnIds = /* @__PURE__ */ new Set();
   lastStderr = "";
+  lastCrashHadStderr = false;
   idleTimer;
   serverCapabilities;
   expectedExitSignal;
@@ -4659,7 +4660,7 @@ var AppServerRpcClient = class extends EventEmitter {
     if (this.serverCapabilities?.modelList === false) {
       throw new UnsupportedFeatureError({
         feature: "model/list",
-        minCodexVersion: this.settings.minCodexVersion ?? "0.130.0",
+        minCodexVersion: this.settings.minCodexVersion ?? "0.144.0",
         serverVersion: this.serverVersion
       });
     }
@@ -4672,7 +4673,7 @@ var AppServerRpcClient = class extends EventEmitter {
       if (error instanceof JsonRpcRequestError && error.code === -32601) {
         throw new UnsupportedFeatureError({
           feature: "model/list",
-          minCodexVersion: this.settings.minCodexVersion ?? "0.130.0",
+          minCodexVersion: this.settings.minCodexVersion ?? "0.144.0",
           serverVersion: this.serverVersion
         });
       }
@@ -4771,6 +4772,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"],
@@ -4781,18 +4783,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;
@@ -4800,11 +4807,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));
@@ -4826,12 +4851,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.130.0. 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,
@@ -4851,7 +4886,7 @@ var AppServerRpcClient = class extends EventEmitter {
       return;
     }
     this.serverVersion = detected;
-    const minVersion = this.settings.minCodexVersion ?? "0.130.0";
+    const minVersion = this.settings.minCodexVersion ?? "0.144.0";
     const compared = compareSemver(detected, minVersion);
     if (compared === void 0) {
       this.logger.warn(
@@ -4893,8 +4928,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();
@@ -4904,11 +4939,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();
@@ -4918,6 +4951,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": "1.2.2",
+  "version": "1.3.1",
   "description": "AI SDK v6 provider for OpenAI Codex CLI (use ChatGPT Plus/Pro subscription)",
   "keywords": [
     "ai-sdk",
@@ -67,7 +67,7 @@
     "jsonc-parser": "^3.3.1"
   },
   "optionalDependencies": {
-    "@openai/codex": "^0.130.0"
+    "@openai/codex": "^0.144.0"
   },
   "devDependencies": {
     "@eslint/js": "^9.14.0",