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

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;
@@ -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.144.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,
@@ -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.js

@@ -4565,6 +4565,7 @@ var AppServerRpcClient = class extends EventEmitter {
   activeRequestContextsByTurn = /* @__PURE__ */ new Map();
   completedTurnIds = /* @__PURE__ */ new Set();
   lastStderr = "";
+  lastCrashHadStderr = false;
   idleTimer;
   serverCapabilities;
   expectedExitSignal;
@@ -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.144.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,
@@ -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.3.0",
+  "version": "1.3.1",
   "description": "AI SDK v6 provider for OpenAI Codex CLI (use ChatGPT Plus/Pro subscription)",
   "keywords": [
     "ai-sdk",