@midscene/harmony 1.7.6 → 1.7.7-beta-20260428102047.0

package/dist/es/bin.mjs

@@ -823,6 +823,8 @@ const createPlatformActions = (device)=>({
             description: 'Terminate (force-stop) a HarmonyOS app by bundle name or mapped app name',
             interfaceAlias: 'terminate',
             paramSchema: terminateParamSchema,
+            delayBeforeRunner: 0,
+            delayAfterRunner: 0,
             call: async (param)=>{
                 if (!param.uri || '' === param.uri.trim()) throw new Error('Terminate requires a non-empty uri parameter');
                 await device.terminate(param.uri);
@@ -831,6 +833,8 @@ const createPlatformActions = (device)=>({
         HarmonyBackButton: defineAction({
             name: 'HarmonyBackButton',
             description: 'Trigger the system "back" operation on HarmonyOS devices',
+            delayBeforeRunner: 0,
+            delayAfterRunner: 0,
             call: async ()=>{
                 await device.back();
             }
@@ -838,6 +842,8 @@ const createPlatformActions = (device)=>({
         HarmonyHomeButton: defineAction({
             name: 'HarmonyHomeButton',
             description: 'Trigger the system "home" operation on HarmonyOS devices',
+            delayBeforeRunner: 0,
+            delayAfterRunner: 0,
             call: async ()=>{
                 await device.home();
             }
@@ -912,26 +918,48 @@ class HarmonyAgent extends Agent {
         this.recentApps = this.createActionWrapper('HarmonyRecentAppsButton');
     }
 }
-async function selectDevice() {
-    console.log('🔍 Scanning for HarmonyOS devices...');
+const HARMONY_NO_DEVICE_MESSAGE = 'No HarmonyOS devices found. Connect a device via USB, ensure HDC is configured, and run `hdc list targets` to verify.';
+function createNoDeviceError() {
+    return new Error(HARMONY_NO_DEVICE_MESSAGE);
+}
+async function getHdcTargets() {
     const devices = await utils_getConnectedDevices();
-    if (0 === devices.length) {
-        console.error('❌ No HarmonyOS devices found!');
-        console.log('📱 Please ensure:');
-        console.log('  • Your device is connected via USB');
-        console.log('  • HDC is properly configured');
-        console.log('  • Run `hdc list targets` to verify');
-        process.exit(1);
+    return devices.map((device, index)=>({
+            id: device.deviceId,
+            label: device.deviceId,
+            isDefault: 0 === index,
+            status: 'device'
+        }));
+}
+async function getHdcTargetsSafe() {
+    try {
+        const targets = await getHdcTargets();
+        return {
+            targets,
+            ...0 === targets.length ? {
+                error: HARMONY_NO_DEVICE_MESSAGE
+            } : {}
+        };
+    } catch (error) {
+        return {
+            targets: [],
+            error: error instanceof Error ? error.message : String(error)
+        };
     }
-    if (1 === devices.length) {
-        console.log(`📱 Found device: ${devices[0].deviceId}`);
-        return devices[0].deviceId;
+}
+async function selectDevice() {
+    console.log('🔍 Scanning for HarmonyOS devices...');
+    const targets = await getHdcTargets();
+    if (0 === targets.length) throw createNoDeviceError();
+    if (1 === targets.length) {
+        console.log(`📱 Found device: ${targets[0].id}`);
+        return targets[0].id;
     }
     return prompts_select({
         message: '📱 Multiple devices found. Please select one:',
-        choices: devices.map((device)=>({
-                name: device.deviceId,
-                value: device.deviceId
+        choices: targets.map((target)=>({
+                name: target.label,
+                value: target.id
             }))
     });
 }
@@ -940,10 +968,114 @@ const harmonyPlaygroundPlatform = definePlaygroundPlatform({
     title: 'Midscene HarmonyOS Playground',
     description: "HarmonyOS playground platform descriptor",
     async prepare (options) {
-        const selectedDeviceId = options?.deviceId || await selectDevice();
         const staticDir = options?.staticDir || node_path.join(__dirname, '../../static');
         const availablePort = await findAvailablePort(PLAYGROUND_SERVER_PORT);
         if (availablePort !== PLAYGROUND_SERVER_PORT) console.log(`⚠️  Port ${PLAYGROUND_SERVER_PORT} is busy, using port ${availablePort} instead`);
+        const createSessionManager = ()=>({
+                async getSetupSchema () {
+                    const explicitDeviceId = options?.deviceId;
+                    const discovery = explicitDeviceId ? {
+                        targets: [
+                            {
+                                id: explicitDeviceId,
+                                label: explicitDeviceId,
+                                isDefault: true,
+                                status: 'device'
+                            }
+                        ]
+                    } : await getHdcTargetsSafe();
+                    const { error, targets } = discovery;
+                    return {
+                        title: 'Welcome to\nMidscene.js Playground!',
+                        description: 'Select an available HDC device to create the current HarmonyOS Agent',
+                        primaryActionLabel: 'Create Agent',
+                        autoSubmitWhenReady: 1 === targets.length,
+                        notice: error ? {
+                            type: 'warning',
+                            message: 'HarmonyOS device discovery failed',
+                            description: error
+                        } : void 0,
+                        fields: [
+                            {
+                                key: 'deviceId',
+                                label: 'HDC device',
+                                type: 'select',
+                                required: true,
+                                options: targets.map((target)=>({
+                                        label: target.label,
+                                        value: target.id,
+                                        description: target.description
+                                    })),
+                                defaultValue: targets.find((target)=>target.isDefault)?.id,
+                                placeholder: 'Select a connected HarmonyOS device'
+                            }
+                        ],
+                        targets
+                    };
+                },
+                async listTargets () {
+                    if (options?.deviceId) return [
+                        {
+                            id: options.deviceId,
+                            label: options.deviceId,
+                            isDefault: true,
+                            status: 'device'
+                        }
+                    ];
+                    return (await getHdcTargetsSafe()).targets;
+                },
+                async createSession (input) {
+                    const targets = options?.deviceId ? [
+                        {
+                            id: options.deviceId,
+                            label: options.deviceId,
+                            isDefault: true,
+                            status: 'device'
+                        }
+                    ] : await getHdcTargets();
+                    const deviceId = options?.deviceId || ('string' == typeof input?.deviceId && input.deviceId ? input.deviceId : targets.find((target)=>target.isDefault)?.id);
+                    if (!deviceId) throw createNoDeviceError();
+                    const connectAgent = async ()=>{
+                        const device = new device_HarmonyDevice(deviceId);
+                        await device.connect();
+                        return new HarmonyAgent(device);
+                    };
+                    const agent = await connectAgent();
+                    return {
+                        agent,
+                        agentFactory: connectAgent,
+                        preview: createScreenshotPreviewDescriptor({
+                            title: 'HarmonyOS device preview'
+                        }),
+                        displayName: deviceId,
+                        metadata: {
+                            deviceId
+                        }
+                    };
+                }
+            });
+        if (options?.deferConnection) return {
+            platformId: 'harmony',
+            title: 'Midscene HarmonyOS Playground',
+            sessionManager: createSessionManager(),
+            launchOptions: {
+                port: availablePort,
+                openBrowser: false,
+                verbose: false,
+                staticPath: staticDir
+            },
+            preview: createScreenshotPreviewDescriptor({
+                title: 'HarmonyOS device preview'
+            }),
+            metadata: {
+                ...options.deviceId ? {
+                    deviceId: options.deviceId
+                } : {},
+                sessionConnected: false,
+                setupState: 'required'
+            }
+        };
+        const selectedDeviceId = options?.deviceId || await selectDevice();
         return {
             platformId: 'harmony',
             title: 'Midscene HarmonyOS Playground',

package/dist/es/cli.mjs

@@ -820,6 +820,8 @@ const createPlatformActions = (device)=>({
             description: 'Terminate (force-stop) a HarmonyOS app by bundle name or mapped app name',
             interfaceAlias: 'terminate',
             paramSchema: terminateParamSchema,
+            delayBeforeRunner: 0,
+            delayAfterRunner: 0,
             call: async (param)=>{
                 if (!param.uri || '' === param.uri.trim()) throw new Error('Terminate requires a non-empty uri parameter');
                 await device.terminate(param.uri);
@@ -828,6 +830,8 @@ const createPlatformActions = (device)=>({
         HarmonyBackButton: defineAction({
             name: 'HarmonyBackButton',
             description: 'Trigger the system "back" operation on HarmonyOS devices',
+            delayBeforeRunner: 0,
+            delayAfterRunner: 0,
             call: async ()=>{
                 await device.back();
             }
@@ -835,6 +839,8 @@ const createPlatformActions = (device)=>({
         HarmonyHomeButton: defineAction({
             name: 'HarmonyHomeButton',
             description: 'Trigger the system "home" operation on HarmonyOS devices',
+            delayBeforeRunner: 0,
+            delayAfterRunner: 0,
             call: async ()=>{
                 await device.home();
             }
@@ -1014,7 +1020,7 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
 const tools = new HarmonyMidsceneTools();
 runToolsCLI(tools, 'midscene-harmony', {
     stripPrefix: 'harmony_',
-    version: "1.7.6",
+    version: "1.7.7-beta-20260428102047.0",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     process.exit(reportCLIError(e));

package/dist/es/index.mjs

@@ -791,6 +791,8 @@ const createPlatformActions = (device)=>({
             description: 'Terminate (force-stop) a HarmonyOS app by bundle name or mapped app name',
             interfaceAlias: 'terminate',
             paramSchema: terminateParamSchema,
+            delayBeforeRunner: 0,
+            delayAfterRunner: 0,
             call: async (param)=>{
                 if (!param.uri || '' === param.uri.trim()) throw new Error('Terminate requires a non-empty uri parameter');
                 await device.terminate(param.uri);
@@ -799,6 +801,8 @@ const createPlatformActions = (device)=>({
         HarmonyBackButton: defineAction({
             name: 'HarmonyBackButton',
             description: 'Trigger the system "back" operation on HarmonyOS devices',
+            delayBeforeRunner: 0,
+            delayAfterRunner: 0,
             call: async ()=>{
                 await device.back();
             }
@@ -806,6 +810,8 @@ const createPlatformActions = (device)=>({
         HarmonyHomeButton: defineAction({
             name: 'HarmonyHomeButton',
             description: 'Trigger the system "home" operation on HarmonyOS devices',
+            delayBeforeRunner: 0,
+            delayAfterRunner: 0,
             call: async ()=>{
                 await device.home();
             }
@@ -1016,26 +1022,48 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
         });
     }
 }
+const HARMONY_NO_DEVICE_MESSAGE = 'No HarmonyOS devices found. Connect a device via USB, ensure HDC is configured, and run `hdc list targets` to verify.';
+function createNoDeviceError() {
+    return new Error(HARMONY_NO_DEVICE_MESSAGE);
+}
+async function getHdcTargets() {
+    const devices = await getConnectedDevices();
+    return devices.map((device, index)=>({
+            id: device.deviceId,
+            label: device.deviceId,
+            isDefault: 0 === index,
+            status: 'device'
+        }));
+}
+async function getHdcTargetsSafe() {
+    try {
+        const targets = await getHdcTargets();
+        return {
+            targets,
+            ...0 === targets.length ? {
+                error: HARMONY_NO_DEVICE_MESSAGE
+            } : {}
+        };
+    } catch (error) {
+        return {
+            targets: [],
+            error: error instanceof Error ? error.message : String(error)
+        };
+    }
+}
 async function selectDevice() {
     console.log('🔍 Scanning for HarmonyOS devices...');
-    const devices = await getConnectedDevices();
-    if (0 === devices.length) {
-        console.error('❌ No HarmonyOS devices found!');
-        console.log('📱 Please ensure:');
-        console.log('  • Your device is connected via USB');
-        console.log('  • HDC is properly configured');
-        console.log('  • Run `hdc list targets` to verify');
-        process.exit(1);
-    }
-    if (1 === devices.length) {
-        console.log(`📱 Found device: ${devices[0].deviceId}`);
-        return devices[0].deviceId;
+    const targets = await getHdcTargets();
+    if (0 === targets.length) throw createNoDeviceError();
+    if (1 === targets.length) {
+        console.log(`📱 Found device: ${targets[0].id}`);
+        return targets[0].id;
     }
     return prompts_select({
         message: '📱 Multiple devices found. Please select one:',
-        choices: devices.map((device)=>({
-                name: device.deviceId,
-                value: device.deviceId
+        choices: targets.map((target)=>({
+                name: target.label,
+                value: target.id
             }))
     });
 }
@@ -1044,10 +1072,114 @@ const harmonyPlaygroundPlatform = definePlaygroundPlatform({
     title: 'Midscene HarmonyOS Playground',
     description: "HarmonyOS playground platform descriptor",
     async prepare (options) {
-        const selectedDeviceId = options?.deviceId || await selectDevice();
         const staticDir = options?.staticDir || node_path.join(__dirname, '../../static');
         const availablePort = await findAvailablePort(PLAYGROUND_SERVER_PORT);
         if (availablePort !== PLAYGROUND_SERVER_PORT) console.log(`⚠️  Port ${PLAYGROUND_SERVER_PORT} is busy, using port ${availablePort} instead`);
+        const createSessionManager = ()=>({
+                async getSetupSchema () {
+                    const explicitDeviceId = options?.deviceId;
+                    const discovery = explicitDeviceId ? {
+                        targets: [
+                            {
+                                id: explicitDeviceId,
+                                label: explicitDeviceId,
+                                isDefault: true,
+                                status: 'device'
+                            }
+                        ]
+                    } : await getHdcTargetsSafe();
+                    const { error, targets } = discovery;
+                    return {
+                        title: 'Welcome to\nMidscene.js Playground!',
+                        description: 'Select an available HDC device to create the current HarmonyOS Agent',
+                        primaryActionLabel: 'Create Agent',
+                        autoSubmitWhenReady: 1 === targets.length,
+                        notice: error ? {
+                            type: 'warning',
+                            message: 'HarmonyOS device discovery failed',
+                            description: error
+                        } : void 0,
+                        fields: [
+                            {
+                                key: 'deviceId',
+                                label: 'HDC device',
+                                type: 'select',
+                                required: true,
+                                options: targets.map((target)=>({
+                                        label: target.label,
+                                        value: target.id,
+                                        description: target.description
+                                    })),
+                                defaultValue: targets.find((target)=>target.isDefault)?.id,
+                                placeholder: 'Select a connected HarmonyOS device'
+                            }
+                        ],
+                        targets
+                    };
+                },
+                async listTargets () {
+                    if (options?.deviceId) return [
+                        {
+                            id: options.deviceId,
+                            label: options.deviceId,
+                            isDefault: true,
+                            status: 'device'
+                        }
+                    ];
+                    return (await getHdcTargetsSafe()).targets;
+                },
+                async createSession (input) {
+                    const targets = options?.deviceId ? [
+                        {
+                            id: options.deviceId,
+                            label: options.deviceId,
+                            isDefault: true,
+                            status: 'device'
+                        }
+                    ] : await getHdcTargets();
+                    const deviceId = options?.deviceId || ('string' == typeof input?.deviceId && input.deviceId ? input.deviceId : targets.find((target)=>target.isDefault)?.id);
+                    if (!deviceId) throw createNoDeviceError();
+                    const connectAgent = async ()=>{
+                        const device = new HarmonyDevice(deviceId);
+                        await device.connect();
+                        return new HarmonyAgent(device);
+                    };
+                    const agent = await connectAgent();
+                    return {
+                        agent,
+                        agentFactory: connectAgent,
+                        preview: createScreenshotPreviewDescriptor({
+                            title: 'HarmonyOS device preview'
+                        }),
+                        displayName: deviceId,
+                        metadata: {
+                            deviceId
+                        }
+                    };
+                }
+            });
+        if (options?.deferConnection) return {
+            platformId: 'harmony',
+            title: 'Midscene HarmonyOS Playground',
+            sessionManager: createSessionManager(),
+            launchOptions: {
+                port: availablePort,
+                openBrowser: false,
+                verbose: false,
+                staticPath: staticDir
+            },
+            preview: createScreenshotPreviewDescriptor({
+                title: 'HarmonyOS device preview'
+            }),
+            metadata: {
+                ...options.deviceId ? {
+                    deviceId: options.deviceId
+                } : {},
+                sessionConnected: false,
+                setupState: 'required'
+            }
+        };
+        const selectedDeviceId = options?.deviceId || await selectDevice();
         return {
             platformId: 'harmony',
             title: 'Midscene HarmonyOS Playground',

package/dist/es/mcp-server.mjs

@@ -820,6 +820,8 @@ const createPlatformActions = (device)=>({
             description: 'Terminate (force-stop) a HarmonyOS app by bundle name or mapped app name',
             interfaceAlias: 'terminate',
             paramSchema: terminateParamSchema,
+            delayBeforeRunner: 0,
+            delayAfterRunner: 0,
             call: async (param)=>{
                 if (!param.uri || '' === param.uri.trim()) throw new Error('Terminate requires a non-empty uri parameter');
                 await device.terminate(param.uri);
@@ -828,6 +830,8 @@ const createPlatformActions = (device)=>({
         HarmonyBackButton: defineAction({
             name: 'HarmonyBackButton',
             description: 'Trigger the system "back" operation on HarmonyOS devices',
+            delayBeforeRunner: 0,
+            delayAfterRunner: 0,
             call: async ()=>{
                 await device.back();
             }
@@ -835,6 +839,8 @@ const createPlatformActions = (device)=>({
         HarmonyHomeButton: defineAction({
             name: 'HarmonyHomeButton',
             description: 'Trigger the system "home" operation on HarmonyOS devices',
+            delayBeforeRunner: 0,
+            delayAfterRunner: 0,
             call: async ()=>{
                 await device.home();
             }
@@ -1018,7 +1024,7 @@ class HarmonyMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/harmony-mcp',
-            version: "1.7.6",
+            version: "1.7.7-beta-20260428102047.0",
             description: 'Control the HarmonyOS device using natural language commands'
         }, toolsManager);
     }