@midscene/android-playground 1.7.6 → 1.7.7-beta-20260428092036.0

package/dist/es/bin.mjs

@@ -25,6 +25,18 @@ async function getAdbTargets() {
             isDefault: 0 === index
         }));
 }
+async function getAdbTargetsSafe() {
+    try {
+        return {
+            targets: await getAdbTargets()
+        };
+    } catch (error) {
+        return {
+            targets: [],
+            error: error instanceof Error ? error.message : String(error)
+        };
+    }
+}
 const androidPlaygroundPlatform = definePlaygroundPlatform({
     id: 'android',
     title: 'Midscene Android Playground',
@@ -40,12 +52,17 @@ const androidPlaygroundPlatform = definePlaygroundPlatform({
         if (scrcpyPort !== SCRCPY_SERVER_PORT) console.log(`⚠️  Port ${SCRCPY_SERVER_PORT} is busy, using port ${scrcpyPort} instead`);
         const sessionManager = {
             async getSetupSchema () {
-                const targets = await getAdbTargets();
+                const { targets, error } = await getAdbTargetsSafe();
                 return {
                     title: 'Welcome to\nMidscene.js Playground!',
                     description: 'Select an available ADB device to create the current Android Agent',
                     primaryActionLabel: 'Create Agent',
                     autoSubmitWhenReady: 1 === targets.length,
+                    notice: error ? {
+                        type: 'warning',
+                        message: 'Android device discovery failed',
+                        description: error
+                    } : void 0,
                     fields: [
                         {
                             key: 'deviceId',
@@ -64,7 +81,7 @@ const androidPlaygroundPlatform = definePlaygroundPlatform({
                     targets
                 };
             },
-            listTargets: getAdbTargets,
+            listTargets: async ()=>(await getAdbTargetsSafe()).targets,
             async createSession (input) {
                 const targets = await getAdbTargets();
                 const deviceId = 'string' == typeof input?.deviceId && input.deviceId ? input.deviceId : targets.find((target)=>target.isDefault)?.id;
@@ -240,6 +257,7 @@ class ScrcpyServer {
         });
     }
     async getDevicesList() {
+        if (this.deviceListSource) return this.deviceListSource.getDevices();
         try {
             debugPage('start to get devices list');
             const client = await this.getAdbClient();
@@ -271,6 +289,24 @@ class ScrcpyServer {
             return [];
         }
     }
+    broadcastDevicesList(devices) {
+        const currentDevicesJson = JSON.stringify(devices);
+        if (this.lastDeviceList === currentDevicesJson) return;
+        debugPage('devices list changed, push to all connected clients');
+        this.lastDeviceList = currentDevicesJson;
+        if (this.currentDeviceId && !devices.some((device)=>device.id === this.currentDeviceId)) this.currentDeviceId = null;
+        if (!this.currentDeviceId && devices.length > 0) {
+            const onlineDevices = devices.filter((device)=>'device' === device.status.toLowerCase());
+            if (onlineDevices.length > 0) {
+                this.currentDeviceId = onlineDevices[0].id;
+                debugPage('auto select the first online device:', this.currentDeviceId);
+            }
+        }
+        this.io.emit('devices-list', {
+            devices,
+            currentDeviceId: this.currentDeviceId
+        });
+    }
     async getAdbClient() {
         const { AdbServerClient } = await import("@yume-chan/adb");
         const { AdbServerNodeTcpConnector } = await import("@yume-chan/adb-server-node-tcp");
@@ -526,25 +562,21 @@ class ScrcpyServer {
         });
     }
     startDeviceMonitoring() {
+        if (this.deviceListSource) {
+            this.deviceListSourceUnsubscribe = this.deviceListSource.subscribe((devices)=>{
+                this.broadcastDevicesList(devices);
+            });
+            this.getDevicesList().then((devices)=>{
+                this.broadcastDevicesList(devices);
+            }).catch((error)=>{
+                console.error('device monitoring error:', error);
+            });
+            return;
+        }
         this.devicePollInterval = setInterval(async ()=>{
             try {
                 const devices = await this.getDevicesList();
-                const currentDevicesJson = JSON.stringify(devices);
-                if (this.lastDeviceList !== currentDevicesJson) {
-                    debugPage('devices list changed, push to all connected clients');
-                    this.lastDeviceList = currentDevicesJson;
-                    if (!this.currentDeviceId && devices.length > 0) {
-                        const onlineDevices = devices.filter((device)=>'device' === device.status.toLowerCase());
-                        if (onlineDevices.length > 0) {
-                            this.currentDeviceId = onlineDevices[0].id;
-                            debugPage('auto select the first online device:', this.currentDeviceId);
-                        }
-                    }
-                    this.io.emit('devices-list', {
-                        devices,
-                        currentDeviceId: this.currentDeviceId
-                    });
-                }
+                this.broadcastDevicesList(devices);
             } catch (error) {
                 console.error('device monitoring error:', error);
             }
@@ -555,9 +587,13 @@ class ScrcpyServer {
             clearInterval(this.devicePollInterval);
             this.devicePollInterval = null;
         }
-        if (this.httpServer) return this.httpServer.close();
+        if (this.deviceListSourceUnsubscribe) {
+            this.deviceListSourceUnsubscribe();
+            this.deviceListSourceUnsubscribe = void 0;
+        }
+        if (this.httpServer?.listening) return this.httpServer.close();
     }
-    constructor(){
+    constructor(options = {}){
         scrcpy_server_define_property(this, "app", void 0);
         scrcpy_server_define_property(this, "httpServer", void 0);
         scrcpy_server_define_property(this, "io", void 0);
@@ -566,7 +602,10 @@ class ScrcpyServer {
         scrcpy_server_define_property(this, "adbClient", null);
         scrcpy_server_define_property(this, "currentDeviceId", null);
         scrcpy_server_define_property(this, "devicePollInterval", null);
+        scrcpy_server_define_property(this, "deviceListSource", void 0);
+        scrcpy_server_define_property(this, "deviceListSourceUnsubscribe", void 0);
         scrcpy_server_define_property(this, "lastDeviceList", '');
+        this.deviceListSource = options.deviceListSource;
         this.app = express();
         this.httpServer = createServer(this.app);
         this.io = new Server(this.httpServer, {

package/dist/es/index.mjs

@@ -25,6 +25,18 @@ async function getAdbTargets() {
             isDefault: 0 === index
         }));
 }
+async function getAdbTargetsSafe() {
+    try {
+        return {
+            targets: await getAdbTargets()
+        };
+    } catch (error) {
+        return {
+            targets: [],
+            error: error instanceof Error ? error.message : String(error)
+        };
+    }
+}
 const androidPlaygroundPlatform = definePlaygroundPlatform({
     id: 'android',
     title: 'Midscene Android Playground',
@@ -40,12 +52,17 @@ const androidPlaygroundPlatform = definePlaygroundPlatform({
         if (scrcpyPort !== SCRCPY_SERVER_PORT) console.log(`⚠️  Port ${SCRCPY_SERVER_PORT} is busy, using port ${scrcpyPort} instead`);
         const sessionManager = {
             async getSetupSchema () {
-                const targets = await getAdbTargets();
+                const { targets, error } = await getAdbTargetsSafe();
                 return {
                     title: 'Welcome to\nMidscene.js Playground!',
                     description: 'Select an available ADB device to create the current Android Agent',
                     primaryActionLabel: 'Create Agent',
                     autoSubmitWhenReady: 1 === targets.length,
+                    notice: error ? {
+                        type: 'warning',
+                        message: 'Android device discovery failed',
+                        description: error
+                    } : void 0,
                     fields: [
                         {
                             key: 'deviceId',
@@ -64,7 +81,7 @@ const androidPlaygroundPlatform = definePlaygroundPlatform({
                     targets
                 };
             },
-            listTargets: getAdbTargets,
+            listTargets: async ()=>(await getAdbTargetsSafe()).targets,
             async createSession (input) {
                 const targets = await getAdbTargets();
                 const deviceId = 'string' == typeof input?.deviceId && input.deviceId ? input.deviceId : targets.find((target)=>target.isDefault)?.id;
@@ -240,6 +257,7 @@ class ScrcpyServer {
         });
     }
     async getDevicesList() {
+        if (this.deviceListSource) return this.deviceListSource.getDevices();
         try {
             debugPage('start to get devices list');
             const client = await this.getAdbClient();
@@ -271,6 +289,24 @@ class ScrcpyServer {
             return [];
         }
     }
+    broadcastDevicesList(devices) {
+        const currentDevicesJson = JSON.stringify(devices);
+        if (this.lastDeviceList === currentDevicesJson) return;
+        debugPage('devices list changed, push to all connected clients');
+        this.lastDeviceList = currentDevicesJson;
+        if (this.currentDeviceId && !devices.some((device)=>device.id === this.currentDeviceId)) this.currentDeviceId = null;
+        if (!this.currentDeviceId && devices.length > 0) {
+            const onlineDevices = devices.filter((device)=>'device' === device.status.toLowerCase());
+            if (onlineDevices.length > 0) {
+                this.currentDeviceId = onlineDevices[0].id;
+                debugPage('auto select the first online device:', this.currentDeviceId);
+            }
+        }
+        this.io.emit('devices-list', {
+            devices,
+            currentDeviceId: this.currentDeviceId
+        });
+    }
     async getAdbClient() {
         const { AdbServerClient } = await import("@yume-chan/adb");
         const { AdbServerNodeTcpConnector } = await import("@yume-chan/adb-server-node-tcp");
@@ -526,25 +562,21 @@ class ScrcpyServer {
         });
     }
     startDeviceMonitoring() {
+        if (this.deviceListSource) {
+            this.deviceListSourceUnsubscribe = this.deviceListSource.subscribe((devices)=>{
+                this.broadcastDevicesList(devices);
+            });
+            this.getDevicesList().then((devices)=>{
+                this.broadcastDevicesList(devices);
+            }).catch((error)=>{
+                console.error('device monitoring error:', error);
+            });
+            return;
+        }
         this.devicePollInterval = setInterval(async ()=>{
             try {
                 const devices = await this.getDevicesList();
-                const currentDevicesJson = JSON.stringify(devices);
-                if (this.lastDeviceList !== currentDevicesJson) {
-                    debugPage('devices list changed, push to all connected clients');
-                    this.lastDeviceList = currentDevicesJson;
-                    if (!this.currentDeviceId && devices.length > 0) {
-                        const onlineDevices = devices.filter((device)=>'device' === device.status.toLowerCase());
-                        if (onlineDevices.length > 0) {
-                            this.currentDeviceId = onlineDevices[0].id;
-                            debugPage('auto select the first online device:', this.currentDeviceId);
-                        }
-                    }
-                    this.io.emit('devices-list', {
-                        devices,
-                        currentDeviceId: this.currentDeviceId
-                    });
-                }
+                this.broadcastDevicesList(devices);
             } catch (error) {
                 console.error('device monitoring error:', error);
             }
@@ -555,9 +587,13 @@ class ScrcpyServer {
             clearInterval(this.devicePollInterval);
             this.devicePollInterval = null;
         }
-        if (this.httpServer) return this.httpServer.close();
+        if (this.deviceListSourceUnsubscribe) {
+            this.deviceListSourceUnsubscribe();
+            this.deviceListSourceUnsubscribe = void 0;
+        }
+        if (this.httpServer?.listening) return this.httpServer.close();
     }
-    constructor(){
+    constructor(options = {}){
         scrcpy_server_define_property(this, "app", void 0);
         scrcpy_server_define_property(this, "httpServer", void 0);
         scrcpy_server_define_property(this, "io", void 0);
@@ -566,7 +602,10 @@ class ScrcpyServer {
         scrcpy_server_define_property(this, "adbClient", null);
         scrcpy_server_define_property(this, "currentDeviceId", null);
         scrcpy_server_define_property(this, "devicePollInterval", null);
+        scrcpy_server_define_property(this, "deviceListSource", void 0);
+        scrcpy_server_define_property(this, "deviceListSourceUnsubscribe", void 0);
         scrcpy_server_define_property(this, "lastDeviceList", '');
+        this.deviceListSource = options.deviceListSource;
         this.app = express();
         this.httpServer = createServer(this.app);
         this.io = new Server(this.httpServer, {

package/dist/lib/bin.js

@@ -40,6 +40,18 @@ async function getAdbTargets() {
             isDefault: 0 === index
         }));
 }
+async function getAdbTargetsSafe() {
+    try {
+        return {
+            targets: await getAdbTargets()
+        };
+    } catch (error) {
+        return {
+            targets: [],
+            error: error instanceof Error ? error.message : String(error)
+        };
+    }
+}
 const androidPlaygroundPlatform = (0, playground_namespaceObject.definePlaygroundPlatform)({
     id: 'android',
     title: 'Midscene Android Playground',
@@ -55,12 +67,17 @@ const androidPlaygroundPlatform = (0, playground_namespaceObject.definePlaygroun
         if (scrcpyPort !== constants_namespaceObject.SCRCPY_SERVER_PORT) console.log(`⚠️  Port ${constants_namespaceObject.SCRCPY_SERVER_PORT} is busy, using port ${scrcpyPort} instead`);
         const sessionManager = {
             async getSetupSchema () {
-                const targets = await getAdbTargets();
+                const { targets, error } = await getAdbTargetsSafe();
                 return {
                     title: 'Welcome to\nMidscene.js Playground!',
                     description: 'Select an available ADB device to create the current Android Agent',
                     primaryActionLabel: 'Create Agent',
                     autoSubmitWhenReady: 1 === targets.length,
+                    notice: error ? {
+                        type: 'warning',
+                        message: 'Android device discovery failed',
+                        description: error
+                    } : void 0,
                     fields: [
                         {
                             key: 'deviceId',
@@ -79,7 +96,7 @@ const androidPlaygroundPlatform = (0, playground_namespaceObject.definePlaygroun
                     targets
                 };
             },
-            listTargets: getAdbTargets,
+            listTargets: async ()=>(await getAdbTargetsSafe()).targets,
             async createSession (input) {
                 const targets = await getAdbTargets();
                 const deviceId = 'string' == typeof input?.deviceId && input.deviceId ? input.deviceId : targets.find((target)=>target.isDefault)?.id;
@@ -266,6 +283,7 @@ class ScrcpyServer {
         });
     }
     async getDevicesList() {
+        if (this.deviceListSource) return this.deviceListSource.getDevices();
         try {
             debugPage('start to get devices list');
             const client = await this.getAdbClient();
@@ -297,6 +315,24 @@ class ScrcpyServer {
             return [];
         }
     }
+    broadcastDevicesList(devices) {
+        const currentDevicesJson = JSON.stringify(devices);
+        if (this.lastDeviceList === currentDevicesJson) return;
+        debugPage('devices list changed, push to all connected clients');
+        this.lastDeviceList = currentDevicesJson;
+        if (this.currentDeviceId && !devices.some((device)=>device.id === this.currentDeviceId)) this.currentDeviceId = null;
+        if (!this.currentDeviceId && devices.length > 0) {
+            const onlineDevices = devices.filter((device)=>'device' === device.status.toLowerCase());
+            if (onlineDevices.length > 0) {
+                this.currentDeviceId = onlineDevices[0].id;
+                debugPage('auto select the first online device:', this.currentDeviceId);
+            }
+        }
+        this.io.emit('devices-list', {
+            devices,
+            currentDeviceId: this.currentDeviceId
+        });
+    }
     async getAdbClient() {
         const { AdbServerClient } = await import("@yume-chan/adb");
         const { AdbServerNodeTcpConnector } = await import("@yume-chan/adb-server-node-tcp");
@@ -552,25 +588,21 @@ class ScrcpyServer {
         });
     }
     startDeviceMonitoring() {
+        if (this.deviceListSource) {
+            this.deviceListSourceUnsubscribe = this.deviceListSource.subscribe((devices)=>{
+                this.broadcastDevicesList(devices);
+            });
+            this.getDevicesList().then((devices)=>{
+                this.broadcastDevicesList(devices);
+            }).catch((error)=>{
+                console.error('device monitoring error:', error);
+            });
+            return;
+        }
         this.devicePollInterval = setInterval(async ()=>{
             try {
                 const devices = await this.getDevicesList();
-                const currentDevicesJson = JSON.stringify(devices);
-                if (this.lastDeviceList !== currentDevicesJson) {
-                    debugPage('devices list changed, push to all connected clients');
-                    this.lastDeviceList = currentDevicesJson;
-                    if (!this.currentDeviceId && devices.length > 0) {
-                        const onlineDevices = devices.filter((device)=>'device' === device.status.toLowerCase());
-                        if (onlineDevices.length > 0) {
-                            this.currentDeviceId = onlineDevices[0].id;
-                            debugPage('auto select the first online device:', this.currentDeviceId);
-                        }
-                    }
-                    this.io.emit('devices-list', {
-                        devices,
-                        currentDeviceId: this.currentDeviceId
-                    });
-                }
+                this.broadcastDevicesList(devices);
             } catch (error) {
                 console.error('device monitoring error:', error);
             }
@@ -581,9 +613,13 @@ class ScrcpyServer {
             clearInterval(this.devicePollInterval);
             this.devicePollInterval = null;
         }
-        if (this.httpServer) return this.httpServer.close();
+        if (this.deviceListSourceUnsubscribe) {
+            this.deviceListSourceUnsubscribe();
+            this.deviceListSourceUnsubscribe = void 0;
+        }
+        if (this.httpServer?.listening) return this.httpServer.close();
     }
-    constructor(){
+    constructor(options = {}){
         scrcpy_server_define_property(this, "app", void 0);
         scrcpy_server_define_property(this, "httpServer", void 0);
         scrcpy_server_define_property(this, "io", void 0);
@@ -592,7 +628,10 @@ class ScrcpyServer {
         scrcpy_server_define_property(this, "adbClient", null);
         scrcpy_server_define_property(this, "currentDeviceId", null);
         scrcpy_server_define_property(this, "devicePollInterval", null);
+        scrcpy_server_define_property(this, "deviceListSource", void 0);
+        scrcpy_server_define_property(this, "deviceListSourceUnsubscribe", void 0);
         scrcpy_server_define_property(this, "lastDeviceList", '');
+        this.deviceListSource = options.deviceListSource;
         this.app = external_express_default()();
         this.httpServer = (0, external_node_http_namespaceObject.createServer)(this.app);
         this.io = new external_socket_io_namespaceObject.Server(this.httpServer, {

package/dist/lib/index.js

@@ -55,6 +55,18 @@ async function getAdbTargets() {
             isDefault: 0 === index
         }));
 }
+async function getAdbTargetsSafe() {
+    try {
+        return {
+            targets: await getAdbTargets()
+        };
+    } catch (error) {
+        return {
+            targets: [],
+            error: error instanceof Error ? error.message : String(error)
+        };
+    }
+}
 const androidPlaygroundPlatform = (0, playground_namespaceObject.definePlaygroundPlatform)({
     id: 'android',
     title: 'Midscene Android Playground',
@@ -70,12 +82,17 @@ const androidPlaygroundPlatform = (0, playground_namespaceObject.definePlaygroun
         if (scrcpyPort !== constants_namespaceObject.SCRCPY_SERVER_PORT) console.log(`⚠️  Port ${constants_namespaceObject.SCRCPY_SERVER_PORT} is busy, using port ${scrcpyPort} instead`);
         const sessionManager = {
             async getSetupSchema () {
-                const targets = await getAdbTargets();
+                const { targets, error } = await getAdbTargetsSafe();
                 return {
                     title: 'Welcome to\nMidscene.js Playground!',
                     description: 'Select an available ADB device to create the current Android Agent',
                     primaryActionLabel: 'Create Agent',
                     autoSubmitWhenReady: 1 === targets.length,
+                    notice: error ? {
+                        type: 'warning',
+                        message: 'Android device discovery failed',
+                        description: error
+                    } : void 0,
                     fields: [
                         {
                             key: 'deviceId',
@@ -94,7 +111,7 @@ const androidPlaygroundPlatform = (0, playground_namespaceObject.definePlaygroun
                     targets
                 };
             },
-            listTargets: getAdbTargets,
+            listTargets: async ()=>(await getAdbTargetsSafe()).targets,
             async createSession (input) {
                 const targets = await getAdbTargets();
                 const deviceId = 'string' == typeof input?.deviceId && input.deviceId ? input.deviceId : targets.find((target)=>target.isDefault)?.id;
@@ -281,6 +298,7 @@ class ScrcpyServer {
         });
     }
     async getDevicesList() {
+        if (this.deviceListSource) return this.deviceListSource.getDevices();
         try {
             debugPage('start to get devices list');
             const client = await this.getAdbClient();
@@ -312,6 +330,24 @@ class ScrcpyServer {
             return [];
         }
     }
+    broadcastDevicesList(devices) {
+        const currentDevicesJson = JSON.stringify(devices);
+        if (this.lastDeviceList === currentDevicesJson) return;
+        debugPage('devices list changed, push to all connected clients');
+        this.lastDeviceList = currentDevicesJson;
+        if (this.currentDeviceId && !devices.some((device)=>device.id === this.currentDeviceId)) this.currentDeviceId = null;
+        if (!this.currentDeviceId && devices.length > 0) {
+            const onlineDevices = devices.filter((device)=>'device' === device.status.toLowerCase());
+            if (onlineDevices.length > 0) {
+                this.currentDeviceId = onlineDevices[0].id;
+                debugPage('auto select the first online device:', this.currentDeviceId);
+            }
+        }
+        this.io.emit('devices-list', {
+            devices,
+            currentDeviceId: this.currentDeviceId
+        });
+    }
     async getAdbClient() {
         const { AdbServerClient } = await import("@yume-chan/adb");
         const { AdbServerNodeTcpConnector } = await import("@yume-chan/adb-server-node-tcp");
@@ -567,25 +603,21 @@ class ScrcpyServer {
         });
     }
     startDeviceMonitoring() {
+        if (this.deviceListSource) {
+            this.deviceListSourceUnsubscribe = this.deviceListSource.subscribe((devices)=>{
+                this.broadcastDevicesList(devices);
+            });
+            this.getDevicesList().then((devices)=>{
+                this.broadcastDevicesList(devices);
+            }).catch((error)=>{
+                console.error('device monitoring error:', error);
+            });
+            return;
+        }
         this.devicePollInterval = setInterval(async ()=>{
             try {
                 const devices = await this.getDevicesList();
-                const currentDevicesJson = JSON.stringify(devices);
-                if (this.lastDeviceList !== currentDevicesJson) {
-                    debugPage('devices list changed, push to all connected clients');
-                    this.lastDeviceList = currentDevicesJson;
-                    if (!this.currentDeviceId && devices.length > 0) {
-                        const onlineDevices = devices.filter((device)=>'device' === device.status.toLowerCase());
-                        if (onlineDevices.length > 0) {
-                            this.currentDeviceId = onlineDevices[0].id;
-                            debugPage('auto select the first online device:', this.currentDeviceId);
-                        }
-                    }
-                    this.io.emit('devices-list', {
-                        devices,
-                        currentDeviceId: this.currentDeviceId
-                    });
-                }
+                this.broadcastDevicesList(devices);
             } catch (error) {
                 console.error('device monitoring error:', error);
             }
@@ -596,9 +628,13 @@ class ScrcpyServer {
             clearInterval(this.devicePollInterval);
             this.devicePollInterval = null;
         }
-        if (this.httpServer) return this.httpServer.close();
+        if (this.deviceListSourceUnsubscribe) {
+            this.deviceListSourceUnsubscribe();
+            this.deviceListSourceUnsubscribe = void 0;
+        }
+        if (this.httpServer?.listening) return this.httpServer.close();
     }
-    constructor(){
+    constructor(options = {}){
         scrcpy_server_define_property(this, "app", void 0);
         scrcpy_server_define_property(this, "httpServer", void 0);
         scrcpy_server_define_property(this, "io", void 0);
@@ -607,7 +643,10 @@ class ScrcpyServer {
         scrcpy_server_define_property(this, "adbClient", null);
         scrcpy_server_define_property(this, "currentDeviceId", null);
         scrcpy_server_define_property(this, "devicePollInterval", null);
+        scrcpy_server_define_property(this, "deviceListSource", void 0);
+        scrcpy_server_define_property(this, "deviceListSourceUnsubscribe", void 0);
         scrcpy_server_define_property(this, "lastDeviceList", '');
+        this.deviceListSource = options.deviceListSource;
         this.app = external_express_default()();
         this.httpServer = (0, external_node_http_namespaceObject.createServer)(this.app);
         this.io = new external_socket_io_namespaceObject.Server(this.httpServer, {

package/dist/types/scrcpy-server.d.ts

@@ -7,6 +7,18 @@ export interface ScrcpyConnectDeviceRequest {
     deviceId?: string;
     maxSize?: number;
 }
+export interface ScrcpyListedDevice {
+    id: string;
+    name: string;
+    status: string;
+}
+export interface ScrcpyDeviceListSource {
+    getDevices(): Promise<ScrcpyListedDevice[]>;
+    subscribe(listener: (devices: ScrcpyListedDevice[]) => void): () => void;
+}
+export interface ScrcpyServerOptions {
+    deviceListSource?: ScrcpyDeviceListSource;
+}
 export declare function resolveRequestedDeviceId(options: ScrcpyConnectDeviceRequest | undefined, currentDeviceId: string | null): string | undefined;
 export default class ScrcpyServer {
     app: express.Application;
@@ -17,10 +29,13 @@ export default class ScrcpyServer {
     adbClient: AdbServerClient | null;
     currentDeviceId: string | null;
     devicePollInterval: NodeJS.Timeout | null;
+    private deviceListSource?;
+    private deviceListSourceUnsubscribe?;
     lastDeviceList: string;
-    constructor();
+    constructor(options?: ScrcpyServerOptions);
     private setupApiRoutes;
     private getDevicesList;
+    private broadcastDevicesList;
     private getAdbClient;
     private getAdb;
     private startScrcpy;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/android-playground",
-  "version": "1.7.6",
+  "version": "1.7.7-beta-20260428092036.0",
   "description": "Android playground for Midscene",
   "main": "./dist/lib/index.js",
   "types": "./dist/types/index.d.ts",
@@ -34,10 +34,10 @@
     "express": "^4.21.2",
     "open": "10.1.0",
     "socket.io": "^4.8.1",
-    "@midscene/android": "1.7.6",
-    "@midscene/core": "1.7.6",
-    "@midscene/playground": "1.7.6",
-    "@midscene/shared": "1.7.6"
+    "@midscene/android": "1.7.7-beta-20260428092036.0",
+    "@midscene/core": "1.7.7-beta-20260428092036.0",
+    "@midscene/playground": "1.7.7-beta-20260428092036.0",
+    "@midscene/shared": "1.7.7-beta-20260428092036.0"
   },
   "devDependencies": {
     "@rslib/core": "^0.18.3",

package/static/index.html

@@ -1 +1 @@
-<!doctype html><html><head><title>Midscene Android Playground</title><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><script defer src="/static/js/lib-react.ed140d90.js"></script><script defer src="/static/js/883.91ca0de7.js"></script><script defer src="/static/js/index.2b64a7a3.js"></script><link href="/static/css/index.dc500f18.css" rel="stylesheet"></head><body><div id="root"></div></body></html>
+<!doctype html><html><head><title>Midscene Android Playground</title><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><script defer src="/static/js/lib-react.ed140d90.js"></script><script defer src="/static/js/883.91ca0de7.js"></script><script defer src="/static/js/index.ca3f2ae9.js"></script><link href="/static/css/index.a02873b3.css" rel="stylesheet"></head><body><div id="root"></div></body></html>