@xenon-device-management/xenon 1.1.0

package/lib/src/scripts/prepare-prisma.js

@@ -0,0 +1,89 @@
+"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;
+    };
+})();
+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.preparePrismaSchema = preparePrismaSchema;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logger_1 = __importDefault(require("../logger"));
+const config_1 = require("../config");
+/**
+ * Prisma Schema Preparer
+ *
+ * Dynamically switches the database provider in schema.prisma
+ * based on the XENON_DB_PROVIDER environment variable.
+ */
+function preparePrismaSchema() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const schemaPath = path.join(process.cwd(), 'prisma', 'schema.prisma');
+        const provider = config_1.config.databaseProvider; // defaults to sqlite
+        if (!fs.existsSync(schemaPath)) {
+            logger_1.default.error(`[PrismaPrepare] Schema not found at ${schemaPath}`);
+            return;
+        }
+        const schema = fs.readFileSync(schemaPath, 'utf8');
+        const currentProviderMatch = schema.match(/datasource\s+db\s*{[\s\S]*?provider\s*=\s*"([^"]+)"/);
+        const currentProvider = currentProviderMatch ? currentProviderMatch[1] : null;
+        if (currentProvider === provider) {
+            logger_1.default.info(`[PrismaPrepare] Schema already configured for ${provider}`);
+            return;
+        }
+        logger_1.default.info(`[PrismaPrepare] Switching provider from ${currentProvider} to ${provider}`);
+        // Replace the provider in the datasource block
+        // We target the provider inside the 'datasource db' block specifically
+        const newSchema = schema.replace(/(datasource\s+db\s*{[\s\S]*?provider\s*=\s*")([^"]*)(")/, `$1${provider}$3`);
+        fs.writeFileSync(schemaPath, newSchema);
+        logger_1.default.info('[PrismaPrepare] schema.prisma updated successfully.');
+    });
+}
+if (require.main === module) {
+    preparePrismaSchema().catch((err) => {
+        var _a;
+        const msg = (_a = err === null || err === void 0 ? void 0 : err.message) !== null && _a !== void 0 ? _a : String(err);
+        logger_1.default.error(`[PrismaPrepare] Critical failure: ${msg}`, err);
+        process.exit(1);
+    });
+}

package/lib/src/services/AICommandService.js

