@rpascene/shared 0.30.8 → 0.30.9

package/src/common.ts

@@ -1,29 +1,29 @@
 import { existsSync, mkdirSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import path from 'node:path';
-// do not import getBasicEnvValue and RPASCENE_RUN_DIR directly from ./env,
+// do not import getBasicEnvValue and MIDSCENE_RUN_DIR directly from ./env,
 // because it will cause circular dependency
 import { getBasicEnvValue } from './env/basic';
-import { RPASCENE_RUN_DIR } from './env/types';
+import { MIDSCENE_RUN_DIR } from './env/types';
 import { ifInNode } from './utils';
 
-export const defaultRunDirName = 'rpascene_run';
+export const defaultRunDirName = 'midscene_run';
 // Define locally for now to avoid import issues
 
-export const getRpasceneRunDir = () => {
+export const getMidsceneRunDir = () => {
   if (!ifInNode) {
     return '';
   }
 
-  return getBasicEnvValue(RPASCENE_RUN_DIR) || defaultRunDirName;
+  return getBasicEnvValue(MIDSCENE_RUN_DIR) || defaultRunDirName;
 };
 
-export const getRpasceneRunBaseDir = () => {
+export const getMidsceneRunBaseDir = () => {
   if (!ifInNode) {
     return '';
   }
 
-  let basePath = path.resolve(process.cwd(), getRpasceneRunDir());
+  let basePath = path.resolve(process.cwd(), getMidsceneRunDir());
 
   // Create a base directory
   if (!existsSync(basePath)) {
@@ -40,13 +40,13 @@ export const getRpasceneRunBaseDir = () => {
 };
 
 /**
- * Get the path to the rpascene_run directory or a subdirectory within it.
+ * Get the path to the midscene_run directory or a subdirectory within it.
  * Creates the directory if it doesn't exist.
  *
  * @param subdir - Optional subdirectory name (e.g., 'log', 'report')
  * @returns The absolute path to the requested directory
  */
-export const getRpasceneRunSubDir = (
+export const getMidsceneRunSubDir = (
   subdir: 'dump' | 'cache' | 'report' | 'tmp' | 'log' | 'output',
 ): string => {
   if (!ifInNode) {
@@ -54,7 +54,7 @@ export const getRpasceneRunSubDir = (
   }
 
   // Create a log directory
-  const basePath = getRpasceneRunBaseDir();
+  const basePath = getMidsceneRunBaseDir();
   const logPath = path.join(basePath, subdir);
   if (!existsSync(logPath)) {
     mkdirSync(logPath, { recursive: true });

package/src/constants/example-code.ts

@@ -1,6 +1,6 @@
 export const PLAYWRIGHT_EXAMPLE_CODE = `
-// Reference the following code to generate Rpascene test cases
-// The following is test code for Rpascene AI, for reference
+// Reference the following code to generate Midscene test cases
+// The following is test code for Midscene AI, for reference
 // The following is Playwright syntax, you can use Playwright to assist in test generation
 IMPORTANT: Follow these exact type signatures for AI functions:
 
@@ -17,8 +17,8 @@ aiAssert(assertion: string): Promise<void>
 aiQuery<T>(queryObject: Record<string, string>): Promise<T> // Extracts data from page based on descriptions
 
 // examples:
-// Reference the following code to generate Rpascene test cases
-// The following is test code for Rpascene AI, for reference
+// Reference the following code to generate Midscene test cases
+// The following is test code for Midscene AI, for reference
 // The following is Playwright syntax, you can use Playwright to assist in test generation
 import { test as base } from '@playwright/test';
 import type { PlayWrightAiFixtureType } from '@rpascene/web/playwright';
@@ -128,33 +128,33 @@ tasks:
       # Tap an element described by a prompt.
       - aiTap: <prompt>
         deepThink: <boolean> # Optional, whether to use deepThink to precisely locate the element. Defaults to False.
-        xpath: <xpath> # Optional, the xpath of the target element for the operation. If provided, Rpascene will prioritize this xpath to find the element before using the cache and the AI model. Defaults to empty.
+        xpath: <xpath> # Optional, the xpath of the target element for the operation. If provided, Midscene will prioritize this xpath to find the element before using the cache and the AI model. Defaults to empty.
         cacheable: <boolean> # Optional, whether to cache the result of this API call when the [caching feature](./caching.mdx) is enabled. Defaults to True.
 
       # Double click an element described by a prompt.
       - aiDoubleClick: <prompt>
         deepThink: <boolean> # Optional, whether to use deepThink to precisely locate the element. Defaults to False.
-        xpath: <xpath> # Optional, the xpath of the target element for the operation. If provided, Rpascene will prioritize this xpath to find the element before using the cache and the AI model. Defaults to empty.
+        xpath: <xpath> # Optional, the xpath of the target element for the operation. If provided, Midscene will prioritize this xpath to find the element before using the cache and the AI model. Defaults to empty.
         cacheable: <boolean> # Optional, whether to cache the result of this API call when the [caching feature](./caching.mdx) is enabled. Defaults to True.
 
       # Hover over an element described by a prompt.
       - aiHover: <prompt>
         deepThink: <boolean> # Optional, whether to use deepThink to precisely locate the element. Defaults to False.
-        xpath: <xpath> # Optional, the xpath of the target element for the operation. If provided, Rpascene will prioritize this xpath to find the element before using the cache and the AI model. Defaults to empty.
+        xpath: <xpath> # Optional, the xpath of the target element for the operation. If provided, Midscene will prioritize this xpath to find the element before using the cache and the AI model. Defaults to empty.
         cacheable: <boolean> # Optional, whether to cache the result of this API call when the [caching feature](./caching.mdx) is enabled. Defaults to True.
 
       # Input text into an element described by a prompt.
       - aiInput: <final text content of the input>
         locate: <prompt>
         deepThink: <boolean> # Optional, whether to use deepThink to precisely locate the element. Defaults to False.
-        xpath: <xpath> # Optional, the xpath of the target element for the operation. If provided, Rpascene will prioritize this xpath to find the element before using the cache and the AI model. Defaults to empty.
+        xpath: <xpath> # Optional, the xpath of the target element for the operation. If provided, Midscene will prioritize this xpath to find the element before using the cache and the AI model. Defaults to empty.
         cacheable: <boolean> # Optional, whether to cache the result of this API call when the [caching feature](./caching.mdx) is enabled. Defaults to True.
 
       # Press a key (e.g., Enter, Tab, Escape) on an element described by a prompt.
       - aiKeyboardPress: <key>
         locate: <prompt>
         deepThink: <boolean> # Optional, whether to use deepThink to precisely locate the element. Defaults to False.
-        xpath: <xpath> # Optional, the xpath of the target element for the operation. If provided, Rpascene will prioritize this xpath to find the element before using the cache and the AI model. Defaults to empty.
+        xpath: <xpath> # Optional, the xpath of the target element for the operation. If provided, Midscene will prioritize this xpath to find the element before using the cache and the AI model. Defaults to empty.
         cacheable: <boolean> # Optional, whether to cache the result of this API call when the [caching feature](./caching.mdx) is enabled. Defaults to True.
 
       # Scroll globally or on an element described by a prompt.
@@ -164,7 +164,7 @@ tasks:
         distance: <number> # Optional, the scroll distance in pixels.
         locate: <prompt> # Optional, the element to scroll on.
         deepThink: <boolean> # Optional, whether to use deepThink to precisely locate the element. Defaults to False.
-        xpath: <xpath> # Optional, the xpath of the target element for the operation. If provided, Rpascene will prioritize this xpath to find the element before using the cache and the AI model. Defaults to empty.
+        xpath: <xpath> # Optional, the xpath of the target element for the operation. If provided, Midscene will prioritize this xpath to find the element before using the cache and the AI model. Defaults to empty.
         cacheable: <boolean> # Optional, whether to cache the result of this API call when the [caching feature](./caching.mdx) is enabled. Defaults to True.
 
       # Log the current screenshot with a description in the report file.

package/src/constants/index.ts

@@ -47,7 +47,7 @@ export const commandMap: any = {
     DisplayName: "鼠标悬停"
   },
   Input: {
-    CommandName: "SeleniumSetTextCommand",
+    CommandName: "SeleniumSetValueCommand",
     DisplayName: "设置文本"
   },
   KeyboardPress: {

package/src/env/constants.ts

@@ -4,75 +4,75 @@ import {
   AZURE_OPENAI_DEPLOYMENT,
   AZURE_OPENAI_ENDPOINT,
   AZURE_OPENAI_KEY,
-  RPASCENE_ANTHROPIC_API_KEY,
-  RPASCENE_AZURE_OPENAI_API_VERSION,
-  RPASCENE_AZURE_OPENAI_DEPLOYMENT,
-  RPASCENE_AZURE_OPENAI_ENDPOINT,
-  RPASCENE_AZURE_OPENAI_INIT_CONFIG_JSON,
-  RPASCENE_AZURE_OPENAI_KEY,
-  RPASCENE_AZURE_OPENAI_SCOPE,
-  RPASCENE_GROUNDING_ANTHROPIC_API_KEY,
-  RPASCENE_GROUNDING_AZURE_OPENAI_API_VERSION,
-  RPASCENE_GROUNDING_AZURE_OPENAI_DEPLOYMENT,
-  RPASCENE_GROUNDING_AZURE_OPENAI_ENDPOINT,
-  RPASCENE_GROUNDING_AZURE_OPENAI_INIT_CONFIG_JSON,
-  RPASCENE_GROUNDING_AZURE_OPENAI_KEY,
-  RPASCENE_GROUNDING_AZURE_OPENAI_SCOPE,
-  RPASCENE_GROUNDING_MODEL_NAME,
-  RPASCENE_GROUNDING_OPENAI_API_KEY,
-  RPASCENE_GROUNDING_OPENAI_BASE_URL,
-  RPASCENE_GROUNDING_OPENAI_HTTP_PROXY,
-  RPASCENE_GROUNDING_OPENAI_INIT_CONFIG_JSON,
-  RPASCENE_GROUNDING_OPENAI_SOCKS_PROXY,
-  RPASCENE_GROUNDING_OPENAI_USE_AZURE,
-  RPASCENE_GROUNDING_USE_ANTHROPIC_SDK,
-  RPASCENE_GROUNDING_USE_AZURE_OPENAI,
-  RPASCENE_GROUNDING_VL_MODE,
-  RPASCENE_MODEL_NAME,
-  RPASCENE_OPENAI_API_KEY,
-  RPASCENE_OPENAI_BASE_URL,
-  RPASCENE_OPENAI_HTTP_PROXY,
-  RPASCENE_OPENAI_INIT_CONFIG_JSON,
-  RPASCENE_OPENAI_SOCKS_PROXY,
-  RPASCENE_OPENAI_USE_AZURE,
-  RPASCENE_PLANNING_ANTHROPIC_API_KEY,
-  RPASCENE_PLANNING_AZURE_OPENAI_API_VERSION,
-  RPASCENE_PLANNING_AZURE_OPENAI_DEPLOYMENT,
-  RPASCENE_PLANNING_AZURE_OPENAI_ENDPOINT,
-  RPASCENE_PLANNING_AZURE_OPENAI_INIT_CONFIG_JSON,
-  RPASCENE_PLANNING_AZURE_OPENAI_KEY,
-  RPASCENE_PLANNING_AZURE_OPENAI_SCOPE,
-  RPASCENE_PLANNING_MODEL_NAME,
-  RPASCENE_PLANNING_OPENAI_API_KEY,
-  RPASCENE_PLANNING_OPENAI_BASE_URL,
-  RPASCENE_PLANNING_OPENAI_HTTP_PROXY,
-  RPASCENE_PLANNING_OPENAI_INIT_CONFIG_JSON,
-  RPASCENE_PLANNING_OPENAI_SOCKS_PROXY,
-  RPASCENE_PLANNING_OPENAI_USE_AZURE,
-  RPASCENE_PLANNING_USE_ANTHROPIC_SDK,
-  RPASCENE_PLANNING_USE_AZURE_OPENAI,
-  RPASCENE_PLANNING_VL_MODE,
-  RPASCENE_USE_ANTHROPIC_SDK,
-  RPASCENE_USE_AZURE_OPENAI,
-  RPASCENE_VL_MODE,
-  RPASCENE_VQA_ANTHROPIC_API_KEY,
-  RPASCENE_VQA_AZURE_OPENAI_API_VERSION,
-  RPASCENE_VQA_AZURE_OPENAI_DEPLOYMENT,
-  RPASCENE_VQA_AZURE_OPENAI_ENDPOINT,
-  RPASCENE_VQA_AZURE_OPENAI_INIT_CONFIG_JSON,
-  RPASCENE_VQA_AZURE_OPENAI_KEY,
-  RPASCENE_VQA_AZURE_OPENAI_SCOPE,
+  MIDSCENE_ANTHROPIC_API_KEY,
+  MIDSCENE_AZURE_OPENAI_API_VERSION,
+  MIDSCENE_AZURE_OPENAI_DEPLOYMENT,
+  MIDSCENE_AZURE_OPENAI_ENDPOINT,
+  MIDSCENE_AZURE_OPENAI_INIT_CONFIG_JSON,
+  MIDSCENE_AZURE_OPENAI_KEY,
+  MIDSCENE_AZURE_OPENAI_SCOPE,
+  MIDSCENE_GROUNDING_ANTHROPIC_API_KEY,
+  MIDSCENE_GROUNDING_AZURE_OPENAI_API_VERSION,
+  MIDSCENE_GROUNDING_AZURE_OPENAI_DEPLOYMENT,
+  MIDSCENE_GROUNDING_AZURE_OPENAI_ENDPOINT,
+  MIDSCENE_GROUNDING_AZURE_OPENAI_INIT_CONFIG_JSON,
+  MIDSCENE_GROUNDING_AZURE_OPENAI_KEY,
+  MIDSCENE_GROUNDING_AZURE_OPENAI_SCOPE,
+  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_OPENAI_USE_AZURE,
+  MIDSCENE_GROUNDING_USE_ANTHROPIC_SDK,
+  MIDSCENE_GROUNDING_USE_AZURE_OPENAI,
+  MIDSCENE_GROUNDING_VL_MODE,
+  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_OPENAI_USE_AZURE,
+  MIDSCENE_PLANNING_ANTHROPIC_API_KEY,
+  MIDSCENE_PLANNING_AZURE_OPENAI_API_VERSION,
+  MIDSCENE_PLANNING_AZURE_OPENAI_DEPLOYMENT,
+  MIDSCENE_PLANNING_AZURE_OPENAI_ENDPOINT,
+  MIDSCENE_PLANNING_AZURE_OPENAI_INIT_CONFIG_JSON,
+  MIDSCENE_PLANNING_AZURE_OPENAI_KEY,
+  MIDSCENE_PLANNING_AZURE_OPENAI_SCOPE,
+  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_OPENAI_USE_AZURE,
+  MIDSCENE_PLANNING_USE_ANTHROPIC_SDK,
+  MIDSCENE_PLANNING_USE_AZURE_OPENAI,
+  MIDSCENE_PLANNING_VL_MODE,
+  MIDSCENE_USE_ANTHROPIC_SDK,
+  MIDSCENE_USE_AZURE_OPENAI,
+  MIDSCENE_VL_MODE,
+  MIDSCENE_VQA_ANTHROPIC_API_KEY,
+  MIDSCENE_VQA_AZURE_OPENAI_API_VERSION,
+  MIDSCENE_VQA_AZURE_OPENAI_DEPLOYMENT,
+  MIDSCENE_VQA_AZURE_OPENAI_ENDPOINT,
+  MIDSCENE_VQA_AZURE_OPENAI_INIT_CONFIG_JSON,
+  MIDSCENE_VQA_AZURE_OPENAI_KEY,
+  MIDSCENE_VQA_AZURE_OPENAI_SCOPE,
   // VQA
-  RPASCENE_VQA_MODEL_NAME,
-  RPASCENE_VQA_OPENAI_API_KEY,
-  RPASCENE_VQA_OPENAI_BASE_URL,
-  RPASCENE_VQA_OPENAI_HTTP_PROXY,
-  RPASCENE_VQA_OPENAI_INIT_CONFIG_JSON,
-  RPASCENE_VQA_OPENAI_SOCKS_PROXY,
-  RPASCENE_VQA_OPENAI_USE_AZURE,
-  RPASCENE_VQA_USE_ANTHROPIC_SDK,
-  RPASCENE_VQA_USE_AZURE_OPENAI,
-  RPASCENE_VQA_VL_MODE,
+  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_OPENAI_USE_AZURE,
+  MIDSCENE_VQA_USE_ANTHROPIC_SDK,
+  MIDSCENE_VQA_USE_AZURE_OPENAI,
+  MIDSCENE_VQA_VL_MODE,
   OPENAI_API_KEY,
   OPENAI_BASE_URL,
   OPENAI_USE_AZURE,
@@ -114,175 +114,175 @@ interface IModelConfigKeys {
 }
 
 export const VQA_MODEL_CONFIG_KEYS: IModelConfigKeys = {
-  modelName: RPASCENE_VQA_MODEL_NAME,
+  modelName: MIDSCENE_VQA_MODEL_NAME,
   /**
    * proxy
    */
-  socksProxy: RPASCENE_VQA_OPENAI_SOCKS_PROXY,
-  httpProxy: RPASCENE_VQA_OPENAI_HTTP_PROXY,
+  socksProxy: MIDSCENE_VQA_OPENAI_SOCKS_PROXY,
+  httpProxy: MIDSCENE_VQA_OPENAI_HTTP_PROXY,
   /**
    * OpenAI
    */
-  openaiBaseURL: RPASCENE_VQA_OPENAI_BASE_URL,
-  openaiApiKey: RPASCENE_VQA_OPENAI_API_KEY,
-  openaiExtraConfig: RPASCENE_VQA_OPENAI_INIT_CONFIG_JSON,
+  openaiBaseURL: MIDSCENE_VQA_OPENAI_BASE_URL,
+  openaiApiKey: MIDSCENE_VQA_OPENAI_API_KEY,
+  openaiExtraConfig: MIDSCENE_VQA_OPENAI_INIT_CONFIG_JSON,
   /**
    * Azure
    */
-  openaiUseAzureDeprecated: RPASCENE_VQA_OPENAI_USE_AZURE,
-  useAzureOpenai: RPASCENE_VQA_USE_AZURE_OPENAI,
-  azureOpenaiScope: RPASCENE_VQA_AZURE_OPENAI_SCOPE,
-  azureOpenaiKey: RPASCENE_VQA_AZURE_OPENAI_KEY,
-  azureOpenaiEndpoint: RPASCENE_VQA_AZURE_OPENAI_ENDPOINT,
-  azureOpenaiApiVersion: RPASCENE_VQA_AZURE_OPENAI_API_VERSION,
-  azureOpenaiDeployment: RPASCENE_VQA_AZURE_OPENAI_DEPLOYMENT,
-  azureExtraConfig: RPASCENE_VQA_AZURE_OPENAI_INIT_CONFIG_JSON,
+  openaiUseAzureDeprecated: MIDSCENE_VQA_OPENAI_USE_AZURE,
+  useAzureOpenai: MIDSCENE_VQA_USE_AZURE_OPENAI,
+  azureOpenaiScope: MIDSCENE_VQA_AZURE_OPENAI_SCOPE,
+  azureOpenaiKey: MIDSCENE_VQA_AZURE_OPENAI_KEY,
+  azureOpenaiEndpoint: MIDSCENE_VQA_AZURE_OPENAI_ENDPOINT,
+  azureOpenaiApiVersion: MIDSCENE_VQA_AZURE_OPENAI_API_VERSION,
+  azureOpenaiDeployment: MIDSCENE_VQA_AZURE_OPENAI_DEPLOYMENT,
+  azureExtraConfig: MIDSCENE_VQA_AZURE_OPENAI_INIT_CONFIG_JSON,
   /**
    * Anthropic
    */
-  useAnthropicSdk: RPASCENE_VQA_USE_ANTHROPIC_SDK,
-  anthropicApiKey: RPASCENE_VQA_ANTHROPIC_API_KEY,
+  useAnthropicSdk: MIDSCENE_VQA_USE_ANTHROPIC_SDK,
+  anthropicApiKey: MIDSCENE_VQA_ANTHROPIC_API_KEY,
   /**
    * Extra
    */
-  vlMode: RPASCENE_VQA_VL_MODE,
+  vlMode: MIDSCENE_VQA_VL_MODE,
 } as const;
 
 export const GROUNDING_MODEL_CONFIG_KEYS: IModelConfigKeys = {
-  modelName: RPASCENE_GROUNDING_MODEL_NAME,
+  modelName: MIDSCENE_GROUNDING_MODEL_NAME,
   /**
    * proxy
    */
-  socksProxy: RPASCENE_GROUNDING_OPENAI_SOCKS_PROXY,
-  httpProxy: RPASCENE_GROUNDING_OPENAI_HTTP_PROXY,
+  socksProxy: MIDSCENE_GROUNDING_OPENAI_SOCKS_PROXY,
+  httpProxy: MIDSCENE_GROUNDING_OPENAI_HTTP_PROXY,
   /**
    * OpenAI
    */
-  openaiBaseURL: RPASCENE_GROUNDING_OPENAI_BASE_URL,
-  openaiApiKey: RPASCENE_GROUNDING_OPENAI_API_KEY,
-  openaiExtraConfig: RPASCENE_GROUNDING_OPENAI_INIT_CONFIG_JSON,
+  openaiBaseURL: MIDSCENE_GROUNDING_OPENAI_BASE_URL,
+  openaiApiKey: MIDSCENE_GROUNDING_OPENAI_API_KEY,
+  openaiExtraConfig: MIDSCENE_GROUNDING_OPENAI_INIT_CONFIG_JSON,
   /**
    * Azure
    */
-  openaiUseAzureDeprecated: RPASCENE_GROUNDING_OPENAI_USE_AZURE,
-  useAzureOpenai: RPASCENE_GROUNDING_USE_AZURE_OPENAI,
-  azureOpenaiScope: RPASCENE_GROUNDING_AZURE_OPENAI_SCOPE,
-  azureOpenaiKey: RPASCENE_GROUNDING_AZURE_OPENAI_KEY,
-  azureOpenaiEndpoint: RPASCENE_GROUNDING_AZURE_OPENAI_ENDPOINT,
-  azureOpenaiApiVersion: RPASCENE_GROUNDING_AZURE_OPENAI_API_VERSION,
-  azureOpenaiDeployment: RPASCENE_GROUNDING_AZURE_OPENAI_DEPLOYMENT,
-  azureExtraConfig: RPASCENE_GROUNDING_AZURE_OPENAI_INIT_CONFIG_JSON,
+  openaiUseAzureDeprecated: MIDSCENE_GROUNDING_OPENAI_USE_AZURE,
+  useAzureOpenai: MIDSCENE_GROUNDING_USE_AZURE_OPENAI,
+  azureOpenaiScope: MIDSCENE_GROUNDING_AZURE_OPENAI_SCOPE,
+  azureOpenaiKey: MIDSCENE_GROUNDING_AZURE_OPENAI_KEY,
+  azureOpenaiEndpoint: MIDSCENE_GROUNDING_AZURE_OPENAI_ENDPOINT,
+  azureOpenaiApiVersion: MIDSCENE_GROUNDING_AZURE_OPENAI_API_VERSION,
+  azureOpenaiDeployment: MIDSCENE_GROUNDING_AZURE_OPENAI_DEPLOYMENT,
+  azureExtraConfig: MIDSCENE_GROUNDING_AZURE_OPENAI_INIT_CONFIG_JSON,
   /**
    * Anthropic
    */
-  useAnthropicSdk: RPASCENE_GROUNDING_USE_ANTHROPIC_SDK,
-  anthropicApiKey: RPASCENE_GROUNDING_ANTHROPIC_API_KEY,
+  useAnthropicSdk: MIDSCENE_GROUNDING_USE_ANTHROPIC_SDK,
+  anthropicApiKey: MIDSCENE_GROUNDING_ANTHROPIC_API_KEY,
   /**
    * Extra
    */
-  vlMode: RPASCENE_GROUNDING_VL_MODE,
+  vlMode: MIDSCENE_GROUNDING_VL_MODE,
 } as const;
 
 export const PLANNING_MODEL_CONFIG_KEYS: IModelConfigKeys = {
-  modelName: RPASCENE_PLANNING_MODEL_NAME,
+  modelName: MIDSCENE_PLANNING_MODEL_NAME,
   /**
    * proxy
    */
-  socksProxy: RPASCENE_PLANNING_OPENAI_SOCKS_PROXY,
-  httpProxy: RPASCENE_PLANNING_OPENAI_HTTP_PROXY,
+  socksProxy: MIDSCENE_PLANNING_OPENAI_SOCKS_PROXY,
+  httpProxy: MIDSCENE_PLANNING_OPENAI_HTTP_PROXY,
   /**
    * OpenAI
    */
-  openaiBaseURL: RPASCENE_PLANNING_OPENAI_BASE_URL,
-  openaiApiKey: RPASCENE_PLANNING_OPENAI_API_KEY,
-  openaiExtraConfig: RPASCENE_PLANNING_OPENAI_INIT_CONFIG_JSON,
+  openaiBaseURL: MIDSCENE_PLANNING_OPENAI_BASE_URL,
+  openaiApiKey: MIDSCENE_PLANNING_OPENAI_API_KEY,
+  openaiExtraConfig: MIDSCENE_PLANNING_OPENAI_INIT_CONFIG_JSON,
   /**
    * Azure
    */
-  openaiUseAzureDeprecated: RPASCENE_PLANNING_OPENAI_USE_AZURE,
-  useAzureOpenai: RPASCENE_PLANNING_USE_AZURE_OPENAI,
-  azureOpenaiScope: RPASCENE_PLANNING_AZURE_OPENAI_SCOPE,
-  azureOpenaiKey: RPASCENE_PLANNING_AZURE_OPENAI_KEY,
-  azureOpenaiEndpoint: RPASCENE_PLANNING_AZURE_OPENAI_ENDPOINT,
-  azureOpenaiApiVersion: RPASCENE_PLANNING_AZURE_OPENAI_API_VERSION,
-  azureOpenaiDeployment: RPASCENE_PLANNING_AZURE_OPENAI_DEPLOYMENT,
-  azureExtraConfig: RPASCENE_PLANNING_AZURE_OPENAI_INIT_CONFIG_JSON,
+  openaiUseAzureDeprecated: MIDSCENE_PLANNING_OPENAI_USE_AZURE,
+  useAzureOpenai: MIDSCENE_PLANNING_USE_AZURE_OPENAI,
+  azureOpenaiScope: MIDSCENE_PLANNING_AZURE_OPENAI_SCOPE,
+  azureOpenaiKey: MIDSCENE_PLANNING_AZURE_OPENAI_KEY,
+  azureOpenaiEndpoint: MIDSCENE_PLANNING_AZURE_OPENAI_ENDPOINT,
+  azureOpenaiApiVersion: MIDSCENE_PLANNING_AZURE_OPENAI_API_VERSION,
+  azureOpenaiDeployment: MIDSCENE_PLANNING_AZURE_OPENAI_DEPLOYMENT,
+  azureExtraConfig: MIDSCENE_PLANNING_AZURE_OPENAI_INIT_CONFIG_JSON,
   /**
    * Anthropic
    */
-  useAnthropicSdk: RPASCENE_PLANNING_USE_ANTHROPIC_SDK,
-  anthropicApiKey: RPASCENE_PLANNING_ANTHROPIC_API_KEY,
+  useAnthropicSdk: MIDSCENE_PLANNING_USE_ANTHROPIC_SDK,
+  anthropicApiKey: MIDSCENE_PLANNING_ANTHROPIC_API_KEY,
   /**
    * Extra
    */
-  vlMode: RPASCENE_PLANNING_VL_MODE,
+  vlMode: MIDSCENE_PLANNING_VL_MODE,
 } as const;
 
 // modelConfig return default
 export const DEFAULT_MODEL_CONFIG_KEYS: IModelConfigKeys = {
-  modelName: RPASCENE_MODEL_NAME,
+  modelName: MIDSCENE_MODEL_NAME,
   /**
    * proxy
    */
-  socksProxy: RPASCENE_OPENAI_SOCKS_PROXY,
-  httpProxy: RPASCENE_OPENAI_HTTP_PROXY,
+  socksProxy: MIDSCENE_OPENAI_SOCKS_PROXY,
+  httpProxy: MIDSCENE_OPENAI_HTTP_PROXY,
   /**
    * OpenAI
    */
-  openaiBaseURL: RPASCENE_OPENAI_BASE_URL,
-  openaiApiKey: RPASCENE_OPENAI_API_KEY,
-  openaiExtraConfig: RPASCENE_OPENAI_INIT_CONFIG_JSON,
+  openaiBaseURL: MIDSCENE_OPENAI_BASE_URL,
+  openaiApiKey: MIDSCENE_OPENAI_API_KEY,
+  openaiExtraConfig: MIDSCENE_OPENAI_INIT_CONFIG_JSON,
   /**
    * Azure
    */
-  openaiUseAzureDeprecated: RPASCENE_OPENAI_USE_AZURE,
-  useAzureOpenai: RPASCENE_USE_AZURE_OPENAI,
-  azureOpenaiScope: RPASCENE_AZURE_OPENAI_SCOPE,
-  azureOpenaiKey: RPASCENE_AZURE_OPENAI_KEY,
-  azureOpenaiEndpoint: RPASCENE_AZURE_OPENAI_ENDPOINT,
-  azureOpenaiApiVersion: RPASCENE_AZURE_OPENAI_API_VERSION,
-  azureOpenaiDeployment: RPASCENE_AZURE_OPENAI_DEPLOYMENT,
-  azureExtraConfig: RPASCENE_AZURE_OPENAI_INIT_CONFIG_JSON,
+  openaiUseAzureDeprecated: MIDSCENE_OPENAI_USE_AZURE,
+  useAzureOpenai: MIDSCENE_USE_AZURE_OPENAI,
+  azureOpenaiScope: MIDSCENE_AZURE_OPENAI_SCOPE,
+  azureOpenaiKey: MIDSCENE_AZURE_OPENAI_KEY,
+  azureOpenaiEndpoint: MIDSCENE_AZURE_OPENAI_ENDPOINT,
+  azureOpenaiApiVersion: MIDSCENE_AZURE_OPENAI_API_VERSION,
+  azureOpenaiDeployment: MIDSCENE_AZURE_OPENAI_DEPLOYMENT,
+  azureExtraConfig: MIDSCENE_AZURE_OPENAI_INIT_CONFIG_JSON,
   /**
    * Anthropic
    */
-  useAnthropicSdk: RPASCENE_USE_ANTHROPIC_SDK,
-  anthropicApiKey: RPASCENE_ANTHROPIC_API_KEY,
+  useAnthropicSdk: MIDSCENE_USE_ANTHROPIC_SDK,
+  anthropicApiKey: MIDSCENE_ANTHROPIC_API_KEY,
   /**
    * Extra
    */
-  vlMode: RPASCENE_VL_MODE,
+  vlMode: MIDSCENE_VL_MODE,
 } as const;
 
 // read from process.env
 export const DEFAULT_MODEL_CONFIG_KEYS_LEGACY: IModelConfigKeys = {
-  modelName: RPASCENE_MODEL_NAME,
+  modelName: MIDSCENE_MODEL_NAME,
   /**
    * proxy
    */
-  socksProxy: RPASCENE_OPENAI_SOCKS_PROXY,
-  httpProxy: RPASCENE_OPENAI_HTTP_PROXY,
+  socksProxy: MIDSCENE_OPENAI_SOCKS_PROXY,
+  httpProxy: MIDSCENE_OPENAI_HTTP_PROXY,
   /**
    * OpenAI
    */
   openaiBaseURL: OPENAI_BASE_URL,
   openaiApiKey: OPENAI_API_KEY,
-  openaiExtraConfig: RPASCENE_OPENAI_INIT_CONFIG_JSON,
+  openaiExtraConfig: MIDSCENE_OPENAI_INIT_CONFIG_JSON,
   /**
    * Azure
    */
   openaiUseAzureDeprecated: OPENAI_USE_AZURE,
-  useAzureOpenai: RPASCENE_USE_AZURE_OPENAI,
-  azureOpenaiScope: RPASCENE_AZURE_OPENAI_SCOPE,
+  useAzureOpenai: MIDSCENE_USE_AZURE_OPENAI,
+  azureOpenaiScope: MIDSCENE_AZURE_OPENAI_SCOPE,
   azureOpenaiKey: AZURE_OPENAI_KEY,
   azureOpenaiEndpoint: AZURE_OPENAI_ENDPOINT,
   azureOpenaiApiVersion: AZURE_OPENAI_API_VERSION,
   azureOpenaiDeployment: AZURE_OPENAI_DEPLOYMENT,
-  azureExtraConfig: RPASCENE_AZURE_OPENAI_INIT_CONFIG_JSON,
+  azureExtraConfig: MIDSCENE_AZURE_OPENAI_INIT_CONFIG_JSON,
   /**
    * Anthropic
    */
-  useAnthropicSdk: RPASCENE_USE_ANTHROPIC_SDK,
+  useAnthropicSdk: MIDSCENE_USE_ANTHROPIC_SDK,
   anthropicApiKey: ANTHROPIC_API_KEY,
   /**
    * Extra

package/src/env/decide-model-config.ts

@@ -284,7 +284,7 @@ export const decideModelConfigFromEnv = (
 
   debugLog(`decideModelConfig as legacy logic with intent ${intent}.`);
 
-  // TODO: when fallback to legacy logic, prefer to read RPASCENE_OPENAI_API_KEY rather than OPENAI_API_KEY
+  // TODO: when fallback to legacy logic, prefer to read MIDSCENE_OPENAI_API_KEY rather than OPENAI_API_KEY
   const result = decideOpenaiSdkConfig({
     keys: DEFAULT_MODEL_CONFIG_KEYS_LEGACY,
     provider: allEnvConfig,

package/src/env/global-config-manager.ts

@@ -67,7 +67,7 @@ export class GlobalConfigManager {
     }
     if (key === MATCH_BY_POSITION) {
       throw new Error(
-        'MATCH_BY_POSITION is deprecated, use RPASCENE_USE_VL_MODEL instead',
+        'MATCH_BY_POSITION is deprecated, use MIDSCENE_USE_VL_MODEL instead',
       );
     }
     const value = allConfig[key];

package/src/env/init-debug.ts

@@ -1,21 +1,21 @@
 import { enableDebug } from '../logger';
 import { getBasicEnvValue } from './basic';
-import { RPASCENE_DEBUG_AI_PROFILE, RPASCENE_DEBUG_AI_RESPONSE } from './types';
+import { MIDSCENE_DEBUG_AI_PROFILE, MIDSCENE_DEBUG_AI_RESPONSE } from './types';
 
 export const initDebugConfig = () => {
-  const shouldPrintTiming = getBasicEnvValue(RPASCENE_DEBUG_AI_PROFILE);
+  const shouldPrintTiming = getBasicEnvValue(MIDSCENE_DEBUG_AI_PROFILE);
   let debugConfig = '';
   if (shouldPrintTiming) {
     console.warn(
-      'RPASCENE_DEBUG_AI_PROFILE is deprecated, use DEBUG=rpascene:ai:profile instead',
+      'MIDSCENE_DEBUG_AI_PROFILE is deprecated, use DEBUG=midscene:ai:profile instead',
     );
     debugConfig = 'ai:profile';
   }
-  const shouldPrintAIResponse = getBasicEnvValue(RPASCENE_DEBUG_AI_RESPONSE);
+  const shouldPrintAIResponse = getBasicEnvValue(MIDSCENE_DEBUG_AI_RESPONSE);
 
   if (shouldPrintAIResponse) {
     console.warn(
-      'RPASCENE_DEBUG_AI_RESPONSE is deprecated, use DEBUG=rpascene:ai:response instead',
+      'MIDSCENE_DEBUG_AI_RESPONSE is deprecated, use DEBUG=midscene:ai:response instead',
     );
     if (debugConfig) {
       debugConfig = 'ai:*';

package/src/env/model-config-manager.ts

@@ -138,7 +138,7 @@ export class ModelConfigManager {
 
     if (!modelConfig.vlMode) {
       throw new Error(
-        'No visual language model (VL model) detected for the current scenario. Element localization may be inaccurate. Please verify your model configuration. Learn more: https://rpascenejs.com/choose-a-model',
+        'No visual language model (VL model) detected for the current scenario. Element localization may be inaccurate. Please verify your model configuration. Learn more: https://midscenejs.com/choose-a-model',
       );
     }
   }

package/src/env/parse.ts

@@ -1,9 +1,9 @@
 import {
-  RPASCENE_USE_DOUBAO_VISION,
-  RPASCENE_USE_GEMINI,
-  RPASCENE_USE_QWEN3_VL,
-  RPASCENE_USE_QWEN_VL,
-  RPASCENE_USE_VLM_UI_TARS,
+  MIDSCENE_USE_DOUBAO_VISION,
+  MIDSCENE_USE_GEMINI,
+  MIDSCENE_USE_QWEN3_VL,
+  MIDSCENE_USE_QWEN_VL,
+  MIDSCENE_USE_VLM_UI_TARS,
   type TVlModeTypes,
   type TVlModeValues,
   UITarsModelVersion,
@@ -57,18 +57,18 @@ export const parseVlModeAndUiTarsFromGlobalConfig = (
   vlMode?: TVlModeTypes;
   uiTarsVersion?: UITarsModelVersion;
 } => {
-  const isDoubao = provider[RPASCENE_USE_DOUBAO_VISION];
-  const isQwen = provider[RPASCENE_USE_QWEN_VL];
-  const isQwen3 = provider[RPASCENE_USE_QWEN3_VL];
-  const isUiTars = provider[RPASCENE_USE_VLM_UI_TARS];
-  const isGemini = provider[RPASCENE_USE_GEMINI];
+  const isDoubao = provider[MIDSCENE_USE_DOUBAO_VISION];
+  const isQwen = provider[MIDSCENE_USE_QWEN_VL];
+  const isQwen3 = provider[MIDSCENE_USE_QWEN3_VL];
+  const isUiTars = provider[MIDSCENE_USE_VLM_UI_TARS];
+  const isGemini = provider[MIDSCENE_USE_GEMINI];
 
   const enabledModes = [
-    isDoubao && RPASCENE_USE_DOUBAO_VISION,
-    isQwen && RPASCENE_USE_QWEN_VL,
-    isQwen3 && RPASCENE_USE_QWEN3_VL,
-    isUiTars && RPASCENE_USE_VLM_UI_TARS,
-    isGemini && RPASCENE_USE_GEMINI,
+    isDoubao && MIDSCENE_USE_DOUBAO_VISION,
+    isQwen && MIDSCENE_USE_QWEN_VL,
+    isQwen3 && MIDSCENE_USE_QWEN3_VL,
+    isUiTars && MIDSCENE_USE_VLM_UI_TARS,
+    isGemini && MIDSCENE_USE_GEMINI,
   ].filter(Boolean);
 
   if (enabledModes.length > 1) {