refactor(env): modernize model configuration environment variables

This PR refactors the model configuration system with improved naming conventions
and better type safety while maintaining backward compatibility.

Key Changes:

1. Environment Variable Naming Convention Updates:
   - Renamed OPENAI_* → MODEL_* for public API variables
     * OPENAI_API_KEY → MODEL_API_KEY (deprecated, backward compatible)
     * OPENAI_BASE_URL → MODEL_BASE_URL (deprecated, backward compatible)
   - Renamed MIDSCENE_*_VL_MODE → MIDSCENE_*_LOCATOR_MODE across all intents
     * MIDSCENE_VL_MODE → MIDSCENE_LOCATOR_MODE
     * MIDSCENE_VQA_VL_MODE → MIDSCENE_VQA_LOCATOR_MODE
     * MIDSCENE_PLANNING_VL_MODE → MIDSCENE_PLANNING_LOCATOR_MODE
     * MIDSCENE_GROUNDING_VL_MODE → MIDSCENE_GROUNDING_LOCATOR_MODE
   - Updated all internal MIDSCENE_*_OPENAI_* → MIDSCENE_*_MODEL_*
     * MIDSCENE_VQA_OPENAI_API_KEY → MIDSCENE_VQA_MODEL_API_KEY
     * MIDSCENE_PLANNING_OPENAI_API_KEY → MIDSCENE_PLANNING_MODEL_API_KEY
     * MIDSCENE_GROUNDING_OPENAI_API_KEY → MIDSCENE_GROUNDING_MODEL_API_KEY
     * (and corresponding BASE_URL variables)

2. Type System Improvements:
   - Split TModelConfigFn into public and internal types
   - Public API (TModelConfigFn) no longer exposes 'intent' parameter
   - Internal type (TModelConfigFnInternal) maintains intent parameter
   - Users can still optionally use intent parameter via type casting

3. Backward Compatibility:
   - Maintained compatibility for documented public variables (OPENAI_API_KEY, OPENAI_BASE_URL)
   - New variables take precedence, fallback to legacy names if not set
   - Only public documented variables are deprecated, internal variables renamed directly

4. Updated Files:
   - packages/shared/src/env/types.ts - Type definitions and constants
   - packages/shared/src/env/constants.ts - Config key mappings
   - packages/shared/src/env/decide-model-config.ts - Compatibility logic
   - packages/shared/src/env/model-config-manager.ts - Type casting implementation
   - packages/shared/src/env/init-debug.ts - Debug variable updates
   - All test files updated to use new variable names

Testing:
- All 24 model-config-manager tests passing
- Overall test suite: 241 tests passing

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: quanru

packages/android/tests/unit-test/agent.test.ts

