@bitkyc08/opencodex 2.30.0-preview.20260821 → 2.31.0

package/src/codex/inject-coordination.ts

@@ -5,10 +5,11 @@
  * sequence it is, rather than doubling in length around the lock.
  */
 import { createHash } from "node:crypto";
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync, lstatSync, readFileSync } from "node:fs";
 
 import { atomicWriteFile } from "../config";
 import type { CodexWriteLockResult } from "./codex-write-lock";
+import { inspectCodexCoordinatorPath } from "./coordinator-doctor";
 import { JOURNAL_PATH } from "./journal";
 import { CODEX_CONFIG_PATH, CODEX_PROFILE_PATH } from "./paths";
 import {
@@ -43,21 +44,51 @@ export type CodexWriteCoordinationEligibility =
   | { kind: "legacy-uncoordinated"; reason: string }
   | { kind: "refused"; reason: string };
 
+/**
+ * A live SQLite creator exposes a zero-byte pathname before BEGIN IMMEDIATE.
+ * Requiring a settled filesystem age makes that scheduling window remain on
+ * the coordinated path while old crash remnants can use the legacy boundary.
+ */
+export const STABLE_ZERO_BYTE_COORDINATOR_AGE_MS = 1_000;
+
 export function codexWriteCoordinationEligibility(deps: {
   coordinatorPath: () => string;
   residue: () => { kind: string };
   integrationRecord: () => { kind: string };
+  nowMs?: () => number;
 }): CodexWriteCoordinationEligibility {
   let coordinatorExists: boolean;
+  let coordinatorIsStableZeroByte = false;
   try {
-    coordinatorExists = existsSync(deps.coordinatorPath());
+    const path = deps.coordinatorPath();
+    coordinatorExists = existsSync(path);
+    if (coordinatorExists) {
+      const entry = lstatSync(path);
+      if (entry.isFile() && !entry.isSymbolicLink() && entry.size === 0) {
+        const diagnostic = inspectCodexCoordinatorPath(path);
+        if (diagnostic.kind === "zero-byte") {
+          const lastIdentityChange = Math.max(diagnostic.identity.mtimeMs, diagnostic.identity.ctimeMs);
+          coordinatorIsStableZeroByte = (deps.nowMs?.() ?? Date.now()) - lastIdentityChange
+            >= STABLE_ZERO_BYTE_COORDINATOR_AGE_MS;
+        }
+      }
+    }
   } catch (error) {
     return { kind: "refused", reason: `the coordinator path could not be resolved: ${String(error)}` };
   }
 
-  // An existing coordinator is authoritative, and the lock owns validating it —
-  // including the unversioned and rowless cases it must refuse rather than adopt.
-  if (coordinatorExists) return { kind: "coordinated" };
+  // Every existing coordinator remains authoritative unless it is proven to be
+  // an old, immutable SQLite-empty remnant. The age gate is part of that proof:
+  // a live creator exposes the same zero-byte pathname briefly before taking N,
+  // and sending that fresh file down the legacy path would bypass its lock.
+  // Non-empty, fresh, unsafe, changed, unversioned, and rowless files therefore
+  // stay coordinated and are validated/refused by the transaction owner.
+  //
+  // We do NOT initialize or adopt it here. Clean homes still enter the
+  // coordinated path, whose SQLite transaction safely initializes it. Routed
+  // or indeterminate legacy homes keep the same uncoordinated compatibility
+  // boundary they would have had if the remnant pathname were absent.
+  if (coordinatorExists && !coordinatorIsStableZeroByte) return { kind: "coordinated" };
 
   const record = deps.integrationRecord();
   if (record.kind === "invalid") {
@@ -83,7 +114,9 @@ export function codexWriteCoordinationEligibility(deps: {
    */
   return {
     kind: "legacy-uncoordinated",
-    reason: residue.kind === "residue"
+    reason: coordinatorIsStableZeroByte
+      ? "the coordinator is a zero-byte non-authoritative remnant and this routed home has not been adopted yet"
+      : residue.kind === "residue"
       ? "this home was routed before write coordination existed and has not been adopted yet"
       : "the existing native Codex state could not be classified, so it cannot seed a coordinator row",
   };

package/src/codex/transition-state.ts

@@ -37,7 +37,7 @@ import {
   samePathIdentity,
 } from "./user-identity";
 
-const COORDINATOR_SCHEMA_VERSION = 1;
+export const CODEX_COORDINATOR_SCHEMA_VERSION = 1;
 const DURABLE_HISTORY_STATUSES = new Set(["converged", "pending", "running", "blocked", "unknown"]);
 const DURABLE_HISTORY_REASONS = new Set([
   "db-busy",
@@ -241,7 +241,7 @@ function rowToState(row: TransitionRow | null): CodexTransitionState {
   };
 }
 
-function readState(database: Database): CodexTransitionState {
+export function readCodexCoordinatorState(database: Database): CodexTransitionState {
   const row = database.query<TransitionRow, []>(SELECT_TRANSITION_ROW).get();
   return rowToState(row);
 }
@@ -282,7 +282,7 @@ function assertInitialStateCanBeCreated(): void {
 
 function initialize(database: Database, databaseWasAbsent: boolean): void {
   const version = database.query<{ user_version: number }, []>("PRAGMA user_version").get()?.user_version;
-  if (version !== 0 && version !== COORDINATOR_SCHEMA_VERSION) {
+  if (version !== 0 && version !== CODEX_COORDINATOR_SCHEMA_VERSION) {
     throw new CodexCoordinatorTransactionError("The coordinator database schema version is unsupported.");
   }
   if (!databaseWasAbsent && version === 0) {
@@ -301,8 +301,8 @@ function initialize(database: Database, databaseWasAbsent: boolean): void {
     assertInitialStateCanBeCreated();
     database.query(INITIALIZE_TRANSITION_ROW).run(new Date().toISOString());
   }
-  if (version === 0) database.exec(`PRAGMA user_version = ${COORDINATOR_SCHEMA_VERSION}`);
-  readState(database);
+  if (version === 0) database.exec(`PRAGMA user_version = ${CODEX_COORDINATOR_SCHEMA_VERSION}`);
+  readCodexCoordinatorState(database);
 }
 
 function createCapability(
@@ -336,7 +336,7 @@ function createCapability(
         expected.nativeGeneration,
         expected.currentTxId,
       );
-      const state = readState(database);
+      const state = readCodexCoordinatorState(database);
       const update: TransitionStateUpdate = result.changes === 1
         ? { kind: "updated", state }
         : { kind: "conflict", current: state };
@@ -451,7 +451,7 @@ export function openCodexCoordinatorTransaction(finalDatabasePath: string): Code
     capability,
     expectation() {
       requireOpen();
-      const state = readState(db);
+      const state = readCodexCoordinatorState(db);
       return {
         nativeBefore: state.nativeGeneration,
         nativeAfter: state.nativeGeneration + 1,
@@ -460,7 +460,7 @@ export function openCodexCoordinatorTransaction(finalDatabasePath: string): Code
     },
     version() {
       requireOpen();
-      const state = readState(db);
+      const state = readCodexCoordinatorState(db);
       return { nativeGeneration: state.nativeGeneration, currentTxId: state.currentTxId };
     },
     assertPublished(expectation) {
@@ -468,7 +468,7 @@ export function openCodexCoordinatorTransaction(finalDatabasePath: string): Code
       if (lastResult?.kind !== "updated") {
         throw new CodexCoordinatorTransactionError("The coordinator transition was not published.");
       }
-      const state = readState(db);
+      const state = readCodexCoordinatorState(db);
       if (state.nativeGeneration !== expectation.nativeAfter || state.currentTxId !== expectation.txId) {
         throw new CodexCoordinatorTransactionError("The coordinator published a different transition.");
       }
@@ -540,7 +540,7 @@ function readCommittedState(): TransitionStateRead {
   try {
     database = new Database(path, { readonly: true });
     database.exec("PRAGMA busy_timeout = 0");
-    return { kind: "ready", state: readState(database) };
+    return { kind: "ready", state: readCodexCoordinatorState(database) };
   } catch (error) {
     return mapUnavailable(error);
   } finally {
@@ -577,7 +577,7 @@ export const updateCodexHistoryTransition: UpdateCodexHistoryTransition = (expec
     database = new Database(currentCoordinatorDatabasePath(), { readwrite: true, create: false });
     database.exec("PRAGMA busy_timeout = 0; BEGIN IMMEDIATE");
     transactionOpen = true;
-    const current = readState(database);
+    const current = readCodexCoordinatorState(database);
     if (current.nativeGeneration > 0 && current.historySchedule === null) {
       throw new CodexCoordinatorTransactionError("A positive transition cannot lose its direction.");
     }
@@ -594,7 +594,7 @@ export const updateCodexHistoryTransition: UpdateCodexHistoryTransition = (expec
       expected.currentTxId,
       expected.currentTxId,
     );
-    const state = readState(database);
+    const state = readCodexCoordinatorState(database);
     database.exec("COMMIT");
     transactionOpen = false;
     return result.changes === 1

package/src/generated/compatibility-version.json

@@ -10,7 +10,7 @@
     },
     {
       "path": "package.json",
-      "sha256": "e93619c60e2ad2e56d45c02fa28e0f3df982f60821532d3211d764c7f4e199b3"
+      "sha256": "3570a5627769ae9dd2796ee178f958ef4e8456479c934274c3b87f6de79f463e"
     },
     {
       "path": "scripts/model-metadata.source.json",
@@ -58,7 +58,7 @@
     },
     {
       "path": "src/adapters/cursor.ts",
-      "sha256": "6042822bf8b0a1210208552584022ce20923153c197d97163ac73b92cb941827"
+      "sha256": "2648737b4e9216f6cf09fc4edf83da4fedaa483220f1716c6f66b6a7c6d15286"
     },
     {
       "path": "src/adapters/cursor/arg-codec.ts",
@@ -74,15 +74,15 @@
     },
     {
       "path": "src/adapters/cursor/cursor-errors.ts",
-      "sha256": "0b84e2a511c90a66d68b6a995cdc8c6a1fdcfe3a0337b06cd14b93d2e18d66c9"
+      "sha256": "b5fb1069d88bf53b4f6de84017646c99452681c22a1bf4abbf6f4b2465a13be4"
     },
     {
       "path": "src/adapters/cursor/discovery.ts",
-      "sha256": "cdebbff19a9d7e3a51ec0444c21a2d09aaf30e49858c4a791b28176096aa2607"
+      "sha256": "8a7275b3280e9629c0b7d0c25ee9d35d723f598bc18dea6bd2633e865ed0c43e"
     },
     {
       "path": "src/adapters/cursor/effort-map.ts",
-      "sha256": "d046b326bea7c6b6deab265ac5b4137f1dd8f3178e7bfe94c9a88c359b6872fc"
+      "sha256": "495b443a1aabdec8358975f76f03b8f40c9981c9ec6120407d8027128e1a027f"
     },
     {
       "path": "src/adapters/cursor/exec-policy.ts",
@@ -96,6 +96,10 @@
       "path": "src/adapters/cursor/gen/agent_pb.ts",
       "sha256": "819da889962a89f5b761cb14e76786f6e455e85bb49f59fdaf6778474b106012"
     },
+    {
+      "path": "src/adapters/cursor/h2-pool.ts",
+      "sha256": "53bab2c504350ce2a985553e6e391a61bba900bb0b58d6c99675eea1e0c1c84e"
+    },
     {
       "path": "src/adapters/cursor/http1-bidi.ts",
       "sha256": "351a05fa5bab54709c5fcb1bbbaaae2974f041ea6033283b854812d97df53c7d"
@@ -110,7 +114,7 @@
     },
     {
       "path": "src/adapters/cursor/live-models.ts",
-      "sha256": "5507dc1b485ff467d1aecdaae9f9fbce5bbdf28693470451001705a6d4e6d901"
+      "sha256": "a66d29f26e225cc49330bcf25aecb5a82b658ef631310843c4221fa2cfb9451f"
     },
     {
       "path": "src/adapters/cursor/live-smoke-gate.ts",
@@ -118,7 +122,7 @@
     },
     {
       "path": "src/adapters/cursor/live-transport.ts",
-      "sha256": "f7ec1630801fb7fd240052807e0cbd1b32207e0b13e4c95874757f0686cf57c8"
+      "sha256": "cc994819e61adca9fdf7ed22a84c726e02b61db93abdd7dd4eb21051f633c08e"
     },
     {
       "path": "src/adapters/cursor/mcp-config.ts",
@@ -134,7 +138,7 @@
     },
     {
       "path": "src/adapters/cursor/native-exec-common.ts",
-      "sha256": "e2329e2d9c55d1eca82486e209338a4eaf0c203491c5e1b26b25c3390357de8a"
+      "sha256": "4682a899e9e626fc7fe7a481bf565468c44641d30414d2e3de560c703ce090b8"
     },
     {
       "path": "src/adapters/cursor/native-exec-desktop.ts",
@@ -162,15 +166,15 @@
     },
     {
       "path": "src/adapters/cursor/native-exec.ts",
-      "sha256": "949136306f67df7e68bf4bac1b63e560f8d48b8e0b246cefa147c98404b54c6f"
+      "sha256": "ac362545a8f421bd650e6ad12c1312172e3b8f27a388223f3578df13a9da438a"
     },
     {
       "path": "src/adapters/cursor/protobuf-events.ts",
-      "sha256": "16faa16a8f5eeb5022a2f7332bd0739189bf3cd5b6dc1267730b14a78786bc08"
+      "sha256": "e6b77507b05bc21880dbb4fb158f53dd8ae81af67d4aa6af15f94f98f5208eac"
     },
     {
       "path": "src/adapters/cursor/protobuf-request.ts",
-      "sha256": "d712426a8ee1b3c4de4d0705b1277e1edd1d5d96ad1c264fb852c2ff426dd50e"
+      "sha256": "56078daf901cd00fc05efd90cbc57e82ff516ee8eb5ebfa64aaf543638e67a59"
     },
     {
       "path": "src/adapters/cursor/request-builder.ts",
@@ -182,7 +186,7 @@
     },
     {
       "path": "src/adapters/cursor/tool-definitions.ts",
-      "sha256": "28759b65e37ba797daa7377a3dd2b62f082a517891f28238bc8ce18ed4b7b3f3"
+      "sha256": "8544f4ce80f5dde32e2d7890542eaeaae966f222cb497e3c0ebf57bdc623c5d6"
     },
     {
       "path": "src/adapters/cursor/tool-result-normalize.ts",
@@ -194,7 +198,7 @@
     },
     {
       "path": "src/adapters/cursor/transport.ts",
-      "sha256": "6359d967e5397cb238b647f89d542005d0ee5f677b8c31770fc29a3244ee9db4"
+      "sha256": "91d5379a51e358becf030d2946cb6ebfb8f3ad775da53ce29986e25f2e11f309"
     },
     {
       "path": "src/adapters/cursor/types.ts",
@@ -230,7 +234,7 @@
     },
     {
       "path": "src/adapters/google.ts",
-      "sha256": "bc8f08993edc83f67ff9fdb4505069a37a69db4d52b9d5f1c30e6b17b246a8d9"
+      "sha256": "e6f8bd41b77ff65b54d7c81bee461ad4f7e12173dda83abc672599277b8df4e4"
     },
     {
       "path": "src/adapters/identity.ts",
@@ -302,7 +306,7 @@
     },
     {
       "path": "src/adapters/openai-responses.ts",
-      "sha256": "4afab7b27fc8aaeb536d9f019af1b3234224f165940c2b2784036866fc972f17"
+      "sha256": "1ed5a3a018aa61b6a52c646aa9ee6985c5543ce5f21b8bac458cf69622a4e6d7"
     },
     {
       "path": "src/adapters/registry.ts",
@@ -328,6 +332,10 @@
       "path": "src/adapters/upstream-http-error.ts",
       "sha256": "4875e77e46d96131e7a3e6c0feb15a54ffcb3901efceac2360abe28b7a0f414b"
     },
+    {
+      "path": "src/adapters/xai-web-search.ts",
+      "sha256": "a9f760d3a1be552ceb74898dc8c00f6e6d3b35a38440030cc95f672e75049e81"
+    },
     {
       "path": "src/bridge.ts",
       "sha256": "8cd99bc0e94a97a54393b693f4d8a5aeb46124591b61f8c8eeedd3e5e05230fa"
@@ -442,7 +450,7 @@
     },
     {
       "path": "src/cli/agent.ts",
-      "sha256": "c2cfc8b6150a34afda9777ba0d9a4945c7365f3577640653476e8c4b3dd76803"
+      "sha256": "c3286d93182fd523bb09337431e2224c96c9c5a345029cc1dff76519842d5f06"
     },
     {
       "path": "src/cli/catalog-prewarm.ts",
@@ -486,11 +494,11 @@
     },
     {
       "path": "src/cli/dispatch.ts",
-      "sha256": "ecc362d37513b79443c714dbf193ea1da7fbb423bc53c308af2e378cf4e6b50c"
+      "sha256": "d98532573083b4df82216bca592818b1946847f9cc472335eaf949ea1bcf1e22"
     },
     {
       "path": "src/cli/doctor.ts",
-      "sha256": "ce42bf3a086291ff48d4456f16b77cfc77100e0996cff32983ef137235a4b7cb"
+      "sha256": "f785624daa2881093a9d696ed92a0e3bc1b97f7d680a75ec52f9d3eaee835e82"
     },
     {
       "path": "src/cli/ensure-desired-integrations.ts",
@@ -502,7 +510,7 @@
     },
     {
       "path": "src/cli/help.ts",
-      "sha256": "61727982fdc69846792c8e1d1d780bc801819bba9dadd589f36901f29685d9a4"
+      "sha256": "20433b67768897debb68132fee8964bfff100f9bd1736e7d71412bf7a1d267fb"
     },
     {
       "path": "src/cli/index.ts",
@@ -562,7 +570,7 @@
     },
     {
       "path": "src/cli/registry.ts",
-      "sha256": "ba6b555b7e93afe0fe41d1ec9caf0f88c8b0783f102639b3a4abdf368a78d263"
+      "sha256": "4160286114b94ce7ada218a9456e30167ac1b6de9781d9c9a04799f8f244ed17"
     },
     {
       "path": "src/cli/root.ts",
@@ -674,7 +682,7 @@
     },
     {
       "path": "src/codex/auth-context.ts",
-      "sha256": "c7bc48d325399fd22a5140d0c9b3a47746bacfff8a3d6d6192f717aa0dfd4535"
+      "sha256": "9703472fb40c9c2fc8876945646aa4d591de96cb3604da7ef8a0c21699a135cf"
     },
     {
       "path": "src/codex/autostart-health.ts",
@@ -710,7 +718,7 @@
     },
     {
       "path": "src/codex/catalog/effort.ts",
-      "sha256": "b938d6f031422c4509c93d221236ce175dc49bd01eec32335e35ac58058e4d9c"
+      "sha256": "e9efbb137522a8952150a75cc04061af43e161203f57b2d02650973119e2316c"
     },
     {
       "path": "src/codex/catalog/filesystem-evidence.ts",
@@ -730,11 +738,11 @@
     },
     {
       "path": "src/codex/catalog/parsing.ts",
-      "sha256": "fcc5e9dd4a6d8bffcc1aa30f5ffb4f1808c6aac986d1a5542305b946e44546e7"
+      "sha256": "a687cae14fdd365ed6eaba53e963022278ac1cbe35ce9ab8b25b7f9e868e6ac7"
     },
     {
       "path": "src/codex/catalog/provider-fetch.ts",
-      "sha256": "2f79fd574e5bbd1da13b42d68013c0137a0718fa2234ad877e3ca3118494cd46"
+      "sha256": "fabaf7f7bc0de27dee84daf05eb5708ffc71d1492ab82c071e6dd83227bd8e2b"
     },
     {
       "path": "src/codex/catalog/sync.ts",
@@ -752,6 +760,10 @@
       "path": "src/codex/convergence.ts",
       "sha256": "4ab2e8828a32a1b6235528d0b9be18b24c7457c485972a00492a4a1675bb9c0a"
     },
+    {
+      "path": "src/codex/coordinator-doctor.ts",
+      "sha256": "8b96fccfcebec924abf6b1c03bb8ef17f6e89469fb6f556c1f0d517654eaf941"
+    },
     {
       "path": "src/codex/custom-model-catalog-migration.ts",
       "sha256": "eb6c1420bc61b27c67772255a20192cb94605c988f6b597608e69b6346464c77"
@@ -806,7 +818,7 @@
     },
     {
       "path": "src/codex/inject-coordination.ts",
-      "sha256": "2b64a277f342eaf806ac4eadabe694bd7e64fe984c514d815bfdd4d2ce4f80f5"
+      "sha256": "3bdb01051c45223920fc57580b2303290a9b405fe36bbefada2b8e61f6d4b637"
     },
     {
       "path": "src/codex/inject.ts",
@@ -1018,7 +1030,7 @@
     },
     {
       "path": "src/codex/transition-state.ts",
-      "sha256": "f249df83f9f3366d18c868f51a04d3a85bcc0d659b437593186532e47b7d8586"
+      "sha256": "774a8323d5dd36a9e7235018daf8fc0d6c2898f053d33e0a9d1da6b1964b71ac"
     },
     {
       "path": "src/codex/upstream-host-health.ts",
@@ -1738,7 +1750,7 @@
     },
     {
       "path": "src/lib/errors.ts",
-      "sha256": "576e12852255862f9241837b9c772d499ee0752ce34b43b080c3069e4f1d3f33"
+      "sha256": "460d877ce68799cc64129940a11deeb14de97d60851fe8c3e3ff09b1ab3e4e55"
     },
     {
       "path": "src/lib/eventstream-decoder.ts",
@@ -1982,7 +1994,7 @@
     },
     {
       "path": "src/oauth/cursor.ts",
-      "sha256": "cb252292687c7cc79956c880de49c8a7cbeb6b9ee2c3f4eaab2dda9b8d640e36"
+      "sha256": "afc515c357f5bc9f788c07e40a0a1fce6ef3d9887759906e5a48113a720d5673"
     },
     {
       "path": "src/oauth/github-copilot.ts",
@@ -2088,13 +2100,17 @@
       "path": "src/providers/context-cap.ts",
       "sha256": "153189b3a96f92081b5d401bbfa463e080bfead24c8d8c3ef8cd57f4a17dc421"
     },
+    {
+      "path": "src/providers/cursor-pool.ts",
+      "sha256": "26c8cb42be69a3089577ed9907673d12705f5496ede163baaf288fc2c288bfcd"
+    },
     {
       "path": "src/providers/derive.ts",
-      "sha256": "55027015be5e5bf25f2c9ab30c5b0652ef6bbdeeacd8bc904eb56466e8463f78"
+      "sha256": "c4abf56b32203d353dbdab3f5485768f859098ae35f2463ed5b939e3d3edce58"
     },
     {
       "path": "src/providers/fastwire.ts",
-      "sha256": "28a8d63aed99fcd99b902b75e63f0df239a88554769273227815724a36f97416"
+      "sha256": "b6609c8e6ec285074ea93cfaec0c997aed30adb2f52ef22b48129347e7525493"
     },
     {
       "path": "src/providers/free-directory.ts",
@@ -2138,7 +2154,7 @@
     },
     {
       "path": "src/providers/openai-sidecar.ts",
-      "sha256": "d07ec55e8600563fa9cbdb9e535cfecb8163b8235aa44547c9359f6ca8ce62d1"
+      "sha256": "c555cf015441e53c7054ea627c84a2f8a7ab6982c7e065371088125ec0757d6d"
     },
     {
       "path": "src/providers/openai-tier-startup.ts",
@@ -2170,7 +2186,7 @@
     },
     {
       "path": "src/providers/registry.ts",
-      "sha256": "68af5ea5f483ace1f33d64d23b03ac778668c180e6b896b2e0f7043028217e05"
+      "sha256": "7e674f4503f43248e68b94a657b233fe3194aa560f7ff7deacb820996148900a"
     },
     {
       "path": "src/providers/request-pacing.ts",
@@ -2178,7 +2194,7 @@
     },
     {
       "path": "src/providers/service-tier.ts",
-      "sha256": "56198ef6740a3b7dbd59c605669383dc52d4004032818c54b1a0289bf34e2c3f"
+      "sha256": "657fc25f91b481b8300bd260e464ac31ba96f287192392e4187e6b7f74f5b890"
     },
     {
       "path": "src/providers/slug-codec.ts",
@@ -2206,7 +2222,7 @@
     },
     {
       "path": "src/responses/custom-tool-compat.ts",
-      "sha256": "f2b179e699e359423f0a90a33303c8a022100e57c1f228488252849ad0c2e0be"
+      "sha256": "fbda1f4416df46f6102fce0ac061793c9038f0739ab8b919534b1cca857e1b98"
     },
     {
       "path": "src/responses/hosted-tool-policy.ts",
@@ -2214,7 +2230,7 @@
     },
     {
       "path": "src/responses/namespace-tool-compat.ts",
-      "sha256": "b1a7a25672210853f2ec3eaf273bc02bdcd6e38e671b3508cbb3e6865ed8441e"
+      "sha256": "2094a2d9a7356e1c159a6a19ebf2947f0a1a78d1588caebfde02084c242aa4f6"
     },
     {
       "path": "src/responses/parser.ts",
@@ -2266,7 +2282,7 @@
     },
     {
       "path": "src/router.ts",
-      "sha256": "0efadab869f68b4049c5cb65b679b1316b3b73ff197671db8819852766c5ebc2"
+      "sha256": "44f5eebeb8894345edf51120ce1c6b091fa0f81be5bac875bd944af0c9c9b2de"
     },
     {
       "path": "src/routing/analytics.ts",
@@ -2378,7 +2394,7 @@
     },
     {
       "path": "src/server/chat-completions.ts",
-      "sha256": "a1dcf1aa726fbdfc4bea1b7079cf7ef62aa17e8c9ce76021a97338d2b172bd4f"
+      "sha256": "47403128f764b59654a5579c42297f07a393ee6fb365435d8cb950675d4f6990"
     },
     {
       "path": "src/server/chat-native-sse.ts",
@@ -2386,7 +2402,7 @@
     },
     {
       "path": "src/server/chat-native.ts",
-      "sha256": "73f1c79e390998bb6e3be373c27b43921c05a79e61ebe63a6a782255da3e777b"
+      "sha256": "4ed4eddc8cfb62631feccc1ae57e0ac35b0baeeab861bca220debee5e9a8c8a8"
     },
     {
       "path": "src/server/claude-messages.ts",
@@ -2446,7 +2462,7 @@
     },
     {
       "path": "src/server/management/agent-settings-routes.ts",
-      "sha256": "5a609ba3b289dd78e06c93efa7a56725e2dad29b3f07f861b7910221a0d058cd"
+      "sha256": "da00cb3480c4c48313c869e0cd264b49fcc9de9edf2b1e8b9fe90d16b25689ae"
     },
     {
       "path": "src/server/management/api-access.ts",
@@ -2466,7 +2482,7 @@
     },
     {
       "path": "src/server/management/config-routes.ts",
-      "sha256": "fbc2d13eb89b2376132dc9fc3580615de29782068c841b1a2626bc09009f9430"
+      "sha256": "63aa2f28e3659d42805df08ca2bbdce98575b55a88ea15cb8fad756fbab5cec2"
     },
     {
       "path": "src/server/management/context.ts",
@@ -2554,7 +2570,7 @@
     },
     {
       "path": "src/server/management/vision-sidecar-options.ts",
-      "sha256": "8372cbc3c4b82c270a620e352d96b4914e2f44d098f6d383db104cfd411f6e2d"
+      "sha256": "797f8328eff1a0eedc3a3c4345ab00bda62c39af7c141c60b1f3d8c7f7f0a798"
     },
     {
       "path": "src/server/management/web-search-sidecar-options.ts",
@@ -2662,11 +2678,11 @@
     },
     {
       "path": "src/server/responses/compact.ts",
-      "sha256": "26ce4c5c090d7de26f62384aa4bee31b7a8feca7737fd49a57dcd3528eae7331"
+      "sha256": "8dcd6b33d2c0b9cc77649ee260e2769e400cfc05e4237ae7a547362257dba862"
     },
     {
       "path": "src/server/responses/core.ts",
-      "sha256": "8a8a9c7bca4a90936ae91fba056d8215916f1e189d64f99a97246d35ee1d4f58"
+      "sha256": "4aa38a520acc867f483393d8b013fca055bbdfefdda83a12b01148b08f36caac"
     },
     {
       "path": "src/server/responses/empty-completion-guard.ts",
@@ -2754,7 +2770,7 @@
     },
     {
       "path": "src/service.ts",
-      "sha256": "a9babc47b0d3fd5e3f1fcd31f9be8438071ebad6d86fa716f52cecfc4d4a14e3"
+      "sha256": "3c1198b34fbef2f69f0a8dff1ca3f604bb16e7bdbf96b0d59e9eac0bc29f848b"
     },
     {
       "path": "src/sidecar/auth.ts",
@@ -2846,11 +2862,11 @@
     },
     {
       "path": "src/types/config.ts",
-      "sha256": "17b8b0ea062aa3d5877d04536ace4fc52baebfce41bdcb4c7f88ead9fd809c09"
+      "sha256": "473fde6d5b11a71b4e7712b3bc2863841d0ecb327f335c3979328850afa0700f"
     },
     {
       "path": "src/types/provider.ts",
-      "sha256": "151bd31beb4de0d27d31283fd5278f45eb52426429dac64fd156fc9b77c4f12d"
+      "sha256": "6a37ade0ad24851f61705584e0c67f1c64335541ffcd5f337465ddd618249f39"
     },
     {
       "path": "src/types/request.ts",
@@ -2914,7 +2930,7 @@
     },
     {
       "path": "src/usage/cost.ts",
-      "sha256": "ccd83889f7cbed904d70c01fc37ea86e0d9761571d7e5bcda4f17c9093800883"
+      "sha256": "c5fb9b72d23943f47941d35ad628d230c48560e7c98a16f6c5afa2361dffb52c"
     },
     {
       "path": "src/usage/debug.ts",
@@ -2922,7 +2938,7 @@
     },
     {
       "path": "src/usage/expected-prices.ts",
-      "sha256": "3b2874f24e7d53979fee5829f6b710b21cfefe06fb96f5cc887247aab5606acc"
+      "sha256": "5d2b69ac87cee1e7acdf5e54bf56e5de309b7c4d1fb79b8d0333f9c88c08e24e"
     },
     {
       "path": "src/usage/log.ts",
@@ -2948,22 +2964,30 @@
       "path": "src/vision/anthropic-describe.ts",
       "sha256": "f71189755b7b4093646a4bfa9622f9cbafa4d85f5a49d510bbcd9ac74b1ca026"
     },
+    {
+      "path": "src/vision/backends.ts",
+      "sha256": "f330298c7effd21e26fa200858b44742a97cc64100be2f84964faceb35a59eaa"
+    },
     {
       "path": "src/vision/describe.ts",
       "sha256": "04673cb73b34adb94a450a07abcd14a8b80c80e3dad17584dbe344260f49984e"
     },
     {
       "path": "src/vision/eligibility.ts",
-      "sha256": "b1f76df0a4aae705419c3badf7d463612f73384679a52fc4a1413fa34369cb63"
+      "sha256": "0cf9d282723759f9b85e2ee563e7492878d8fd0c5de0e50688d404ef6632f288"
     },
     {
       "path": "src/vision/index.ts",
-      "sha256": "35db81fe518fb8e5b7a4773cad1c4885d745705f269f04fd6440cb7d1e13cf63"
+      "sha256": "8b46ba96b3c1cc5d4a57eb3b3edcc9d3f6c791fc6a5e5e26d4adc89afbcae116"
     },
     {
       "path": "src/vision/reasoning.ts",
       "sha256": "7b5ba571d9e727304f9cc053baaf82a5023fd2dad92f7fbf01af7edb8cfca21a"
     },
+    {
+      "path": "src/vision/routed-describe.ts",
+      "sha256": "270bf4204b10a46611c9f978f26a68e45b567cdf38deb81f1ed762d4c76398f0"
+    },
     {
       "path": "src/vision/timeout-bounds.ts",
       "sha256": "65a3124c6817cda51eb529520652576ffb1e92db433112162c0065104954eaba"

package/src/lib/errors.ts

@@ -162,11 +162,16 @@ export function classifyError(status: number, type: string, message: string): Oc
     return { message, type: "invalid_request_error", code: "context_length_exceeded" };
   }
   // "Cursor resource limit exceeded" is emitted only for explicit request-size overflow
-  // details (isCursorRequestTooLargeDetail in cursor-errors.ts); quota-style resource
-  // exhaustion arrives as "Cursor rate limit exceeded" and falls through to 429 below.
+  // details (isCursorRequestTooLargeDetail in cursor-errors.ts); "Cursor context limit
+  // exceeded" is the bare payload-overflow shape (isCursorZeroTokenResourceExhausted);
+  // quota-style resource exhaustion arrives as "Cursor rate limit exceeded" and falls
+  // through to 429 below.
   if (text.includes("cursor resource limit exceeded")) {
     return { message, type: "invalid_request_error", code: "tool_catalog_too_large" };
   }
+  if (text.includes("cursor context limit exceeded")) {
+    return { message, type: "invalid_request_error", code: "context_length_exceeded" };
+  }
   // The Cursor adapter's classified rate-limit prefix is authoritative: its DETAIL may echo
   // quota wording ("... quota exhausted") that would otherwise hit the insufficient_quota
   // branch below and break the planned retry-with-backoff contract (WP3 review blocker 1).
@@ -306,6 +311,7 @@ export function inferHttpStatusFromAdapterMessage(message: string): number {
   // See classifyError: this prefix now only means explicit request-size overflow (400);
   // quota-style Cursor resource exhaustion carries the rate-limit prefix and maps to 429.
   if (lower.includes("cursor resource limit exceeded")) return 400;
+  if (lower.includes("cursor context limit exceeded")) return 400;
   if (
     lower.includes("resource_exhausted") ||
     lower.includes("resource exhausted") ||