feat: add GPT-5.4 support and auto-fallback for future GPT-5.x sub-versions (#13293)

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: EurFelux

src/renderer/src/config/models/__tests__/openai.test.ts

@@ -84,6 +84,34 @@ describe('OpenAI Model Detection', () => {
       })
     })
 
+    describe('should return true for future GPT-5.x sub-versions', () => {
+      it('returns true for GPT-5.4 models', () => {
+        expect(isSupportNoneReasoningEffortModel(createModel({ id: 'gpt-5.4' }))).toBe(true)
+        expect(isSupportNoneReasoningEffortModel(createModel({ id: 'gpt-5.4-mini' }))).toBe(true)
+      })
+
+      it('returns false for future GPT-5.x pro/chat variants', () => {
+        expect(isSupportNoneReasoningEffortModel(createModel({ id: 'gpt-5.4-pro' }))).toBe(false)
+        expect(isSupportNoneReasoningEffortModel(createModel({ id: 'gpt-5.4-chat' }))).toBe(false)
+      })
+
+      it('returns true for future GPT-5.x codex variants (5.3+)', () => {
+        expect(isSupportNoneReasoningEffortModel(createModel({ id: 'gpt-5.3-codex' }))).toBe(true)
+        expect(isSupportNoneReasoningEffortModel(createModel({ id: 'gpt-5.4-codex' }))).toBe(true)
+      })
+    })
+
+    describe('should return false for GPT-5.1/5.2 codex variants', () => {
+      it('returns false for GPT-5.1 codex models', () => {
+        expect(isSupportNoneReasoningEffortModel(createModel({ id: 'gpt-5.1-codex' }))).toBe(false)
+        expect(isSupportNoneReasoningEffortModel(createModel({ id: 'gpt-5.1-codex-mini' }))).toBe(false)
+      })
+
+      it('returns false for GPT-5.2 codex models', () => {
+        expect(isSupportNoneReasoningEffortModel(createModel({ id: 'gpt-5.2-codex' }))).toBe(false)
+      })
+    })
+
     describe('should return false for GPT-5 series (non-5.1/5.2)', () => {
       it('returns false for GPT-5 base model', () => {
         expect(isSupportNoneReasoningEffortModel(createModel({ id: 'gpt-5' }))).toBe(false)

src/renderer/src/config/models/__tests__/reasoning.test.ts

@@ -480,6 +480,16 @@ describe('GPT-5.1 Series Models', () => {
     it('should not support GPT-5.1 chat models', () => {
       expect(isSupportedReasoningEffortOpenAIModel(createModel({ id: 'gpt-5.1-chat' }))).toBe(false)
     })
+
+    it('should support future GPT-5.x sub-version models', () => {
+      expect(isSupportedReasoningEffortOpenAIModel(createModel({ id: 'gpt-5.4' }))).toBe(true)
+      expect(isSupportedReasoningEffortOpenAIModel(createModel({ id: 'gpt-5.4-mini' }))).toBe(true)
+      expect(isSupportedReasoningEffortOpenAIModel(createModel({ id: 'gpt-5.9' }))).toBe(true)
+    })
+
+    it('should not support future GPT-5.x chat models', () => {
+      expect(isSupportedReasoningEffortOpenAIModel(createModel({ id: 'gpt-5.4-chat' }))).toBe(false)
+    })
   })
 
   describe('isOpenAIReasoningModel', () => {
@@ -630,9 +640,13 @@ describe('Thinking model classification', () => {
 })
 
 describe('Reasoning option configuration', () => {
-  it('allows GPT-5.1 series models to disable reasoning', () => {
+  it('allows GPT-5.1 base models to disable reasoning', () => {
     expect(MODEL_SUPPORTED_OPTIONS.gpt5_1).toContain('none')
-    expect(MODEL_SUPPORTED_OPTIONS.gpt5_1_codex).toContain('none')
+  })
+
+  it('does not allow GPT-5.1 codex models to disable reasoning', () => {
+    expect(MODEL_SUPPORTED_OPTIONS.gpt5_1_codex).not.toContain('none')
+    expect(MODEL_SUPPORTED_OPTIONS.gpt5_1_codex_max).not.toContain('none')
   })
 
   it('restricts GPT-5 Pro reasoning to high effort only', () => {
@@ -663,7 +677,46 @@ describe('getThinkModelType - Comprehensive Coverage', () => {
     })
   })
 
-  describe('GPT-5 series models', () => {
+  describe('GPT-5.2 series models', () => {
+    it('should return gpt5_2 for GPT-5.2 models', () => {
+      expect(getThinkModelType(createModel({ id: 'gpt-5.2' }))).toBe('gpt5_2')
+      expect(getThinkModelType(createModel({ id: 'gpt-5.2-preview' }))).toBe('gpt5_2')
+      expect(getThinkModelType(createModel({ id: 'gpt-5.2-mini' }))).toBe('gpt5_2')
+    })
+
+    it('should return gpt52pro for GPT-5.2 Pro models', () => {
+      expect(getThinkModelType(createModel({ id: 'gpt-5.2-pro' }))).toBe('gpt52pro')
+      expect(getThinkModelType(createModel({ id: 'gpt-5.2-pro-preview' }))).toBe('gpt52pro')
+    })
+
+    it('should return gpt5_2_codex for GPT-5.2 codex models', () => {
+      expect(getThinkModelType(createModel({ id: 'gpt-5.2-codex' }))).toBe('gpt5_2_codex')
+      expect(getThinkModelType(createModel({ id: 'gpt-5.2-codex-mini' }))).toBe('gpt5_2_codex')
+    })
+  })
+
+  describe('GPT-5.x future sub-version fallback', () => {
+    it('should return gpt5_2 for future GPT-5.x models', () => {
+      expect(getThinkModelType(createModel({ id: 'gpt-5.3' }))).toBe('gpt5_2')
+      expect(getThinkModelType(createModel({ id: 'gpt-5.4' }))).toBe('gpt5_2')
+      expect(getThinkModelType(createModel({ id: 'gpt-5.4-mini' }))).toBe('gpt5_2')
+      expect(getThinkModelType(createModel({ id: 'gpt-5.9' }))).toBe('gpt5_2')
+    })
+
+    it('should return gpt5_2 for future GPT-5.x codex models (5.3+, supports none)', () => {
+      expect(getThinkModelType(createModel({ id: 'gpt-5.3-codex' }))).toBe('gpt5_2')
+      expect(getThinkModelType(createModel({ id: 'gpt-5.4-codex' }))).toBe('gpt5_2')
+    })
+
+    it('should return gpt52pro for future GPT-5.x Pro models', () => {
+      expect(getThinkModelType(createModel({ id: 'gpt-5.3-pro' }))).toBe('gpt52pro')
+      expect(getThinkModelType(createModel({ id: 'gpt-5.4-pro' }))).toBe('gpt52pro')
+      expect(getThinkModelType(createModel({ id: 'gpt-5.4-pro-preview' }))).toBe('gpt52pro')
+      expect(getThinkModelType(createModel({ id: 'gpt-5.9-pro' }))).toBe('gpt52pro')
+    })
+  })
+
+  describe('GPT-5 base series models', () => {
     it('should return gpt5_codex for GPT-5 codex models', () => {
       expect(getThinkModelType(createModel({ id: 'gpt-5-codex' }))).toBe('gpt5_codex')
       expect(getThinkModelType(createModel({ id: 'gpt-5-codex-mini' }))).toBe('gpt5_codex')
@@ -1895,13 +1948,11 @@ describe('getModelSupportedReasoningEffortOptions', () => {
     it('should return correct options for GPT-5.1 Codex models', () => {
       expect(getModelSupportedReasoningEffortOptions(createModel({ id: 'gpt-5.1-codex' }))).toEqual([
         'default',
-        'none',
         'medium',
         'high'
       ])
       expect(getModelSupportedReasoningEffortOptions(createModel({ id: 'gpt-5.1-codex-mini' }))).toEqual([
         'default',
-        'none',
         'medium',
         'high'
       ])

src/renderer/src/config/models/__tests__/utils.test.ts

@@ -3,6 +3,7 @@ import type { Model } from '@renderer/types'
 import { beforeEach, describe, expect, it, vi } from 'vitest'
 
 import {
+  isGPT5FamilyModel,
   isGPT5ProModel,
   isGPT5SeriesModel,
   isGPT5SeriesReasoningModel,
@@ -175,13 +176,46 @@ describe('model utils', () => {
   })
 
   describe('GPT-5 family detection', () => {
+    describe('isGPT5FamilyModel', () => {
+      it('returns true for GPT-5 base models', () => {
+        expect(isGPT5FamilyModel(createModel({ id: 'gpt-5' }))).toBe(true)
+        expect(isGPT5FamilyModel(createModel({ id: 'gpt-5-preview' }))).toBe(true)
+        expect(isGPT5FamilyModel(createModel({ id: 'gpt-5-pro' }))).toBe(true)
+        expect(isGPT5FamilyModel(createModel({ id: 'gpt-5-chat' }))).toBe(true)
+      })
+
+      it('returns true for GPT-5.x sub-version models', () => {
+        expect(isGPT5FamilyModel(createModel({ id: 'gpt-5.1' }))).toBe(true)
+        expect(isGPT5FamilyModel(createModel({ id: 'gpt-5.1-mini' }))).toBe(true)
+        expect(isGPT5FamilyModel(createModel({ id: 'gpt-5.2-pro' }))).toBe(true)
+        expect(isGPT5FamilyModel(createModel({ id: 'gpt-5.4' }))).toBe(true)
+      })
+
+      it('returns false for non-GPT-5 models', () => {
+        expect(isGPT5FamilyModel(createModel({ id: 'gpt-4o' }))).toBe(false)
+        expect(isGPT5FamilyModel(createModel({ id: 'gpt-4.1' }))).toBe(false)
+        expect(isGPT5FamilyModel(createModel({ id: 'claude-3.5' }))).toBe(false)
+        expect(isGPT5FamilyModel(createModel({ id: 'o3-mini' }))).toBe(false)
+      })
+    })
+
     describe('isGPT5SeriesModel', () => {
-      it('returns true for GPT-5 models', () => {
+      it('returns true for GPT-5 base models', () => {
+        expect(isGPT5SeriesModel(createModel({ id: 'gpt-5' }))).toBe(true)
         expect(isGPT5SeriesModel(createModel({ id: 'gpt-5-preview' }))).toBe(true)
+        expect(isGPT5SeriesModel(createModel({ id: 'gpt-5-pro' }))).toBe(true)
       })
 
-      it('returns false for GPT-5.1 models', () => {
+      it('returns false for GPT-5.x sub-version models', () => {
         expect(isGPT5SeriesModel(createModel({ id: 'gpt-5.1-preview' }))).toBe(false)
+        expect(isGPT5SeriesModel(createModel({ id: 'gpt-5.2' }))).toBe(false)
+        expect(isGPT5SeriesModel(createModel({ id: 'gpt-5.4' }))).toBe(false)
+        expect(isGPT5SeriesModel(createModel({ id: 'gpt-5.9-turbo' }))).toBe(false)
+      })
+
+      it('returns false for non-GPT-5 models', () => {
+        expect(isGPT5SeriesModel(createModel({ id: 'gpt-4o' }))).toBe(false)
+        expect(isGPT5SeriesModel(createModel({ id: 'gpt-4.1' }))).toBe(false)
       })
     })
 
@@ -217,33 +251,65 @@ describe('model utils', () => {
         expect(isSupportVerbosityModel(createModel({ id: 'gpt-5' }))).toBe(true)
       })
 
-      it('returns false for GPT-5 chat models', () => {
-        expect(isSupportVerbosityModel(createModel({ id: 'gpt-5-chat' }))).toBe(false)
+      it('returns true for GPT-5.x sub-version models', () => {
+        expect(isSupportVerbosityModel(createModel({ id: 'gpt-5.1-preview' }))).toBe(true)
+        expect(isSupportVerbosityModel(createModel({ id: 'gpt-5.2' }))).toBe(true)
+        expect(isSupportVerbosityModel(createModel({ id: 'gpt-5.4' }))).toBe(true)
+      })
+
+      it('returns true for GPT-5 chat and codex models (granular exclusion handled by validators)', () => {
+        expect(isSupportVerbosityModel(createModel({ id: 'gpt-5-chat' }))).toBe(true)
+        expect(isSupportVerbosityModel(createModel({ id: 'gpt-5.1-chat' }))).toBe(true)
+        expect(isSupportVerbosityModel(createModel({ id: 'gpt-5.1-codex' }))).toBe(true)
       })
 
-      it('returns true for GPT-5.1 models', () => {
-        expect(isSupportVerbosityModel(createModel({ id: 'gpt-5.1-preview' }))).toBe(true)
+      it('returns false for non-GPT-5 models', () => {
+        expect(isSupportVerbosityModel(createModel({ id: 'gpt-4o' }))).toBe(false)
       })
     })
 
     describe('getModelSupportedVerbosity', () => {
-      it('returns only "high" for GPT-5 Pro models', () => {
-        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5-pro' }))).toEqual([undefined, null, 'high'])
-        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5-pro-2025-10-06' }))).toEqual([
-          undefined,
-          null,
-          'high'
-        ])
+      const allLevels = [undefined, null, 'low', 'medium', 'high']
+      const mediumOnly = [undefined, null, 'medium']
+
+      it('GPT-5 models', () => {
+        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5' }))).toEqual(allLevels)
+        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5-mini' }))).toEqual(allLevels)
+        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5-nano' }))).toEqual(allLevels)
+        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5-pro' }))).toEqual(allLevels)
+        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5-chat' }))).toEqual(mediumOnly)
+      })
+
+      it('GPT-5.1 models', () => {
+        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5.1' }))).toEqual(allLevels)
+        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5.1-chat-latest' }))).toEqual(mediumOnly)
+        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5.1-codex' }))).toEqual(mediumOnly)
+        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5.1-codex-mini' }))).toEqual(mediumOnly)
+        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5.1-codex-max' }))).toEqual(mediumOnly)
+      })
+
+      it('GPT-5.2 models', () => {
+        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5.2' }))).toEqual(allLevels)
+        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5.2-pro' }))).toEqual(allLevels)
+        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5.2-codex' }))).toEqual(mediumOnly)
+        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5.2-chat-latest' }))).toEqual(mediumOnly)
+      })
+
+      it('GPT-5.3 models', () => {
+        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5.3-codex' }))).toEqual(allLevels)
+        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5.3-chat-latest' }))).toEqual(mediumOnly)
       })
 
-      it('returns all levels for non-Pro GPT-5 models', () => {
-        const previewModel = createModel({ id: 'gpt-5-preview' })
-        expect(getModelSupportedVerbosity(previewModel)).toEqual([undefined, null, 'low', 'medium', 'high'])
+      it('GPT-5.4 models', () => {
+        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5.4' }))).toEqual(allLevels)
+        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5.4-pro' }))).toEqual(allLevels)
       })
 
-      it('returns all levels for GPT-5.1 models', () => {
-        const gpt51Model = createModel({ id: 'gpt-5.1-preview' })
-        expect(getModelSupportedVerbosity(gpt51Model)).toEqual([undefined, null, 'low', 'medium', 'high'])
+      it('future GPT-5.5+ models fallback correctly', () => {
+        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5.5' }))).toEqual(allLevels)
+        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5.5-pro' }))).toEqual(allLevels)
+        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5.5-codex' }))).toEqual(allLevels)
+        expect(getModelSupportedVerbosity(createModel({ id: 'gpt-5.5-chat-latest' }))).toEqual(mediumOnly)
       })
 
       it('returns only undefined for non-GPT-5 models', () => {

src/renderer/src/config/models/default.ts

@@ -238,7 +238,6 @@ export const SYSTEM_MODELS: Record<SystemProviderId | 'defaultModel', Model[]> =
       group: 'llama'
     }
   ],
-
   burncloud: [
     { id: 'claude-opus-4-5-20251101', provider: 'burncloud', name: 'Claude 4.5 Opus', group: 'Claude 4.5' },
     { id: 'claude-sonnet-4-5-20250929', provider: 'burncloud', name: 'Claude 4.5 Sonnet', group: 'Claude 4.5' },
@@ -318,13 +317,15 @@ export const SYSTEM_MODELS: Record<SystemProviderId | 'defaultModel', Model[]> =
   ],
   alayanew: [],
   openai: [
-    { id: 'gpt-5.1', provider: 'openai', name: ' GPT 5.1', group: 'GPT 5.1' },
-    { id: 'gpt-5', provider: 'openai', name: ' GPT 5', group: 'GPT 5' },
-    { id: 'gpt-5-mini', provider: 'openai', name: ' GPT 5 Mini', group: 'GPT 5' },
-    { id: 'gpt-5-nano', provider: 'openai', name: ' GPT 5 Nano', group: 'GPT 5' },
-    { id: 'gpt-5-pro', provider: 'openai', name: ' GPT 5 Pro', group: 'GPT 5' },
-    { id: 'gpt-5-chat', provider: 'openai', name: ' GPT 5 Chat', group: 'GPT 5' },
-    { id: 'gpt-image-1', provider: 'openai', name: ' GPT Image 1', group: 'GPT Image' }
+    { id: 'gpt-5.4', provider: 'openai', name: ' GPT 5.4', group: 'gpt-5.4' },
+    { id: 'gpt-5.4-pro', provider: 'openai', name: ' GPT 5.4 Pro', group: 'gpt-5.4' },
+    { id: 'gpt-5.2', provider: 'openai', name: ' GPT 5.2', group: 'gpt-5.2' },
+    { id: 'gpt-5.2-pro', provider: 'openai', name: ' GPT 5.2 Pro', group: 'gpt-5.2' },
+    { id: 'gpt-5.1', provider: 'openai', name: ' GPT 5.1', group: 'gpt-5.1' },
+    { id: 'gpt-5', provider: 'openai', name: ' GPT 5', group: 'gpt-5' },
+    { id: 'gpt-5-pro', provider: 'openai', name: ' GPT 5 Pro', group: 'gpt-5' },
+    { id: 'gpt-5-chat', provider: 'openai', name: ' GPT 5 Chat', group: 'gpt-5' },
+    { id: 'gpt-image-1', provider: 'openai', name: ' GPT Image 1', group: 'gpt-image' }
   ],
   'azure-openai': [
     {

src/renderer/src/config/models/openai.ts

@@ -50,16 +50,28 @@ export const isOpenAIOpenWeightModel = (model: Model) => {
   return modelId.includes('gpt-oss')
 }
 
+/**
+ * Checks if a model belongs to the GPT-5 base series (e.g. gpt-5, gpt-5-pro).
+ * Uses negative lookahead to exclude sub-versions like gpt-5.1, gpt-5.2, etc.
+ */
 export const isGPT5SeriesModel = (model: Model) => {
   const modelId = getLowerBaseModelName(model.id)
-  return modelId.includes('gpt-5') && !modelId.includes('gpt-5.1') && !modelId.includes('gpt-5.2')
+  return /gpt-5(?!\.\d)/.test(modelId)
 }
 
 export const isGPT5SeriesReasoningModel = (model: Model) => {
   const modelId = getLowerBaseModelName(model.id)
   return isGPT5SeriesModel(model) && !modelId.includes('chat')
 }
 
+/**
+ * Checks if a model belongs to the GPT-5 family (gpt-5, gpt-5.1, gpt-5.2, etc.).
+ */
+export const isGPT5FamilyModel = (model: Model) => {
+  const modelId = getLowerBaseModelName(model.id)
+  return modelId.includes('gpt-5')
+}
+
 export const isGPT51SeriesModel = (model: Model) => {
   const modelId = getLowerBaseModelName(model.id)
   return modelId.includes('gpt-5.1')
@@ -70,18 +82,14 @@ export const isGPT52SeriesModel = (model: Model) => {
   return modelId.includes('gpt-5.2')
 }
 
-export function isSupportVerbosityModel(model: Model): boolean {
-  const modelId = getLowerBaseModelName(model.id)
-  return (
-    (isGPT5SeriesModel(model) || isGPT51SeriesModel(model) || isGPT52SeriesModel(model)) && !modelId.includes('chat')
-  )
-}
+export const isSupportVerbosityModel = isGPT5FamilyModel
 
 /**
  * Determines if a model supports the "none" reasoning effort parameter.
  *
- * This applies to GPT-5.1 and GPT-5.2 series reasoning models (non-chat, non-pro variants).
+ * This applies to GPT-5.x sub-version models (non-chat, non-pro variants).
  * These models allow setting reasoning_effort to "none" to skip reasoning steps.
+ * Codex variants are supported from GPT-5.3 onwards; GPT-5.1/5.2 codex models are excluded.
  *
  * @param model - The model to check
  * @returns true if the model supports "none" reasoning effort, false otherwise
@@ -91,17 +99,24 @@ export function isSupportVerbosityModel(model: Model): boolean {
  * // Returns true
  * isSupportNoneReasoningEffortModel({ id: 'gpt-5.1', provider: 'openai' })
  * isSupportNoneReasoningEffortModel({ id: 'gpt-5.2-mini', provider: 'openai' })
+ * isSupportNoneReasoningEffortModel({ id: 'gpt-5.3-codex', provider: 'openai' })
  *
  * // Returns false
  * isSupportNoneReasoningEffortModel({ id: 'gpt-5.1-pro', provider: 'openai' })
- * isSupportNoneReasoningEffortModel({ id: 'gpt-5.1-chat', provider: 'openai' })
+ * isSupportNoneReasoningEffortModel({ id: 'gpt-5.1-codex', provider: 'openai' })
  * isSupportNoneReasoningEffortModel({ id: 'gpt-5-pro', provider: 'openai' })
  * ```
  */
 export function isSupportNoneReasoningEffortModel(model: Model): boolean {
   const modelId = getLowerBaseModelName(model.id)
+  const isCodex = modelId.includes('codex')
+  const isOldCodex = isCodex && (isGPT51SeriesModel(model) || isGPT52SeriesModel(model))
   return (
-    (isGPT51SeriesModel(model) || isGPT52SeriesModel(model)) && !modelId.includes('chat') && !modelId.includes('pro')
+    isGPT5FamilyModel(model) &&
+    !isGPT5SeriesModel(model) &&
+    !modelId.includes('chat') &&
+    !modelId.includes('pro') &&
+    !isOldCodex
   )
 }
 
@@ -131,7 +146,7 @@ export function isSupportedReasoningEffortOpenAIModel(model: Model): boolean {
     modelId.includes('o3') ||
     modelId.includes('o4') ||
     modelId.includes('gpt-oss') ||
-    ((isGPT5SeriesModel(model) || isGPT51SeriesModel(model) || isGPT52SeriesModel(model)) && !modelId.includes('chat'))
+    (isGPT5FamilyModel(model) && !modelId.includes('chat'))
   )
 }