@@ -24,9 +24,9 @@ vi.mock('../../src/utils');
 
 const mockedModelConfigFnResult = {
   MIDSCENE_MODEL_NAME: 'mock',
-  MIDSCENE_OPENAI_API_KEY: 'mock',
-  MIDSCENE_OPENAI_BASE_URL: 'mock',
-  MIDSCENE_VL_MODE: 'doubao-vision',
+  MIDSCENE_MODEL_API_KEY: 'mock',
+  MIDSCENE_MODEL_BASE_URL: 'mock',
+  MIDSCENE_LOCATOR_MODE: 'doubao-vision',
 } as const;
 
 describe('AndroidAgent', () => {

packages/core/tests/unit-test/agent-custom-client.test.ts

@@ -1,13 +1,13 @@
 import { Agent } from '@/agent';
 import type { CreateOpenAIClientFn } from '@midscene/shared/env';
 import {
+  MIDSCENE_MODEL_API_KEY,
+  MIDSCENE_MODEL_BASE_URL,
   MIDSCENE_MODEL_NAME,
-  MIDSCENE_OPENAI_API_KEY,
-  MIDSCENE_OPENAI_BASE_URL,
+  MIDSCENE_PLANNING_LOCATOR_MODE,
+  MIDSCENE_PLANNING_MODEL_API_KEY,
+  MIDSCENE_PLANNING_MODEL_BASE_URL,
   MIDSCENE_PLANNING_MODEL_NAME,
-  MIDSCENE_PLANNING_OPENAI_API_KEY,
-  MIDSCENE_PLANNING_OPENAI_BASE_URL,
-  MIDSCENE_PLANNING_VL_MODE,
 } from '@midscene/shared/env';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
@@ -32,8 +32,8 @@ describe('Agent with custom OpenAI client', () => {
       const agent = new Agent(mockInterface, {
         modelConfig: ({ intent }) => ({
           [MIDSCENE_MODEL_NAME]: 'gpt-4o',
-          [MIDSCENE_OPENAI_API_KEY]: 'test-key',
-          [MIDSCENE_OPENAI_BASE_URL]: 'https://api.openai.com/v1',
+          [MIDSCENE_MODEL_API_KEY]: 'test-key',
+          [MIDSCENE_MODEL_BASE_URL]: 'https://api.openai.com/v1',
         }),
         createOpenAIClient: mockCreateClient,
       });
@@ -53,8 +53,8 @@ describe('Agent with custom OpenAI client', () => {
       const agent = new Agent(mockInterface, {
         modelConfig: ({ intent }) => ({
           [MIDSCENE_MODEL_NAME]: 'gpt-4o',
-          [MIDSCENE_OPENAI_API_KEY]: 'test-key',
-          [MIDSCENE_OPENAI_BASE_URL]: 'https://api.openai.com/v1',
+          [MIDSCENE_MODEL_API_KEY]: 'test-key',
+          [MIDSCENE_MODEL_BASE_URL]: 'https://api.openai.com/v1',
         }),
         createOpenAIClient: mockCreateClient,
       });
@@ -73,8 +73,8 @@ describe('Agent with custom OpenAI client', () => {
       const agent = new Agent(mockInterface, {
         modelConfig: ({ intent }) => ({
           [MIDSCENE_MODEL_NAME]: 'gpt-4o',
-          [MIDSCENE_OPENAI_API_KEY]: 'test-key',
-          [MIDSCENE_OPENAI_BASE_URL]: 'https://api.openai.com/v1',
+          [MIDSCENE_MODEL_API_KEY]: 'test-key',
+          [MIDSCENE_MODEL_BASE_URL]: 'https://api.openai.com/v1',
         }),
       });
 
@@ -108,16 +108,15 @@ describe('Agent with custom OpenAI client', () => {
             case 'planning':
               return {
                 [MIDSCENE_PLANNING_MODEL_NAME]: 'qwen-vl-plus',
-                [MIDSCENE_PLANNING_OPENAI_API_KEY]: 'test-planning-key',
-                [MIDSCENE_PLANNING_OPENAI_BASE_URL]:
-                  'https://api.openai.com/v1',
-                [MIDSCENE_PLANNING_VL_MODE]: 'qwen-vl' as const,
+                [MIDSCENE_PLANNING_MODEL_API_KEY]: 'test-planning-key',
+                [MIDSCENE_PLANNING_MODEL_BASE_URL]: 'https://api.openai.com/v1',
+                [MIDSCENE_PLANNING_LOCATOR_MODE]: 'qwen-vl' as const,
               };
             default:
               return {
                 [MIDSCENE_MODEL_NAME]: 'gpt-4o',
-                [MIDSCENE_OPENAI_API_KEY]: 'test-key',
-                [MIDSCENE_OPENAI_BASE_URL]: 'https://api.openai.com/v1',
+                [MIDSCENE_MODEL_API_KEY]: 'test-key',
+                [MIDSCENE_MODEL_BASE_URL]: 'https://api.openai.com/v1',
               };
           }
         },
@@ -170,15 +169,15 @@ describe('Agent with custom OpenAI client', () => {
           if (intent === 'planning') {
             return {
               [MIDSCENE_PLANNING_MODEL_NAME]: 'qwen-vl-plus',
-              [MIDSCENE_PLANNING_OPENAI_API_KEY]: 'test-key',
-              [MIDSCENE_PLANNING_OPENAI_BASE_URL]: 'https://api.openai.com/v1',
-              [MIDSCENE_PLANNING_VL_MODE]: 'qwen-vl' as const,
+              [MIDSCENE_PLANNING_MODEL_API_KEY]: 'test-key',
+              [MIDSCENE_PLANNING_MODEL_BASE_URL]: 'https://api.openai.com/v1',
+              [MIDSCENE_PLANNING_LOCATOR_MODE]: 'qwen-vl' as const,
             };
           }
           return {
             [MIDSCENE_MODEL_NAME]: 'gpt-4o',
-            [MIDSCENE_OPENAI_API_KEY]: 'test-key',
-            [MIDSCENE_OPENAI_BASE_URL]: 'https://api.openai.com/v1',
+            [MIDSCENE_MODEL_API_KEY]: 'test-key',
+            [MIDSCENE_MODEL_BASE_URL]: 'https://api.openai.com/v1',
           };
         },
         createOpenAIClient: mockCreateClient,
@@ -226,8 +225,8 @@ describe('Agent with custom OpenAI client', () => {
       const agent = new Agent(mockInterface, {
         modelConfig: ({ intent }) => ({
           [MIDSCENE_MODEL_NAME]: 'gpt-4o',
-          [MIDSCENE_OPENAI_API_KEY]: 'test-api-key',
-          [MIDSCENE_OPENAI_BASE_URL]: 'https://custom.openai.com/v1',
+          [MIDSCENE_MODEL_API_KEY]: 'test-api-key',
+          [MIDSCENE_MODEL_BASE_URL]: 'https://custom.openai.com/v1',
         }),
         createOpenAIClient: mockCreateClient,
       });
@@ -275,8 +274,8 @@ describe('Agent with custom OpenAI client', () => {
       const agent = new Agent(mockInterface, {
         modelConfig: ({ intent }) => ({
           [MIDSCENE_MODEL_NAME]: 'gpt-4o',
-          [MIDSCENE_OPENAI_API_KEY]: 'test-key',
-          [MIDSCENE_OPENAI_BASE_URL]: 'https://api.openai.com/v1',
+          [MIDSCENE_MODEL_API_KEY]: 'test-key',
+          [MIDSCENE_MODEL_BASE_URL]: 'https://api.openai.com/v1',
         }),
         createOpenAIClient: mockCreateClient,
       });

packages/core/tests/unit-test/proxy-integration.test.ts

@@ -315,15 +315,15 @@ describe('proxy integration', () => {
   });
 
   describe('environment variable integration', () => {
-    it('should work with MIDSCENE_OPENAI_HTTP_PROXY environment variable', () => {
+    it('should work with MIDSCENE_MODEL_HTTP_PROXY environment variable', () => {
       const proxyUrl = 'http://127.0.0.1:8080';
 
       // This would typically come from environment variables via globalConfigManager
       const mockModelConfig: IModelConfig = {
         modelName: 'gpt-4o',
         openaiApiKey: 'test-key',
         openaiBaseURL: 'https://api.openai.com/v1',
-        httpProxy: proxyUrl, // Would be populated from MIDSCENE_OPENAI_HTTP_PROXY
+        httpProxy: proxyUrl, // Would be populated from MIDSCENE_MODEL_HTTP_PROXY
         modelDescription: 'test',
         intent: 'default',
         from: 'env',
@@ -332,15 +332,15 @@ describe('proxy integration', () => {
       expect(mockModelConfig.httpProxy).toBe(proxyUrl);
     });
 
-    it('should work with MIDSCENE_OPENAI_SOCKS_PROXY environment variable', () => {
+    it('should work with MIDSCENE_MODEL_SOCKS_PROXY environment variable', () => {
       const proxyUrl = 'socks5://127.0.0.1:1080';
 
       // This would typically come from environment variables via globalConfigManager
       const mockModelConfig: IModelConfig = {
         modelName: 'gpt-4o',
         openaiApiKey: 'test-key',
         openaiBaseURL: 'https://api.openai.com/v1',
-        socksProxy: proxyUrl, // Would be populated from MIDSCENE_OPENAI_SOCKS_PROXY
+        socksProxy: proxyUrl, // Would be populated from MIDSCENE_MODEL_SOCKS_PROXY
         modelDescription: 'test',
         intent: 'default',
         from: 'env',
@@ -356,7 +356,7 @@ describe('proxy integration', () => {
         modelName: 'gpt-4o',
         openaiApiKey: 'test-key',
         openaiBaseURL: 'https://api.openai.com/v1',
-        httpProxy: proxyUrl, // Would be populated from MIDSCENE_VQA_OPENAI_HTTP_PROXY
+        httpProxy: proxyUrl, // Would be populated from MIDSCENE_VQA_MODEL_HTTP_PROXY
         modelDescription: 'test',
         intent: 'VQA',
         from: 'env',
@@ -373,7 +373,7 @@ describe('proxy integration', () => {
         modelName: 'gpt-4o',
         openaiApiKey: 'test-key',
         openaiBaseURL: 'https://api.openai.com/v1',
-        socksProxy: proxyUrl, // Would be populated from MIDSCENE_PLANNING_OPENAI_SOCKS_PROXY
+        socksProxy: proxyUrl, // Would be populated from MIDSCENE_PLANNING_MODEL_SOCKS_PROXY
         modelDescription: 'test',
         intent: 'planning',
         from: 'env',
@@ -390,7 +390,7 @@ describe('proxy integration', () => {
         modelName: 'gpt-4o',
         openaiApiKey: 'test-key',
         openaiBaseURL: 'https://api.openai.com/v1',
-        httpProxy: proxyUrl, // Would be populated from MIDSCENE_GROUNDING_OPENAI_HTTP_PROXY
+        httpProxy: proxyUrl, // Would be populated from MIDSCENE_GROUNDING_MODEL_HTTP_PROXY
         modelDescription: 'test',
         intent: 'grounding',
         from: 'env',

packages/core/tests/unit-test/vl-model-check.test.ts

@@ -27,8 +27,8 @@ vi.mock('@midscene/core', async () => {
 
 const mockedModelConfigFnResult = {
   MIDSCENE_MODEL_NAME: 'gpt-4o',
-  MIDSCENE_OPENAI_API_KEY: 'mock-api-key',
-  MIDSCENE_OPENAI_BASE_URL: 'mock-base-url',
+  MIDSCENE_MODEL_API_KEY: 'mock-api-key',
+  MIDSCENE_MODEL_BASE_URL: 'mock-base-url',
 };
 
 describe('VL Model Check for Different Interface Types', () => {
@@ -133,9 +133,9 @@ describe('VL Model Check for Different Interface Types', () => {
 
     const modelConfigWithVL = {
       MIDSCENE_MODEL_NAME: 'gemini-2.0-flash-exp',
-      MIDSCENE_OPENAI_API_KEY: 'mock-api-key',
-      MIDSCENE_OPENAI_BASE_URL: 'mock-base-url',
-      MIDSCENE_VL_MODE: 'gemini',
+      MIDSCENE_MODEL_API_KEY: 'mock-api-key',
+      MIDSCENE_MODEL_BASE_URL: 'mock-base-url',
+      MIDSCENE_LOCATOR_MODE: 'gemini',
     };
 
     expect(() => {

packages/shared/src/env/constants.ts

@@ -1,33 +1,35 @@
 import {
+  MIDSCENE_GROUNDING_LOCATOR_MODE,
+  MIDSCENE_GROUNDING_MODEL_API_KEY,
+  MIDSCENE_GROUNDING_MODEL_BASE_URL,
+  MIDSCENE_GROUNDING_MODEL_HTTP_PROXY,
+  MIDSCENE_GROUNDING_MODEL_INIT_CONFIG_JSON,
   MIDSCENE_GROUNDING_MODEL_NAME,
-  MIDSCENE_GROUNDING_OPENAI_API_KEY,
-  MIDSCENE_GROUNDING_OPENAI_BASE_URL,
-  MIDSCENE_GROUNDING_OPENAI_HTTP_PROXY,
-  MIDSCENE_GROUNDING_OPENAI_INIT_CONFIG_JSON,
-  MIDSCENE_GROUNDING_OPENAI_SOCKS_PROXY,
-  MIDSCENE_GROUNDING_VL_MODE,
+  MIDSCENE_GROUNDING_MODEL_SOCKS_PROXY,
+  MIDSCENE_LOCATOR_MODE,
+  MIDSCENE_MODEL_API_KEY,
+  MIDSCENE_MODEL_BASE_URL,
+  MIDSCENE_MODEL_HTTP_PROXY,
+  MIDSCENE_MODEL_INIT_CONFIG_JSON,
   MIDSCENE_MODEL_NAME,
-  MIDSCENE_OPENAI_API_KEY,
-  MIDSCENE_OPENAI_BASE_URL,
-  MIDSCENE_OPENAI_HTTP_PROXY,
-  MIDSCENE_OPENAI_INIT_CONFIG_JSON,
-  MIDSCENE_OPENAI_SOCKS_PROXY,
+  MIDSCENE_MODEL_SOCKS_PROXY,
+  MIDSCENE_PLANNING_LOCATOR_MODE,
+  MIDSCENE_PLANNING_MODEL_API_KEY,
+  MIDSCENE_PLANNING_MODEL_BASE_URL,
+  MIDSCENE_PLANNING_MODEL_HTTP_PROXY,
+  MIDSCENE_PLANNING_MODEL_INIT_CONFIG_JSON,
   MIDSCENE_PLANNING_MODEL_NAME,
-  MIDSCENE_PLANNING_OPENAI_API_KEY,
-  MIDSCENE_PLANNING_OPENAI_BASE_URL,
-  MIDSCENE_PLANNING_OPENAI_HTTP_PROXY,
-  MIDSCENE_PLANNING_OPENAI_INIT_CONFIG_JSON,
-  MIDSCENE_PLANNING_OPENAI_SOCKS_PROXY,
-  MIDSCENE_PLANNING_VL_MODE,
-  MIDSCENE_VL_MODE,
+  MIDSCENE_PLANNING_MODEL_SOCKS_PROXY,
+  MIDSCENE_VQA_LOCATOR_MODE,
+  MIDSCENE_VQA_MODEL_API_KEY,
+  MIDSCENE_VQA_MODEL_BASE_URL,
+  MIDSCENE_VQA_MODEL_HTTP_PROXY,
+  MIDSCENE_VQA_MODEL_INIT_CONFIG_JSON,
   // VQA
   MIDSCENE_VQA_MODEL_NAME,
-  MIDSCENE_VQA_OPENAI_API_KEY,
-  MIDSCENE_VQA_OPENAI_BASE_URL,
-  MIDSCENE_VQA_OPENAI_HTTP_PROXY,
-  MIDSCENE_VQA_OPENAI_INIT_CONFIG_JSON,
-  MIDSCENE_VQA_OPENAI_SOCKS_PROXY,
-  MIDSCENE_VQA_VL_MODE,
+  MIDSCENE_VQA_MODEL_SOCKS_PROXY,
+  MODEL_API_KEY,
+  MODEL_BASE_URL,
   OPENAI_API_KEY,
   OPENAI_BASE_URL,
 } from './types';
@@ -56,56 +58,56 @@ export const VQA_MODEL_CONFIG_KEYS: IModelConfigKeys = {
   /**
    * proxy
    */
-  socksProxy: MIDSCENE_VQA_OPENAI_SOCKS_PROXY,
-  httpProxy: MIDSCENE_VQA_OPENAI_HTTP_PROXY,
+  socksProxy: MIDSCENE_VQA_MODEL_SOCKS_PROXY,
+  httpProxy: MIDSCENE_VQA_MODEL_HTTP_PROXY,
   /**
    * OpenAI
    */
-  openaiBaseURL: MIDSCENE_VQA_OPENAI_BASE_URL,
-  openaiApiKey: MIDSCENE_VQA_OPENAI_API_KEY,
-  openaiExtraConfig: MIDSCENE_VQA_OPENAI_INIT_CONFIG_JSON,
+  openaiBaseURL: MIDSCENE_VQA_MODEL_BASE_URL,
+  openaiApiKey: MIDSCENE_VQA_MODEL_API_KEY,
+  openaiExtraConfig: MIDSCENE_VQA_MODEL_INIT_CONFIG_JSON,
   /**
    * Extra
    */
-  vlMode: MIDSCENE_VQA_VL_MODE,
+  vlMode: MIDSCENE_VQA_LOCATOR_MODE,
 } as const;
 
 export const GROUNDING_MODEL_CONFIG_KEYS: IModelConfigKeys = {
   modelName: MIDSCENE_GROUNDING_MODEL_NAME,
   /**
    * proxy
    */
-  socksProxy: MIDSCENE_GROUNDING_OPENAI_SOCKS_PROXY,
-  httpProxy: MIDSCENE_GROUNDING_OPENAI_HTTP_PROXY,
+  socksProxy: MIDSCENE_GROUNDING_MODEL_SOCKS_PROXY,
+  httpProxy: MIDSCENE_GROUNDING_MODEL_HTTP_PROXY,
   /**
    * OpenAI
    */
-  openaiBaseURL: MIDSCENE_GROUNDING_OPENAI_BASE_URL,
-  openaiApiKey: MIDSCENE_GROUNDING_OPENAI_API_KEY,
-  openaiExtraConfig: MIDSCENE_GROUNDING_OPENAI_INIT_CONFIG_JSON,
+  openaiBaseURL: MIDSCENE_GROUNDING_MODEL_BASE_URL,
+  openaiApiKey: MIDSCENE_GROUNDING_MODEL_API_KEY,
+  openaiExtraConfig: MIDSCENE_GROUNDING_MODEL_INIT_CONFIG_JSON,
   /**
    * Extra
    */
-  vlMode: MIDSCENE_GROUNDING_VL_MODE,
+  vlMode: MIDSCENE_GROUNDING_LOCATOR_MODE,
 } as const;
 
 export const PLANNING_MODEL_CONFIG_KEYS: IModelConfigKeys = {
   modelName: MIDSCENE_PLANNING_MODEL_NAME,
   /**
    * proxy
    */
-  socksProxy: MIDSCENE_PLANNING_OPENAI_SOCKS_PROXY,
-  httpProxy: MIDSCENE_PLANNING_OPENAI_HTTP_PROXY,
+  socksProxy: MIDSCENE_PLANNING_MODEL_SOCKS_PROXY,
+  httpProxy: MIDSCENE_PLANNING_MODEL_HTTP_PROXY,
   /**
    * OpenAI
    */
-  openaiBaseURL: MIDSCENE_PLANNING_OPENAI_BASE_URL,
-  openaiApiKey: MIDSCENE_PLANNING_OPENAI_API_KEY,
-  openaiExtraConfig: MIDSCENE_PLANNING_OPENAI_INIT_CONFIG_JSON,
+  openaiBaseURL: MIDSCENE_PLANNING_MODEL_BASE_URL,
+  openaiApiKey: MIDSCENE_PLANNING_MODEL_API_KEY,
+  openaiExtraConfig: MIDSCENE_PLANNING_MODEL_INIT_CONFIG_JSON,
   /**
    * Extra
    */
-  vlMode: MIDSCENE_PLANNING_VL_MODE,
+  vlMode: MIDSCENE_PLANNING_LOCATOR_MODE,
 } as const;
 
 // modelConfig return default
@@ -114,18 +116,18 @@ export const DEFAULT_MODEL_CONFIG_KEYS: IModelConfigKeys = {
   /**
    * proxy
    */
-  socksProxy: MIDSCENE_OPENAI_SOCKS_PROXY,
-  httpProxy: MIDSCENE_OPENAI_HTTP_PROXY,
+  socksProxy: MIDSCENE_MODEL_SOCKS_PROXY,
+  httpProxy: MIDSCENE_MODEL_HTTP_PROXY,
   /**
    * OpenAI
    */
-  openaiBaseURL: MIDSCENE_OPENAI_BASE_URL,
-  openaiApiKey: MIDSCENE_OPENAI_API_KEY,
-  openaiExtraConfig: MIDSCENE_OPENAI_INIT_CONFIG_JSON,
+  openaiBaseURL: MIDSCENE_MODEL_BASE_URL,
+  openaiApiKey: MIDSCENE_MODEL_API_KEY,
+  openaiExtraConfig: MIDSCENE_MODEL_INIT_CONFIG_JSON,
   /**
    * Extra
    */
-  vlMode: MIDSCENE_VL_MODE,
+  vlMode: MIDSCENE_LOCATOR_MODE,
 } as const;
 
 // read from process.env
@@ -134,14 +136,14 @@ export const DEFAULT_MODEL_CONFIG_KEYS_LEGACY: IModelConfigKeys = {
   /**
    * proxy
    */
-  socksProxy: MIDSCENE_OPENAI_SOCKS_PROXY,
-  httpProxy: MIDSCENE_OPENAI_HTTP_PROXY,
+  socksProxy: MIDSCENE_MODEL_SOCKS_PROXY,
+  httpProxy: MIDSCENE_MODEL_HTTP_PROXY,
   /**
-   * OpenAI
+   * OpenAI - Uses legacy OPENAI_* variables for backward compatibility
    */
   openaiBaseURL: OPENAI_BASE_URL,
   openaiApiKey: OPENAI_API_KEY,
-  openaiExtraConfig: MIDSCENE_OPENAI_INIT_CONFIG_JSON,
+  openaiExtraConfig: MIDSCENE_MODEL_INIT_CONFIG_JSON,
   /**
    * Extra
    */