@xenon-device-management/xenon 1.1.0

package/lib/src/app/swagger.js

@@ -0,0 +1,366 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.swaggerSpec = void 0;
+exports.setupSwagger = setupSwagger;
+const swagger_jsdoc_1 = __importDefault(require("swagger-jsdoc"));
+const swagger_ui_express_1 = __importDefault(require("swagger-ui-express"));
+const swaggerDefinition = {
+    openapi: '3.0.0',
+    servers: [
+        {
+            url: '/xenon',
+            description: 'Local Grid Node Registry',
+        },
+    ],
+    info: {
+        title: 'Xenon API',
+        version: '1.0.0',
+        description: `
+# Xenon Edge • Intelligent Infrastructure API
+**The foundation for autonomous mobile device orchestration.**
+
+Xenon's high-performance API provides programmatic access to the core orchestration engine, enabling complex automation workflows for distributed device farms.
+
+### Key Capabilities:
+*   **Elastic Device Grid**: Real-time discovery and state management of physical nodes.
+*   **Autonomous Sessions**: Self-healing Appium session management with automated retries.
+*   **Deep Control**: Direct low-latency interaction logic (Input injection, thermal monitoring).
+*   **Security Protocol**: Industrial-grade isolation for sensitive test environments.
+
+---
+Currently operating in **OSS Mode**. Future releases will support **Xenon Identity (JWT)** for secure fleet-wide propagation.
+        `,
+        contact: {
+            name: 'Xenon Architecture Team',
+            url: 'https://github.com/xenon-platform/xenon',
+        },
+        license: {
+            name: 'ISC License',
+            url: 'https://opensource.org/licenses/ISC',
+        },
+    },
+    tags: [
+        { name: 'Devices', description: 'Real-time grid discovery' },
+        { name: 'Sessions', description: 'Orchestration & Logs' },
+        { name: 'Builds', description: 'Telemetry tracking' },
+        { name: 'Control', description: 'Direct interaction engine' },
+        { name: 'Reservations', description: 'Resource locking' },
+        { name: 'Applications', description: 'Artifact management' },
+        { name: 'Grid', description: 'Cluster topology' },
+        { name: 'Webhooks', description: 'Event propagation' },
+        { name: 'Configuration', description: 'Edge node parameters' },
+    ],
+    components: {
+        schemas: {
+            Device: {
+                type: 'object',
+                properties: {
+                    udid: {
+                        type: 'string',
+                        description: 'Unique identity',
+                        example: '00008110-00084CE80E51401E',
+                    },
+                    name: { type: 'string', example: 'iPhone 14 Pro' },
+                    platform: { type: 'string', enum: ['ios', 'android'] },
+                    host: { type: 'string', example: '192.168.1.100' },
+                    busy: { type: 'boolean' },
+                    session_id: { type: 'string', nullable: true },
+                    state: { type: 'string' },
+                    sdk: { type: 'string', example: '17.0' },
+                    deviceType: { type: 'string' },
+                },
+            },
+            // ... (rest of schemas remain same for internal completeness)
+            Session: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string' },
+                    name: { type: 'string' },
+                    status: { type: 'string', enum: ['running', 'success', 'failed'] },
+                    device_udid: { type: 'string' },
+                    device_name: { type: 'string' },
+                    device_platform: { type: 'string' },
+                    createdAt: { type: 'string', format: 'date-time' },
+                },
+            },
+            Build: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string' },
+                    name: { type: 'string' },
+                    sessionCount: { type: 'integer' },
+                    passedCount: { type: 'integer' },
+                    failedCount: { type: 'integer' },
+                    runningCount: { type: 'integer' },
+                    createdAt: { type: 'string', format: 'date-time' },
+                },
+            },
+            Reservation: {
+                type: 'object',
+                properties: {
+                    udid: { type: 'string' },
+                    host: { type: 'string' },
+                    reservedBy: { type: 'string' },
+                    reservedUntil: { type: 'integer' },
+                    reservationReason: { type: 'string' },
+                    remainingMs: { type: 'integer' },
+                },
+            },
+            App: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string' },
+                    name: { type: 'string' },
+                    filename: { type: 'string' },
+                    filepath: { type: 'string' },
+                    platform: { type: 'string', enum: ['ios', 'android'] },
+                    uploadedAt: { type: 'string', format: 'date-time' },
+                },
+            },
+            WebhookConfig: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string' },
+                    url: { type: 'string', format: 'uri' },
+                    events: { type: 'array', items: { type: 'string' } },
+                    type: { type: 'string', enum: ['slack', 'webhook'] },
+                },
+            },
+            LocatorSuggestion: {
+                type: 'object',
+                properties: {
+                    strategy: { type: 'string' },
+                    value: { type: 'string' },
+                    priority: { type: 'integer' },
+                    isUnique: { type: 'boolean' },
+                },
+            },
+            InspectorNode: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string' },
+                    type: { type: 'string' },
+                    text: { type: 'string' },
+                    path: { type: 'string' },
+                    rect: {
+                        type: 'object',
+                        properties: {
+                            x: { type: 'number' },
+                            y: { type: 'number' },
+                            width: { type: 'number' },
+                            height: { type: 'number' },
+                        },
+                    },
+                    attributes: { type: 'object', additionalProperties: true },
+                    locators: {
+                        type: 'array',
+                        items: { $ref: '#/components/schemas/LocatorSuggestion' },
+                    },
+                    children: {
+                        type: 'array',
+                        items: { $ref: '#/components/schemas/InspectorNode' },
+                    },
+                },
+            },
+            InspectorSnapshot: {
+                type: 'object',
+                properties: {
+                    udid: { type: 'string' },
+                    platform: { type: 'string' },
+                    screenshot: { type: 'string', description: 'Base64 encoded screenshot' },
+                    root: { $ref: '#/components/schemas/InspectorNode' },
+                },
+            },
+            Error: {
+                type: 'object',
+                properties: {
+                    error: { type: 'boolean', example: true },
+                    message: { type: 'string' },
+                },
+            },
+            Success: {
+                type: 'object',
+                properties: {
+                    success: { type: 'boolean', example: true },
+                },
+            },
+        },
+    },
+};
+const path_1 = __importDefault(require("path"));
+// @ts-ignore - Types will be available after package install
+const options = {
+    swaggerDefinition,
+    apis: [
+        // Load from compiled JS (execution runtime)
+        path_1.default.join(__dirname, 'swagger-docs.js'),
+        path_1.default.join(__dirname, 'routers', '*.js'),
+        // Fallback to TS source (development environment)
+        path_1.default.join(__dirname, '..', '..', '..', 'src', 'app', 'swagger-docs.ts'),
+        path_1.default.join(__dirname, '..', '..', '..', 'src', 'app', 'routers', '*.ts'),
+    ],
+};
+const swaggerSpec = (0, swagger_jsdoc_1.default)(options);
+exports.swaggerSpec = swaggerSpec;
+function setupSwagger(app, basePath = '/xenon') {
+    // Serve Swagger UI at /xenon/api-docs
+    app.use('/api-docs', swagger_ui_express_1.default.serve, swagger_ui_express_1.default.setup(swaggerSpec, {
+        customCss: `
+        /* Xenon Ultimate V2 • High-Integrity API Documentation */
+        @import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=Outfit:wght@500;600;700;800&family=JetBrains+Mono:wght@500;700&display=swap');
+
+        :root {
+          --xenon-bg: #020617;
+          --xenon-surface: #0f172a;
+          --xenon-surface-hover: #1e293b;
+          --xenon-border: rgba(255, 255, 255, 0.05);
+          --xenon-border-bright: rgba(255, 255, 255, 0.12);
+          --xenon-emerald: #22c55e;
+          --xenon-emerald-glow: rgba(34, 197, 94, 0.2);
+          --xenon-blue: #38bdf8;
+          --xenon-blue-glow: rgba(56, 189, 248, 0.2);
+          --xenon-amber: #fbbf24;
+          --xenon-amber-glow: rgba(251, 191, 36, 0.2);
+          --xenon-crimson: #f43f5e;
+          --xenon-crimson-glow: rgba(244, 63, 94, 0.2);
+          --xenon-text: #f8fafc;
+          --xenon-text-dim: #94a3b8;
+          --xenon-text-dark: #475569;
+        }
+
+        body { background: var(--xenon-bg) !important; margin: 0; font-family: 'Inter', sans-serif !important; -webkit-font-smoothing: antialiased; }
+        .swagger-ui { background: var(--xenon-bg) !important; color: var(--xenon-text) !important; padding-bottom: 80px; }
+        
+        /* Layout & Spacing */
+        .swagger-ui .wrapper { max-width: 1100px; padding: 0 40px; }
+        .swagger-ui .topbar { display: none; }
+        
+        /* Header & Info */
+        .swagger-ui .info { margin: 80px 0 40px 0; }
+        .swagger-ui .info .title { 
+            font-family: 'Outfit', sans-serif; 
+            font-size: 52px; 
+            font-weight: 800; 
+            color: #fff !important; 
+            letter-spacing: -0.04em; 
+            margin-bottom: 24px;
+            background: linear-gradient(to bottom right, #fff 30%, var(--xenon-text-dim));
+            -webkit-background-clip: text;
+            -webkit-text-fill-color: transparent;
+        }
+        .swagger-ui .info p { font-size: 18px; color: var(--xenon-text-dim) !important; line-height: 1.8; max-width: 700px; margin-bottom: 32px; }
+        .swagger-ui .info code { background: #18181b; color: var(--xenon-emerald); padding: 4px 8px; border-radius: 6px; font-family: 'JetBrains Mono', monospace; font-size: 14px; }
+        
+        /* Server Selection Card */
+        .swagger-ui .scheme-container { 
+            background: var(--xenon-surface) !important; 
+            border: 1px solid var(--xenon-border); 
+            border-radius: 20px; 
+            padding: 32px; 
+            box-shadow: 0 20px 40px rgba(0,0,0,0.5), inset 0 1px 1px rgba(255,255,255,0.05);
+            margin: 40px 0;
+        }
+        .swagger-ui .servers-title { color: #fff !important; font-family: 'Outfit', sans-serif; font-size: 14px; text-transform: uppercase; letter-spacing: 0.1em; opacity: 0.5; margin-bottom: 12px; }
+        .swagger-ui .servers select { background: #000 !important; border: 1px solid var(--xenon-border-bright) !important; color: var(--xenon-text) !important; border-radius: 10px !important; padding: 12px !important; width: 100%; max-width: 400px; }
+
+        /* Operations & Methods */
+        .swagger-ui .opblock-tag { 
+            font-family: 'Outfit', sans-serif; 
+            border: none; 
+            color: #fff !important; 
+            font-size: 24px; 
+            font-weight: 700; 
+            margin: 60px 0 24px 0; 
+            padding: 0; 
+            display: flex;
+            align-items: center;
+            gap: 12px;
+        }
+        .swagger-ui .opblock-tag small { color: var(--xenon-text-dim) !important; font-size: 14px; font-weight: 400; text-transform: none; letter-spacing: 0; margin-left: auto; }
+        
+        .swagger-ui .opblock { 
+            border: 1px solid var(--xenon-border) !important; 
+            background: var(--xenon-surface) !important; 
+            border-radius: 16px !important; 
+            margin-bottom: 16px !important; 
+            box-shadow: 0 4px 12px rgba(0,0,0,0.2); 
+            transition: all 0.25s cubic-bezier(0.4, 0, 0.2, 1) !important;
+            overflow: hidden;
+        }
+        .swagger-ui .opblock:hover { 
+            border-color: var(--xenon-border-bright) !important; 
+            transform: translateY(-2px); 
+            box-shadow: 0 12px 24px rgba(0,0,0,0.4); 
+            background: var(--xenon-surface-hover) !important;
+        }
+        .swagger-ui .opblock-summary { padding: 16px 24px; border-bottom: none !important; }
+        
+        /* Semantic Method Glows */
+        .swagger-ui .opblock-summary-method { 
+            border-radius: 8px !important; 
+            border: none !important; 
+            font-family: 'JetBrains Mono', monospace !important; 
+            font-weight: 800 !important; 
+            font-size: 13px !important; 
+            min-width: 85px !important; 
+            padding: 6px 0 !important;
+            box-shadow: inset 0 1px 1px rgba(255,255,255,0.2) !important;
+        }
+        
+        /* GET */
+        .swagger-ui .opblock.opblock-get .opblock-summary-method { background: var(--xenon-blue) !important; box-shadow: 0 0 15px var(--xenon-blue-glow), inset 0 1px 1px rgba(255,255,255,0.2) !important; }
+        .swagger-ui .opblock.opblock-get:hover { border-color: var(--xenon-blue) !important; }
+        /* POST */
+        .swagger-ui .opblock.opblock-post .opblock-summary-method { background: var(--xenon-emerald) !important; box-shadow: 0 0 15px var(--xenon-emerald-glow), inset 0 1px 1px rgba(255,255,255,0.2) !important; }
+        .swagger-ui .opblock.opblock-post:hover { border-color: var(--xenon-emerald) !important; }
+        /* PUT */
+        .swagger-ui .opblock.opblock-put .opblock-summary-method { background: var(--xenon-amber) !important; box-shadow: 0 0 15px var(--xenon-amber-glow), inset 0 1px 1px rgba(255,255,255,0.2) !important; }
+        .swagger-ui .opblock.opblock-put:hover { border-color: var(--xenon-amber) !important; }
+        /* DELETE */
+        .swagger-ui .opblock.opblock-delete .opblock-summary-method { background: var(--xenon-crimson) !important; box-shadow: 0 0 15px var(--xenon-crimson-glow), inset 0 1px 1px rgba(255,255,255,0.2) !important; }
+        .swagger-ui .opblock.opblock-delete:hover { border-color: var(--xenon-crimson) !important; }
+
+        .swagger-ui .opblock-summary-path { color: #fff !important; font-family: 'JetBrains Mono', monospace !important; font-size: 16px !important; font-weight: 600 !important; }
+        .swagger-ui .opblock-summary-description { color: var(--xenon-text-dim) !important; font-size: 14px; margin-left: 12px; }
+
+        /* Forms & Interactive */
+        .swagger-ui .btn.authorize { color: var(--xenon-emerald) !important; border-color: var(--xenon-emerald) !important; background: transparent !important; border-radius: 12px; font-weight: 600; padding: 10px 24px; transition: all 0.2s; }
+        .swagger-ui .btn.authorize:hover { background: var(--xenon-emerald-glow) !important; transform: scale(1.02); }
+        .swagger-ui .btn.authorize svg { fill: var(--xenon-emerald) !important; }
+        
+        .swagger-ui .btn.execute { background-color: var(--xenon-emerald) !important; border: none !important; border-radius: 12px !important; padding: 12px 32px !important; font-weight: 700 !important; letter-spacing: 0.1em; text-transform: uppercase; box-shadow: 0 8px 16px var(--xenon-emerald-glow) !important; }
+        .swagger-ui .btn.cancel { border-radius: 12px !important; border: 1px solid var(--xenon-border-bright) !important; color: var(--xenon-text) !important; }
+        
+        .swagger-ui input[type=text], .swagger-ui select, .swagger-ui textarea { background: #000 !important; border: 1px solid var(--xenon-border-bright) !important; color: #fff !important; border-radius: 12px !important; padding: 14px !important; }
+        
+        /* Models / Schemas */
+        .swagger-ui section.models { border: 1px solid var(--xenon-border); border-radius: 20px; background: var(--xenon-surface); margin-top: 80px; padding: 20px; }
+        .swagger-ui section.models h4 { color: #fff !important; font-family: 'Outfit', sans-serif; font-size: 20px; margin-bottom: 24px; border-bottom: 1px solid var(--xenon-border); padding-bottom: 12px; }
+        .swagger-ui .model-box { background: transparent !important; }
+        .swagger-ui .model-title { color: var(--xenon-emerald) !important; font-family: 'JetBrains Mono', monospace; font-size: 14px; }
+        .swagger-ui .prop-type { color: var(--xenon-blue) !important; }
+        .swagger-ui .prop-format { color: var(--xenon-text-dim) !important; font-size: 11px; }
+
+        /* Modal Overhaul */
+        .swagger-ui .dialog-ux .modal-ux { background: var(--xenon-bg) !important; border: 1px solid var(--xenon-border-bright) !important; border-radius: 28px; box-shadow: 0 80px 160px rgba(0,0,0,0.9); padding: 40px; }
+        .swagger-ui .dialog-ux .modal-ux-header h3 { font-family: 'Outfit', sans-serif; font-size: 28px; color: #fff !important; margin-bottom: 16px; }
+        .swagger-ui .dialog-ux .modal-ux-content h4 { color: var(--xenon-text-dim) !important; margin-top: 24px; }
+        
+        /* Custom Scrollbar */
+        ::-webkit-scrollbar { width: 10px; height: 10px; }
+        ::-webkit-scrollbar-track { background: var(--xenon-bg); }
+        ::-webkit-scrollbar-thumb { background: #27272a; border-radius: 5px; border: 2px solid var(--xenon-bg); }
+        ::-webkit-scrollbar-thumb:hover { background: #3f3f46; }
+      `,
+        customSiteTitle: 'Xenon API Documentation',
+        customfavIcon: '/xenon/favicon.png',
+    }));
+    // Serve raw OpenAPI spec as JSON
+    app.get('/api-docs.json', (req, res) => {
+        res.setHeader('Content-Type', 'application/json');
+        res.send(swaggerSpec);
+    });
+}

