@nyssance/codex-acp-v2 0.7.3 → 0.7.4

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 0.7.4 — 2026-09-30
+
+### Added
+
+- `CODEX_ACP_MODEL_CATALOGS`: extra model catalog files for gateway models. Codex builds its model
+  table once at app-server start and ignores a per-thread `model_catalog_json`, so gateway models ran on
+  fallback metadata and every reply opened with "Model metadata for `…` not found". The adapter now dumps
+  Codex's own catalog (`codex debug models`), adds the extra entries hidden, and starts the app-server
+  with the merged file.
+
+### Changed
+
+- Generated against Codex 0.159.2 (`@openai/codex` ^0.159.2): `tooManyDenials` turn errors are
+  classified `too_many_denials` (not retryable); `thread/items/list` cursors may be item anchors.
+
 ## 0.7.3 — 2026-09-30
 
 ### Changed

package/README.md

@@ -91,6 +91,7 @@ adjust defaults.
 | Variable | Effect |
 | --- | --- |
 | `CODEX_PATH` | Codex executable to spawn (`codex app-server`). Default: bundled `@openai/codex`. |
+| `CODEX_ACP_MODEL_CATALOGS` | Extra Codex model catalog files (`{models: [...]}`, joined with the platform path delimiter) for gateway models. Codex reads model metadata only at app-server start, so these are merged, hidden from the ChatGPT group, into Codex's own catalog there; without them a gateway model runs on fallback metadata and Codex warns on every turn. |
 | `CODEX_CONFIG` | JSON object merged into every thread's Codex config. |
 | `MODEL_PROVIDER` | Codex model provider for new threads. |
 | `INITIAL_AGENT_MODE` | `read-only`, `agent` (default), or `agent-full-access`. |

package/dist/index.js

@@ -21844,7 +21844,7 @@ var package_default = {
   publishConfig: {
     access: "public"
   },
-  version: "0.7.3",
+  version: "0.7.4",
   description: "Native ACP v2 agent for the OpenAI Codex app-server",
   packageManager: "bun@1.4.0",
   engines: {
@@ -21916,7 +21916,7 @@ var package_default = {
     "vscode-jsonrpc": "^9.0.2"
   },
   optionalDependencies: {
-    "@openai/codex": "^0.158.0"
+    "@openai/codex": "^0.159.2"
   }
 };
 
@@ -22076,6 +22076,8 @@ function classifyTurnError(info) {
     case "cyberPolicy":
     case "misalignmentPolicyViolation":
       return failure2("policy", false, "refusal");
+    case "tooManyDenials":
+      return failure2("too_many_denials");
     case "sessionBudgetExceeded":
       return failure2("budget");
     case "usageLimitExceeded":
@@ -28604,7 +28606,8 @@ function threadIdOf(notification) {
 }
 
 // src/codex/process.ts
-import { existsSync } from "fs";
+import { existsSync, mkdtempSync, readFileSync as readFileSync2, writeFileSync } from "fs";
+import os3 from "os";
 import path8 from "path";
 import { spawn, spawnSync } from "child_process";
 import { createRequire } from "module";
@@ -28916,7 +28919,9 @@ function startCodexProcess(codexPath, env = process.env) {
   if (probe.error !== undefined)
     throw new Error(`Could not run Codex (${launcher.command}): ${probe.error.message}`);
   assertCodexVersion(probe.stdout.length > 0 ? probe.stdout : probe.stderr);
-  const child = launcher.shell ? spawn(`${launcher.command} app-server`, { shell: true, env }) : spawn(launcher.command, [...launcher.prefixArgs, "app-server"], { env });
+  const catalog = mergedModelCatalog(launcher, env);
+  const catalogOverride = catalog === null ? null : `model_catalog_json='${catalog}'`;
+  const child = launcher.shell ? spawn(`${launcher.command}${catalogOverride === null ? "" : ` -c "${catalogOverride}"`} app-server`, { shell: true, env }) : spawn(launcher.command, [...launcher.prefixArgs, ...catalogOverride === null ? [] : ["-c", catalogOverride], "app-server"], { env });
   let stderr = "";
   child.stderr.on("data", (data) => {
     stderr = (stderr + data.toString()).slice(-STDERR_RETAIN_BYTES);
@@ -28941,6 +28946,44 @@ function startCodexProcess(codexPath, env = process.env) {
     exitCode: () => child.exitCode
   };
 }
+var EXTRA_MODEL_CATALOGS_ENV = "CODEX_ACP_MODEL_CATALOGS";
+function mergedModelCatalog(launcher, env) {
+  const raw = env[EXTRA_MODEL_CATALOGS_ENV];
+  if (raw === undefined || raw.trim() === "")
+    return null;
+  const files = raw.split(path8.delimiter).filter((file2) => file2.length > 0);
+  const dump = spawnSync(launcher.command, [...launcher.prefixArgs, "debug", "models"], {
+    shell: launcher.shell,
+    env,
+    encoding: "utf8",
+    maxBuffer: 64 * 1024 * 1024
+  });
+  if (dump.error !== undefined || dump.status !== 0) {
+    throw new Error(`codex debug models failed: ${dump.error?.message ?? dump.stderr.trim()}`);
+  }
+  const base = JSON.parse(dump.stdout);
+  if (!Array.isArray(base.models))
+    throw new Error("codex debug models did not return {models: [...]}");
+  const models = base.models;
+  const slugs = new Set(models.map((model) => model["slug"]));
+  for (const file2 of files) {
+    const extra = JSON.parse(readFileSync2(file2, "utf8"));
+    if (!Array.isArray(extra.models))
+      throw new Error(`${EXTRA_MODEL_CATALOGS_ENV}: ${file2} is not {models: [...]}`);
+    for (const entry of extra.models) {
+      if (typeof entry["slug"] !== "string")
+        throw new Error(`${EXTRA_MODEL_CATALOGS_ENV}: ${file2} has an entry without a slug`);
+      if (slugs.has(entry["slug"]))
+        continue;
+      slugs.add(entry["slug"]);
+      models.push({ ...entry, visibility: "hide" });
+    }
+  }
+  const directory = mkdtempSync(path8.join(os3.tmpdir(), "codex-acp-v2-catalog-"));
+  const target = path8.join(directory, "models.json");
+  writeFileSync(target, JSON.stringify({ ...base, models }));
+  return target;
+}
 
 // src/index.ts
 var CODEX_EXIT_GRACE_MS = 2000;

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.7.3",
+  "version": "0.7.4",
   "description": "Native ACP v2 agent for the OpenAI Codex app-server",
   "packageManager": "bun@1.4.0",
   "engines": {
@@ -75,6 +75,6 @@
     "vscode-jsonrpc": "^9.0.2"
   },
   "optionalDependencies": {
-    "@openai/codex": "^0.158.0"
+    "@openai/codex": "^0.159.2"
   }
 }