@xiuchang-midscene/shared 2.0.2

package/README.md

@@ -0,0 +1,9 @@
+## Documentation
+
+An AI-powered automation SDK can control the page, perform assertions, and extract data in JSON format using natural language.
+
+See https://midscenejs.com/ for details.
+
+## License
+
+Midscene is MIT licensed.

package/dist/es/baseDB.mjs

@@ -0,0 +1,109 @@
+function _define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
+class IndexedDBManager {
+    initDB() {
+        return new Promise((resolve, reject)=>{
+            const request = indexedDB.open(this.dbName, this.version);
+            request.onerror = ()=>reject(request.error);
+            request.onsuccess = ()=>resolve(request.result);
+            request.onupgradeneeded = (event)=>{
+                const db = event.target.result;
+                this.storeConfigs.forEach(({ name, keyPath })=>{
+                    if (!db.objectStoreNames.contains(name)) {
+                        const store = db.createObjectStore(name, {
+                            keyPath
+                        });
+                        store.createIndex('timestamp', 'timestamp', {
+                            unique: false
+                        });
+                    }
+                });
+            };
+        });
+    }
+    async withTransaction(storeNames, mode, operation) {
+        const db = await this.dbPromise;
+        const transaction = db.transaction(storeNames, mode);
+        const stores = Array.isArray(storeNames) ? storeNames.map((name)=>transaction.objectStore(name)) : transaction.objectStore(storeNames);
+        return operation(stores);
+    }
+    promisifyRequest(request) {
+        return new Promise((resolve, reject)=>{
+            request.onsuccess = ()=>resolve(request.result);
+            request.onerror = ()=>reject(request.error);
+        });
+    }
+    async put(storeName, data) {
+        await this.withTransaction(storeName, 'readwrite', async (store)=>{
+            await this.promisifyRequest(store.put(data));
+        });
+    }
+    async get(storeName, key) {
+        return this.withTransaction(storeName, 'readonly', async (store)=>this.promisifyRequest(store.get(key)));
+    }
+    async getAll(storeName, sortByTimestamp = true) {
+        return this.withTransaction(storeName, 'readonly', async (store)=>{
+            const objectStore = store;
+            const results = sortByTimestamp ? await this.promisifyRequest(objectStore.index('timestamp').getAll()) : await this.promisifyRequest(objectStore.getAll());
+            return sortByTimestamp ? results.sort((a, b)=>a.timestamp - b.timestamp) : results;
+        });
+    }
+    async clear(storeName) {
+        await this.withTransaction(storeName, 'readwrite', async (store)=>{
+            await this.promisifyRequest(store.clear());
+        });
+    }
+    async delete(storeName, key) {
+        await this.withTransaction(storeName, 'readwrite', async (store)=>{
+            await this.promisifyRequest(store.delete(key));
+        });
+    }
+    async count(storeName) {
+        return this.withTransaction(storeName, 'readonly', async (store)=>this.promisifyRequest(store.count()));
+    }
+    getDBPromise() {
+        return this.dbPromise;
+    }
+    constructor(dbName, version, storeConfigs){
+        _define_property(this, "dbPromise", void 0);
+        _define_property(this, "dbName", void 0);
+        _define_property(this, "version", void 0);
+        _define_property(this, "storeConfigs", void 0);
+        this.dbName = dbName;
+        this.version = version;
+        this.storeConfigs = storeConfigs;
+        this.dbPromise = this.initDB();
+    }
+}
+const withErrorHandling = async (operation, errorMessage, defaultValue, onQuotaExceeded)=>{
+    try {
+        return await operation();
+    } catch (e) {
+        console.error(errorMessage, e);
+        if (e instanceof Error && 'QuotaExceededError' === e.name && onQuotaExceeded) {
+            console.log('Storage quota exceeded, running cleanup...');
+            await onQuotaExceeded();
+        }
+        return defaultValue;
+    }
+};
+const createCleanupFunction = (dbManager, storeName, maxItems)=>async ()=>{
+        try {
+            const results = await dbManager.getAll(storeName);
+            if (results.length > maxItems) {
+                const toDelete = results.sort((a, b)=>a.timestamp - b.timestamp).slice(0, results.length - maxItems);
+                await Promise.all(toDelete.map((item)=>dbManager.delete(storeName, item.id)));
+            }
+        } catch (e) {
+            console.error(`Failed to cleanup ${storeName}:`, e);
+        }
+    };
+export { IndexedDBManager, createCleanupFunction, withErrorHandling };

