@bitkyc08/opencodex 2.39.0 → 2.40.0

package/src/adapters/cursor/catalog.ts

@@ -32,6 +32,12 @@ export interface CursorCapability {
   readonly variants: Partial<Record<CursorVariantKind, CursorVariantSpec>>;
   /** Which variant the umbrella picker row selects (thinking merges into the base). */
   readonly defaultVariant: CursorVariantKind;
+  /**
+   * Human picker label, in Cursor's own spelling. Codex would otherwise show the raw
+   * routed slug (`cursor/kimi-k3`), because `routedDisplayName` passes it through
+   * unchanged for every provider (codex/catalog/sync.ts).
+   */
+  readonly displayName: string;
   /** Context-window metadata (display/routing only — never implies maxMode). */
   readonly window: number;
   /** Max Mode proven on the wire for this base (static evidence; live maxModeModels unions in). */
@@ -46,6 +52,8 @@ const CONTEXT_256K = 256 * K;
 const CONTEXT_272K = 272 * K;
 const CONTEXT_500K = 500 * K;
 const CONTEXT_1M = 1_000 * K;
+/** Gemini publishes the exact power-of-two window, not a rounded 1M. */
+const CONTEXT_GEMINI = 1_048_576;
 
 const FULL = ["low", "medium", "high", "xhigh", "max"] as const;
 const T = "thinking-then-effort" as const;
@@ -59,6 +67,7 @@ const E = "effort-then-thinking" as const;
  */
 export const CURSOR_CAPABILITIES: Record<string, CursorCapability> = {
   "claude-4.5-opus": {
+    displayName: "Claude Opus 4.5",
     window: CONTEXT_200K,
     defaultVariant: "thinking",
     variants: {
@@ -67,6 +76,7 @@ export const CURSOR_CAPABILITIES: Record<string, CursorCapability> = {
     },
   },
   "claude-4.6-opus": {
+    displayName: "Claude Opus 4.6",
     window: CONTEXT_1M,
     defaultVariant: "thinking",
     variants: {
@@ -75,6 +85,7 @@ export const CURSOR_CAPABILITIES: Record<string, CursorCapability> = {
     },
   },
   "claude-4.6-sonnet": {
+    displayName: "Claude Sonnet 4.6",
     window: CONTEXT_1M,
     defaultVariant: "thinking",
     variants: {
@@ -83,6 +94,7 @@ export const CURSOR_CAPABILITIES: Record<string, CursorCapability> = {
     },
   },
   "claude-4.5-sonnet": {
+    displayName: "Claude Sonnet 4.5",
     window: CONTEXT_200K,
     defaultVariant: "thinking",
     variants: {
@@ -91,6 +103,7 @@ export const CURSOR_CAPABILITIES: Record<string, CursorCapability> = {
     },
   },
   "claude-4-sonnet": {
+    displayName: "Claude Sonnet 4",
     window: CONTEXT_200K,
     defaultVariant: "thinking",
     variants: {
@@ -99,6 +112,7 @@ export const CURSOR_CAPABILITIES: Record<string, CursorCapability> = {
     },
   },
   "claude-fable-5": {
+    displayName: "Claude Fable 5",
     window: CONTEXT_1M,
     defaultVariant: "thinking",
     variants: {
@@ -106,7 +120,41 @@ export const CURSOR_CAPABILITIES: Record<string, CursorCapability> = {
       thinking: { levels: FULL, order: T },
     },
   },
+  // 260902 preemptive: Claude Fable 5.1 seeded ahead of Cursor's lineup update, mirroring
+  // claude-fable-5 (same 1M window and full effort ladder). Cursor has spelled Claude ids
+  // both Anthropic-style (`claude-opus-4-7`, thinking-then-effort) and version-first
+  // (`claude-4.6-opus`, effort-then-thinking), so all three plausible spellings are seeded;
+  // the live GetUsableModels filter drops whichever the roster does not expose. Collapse to
+  // the one real spelling once it is observed.
+  "claude-fable-5-1": {
+    displayName: "Claude Fable 5.1",
+    window: CONTEXT_1M,
+    defaultVariant: "thinking",
+    variants: {
+      regular: { levels: FULL },
+      thinking: { levels: FULL, order: T },
+    },
+  },
+  "claude-fable-5.1": {
+    displayName: "Claude Fable 5.1",
+    window: CONTEXT_1M,
+    defaultVariant: "thinking",
+    variants: {
+      regular: { levels: FULL },
+      thinking: { levels: FULL, order: T },
+    },
+  },
+  "claude-5.1-fable": {
+    displayName: "Claude Fable 5.1",
+    window: CONTEXT_1M,
+    defaultVariant: "thinking",
+    variants: {
+      regular: { levels: FULL },
+      thinking: { levels: FULL, order: E },
+    },
+  },
   "claude-sonnet-5": {
+    displayName: "Claude Sonnet 5",
     window: CONTEXT_1M,
     defaultVariant: "thinking",
     variants: {
@@ -115,6 +163,7 @@ export const CURSOR_CAPABILITIES: Record<string, CursorCapability> = {
     },
   },
   "claude-opus-4-7": {
+    displayName: "Claude Opus 4.7",
     window: CONTEXT_1M,
     defaultVariant: "thinking",
     variants: {
@@ -125,6 +174,7 @@ export const CURSOR_CAPABILITIES: Record<string, CursorCapability> = {
     },
   },
   "claude-opus-4-8": {
+    displayName: "Claude Opus 4.8",
     window: CONTEXT_1M,
     defaultVariant: "thinking",
     variants: {
@@ -135,6 +185,7 @@ export const CURSOR_CAPABILITIES: Record<string, CursorCapability> = {
     },
   },
   "claude-opus-5": {
+    displayName: "Claude Opus 5",
     window: CONTEXT_1M,
     defaultVariant: "thinking",
     variants: {
@@ -147,32 +198,38 @@ export const CURSOR_CAPABILITIES: Record<string, CursorCapability> = {
     },
   },
   "glm-5.2": {
+    displayName: "GLM 5.2",
     window: CONTEXT_1M,
     defaultVariant: "regular",
     variants: { regular: { levels: ["high", "max"] } },
   },
   "glm-5.3": {
+    displayName: "GLM 5.3",
     window: CONTEXT_1M,
     defaultVariant: "regular",
     variants: { regular: { levels: ["low", "high", "max"] } },
   },
   "gemini-3.6-flash": {
-    window: CONTEXT_1M,
+    displayName: "Gemini 3.6 Flash",
+    window: CONTEXT_GEMINI,
     defaultVariant: "regular",
     variants: { regular: { levels: ["minimal", "low", "medium", "high"] } },
   },
   "gemini-3.7-flash": {
-    window: CONTEXT_1M,
+    displayName: "Gemini 3.7 Flash",
+    window: CONTEXT_GEMINI,
     defaultVariant: "regular",
     variants: { regular: { levels: ["low", "medium", "high"] } },
   },
   "kimi-k3": {
+    displayName: "Kimi K3",
     window: CONTEXT_1M,
     defaultVariant: "regular",
     maxModeVerified: true,
     variants: { regular: { levels: ["low", "high", "max"] } },
   },
   "grok-4.5": {
+    displayName: "Cursor Grok 4.5",
     window: CONTEXT_500K,
     defaultVariant: "regular",
     wirePrefix: "cursor-",
@@ -182,6 +239,7 @@ export const CURSOR_CAPABILITIES: Record<string, CursorCapability> = {
     },
   },
   "grok-4.6": {
+    displayName: "Cursor Grok 4.6",
     window: CONTEXT_500K,
     defaultVariant: "regular",
     wirePrefix: "cursor-",
@@ -191,71 +249,88 @@ export const CURSOR_CAPABILITIES: Record<string, CursorCapability> = {
     },
   },
   "gpt-5.1": {
+    displayName: "GPT-5.1",
     window: CONTEXT_272K,
     defaultVariant: "regular",
     variants: { regular: { levels: ["low", "high"] } },
   },
   "gpt-5.1-codex-max": {
+    displayName: "GPT-5.1 Codex Max",
     window: CONTEXT_272K,
     defaultVariant: "regular",
     variants: { regular: { levels: ["low", "medium", "high", "xhigh"] } },
   },
   "gpt-5.1-codex-mini": {
+    displayName: "GPT-5.1 Codex Mini",
     window: CONTEXT_272K,
     defaultVariant: "regular",
     variants: { regular: { levels: ["low", "high"] } },
   },
   "gpt-5.2": {
+    displayName: "GPT-5.2",
     window: CONTEXT_272K,
     defaultVariant: "regular",
     variants: { regular: { levels: ["low", "high", "xhigh"] } },
   },
   "gpt-5.2-codex": {
+    displayName: "GPT-5.2 Codex",
     window: CONTEXT_272K,
     defaultVariant: "regular",
     variants: { regular: { levels: ["low", "high", "xhigh"] } },
   },
   "gpt-5.3-codex": {
+    displayName: "Codex 5.3",
     window: CONTEXT_272K,
     defaultVariant: "regular",
     variants: { regular: { levels: ["low", "high", "xhigh"] } },
   },
   "gpt-5.4": {
+    displayName: "GPT-5.4",
     window: CONTEXT_272K,
     defaultVariant: "regular",
     variants: { regular: { levels: ["low", "medium", "high", "xhigh"] } },
   },
   "gpt-5.4-mini": {
+    displayName: "GPT-5.4 Mini",
     window: CONTEXT_272K,
     defaultVariant: "regular",
     variants: { regular: { levels: ["low", "medium", "high", "xhigh"] } },
   },
   "gpt-5.4-nano": {
+    displayName: "GPT-5.4 Nano",
     window: CONTEXT_272K,
     defaultVariant: "regular",
     variants: { regular: { levels: ["low", "medium", "high", "xhigh"] } },
   },
   "gpt-5.5": {
+    displayName: "GPT-5.5",
     window: CONTEXT_272K,
     defaultVariant: "regular",
     variants: { regular: { levels: ["low", "medium", "high"] } },
   },
   "gpt-5.5-extra": {
-    window: CONTEXT_272K,
+    displayName: "GPT-5.5 Extra",
+    // Live GetUsableModels reports 200K for this row, not the gpt-5 family's 272K
+    // (account-verified 260709). The seed carried the measured number; the capability
+    // table was approximating from the family.
+    window: CONTEXT_200K,
     defaultVariant: "regular",
     variants: { regular: { levels: ["high"] } },
   },
   "gpt-5.6-sol": {
+    displayName: "GPT-5.6 Sol",
     window: CONTEXT_1M,
     defaultVariant: "regular",
     variants: { regular: { levels: FULL } },
   },
   "gpt-5.6-terra": {
+    displayName: "GPT-5.6 Terra",
     window: CONTEXT_1M,
     defaultVariant: "regular",
     variants: { regular: { levels: FULL } },
   },
   "gpt-5.6-luna": {
+    displayName: "GPT-5.6 Luna",
     window: CONTEXT_1M,
     defaultVariant: "regular",
     variants: { regular: { levels: FULL } },
@@ -368,6 +443,53 @@ function defaultKindFor(baseId: string): CursorVariantKind {
   return CURSOR_CAPABILITIES[baseId]?.defaultVariant ?? "regular";
 }
 
+/**
+ * Promote a variant to its fast sibling when the base declares one, else leave it alone.
+ *
+ * Thinking must map to thinkingFast rather than to the plain fast variant: the umbrella row
+ * for a Claude base routes THINKING, and its regular-fast sibling is a different product
+ * with a shorter ladder (claude-opus-5-fast stops at high) whose regular family is
+ * quarantined. A base with no fast dimension keeps its kind, so Fast degrades to today's
+ * behavior instead of erroring.
+ */
+export function upgradeToFast(baseId: string, kind: CursorVariantKind): CursorVariantKind {
+  const variants = CURSOR_CAPABILITIES[baseId]?.variants;
+  if (!variants) return kind;
+  if (kind === "thinking" || kind === "thinkingFast") {
+    return variants.thinkingFast ? "thinkingFast" : kind;
+  }
+  return variants.fast ? "fast" : kind;
+}
+
+/** Bases whose capability declares a fast or thinking-fast variant. */
+export function cursorFastCapableBases(): string[] {
+  return Object.entries(CURSOR_CAPABILITIES)
+    .filter(([, capability]) => capability.variants.fast !== undefined
+      || capability.variants.thinkingFast !== undefined)
+    .map(([baseId]) => baseId);
+}
+
+/**
+ * The id to LIST for a base when the global fast switch is on, for clients that have no
+ * Fast toggle of their own. Undefined when the base has no fast dimension, so a caller
+ * cannot advertise an id that would not route.
+ *
+ * Composed from the base's defaultVariant rather than a bare `-fast` suffix. Measured: for a
+ * thinking-default base, `claude-opus-5-fast` parses back as the REGULAR-fast sibling and
+ * resolves to `claude-opus-5-high-fast` — a shorter ladder, in the quarantined regular
+ * family, and a different wire from what the Codex toggle sends. The mirror case is equally
+ * wrong: grok has no thinkingFast spec, so `grok-4.6-thinking-fast` would fall back to the
+ * regular spec and emit a bare `grok-4.6` with no effort and no fast marker at all.
+ */
+export function cursorFastIdFor(baseId: string): string | undefined {
+  const capability = CURSOR_CAPABILITIES[baseId];
+  if (!capability) return undefined;
+  const kind = upgradeToFast(baseId, capability.defaultVariant);
+  if (kind === "thinkingFast") return `${baseId}-thinking-fast`;
+  if (kind === "fast") return `${baseId}-fast`;
+  return undefined;
+}
+
 function normalizeRequestedEffort(reasoning: string | undefined): string | undefined {
   const normalized = reasoning?.toLowerCase();
   return normalized === "ultra" ? "max" : normalized;
@@ -448,20 +570,25 @@ export function resolveCursorSelection(
   pickedId: string,
   reasoning: string | undefined,
   liveMaxModeIds?: ReadonlySet<string>,
+  options: { fast?: boolean } = {},
 ): CursorResolvedSelection {
   const parsed = parseCursorVariantId(pickedId);
   if (!parsed.known) {
     return { wireId: pickedId, canonicalId: pickedId, maxMode: false, known: false };
   }
   const capability = CURSOR_CAPABILITIES[parsed.baseId]!;
-  const spec = capability.variants[parsed.kind] ?? capability.variants.regular;
+  // Codex's Fast toggle is a variant switch here; every later read must use the upgraded
+  // kind, not parsed.kind, or the wire id loses its -fast marker (or keeps the cursor-
+  // prefix that only the regular variant takes).
+  const kind = options.fast === true ? upgradeToFast(parsed.baseId, parsed.kind) : parsed.kind;
+  const spec = capability.variants[kind] ?? capability.variants.regular;
   if (!spec) {
     return { wireId: parsed.baseId, canonicalId: parsed.baseId, maxMode: false, known: true };
   }
   const requested = parsed.level ?? reasoning;
   const effort = cursorVariantEffort(spec, requested);
-  const canonicalId = composeWireId(parsed.baseId, parsed.kind, effort);
-  const wireId = capability.wirePrefix && parsed.kind === "regular"
+  const canonicalId = composeWireId(parsed.baseId, kind, effort);
+  const wireId = capability.wirePrefix && kind === "regular"
     ? `${capability.wirePrefix}${canonicalId}`
     : canonicalId;
   const ultraRequested = parsed.ultra || reasoning?.toLowerCase() === "ultra";
@@ -493,6 +620,7 @@ export function liveCursorMaxModeBasesForTests(): ReadonlySet<string> {
 
 export interface CursorUmbrellaRow {
   readonly id: string;
+  readonly displayName: string;
   readonly efforts: readonly string[];
   readonly window: number;
   /** Max Mode evidence present: the ultra rung maps to maxMode on the wire. */
@@ -508,9 +636,13 @@ export interface CursorUmbrellaRow {
 export function cursorGrokFastSelection(
   pickedId: string,
   reasoning: string | undefined,
+  fast?: boolean,
 ): { wireBaseId: string; effort: string } | undefined {
   const parsed = parseCursorVariantId(pickedId);
-  if (!parsed.known || parsed.kind !== "fast") return undefined;
+  // Both call paths must learn the flag together: if only resolveCursorSelection did, a
+  // toggled Grok pick would emit a flattened grok-4.6-high-fast id, which the wire rejects.
+  const kind = fast === true ? upgradeToFast(parsed.baseId, parsed.kind) : parsed.kind;
+  if (!parsed.known || kind !== "fast") return undefined;
   const capability = CURSOR_CAPABILITIES[parsed.baseId];
   if (capability?.wirePrefix !== "cursor-") return undefined;
   const spec = capability.variants.fast;
@@ -532,6 +664,7 @@ export function cursorUmbrellaRows(): CursorUmbrellaRow[] {
     if (!spec || spec.quarantined) continue;
     rows.push({
       id: baseId,
+      displayName: capability.displayName,
       efforts: spec.levels,
       window: capability.window,
       maxModeVerified: capability.maxModeVerified === true,

package/src/adapters/cursor/discovery.ts

@@ -5,7 +5,7 @@ import {
   cursorWireModelIdWithEffort,
   CURSOR_THINKING_MODEL_IDS,
 } from "./effort-map";
-import { parseCursorVariantId } from "./catalog";
+import { cursorUmbrellaRows, parseCursorVariantId } from "./catalog";
 
 export interface CursorModelInfo {
   id: string;
@@ -30,6 +30,8 @@ export function inferCursorContextWindow(modelId: string): number {
   if (id.includes("1m")) return CONTEXT_1M;
   if (id.startsWith("gemini-")) return CONTEXT_1M;
   if (id === "glm-5.3" || id === "glm-5.2") return CONTEXT_1M;
+  // 260902: every Fable is a 1M model; catch live spellings the seed does not carry.
+  if (id.includes("fable")) return CONTEXT_1M;
   if (id.startsWith("gpt-5.6-")) return CONTEXT_1M;
   if (id.startsWith("gpt-5") || id === "gpt-5-codex") return CONTEXT_272K;
   if (id.startsWith("grok-4.5") || id.startsWith("grok-4.6")) return 500_000;
@@ -260,96 +262,86 @@ export function filterCursorConfiguredModelsByLiveDiscovery<T extends { id: stri
  */
 export const CURSOR_KNOWN_UNCALLABLE_MODEL_IDS: ReadonlySet<string> = new Set([]);
 
+/**
+ * Cursor products that are NOT a dimension of any capability base. Each carries its own
+ * label because there is no capability record to read one from. A row belongs here only
+ * when Cursor ships it as a distinct product; a variant of a cataloged base does not.
+ */
+export const CURSOR_PRODUCT_MODELS: readonly (CursorModelInfo & { displayName: string })[] = [
+  { id: "claude-4.5-haiku", displayName: "Claude Haiku 4.5", contextWindow: CONTEXT_200K },
+  { id: "composer-1", displayName: "Composer 1", contextWindow: CONTEXT_200K },
+  { id: "composer-2.5", displayName: "Composer 2.5", contextWindow: CONTEXT_200K },
+  { id: "gemini-2.5-flash", displayName: "Gemini 2.5 Flash", contextWindow: CONTEXT_GEMINI },
+  { id: "gemini-3-flash", displayName: "Gemini 3 Flash", contextWindow: CONTEXT_GEMINI },
+  { id: "gemini-3-pro", displayName: "Gemini 3 Pro", contextWindow: CONTEXT_GEMINI },
+  { id: "gemini-3-pro-image-preview", displayName: "Gemini 3 Pro Image", contextWindow: CONTEXT_200K },
+  { id: "gemini-3.1-pro", displayName: "Gemini 3.1 Pro", contextWindow: CONTEXT_GEMINI },
+  { id: "gemini-3.5-flash", displayName: "Gemini 3.5 Flash", contextWindow: CONTEXT_200K },
+  { id: "gpt-5-codex", displayName: "GPT-5 Codex", contextWindow: CONTEXT_272K },
+  { id: "gpt-5-mini", displayName: "GPT-5 Mini", contextWindow: CONTEXT_272K },
+  { id: "gpt-5.1-codex", displayName: "GPT-5.1 Codex", contextWindow: CONTEXT_272K },
+  { id: "kimi-k2.7-code", displayName: "Kimi K2.7 Code", contextWindow: CONTEXT_262K },
+];
+
+/**
+ * Real upstream wire ids that LOOK like a dimension of a cataloged base but are served as
+ * their own catalog row by Cursor, so they stay rows rather than folding into a base.
+ *
+ * - `claude-4-sonnet-1m`: a distinct 1M-window row upstream, not `claude-4-sonnet` + ultra.
+ *   claude-4-sonnet carries no maxMode evidence, so folding it would invent a capability.
+ *   `REAL_1M_WIRE_IDS` in catalog.ts already stops the parser reading it as the synthetic
+ *   marker.
+ * - `gpt-5-fast`: there is no `gpt-5` capability base for it to be a dimension of.
+ * - `composer-2.5-fast`: composer-2.5 has no effort or variant dimensions at all.
+ */
+export const CURSOR_REAL_ID_EXCEPTIONS: readonly (CursorModelInfo & { displayName: string })[] = [
+  { id: "claude-4-sonnet-1m", displayName: "Claude Sonnet 4 (1M)", contextWindow: CONTEXT_1M },
+  { id: "gpt-5-fast", displayName: "GPT-5 Fast", contextWindow: CONTEXT_272K },
+  { id: "composer-2.5-fast", displayName: "Composer 2.5 Fast", contextWindow: CONTEXT_200K },
+];
+
+/** Picker labels for the auto-router rows, which have no capability record. */
+const CURSOR_ROUTER_DISPLAY_NAMES: Readonly<Record<string, string>> = {
+  auto: "Auto",
+  "auto-cost": "Auto (Cost)",
+  "auto-balance": "Auto (Balanced)",
+  "auto-intelligence": "Auto (Intelligence)",
+};
+
+/**
+ * The published Cursor row set. DERIVED from CURSOR_CAPABILITIES via cursorUmbrellaRows()
+ * (devlog 260902_cursor_unified_identity) so the capability table and the picker can no
+ * longer disagree: one row per base, with thinking / fast / synthetic -1m remaining
+ * routable aliases that add no rows.
+ *
+ * Before this, the seed was a hand-maintained list that drifted from the capability table —
+ * `cursorUmbrellaRows()` existed but only tests called it, so collapsing a variant changed
+ * routing without changing what Codex listed.
+ *
+ * Windows and effort ladders come from the capability record; the two lists below carry the
+ * ids that have no capability record, each with its own label and window.
+ */
 export const CURSOR_STATIC_MODELS: readonly CursorModelInfo[] = normalizeCursorModels([
-  // Context windows and the model lineup mirror Cursor's public models/pricing docs plus the jawcode
-  // SOT (../jawcode/packages/ai/src/models.json, `cursor` provider), which mirrors the real
-  // GetUsableModels catalog. Live discovery is the preferred path when logged in; these ids seed the
-  // routed Codex catalog and provide a static fallback. Cursor base ids carry no effort suffix here —
-  // the request builder appends the per-model suffix (see effort-map.ts) and reasoning models
-  // advertise effort so Codex exposes the tier picker. `supportsReasoningEffort` tracks whether the
-  // model has *selectable effort tiers* (CURSOR_MODEL_EFFORT_TIERS), NOT merely whether it reasons:
-  // gemini/grok/kimi-k2.7/gpt-5-mini are reasoning models in the SOT but are sent bare (no tier picker).
   ...CURSOR_ROUTER_MODEL_IDS.map(id => ({ id, contextWindow: CONTEXT_200K, supportsReasoningEffort: false })),
-
-  // Umbrella seed (devlog 260828_cursor_umbrella_catalog): one row per BASE
-  // model. Thinking merges into the base (the resolver routes the thinking
-  // variant); fast / thinking-fast / -1m stay routable as aliases but add no
-  // rows. Windows follow CURSOR_CAPABILITIES where the base is cataloged.
-  { id: "claude-sonnet-5", contextWindow: CONTEXT_1M, supportsReasoningEffort: true },
-  { id: "claude-4-sonnet", contextWindow: CONTEXT_200K },
-  { id: "claude-4-sonnet-1m", contextWindow: CONTEXT_1M },
-  { id: "claude-4.5-haiku", contextWindow: CONTEXT_200K },
-  { id: "claude-4.5-sonnet", contextWindow: CONTEXT_200K },
-  { id: "claude-4.5-opus", contextWindow: CONTEXT_200K, supportsReasoningEffort: true },
-  { id: "claude-4.6-opus", contextWindow: CONTEXT_1M, supportsReasoningEffort: true },
-  { id: "claude-4.6-sonnet", contextWindow: CONTEXT_1M, supportsReasoningEffort: true },
-  { id: "claude-opus-4-7", contextWindow: CONTEXT_1M, supportsReasoningEffort: true },
-  { id: "claude-opus-4-8", contextWindow: CONTEXT_1M, supportsReasoningEffort: true },
-  // claude-opus-5: regular variant is quarantined (not_found on every Run) but
-  // the umbrella row routes the THINKING variant, which is live — so the base
-  // row returns to the seed under the umbrella (resolver never sends the
-  // quarantined regular wire id for the bare slug).
-  { id: "claude-opus-5", contextWindow: CONTEXT_1M, supportsReasoningEffort: true },
-  { id: "claude-fable-5", contextWindow: CONTEXT_1M, supportsReasoningEffort: true },
-
-  { id: "composer-1", contextWindow: CONTEXT_200K },
-  { id: "composer-2.5", contextWindow: CONTEXT_200K },
-  { id: "composer-2.5-fast", contextWindow: CONTEXT_200K },
-
-  { id: "gemini-2.5-flash", contextWindow: CONTEXT_GEMINI },
-  { id: "gemini-3-flash", contextWindow: CONTEXT_GEMINI },
-  { id: "gemini-3-pro", contextWindow: CONTEXT_GEMINI },
-  { id: "gemini-3-pro-image-preview", contextWindow: CONTEXT_200K },
-  { id: "gemini-3.1-pro", contextWindow: CONTEXT_GEMINI },
-  { id: "gemini-3.5-flash", contextWindow: CONTEXT_200K },
-  // 260825 live GetUsableModels: both ship only as effort-suffixed ids, so each exposes a tier
-  // picker. 3.6 is the only Cursor model with a `minimal` rung.
-  { id: "gemini-3.6-flash", contextWindow: CONTEXT_GEMINI, supportsReasoningEffort: true },
-  { id: "gemini-3.7-flash", contextWindow: CONTEXT_GEMINI, supportsReasoningEffort: true },
-
-  { id: "gpt-5-codex", contextWindow: CONTEXT_272K },
-  { id: "gpt-5-fast", contextWindow: CONTEXT_272K },
-  { id: "gpt-5-mini", contextWindow: CONTEXT_272K },
-  { id: "gpt-5.1", contextWindow: CONTEXT_272K, supportsReasoningEffort: true },
-  { id: "gpt-5.1-codex", contextWindow: CONTEXT_272K },
-  { id: "gpt-5.1-codex-max", contextWindow: CONTEXT_272K, supportsReasoningEffort: true },
-  { id: "gpt-5.1-codex-mini", contextWindow: CONTEXT_272K, supportsReasoningEffort: true },
-  { id: "gpt-5.2", contextWindow: CONTEXT_272K, supportsReasoningEffort: true },
-  { id: "gpt-5.2-codex", contextWindow: CONTEXT_272K, supportsReasoningEffort: true },
-  { id: "gpt-5.3-codex", contextWindow: CONTEXT_272K, supportsReasoningEffort: true },
-  { id: "gpt-5.4", contextWindow: CONTEXT_272K, supportsReasoningEffort: true },
-  { id: "gpt-5.4-mini", contextWindow: CONTEXT_272K, supportsReasoningEffort: true },
-  { id: "gpt-5.4-nano", contextWindow: CONTEXT_272K, supportsReasoningEffort: true },
-  { id: "gpt-5.5", contextWindow: CONTEXT_272K, supportsReasoningEffort: true },
-  // gpt-5.5-extra: absent from cursor.com docs but SURVIVES the live GetUsableModels filter
-  // (account-verified 260709, devlog/model_update/260709_model_refresh/004_live_snapshot.md).
-  { id: "gpt-5.5-extra", contextWindow: CONTEXT_200K, supportsReasoningEffort: true },
-  { id: "gpt-5.6-sol", contextWindow: CONTEXT_1M, supportsReasoningEffort: true },
-  { id: "gpt-5.6-terra", contextWindow: CONTEXT_1M, supportsReasoningEffort: true },
-  { id: "gpt-5.6-luna", contextWindow: CONTEXT_1M, supportsReasoningEffort: true },
-
-  // 260709 refresh: stale grok/composer/kimi/gpt ids dropped per current cursor.com docs; the
-  // 260709 note: grok-4.5 was deferred; confirmed live 260708 (cursor.com/models, xAI launch).
-
-  // Conflict resolution (260709): keep the refreshed 1M context + kimi-k2.7-code from de12fc8,
-  // take PR #73's supportsReasoningEffort for glm-5.2 (its effort-map tiers landed with the PR).
-  { id: "glm-5.2", contextWindow: CONTEXT_1M, supportsReasoningEffort: true },
-  // 260814 preemptive: glm-5.3 seeded ahead of Cursor's lineup update (mirrors glm-5.2).
-  { id: "glm-5.3", contextWindow: CONTEXT_1M, supportsReasoningEffort: true },
-  { id: "kimi-k2.7-code", contextWindow: CONTEXT_262K },
-  // kimi-k3: cursor.com/docs/models/kimi-k3; account-verified via GetUsableModels (2026-07-28) —
-  // ships only as effort-suffixed kimi-k3-{low,high,max}, so the tier picker is exposed.
-  // kimi-k3 folds the old synthetic kimi-k3-1m row into the umbrella: the base
-  // is maxModeVerified (user-verified 1M on the Ultra plan, devlog 260826/025),
-  // so the ultra effort rung arms Max Mode on the wire and the separate picker
-  // row is gone. cursor/kimi-k3-1m stays routable as an alias.
-  { id: "kimi-k3", contextWindow: CONTEXT_1M, supportsReasoningEffort: true },
-
-  { id: "grok-4.5", contextWindow: 500_000, supportsReasoningEffort: true },
-  // 260813 preemptive: grok-4.6 seeded ahead of Cursor's lineup update (mirrors grok-4.5).
-  { id: "grok-4.6", contextWindow: 500_000, supportsReasoningEffort: true },
+  ...cursorUmbrellaRows().map(row => ({
+    id: row.id,
+    contextWindow: row.window,
+    supportsReasoningEffort: row.efforts.length > 0,
+  })),
+  ...CURSOR_PRODUCT_MODELS,
+  ...CURSOR_REAL_ID_EXCEPTIONS,
 ]);
 
+/** Picker labels for every seeded row, for providers.cursor.modelDisplayNames. */
+export function cursorModelDisplayNames(): Record<string, string> {
+  return Object.fromEntries([
+    ...CURSOR_ROUTER_MODEL_IDS.map(id => [id, CURSOR_ROUTER_DISPLAY_NAMES[id] ?? id] as const),
+    ...cursorUmbrellaRows().map(row => [row.id, row.displayName] as const),
+    ...CURSOR_PRODUCT_MODELS.map(model => [model.id, model.displayName] as const),
+    ...CURSOR_REAL_ID_EXCEPTIONS.map(model => [model.id, model.displayName] as const),
+  ]);
+}
+
 export function cursorModelIds(models: readonly CursorModelInfo[] = CURSOR_STATIC_MODELS): string[] {
   return normalizeCursorModels(models).map(model => model.id);
 }

package/src/adapters/cursor/effort-map.ts

@@ -23,6 +23,11 @@ const CURSOR_MODEL_EFFORT_TIERS: Record<string, readonly string[]> = {
   // max is always the top tier (canonical order: low < medium < high < xhigh < max), confirmed
   // against Anthropic's effort ladder docs and Cursor's live model lineup.
   "claude-fable-5": ["low", "medium", "high", "xhigh", "max"],
+  // 260902 preemptive: Fable 5.1 seeded ahead of Cursor's lineup update (mirrors fable-5) under
+  // the three spellings Cursor has used for Claude ids.
+  "claude-fable-5-1": ["low", "medium", "high", "xhigh", "max"],
+  "claude-fable-5.1": ["low", "medium", "high", "xhigh", "max"],
+  "claude-5.1-fable": ["low", "medium", "high", "xhigh", "max"],
   "claude-opus-4-7": ["low", "medium", "high", "xhigh", "max"],
   // Opus Fast tiers from the 260822 GetUsableModels dump (devlog .../300): the wire
   // exposes {base-without-fast}-{effort}-fast only; suffix derivation at the bottom of
@@ -49,6 +54,9 @@ const CURSOR_MODEL_EFFORT_TIERS: Record<string, readonly string[]> = {
   "claude-opus-4-7-thinking-fast": ["low", "medium", "high", "xhigh", "max"],
   "claude-sonnet-5-thinking": ["low", "medium", "high", "xhigh", "max"],
   "claude-fable-5-thinking": ["low", "medium", "high", "xhigh", "max"],
+  "claude-fable-5-1-thinking": ["low", "medium", "high", "xhigh", "max"],
+  "claude-fable-5.1-thinking": ["low", "medium", "high", "xhigh", "max"],
+  "claude-5.1-fable-thinking": ["low", "medium", "high", "xhigh", "max"],
   "claude-4.6-opus-thinking": ["high", "max"],
   "claude-4.5-opus-thinking": ["high"],
   "claude-4.6-sonnet-thinking": ["medium"],
@@ -113,6 +121,9 @@ const CURSOR_THINKING_FAMILIES: Readonly<Record<string, { source: string; order:
   "claude-opus-4-7-thinking-fast": { source: "claude-opus-4-7-fast", order: "thinking-then-effort" },
   "claude-sonnet-5-thinking": { source: "claude-sonnet-5", order: "thinking-then-effort" },
   "claude-fable-5-thinking": { source: "claude-fable-5", order: "thinking-then-effort" },
+  "claude-fable-5-1-thinking": { source: "claude-fable-5-1", order: "thinking-then-effort" },
+  "claude-fable-5.1-thinking": { source: "claude-fable-5.1", order: "thinking-then-effort" },
+  "claude-5.1-fable-thinking": { source: "claude-5.1-fable", order: "effort-then-thinking" },
   "claude-4.6-opus-thinking": { source: "claude-4.6-opus", order: "effort-then-thinking" },
   "claude-4.5-opus-thinking": { source: "claude-4.5-opus", order: "effort-then-thinking" },
   "claude-4.6-sonnet-thinking": { source: "claude-4.6-sonnet", order: "effort-then-thinking" },