@@ -0,0 +1,143 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+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.AICommandService = void 0;
+const typedi_1 = require("typedi");
+const logger_1 = __importDefault(require("../logger"));
+const OmniVisionService_1 = require("./omni-vision/OmniVisionService");
+const VisionAssertionService_1 = require("./omni-vision/VisionAssertionService");
+let AICommandService = class AICommandService {
+    constructor() {
+        this.logger = logger_1.default.scope('AICommandService');
+    }
+    analyzeScreen(driver) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.logger.info('Analyzing screen via AI...');
+            return yield typedi_1.Container.get(OmniVisionService_1.OmniVisionService).analyzeScreen(driver);
+        });
+    }
+    assertVisualState(driver, instruction) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.logger.info(`Asserting visual state: ${instruction}`);
+            return yield typedi_1.Container.get(VisionAssertionService_1.VisionAssertionService).assertState(driver, instruction);
+        });
+    }
+    omniScan(driver) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.logger.info('Performing Omni-Scan...');
+            return yield typedi_1.Container.get(OmniVisionService_1.OmniVisionService).analyzeScreen(driver);
+        });
+    }
+    testAiLocator(driver, locator) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.logger.info(`Testing AI locator: ${locator.strategy}=${locator.selector}`);
+            const omniService = typedi_1.Container.get(OmniVisionService_1.OmniVisionService);
+            if (locator.strategy === '-custom:ai-text') {
+                return yield omniService.findByText(driver, locator.selector);
+            }
+            else if (locator.strategy === '-custom:ai-icon') {
+                const result = yield omniService.findByIcon(driver, locator.selector);
+                return result ? [result] : [];
+            }
+            throw new Error(`Unsupported AI strategy: ${locator.strategy}`);
+        });
+    }
+    /**
+     * Omni-Click: OCR-driven click by visible text.
+     * Designed as a modern, enterprise command with predictable arguments + structured response.
+     */
+    omniClick(driver, payload) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const text = payload === null || payload === void 0 ? void 0 : payload.text;
+            if (!text || typeof text !== 'string' || text.trim().length === 0) {
+                throw new Error('omniClick requires a non-empty "text" string');
+            }
+            const index = typeof (payload === null || payload === void 0 ? void 0 : payload.index) === 'number' ? payload.index : 1;
+            const takeANewScreenShot = typeof (payload === null || payload === void 0 ? void 0 : payload.takeANewScreenShot) === 'boolean' ? payload.takeANewScreenShot : true;
+            this.logger.info(`Omni-Click requested. text="${text}" index=${index} takeANewScreenShot=${takeANewScreenShot}`);
+            return yield typedi_1.Container.get(OmniVisionService_1.OmniVisionService).omniClickByText(driver, {
+                text,
+                index,
+                takeANewScreenShot,
+            });
+        });
+    }
+    /**
+     * Visual-Tap: AI-driven click by visual description (icons, buttons, etc).
+     */
+    visualTap(driver, payload) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const icon = (payload === null || payload === void 0 ? void 0 : payload.icon) || (payload === null || payload === void 0 ? void 0 : payload.description);
+            if (!icon || typeof icon !== 'string' || icon.trim().length === 0) {
+                throw new Error('visualTap requires a non-empty "icon" or "description" string');
+            }
+            const takeANewScreenShot = typeof (payload === null || payload === void 0 ? void 0 : payload.takeANewScreenShot) === 'boolean' ? payload.takeANewScreenShot : true;
+            this.logger.info(`Visual-Tap requested. target="${icon}" takeANewScreenShot=${takeANewScreenShot}`);
+            return yield typedi_1.Container.get(OmniVisionService_1.OmniVisionService).omniClickByIcon(driver, {
+                icon,
+                takeANewScreenShot,
+            });
+        });
+    }
+    /**
+     * UI Scan Export: OCR + lightweight visual metadata export.
+     */
+    uiScanExport(driver, payload) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const takeANewScreenShot = typeof (payload === null || payload === void 0 ? void 0 : payload.takeANewScreenShot) === 'boolean' ? payload.takeANewScreenShot : true;
+            const maxItems = typeof (payload === null || payload === void 0 ? void 0 : payload.maxItems) === 'number' ? payload.maxItems : 200;
+            this.logger.info(`UI Lens export requested. takeANewScreenShot=${takeANewScreenShot} maxItems=${maxItems}`);
+            return yield typedi_1.Container.get(OmniVisionService_1.OmniVisionService).exportUiLensMetadata(driver, {
+                takeANewScreenShot,
+                maxItems,
+            });
+        });
+    }
+    /**
+     * Smart Tap: Xenon-native, self-explanatory alias of omniClick/visualTap.
+     * Automatically switches between text-based and icon-based matching.
+     */
+    smartTap(driver, payload) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.logger.info(`smartTap payload: ${JSON.stringify(payload)}`);
+            const icon = (payload === null || payload === void 0 ? void 0 : payload.icon) || (payload === null || payload === void 0 ? void 0 : payload.description);
+            const text = payload === null || payload === void 0 ? void 0 : payload.text;
+            // Prioritize visual description if provided
+            if (icon && typeof icon === 'string' && icon.trim().length > 0) {
+                this.logger.info(`Routing smartTap to visualTap (icon detected: "${icon}")`);
+                return yield this.visualTap(driver, payload);
+            }
+            this.logger.info(`Routing smartTap to omniClick (text detected: "${text}")`);
+            return yield this.omniClick(driver, payload);
+        });
+    }
+    /**
+     * UI Inventory: Xenon-native, self-explanatory alias of uiScanExport.
+     */
+    uiInventory(driver, payload) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.uiScanExport(driver, payload);
+        });
+    }
+};
+exports.AICommandService = AICommandService;
+exports.AICommandService = AICommandService = __decorate([
+    (0, typedi_1.Service)()
+], AICommandService);