@rpascene/shared 0.30.8

package/src/env/types.ts

@@ -0,0 +1,573 @@
+// config keys
+export const RPASCENE_OPENAI_INIT_CONFIG_JSON =
+  'RPASCENE_OPENAI_INIT_CONFIG_JSON';
+export const RPASCENE_MODEL_NAME = 'RPASCENE_MODEL_NAME';
+export const RPASCENE_LANGSMITH_DEBUG = 'RPASCENE_LANGSMITH_DEBUG';
+export const RPASCENE_DEBUG_AI_PROFILE = 'RPASCENE_DEBUG_AI_PROFILE';
+export const RPASCENE_DEBUG_AI_RESPONSE = 'RPASCENE_DEBUG_AI_RESPONSE';
+export const RPASCENE_DANGEROUSLY_PRINT_ALL_CONFIG =
+  'RPASCENE_DANGEROUSLY_PRINT_ALL_CONFIG';
+export const RPASCENE_DEBUG_MODE = 'RPASCENE_DEBUG_MODE';
+export const RPASCENE_MCP_USE_PUPPETEER_MODE =
+  'RPASCENE_MCP_USE_PUPPETEER_MODE';
+export const RPASCENE_MCP_CHROME_PATH = 'RPASCENE_MCP_CHROME_PATH';
+export const RPASCENE_MCP_ANDROID_MODE = 'RPASCENE_MCP_ANDROID_MODE';
+export const DOCKER_CONTAINER = 'DOCKER_CONTAINER';
+export const RPASCENE_FORCE_DEEP_THINK = 'RPASCENE_FORCE_DEEP_THINK';
+
+export const RPASCENE_OPENAI_SOCKS_PROXY = 'RPASCENE_OPENAI_SOCKS_PROXY';
+export const RPASCENE_OPENAI_HTTP_PROXY = 'RPASCENE_OPENAI_HTTP_PROXY';
+export const OPENAI_API_KEY = 'OPENAI_API_KEY';
+export const OPENAI_BASE_URL = 'OPENAI_BASE_URL';
+export const OPENAI_MAX_TOKENS = 'OPENAI_MAX_TOKENS';
+
+export const RPASCENE_ADB_PATH = 'RPASCENE_ADB_PATH';
+export const RPASCENE_ADB_REMOTE_HOST = 'RPASCENE_ADB_REMOTE_HOST';
+export const RPASCENE_ADB_REMOTE_PORT = 'RPASCENE_ADB_REMOTE_PORT';
+export const RPASCENE_ANDROID_IME_STRATEGY = 'RPASCENE_ANDROID_IME_STRATEGY';
+
+export const RPASCENE_IOS_DEVICE_UDID = 'RPASCENE_IOS_DEVICE_UDID';
+export const RPASCENE_IOS_SIMULATOR_UDID = 'RPASCENE_IOS_SIMULATOR_UDID';
+
+export const RPASCENE_CACHE = 'RPASCENE_CACHE';
+export const RPASCENE_USE_VLM_UI_TARS = 'RPASCENE_USE_VLM_UI_TARS';
+export const RPASCENE_USE_QWEN_VL = 'RPASCENE_USE_QWEN_VL';
+export const RPASCENE_USE_QWEN3_VL = 'RPASCENE_USE_QWEN3_VL';
+export const RPASCENE_USE_DOUBAO_VISION = 'RPASCENE_USE_DOUBAO_VISION';
+export const RPASCENE_USE_GEMINI = 'RPASCENE_USE_GEMINI';
+export const RPASCENE_USE_VL_MODEL = 'RPASCENE_USE_VL_MODEL';
+export const MATCH_BY_POSITION = 'MATCH_BY_POSITION';
+export const RPASCENE_API_TYPE = 'RPASCENE-API-TYPE';
+export const RPASCENE_REPORT_TAG_NAME = 'RPASCENE_REPORT_TAG_NAME';
+
+export const RPASCENE_REPLANNING_CYCLE_LIMIT =
+  'RPASCENE_REPLANNING_CYCLE_LIMIT';
+
+export const RPASCENE_PREFERRED_LANGUAGE = 'RPASCENE_PREFERRED_LANGUAGE';
+
+export const RPASCENE_USE_AZURE_OPENAI = 'RPASCENE_USE_AZURE_OPENAI';
+export const RPASCENE_AZURE_OPENAI_SCOPE = 'RPASCENE_AZURE_OPENAI_SCOPE';
+export const RPASCENE_AZURE_OPENAI_INIT_CONFIG_JSON =
+  'RPASCENE_AZURE_OPENAI_INIT_CONFIG_JSON';
+
+export const RPASCENE_CACHE_MAX_FILENAME_LENGTH =
+  'RPASCENE_CACHE_MAX_FILENAME_LENGTH';
+
+export const AZURE_OPENAI_ENDPOINT = 'AZURE_OPENAI_ENDPOINT';
+export const AZURE_OPENAI_KEY = 'AZURE_OPENAI_KEY';
+export const AZURE_OPENAI_API_VERSION = 'AZURE_OPENAI_API_VERSION';
+export const AZURE_OPENAI_DEPLOYMENT = 'AZURE_OPENAI_DEPLOYMENT';
+
+export const RPASCENE_USE_ANTHROPIC_SDK = 'RPASCENE_USE_ANTHROPIC_SDK';
+export const ANTHROPIC_API_KEY = 'ANTHROPIC_API_KEY';
+
+export const RPASCENE_RUN_DIR = 'RPASCENE_RUN_DIR';
+
+// default new
+export const RPASCENE_OPENAI_BASE_URL = 'RPASCENE_OPENAI_BASE_URL';
+export const RPASCENE_OPENAI_API_KEY = 'RPASCENE_OPENAI_API_KEY';
+export const RPASCENE_OPENAI_USE_AZURE = 'RPASCENE_OPENAI_USE_AZURE';
+export const RPASCENE_AZURE_OPENAI_KEY = 'RPASCENE_AZURE_OPENAI_KEY';
+export const RPASCENE_AZURE_OPENAI_ENDPOINT = 'RPASCENE_AZURE_OPENAI_ENDPOINT';
+export const RPASCENE_AZURE_OPENAI_API_VERSION =
+  'RPASCENE_AZURE_OPENAI_API_VERSION';
+export const RPASCENE_AZURE_OPENAI_DEPLOYMENT =
+  'RPASCENE_AZURE_OPENAI_DEPLOYMENT';
+export const RPASCENE_ANTHROPIC_API_KEY = 'RPASCENE_ANTHROPIC_API_KEY';
+export const RPASCENE_VL_MODE = 'RPASCENE_VL_MODE';
+
+// VQA
+export const RPASCENE_VQA_MODEL_NAME = 'RPASCENE_VQA_MODEL_NAME';
+export const RPASCENE_VQA_OPENAI_SOCKS_PROXY =
+  'RPASCENE_VQA_OPENAI_SOCKS_PROXY';
+export const RPASCENE_VQA_OPENAI_HTTP_PROXY = 'RPASCENE_VQA_OPENAI_HTTP_PROXY';
+export const RPASCENE_VQA_OPENAI_BASE_URL = 'RPASCENE_VQA_OPENAI_BASE_URL';
+export const RPASCENE_VQA_OPENAI_API_KEY = 'RPASCENE_VQA_OPENAI_API_KEY';
+export const RPASCENE_VQA_OPENAI_INIT_CONFIG_JSON =
+  'RPASCENE_VQA_OPENAI_INIT_CONFIG_JSON';
+export const RPASCENE_VQA_OPENAI_USE_AZURE = 'RPASCENE_VQA_OPENAI_USE_AZURE';
+export const RPASCENE_VQA_USE_AZURE_OPENAI = 'RPASCENE_VQA_USE_AZURE_OPENAI';
+export const RPASCENE_VQA_AZURE_OPENAI_SCOPE =
+  'RPASCENE_VQA_AZURE_OPENAI_SCOPE';
+export const RPASCENE_VQA_AZURE_OPENAI_KEY = 'RPASCENE_VQA_AZURE_OPENAI_KEY';
+export const RPASCENE_VQA_AZURE_OPENAI_ENDPOINT =
+  'RPASCENE_VQA_AZURE_OPENAI_ENDPOINT';
+export const RPASCENE_VQA_AZURE_OPENAI_API_VERSION =
+  'RPASCENE_VQA_AZURE_OPENAI_API_VERSION';
+export const RPASCENE_VQA_AZURE_OPENAI_DEPLOYMENT =
+  'RPASCENE_VQA_AZURE_OPENAI_DEPLOYMENT';
+export const RPASCENE_VQA_AZURE_OPENAI_INIT_CONFIG_JSON =
+  'RPASCENE_VQA_AZURE_OPENAI_INIT_CONFIG_JSON';
+export const RPASCENE_VQA_USE_ANTHROPIC_SDK = 'RPASCENE_VQA_USE_ANTHROPIC_SDK';
+export const RPASCENE_VQA_ANTHROPIC_API_KEY = 'RPASCENE_VQA_ANTHROPIC_API_KEY';
+export const RPASCENE_VQA_VL_MODE = 'RPASCENE_VQA_VL_MODE';
+
+// PLANNING
+export const RPASCENE_PLANNING_MODEL_NAME = 'RPASCENE_PLANNING_MODEL_NAME';
+export const RPASCENE_PLANNING_OPENAI_SOCKS_PROXY =
+  'RPASCENE_PLANNING_OPENAI_SOCKS_PROXY';
+export const RPASCENE_PLANNING_OPENAI_HTTP_PROXY =
+  'RPASCENE_PLANNING_OPENAI_HTTP_PROXY';
+export const RPASCENE_PLANNING_OPENAI_BASE_URL =
+  'RPASCENE_PLANNING_OPENAI_BASE_URL';
+export const RPASCENE_PLANNING_OPENAI_API_KEY =
+  'RPASCENE_PLANNING_OPENAI_API_KEY';
+export const RPASCENE_PLANNING_OPENAI_INIT_CONFIG_JSON =
+  'RPASCENE_PLANNING_OPENAI_INIT_CONFIG_JSON';
+export const RPASCENE_PLANNING_OPENAI_USE_AZURE =
+  'RPASCENE_PLANNING_OPENAI_USE_AZURE';
+export const RPASCENE_PLANNING_USE_AZURE_OPENAI =
+  'RPASCENE_PLANNING_USE_AZURE_OPENAI';
+export const RPASCENE_PLANNING_AZURE_OPENAI_SCOPE =
+  'RPASCENE_PLANNING_AZURE_OPENAI_SCOPE';
+export const RPASCENE_PLANNING_AZURE_OPENAI_KEY =
+  'RPASCENE_PLANNING_AZURE_OPENAI_KEY';
+export const RPASCENE_PLANNING_AZURE_OPENAI_ENDPOINT =
+  'RPASCENE_PLANNING_AZURE_OPENAI_ENDPOINT';
+export const RPASCENE_PLANNING_AZURE_OPENAI_API_VERSION =
+  'RPASCENE_PLANNING_AZURE_OPENAI_API_VERSION';
+export const RPASCENE_PLANNING_AZURE_OPENAI_DEPLOYMENT =
+  'RPASCENE_PLANNING_AZURE_OPENAI_DEPLOYMENT';
+export const RPASCENE_PLANNING_AZURE_OPENAI_INIT_CONFIG_JSON =
+  'RPASCENE_PLANNING_AZURE_OPENAI_INIT_CONFIG_JSON';
+export const RPASCENE_PLANNING_USE_ANTHROPIC_SDK =
+  'RPASCENE_PLANNING_USE_ANTHROPIC_SDK';
+export const RPASCENE_PLANNING_ANTHROPIC_API_KEY =
+  'RPASCENE_PLANNING_ANTHROPIC_API_KEY';
+export const RPASCENE_PLANNING_VL_MODE = 'RPASCENE_PLANNING_VL_MODE';
+
+// GROUNDING
+export const RPASCENE_GROUNDING_MODEL_NAME = 'RPASCENE_GROUNDING_MODEL_NAME';
+export const RPASCENE_GROUNDING_OPENAI_SOCKS_PROXY =
+  'RPASCENE_GROUNDING_OPENAI_SOCKS_PROXY';
+export const RPASCENE_GROUNDING_OPENAI_HTTP_PROXY =
+  'RPASCENE_GROUNDING_OPENAI_HTTP_PROXY';
+export const RPASCENE_GROUNDING_OPENAI_BASE_URL =
+  'RPASCENE_GROUNDING_OPENAI_BASE_URL';
+export const RPASCENE_GROUNDING_OPENAI_API_KEY =
+  'RPASCENE_GROUNDING_OPENAI_API_KEY';
+export const RPASCENE_GROUNDING_OPENAI_INIT_CONFIG_JSON =
+  'RPASCENE_GROUNDING_OPENAI_INIT_CONFIG_JSON';
+export const RPASCENE_GROUNDING_OPENAI_USE_AZURE =
+  'RPASCENE_GROUNDING_OPENAI_USE_AZURE';
+export const RPASCENE_GROUNDING_USE_AZURE_OPENAI =
+  'RPASCENE_GROUNDING_USE_AZURE_OPENAI';
+export const RPASCENE_GROUNDING_AZURE_OPENAI_SCOPE =
+  'RPASCENE_GROUNDING_AZURE_OPENAI_SCOPE';
+export const RPASCENE_GROUNDING_AZURE_OPENAI_KEY =
+  'RPASCENE_GROUNDING_AZURE_OPENAI_KEY';
+export const RPASCENE_GROUNDING_AZURE_OPENAI_ENDPOINT =
+  'RPASCENE_GROUNDING_AZURE_OPENAI_ENDPOINT';
+export const RPASCENE_GROUNDING_AZURE_OPENAI_API_VERSION =
+  'RPASCENE_GROUNDING_AZURE_OPENAI_API_VERSION';
+export const RPASCENE_GROUNDING_AZURE_OPENAI_DEPLOYMENT =
+  'RPASCENE_GROUNDING_AZURE_OPENAI_DEPLOYMENT';
+export const RPASCENE_GROUNDING_AZURE_OPENAI_INIT_CONFIG_JSON =
+  'RPASCENE_GROUNDING_AZURE_OPENAI_INIT_CONFIG_JSON';
+export const RPASCENE_GROUNDING_USE_ANTHROPIC_SDK =
+  'RPASCENE_GROUNDING_USE_ANTHROPIC_SDK';
+export const RPASCENE_GROUNDING_ANTHROPIC_API_KEY =
+  'RPASCENE_GROUNDING_ANTHROPIC_API_KEY';
+export const RPASCENE_GROUNDING_VL_MODE = 'RPASCENE_GROUNDING_VL_MODE';
+
+// @deprecated
+export const OPENAI_USE_AZURE = 'OPENAI_USE_AZURE';
+
+/**
+ * env keys declared but unused
+ */
+export const UNUSED_ENV_KEYS = [RPASCENE_DANGEROUSLY_PRINT_ALL_CONFIG];
+
+/**
+ * env keys for debug or basic run
+ * can not be override by overrideAIConfig
+ */
+export const BASIC_ENV_KEYS = [
+  RPASCENE_DEBUG_MODE,
+  RPASCENE_DEBUG_AI_PROFILE,
+  RPASCENE_DEBUG_AI_RESPONSE,
+  RPASCENE_RUN_DIR,
+] as const;
+
+export const BOOLEAN_ENV_KEYS = [
+  RPASCENE_CACHE,
+  RPASCENE_LANGSMITH_DEBUG,
+  RPASCENE_FORCE_DEEP_THINK,
+  RPASCENE_MCP_USE_PUPPETEER_MODE,
+  RPASCENE_MCP_ANDROID_MODE,
+] as const;
+
+export const NUMBER_ENV_KEYS = [
+  RPASCENE_CACHE_MAX_FILENAME_LENGTH,
+  RPASCENE_REPLANNING_CYCLE_LIMIT,
+] as const;
+
+export const STRING_ENV_KEYS = [
+  OPENAI_MAX_TOKENS,
+  RPASCENE_ADB_PATH,
+  RPASCENE_ADB_REMOTE_HOST,
+  RPASCENE_ADB_REMOTE_PORT,
+  RPASCENE_ANDROID_IME_STRATEGY,
+  RPASCENE_IOS_DEVICE_UDID,
+  RPASCENE_IOS_SIMULATOR_UDID,
+  RPASCENE_REPORT_TAG_NAME,
+  RPASCENE_PREFERRED_LANGUAGE,
+  MATCH_BY_POSITION,
+  RPASCENE_MCP_CHROME_PATH,
+  DOCKER_CONTAINER,
+] as const;
+
+/**
+ * Non model related env keys, used for globally controlling the behavior of rpascene
+ * Can not be override by agent.modelConfig but can be override by overrideAIConfig
+ * Can be access at any time
+ */
+export const GLOBAL_ENV_KEYS = [
+  ...BOOLEAN_ENV_KEYS,
+  ...NUMBER_ENV_KEYS,
+  ...STRING_ENV_KEYS,
+] as const;
+
+/**
+ * Model related eve keys, used for declare which model to use.
+ * Can be override by both agent.modelConfig and overrideAIConfig
+ * Can only be access after agent.constructor
+ */
+export const MODEL_ENV_KEYS = [
+  // model default
+  RPASCENE_MODEL_NAME,
+  RPASCENE_OPENAI_INIT_CONFIG_JSON,
+  RPASCENE_OPENAI_API_KEY,
+  RPASCENE_OPENAI_BASE_URL,
+  RPASCENE_OPENAI_USE_AZURE,
+  RPASCENE_OPENAI_SOCKS_PROXY,
+  RPASCENE_OPENAI_HTTP_PROXY,
+  RPASCENE_USE_AZURE_OPENAI,
+  RPASCENE_AZURE_OPENAI_SCOPE,
+  RPASCENE_AZURE_OPENAI_INIT_CONFIG_JSON,
+  RPASCENE_USE_ANTHROPIC_SDK,
+  RPASCENE_USE_VLM_UI_TARS,
+  RPASCENE_USE_QWEN_VL,
+  RPASCENE_USE_QWEN3_VL,
+  RPASCENE_USE_DOUBAO_VISION,
+  RPASCENE_USE_GEMINI,
+  RPASCENE_USE_VL_MODEL,
+  ANTHROPIC_API_KEY,
+  RPASCENE_AZURE_OPENAI_ENDPOINT,
+  RPASCENE_AZURE_OPENAI_KEY,
+  RPASCENE_AZURE_OPENAI_API_VERSION,
+  RPASCENE_AZURE_OPENAI_DEPLOYMENT,
+  RPASCENE_VL_MODE,
+  // model default legacy
+  OPENAI_API_KEY,
+  OPENAI_BASE_URL,
+  OPENAI_USE_AZURE,
+  ANTHROPIC_API_KEY,
+  AZURE_OPENAI_ENDPOINT,
+  AZURE_OPENAI_KEY,
+  AZURE_OPENAI_API_VERSION,
+  AZURE_OPENAI_DEPLOYMENT,
+  // VQA
+  RPASCENE_VQA_MODEL_NAME,
+  RPASCENE_VQA_OPENAI_SOCKS_PROXY,
+  RPASCENE_VQA_OPENAI_HTTP_PROXY,
+  RPASCENE_VQA_OPENAI_BASE_URL,
+  RPASCENE_VQA_OPENAI_API_KEY,
+  RPASCENE_VQA_OPENAI_INIT_CONFIG_JSON,
+  RPASCENE_VQA_OPENAI_USE_AZURE,
+  RPASCENE_VQA_USE_AZURE_OPENAI,
+  RPASCENE_VQA_AZURE_OPENAI_SCOPE,
+  RPASCENE_VQA_AZURE_OPENAI_KEY,
+  RPASCENE_VQA_AZURE_OPENAI_ENDPOINT,
+  RPASCENE_VQA_AZURE_OPENAI_API_VERSION,
+  RPASCENE_VQA_AZURE_OPENAI_DEPLOYMENT,
+  RPASCENE_VQA_AZURE_OPENAI_INIT_CONFIG_JSON,
+  RPASCENE_VQA_USE_ANTHROPIC_SDK,
+  RPASCENE_VQA_ANTHROPIC_API_KEY,
+  RPASCENE_VQA_VL_MODE,
+  // PLANNING
+  RPASCENE_PLANNING_MODEL_NAME,
+  RPASCENE_PLANNING_OPENAI_SOCKS_PROXY,
+  RPASCENE_PLANNING_OPENAI_HTTP_PROXY,
+  RPASCENE_PLANNING_OPENAI_BASE_URL,
+  RPASCENE_PLANNING_OPENAI_API_KEY,
+  RPASCENE_PLANNING_OPENAI_INIT_CONFIG_JSON,
+  RPASCENE_PLANNING_OPENAI_USE_AZURE,
+  RPASCENE_PLANNING_USE_AZURE_OPENAI,
+  RPASCENE_PLANNING_AZURE_OPENAI_SCOPE,
+  RPASCENE_PLANNING_AZURE_OPENAI_KEY,
+  RPASCENE_PLANNING_AZURE_OPENAI_ENDPOINT,
+  RPASCENE_PLANNING_AZURE_OPENAI_API_VERSION,
+  RPASCENE_PLANNING_AZURE_OPENAI_DEPLOYMENT,
+  RPASCENE_PLANNING_AZURE_OPENAI_INIT_CONFIG_JSON,
+  RPASCENE_PLANNING_USE_ANTHROPIC_SDK,
+  RPASCENE_PLANNING_ANTHROPIC_API_KEY,
+  RPASCENE_PLANNING_VL_MODE,
+  // GROUNDING
+  RPASCENE_GROUNDING_MODEL_NAME,
+  RPASCENE_GROUNDING_OPENAI_SOCKS_PROXY,
+  RPASCENE_GROUNDING_OPENAI_HTTP_PROXY,
+  RPASCENE_GROUNDING_OPENAI_BASE_URL,
+  RPASCENE_GROUNDING_OPENAI_API_KEY,
+  RPASCENE_GROUNDING_OPENAI_INIT_CONFIG_JSON,
+  RPASCENE_GROUNDING_OPENAI_USE_AZURE,
+  RPASCENE_GROUNDING_USE_AZURE_OPENAI,
+  RPASCENE_GROUNDING_AZURE_OPENAI_SCOPE,
+  RPASCENE_GROUNDING_AZURE_OPENAI_KEY,
+  RPASCENE_GROUNDING_AZURE_OPENAI_ENDPOINT,
+  RPASCENE_GROUNDING_AZURE_OPENAI_API_VERSION,
+  RPASCENE_GROUNDING_AZURE_OPENAI_DEPLOYMENT,
+  RPASCENE_GROUNDING_AZURE_OPENAI_INIT_CONFIG_JSON,
+  RPASCENE_GROUNDING_USE_ANTHROPIC_SDK,
+  RPASCENE_GROUNDING_ANTHROPIC_API_KEY,
+  RPASCENE_GROUNDING_VL_MODE,
+] as const;
+
+export const Yht_ENV_KEYS = [
+  'domain',
+  'yht_access_token',
+  'chatType',
+  'model',
+  'modelCategory',
+  'stream',
+  'temperature',
+  'top_p',
+  'baseURL'
+]
+
+export const ALL_ENV_KEYS = [
+  ...UNUSED_ENV_KEYS,
+  ...BASIC_ENV_KEYS,
+  ...GLOBAL_ENV_KEYS,
+  ...MODEL_ENV_KEYS,
+  ...Yht_ENV_KEYS
+] as const;
+
+export type TEnvKeys = (typeof ALL_ENV_KEYS)[number];
+export type TGlobalConfig = Record<TEnvKeys, string | undefined>;
+
+export type TVlModeValues =
+  | 'qwen-vl'
+  | 'qwen3-vl'
+  | 'doubao-vision'
+  | 'gemini'
+  | 'vlm-ui-tars'
+  | 'vlm-ui-tars-doubao'
+  | 'vlm-ui-tars-doubao-1.5';
+
+export type TVlModeTypes =
+  | 'qwen-vl'
+  | 'qwen3-vl'
+  | 'doubao-vision'
+  | 'gemini'
+  | 'vlm-ui-tars';
+
+export interface IModelConfigForVQA {
+  // model name
+  [RPASCENE_VQA_MODEL_NAME]: string;
+  // proxy
+  [RPASCENE_VQA_OPENAI_SOCKS_PROXY]?: string;
+  [RPASCENE_VQA_OPENAI_HTTP_PROXY]?: string;
+  // OpenAI
+  [RPASCENE_VQA_OPENAI_BASE_URL]?: string;
+  [RPASCENE_VQA_OPENAI_API_KEY]?: string;
+  [RPASCENE_VQA_OPENAI_INIT_CONFIG_JSON]?: string;
+  // Azure
+  [RPASCENE_VQA_OPENAI_USE_AZURE]?: string;
+  [RPASCENE_VQA_USE_AZURE_OPENAI]?: string;
+  [RPASCENE_VQA_AZURE_OPENAI_SCOPE]?: string;
+  [RPASCENE_VQA_AZURE_OPENAI_KEY]?: string;
+  [RPASCENE_VQA_AZURE_OPENAI_ENDPOINT]?: string;
+  [RPASCENE_VQA_AZURE_OPENAI_API_VERSION]?: string;
+  [RPASCENE_VQA_AZURE_OPENAI_DEPLOYMENT]?: string;
+  [RPASCENE_VQA_AZURE_OPENAI_INIT_CONFIG_JSON]?: string;
+  // Anthropic
+  [RPASCENE_VQA_USE_ANTHROPIC_SDK]?: string;
+  [RPASCENE_VQA_ANTHROPIC_API_KEY]?: string;
+  // extra
+  [RPASCENE_VQA_VL_MODE]?: TVlModeValues;
+}
+
+export interface IModelConfigForPlanning {
+  // model name
+  [RPASCENE_PLANNING_MODEL_NAME]: string;
+  // proxy
+  [RPASCENE_PLANNING_OPENAI_SOCKS_PROXY]?: string;
+  [RPASCENE_PLANNING_OPENAI_HTTP_PROXY]?: string;
+  // OpenAI
+  [RPASCENE_PLANNING_OPENAI_BASE_URL]?: string;
+  [RPASCENE_PLANNING_OPENAI_API_KEY]?: string;
+  [RPASCENE_PLANNING_OPENAI_INIT_CONFIG_JSON]?: string;
+  // Azure
+  [RPASCENE_PLANNING_OPENAI_USE_AZURE]?: string;
+  [RPASCENE_PLANNING_USE_AZURE_OPENAI]?: string;
+  [RPASCENE_PLANNING_AZURE_OPENAI_SCOPE]?: string;
+  [RPASCENE_PLANNING_AZURE_OPENAI_KEY]?: string;
+  [RPASCENE_PLANNING_AZURE_OPENAI_ENDPOINT]?: string;
+  [RPASCENE_PLANNING_AZURE_OPENAI_API_VERSION]?: string;
+  [RPASCENE_PLANNING_AZURE_OPENAI_DEPLOYMENT]?: string;
+  [RPASCENE_PLANNING_AZURE_OPENAI_INIT_CONFIG_JSON]?: string;
+  // Anthropic
+  [RPASCENE_PLANNING_USE_ANTHROPIC_SDK]?: string;
+  [RPASCENE_PLANNING_ANTHROPIC_API_KEY]?: string;
+  // extra
+  [RPASCENE_PLANNING_VL_MODE]?: TVlModeValues;
+}
+
+export interface IModeConfigForGrounding {
+  // model name
+  [RPASCENE_GROUNDING_MODEL_NAME]: string;
+  // proxy
+  [RPASCENE_GROUNDING_OPENAI_SOCKS_PROXY]?: string;
+  [RPASCENE_GROUNDING_OPENAI_HTTP_PROXY]?: string;
+  // OpenAI
+  [RPASCENE_GROUNDING_OPENAI_BASE_URL]?: string;
+  [RPASCENE_GROUNDING_OPENAI_API_KEY]?: string;
+  [RPASCENE_GROUNDING_OPENAI_INIT_CONFIG_JSON]?: string;
+  // Azure
+  [RPASCENE_GROUNDING_OPENAI_USE_AZURE]?: string;
+  [RPASCENE_GROUNDING_USE_AZURE_OPENAI]?: string;
+  [RPASCENE_GROUNDING_AZURE_OPENAI_SCOPE]?: string;
+  [RPASCENE_GROUNDING_AZURE_OPENAI_KEY]?: string;
+  [RPASCENE_GROUNDING_AZURE_OPENAI_ENDPOINT]?: string;
+  [RPASCENE_GROUNDING_AZURE_OPENAI_API_VERSION]?: string;
+  [RPASCENE_GROUNDING_AZURE_OPENAI_DEPLOYMENT]?: string;
+  [RPASCENE_GROUNDING_AZURE_OPENAI_INIT_CONFIG_JSON]?: string;
+  // Anthropic
+  [RPASCENE_GROUNDING_USE_ANTHROPIC_SDK]?: string;
+  [RPASCENE_GROUNDING_ANTHROPIC_API_KEY]?: string;
+  // extra
+  [RPASCENE_GROUNDING_VL_MODE]?: TVlModeValues;
+}
+
+export interface IModelConfigForDefault {
+  // model name
+  [RPASCENE_MODEL_NAME]: string;
+  // proxy
+  [RPASCENE_OPENAI_SOCKS_PROXY]?: string;
+  [RPASCENE_OPENAI_HTTP_PROXY]?: string;
+  // OpenAI
+  [RPASCENE_OPENAI_BASE_URL]?: string;
+  [RPASCENE_OPENAI_API_KEY]?: string;
+  [RPASCENE_OPENAI_INIT_CONFIG_JSON]?: string;
+  // Azure
+  [RPASCENE_OPENAI_USE_AZURE]?: string;
+  [RPASCENE_USE_AZURE_OPENAI]?: string;
+  [RPASCENE_AZURE_OPENAI_SCOPE]?: string;
+  [RPASCENE_AZURE_OPENAI_KEY]?: string;
+  [RPASCENE_AZURE_OPENAI_ENDPOINT]?: string;
+  [RPASCENE_AZURE_OPENAI_API_VERSION]?: string;
+  [RPASCENE_AZURE_OPENAI_DEPLOYMENT]?: string;
+  [RPASCENE_AZURE_OPENAI_INIT_CONFIG_JSON]?: string;
+  // Anthropic
+  [RPASCENE_USE_ANTHROPIC_SDK]?: string;
+  [RPASCENE_ANTHROPIC_API_KEY]?: string;
+  // extra
+  [RPASCENE_VL_MODE]?: TVlModeValues;
+}
+
+export interface IModelConfigForDefaultLegacy {
+  // model name
+  [RPASCENE_MODEL_NAME]: string;
+  // proxy
+  [RPASCENE_OPENAI_SOCKS_PROXY]?: string;
+  [RPASCENE_OPENAI_HTTP_PROXY]?: string;
+  // OpenAI
+  [OPENAI_BASE_URL]?: string;
+  [OPENAI_API_KEY]?: string;
+  [RPASCENE_OPENAI_INIT_CONFIG_JSON]?: string;
+  // Azure
+  [OPENAI_USE_AZURE]?: string;
+  [RPASCENE_USE_AZURE_OPENAI]?: string;
+  [RPASCENE_AZURE_OPENAI_SCOPE]?: string;
+  [AZURE_OPENAI_KEY]?: string;
+  [AZURE_OPENAI_ENDPOINT]?: string;
+  [AZURE_OPENAI_API_VERSION]?: string;
+  [AZURE_OPENAI_DEPLOYMENT]?: string;
+  [RPASCENE_AZURE_OPENAI_INIT_CONFIG_JSON]?: string;
+  // Anthropic
+  [RPASCENE_USE_ANTHROPIC_SDK]?: string;
+  [ANTHROPIC_API_KEY]?: string;
+  // extra
+  [RPASCENE_VL_MODE]?: TVlModeValues;
+}
+
+/**
+ * - VQA: Visual Question Answering
+ * - grounding：short for Visual Grounding
+ * - planning: planning
+ * - default: all except VQA、grounding、planning
+ */
+export type TIntent = 'VQA' | 'planning' | 'grounding' | 'default';
+
+export type TModelConfigFn = (options: {
+  intent: TIntent;
+}) =>
+  | IModelConfigForVQA
+  | IModelConfigForPlanning
+  | IModeConfigForGrounding
+  | IModelConfigForDefault;
+
+export enum UITarsModelVersion {
+  V1_0 = '1.0',
+  V1_5 = '1.5',
+  DOUBAO_1_5_15B = 'doubao-1.5-15B',
+  DOUBAO_1_5_20B = 'doubao-1.5-20B',
+}
+
+export const VL_MODE_RAW_VALID_VALUES: TVlModeValues[] = [
+  'doubao-vision',
+  'gemini',
+  'qwen-vl',
+  'qwen3-vl',
+  'vlm-ui-tars',
+  'vlm-ui-tars-doubao',
+  'vlm-ui-tars-doubao-1.5',
+];
+
+export interface IModelConfig {
+  /**
+   * proxy
+   */
+  socksProxy?: string;
+  httpProxy?: string;
+  /**
+   * model
+   */
+  modelName: string;
+  /**
+   * OpenAI
+   */
+  openaiBaseURL?: string;
+  openaiApiKey?: string;
+  openaiExtraConfig?: Record<string, unknown>;
+  /**
+   * Azure
+   */
+  openaiUseAzureDeprecated?: boolean;
+  useAzureOpenai?: boolean;
+  azureOpenaiScope?: string;
+  azureOpenaiKey?: string;
+  azureOpenaiEndpoint?: string;
+  azureOpenaiApiVersion?: string;
+  azureOpenaiDeployment?: string;
+  azureExtraConfig?: Record<string, unknown>;
+  /**
+   * Anthropic
+   */
+  useAnthropicSdk?: boolean;
+  anthropicApiKey?: string;
+  /**
+   * - vlModeRaw: exists only in non-legacy logic. value can be 'doubao-vision', 'gemini', 'qwen-vl', 'vlm-ui-tars', 'vlm-ui-tars-doubao', 'vlm-ui-tars-doubao-1.5'
+   * - vlMode: based on the results of the vlModoRaw classification，value can be 'doubao-vision', 'gemini', 'qwen-vl', 'vlm-ui-tars'
+   */
+  vlModeRaw?: string;
+  vlMode?: TVlModeTypes;
+  uiTarsModelVersion?: UITarsModelVersion;
+  modelDescription: string;
+  /**
+   * for debug
+   */
+  intent: TIntent;
+  from: 'modelConfig' | 'env' | 'legacy-env';
+}

