@codexapi/codexclaude 2.0.15 → 2.0.16

package/CUSTOMIZATIONS.md

@@ -5,7 +5,8 @@
 ## Runtime
 
 - Customer-facing app name: `Magnetapi.org Coding Agent`
-- Local launcher version: `2.0.15`
+- Local launcher version: `2.0.16`
+- Bundled official Codex dependency: `@openai/codex@0.143.0`
 - Bundled coding runtime is managed internally and must not be advertised in customer-facing startup text.
 
 ## Launcher Behavior
@@ -15,9 +16,9 @@
 - Rewrites `~/.codex/config.toml` before every launch.
 - Starts official Codex with `--search` by default.
 - Passes all unknown commands directly to the bundled coding runtime.
-- Provides `codexclaude changelog` so users can see forced-update changes from the terminal.
+- Provides `codexclaude changelog` so users can see recommended or required update changes from the terminal.
 - Does not expose separate `codexclaude status` or `codexclaude usage` commands; wallet information remains a compact pre-launch line.
-- Checks npm latest at startup and blocks coding with an Update Now command when a newer launcher is available.
+- Shows a non-blocking update notice at startup when a newer recommended launcher is available. Only versions below the backend minimum may be blocked.
 
 ## Provider Config
 
@@ -42,7 +43,7 @@ The launcher writes a Codex model provider named `codexapi`:
 - Claude-family Responses traffic uses the Claude-compatible CodexAPI.pro endpoint for CodexAPI.pro and ChatPlus accounts, while MyAPI.world accounts keep the MyAPI endpoint.
 - Fable 5 stays visible to the user while the backend applies the custom routed premium path and 2x billing multiplier.
 
-Current backend state verified on 2026-06-25: Admin Manage Models controls runtime routing server-side. This operational routing must not change the launcher-visible model ids, model catalog, or customer-facing labels.
+Current backend state verified on 2026-07-08: Admin Manage Models controls runtime routing server-side. This operational routing must not change the launcher-visible model ids, model catalog, or customer-facing labels.
 
 ## Wallet Display
 

package/README.md

@@ -2,7 +2,7 @@
 
 `codexclaude` installs the Magnetapi.org Coding Agent for customers who want one coding CLI that can use ChatGPT-5.5, Opus 4.8, Sonnet 5, or Fable 5 against the same Token Wallet.
 
-Version `2.0.15` applies account, wallet, model, and Full Access defaults before the coding session starts.
+Version `2.0.16` applies account, wallet, model, and Full Access defaults before the coding session starts. It bundles official Codex `0.143.0`.
 
 ## Install
 
@@ -12,12 +12,12 @@ npm install -g @codexapi/codexclaude@latest
 
 This installs the current `codexclaude` launcher from npm.
 
-## Required updates
+## Update Notices
 
-CodexAPI.pro checks the CodexAPI.pro API and npm at startup. If a newer required launcher is available, the app stops before coding starts and shows the exact **Update Now** command:
+CodexAPI.pro checks the CodexAPI.pro API and npm at startup. If a newer recommended launcher is available, the app shows a clear update notice and the exact command, then lets you keep coding. Only versions below the backend minimum are blocked.
 
 ```bash
-npm install -g @codexapi/codexclaude@latest
+npm install -g @codexapi/codexclaude@2.0.16
 ```
 
 This does not delete your local Codex session history. The update only replaces the `codexclaude` launcher and refreshes the CodexAPI.pro provider config.
@@ -73,8 +73,8 @@ gpt-5.5 xhigh · ~/codexapi · Wallet $20.00
 - xhigh visible reasoning in the local Codex UI while CodexAPI.pro keeps upstream runtime effort server-managed.
 - A local `~/.codexclaude/model_catalog.json` file so native Codex `/model` lists only ChatGPT-5.5, Opus 4.8, Sonnet 5, and Fable 5.
 - No default fast service tier. Fast mode is billed only when the user enables it inside Codex.
-- Magnetapi.org Coding Agent `2.0.15` with the current profile-compatible config enabled.
+- Magnetapi.org Coding Agent `2.0.16` with the current profile-compatible config enabled.
 - Token Wallet balance lookup before launch without exposing separate `status` or `usage` launcher commands.
 - Opus 4.8 tool-call compatibility through the Chicago CodexAPI.pro Responses gateway.
 - Backend-identifying request headers so CodexAPI.pro can enforce subscription plan rules server-side.