package/dist/es/baseDB.mjs.bak

@@ -0,0 +1,109 @@
+function _define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
+class IndexedDBManager {
+    initDB() {
+        return new Promise((resolve, reject)=>{
+            const request = indexedDB.open(this.dbName, this.version);
+            request.onerror = ()=>reject(request.error);
+            request.onsuccess = ()=>resolve(request.result);
+            request.onupgradeneeded = (event)=>{
+                const db = event.target.result;
+                this.storeConfigs.forEach(({ name, keyPath })=>{
+                    if (!db.objectStoreNames.contains(name)) {
+                        const store = db.createObjectStore(name, {
+                            keyPath
+                        });
+                        store.createIndex('timestamp', 'timestamp', {
+                            unique: false
+                        });
+                    }
+                });
+            };
+        });
+    }
+    async withTransaction(storeNames, mode, operation) {
+        const db = await this.dbPromise;
+        const transaction = db.transaction(storeNames, mode);
+        const stores = Array.isArray(storeNames) ? storeNames.map((name)=>transaction.objectStore(name)) : transaction.objectStore(storeNames);
+        return operation(stores);
+    }
+    promisifyRequest(request) {
+        return new Promise((resolve, reject)=>{
+            request.onsuccess = ()=>resolve(request.result);
+            request.onerror = ()=>reject(request.error);
+        });
+    }
+    async put(storeName, data) {
+        await this.withTransaction(storeName, 'readwrite', async (store)=>{
+            await this.promisifyRequest(store.put(data));
+        });
+    }
+    async get(storeName, key) {
+        return this.withTransaction(storeName, 'readonly', async (store)=>this.promisifyRequest(store.get(key)));
+    }
+    async getAll(storeName, sortByTimestamp = true) {
+        return this.withTransaction(storeName, 'readonly', async (store)=>{
+            const objectStore = store;
+            const results = sortByTimestamp ? await this.promisifyRequest(objectStore.index('timestamp').getAll()) : await this.promisifyRequest(objectStore.getAll());
+            return sortByTimestamp ? results.sort((a, b)=>a.timestamp - b.timestamp) : results;
+        });
+    }
+    async clear(storeName) {
+        await this.withTransaction(storeName, 'readwrite', async (store)=>{
+            await this.promisifyRequest(store.clear());
+        });
+    }
+    async delete(storeName, key) {
+        await this.withTransaction(storeName, 'readwrite', async (store)=>{
+            await this.promisifyRequest(store.delete(key));
+        });
+    }
+    async count(storeName) {
+        return this.withTransaction(storeName, 'readonly', async (store)=>this.promisifyRequest(store.count()));
+    }
+    getDBPromise() {
+        return this.dbPromise;
+    }
+    constructor(dbName, version, storeConfigs){
+        _define_property(this, "dbPromise", void 0);
+        _define_property(this, "dbName", void 0);
+        _define_property(this, "version", void 0);
+        _define_property(this, "storeConfigs", void 0);
+        this.dbName = dbName;
+        this.version = version;
+        this.storeConfigs = storeConfigs;
+        this.dbPromise = this.initDB();
+    }
+}
+const withErrorHandling = async (operation, errorMessage, defaultValue, onQuotaExceeded)=>{
+    try {
+        return await operation();
+    } catch (e) {
+        console.error(errorMessage, e);
+        if (e instanceof Error && 'QuotaExceededError' === e.name && onQuotaExceeded) {
+            console.log('Storage quota exceeded, running cleanup...');
+            await onQuotaExceeded();
+        }
+        return defaultValue;
+    }
+};
+const createCleanupFunction = (dbManager, storeName, maxItems)=>async ()=>{
+        try {
+            const results = await dbManager.getAll(storeName);
+            if (results.length > maxItems) {
+                const toDelete = results.sort((a, b)=>a.timestamp - b.timestamp).slice(0, results.length - maxItems);
+                await Promise.all(toDelete.map((item)=>dbManager.delete(storeName, item.id)));
+            }
+        } catch (e) {
+            console.error(`Failed to cleanup ${storeName}:`, e);
+        }
+    };
+export { IndexedDBManager, createCleanupFunction, withErrorHandling };

