@xenon-device-management/xenon 1.9.1 → 1.10.0

package/lib/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@xenon-device-management/xenon",
-    "version": "1.9.1",
+    "version": "1.10.0",
     "description": "Xenon - Intelligent Mobile Infrastructure. A self-healing device orchestration platform for Appium.",
     "main": "./lib/src/index.js",
     "exports": {
@@ -12,7 +12,7 @@
         "postinstall": "node scripts/generate-prisma.js",
         "build": "node scripts/generate-prisma.js && tsc -b && npm run build:copy",
         "build:all": "npm run build:xenon && npm run build",
-        "build:copy": "rm -rf lib/public && mkdir -p lib/src && cp -R src/public lib/ && cp -R src/generated lib/src/ && cp schema.json lib/",
+        "build:copy": "rm -rf lib/public && mkdir -p lib/src && cp -R src/public lib/ && cp -R src/generated lib/src/ && cp schema.json lib/ && mkdir -p lib/src/device-managers/android/vendor && cp src/device-managers/android/vendor/*.jar lib/src/device-managers/android/vendor/",
         "build:schema": "node scripts/generate-types-from-schema.js",
         "build:xenon": "sh scripts/build-xenon.sh",
         "dev": "npm run db:migrate && npm run build && npm run plugin:reinstall && npm run server",

package/lib/schema.json

@@ -475,9 +475,16 @@
             "description": "Live-streaming options.",
             "properties": {
                 "androidH264": {
-                    "type": "boolean",
                     "default": false,
-                    "description": "Use scrcpy H.264 for Android live preview (WebCodecs in the browser) instead of the MJPEG screencap loop. Falls back to MJPEG when unsupported."
+                    "description": "Android live preview: false/omitted = MJPEG; true = H.264 via scrcpy; { \"source\": \"scrcpy\" | \"screenrecord\" } to pick the capture source explicitly. Falls back to MJPEG when unsupported.",
+                    "oneOf": [
+                        { "type": "boolean" },
+                        {
+                            "type": "object",
+                            "additionalProperties": false,
+                            "properties": { "source": { "type": "string", "enum": ["scrcpy", "screenrecord"] } }
+                        }
+                    ]
                 }
             }
         }

package/lib/src/app/routers/androidH264Config.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveAndroidH264 = resolveAndroidH264;
+/**
+ * Normalize the three accepted flag shapes to one:
+ *   false | undefined        → { enabled:false }         (pure MJPEG — default)
+ *   true                     → { enabled:true, scrcpy }  (new default source)
+ *   { source }               → { enabled:true, source }  (explicit; scrcpy default)
+ */
+function resolveAndroidH264(cfg) {
+    if (!cfg)
+        return { enabled: false, source: 'scrcpy' };
+    if (cfg === true)
+        return { enabled: true, source: 'scrcpy' };
+    return { enabled: true, source: cfg.source === 'screenrecord' ? 'screenrecord' : 'scrcpy' };
+}

package/lib/src/app/routers/control.js

@@ -64,6 +64,7 @@ const InspectorService_1 = require("../../services/InspectorService");
 const StreamTicketService_1 = require("../../services/token/StreamTicketService");
 const PluginContext_1 = require("../../PluginContext");
 const streamType_1 = require("./streamType");
+const androidH264Config_1 = require("./androidH264Config");
 const recording_store_1 = require("../../services/recording/recording-store");
 const scopeGuard_1 = require("../../middleware/scopeGuard");
 const roleGuard_1 = require("../../middleware/roleGuard");