package/lib/src/chromeUtils.js

@@ -0,0 +1,148 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getModuleRoot = exports.OS = exports.getOsInfo = exports.CD_VER = exports.CD_CDN = exports.getOsName = void 0;
+exports.getChromeVersion = getChromeVersion;
+exports.getChromedriverBinaryPath = getChromedriverBinaryPath;
+exports.retrieveData = retrieveData;
+exports.generateLogPrefix = generateLogPrefix;
+exports.formatCdVersion = formatCdVersion;
+/* eslint-disable @typescript-eslint/no-var-requires */
+const lodash_1 = __importDefault(require("lodash"));
+const support_1 = require("@appium/support");
+const driver_1 = require("appium/driver");
+const path_1 = __importDefault(require("path"));
+const axios_1 = __importDefault(require("axios"));
+const teen_process_1 = require("teen_process");
+const logger_1 = __importDefault(require("./logger"));
+const CD_CDN = process.env.npm_config_chromedriver_cdnurl ||
+    process.env.CHROMEDRIVER_CDNURL ||
+    'https://chromedriver.storage.googleapis.com';
+exports.CD_CDN = CD_CDN;
+const OS = {
+    linux: 'linux',
+    windows: 'win',
+    mac: 'mac',
+};
+exports.OS = OS;
+const CD_EXECUTABLE_PREFIX = 'chromedriver';
+const MODULE_NAME = 'xenon';
+const CD_VER = process.env.npm_config_chromedriver_version || process.env.CHROMEDRIVER_VERSION;
+exports.CD_VER = CD_VER;
+const getModuleRoot = lodash_1.default.memoize(function getModuleRoot() {
+    if (!lodash_1.default.isFunction(support_1.node.getModuleRootSync)) {
+        const { existsSync, readFileSync } = require('fs');
+        let currentDir = path_1.default.dirname(path_1.default.resolve(__filename));
+        let isAtFsRoot = false;
+        while (!isAtFsRoot) {
+            const manifestPath = path_1.default.join(currentDir, 'package.json');
+            try {
+                if (existsSync(manifestPath) &&
+                    JSON.parse(readFileSync(manifestPath, 'utf8')).name === MODULE_NAME) {
+                    return currentDir;
+                }
+                // eslint-disable-next-line no-empty
+            }
+            catch (ign) { }
+            currentDir = path_1.default.dirname(currentDir);
+            isAtFsRoot = currentDir.length <= path_1.default.dirname(currentDir).length;
+        }
+        throw new Error(`Cannot find the root folder of the ${MODULE_NAME} Node.js module`);
+    }
+    const root = support_1.node.getModuleRootSync(MODULE_NAME, __filename);
+    if (!root) {
+        throw new Error(`Cannot find the root folder of the ${MODULE_NAME} Node.js module`);
+    }
+    return root;
+});
+exports.getModuleRoot = getModuleRoot;
+function getChromeVersion(adb, bundleId) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { versionName } = yield adb.getPackageInfo(bundleId);
+        return versionName;
+    });
+}
+const DOWNLOAD_TIMEOUT_MS = 15 * 1000;
+const LATEST_VERSION = 'LATEST';
+function formatCdVersion(ver) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return ver === LATEST_VERSION
+            ? (yield retrieveData(`${CD_CDN}/LATEST_RELEASE`, { timeout: DOWNLOAD_TIMEOUT_MS })).trim()
+            : ver;
+    });
+}
+function getChromedriverBinaryPath(dir_1) {
+    return __awaiter(this, arguments, void 0, function* (dir, osName = getOsName()) {
+        const pathSuffix = osName === OS.windows ? '.exe' : '';
+        logger_1.default.debug(`${CD_EXECUTABLE_PREFIX}*${pathSuffix}`);
+        const paths = yield support_1.fs.glob(`${CD_EXECUTABLE_PREFIX}*${pathSuffix}`, {
+            cwd: dir,
+            absolute: true,
+            nocase: true,
+            nodir: true,
+        });
+        return lodash_1.default.isEmpty(paths)
+            ? path_1.default.resolve(dir, `${CD_EXECUTABLE_PREFIX}${pathSuffix}`)
+            : lodash_1.default.first(paths);
+    });
+}
+function retrieveData(url_1, headers_1) {
+    return __awaiter(this, arguments, void 0, function* (url, headers, opts = {}) {
+        const { timeout = 5000, responseType = 'text' } = opts;
+        return (yield (0, axios_1.default)({
+            url,
+            headers,
+            timeout,
+            responseType,
+        })).data;
+    });
+}
+const getOsName = lodash_1.default.memoize(function getOsName() {
+    if (support_1.system.isWindows()) {
+        return OS.windows;
+    }
+    if (support_1.system.isMac()) {
+        return OS.mac;
+    }
+    return OS.linux;
+});
+exports.getOsName = getOsName;
+const getOsInfo = lodash_1.default.memoize(function getOsInfo() {
+    return __awaiter(this, void 0, void 0, function* () {
+        let systemHardware = '';
+        if (!support_1.system.isWindows()) {
+            systemHardware = (0, teen_process_1.exec)('uname', ['-m']).toString();
+        }
+        return {
+            name: getOsName(),
+            arch: yield support_1.system.arch(),
+            hardwareName: support_1.system.isWindows() ? null : lodash_1.default.trim(systemHardware),
+        };
+    });
+});
+exports.getOsInfo = getOsInfo;
+// @ts-expect-error - Instantiating BaseDriver with empty options for helper access
+// error TS2345: Argument of type '{}' is not assignable to parameter of type 'DriverOpts<Readonly<Record<string, Constraint>>>'
+// Type '{}' is missing the following properties from type 'ServerArgs': address, allowCors, allowInsecure, basePath, and 26 more.
+const getBaseDriverInstance = lodash_1.default.memoize(() => new driver_1.BaseDriver({}, false));
+/**
+ * Generates log prefix string
+ *
+ * @param {object} obj log owner instance
+ * @param {string?} sessionId Optional session identifier
+ * @returns {string}
+ */
+function generateLogPrefix(obj, sessionId) {
+    return getBaseDriverInstance().helpers.generateDriverLogPrefix(obj, sessionId);
+}