package/src/env/utils.ts

@@ -0,0 +1,39 @@
+import { GlobalConfigManager } from './global-config-manager';
+import { ModelConfigManager } from './model-config-manager';
+import {
+  type GLOBAL_ENV_KEYS,
+  RPASCENE_PREFERRED_LANGUAGE,
+  type MODEL_ENV_KEYS,
+} from './types';
+
+export const globalModelConfigManager = new ModelConfigManager();
+
+export const globalConfigManager = new GlobalConfigManager();
+
+globalConfigManager.registerModelConfigManager(globalModelConfigManager);
+globalModelConfigManager.registerGlobalConfigManager(globalConfigManager);
+
+export const getPreferredLanguage = () => {
+  const prefer = globalConfigManager.getEnvConfigValue(
+    RPASCENE_PREFERRED_LANGUAGE,
+  );
+  if (prefer) {
+    return prefer;
+  }
+
+  const timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+  const isChina = timeZone === 'Asia/Shanghai';
+  return isChina ? 'Chinese' : 'English';
+};
+
+export const overrideAIConfig = (
+  newConfig: Partial<
+    Record<
+      (typeof GLOBAL_ENV_KEYS)[number] | (typeof MODEL_ENV_KEYS)[number],
+      string
+    >
+  >,
+  extendMode = false, // true: merge with global config, false: override global config
+) => {
+  globalConfigManager.overrideAIConfig(newConfig, extendMode);
+};

package/src/extractor/constants.ts

@@ -0,0 +1,5 @@
+export {
+  NodeType,
+  TEXT_MAX_SIZE,
+  TEXT_SIZE_THRESHOLD,
+} from '../constants/index';