@@ -562,7 +563,8 @@ router.post('/:udid/stream/start', (req, res) => __awaiter(void 0, void 0, void
         });
     }
     try {
-        const flagOn = !!((_a = typedi_1.Container.get(PluginContext_1.PluginContext).pluginArgs.streaming) === null || _a === void 0 ? void 0 : _a.androidH264);
+        const h264Cfg = (0, androidH264Config_1.resolveAndroidH264)((_a = typedi_1.Container.get(PluginContext_1.PluginContext).pluginArgs.streaming) === null || _a === void 0 ? void 0 : _a.androidH264);
+        const flagOn = h264Cfg.enabled;
         // A recording device keeps MJPEG preview so we never run screenrecord and
         // the recording's screencap pipeline against the same device at once.
         const recording = yield typedi_1.Container.get(recording_store_1.RecordingStore).isRecording(udid);
@@ -574,7 +576,7 @@ router.post('/:udid/stream/start', (req, res) => __awaiter(void 0, void 0, void
         else if (streamType === 'h264') {
             // H.264 preview: start the scrcpy/screenrecord service. Do NOT also start
             // the MJPEG screencap loop — one capture pipeline per device.
-            yield typedi_1.Container.get(AndroidH264StreamService_1.default).start(udid);
+            yield typedi_1.Container.get(AndroidH264StreamService_1.default).start(udid, { source: h264Cfg.source });
         }
         else {
             mjpegPort = (yield typedi_1.Container.get(AndroidStreamService_1.default).startStream(udid)).mjpegPort;
@@ -708,7 +710,7 @@ router.get('/:udid/stream/status', (req, res) => __awaiter(void 0, void 0, void
         return res.status(404).send('Device not found');
     // Advertise which transport the frontend player should use. A recording
     // device keeps MJPEG (one capture pipeline per device).
-    const flagOn = !!((_a = typedi_1.Container.get(PluginContext_1.PluginContext).pluginArgs.streaming) === null || _a === void 0 ? void 0 : _a.androidH264);
+    const flagOn = (0, androidH264Config_1.resolveAndroidH264)((_a = typedi_1.Container.get(PluginContext_1.PluginContext).pluginArgs.streaming) === null || _a === void 0 ? void 0 : _a.androidH264).enabled;
     const recording = yield typedi_1.Container.get(recording_store_1.RecordingStore).isRecording(udid);
     const type = (0, streamType_1.resolveStreamType)(device.platform, flagOn, recording);
     const h264Path = type === 'h264' ? `/xenon/api/control/${encodeURIComponent(udid)}/stream/h264` : undefined;

package/lib/src/device-managers/android/AndroidH264StreamService.js

@@ -60,6 +60,8 @@ const logger_1 = __importDefault(require("../../logger"));
 const device_store_1 = require("../../data-service/device-store");
 const H264Multiplexer_1 = require("./H264Multiplexer");
 const h264NalParser_1 = require("./h264NalParser");
+const androidH264Config_1 = require("../../app/routers/androidH264Config");
+const PluginContext_1 = require("../../PluginContext");
 const IDLE_TIMEOUT_MS = 600000; // stop a stream after 10 min with zero viewers
 const RESTART_MIN_INTERVAL_MS = 300; // fast restart after a healthy stream hits the cap/rotation
 // After this many consecutive restarts that produced no frames (device gone,
@@ -106,7 +108,7 @@ let AndroidH264StreamService = class AndroidH264StreamService {
         var _a;
         return (_a = this.sessions.get(udid)) === null || _a === void 0 ? void 0 : _a.mux;
     }
-    start(udid) {
+    start(udid, opts) {
         return __awaiter(this, void 0, void 0, function* () {
             const inflight = this.startPromises.get(udid);
             if (inflight)
@@ -115,6 +117,7 @@ let AndroidH264StreamService = class AndroidH264StreamService {
             if (existing && existing.status === 'running')
                 return existing.mux;
             const promise = (() => __awaiter(this, void 0, void 0, function* () {
+                var _a, _b;
                 const mux = new H264Multiplexer_1.H264Multiplexer();
                 const session = { status: 'running', mux };
                 this.sessions.set(udid, session);
@@ -129,7 +132,13 @@ let AndroidH264StreamService = class AndroidH264StreamService {
                             resolveConfig();
                         }
                     };
-                    session.capture = yield this.openCapture(udid, onPacket);
+                    // Resolve the capture source: an explicit opts.source wins; otherwise
+                    // read the server-wide flag config. Resolving here (not just at the REST
+                    // call site) means the WS auto-start path — start(udid) with no opts —
+                    // also honours a configured { source: 'screenrecord' } instead of
+                    // silently defaulting to scrcpy.
+                    const source = (_a = opts === null || opts === void 0 ? void 0 : opts.source) !== null && _a !== void 0 ? _a : (0, androidH264Config_1.resolveAndroidH264)((_b = typedi_1.Container.get(PluginContext_1.PluginContext).pluginArgs.streaming) === null || _b === void 0 ? void 0 : _b.androidH264).source;
+                    session.capture = yield this.openCapture(udid, onPacket, source);
                     // Give the first keyframe/config a moment so callers get a ready stream,
                     // but never block start-up indefinitely.
                     yield Promise.race([firstConfig, new Promise((r) => setTimeout(r, 3000))]);
@@ -169,13 +178,54 @@ let AndroidH264StreamService = class AndroidH264StreamService {
             logger_1.default.info(`[${udid}] H.264 stream terminated.`);
         });
     }
+    /**
+     * Select the capture source: `screenrecord` (legacy, rollback path) or
+     * `scrcpy` (default). Dispatches to the matching producer.
+     */
+    openCapture(udid, onPacket, source) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return source === 'screenrecord'
+                ? this.openScreenrecordCapture(udid, onPacket)
+                : this.openScrcpyCapture(udid, onPacket);
+        });
+    }
+    /**
+     * scrcpy-server capture: pushes/launches the vendored server jar over adb
+     * and streams its Annex-B H.264 socket output through a fresh
+     * {@link H264NalParser}. Unlike screenrecord, scrcpy has no time cap, so a
+     * 'close' while the session is still 'running' is unexpected — treat it as
+     * a crash and stop the session rather than silently going dark.
+     */
+    openScrcpyCapture(udid, onPacket) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { ScrcpyServerSession, scrcpyMaxSizeFromDims } = yield Promise.resolve().then(() => __importStar(require('./ScrcpyServerSession')));
+            const device = yield device_store_1.DeviceStoreFactory.getStore().findDevice({ udid });
+            const maxSize = scrcpyMaxSizeFromDims(Number(device === null || device === void 0 ? void 0 : device.screenWidth), Number(device === null || device === void 0 ? void 0 : device.screenHeight));
+            const parser = new h264NalParser_1.H264NalParser();
+            const session = new ScrcpyServerSession(udid);
+            session.on('data', (b) => {
+                for (const p of parser.push(b))
+                    onPacket(p);
+            });
+            session.on('close', () => {
+                var _a;
+                // Crash recovery: scrcpy has no time cap, so a close while running is unexpected.
+                if (((_a = this.sessions.get(udid)) === null || _a === void 0 ? void 0 : _a.status) === 'running') {
+                    logger_1.default.warn(`[${udid}] scrcpy stream closed unexpectedly; stopping H.264 session.`);
+                    this.stop(udid);
+                }
+            });
+            yield session.start(maxSize);
+            return { kill: () => session.stop() };
+        });
+    }
     /**
      * Spawn screenrecord with the resolved adb binary (never a bare `adb` — the
      * GUI-launch PATH trap; see 1.8.2) and feed its Annex-B output through a
      * fresh {@link H264NalParser}. Restarts on process exit (cap/rotation) while
      * the session is still running.
      */
-    openCapture(udid, onPacket) {
+    openScreenrecordCapture(udid, onPacket) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a;
             const { default: AndroidDeviceManager } = yield Promise.resolve().then(() => __importStar(require('../AndroidDeviceManager')));

package/lib/src/device-managers/android/ScrcpyServerSession.js

@@ -0,0 +1,269 @@
+"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.ScrcpyServerSession = exports.SCRCPY_DEVICE_JAR_PATH = void 0;
+exports.buildScrcpyServerArgs = buildScrcpyServerArgs;
+exports.scrcpyMaxSizeFromDims = scrcpyMaxSizeFromDims;
+exports.parseAdbForwardPort = parseAdbForwardPort;
+const child_process_1 = require("child_process");
+const events_1 = require("events");
+const net_1 = __importDefault(require("net"));
+const util_1 = require("util");
+const typedi_1 = require("typedi");
+const logger_1 = __importDefault(require("../../logger"));
+const scrcpyVersion_1 = require("./scrcpyVersion");
+const execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
+const LOCAL_ABSTRACT = 'scrcpy'; // device-side socket name scrcpy listens on
+exports.SCRCPY_DEVICE_JAR_PATH = '/data/local/tmp/scrcpy-server-manual.jar';
+/**
+ * The argv passed to the resolved adb AFTER any `-s <udid>` — a headless,
+ * video-only scrcpy-server launch. All three metadata channels are disabled
+ * (`send_device_meta=false`, `send_codec_meta=false`, `send_frame_meta=false`)
+ * so the socket carries plain Annex-B H.264 that the existing H264NalParser
+ * consumes unchanged. `send_dummy_byte=true` (the tunnel_forward readiness byte)
+ * is explicit because the socket reader skips exactly one leading byte.
+ * Arg NAMES verified against the vendored scrcpy 3.3.4 jar's dex; the version
+ * constant and this argv move together (see scrcpyVersion.ts / vendor/README.md).
+ * No `scid` → the server listens on `localabstract:scrcpy` (per-device namespace).
+ */
+function buildScrcpyServerArgs(opts) {
+    return [
+        'shell',
+        `CLASSPATH=${opts.jarDevicePath}`,
+        'app_process',
+        '/',
+        'com.genymobile.scrcpy.Server',
+        opts.version,
+        'tunnel_forward=true',
+        'audio=false',
+        'control=false',
+        'video=true',
+        'video_codec=h264',
+        `max_size=${opts.maxSize}`,
+        'video_bit_rate=4000000',
+        'max_fps=30',
+        'send_device_meta=false',
+        'send_codec_meta=false',
+        'send_frame_meta=false',
+        'send_dummy_byte=true',
+        'cleanup=true',
+    ];
+}
+/**
+ * scrcpy `max_size` caps the device's LONGER edge (single int, aspect preserved).
+ * Derive it so the SHORTER edge lands near `targetShortEdge` (matches today's
+ * ~720-wide screenrecord downscale). Never upscales.
+ */
+function scrcpyMaxSizeFromDims(sw, sh, targetShortEdge = 720) {
+    const shortE = Math.min(sw, sh);
+    const longE = Math.max(sw, sh);
+    if (!Number.isFinite(shortE) || !Number.isFinite(longE) || shortE <= 0 || longE <= 0) {
+        return targetShortEdge * 2; // safe default longer-edge cap
+    }
+    if (shortE <= targetShortEdge)
+        return longE; // no upscale
+    return Math.round(longE * (targetShortEdge / shortE));
+}
+/** Parse the local TCP port that `adb forward tcp:0 …` prints on stdout. */
+function parseAdbForwardPort(stdout) {
+    const port = parseInt(String(stdout).trim(), 10);
+    if (!Number.isInteger(port) || port <= 0) {
+        throw new Error(`Unparseable adb forward port: ${JSON.stringify(stdout)}`);
+    }
+    return port;
+}
+class ScrcpyServerSession extends events_1.EventEmitter {
+    constructor(udid) {
+        super();
+        this.udid = udid;
+        this.stopped = false;
+        this.closeEmitted = false;
+        this.adbPath = 'adb';
+        this.hostArgs = [];
+        this.base = []; // [...hostArgs, '-s', udid]
+    }
+    /** Guarantees at most one public 'close' event, and none once the session was intentionally stopped. */
+    emitClosedOnce() {
+        if (this.closeEmitted || this.stopped)
+            return;
+        this.closeEmitted = true;
+        this.emit('close');
+    }
+    start(maxSize) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            const { default: AndroidDeviceManager } = yield Promise.resolve().then(() => __importStar(require('../AndroidDeviceManager')));
+            const adb = yield typedi_1.Container.get(AndroidDeviceManager).getAdbForDevice(this.udid);
+            if (this.stopped)
+                throw new Error('session stopped during start');
+            if (!((_a = adb === null || adb === void 0 ? void 0 : adb.executable) === null || _a === void 0 ? void 0 : _a.path))
+                throw new Error(`[${this.udid}] adb executable path not resolved`);
+            this.adbPath = adb.executable.path;
+            this.hostArgs = (adb === null || adb === void 0 ? void 0 : adb.adbHost) && (adb === null || adb === void 0 ? void 0 : adb.adbPort) ? ['-H', adb.adbHost, '-P', String(adb.adbPort)] : [];
+            this.base = [...this.hostArgs, '-s', this.udid];
+            try {
+                // 1) push jar (idempotent enough; overwrite is cheap and safe). Push
+                //    destination and the CLASSPATH must be the same path — use the one
+                //    constant so editing it can never point CLASSPATH at an unpushed jar.
+                yield execFileAsync(this.adbPath, [...this.base, 'push', (0, scrcpyVersion_1.scrcpyServerJarPath)(), exports.SCRCPY_DEVICE_JAR_PATH]);
+                if (this.stopped)
+                    throw new Error('session stopped during start');
+                // 2) app_process (long-lived). buildScrcpyServerArgs + SCRCPY_DEVICE_JAR_PATH
+                //    are defined in THIS file (Task 2) — reference them directly (no self-import).
+                const serverArgs = buildScrcpyServerArgs({
+                    version: scrcpyVersion_1.SCRCPY_SERVER_VERSION,
+                    jarDevicePath: exports.SCRCPY_DEVICE_JAR_PATH,
+                    maxSize,
+                });
+                this.proc = (0, child_process_1.spawn)(this.adbPath, [...this.base, ...serverArgs]);
+                (_b = this.proc.stdout) === null || _b === void 0 ? void 0 : _b.resume(); // scrcpy-server writes video to the socket, not stdout; drain so it can't backpressure
+                (_c = this.proc.stderr) === null || _c === void 0 ? void 0 : _c.on('data', (d) => logger_1.default.debug(`[${this.udid}] scrcpy-server: ${d.toString().trim()}`));
+                this.proc.on('close', () => { this.emitClosedOnce(); });
+                this.proc.on('error', (e) => {
+                    // A ChildProcess emitting 'error' with zero listeners crashes the process — always have one.
+                    logger_1.default.warn(`[${this.udid}] scrcpy-server proc error: ${e.message}`);
+                    this.emitClosedOnce();
+                });
+                // 3) forward a local port to the device socket, then connect
+                //    (parseAdbForwardPort is defined in this file — Task 3 — so call it directly)
+                const { stdout } = yield execFileAsync(this.adbPath, [...this.base, 'forward', 'tcp:0', `localabstract:${LOCAL_ABSTRACT}`]);
+                const port = parseAdbForwardPort(stdout);
+                this.forwardSpec = `tcp:${port}`;
+                if (this.stopped)
+                    throw new Error('session stopped during start');
+                yield this.connectWithRetry(port);
+                if (this.stopped)
+                    throw new Error('stopped during start');
+            }
+            catch (e) {
+                this.cleanup();
+                throw e;
+            }
+        });
+    }
+    connectWithRetry(port, attempt = 0) {
+        return new Promise((resolve, reject) => {
+            if (this.stopped) {
+                reject(new Error('stopped'));
+                return;
+            }
+            const sock = net_1.default.connect(port, '127.0.0.1');
+            let settled = false;
+            // `adb forward` accepts the LOCAL tcp connection immediately (~5ms) and only
+            // THEN dials the device-side scrcpy socket; if scrcpy-server hasn't bound it
+            // yet, adb closes us with zero bytes. So 'connect' is NOT proof the server is
+            // ready — a connect that closes/errors before any byte means "not ready yet"
+            // and we retry. A connection counts as real only once scrcpy's readiness
+            // dummy byte (send_dummy_byte=true) arrives. This is why the dummy byte exists.
+            const retry = (reason) => {
+                if (settled)
+                    return;
+                settled = true;
+                sock.removeListener('data', onFirstData);
+                sock.removeListener('error', retryErr);
+                sock.removeListener('close', retryClose);
+                sock.destroy(); // don't leak the failed socket
+                if (attempt < 19 && !this.stopped) { // 20 attempts total (0..19)
+                    setTimeout(() => this.connectWithRetry(port, attempt + 1).then(resolve, reject), 100);
+                }
+                else {
+                    reject(new Error(`scrcpy connect failed after ${attempt + 1} attempts: ${reason}`));
+                }
+            };
+            const retryErr = (e) => retry(e.message || 'socket error');
+            const retryClose = () => retry('closed before data');
+            const onFirstData = (first) => {
+                if (settled)
+                    return;
+                settled = true;
+                sock.removeListener('error', retryErr);
+                sock.removeListener('close', retryClose);
+                if (this.stopped) {
+                    sock.destroy();
+                    reject(new Error('stopped during connect'));
+                    return;
+                }
+                this.socket = sock;
+                // The first byte is scrcpy's readiness dummy byte; the raw H.264 Annex-B
+                // stream (SPS/PPS/IDR…) begins at byte 1 of this same chunk.
+                const rest = first.subarray(1);
+                sock.on('data', (chunk) => { if (!this.stopped)
+                    this.emit('data', chunk); });
+                sock.on('error', (e) => logger_1.default.warn(`[${this.udid}] scrcpy socket error: ${e.message}`)); // steady-state: log; 'close' follows
+                sock.on('close', () => { this.emitClosedOnce(); });
+                if (rest.length && !this.stopped)
+                    this.emit('data', rest);
+                resolve();
+            };
+            sock.once('error', retryErr);
+            sock.once('close', retryClose);
+            sock.once('data', onFirstData);
+        });
+    }
+    cleanup() {
+        var _a, _b;
+        this.stopped = true; // must be first: gates emitClosedOnce + connectWithRetry + connect-handler against a proc/socket event racing this cleanup
+        try {
+            (_a = this.socket) === null || _a === void 0 ? void 0 : _a.destroy();
+        }
+        catch ( /* best-effort */_c) { /* best-effort */ }
+        try {
+            (_b = this.proc) === null || _b === void 0 ? void 0 : _b.kill('SIGKILL');
+        }
+        catch ( /* best-effort */_d) { /* best-effort */ }
+        if (this.forwardSpec) {
+            const spec = this.forwardSpec;
+            this.forwardSpec = undefined; // clear first so a repeated stop()/cleanup() doesn't re-spawn adb
+            (0, child_process_1.execFile)(this.adbPath, [...this.base, 'forward', '--remove', spec], () => undefined);
+        }
+    }
+    stop() {
+        this.stopped = true;
+        this.cleanup();
+    }
+}
+exports.ScrcpyServerSession = ScrcpyServerSession;

package/lib/src/device-managers/android/scrcpyVersion.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCRCPY_SERVER_VERSION = void 0;
+exports.scrcpyServerJarFilename = scrcpyServerJarFilename;
+exports.scrcpyServerJarPath = scrcpyServerJarPath;
+const path_1 = __importDefault(require("path"));
+/**
+ * Pinned scrcpy-server version. The vendored jar filename AND the `app_process`
+ * <version> argument both derive from this — they must always agree, so this is
+ * the single source of truth. Bump procedure: see vendor/README.md.
+ */
+exports.SCRCPY_SERVER_VERSION = '3.3.4';
+function scrcpyServerJarFilename() {
+    return `scrcpy-server-${exports.SCRCPY_SERVER_VERSION}.jar`;
+}
+/** Absolute path to the vendored jar, valid in src (ts-node) and lib (built). */
+function scrcpyServerJarPath() {
+    return path_1.default.join(__dirname, 'vendor', scrcpyServerJarFilename());
+}

package/lib/src/services/ServerManager.js

@@ -114,6 +114,9 @@ let ServerManager = ServerManager_1 = class ServerManager {
             if (httpServer) {
                 (0, h264StreamWs_1.attachH264Ws)(httpServer, {
                     redeem: (ticket, udid) => typedi_1.Container.get(StreamTicketService_1.StreamTicketService).redeem(ticket, udid),
+                    // No source opt on purpose: start() resolves the capture source from the
+                    // streaming.androidH264 config itself, so this WS auto-start honours a
+                    // { source: 'screenrecord' } rollback just like the REST stream/start.
                     startStream: (udid) => typedi_1.Container.get(AndroidH264StreamService_1.default).start(udid),
                 });
             }

package/lib/test/unit/android-h264-config.spec.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const androidH264Config_1 = require("../../src/app/routers/androidH264Config");
+describe('resolveAndroidH264', () => {
+    it('undefined/false → disabled', () => {
+        (0, chai_1.expect)((0, androidH264Config_1.resolveAndroidH264)(undefined)).to.deep.equal({ enabled: false, source: 'scrcpy' });
+        (0, chai_1.expect)((0, androidH264Config_1.resolveAndroidH264)(false)).to.deep.equal({ enabled: false, source: 'scrcpy' });
+    });
+    it('true → enabled with scrcpy (the new meaning of true)', () => {
+        (0, chai_1.expect)((0, androidH264Config_1.resolveAndroidH264)(true)).to.deep.equal({ enabled: true, source: 'scrcpy' });
+    });
+    it('object → enabled; source defaults to scrcpy, honored when explicit', () => {
+        (0, chai_1.expect)((0, androidH264Config_1.resolveAndroidH264)({})).to.deep.equal({ enabled: true, source: 'scrcpy' });
+        (0, chai_1.expect)((0, androidH264Config_1.resolveAndroidH264)({ source: 'screenrecord' })).to.deep.equal({
+            enabled: true,
+            source: 'screenrecord',
+        });
+    });
+});

package/lib/test/unit/android-h264-service.spec.js

@@ -14,7 +14,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 require("reflect-metadata");
 const chai_1 = require("chai");
+const typedi_1 = require("typedi");
 const AndroidH264StreamService_1 = __importDefault(require("../../src/device-managers/android/AndroidH264StreamService"));
+const PluginContext_1 = require("../../src/PluginContext");
 // Lifecycle/state only — the capture seam (openCapture) is stubbed so the test
 // drives packet flow without a real device or screenrecord process.
 function make() {
@@ -24,6 +26,13 @@ function make() {
     return svc;
 }
 describe('AndroidH264StreamService', () => {
+    // start(udid) with no opts reads the flag config from PluginContext. Seed a
+    // known default before each test (streaming undefined → source 'scrcpy'); the
+    // WS-source tests override it in-test. Set (not remove) so TypeDI never hits a
+    // ServiceNotFoundError on the next Container.get.
+    beforeEach(() => {
+        typedi_1.Container.set(PluginContext_1.PluginContext, { pluginArgs: {} });
+    });
     it('start() creates a multiplexer, seeds it with the config packet, and resolves', () => __awaiter(void 0, void 0, void 0, function* () {
         const svc = make();
         svc.openCapture = (_udid, onPacket) => __awaiter(void 0, void 0, void 0, function* () {
@@ -80,4 +89,65 @@ describe('AndroidH264StreamService', () => {
         (0, chai_1.expect)(killed).to.equal(true);
         (0, chai_1.expect)(svc.getMultiplexer('udid-z')).to.equal(undefined);
     }));
+    it('start({source:"scrcpy"}) uses the scrcpy capture seam', () => __awaiter(void 0, void 0, void 0, function* () {
+        const svc = make();
+        let used = '';
+        svc.openScrcpyCapture = (_u, onPacket) => __awaiter(void 0, void 0, void 0, function* () {
+            used = 'scrcpy';
+            onPacket({ type: 'config', data: Buffer.from([0]), ptsMs: 0 });
+            return { kill: () => undefined };
+        });
+        svc.openScreenrecordCapture = () => __awaiter(void 0, void 0, void 0, function* () { used = 'screenrecord'; return { kill: () => undefined }; });
+        yield svc.start('udid-s', { source: 'scrcpy' });
+        (0, chai_1.expect)(used).to.equal('scrcpy');
+    }));
+    it('start({source:"screenrecord"}) uses the legacy capture seam', () => __awaiter(void 0, void 0, void 0, function* () {
+        const svc = make();
+        let used = '';
+        svc.openScrcpyCapture = () => __awaiter(void 0, void 0, void 0, function* () { used = 'scrcpy'; return { kill: () => undefined }; });
+        svc.openScreenrecordCapture = (_u, onPacket) => __awaiter(void 0, void 0, void 0, function* () {
+            used = 'screenrecord';
+            onPacket({ type: 'config', data: Buffer.from([0]), ptsMs: 0 });
+            return { kill: () => undefined };
+        });
+        yield svc.start('udid-r', { source: 'screenrecord' });
+        (0, chai_1.expect)(used).to.equal('screenrecord');
+    }));
+    // The WebSocket auto-start path calls start(udid) with NO opts. It must still
+    // honour the configured capture source (read from PluginContext), not silently
+    // default to scrcpy — otherwise a { source: 'screenrecord' } rollback is bypassed.
+    it('start(udid) with no opts uses the source configured in PluginContext (screenrecord)', () => __awaiter(void 0, void 0, void 0, function* () {
+        const svc = make();
+        typedi_1.Container.set(PluginContext_1.PluginContext, {
+            pluginArgs: { streaming: { androidH264: { source: 'screenrecord' } } },
+        });
+        let used = '';
+        svc.openScrcpyCapture = () => __awaiter(void 0, void 0, void 0, function* () {
+            used = 'scrcpy';
+            return { kill: () => undefined };
+        });
+        svc.openScreenrecordCapture = (_u, onPacket) => __awaiter(void 0, void 0, void 0, function* () {
+            used = 'screenrecord';
+            onPacket({ type: 'config', data: Buffer.from([0]), ptsMs: 0 });
+            return { kill: () => undefined };
+        });
+        yield svc.start('udid-ws-sr'); // no opts — mimics the WS startStream(udid) path
+        (0, chai_1.expect)(used).to.equal('screenrecord');
+    }));
+    it('start(udid) with no opts uses the source configured in PluginContext (scrcpy)', () => __awaiter(void 0, void 0, void 0, function* () {
+        const svc = make();
+        typedi_1.Container.set(PluginContext_1.PluginContext, { pluginArgs: { streaming: { androidH264: true } } });
+        let used = '';
+        svc.openScrcpyCapture = (_u, onPacket) => __awaiter(void 0, void 0, void 0, function* () {
+            used = 'scrcpy';
+            onPacket({ type: 'config', data: Buffer.from([0]), ptsMs: 0 });
+            return { kill: () => undefined };
+        });
+        svc.openScreenrecordCapture = () => __awaiter(void 0, void 0, void 0, function* () {
+            used = 'screenrecord';
+            return { kill: () => undefined };
+        });
+        yield svc.start('udid-ws-scrcpy'); // no opts
+        (0, chai_1.expect)(used).to.equal('scrcpy');
+    }));
 });

package/lib/test/unit/scrcpy-server-session.spec.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const ScrcpyServerSession_1 = require("../../src/device-managers/android/ScrcpyServerSession");
+describe('buildScrcpyServerArgs', () => {
+    it('builds the exact video-only app_process argv', () => {
+        const argv = (0, ScrcpyServerSession_1.buildScrcpyServerArgs)({ version: '3.3.4', jarDevicePath: ScrcpyServerSession_1.SCRCPY_DEVICE_JAR_PATH, maxSize: 1560 });
+        (0, chai_1.expect)(argv).to.deep.equal([
+            'shell',
+            `CLASSPATH=${ScrcpyServerSession_1.SCRCPY_DEVICE_JAR_PATH}`,
+            'app_process',
+            '/',
+            'com.genymobile.scrcpy.Server',
+            '3.3.4',
+            'tunnel_forward=true',
+            'audio=false',
+            'control=false',
+            'video=true',
+            'video_codec=h264',
+            'max_size=1560',
+            'video_bit_rate=4000000',
+            'max_fps=30',
+            'send_device_meta=false',
+            'send_codec_meta=false',
+            'send_frame_meta=false',
+            'send_dummy_byte=true',
+            'cleanup=true',
+        ]);
+    });
+});
+describe('scrcpyMaxSizeFromDims', () => {
+    it('caps the LONGER edge so the shorter edge lands near the target', () => {
+        // 1080x2340: short=1080 → scale 720/1080; long=2340*0.6667 ≈ 1560
+        (0, chai_1.expect)((0, ScrcpyServerSession_1.scrcpyMaxSizeFromDims)(1080, 2340)).to.equal(1560);
+    });
+    it('is orientation-agnostic (landscape same result)', () => {
+        (0, chai_1.expect)((0, ScrcpyServerSession_1.scrcpyMaxSizeFromDims)(2340, 1080)).to.equal(1560);
+    });
+    it('never upscales when the short edge is already below target', () => {
+        (0, chai_1.expect)((0, ScrcpyServerSession_1.scrcpyMaxSizeFromDims)(480, 800)).to.equal(800);
+    });
+    it('returns safe default (1440) for non-finite or non-positive dimensions', () => {
+        (0, chai_1.expect)((0, ScrcpyServerSession_1.scrcpyMaxSizeFromDims)(NaN, 800)).to.equal(1440);
+        (0, chai_1.expect)((0, ScrcpyServerSession_1.scrcpyMaxSizeFromDims)(0, 800)).to.equal(1440);
+        (0, chai_1.expect)((0, ScrcpyServerSession_1.scrcpyMaxSizeFromDims)(-100, 800)).to.equal(1440);
+    });
+});
+describe('parseAdbForwardPort', () => {
+    it('reads the assigned port from `adb forward tcp:0` output', () => {
+        (0, chai_1.expect)((0, ScrcpyServerSession_1.parseAdbForwardPort)('41337\n')).to.equal(41337);
+    });
+    it('throws on non-numeric output', () => {
+        (0, chai_1.expect)(() => (0, ScrcpyServerSession_1.parseAdbForwardPort)('error: device offline')).to.throw();
+    });
+    it('throws on zero or negative port numbers', () => {
+        (0, chai_1.expect)(() => (0, ScrcpyServerSession_1.parseAdbForwardPort)('0')).to.throw();
+        (0, chai_1.expect)(() => (0, ScrcpyServerSession_1.parseAdbForwardPort)('-1')).to.throw();
+    });
+});

package/lib/test/unit/scrcpy-version.spec.js

@@ -0,0 +1,16 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const fs_1 = __importDefault(require("fs"));
+const scrcpyVersion_1 = require("../../src/device-managers/android/scrcpyVersion");
+describe('scrcpyVersion', () => {
+    it('derives the jar filename from the single version constant', () => {
+        (0, chai_1.expect)((0, scrcpyVersion_1.scrcpyServerJarFilename)()).to.equal(`scrcpy-server-${scrcpyVersion_1.SCRCPY_SERVER_VERSION}.jar`);
+    });
+    it('the vendored jar exists on disk at the resolved path', () => {
+        (0, chai_1.expect)(fs_1.default.existsSync((0, scrcpyVersion_1.scrcpyServerJarPath)()), (0, scrcpyVersion_1.scrcpyServerJarPath)()).to.equal(true);
+    });
+});

package/lib/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/InternalHttpClient.ts","../src/PluginContext.ts","../src/XenonCapabilityManager.ts","../src/chromeUtils.ts","../src/config.ts","../src/device-utils.ts","../src/index.ts","../src/logger.ts","../src/plugin.ts","../src/prisma.ts","../src/app/index.ts","../src/app/swagger-docs.ts","../src/app/swagger.ts","../src/app/routers/apikeys.ts","../src/app/routers/apps.ts","../src/app/routers/audit.ts","../src/app/routers/auth.ts","../src/app/routers/bug-report.ts","../src/app/routers/build-export.ts","../src/app/routers/capabilities.ts","../src/app/routers/config.ts","../src/app/routers/control.ts","../src/app/routers/dashboard.ts","../src/app/routers/grid.ts","../src/app/routers/interceptor.ts","../src/app/routers/ports.ts","../src/app/routers/processes.ts","../src/app/routers/profile.ts","../src/app/routers/profileIdentity.ts","../src/app/routers/projects.ts","../src/app/routers/recordings.ts","../src/app/routers/reservation.ts","../src/app/routers/sdk-leases.ts","../src/app/routers/sdk-version.ts","../src/app/routers/streamType.ts","../src/app/routers/teams.ts","../src/app/routers/users.ts","../src/app/routers/webhook.ts","../src/app/ws/h264StreamWs.ts","../src/commands/handle.ts","../src/commands/index.ts","../src/dashboard/asset-manager.ts","../src/dashboard/commands.ts","../src/dashboard/event-manager.ts","../src/dashboard/services/app-service.ts","../src/dashboard/services/failure-analysis-service.ts","../src/dashboard/services/session-service.ts","../src/data-service/CircuitBreaker.ts","../src/data-service/config-service.ts","../src/data-service/db.ts","../src/data-service/device-service.ts","../src/data-service/device-store.interface.ts","../src/data-service/device-store.ts","../src/data-service/pending-sessions-service.ts","../src/data-service/pluginArgs.ts","../src/data-service/prisma-service.ts","../src/data-service/prisma-store.ts","../src/data-service/queue-service.ts","../src/data-service/web-config-service.ts","../src/device-managers/AndroidDeviceManager.ts","../src/device-managers/ChromeDriverManager.ts","../src/device-managers/HealthMonitorService.ts","../src/device-managers/IOSDeviceManager.ts","../src/device-managers/NodeDevices.ts","../src/device-managers/iOSTracker.ts","../src/device-managers/index.ts","../src/device-managers/android/AndroidH264StreamService.ts","../src/device-managers/android/AndroidStreamService.ts","../src/device-managers/android/DeviceLockManager.ts","../src/device-managers/android/H264Multiplexer.ts","../src/device-managers/android/h264NalParser.ts","../src/device-managers/cloud/CapabilityManager.ts","../src/device-managers/cloud/Devices.ts","../src/device-managers/ios/IOSDiscoveryService.ts","../src/device-managers/ios/IOSStreamService.ts","../src/device-managers/ios/WDAClient.ts","../src/device-managers/ios/iosBattery.ts","../src/device-managers/ios/iosStreamDiagnostics.ts","../src/enums/Capabilities.ts","../src/enums/Cloud.ts","../src/enums/Platform.ts","../src/enums/SessionType.ts","../src/enums/SocketEvents.ts","../src/generated/client/default.d.ts","../src/generated/client/default.js","../src/generated/client/edge.d.ts","../src/generated/client/edge.js","../src/generated/client/index-browser.js","../src/generated/client/index.d.ts","../src/generated/client/index.js","../src/generated/client/wasm.d.ts","../src/generated/client/wasm.js","../src/generated/client/runtime/edge-esm.js","../src/generated/client/runtime/edge.js","../src/generated/client/runtime/index-browser.d.ts","../src/generated/client/runtime/index-browser.js","../src/generated/client/runtime/library.d.ts","../src/generated/client/runtime/library.js","../src/generated/client/runtime/react-native.js","../src/generated/client/runtime/wasm.js","../src/helpers/UniversalMjpegProxy.ts","../src/helpers/index.ts","../src/interceptors/CommandInterceptor.ts","../src/interfaces/ICloudManager.ts","../src/interfaces/IDevice.ts","../src/interfaces/IDeviceFilterOptions.ts","../src/interfaces/IDeviceManager.ts","../src/interfaces/IOptions.ts","../src/interfaces/IPluginArgs.ts","../src/interfaces/ISessionCapability.ts","../src/logging/sessionContext.ts","../src/middleware/authMiddleware.ts","../src/middleware/csrfMiddleware.ts","../src/middleware/leaseTokenMiddleware.ts","../src/middleware/loginRateLimiter.ts","../src/middleware/rateLimitMiddleware.ts","../src/middleware/roleGuard.ts","../src/middleware/scopeGuard.ts","../src/profiling/AndroidAppProfiler.ts","../src/proxy/wd-command-proxy.ts","../src/scripts/generate-database-migration.ts","../src/scripts/initialize-database.ts","../src/scripts/install-go-ios.ts","../src/scripts/prepare-prisma.ts","../src/scripts/run-migrations.ts","../src/services/AICommandService.ts","../src/services/AIService.ts","../src/services/ApiKeyService.ts","../src/services/CircuitBreaker.ts","../src/services/CleanupService.ts","../src/services/DeviceReconciler.ts","../src/services/EmailService.ts","../src/services/EventBus.ts","../src/services/EventLogService.ts","../src/services/InspectorService.ts","../src/services/InterceptorService.ts","../src/services/MetricsService.ts","../src/services/NetworkConditioningService.ts","../src/services/NotificationService.ts","../src/services/OrphanSweeper.ts","../src/services/PasswordResetService.ts","../src/services/PortAllocator.ts","../src/services/ProcessMetricsService.ts","../src/services/ProcessRegistry.ts","../src/services/RequestLogService.ts","../src/services/ResourceIsolationService.ts","../src/services/SecurityService.ts","../src/services/SelectorStateService.ts","../src/services/SelectorVerificationJob.ts","../src/services/ServerManager.ts","../src/services/SessionHeartbeatService.ts","../src/services/SessionLifecycleService.ts","../src/services/ShutdownCoordinator.ts","../src/services/SocketClient.ts","../src/services/SocketServer.ts","../src/services/TeamService.ts","../src/services/TracingService.ts","../src/services/UserService.ts","../src/services/UserSessionService.ts","../src/services/VideoPipelineService.ts","../src/services/sessionTokenGate.ts","../src/services/artifacts/ArtifactStore.ts","../src/services/autowait/AutowaitService.ts","../src/services/autowait/waitFor.ts","../src/services/bug-report/BugReportService.ts","../src/services/bug-report/archive.ts","../src/services/bug-report/har-collector.ts","../src/services/bug-report/manifest.ts","../src/services/bug-report/readme.ts","../src/services/bug-report/types.ts","../src/services/bug-report/video-slice.ts","../src/services/bug-report/window.ts","../src/services/healing/FuzzyXmlHealingProvider.ts","../src/services/healing/HealEtalonService.ts","../src/services/healing/HealedLocatorGenerator.ts","../src/services/healing/HealingMetrics.ts","../src/services/healing/HealingOrchestrator.ts","../src/services/healing/LlmHealingProvider.ts","../src/services/healing/OcrHealingProvider.ts","../src/services/healing/ResilioTreeHealingProvider.ts","../src/services/healing/VisualAiHealingProvider.ts","../src/services/healing/types.ts","../src/services/identity/bootstrap.ts","../src/services/identity/sessionCleanupCron.ts","../src/services/identity/userAuthorization.ts","../src/services/interceptor/AndroidProxyAdapter.ts","../src/services/interceptor/CertManager.ts","../src/services/interceptor/HarBuilder.ts","../src/services/interceptor/HostFilter.ts","../src/services/interceptor/MitmProxyHost.ts","../src/services/interceptor/MockEngine.ts","../src/services/interceptor/RequestBuffer.ts","../src/services/interceptor/SessionArchive.ts","../src/services/interceptor/types.ts","../src/services/lease/LeaseOrphanSweeper.ts","../src/services/lease/LeaseService.ts","../src/services/lease/buildCapabilityBag.ts","../src/services/lease/leaseToken.ts","../src/services/omni-vision/OmniVisionService.ts","../src/services/omni-vision/VisionAssertionService.ts","../src/services/ports/PortAllocatorClient.ts","../src/services/ports/PortAllocatorService.ts","../src/services/recording/RecordingOrchestrator.ts","../src/services/recording/annotation-render.ts","../src/services/recording/busy-precheck.ts","../src/services/recording/concurrency-gate.ts","../src/services/recording/manualLock.ts","../src/services/recording/proof-bundle.ts","../src/services/recording/recording-store.ts","../src/services/telemetry/attributes.ts","../src/services/token/JwtKeyService.ts","../src/services/token/StreamTicketService.ts","../src/services/token/mcpScopes.ts","../src/sessions/CloudSession.ts","../src/sessions/LocalSession.ts","../src/sessions/RemoteSession.ts","../src/sessions/SessionManager.ts","../src/sessions/XenonSession.ts","../src/types/CLIArgs.ts","../src/types/CloudArgs.ts","../src/types/CloudSchema.ts","../src/types/DeviceType.ts","../src/types/DeviceUpdate.ts","../src/types/IOSDevice.ts","../src/types/Platform.ts","../src/types/SessionStatus.ts","../src/types/express.d.ts","../src/types/healing.d.ts","../src/types/identity.ts","../src/validators/CapabilityValidator.ts","../test/e2e/e2ehelper.ts","../test/e2e/plugin-harness.ts","../test/e2e/plugin.spec.ts","../test/e2e/startup-verification.spec.ts","../test/e2e/telemetry_verification.spec.ts","../test/e2e/video-recording-test.spec.js","../test/e2e/android/conf.spec.js","../test/e2e/android/conf2.spec.js","../test/e2e/android/conf3.spec.js","../test/e2e/hubnode/forward-request.spec.ts","../test/e2e/hubnode/hubnode.spec.ts","../test/e2e/ios/conf1.spec.js","../test/e2e/ios/conf2.spec.js","../test/helpers/seedUser.ts","../test/helpers/test-container.ts","../test/integration/androidDevices.spec.ts","../test/integration/audit-ingest.spec.ts","../test/integration/auth-flow.spec.ts","../test/integration/auth-rate-limit.spec.ts","../test/integration/bug-report-route.spec.ts","../test/integration/cliArgs.js","../test/integration/cross-workflow.spec.ts","../test/integration/forgot-password-rate-limit.spec.ts","../test/integration/forgot-password.spec.ts","../test/integration/healing-events-sessionfilter.spec.ts","../test/integration/legacy-deprecation-headers.spec.ts","../test/integration/migration.spec.ts","../test/integration/node-pair-auth-rest.spec.ts","../test/integration/ports-router.spec.ts","../test/integration/profile-tokens.spec.ts","../test/integration/recordings-router.spec.ts","../test/integration/reset-revokes-sessions.spec.ts","../test/integration/role-matrix.spec.ts","../test/integration/sdk-leases-router.spec.ts","../test/integration/sdk-version.spec.ts","../test/integration/selector-health-endpoint.spec.ts","../test/integration/selector-state-flow.spec.ts","../test/integration/team-membership-migration.spec.ts","../test/integration/team-visibility-dashboard.spec.ts","../test/integration/team-visibility-grid.spec.ts","../test/integration/team-visibility-recordings.spec.ts","../test/integration/users-flow.spec.ts","../test/integration/users-lockout.spec.ts","../test/integration/ios/01iOSSimulator.spec.ts","../test/integration/ios/02iOSDevices.spec.ts","../test/unit/AndroidDeviceManager.spec.ts","../test/unit/ApiKeyService.test.ts","../test/unit/ArtifactStore.spec.ts","../test/unit/AutowaitService.spec.ts","../test/unit/CapabilitiesRouter.spec.ts","../test/unit/ChromeDriverManager.spec.js","../test/unit/CleanupService.spec.ts","../test/unit/CommandInterceptor.autowait.spec.ts","../test/unit/DeviceModel.spec.ts","../test/unit/EmailService.test.ts","../test/unit/EventLogService.spec.ts","../test/unit/FuzzyXmlHealingProvider.test.ts","../test/unit/GetAdbOriginal.js","../test/unit/HealingCascade.test.ts","../test/unit/IOSDeviceManager.spec.js","../test/unit/JwtKeyService.spec.ts","../test/unit/McpScopes.spec.ts","../test/unit/OrphanSweeper.test.ts","../test/unit/PasswordResetService.test.ts","../test/unit/PortAllocator.test.ts","../test/unit/ProcessRegistry.test.ts","../test/unit/ProjectsRouter.spec.ts","../test/unit/RemoteIOs.spec.js","../test/unit/ResilioTreeHealingProvider.test.ts","../test/unit/SessionHeartbeatWrite.test.ts","../test/unit/SessionLifecycleCaps.spec.ts","../test/unit/SessionTokenGate.spec.ts","../test/unit/StreamTicketService.spec.ts","../test/unit/TeamService.test.ts","../test/unit/TokenEndpoint.spec.ts","../test/unit/UserService.test.ts","../test/unit/UserSessionService.test.ts","../test/unit/XenonCapabilityManager.spec.ts","../test/unit/aggregate-hotspots-tuple-key.spec.ts","../test/unit/android-h264-service.spec.ts","../test/unit/android-stream-adb-path.spec.ts","../test/unit/android-stream-encoder.spec.ts","../test/unit/android-stream-fast-start.spec.ts","../test/unit/android-stream-release.spec.ts","../test/unit/auth-me-auth-disabled.test.ts","../test/unit/authMiddleware.bearer.spec.ts","../test/unit/authMiddleware.mcpAudience.spec.ts","../test/unit/authMiddleware.streamTicket.spec.ts","../test/unit/authMiddleware.test.ts","../test/unit/bootstrap-identity.test.ts","../test/unit/build-export.spec.ts","../test/unit/busy-precheck.spec.ts","../test/unit/commands.spec.js","../test/unit/concurrency-gate.spec.ts","../test/unit/config.spec.js","../test/unit/device-service.spec.ts","../test/unit/device-utils.spec.ts","../test/unit/event-manager-regression-hook.spec.ts","../test/unit/extract-access-key-token-pair.test.ts","../test/unit/findAndLockDevice-leasemerge.spec.ts","../test/unit/h264-multiplexer.spec.ts","../test/unit/h264-nal-parser.spec.ts","../test/unit/h264-ws-frame.spec.ts","../test/unit/healing-instrumentation.spec.ts","../test/unit/healing-state-endpoints.spec.ts","../test/unit/healing-tier-gate.spec.ts","../test/unit/helpers.spec.ts","../test/unit/iosBattery.spec.ts","../test/unit/iosStreamDiagnostics.spec.ts","../test/unit/loginRateLimiter.test.ts","../test/unit/manualLock.test.ts","../test/unit/omni-vision.spec.ts","../test/unit/plugin.spec.ts","../test/unit/prisma.spec.ts","../test/unit/profile-router.test.ts","../test/unit/profileIdentity.spec.ts","../test/unit/proof-bundle.spec.ts","../test/unit/rateLimitMiddleware.test.ts","../test/unit/recording-instrumentation.spec.ts","../test/unit/recording-orchestrator.spec.ts","../test/unit/recording-store.spec.ts","../test/unit/roleGuard.test.ts","../test/unit/run-migrations-fail-fast.test.ts","../test/unit/run-migrations.test.ts","../test/unit/selector-state-service.spec.ts","../test/unit/selector-verification-job.spec.ts","../test/unit/socketServer.bearer.spec.ts","../test/unit/stream-status-type.spec.ts","../test/unit/team-filter.test.ts","../test/unit/tracing-service-init.spec.ts","../test/unit/userAuthorization.test.ts","../test/unit/users-router.test.ts","../test/unit/video-pipeline-args.spec.ts","../test/unit/video-pipeline-outputpath.spec.ts","../test/unit/bug-report/archive.spec.ts","../test/unit/bug-report/har-collector.spec.ts","../test/unit/bug-report/manifest.spec.ts","../test/unit/bug-report/readme.spec.ts","../test/unit/bug-report/route.spec.ts","../test/unit/bug-report/service.spec.ts","../test/unit/bug-report/video-slice.spec.ts","../test/unit/bug-report/window.spec.ts","../test/unit/fixtures/device.config.js","../test/unit/fixtures/devices.js","../test/unit/interceptor/AndroidProxyAdapter.spec.ts","../test/unit/interceptor/CertManager.spec.ts","../test/unit/interceptor/HarBuilder.spec.ts","../test/unit/interceptor/HostFilter.spec.ts","../test/unit/interceptor/MitmProxyHost.spec.ts","../test/unit/interceptor/MockEngine.spec.ts","../test/unit/interceptor/RequestBuffer.spec.ts","../test/unit/interceptor/SessionArchive.spec.ts","../test/unit/lease/LeaseOrphanSweeper.spec.ts","../test/unit/lease/LeaseService.spec.ts","../test/unit/lease/buildCapabilityBag.spec.ts","../test/unit/lease/leaseToken.spec.ts","../test/unit/lease/nodePairAuth.spec.ts","../test/unit/ports/PortAllocatorService.spec.ts"],"version":"5.9.3"}
+{"root":["../src/InternalHttpClient.ts","../src/PluginContext.ts","../src/XenonCapabilityManager.ts","../src/chromeUtils.ts","../src/config.ts","../src/device-utils.ts","../src/index.ts","../src/logger.ts","../src/plugin.ts","../src/prisma.ts","../src/app/index.ts","../src/app/swagger-docs.ts","../src/app/swagger.ts","../src/app/routers/androidH264Config.ts","../src/app/routers/apikeys.ts","../src/app/routers/apps.ts","../src/app/routers/audit.ts","../src/app/routers/auth.ts","../src/app/routers/bug-report.ts","../src/app/routers/build-export.ts","../src/app/routers/capabilities.ts","../src/app/routers/config.ts","../src/app/routers/control.ts","../src/app/routers/dashboard.ts","../src/app/routers/grid.ts","../src/app/routers/interceptor.ts","../src/app/routers/ports.ts","../src/app/routers/processes.ts","../src/app/routers/profile.ts","../src/app/routers/profileIdentity.ts","../src/app/routers/projects.ts","../src/app/routers/recordings.ts","../src/app/routers/reservation.ts","../src/app/routers/sdk-leases.ts","../src/app/routers/sdk-version.ts","../src/app/routers/streamType.ts","../src/app/routers/teams.ts","../src/app/routers/users.ts","../src/app/routers/webhook.ts","../src/app/ws/h264StreamWs.ts","../src/commands/handle.ts","../src/commands/index.ts","../src/dashboard/asset-manager.ts","../src/dashboard/commands.ts","../src/dashboard/event-manager.ts","../src/dashboard/services/app-service.ts","../src/dashboard/services/failure-analysis-service.ts","../src/dashboard/services/session-service.ts","../src/data-service/CircuitBreaker.ts","../src/data-service/config-service.ts","../src/data-service/db.ts","../src/data-service/device-service.ts","../src/data-service/device-store.interface.ts","../src/data-service/device-store.ts","../src/data-service/pending-sessions-service.ts","../src/data-service/pluginArgs.ts","../src/data-service/prisma-service.ts","../src/data-service/prisma-store.ts","../src/data-service/queue-service.ts","../src/data-service/web-config-service.ts","../src/device-managers/AndroidDeviceManager.ts","../src/device-managers/ChromeDriverManager.ts","../src/device-managers/HealthMonitorService.ts","../src/device-managers/IOSDeviceManager.ts","../src/device-managers/NodeDevices.ts","../src/device-managers/iOSTracker.ts","../src/device-managers/index.ts","../src/device-managers/android/AndroidH264StreamService.ts","../src/device-managers/android/AndroidStreamService.ts","../src/device-managers/android/DeviceLockManager.ts","../src/device-managers/android/H264Multiplexer.ts","../src/device-managers/android/ScrcpyServerSession.ts","../src/device-managers/android/h264NalParser.ts","../src/device-managers/android/scrcpyVersion.ts","../src/device-managers/cloud/CapabilityManager.ts","../src/device-managers/cloud/Devices.ts","../src/device-managers/ios/IOSDiscoveryService.ts","../src/device-managers/ios/IOSStreamService.ts","../src/device-managers/ios/WDAClient.ts","../src/device-managers/ios/iosBattery.ts","../src/device-managers/ios/iosStreamDiagnostics.ts","../src/enums/Capabilities.ts","../src/enums/Cloud.ts","../src/enums/Platform.ts","../src/enums/SessionType.ts","../src/enums/SocketEvents.ts","../src/generated/client/default.d.ts","../src/generated/client/default.js","../src/generated/client/edge.d.ts","../src/generated/client/edge.js","../src/generated/client/index-browser.js","../src/generated/client/index.d.ts","../src/generated/client/index.js","../src/generated/client/wasm.d.ts","../src/generated/client/wasm.js","../src/generated/client/runtime/edge-esm.js","../src/generated/client/runtime/edge.js","../src/generated/client/runtime/index-browser.d.ts","../src/generated/client/runtime/index-browser.js","../src/generated/client/runtime/library.d.ts","../src/generated/client/runtime/library.js","../src/generated/client/runtime/react-native.js","../src/generated/client/runtime/wasm.js","../src/helpers/UniversalMjpegProxy.ts","../src/helpers/index.ts","../src/interceptors/CommandInterceptor.ts","../src/interfaces/ICloudManager.ts","../src/interfaces/IDevice.ts","../src/interfaces/IDeviceFilterOptions.ts","../src/interfaces/IDeviceManager.ts","../src/interfaces/IOptions.ts","../src/interfaces/IPluginArgs.ts","../src/interfaces/ISessionCapability.ts","../src/logging/sessionContext.ts","../src/middleware/authMiddleware.ts","../src/middleware/csrfMiddleware.ts","../src/middleware/leaseTokenMiddleware.ts","../src/middleware/loginRateLimiter.ts","../src/middleware/rateLimitMiddleware.ts","../src/middleware/roleGuard.ts","../src/middleware/scopeGuard.ts","../src/profiling/AndroidAppProfiler.ts","../src/proxy/wd-command-proxy.ts","../src/scripts/generate-database-migration.ts","../src/scripts/initialize-database.ts","../src/scripts/install-go-ios.ts","../src/scripts/prepare-prisma.ts","../src/scripts/run-migrations.ts","../src/services/AICommandService.ts","../src/services/AIService.ts","../src/services/ApiKeyService.ts","../src/services/CircuitBreaker.ts","../src/services/CleanupService.ts","../src/services/DeviceReconciler.ts","../src/services/EmailService.ts","../src/services/EventBus.ts","../src/services/EventLogService.ts","../src/services/InspectorService.ts","../src/services/InterceptorService.ts","../src/services/MetricsService.ts","../src/services/NetworkConditioningService.ts","../src/services/NotificationService.ts","../src/services/OrphanSweeper.ts","../src/services/PasswordResetService.ts","../src/services/PortAllocator.ts","../src/services/ProcessMetricsService.ts","../src/services/ProcessRegistry.ts","../src/services/RequestLogService.ts","../src/services/ResourceIsolationService.ts","../src/services/SecurityService.ts","../src/services/SelectorStateService.ts","../src/services/SelectorVerificationJob.ts","../src/services/ServerManager.ts","../src/services/SessionHeartbeatService.ts","../src/services/SessionLifecycleService.ts","../src/services/ShutdownCoordinator.ts","../src/services/SocketClient.ts","../src/services/SocketServer.ts","../src/services/TeamService.ts","../src/services/TracingService.ts","../src/services/UserService.ts","../src/services/UserSessionService.ts","../src/services/VideoPipelineService.ts","../src/services/sessionTokenGate.ts","../src/services/artifacts/ArtifactStore.ts","../src/services/autowait/AutowaitService.ts","../src/services/autowait/waitFor.ts","../src/services/bug-report/BugReportService.ts","../src/services/bug-report/archive.ts","../src/services/bug-report/har-collector.ts","../src/services/bug-report/manifest.ts","../src/services/bug-report/readme.ts","../src/services/bug-report/types.ts","../src/services/bug-report/video-slice.ts","../src/services/bug-report/window.ts","../src/services/healing/FuzzyXmlHealingProvider.ts","../src/services/healing/HealEtalonService.ts","../src/services/healing/HealedLocatorGenerator.ts","../src/services/healing/HealingMetrics.ts","../src/services/healing/HealingOrchestrator.ts","../src/services/healing/LlmHealingProvider.ts","../src/services/healing/OcrHealingProvider.ts","../src/services/healing/ResilioTreeHealingProvider.ts","../src/services/healing/VisualAiHealingProvider.ts","../src/services/healing/types.ts","../src/services/identity/bootstrap.ts","../src/services/identity/sessionCleanupCron.ts","../src/services/identity/userAuthorization.ts","../src/services/interceptor/AndroidProxyAdapter.ts","../src/services/interceptor/CertManager.ts","../src/services/interceptor/HarBuilder.ts","../src/services/interceptor/HostFilter.ts","../src/services/interceptor/MitmProxyHost.ts","../src/services/interceptor/MockEngine.ts","../src/services/interceptor/RequestBuffer.ts","../src/services/interceptor/SessionArchive.ts","../src/services/interceptor/types.ts","../src/services/lease/LeaseOrphanSweeper.ts","../src/services/lease/LeaseService.ts","../src/services/lease/buildCapabilityBag.ts","../src/services/lease/leaseToken.ts","../src/services/omni-vision/OmniVisionService.ts","../src/services/omni-vision/VisionAssertionService.ts","../src/services/ports/PortAllocatorClient.ts","../src/services/ports/PortAllocatorService.ts","../src/services/recording/RecordingOrchestrator.ts","../src/services/recording/annotation-render.ts","../src/services/recording/busy-precheck.ts","../src/services/recording/concurrency-gate.ts","../src/services/recording/manualLock.ts","../src/services/recording/proof-bundle.ts","../src/services/recording/recording-store.ts","../src/services/telemetry/attributes.ts","../src/services/token/JwtKeyService.ts","../src/services/token/StreamTicketService.ts","../src/services/token/mcpScopes.ts","../src/sessions/CloudSession.ts","../src/sessions/LocalSession.ts","../src/sessions/RemoteSession.ts","../src/sessions/SessionManager.ts","../src/sessions/XenonSession.ts","../src/types/CLIArgs.ts","../src/types/CloudArgs.ts","../src/types/CloudSchema.ts","../src/types/DeviceType.ts","../src/types/DeviceUpdate.ts","../src/types/IOSDevice.ts","../src/types/Platform.ts","../src/types/SessionStatus.ts","../src/types/express.d.ts","../src/types/healing.d.ts","../src/types/identity.ts","../src/validators/CapabilityValidator.ts","../test/e2e/e2ehelper.ts","../test/e2e/plugin-harness.ts","../test/e2e/plugin.spec.ts","../test/e2e/startup-verification.spec.ts","../test/e2e/telemetry_verification.spec.ts","../test/e2e/video-recording-test.spec.js","../test/e2e/android/conf.spec.js","../test/e2e/android/conf2.spec.js","../test/e2e/android/conf3.spec.js","../test/e2e/hubnode/forward-request.spec.ts","../test/e2e/hubnode/hubnode.spec.ts","../test/e2e/ios/conf1.spec.js","../test/e2e/ios/conf2.spec.js","../test/helpers/seedUser.ts","../test/helpers/test-container.ts","../test/integration/androidDevices.spec.ts","../test/integration/audit-ingest.spec.ts","../test/integration/auth-flow.spec.ts","../test/integration/auth-rate-limit.spec.ts","../test/integration/bug-report-route.spec.ts","../test/integration/cliArgs.js","../test/integration/cross-workflow.spec.ts","../test/integration/forgot-password-rate-limit.spec.ts","../test/integration/forgot-password.spec.ts","../test/integration/healing-events-sessionfilter.spec.ts","../test/integration/legacy-deprecation-headers.spec.ts","../test/integration/migration.spec.ts","../test/integration/node-pair-auth-rest.spec.ts","../test/integration/ports-router.spec.ts","../test/integration/profile-tokens.spec.ts","../test/integration/recordings-router.spec.ts","../test/integration/reset-revokes-sessions.spec.ts","../test/integration/role-matrix.spec.ts","../test/integration/sdk-leases-router.spec.ts","../test/integration/sdk-version.spec.ts","../test/integration/selector-health-endpoint.spec.ts","../test/integration/selector-state-flow.spec.ts","../test/integration/team-membership-migration.spec.ts","../test/integration/team-visibility-dashboard.spec.ts","../test/integration/team-visibility-grid.spec.ts","../test/integration/team-visibility-recordings.spec.ts","../test/integration/users-flow.spec.ts","../test/integration/users-lockout.spec.ts","../test/integration/ios/01iOSSimulator.spec.ts","../test/integration/ios/02iOSDevices.spec.ts","../test/unit/AndroidDeviceManager.spec.ts","../test/unit/ApiKeyService.test.ts","../test/unit/ArtifactStore.spec.ts","../test/unit/AutowaitService.spec.ts","../test/unit/CapabilitiesRouter.spec.ts","../test/unit/ChromeDriverManager.spec.js","../test/unit/CleanupService.spec.ts","../test/unit/CommandInterceptor.autowait.spec.ts","../test/unit/DeviceModel.spec.ts","../test/unit/EmailService.test.ts","../test/unit/EventLogService.spec.ts","../test/unit/FuzzyXmlHealingProvider.test.ts","../test/unit/GetAdbOriginal.js","../test/unit/HealingCascade.test.ts","../test/unit/IOSDeviceManager.spec.js","../test/unit/JwtKeyService.spec.ts","../test/unit/McpScopes.spec.ts","../test/unit/OrphanSweeper.test.ts","../test/unit/PasswordResetService.test.ts","../test/unit/PortAllocator.test.ts","../test/unit/ProcessRegistry.test.ts","../test/unit/ProjectsRouter.spec.ts","../test/unit/RemoteIOs.spec.js","../test/unit/ResilioTreeHealingProvider.test.ts","../test/unit/SessionHeartbeatWrite.test.ts","../test/unit/SessionLifecycleCaps.spec.ts","../test/unit/SessionTokenGate.spec.ts","../test/unit/StreamTicketService.spec.ts","../test/unit/TeamService.test.ts","../test/unit/TokenEndpoint.spec.ts","../test/unit/UserService.test.ts","../test/unit/UserSessionService.test.ts","../test/unit/XenonCapabilityManager.spec.ts","../test/unit/aggregate-hotspots-tuple-key.spec.ts","../test/unit/android-h264-config.spec.ts","../test/unit/android-h264-service.spec.ts","../test/unit/android-stream-adb-path.spec.ts","../test/unit/android-stream-encoder.spec.ts","../test/unit/android-stream-fast-start.spec.ts","../test/unit/android-stream-release.spec.ts","../test/unit/auth-me-auth-disabled.test.ts","../test/unit/authMiddleware.bearer.spec.ts","../test/unit/authMiddleware.mcpAudience.spec.ts","../test/unit/authMiddleware.streamTicket.spec.ts","../test/unit/authMiddleware.test.ts","../test/unit/bootstrap-identity.test.ts","../test/unit/build-export.spec.ts","../test/unit/busy-precheck.spec.ts","../test/unit/commands.spec.js","../test/unit/concurrency-gate.spec.ts","../test/unit/config.spec.js","../test/unit/device-service.spec.ts","../test/unit/device-utils.spec.ts","../test/unit/event-manager-regression-hook.spec.ts","../test/unit/extract-access-key-token-pair.test.ts","../test/unit/findAndLockDevice-leasemerge.spec.ts","../test/unit/h264-multiplexer.spec.ts","../test/unit/h264-nal-parser.spec.ts","../test/unit/h264-ws-frame.spec.ts","../test/unit/healing-instrumentation.spec.ts","../test/unit/healing-state-endpoints.spec.ts","../test/unit/healing-tier-gate.spec.ts","../test/unit/helpers.spec.ts","../test/unit/iosBattery.spec.ts","../test/unit/iosStreamDiagnostics.spec.ts","../test/unit/loginRateLimiter.test.ts","../test/unit/manualLock.test.ts","../test/unit/omni-vision.spec.ts","../test/unit/plugin.spec.ts","../test/unit/prisma.spec.ts","../test/unit/profile-router.test.ts","../test/unit/profileIdentity.spec.ts","../test/unit/proof-bundle.spec.ts","../test/unit/rateLimitMiddleware.test.ts","../test/unit/recording-instrumentation.spec.ts","../test/unit/recording-orchestrator.spec.ts","../test/unit/recording-store.spec.ts","../test/unit/roleGuard.test.ts","../test/unit/run-migrations-fail-fast.test.ts","../test/unit/run-migrations.test.ts","../test/unit/scrcpy-server-session.spec.ts","../test/unit/scrcpy-version.spec.ts","../test/unit/selector-state-service.spec.ts","../test/unit/selector-verification-job.spec.ts","../test/unit/socketServer.bearer.spec.ts","../test/unit/stream-status-type.spec.ts","../test/unit/team-filter.test.ts","../test/unit/tracing-service-init.spec.ts","../test/unit/userAuthorization.test.ts","../test/unit/users-router.test.ts","../test/unit/video-pipeline-args.spec.ts","../test/unit/video-pipeline-outputpath.spec.ts","../test/unit/bug-report/archive.spec.ts","../test/unit/bug-report/har-collector.spec.ts","../test/unit/bug-report/manifest.spec.ts","../test/unit/bug-report/readme.spec.ts","../test/unit/bug-report/route.spec.ts","../test/unit/bug-report/service.spec.ts","../test/unit/bug-report/video-slice.spec.ts","../test/unit/bug-report/window.spec.ts","../test/unit/fixtures/device.config.js","../test/unit/fixtures/devices.js","../test/unit/interceptor/AndroidProxyAdapter.spec.ts","../test/unit/interceptor/CertManager.spec.ts","../test/unit/interceptor/HarBuilder.spec.ts","../test/unit/interceptor/HostFilter.spec.ts","../test/unit/interceptor/MitmProxyHost.spec.ts","../test/unit/interceptor/MockEngine.spec.ts","../test/unit/interceptor/RequestBuffer.spec.ts","../test/unit/interceptor/SessionArchive.spec.ts","../test/unit/lease/LeaseOrphanSweeper.spec.ts","../test/unit/lease/LeaseService.spec.ts","../test/unit/lease/buildCapabilityBag.spec.ts","../test/unit/lease/leaseToken.spec.ts","../test/unit/lease/nodePairAuth.spec.ts","../test/unit/ports/PortAllocatorService.spec.ts"],"version":"5.9.3"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xenon-device-management/xenon",
-  "version": "1.9.1",
+  "version": "1.10.0",
   "description": "Xenon - Intelligent Mobile Infrastructure. A self-healing device orchestration platform for Appium.",
   "main": "./lib/src/index.js",
   "exports": {
@@ -12,7 +12,7 @@
     "postinstall": "node scripts/generate-prisma.js",
     "build": "node scripts/generate-prisma.js && tsc -b && npm run build:copy",
     "build:all": "npm run build:xenon && npm run build",
-    "build:copy": "rm -rf lib/public && mkdir -p lib/src && cp -R src/public lib/ && cp -R src/generated lib/src/ && cp schema.json lib/",
+    "build:copy": "rm -rf lib/public && mkdir -p lib/src && cp -R src/public lib/ && cp -R src/generated lib/src/ && cp schema.json lib/ && mkdir -p lib/src/device-managers/android/vendor && cp src/device-managers/android/vendor/*.jar lib/src/device-managers/android/vendor/",
     "build:schema": "node scripts/generate-types-from-schema.js",
     "build:xenon": "sh scripts/build-xenon.sh",
     "dev": "npm run db:migrate && npm run build && npm run plugin:reinstall && npm run server",

package/schema.json

@@ -475,9 +475,16 @@
             "description": "Live-streaming options.",
             "properties": {
                 "androidH264": {
-                    "type": "boolean",
                     "default": false,
-                    "description": "Use scrcpy H.264 for Android live preview (WebCodecs in the browser) instead of the MJPEG screencap loop. Falls back to MJPEG when unsupported."
+                    "description": "Android live preview: false/omitted = MJPEG; true = H.264 via scrcpy; { \"source\": \"scrcpy\" | \"screenrecord\" } to pick the capture source explicitly. Falls back to MJPEG when unsupported.",
+                    "oneOf": [
+                        { "type": "boolean" },
+                        {
+                            "type": "object",
+                            "additionalProperties": false,
+                            "properties": { "source": { "type": "string", "enum": ["scrcpy", "screenrecord"] } }
+                        }
+                    ]
                 }
             }
         }