package/dist/es/build/copy-static.mjs

@@ -0,0 +1,31 @@
+import node_fs from "node:fs";
+import node_path from "node:path";
+const createCopyStaticPlugin = (options)=>({
+        name: options.pluginName || 'copy-static',
+        setup (api) {
+            api.onAfterBuild(async ()=>{
+                const { srcDir, destDir, faviconPath } = options;
+                const stat = await node_fs.promises.lstat(destDir).catch(()=>null);
+                if (stat?.isSymbolicLink()) await node_fs.promises.unlink(destDir);
+                await node_fs.promises.mkdir(destDir, {
+                    recursive: true
+                });
+                await node_fs.promises.cp(srcDir, destDir, {
+                    recursive: true
+                });
+                console.log(`Copied build artifacts from ${srcDir} to ${destDir}`);
+                if (faviconPath) {
+                    const faviconDest = node_path.join(destDir, 'favicon.ico');
+                    await node_fs.promises.copyFile(faviconPath, faviconDest);
+                    console.log(`Copied favicon from ${faviconPath} to ${faviconDest}`);
+                }
+            });
+        }
+    });
+const createPlaygroundCopyPlugin = (srcDir, destDir, pluginName, faviconSrc)=>createCopyStaticPlugin({
+        srcDir,
+        destDir,
+        faviconPath: faviconSrc,
+        pluginName
+    });
+export { createCopyStaticPlugin, createPlaygroundCopyPlugin };

package/dist/es/build/copy-static.mjs.bak

@@ -0,0 +1,31 @@
+import node_fs from "node:fs";
+import node_path from "node:path";
+const createCopyStaticPlugin = (options)=>({
+        name: options.pluginName || 'copy-static',
+        setup (api) {
+            api.onAfterBuild(async ()=>{
+                const { srcDir, destDir, faviconPath } = options;
+                const stat = await node_fs.promises.lstat(destDir).catch(()=>null);
+                if (stat?.isSymbolicLink()) await node_fs.promises.unlink(destDir);
+                await node_fs.promises.mkdir(destDir, {
+                    recursive: true
+                });
+                await node_fs.promises.cp(srcDir, destDir, {
+                    recursive: true
+                });
+                console.log(`Copied build artifacts from ${srcDir} to ${destDir}`);
+                if (faviconPath) {
+                    const faviconDest = node_path.join(destDir, 'favicon.ico');
+                    await node_fs.promises.copyFile(faviconPath, faviconDest);
+                    console.log(`Copied favicon from ${faviconPath} to ${faviconDest}`);
+                }
+            });
+        }
+    });
+const createPlaygroundCopyPlugin = (srcDir, destDir, pluginName, faviconSrc)=>createCopyStaticPlugin({
+        srcDir,
+        destDir,
+        faviconPath: faviconSrc,
+        pluginName
+    });
+export { createCopyStaticPlugin, createPlaygroundCopyPlugin };

package/dist/es/build/rspack-config.mjs

