@xenon-device-management/xenon 1.29.0 → 2.0.0

package/lib/src/XenonCapabilityManager.js

@@ -49,7 +49,6 @@ exports.XENON_CAPABILITIES = void 0;
 exports.androidCapabilities = androidCapabilities;
 exports.iOSCapabilities = iOSCapabilities;
 exports.extractTeamCap = extractTeamCap;
-exports.extractAccessKeyCap = extractAccessKeyCap;
 exports.extractAccessKeyTokenPair = extractAccessKeyTokenPair;
 exports.extractSessionToken = extractSessionToken;
 exports.getXenonCapabilities = getXenonCapabilities;
@@ -58,6 +57,7 @@ const lodash_1 = __importDefault(require("lodash"));
 const typedi_1 = require("typedi");
 const PortAllocator_1 = require("./services/PortAllocator");
 const logger_1 = __importDefault(require("./logger"));
+const xenonOptions_1 = require("./services/session/xenonOptions");
 var XENON_CAPABILITIES;
 (function (XENON_CAPABILITIES) {
     XENON_CAPABILITIES["BUILD_NAME"] = "build";
@@ -68,7 +68,6 @@ var XENON_CAPABILITIES;
     XENON_CAPABILITIES["LIVE_VIDEO"] = "live_video";
     XENON_CAPABILITIES["SCREENSHOT_ON_FAILURE"] = "screenshot_on_failure";
     XENON_CAPABILITIES["SCREENSHOT_ON_FAIL"] = "screenshotOnFailure";
-    XENON_CAPABILITIES["XENON_OPTIONS"] = "xenon:options";
     XENON_CAPABILITIES["SAVE_DEVICE_LOGS"] = "saveDeviceLogs";
     XENON_CAPABILITIES["SAVE_LOGS"] = "save_device_logs";
     XENON_CAPABILITIES["SCREENSHOT_ON_EVERY_COMMAND"] = "screenshot_on_every_command";
@@ -221,58 +220,33 @@ function extractTeamCap(caps) {
     }
     return undefined;
 }
-function extractAccessKeyCap(caps) {
-    var _a;
-    const merged = Object.assign({}, ((_a = caps.firstMatch) === null || _a === void 0 ? void 0 : _a[0]) || {}, caps.alwaysMatch || {});
-    const prefixes = ['xenon:', 'xe:', 'appium:', ''];
-    const names = ['accessKey', 'access_key'];
-    for (const prefix of prefixes) {
-        for (const name of names) {
-            const v = merged[prefix ? `${prefix}${name}` : name];
-            if (typeof v === 'string' && v.length > 0)
-                return v;
-        }
-    }
-    return undefined;
-}
-// Returns the (accessKey, token) pair from df:options.{accessKey,token} or
-// equivalently df:options.{access_key,token}. Returns undefined if either
-// piece is missing — callers fall back to extractAccessKeyCap (legacy).
+// Returns the API-key pair from xe:options.{accessKey,token} (or the
+// xenon:options alias; xe:options wins field by field). Returns undefined if
+// either piece is missing. This is the only key-pair credential a session can
+// present; there is no flat `xenon:accessKey`.
 function extractAccessKeyTokenPair(caps) {
-    var _a, _b, _c, _d;
-    const merged = Object.assign({}, ((_a = caps.firstMatch) === null || _a === void 0 ? void 0 : _a[0]) || {}, caps.alwaysMatch || {});
-    const dfOptions = (_c = (_b = merged['df:options']) !== null && _b !== void 0 ? _b : merged['xenon:df:options']) !== null && _c !== void 0 ? _c : merged['appium:df:options'];
-    if (!dfOptions || typeof dfOptions !== 'object')
-        return undefined;
-    const accessKey = (_d = dfOptions.accessKey) !== null && _d !== void 0 ? _d : dfOptions.access_key;
-    const token = dfOptions.token;
-    if (typeof accessKey !== 'string' || typeof token !== 'string')
-        return undefined;
-    if (!accessKey || !token)
-        return undefined;
-    return { accessKey, token };
+    const options = (0, xenonOptions_1.xenonOptionsOf)(caps);
+    const accessKey = (0, xenonOptions_1.stringOption)(options, 'accessKey');
+    const token = (0, xenonOptions_1.stringOption)(options, 'token');
+    return accessKey && token ? { accessKey, token } : undefined;
 }
-// Returns the xenon:options.sessionToken JWT (hub-minted, aud 'xenon-session'),
-// used by the opt-in session-token gate (spec §3 item 6, risk R9). Returns
-// null if absent — callers combine this with the df:options access-key/token
-// pair to decide whether createSession is authorized.
+// Returns the xe:options.sessionToken JWT (hub-minted, aud 'xenon-session'),
+// or the xenon:options alias's, used by the opt-in session-token gate (spec
+// §3 item 6, risk R9). Returns null if absent — callers combine this with the
+// access-key/token pair to decide whether createSession is authorized.
 function extractSessionToken(caps) {
     var _a;
-    const read = (obj) => {
-        const xo = obj === null || obj === void 0 ? void 0 : obj['xenon:options'];
-        const t = xo && typeof xo === 'object' ? xo.sessionToken : undefined;
-        return typeof t === 'string' && t.length > 0 ? t : null;
-    };
-    const fm = Array.isArray(caps === null || caps === void 0 ? void 0 : caps.firstMatch) ? caps.firstMatch[0] : undefined;
-    return (_a = read(caps === null || caps === void 0 ? void 0 : caps.alwaysMatch)) !== null && _a !== void 0 ? _a : read(fm);
+    return (_a = (0, xenonOptions_1.stringOption)((0, xenonOptions_1.xenonOptionsOf)(caps), 'sessionToken')) !== null && _a !== void 0 ? _a : null;
 }
 function getXenonCapabilities(caps) {
     var _a, _b;
     const mergedCapabilites = Object.assign({}, (_b = (_a = caps.firstMatch) === null || _a === void 0 ? void 0 : _a[0]) !== null && _b !== void 0 ? _b : {}, caps.alwaysMatch);
+    const xenonOptions = (0, xenonOptions_1.xenonOptionsIn)(mergedCapabilites);
     const getAnyCap = (snake, camel) => {
         // Strict prefix resolution: xe:, appium:, no-prefix — snake_case + camelCase fallbacks.
-        // Also accept the namespaced `xenon:options.<name>` form, which is how other Appium
-        // plugins document nested options and what most users naturally try first.
+        // Also accept the namespaced `xe:options.<name>` form (or its `xenon:options` alias),
+        // which is how other Appium plugins document nested options and what most users
+        // naturally try first.
         const prefixes = ['xe:', 'appium:', ''];
         const names = [snake, camel];
         for (const prefix of prefixes) {
@@ -282,12 +256,9 @@ function getXenonCapabilities(caps) {
                     return mergedCapabilites[key];
             }
         }
-        const xenonOptions = mergedCapabilites[XENON_CAPABILITIES.XENON_OPTIONS];
-        if (xenonOptions && typeof xenonOptions === 'object') {
-            for (const name of names) {
-                if (xenonOptions[name] !== undefined)
-                    return xenonOptions[name];
-            }
+        for (const name of names) {
+            if (xenonOptions[name] !== undefined)
+                return xenonOptions[name];
         }
         return undefined;
     };

package/lib/src/app/index.js

@@ -55,8 +55,7 @@ const cors_1 = __importDefault(require("cors"));
 const async_lock_1 = __importDefault(require("async-lock"));
 const crypto_1 = __importDefault(require("crypto"));
 const InternalHttpClient_1 = require("../InternalHttpClient");
-const config_1 = require("../config");
-const logger_1 = __importDefault(require("../logger"));
+const logger_1 = __importStar(require("../logger"));
 const sessionContext_1 = require("../logging/sessionContext");
 const dashboard_1 = __importDefault(require("./routers/dashboard"));
 const grid_1 = __importDefault(require("./routers/grid"));
@@ -67,7 +66,7 @@ const reservation_1 = __importDefault(require("./routers/reservation"));
 const ports_1 = __importDefault(require("./routers/ports"));
 const sdk_leases_1 = __importDefault(require("./routers/sdk-leases"));
 const sdk_version_1 = __importDefault(require("./routers/sdk-version"));
-const config_2 = __importDefault(require("./routers/config"));
+const config_1 = __importDefault(require("./routers/config"));
 const interceptor_1 = __importDefault(require("./routers/interceptor"));
 const bug_report_1 = __importDefault(require("./routers/bug-report"));
 const recordings_1 = __importDefault(require("./routers/recordings"));
@@ -81,6 +80,8 @@ const capabilities_1 = require("./routers/capabilities");
 const projects_1 = require("./routers/projects");
 const audit_1 = require("./routers/audit");
 const authMiddleware_1 = require("../middleware/authMiddleware");
+const roleGuard_1 = require("../middleware/roleGuard");
+const scopeGuard_1 = require("../middleware/scopeGuard");
 const rateLimitMiddleware_1 = require("../middleware/rateLimitMiddleware");
 const csrfMiddleware_1 = require("../middleware/csrfMiddleware");
 const swagger_1 = require("./swagger");
@@ -214,8 +215,10 @@ router.use((req, res, next) => {
 });
 staticFilesRouter.use(express_1.default.static(publicPath, { index: false }));
 router.use('/api', apiRouter);
-// Principal Fix: Rename collision route from /assets to /session-recordings to avoid conflict with dashboard's /assets folder
-router.use('/session-recordings', express_1.default.static(config_1.config.sessionAssetsPath));
+// Session files are served by GET /api/session/:sessionId/asset/:kind/:file,
+// behind the login and the session's team check. They used to be an
+// express.static mount here, outside the login, which also served every
+// recording and interceptor capture stored under the same folder.
 router.use(staticFilesRouter);
 function createRouter(pluginArgs) {
     // CSRF defense (runs before /health so even a hostile GET->POST confused-
@@ -253,9 +256,11 @@ function createRouter(pluginArgs) {
     // MCP audit ingest: the 2b gateway ships batched tool-call audit JSONL here,
     // authenticated as a service identity (roleGuard(MEMBER) + admin scope).
     apiRouter.use('/audit', (0, audit_1.auditRouter)());
-    // Exposes plugin CLI args (may include host, hub URL, etc.) — auth-gated.
-    apiRouter.get('/cliArgs', (_req, res) => __awaiter(this, void 0, void 0, function* () {
-        res.json(yield (0, pluginArgs_1.getCLIArgs)());
+    // The stored Appium arguments: a database URL with its password, AI and
+    // cloud provider keys, the hub URL. Admin-only, like /processes, and
+    // redacted the way the startup log redacts them.
+    apiRouter.get('/cliArgs', (0, roleGuard_1.roleGuard)('ADMIN'), (0, scopeGuard_1.scopeGuard)(['admin']), (_req, res) => __awaiter(this, void 0, void 0, function* () {
+        res.json((0, logger_1.redactSecrets)(yield (0, pluginArgs_1.getCLIArgs)()));
     }));
     // Prometheus-style metrics — auth-gated to avoid operational recon.
     apiRouter.get('/metrics', (_req, res) => __awaiter(this, void 0, void 0, function* () {
@@ -269,7 +274,7 @@ function createRouter(pluginArgs) {
     control_1.default.register(apiRouter);
     apps_1.default.register(apiRouter);
     webhook_1.default.register(apiRouter);
-    config_2.default.register(apiRouter, pluginArgs);
+    config_1.default.register(apiRouter, pluginArgs);
     interceptor_1.default.register(apiRouter);
     bug_report_1.default.register(apiRouter);
     recordings_1.default.register(apiRouter);

package/lib/src/app/insertBeforeRoutes.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.routerStackOf = routerStackOf;
+exports.insertBeforeRoutes = insertBeforeRoutes;
+function isRouter(candidate) {
+    return !!candidate && Array.isArray(candidate.stack);
+}
+function findRouter(app) {
+    if (!app)
+        return undefined;
+    if (isRouter(app._router))
+        return { router: app._router, shape: 'express4' };
+    let router;
+    try {
+        // Express 4 defines `app.router` as a getter that throws a deprecation
+        // error. Express 5 defines it as the router itself.
+        router = app.router;
+    }
+    catch (_a) {
+        router = undefined;
+    }
+    if (isRouter(router))
+        return { router, shape: 'express5' };
+    return undefined;
+}
+/** The app's router stack, or undefined when neither Express shape has one. */
+function routerStackOf(app) {
+    var _a;
+    return (_a = findRouter(app)) === null || _a === void 0 ? void 0 : _a.router.stack;
+}
+function insertBeforeRoutes(app, path, handler) {
+    const found = findRouter(app);
+    if (!found) {
+        return {
+            placed: false,
+            reason: 'no Express router found (neither app._router nor app.router has a stack)',
+        };
+    }
+    const { stack } = found.router;
+    const lengthBefore = stack.length;
+    app.use(path, handler);
+    const added = stack.splice(lengthBefore);
+    if (added.length !== 1) {
+        // app.use() added its layer somewhere other than the stack we found, or
+        // added more than one. Put back whatever it added and refuse to guess.
+        stack.push(...added);
+        return {
+            placed: false,
+            shape: found.shape,
+            reason: `app.use() added ${added.length} layers to the router stack, expected 1`,
+        };
+    }
+    const firstRoute = stack.findIndex((layer) => !!layer.route);
+    const index = firstRoute === -1 ? stack.length : firstRoute;
+    stack.splice(index, 0, added[0]);
+    return { placed: true, shape: found.shape, index };
+}

package/lib/src/app/registerCommandAuth.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeBasePath = normalizeBasePath;
+exports.sessionCommandPath = sessionCommandPath;
+exports.registerCommandAuth = registerCommandAuth;
+const typedi_1 = require("typedi");
+const logger_1 = __importDefault(require("../logger"));
+const config_1 = require("../config");
+const SessionOwnerResolver_1 = require("../services/device-access/SessionOwnerResolver");
+const commandAuth_1 = require("../middleware/commandAuth");
+const commandCaller_1 = require("../middleware/commandCaller");
+const insertBeforeRoutes_1 = require("./insertBeforeRoutes");
+/**
+ * Appium's base-path rule (base-driver `normalizeBasePath`): drop one trailing
+ * '/', and add a leading '/' unless the path is empty. `cliArgs.basePath`
+ * reaches a plugin as the operator wrote it, while Appium normalises its own
+ * copy before building routes, so the guard must normalise the same way or it
+ * would miss the routes it is meant to sit in front of.
+ */
+function normalizeBasePath(basePath) {
+    let normalized = typeof basePath === 'string' ? basePath : '';
+    normalized = normalized.replace(/\/$/, '');
+    if (normalized !== '' && !normalized.startsWith('/'))
+        normalized = `/${normalized}`;
+    return normalized;
+}
+/**
+ * Everything under `<basePath>/session/:sessionId`, every method. The create
+ * route (`POST <basePath>/session`) has no id segment and does not match.
+ */
+function sessionCommandPath(basePath) {
+    return `${normalizeBasePath(basePath)}/session/:sessionId`;
+}
+/**
+ * Install per-command auth (commandAuth.ts) ahead of Appium's routes. Called
+ * from ServerManager.registerRoutes, which Appium runs after adding them.
+ *
+ * The middleware is always installed and reads the setting per request, so a
+ * server with the setting off pays one env check per session command and does
+ * no lookups. If it cannot be placed ahead of the routes the error is logged,
+ * and with the setting on (and auth enabled) the server refuses to start:
+ * an operator who asked for the check must not get a server that silently
+ * serves session commands without it.
+ */
+function registerCommandAuth(app, cliArgs, overrides = {}) {
+    const deps = Object.assign({ enabled: () => (0, commandAuth_1.commandAuthEnabled)(), authDisabled: () => config_1.config.authDisabled === true, verifier: new commandCaller_1.CommandCallerVerifier(), ownerOf: (sessionId) => typedi_1.Container.get(SessionOwnerResolver_1.SessionOwnerResolver).ownerOf(sessionId), logger: logger_1.default.scope('CommandAuth') }, overrides);
+    const path = sessionCommandPath(cliArgs === null || cliArgs === void 0 ? void 0 : cliArgs.basePath);
+    const result = (0, insertBeforeRoutes_1.insertBeforeRoutes)(app, path, (0, commandAuth_1.createCommandAuthMiddleware)(deps));
+    const active = deps.enabled() && !deps.authDisabled();
+    if (!result.placed) {
+        deps.logger.error(`Per-command auth could not be placed ahead of Appium's routes for ${path}: ${result.reason}.`);
+        if (active) {
+            throw new Error('XENON_REQUIRE_COMMAND_AUTH is on, but the per-command check could not be placed ahead ' +
+                "of Appium's WebDriver routes, so it would never run. Refusing to start rather than " +
+                'serve session commands unchecked.');
+        }
+        return result;
+    }
+    deps.logger.info(active
+        ? `Per-command auth is ON: every request under ${path} needs the session owner's ` +
+            'credentials or an override admin (XENON_REQUIRE_COMMAND_AUTH).'
+        : `Per-command auth is off for ${path} (XENON_REQUIRE_COMMAND_AUTH not set, or auth disabled).`);
+    return result;
+}

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

@@ -20,15 +20,22 @@ const logger_1 = __importDefault(require("../../logger"));
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const scopeGuard_1 = require("../../middleware/scopeGuard");
 const roleGuard_1 = require("../../middleware/roleGuard");
+const appVisibility_1 = require("../../services/device-access/appVisibility");
+const prisma_1 = require("../../prisma");
 const router = (0, express_1.Router)();
 // MEMBER-tier baseline: device app visibility requires authenticated user
 router.use((0, roleGuard_1.roleGuard)('MEMBER'));
 // Uploading an APK/IPA or deleting one from the fleet requires devices scope.
 // App listings stay readable to any authenticated key.
 router.use((0, scopeGuard_1.mutationScopeGuard)(['devices']));
+// Uploaded apps follow the device team rule on the app's team (canSeeApp):
+// admins see every app, members shared apps and their teams'. An app the
+// caller can't see answers every route exactly as an unknown id.
+const UNKNOWN_APP = { error: 'App not found' };
 router.get('/', (req, res) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
     try {
-        const apps = yield app_service_1.APP_SERVICE.getApps();
+        const apps = yield app_service_1.APP_SERVICE.getApps((_a = req.auth) === null || _a === void 0 ? void 0 : _a.teamIds);
         res.json(apps);
     }
     catch (err) {
@@ -57,15 +64,29 @@ router.get('/', (req, res) => __awaiter(void 0, void 0, void 0, function* () {
  * is not joined onto a path.
  */
 exports.DOWNLOAD_OPTIONS = { dotfiles: 'allow' };
+/**
+ * Whether this request may see the app. A download ticket (authMiddleware's
+ * app-ticket path) was team-checked when it was minted and is bound to one
+ * app, so it sees that app and nothing else; everyone else by the team rule.
+ */
+function canRequestSeeApp(req, app) {
+    var _a, _b;
+    if (!app)
+        return false;
+    if (((_a = req.auth) === null || _a === void 0 ? void 0 : _a.kind) === 'app-ticket')
+        return req.auth.appId === app.id;
+    return (0, appVisibility_1.canSeeApp)(app, (_b = req.auth) === null || _b === void 0 ? void 0 : _b.teamIds);
+}
 function downloadApp(req, res) {
     return __awaiter(this, void 0, void 0, function* () {
         try {
             const app = yield app_service_1.APP_SERVICE.getAppById(req.params.id);
-            if (app && (yield fs_extra_1.default.exists(app.filepath))) {
+            // The ticket path sends with DOWNLOAD_OPTIONS too: it is this same call.
+            if (app && canRequestSeeApp(req, app) && (yield fs_extra_1.default.exists(app.filepath))) {
                 res.download(app.filepath, app.filename, exports.DOWNLOAD_OPTIONS);
             }
             else {
-                res.status(404).json({ error: 'App not found' });
+                res.status(404).json(UNKNOWN_APP);
             }
         }
         catch (err) {
@@ -75,7 +96,26 @@ function downloadApp(req, res) {
     });
 }
 router.get('/:id/download', downloadApp);
+/**
+ * The team an upload or a move names: a string id, or null for the shared
+ * pool. Undefined, null and '' all mean shared; anything else that is not a
+ * string is refused.
+ */
+function parseTeamId(value) {
+    if (value === undefined || value === null || value === '')
+        return { ok: true, teamId: null };
+    if (typeof value === 'string')
+        return { ok: true, teamId: value };
+    return { ok: false };
+}
+function teamExists(teamId) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const team = yield prisma_1.prisma.team.findUnique({ where: { id: teamId }, select: { id: true } });
+        return !!team;
+    });
+}
 router.post('/upload', (0, roleGuard_1.roleGuard)('ADMIN'), (req, res) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
     if (!req.files || Object.keys(req.files).length === 0) {
         return res.status(400).json({ error: 'No files were uploaded.' });
     }
@@ -83,9 +123,18 @@ router.post('/upload', (0, roleGuard_1.roleGuard)('ADMIN'), (req, res) => __awai
     if (!appFile) {
         return res.status(400).json({ error: 'Field "app" is required.' });
     }
+    // Optional multipart field. Checked before anything is written, so a bad
+    // team stores nothing.
+    const team = parseTeamId((_a = req.body) === null || _a === void 0 ? void 0 : _a.teamId);
+    if (!team.ok)
+        return res.status(400).json({ error: 'teamId must be a string' });
     try {
-        const app = yield app_service_1.APP_SERVICE.uploadApp(appFile);
-        logger_1.default.audit('APP_UPLOAD', req.ip, { appId: app.id, name: app.name });
+        if (team.teamId && !(yield teamExists(team.teamId))) {
+            return res.status(400).json({ error: 'team not found' });
+        }
+        // An upload of bytes already stored returns that app, in its own team.
+        const app = yield app_service_1.APP_SERVICE.uploadApp(appFile, team.teamId);
+        logger_1.default.audit('APP_UPLOAD', req.ip, { appId: app.id, name: app.name, teamId: app.teamId });
         res.json(app);
     }
     catch (err) {
@@ -93,8 +142,37 @@ router.post('/upload', (0, roleGuard_1.roleGuard)('ADMIN'), (req, res) => __awai
         res.status(500).json({ error: err.message });
     }
 }));
+/**
+ * Moves an app to a team, or back to the shared pool with `{ teamId: null }`.
+ * Shaped like PUT /grid/device/:udid/team: admin role and scope, 404 for an
+ * unknown team or app, `{ ok, updated }`.
+ */
+router.put('/:id/team', (0, roleGuard_1.roleGuard)('ADMIN'), (0, scopeGuard_1.scopeGuard)(['admin']), (req, res) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const team = parseTeamId((_a = req.body) === null || _a === void 0 ? void 0 : _a.teamId);
+    if (!team.ok)
+        return res.status(400).json({ error: 'teamId must be a string or null' });
+    try {
+        if (team.teamId && !(yield teamExists(team.teamId))) {
+            return res.status(404).json({ error: 'team not found' });
+        }
+        const updated = yield app_service_1.APP_SERVICE.setAppTeam(req.params.id, team.teamId);
+        if (updated === 0)
+            return res.status(404).json(UNKNOWN_APP);
+        logger_1.default.audit('APP_TEAM', req.ip, { appId: req.params.id, teamId: team.teamId });
+        res.json({ ok: true, updated });
+    }
+    catch (err) {
+        logger_1.default.error(`Failed to move app ${req.params.id}: ${err.message}`);
+        res.status(500).json({ error: err.message });
+    }
+}));
 router.delete('/:id', (0, roleGuard_1.roleGuard)('ADMIN'), (req, res) => __awaiter(void 0, void 0, void 0, function* () {
     try {
+        // Unknown and hidden alike: 404 with the unknown body, nothing deleted.
+        const app = yield app_service_1.APP_SERVICE.getAppById(req.params.id);
+        if (!canRequestSeeApp(req, app))
+            return res.status(404).json(UNKNOWN_APP);
         yield app_service_1.APP_SERVICE.deleteApp(req.params.id);
         logger_1.default.audit('APP_DELETE', req.ip, { appId: req.params.id });
         res.sendStatus(204);

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

@@ -64,7 +64,7 @@ function issueToken(auth, body) {
                 roles: grant.roles,
             }, { audience, ttlSeconds: expiresIn });
             // Session-token capability (spec §3 item 6 / R9): a sibling credential the
-            // client injects as `xenon:options.sessionToken` so the Appium createSession
+            // client injects as `xe:options.sessionToken` so the Appium createSession
             // interceptor can refuse tokenless direct-connect sessions when the gate is on.
             const sessionToken = yield svc.sign({ sub: auth.userId, teamId: (_c = auth.teamId) !== null && _c !== void 0 ? _c : null }, { audience: 'xenon-session', ttlSeconds: expiresIn });
             return { token, expiresIn, audience, scopes: grant.granular, sessionToken };

package/lib/src/app/routers/bug-report.js

@@ -21,6 +21,8 @@ const roleGuard_1 = require("../../middleware/roleGuard");
 const logger_1 = __importDefault(require("../../logger"));
 const SocketServer_1 = require("../../services/SocketServer");
 const SocketEvents_1 = require("../../enums/SocketEvents");
+const prisma_1 = require("../../prisma");
+const sessionVisibility_1 = require("../../services/device-access/sessionVisibility");
 const router = (0, express_1.Router)();
 router.use((0, roleGuard_1.roleGuard)('MEMBER'));
 function parseMode(raw) {
@@ -54,6 +56,16 @@ router.post('/sessions/:sessionId/bug-report', (req, res) => __awaiter(void 0, v
         }
         windowSec = parsed;
     }
+    // Another team's session gets the service's own unknown-session answer,
+    // and nothing is assembled for it.
+    const session = yield prisma_1.prisma.session.findUnique({
+        where: { id: sessionId },
+        select: { device_udid: true, user_id: true },
+    });
+    const auth = req.auth;
+    if (session && !(yield (0, sessionVisibility_1.canSeeSession)(session, auth))) {
+        return res.status(404).json({ error: `Session ${sessionId} not found` });
+    }
     const svc = typedi_1.Container.get(BugReportService_1.BugReportService);
     let bundle;
     try {

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

@@ -4,6 +4,7 @@ exports.buildCapabilities = buildCapabilities;
 exports.capabilitiesRouter = capabilitiesRouter;
 const express_1 = require("express");
 const sessionTokenGate_1 = require("../../services/sessionTokenGate");
+const commandAuth_1 = require("../../middleware/commandAuth");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const pkg = require('../../../package.json');
 function buildCapabilities() {
@@ -18,6 +19,9 @@ function buildCapabilities() {
             projects: true, // Task 8
             mcpScopedTokens: true, // Tasks 1-3: granular-claim minting available
             sessionTokenGate: (0, sessionTokenGate_1.sessionTokenGateEnabled)(), // Task 4: live XENON_REQUIRE_SESSION_TOKEN value
+            // Live XENON_REQUIRE_COMMAND_AUTH value: when true, every WebDriver
+            // session command must carry the x-xenon-* pair or a Bearer token.
+            commandAuth: (0, commandAuth_1.commandAuthEnabled)(),
         },
     };
 }

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

@@ -66,6 +66,7 @@ const fs_extra_1 = __importDefault(require("fs-extra"));
 const OmniVisionService_1 = require("../../services/omni-vision/OmniVisionService");
 const InspectorService_1 = require("../../services/InspectorService");
 const StreamTicketService_1 = require("../../services/token/StreamTicketService");
+const appVisibility_1 = require("../../services/device-access/appVisibility");
 const PluginContext_1 = require("../../PluginContext");
 const streamType_1 = require("./streamType");
 const iosStreamPort_1 = require("./iosStreamPort");
@@ -496,6 +497,7 @@ router.post('/:udid/install', (req, res) => __awaiter(void 0, void 0, void 0, fu
     res.status(400).send('Manager not found or installApp not supported');
 }));
 router.post('/:udid/install-repository-app', (req, res) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
     const { udid } = req.params;
     const { appId } = req.body;
     const device = yield getDeviceInfo(udid);
@@ -504,8 +506,11 @@ router.post('/:udid/install-repository-app', (req, res) => __awaiter(void 0, voi
     try {
         const { APP_SERVICE } = yield Promise.resolve().then(() => __importStar(require('../../dashboard/services/app-service')));
         const app = yield APP_SERVICE.getAppById(appId);
-        if (!app)
+        // Installing hands over the binary as a download does: another team's
+        // app answers as an unknown one.
+        if (!(0, appVisibility_1.canSeeApp)(app, (_a = req.auth) === null || _a === void 0 ? void 0 : _a.teamIds)) {
             return res.status(404).send('App not found in repository');
+        }
         const manager = yield getDeviceManagerForPlatform(device.platform);
         if (manager && manager.installApp) {
             // If it's a local file, pass the path.