-- npm latest-version checks before coding starts, with an explicit update command when a newer required launcher exists.
+- Non-blocking update notices before coding starts, with an explicit update command when a newer recommended launcher exists.

package/bin/codexclaude.js

@@ -10,8 +10,8 @@ import { stdin as input, stdout as output } from "node:process";
 
 const require = createRequire(import.meta.url);
 
-const APP_VERSION = "2.0.15";
-const CODEX_VERSION = "0.142.5";
+const APP_VERSION = "2.0.16";
+const CODEX_VERSION = "0.143.0";
 const APP_DISPLAY_NAME = "Magnetapi.org Coding Agent";
 const DISPLAY_REASONING_EFFORT = "xhigh";
 const SERVER_REASONING_EFFORT = "high";
@@ -273,19 +273,9 @@ async function enforceLauncherVersion() {
   if (metadata?.updateRequired || isOlderVersion(APP_VERSION, metadata?.minimumVersion)) {
     throw new Error(updateRequiredMessage(metadata));
   }
-  const npmMetadata = await npmLatestMetadata();
-  if (npmMetadata?.version && isOlderVersion(APP_VERSION, npmMetadata.version)) {
-    throw new Error(
-      updateRequiredMessage({
-        latestVersion: npmMetadata.version,
-        minimumVersion: npmMetadata.version,
-        installCommand: UPDATE_COMMAND,
-        registryInstallCommand: UPDATE_COMMAND,
-        changes: [
-          `npm latest is ${npmMetadata.version}; update codexclaude before starting a coding session.`,
-        ],
-      }),
-    );
+  const updateMetadata = optionalUpdateMetadata(metadata, await npmLatestMetadata());
+  if (updateMetadata) {
+    printOptionalUpdateNotice(updateMetadata);
   }
 }
 
@@ -384,13 +374,49 @@ function updateRequiredMessage(metadata) {
   const latest = metadata?.latestVersion || "latest";
   const minimum = metadata?.minimumVersion || latest;
   return [
-    `Update Now: CodexAPI.pro has updated to codexclaude ${latest}. Update your agent now to continue.`,
+    `Update required: CodexAPI.pro has updated to codexclaude ${latest}. Update your agent now to continue.`,
     `Installed codexclaude: ${APP_VERSION}. Required: ${minimum}. Latest: ${latest}.`,
     `Run: ${installCommand}`,
     "Your Codex session history will not be deleted. The update only replaces the codexclaude launcher and rewrites provider config backups.",
   ].join("\n");
 }
 
+function optionalUpdateMetadata(serviceMetadata, npmMetadata) {
+  const candidates = [serviceMetadata, npmMetadata].filter(Boolean);
+  let selected = null;
+  for (const candidate of candidates) {
+    const candidateVersion = candidate.latestVersion || candidate.version;
+    if (!candidateVersion || !isOlderVersion(APP_VERSION, candidateVersion)) {
+      continue;
+    }
+    if (!selected || isOlderVersion(selected.latestVersion || selected.version, candidateVersion)) {
+      selected = {
+        ...candidate,
+        latestVersion: candidateVersion,
+      };
+    }
+  }
+  return selected;
+}
+
+function printOptionalUpdateNotice(metadata) {
+  const installCommand =
+    metadata?.installCommand ||
+    metadata?.registryInstallCommand ||
+    UPDATE_COMMAND;
+  const latest = metadata?.latestVersion || metadata?.version || "latest";
+  const changes = Array.isArray(metadata?.changes) ? metadata.changes.slice(0, 4) : [];
+  const border = "─".repeat(64);
+  const line = (text) => `│ ${String(text)}`.slice(0, 65).padEnd(65) + "│";
+  console.error(`\n┌${border}┐`);
+  console.error(line(`codexclaude ${latest} is available. You can keep coding on ${APP_VERSION}.`));
+  console.error(line(`Update when ready: ${installCommand}`));
+  for (const change of changes) {
+    console.error(line(`• ${change}`));
+  }
+  console.error(`└${border}┘\n`);
+}
+
 function isOlderVersion(current, required) {
   if (!required) {
     return false;

package/codexclaude.md

@@ -9,10 +9,10 @@ there is no supported configuration or API boundary that can solve the issue.
 ## Current Release
 
 - Launcher package: `@codexapi/codexclaude`
-- Launcher version: `2.0.15`
+- Launcher version: `2.0.16`
 - Customer-facing app name: `Magnetapi.org Coding Agent`
-- Bundled runtime dependency: managed internally; do not print the upstream runtime version in customer-facing startup text.
-- Public install command: `npm install -g @codexapi/codexclaude@latest`
+- Bundled runtime dependency: official `@openai/codex@0.143.0`; do not print the upstream runtime version in customer-facing startup text.
+- Public update command for this optional release: `npm install -g @codexapi/codexclaude@2.0.16`
 - Default API origin: `https://codexapi.pro`
 - Normal Responses base URL: `https://codexapi.pro/v1`
 - Opus 4.8 Responses base URL: `https://api-chicago.codexapi.pro/v1`
@@ -20,7 +20,7 @@ there is no supported configuration or API boundary that can solve the issue.
 - Generated Codex config: `~/.codex/config.toml`
 - Generated Codex model catalog: `~/.codexclaude/model_catalog.json`
 
-State verified on 2026-07-06: the launcher presents itself as Magnetapi.org Coding Agent `2.0.15`. Backend routing is server-controlled by Admin Manage Models and must not collapse the launcher model list or rename customer-selected model ids.
+State verified on 2026-07-08: the launcher presents itself as Magnetapi.org Coding Agent `2.0.16`. Backend routing is server-controlled by Admin Manage Models and must not collapse the launcher model list or rename customer-selected model ids.
 
 ## Required User-Facing Model Behavior
 
@@ -57,7 +57,7 @@ because the request body model is how CodexAPI.pro snapshots routing and
 billing before generation starts. The correct fix is to provide valid metadata
 for `claude-opus-4-8`.
 
-`bin/codexclaude.js` writes a local catalog with full metadata for all six
+`bin/codexclaude.js` writes a local catalog with full metadata for all four
 supported slugs. Each entry must include, at minimum:
 
 - `slug`
@@ -211,7 +211,7 @@ When upgrading official `@openai/codex`:
 9. Preserve bearer username auth with the CodexAPI.pro API username.
 10. Preserve the `X-CodexAPI-*` headers.
 11. Preserve Claude-family endpoint routing unless operations changes it.
-12. Preserve update enforcement through `/api/v1/codexclaude/version` and npm latest metadata.
+12. Preserve update checks through `/api/v1/codexclaude/version` and npm metadata. Recommended releases must be non-blocking; only versions below the backend `minimumVersion` may be forced.
 13. Update this file with a new release section explaining what changed.
 14. Run the validation commands below before publishing.
 
@@ -261,6 +261,14 @@ python3 -m py_compile app/main.py app/openai_compat.py app/config.py app/postgre
 /root/codexapi/.venv/bin/pytest -q tests/test_openai_compat.py tests/test_main_helpers.py
 ```
 
+## Version 2.0.16 Changes
+
+- Updated the bundled official Codex dependency to `@openai/codex@0.143.0`.
+- Kept the launcher model picker and native Codex `/model` catalog limited to ChatGPT-5.5, Opus 4.8, Sonnet 5, and Fable 5.
+- Kept the customer-facing startup identity as Magnetapi.org Coding Agent and continued hiding the upstream Codex runtime version in normal startup text.
+- Changed the update surface for this release to a recommended, non-blocking notice. Users should be shown the exact update command, but they must not be forced off `2.0.15` for this release.
+- Preserved Full Access defaults, xhigh visible reasoning, bearer username auth, Responses wire API, and the CodexAPI.pro identification headers.
+
 ## Version 2.0.15 Changes
 
 - Renamed the launcher-controlled startup/status surface to Magnetapi.org Coding Agent and now prints the app version instead of the upstream runtime version.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codexapi/codexclaude",
-  "version": "2.0.15",
+  "version": "2.0.16",
   "description": "Magnetapi.org Coding Agent launcher for ChatGPT-5.5, Opus 4.8, Sonnet 5, and Fable 5.",
   "license": "Apache-2.0",
   "type": "module",
@@ -17,7 +17,7 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@openai/codex": "^0.142.5"
+    "@openai/codex": "0.143.0"
   },
   "publishConfig": {
     "access": "public"