@@ -0,0 +1,4 @@
+const commonIgnoreWarnings = [
+    /Critical dependency: the request of a dependency is an expression/
+];
+export { commonIgnoreWarnings };

package/dist/es/build/rspack-config.mjs.bak

@@ -0,0 +1,4 @@
+const commonIgnoreWarnings = [
+    /Critical dependency: the request of a dependency is an expression/
+];
+export { commonIgnoreWarnings };

package/dist/es/cli/cli-runner.mjs

@@ -0,0 +1,140 @@
+import { existsSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import dotenv from "dotenv";
+import { getDebug } from "../logger.mjs";
+function _define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
+const debug = getDebug('cli-runner');
+class CLIError extends Error {
+    constructor(message, exitCode = 1){
+        super(message), _define_property(this, "exitCode", void 0), this.exitCode = exitCode;
+    }
+}
+function parseValue(raw) {
+    if (raw.startsWith('{') || raw.startsWith('[')) try {
+        return JSON.parse(raw);
+    } catch  {}
+    if (/^-?\d+(\.\d+)?$/.test(raw)) return Number(raw);
+    return raw;
+}
+function parseCliArgs(args) {
+    const result = {};
+    for(let i = 0; i < args.length; i++){
+        const arg = args[i];
+        if (!arg.startsWith('--')) continue;
+        const body = arg.slice(2);
+        const eqIdx = body.indexOf('=');
+        if (eqIdx >= 0) result[body.slice(0, eqIdx)] = parseValue(body.slice(eqIdx + 1));
+        else if (args[i + 1] && !args[i + 1].startsWith('--')) {
+            i++;
+            result[body] = parseValue(args[i]);
+        } else result[body] = true;
+    }
+    return result;
+}
+function outputContentItem(item, isError) {
+    switch(item.type){
+        case 'text':
+            if (isError) console.error(item.text);
+            else console.log(item.text);
+            break;
+        case 'image':
+            {
+                const filename = `screenshot-${Date.now()}.png`;
+                const filepath = join(tmpdir(), filename);
+                writeFileSync(filepath, Buffer.from(item.data, 'base64'));
+                console.log(`Screenshot saved: ${filepath}`);
+                break;
+            }
+        default:
+            console.log(`[${item.type} content not displayed in CLI]`);
+    }
+}
+function outputResult(result) {
+    for (const item of result.content)outputContentItem(item, result.isError ?? false);
+}
+function removePrefix(name, prefix) {
+    if (prefix && name.startsWith(prefix)) return name.slice(prefix.length);
+    return name;
+}
+function printCommandHelp(scriptName, cmd) {
+    const { def } = cmd;
+    console.log(`\nUsage: ${scriptName} ${cmd.name} [options]\n`);
+    console.log(def.description);
+    const schemaEntries = Object.entries(def.schema);
+    if (schemaEntries.length > 0) {
+        console.log('\nOptions:');
+        for (const [key, zodType] of schemaEntries){
+            const desc = zodType.description ?? '';
+            console.log(`  --${key.padEnd(20)} ${desc}`);
+        }
+    }
+}
+function printVersion(scriptName, version) {
+    console.log(`${scriptName} v${version}`);
+}
+function printHelp(scriptName, commands, version) {
+    if (version) {
+        printVersion(scriptName, version);
+        console.log('');
+    }
+    console.log(`\nUsage: ${scriptName} <command> [options]\n`);
+    console.log('Commands:');
+    for (const { name, def } of commands)console.log(`  ${name.padEnd(30)} ${def.description}`);
+    console.log(`  ${'version'.padEnd(30)} Show CLI version`);
+    console.log(`\nRun "${scriptName} <command> --help" for more info.`);
+}
+async function runToolsCLI(tools, scriptName, options) {
+    const rawArgs = options?.argv ?? process.argv.slice(2);
+    debug('CLI invoked: %s %s', scriptName, rawArgs.join(' '));
+    const envFile = join(process.cwd(), '.env');
+    if (existsSync(envFile)) dotenv.config({
+        path: envFile
+    });
+    await tools.initTools();
+    const commands = tools.getToolDefinitions().map((def)=>({
+            name: removePrefix(def.name, options?.stripPrefix).toLowerCase(),
+            def
+        }));
+    const cliVersion = options?.version;
+    const [commandName, ...restArgs] = rawArgs;
+    if (!commandName || '--help' === commandName || '-h' === commandName) {
+        debug('showing help (no command or --help flag)');
+        printHelp(scriptName, commands, cliVersion);
+        return;
+    }
+    if ('--version' === commandName || '-v' === commandName || 'version' === commandName.toLowerCase()) {
+        if (!cliVersion) throw new CLIError('Failed to determine CLI version');
+        printVersion(scriptName, cliVersion);
+        return;
+    }
+    const match = commands.find((c)=>c.name.toLowerCase() === commandName.toLowerCase());
+    if (!match) {
+        debug('unknown command: %s', commandName);
+        console.error(`Unknown command: ${commandName}`);
+        printHelp(scriptName, commands, cliVersion);
+        throw new CLIError(`Unknown command: ${commandName}`);
+    }
+    const parsedArgs = parseCliArgs(restArgs);
+    debug('command: %s, args: %s', match.name, JSON.stringify(parsedArgs));
+    if (true === parsedArgs.help) {
+        debug('showing command help for: %s', match.name);
+        printCommandHelp(scriptName, match);
+        return;
+    }
+    const result = await match.def.handler(parsedArgs);
+    debug('command %s completed, isError: %s', match.name, result.isError ?? false);
+    outputResult(result);
+    await tools.destroy();
+    if (result.isError) throw new CLIError('Command failed', 1);
+}
+export { CLIError, parseCliArgs, parseValue, removePrefix, runToolsCLI };

package/dist/es/cli/cli-runner.mjs.bak

@@ -0,0 +1,140 @@
+import { existsSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import dotenv from "dotenv";
+import { getDebug } from "../logger.mjs";
+function _define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
+const debug = getDebug('cli-runner');
+class CLIError extends Error {
+    constructor(message, exitCode = 1){
+        super(message), _define_property(this, "exitCode", void 0), this.exitCode = exitCode;
+    }
+}
+function parseValue(raw) {
+    if (raw.startsWith('{') || raw.startsWith('[')) try {
+        return JSON.parse(raw);
+    } catch  {}
+    if (/^-?\d+(\.\d+)?$/.test(raw)) return Number(raw);
+    return raw;
+}
+function parseCliArgs(args) {
+    const result = {};
+    for(let i = 0; i < args.length; i++){
+        const arg = args[i];
+        if (!arg.startsWith('--')) continue;
+        const body = arg.slice(2);
+        const eqIdx = body.indexOf('=');
+        if (eqIdx >= 0) result[body.slice(0, eqIdx)] = parseValue(body.slice(eqIdx + 1));
+        else if (args[i + 1] && !args[i + 1].startsWith('--')) {
+            i++;
+            result[body] = parseValue(args[i]);
+        } else result[body] = true;
+    }
+    return result;
+}
+function outputContentItem(item, isError) {
+    switch(item.type){
+        case 'text':
+            if (isError) console.error(item.text);
+            else console.log(item.text);
+            break;
+        case 'image':
+            {
+                const filename = `screenshot-${Date.now()}.png`;
+                const filepath = join(tmpdir(), filename);
+                writeFileSync(filepath, Buffer.from(item.data, 'base64'));
+                console.log(`Screenshot saved: ${filepath}`);
+                break;
+            }
+        default:
+            console.log(`[${item.type} content not displayed in CLI]`);
+    }
+}
+function outputResult(result) {
+    for (const item of result.content)outputContentItem(item, result.isError ?? false);
+}
+function removePrefix(name, prefix) {
+    if (prefix && name.startsWith(prefix)) return name.slice(prefix.length);
+    return name;
+}
+function printCommandHelp(scriptName, cmd) {
+    const { def } = cmd;
+    console.log(`\nUsage: ${scriptName} ${cmd.name} [options]\n`);
+    console.log(def.description);
+    const schemaEntries = Object.entries(def.schema);
+    if (schemaEntries.length > 0) {
+        console.log('\nOptions:');
+        for (const [key, zodType] of schemaEntries){
+            const desc = zodType.description ?? '';
+            console.log(`  --${key.padEnd(20)} ${desc}`);
+        }
+    }
+}
+function printVersion(scriptName, version) {
+    console.log(`${scriptName} v${version}`);
+}
+function printHelp(scriptName, commands, version) {
+    if (version) {
+        printVersion(scriptName, version);
+        console.log('');
+    }
+    console.log(`\nUsage: ${scriptName} <command> [options]\n`);
+    console.log('Commands:');
+    for (const { name, def } of commands)console.log(`  ${name.padEnd(30)} ${def.description}`);
+    console.log(`  ${'version'.padEnd(30)} Show CLI version`);
+    console.log(`\nRun "${scriptName} <command> --help" for more info.`);
+}
+async function runToolsCLI(tools, scriptName, options) {
+    const rawArgs = options?.argv ?? process.argv.slice(2);
+    debug('CLI invoked: %s %s', scriptName, rawArgs.join(' '));
+    const envFile = join(process.cwd(), '.env');
+    if (existsSync(envFile)) dotenv.config({
+        path: envFile
+    });
+    await tools.initTools();
+    const commands = tools.getToolDefinitions().map((def)=>({
+            name: removePrefix(def.name, options?.stripPrefix).toLowerCase(),
+            def
+        }));
+    const cliVersion = options?.version;
+    const [commandName, ...restArgs] = rawArgs;
+    if (!commandName || '--help' === commandName || '-h' === commandName) {
+        debug('showing help (no command or --help flag)');
+        printHelp(scriptName, commands, cliVersion);
+        return;
+    }
+    if ('--version' === commandName || '-v' === commandName || 'version' === commandName.toLowerCase()) {
+        if (!cliVersion) throw new CLIError('Failed to determine CLI version');
+        printVersion(scriptName, cliVersion);
+        return;
+    }
+    const match = commands.find((c)=>c.name.toLowerCase() === commandName.toLowerCase());
+    if (!match) {
+        debug('unknown command: %s', commandName);
+        console.error(`Unknown command: ${commandName}`);
+        printHelp(scriptName, commands, cliVersion);
+        throw new CLIError(`Unknown command: ${commandName}`);
+    }
+    const parsedArgs = parseCliArgs(restArgs);
+    debug('command: %s, args: %s', match.name, JSON.stringify(parsedArgs));
+    if (true === parsedArgs.help) {
+        debug('showing command help for: %s', match.name);
+        printCommandHelp(scriptName, match);
+        return;
+    }
+    const result = await match.def.handler(parsedArgs);
+    debug('command %s completed, isError: %s', match.name, result.isError ?? false);
+    outputResult(result);
+    await tools.destroy();
+    if (result.isError) throw new CLIError('Command failed', 1);
+}
+export { CLIError, parseCliArgs, parseValue, removePrefix, runToolsCLI };

package/dist/es/cli/index.mjs

@@ -0,0 +1,2 @@
+import { CLIError, parseCliArgs, parseValue, removePrefix, runToolsCLI } from "./cli-runner.mjs";
+export { CLIError, parseCliArgs, parseValue, removePrefix, runToolsCLI };

package/dist/es/cli/index.mjs.bak

@@ -0,0 +1,2 @@
+import { CLIError, parseCliArgs, parseValue, removePrefix, runToolsCLI } from "./cli-runner.mjs";
+export { CLIError, parseCliArgs, parseValue, removePrefix, runToolsCLI };

package/dist/es/common.mjs

@@ -0,0 +1,37 @@
+import { existsSync, mkdirSync } from "node:fs";
+import { tmpdir } from "node:os";
+import node_path from "node:path";
+import { getBasicEnvValue } from "./env/basic.mjs";
+import { MIDSCENE_RUN_DIR } from "./env/types.mjs";
+import { ifInNode } from "./utils.mjs";
+const defaultRunDirName = 'midscene_run';
+const getMidsceneRunDir = ()=>{
+    if (!ifInNode) return '';
+    return getBasicEnvValue(MIDSCENE_RUN_DIR) || defaultRunDirName;
+};
+const getMidsceneRunBaseDir = ()=>{
+    if (!ifInNode) return '';
+    let basePath = node_path.resolve(process.cwd(), getMidsceneRunDir());
+    if (!existsSync(basePath)) try {
+        mkdirSync(basePath, {
+            recursive: true
+        });
+    } catch (error) {
+        basePath = node_path.join(tmpdir(), defaultRunDirName);
+        mkdirSync(basePath, {
+            recursive: true
+        });
+    }
+    return basePath;
+};
+const getMidsceneRunSubDir = (subdir)=>{
+    if (!ifInNode) return '';
+    const basePath = getMidsceneRunBaseDir();
+    const logPath = node_path.join(basePath, subdir);
+    if (!existsSync(logPath)) mkdirSync(logPath, {
+        recursive: true
+    });
+    return logPath;
+};
+const ERROR_CODE_NOT_IMPLEMENTED_AS_DESIGNED = 'NOT_IMPLEMENTED_AS_DESIGNED';
+export { ERROR_CODE_NOT_IMPLEMENTED_AS_DESIGNED, defaultRunDirName, getMidsceneRunBaseDir, getMidsceneRunDir, getMidsceneRunSubDir };

package/dist/es/common.mjs.bak

@@ -0,0 +1,37 @@
+import { existsSync, mkdirSync } from "node:fs";
+import { tmpdir } from "node:os";
+import node_path from "node:path";
+import { getBasicEnvValue } from "./env/basic.mjs";
+import { MIDSCENE_RUN_DIR } from "./env/types.mjs";
+import { ifInNode } from "./utils.mjs";
+const defaultRunDirName = 'midscene_run';
+const getMidsceneRunDir = ()=>{
+    if (!ifInNode) return '';
+    return getBasicEnvValue(MIDSCENE_RUN_DIR) || defaultRunDirName;
+};
+const getMidsceneRunBaseDir = ()=>{
+    if (!ifInNode) return '';
+    let basePath = node_path.resolve(process.cwd(), getMidsceneRunDir());
+    if (!existsSync(basePath)) try {
+        mkdirSync(basePath, {
+            recursive: true
+        });
+    } catch (error) {
+        basePath = node_path.join(tmpdir(), defaultRunDirName);
+        mkdirSync(basePath, {
+            recursive: true
+        });
+    }
+    return basePath;
+};
+const getMidsceneRunSubDir = (subdir)=>{
+    if (!ifInNode) return '';
+    const basePath = getMidsceneRunBaseDir();
+    const logPath = node_path.join(basePath, subdir);
+    if (!existsSync(logPath)) mkdirSync(logPath, {
+        recursive: true
+    });
+    return logPath;
+};
+const ERROR_CODE_NOT_IMPLEMENTED_AS_DESIGNED = 'NOT_IMPLEMENTED_AS_DESIGNED';
+export { ERROR_CODE_NOT_IMPLEMENTED_AS_DESIGNED, defaultRunDirName, getMidsceneRunBaseDir, getMidsceneRunDir, getMidsceneRunSubDir };