package/lib/src/commands/handle.js

@@ -0,0 +1,19 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = handle;
+const device_service_1 = require("../data-service/device-service");
+function handle(next, driver, _commandName, ..._args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        (0, device_service_1.updateCmdExecutedTime)(driver.sessionId);
+        return yield next();
+    });
+}

package/lib/src/commands/index.js

@@ -0,0 +1,8 @@
+"use strict";
+// Note: handle() is now a class method in plugin.ts, not a command
+// import handle from './handle';
+Object.defineProperty(exports, "__esModule", { value: true });
+const commands = {
+// handle method removed - now implemented as class method
+};
+exports.default = commands;

package/lib/src/config.js

@@ -0,0 +1,73 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.config = void 0;
+exports.updateConfig = updateConfig;
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const basePath = path.join(os.homedir(), '.cache', 'xenon');
+exports.config = {
+    cacheDir: basePath,
+    databaseProvider: process.env.XENON_DB_PROVIDER || 'sqlite',
+    databaseUrl: process.env.DATABASE_URL || `file:${path.join(basePath, 'xenon.db')}`,
+    databasePath: path.join(basePath, 'xenon.db'),
+    sessionAssetsPath: path.join(basePath, 'assets', 'sessions'),
+    appsPath: path.join(basePath, 'apps'),
+    takeScreenshotsFor: [
+        'click',
+        'setUrl',
+        'setValue',
+        'performActions',
+        'clear',
+        'swipe',
+        'scroll',
+        'dragAndDrop',
+        'back',
+        'forward',
+    ],
+    aiProvider: process.env.XENON_AI_PROVIDER || 'gemini',
+    aiModel: process.env.XENON_AI_MODEL,
+    aiBaseUrl: process.env.XENON_AI_BASE_URL,
+    geminiApiKey: process.env.XENON_GEMINI_API_KEY || process.env.GEMINI_API_KEY,
+    openaiApiKey: process.env.XENON_OPENAI_API_KEY || process.env.OPENAI_API_KEY,
+    anthropicApiKey: process.env.XENON_ANTHROPIC_API_KEY || process.env.ANTHROPIC_API_KEY,
+    geminiModel: process.env.XENON_GEMINI_MODEL,
+    openaiModel: process.env.XENON_OPENAI_MODEL,
+    anthropicModel: process.env.XENON_ANTHROPIC_MODEL,
+    ollamaModel: process.env.XENON_OLLAMA_MODEL,
+};
+function updateConfig(newConfig) {
+    Object.assign(exports.config, newConfig);
+}