@midscene/harmony 1.5.4-beta-20260310084708.0 → 1.5.4

package/dist/es/bin.mjs

@@ -218,7 +218,7 @@ class HdcClient {
             width: Number.parseInt(renderSizeMatch[1], 10),
             height: Number.parseInt(renderSizeMatch[2], 10)
         };
-        const displayStdout = await this.shell('hidumper -s DisplayManagerService -a -a');
+        const displayStdout = await this.shell('hidumper -s DisplayManagerService -a');
         const displayMatch = displayStdout.match(/activeModes.*?(\d{3,5}),\s*(\d{3,5})/);
         if (displayMatch) return {
             width: Number.parseInt(displayMatch[1], 10),
@@ -250,6 +250,15 @@ function device_define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
+const harmonyInputParamSchema = z.object({
+    value: z.string().describe('The text to input. Provide the final content for replace/append modes, or an empty string when using clear mode to remove existing text.'),
+    mode: z.preprocess((val)=>'append' === val ? 'typeOnly' : val, z["enum"]([
+        'replace',
+        'clear',
+        'typeOnly'
+    ]).default('replace').optional().describe('Input mode: "replace" (default) - clear the field and input the value; "typeOnly" - type the value directly without clearing the field first; "clear" - attempt to clear the field (limited support on HarmonyOS).')),
+    locate: getMidsceneLocationSchema().describe('The input field to be filled').optional()
+});
 const defaultScrollUntilTimes = 10;
 const defaultSwipeSpeed = 600;
 const defaultFastSwipeSpeed = 2000;
@@ -304,15 +313,13 @@ class device_HarmonyDevice {
                 name: 'Input',
                 description: 'Input text into the input field',
                 interfaceAlias: 'aiInput',
-                paramSchema: z.object({
-                    value: z.string().describe('The text to input. Provide the final content for replace/append modes, or an empty string when using clear mode to remove existing text.'),
-                    mode: z.preprocess((val)=>'append' === val ? 'typeOnly' : val, z["enum"]([
-                        'replace',
-                        'clear',
-                        'typeOnly'
-                    ]).default('replace').optional().describe('Input mode: "replace" (default) - clear the field and input the value; "typeOnly" - type the value directly without clearing the field first; "clear" - attempt to clear the field (limited support on HarmonyOS).')),
-                    locate: getMidsceneLocationSchema().describe('The input field to be filled').optional()
-                }),
+                paramSchema: harmonyInputParamSchema,
+                sample: {
+                    value: 'test@example.com',
+                    locate: {
+                        prompt: 'the email input field'
+                    }
+                },
                 call: async (param)=>{
                     const element = param.locate;
                     if ('clear' === param.mode) return void await this.clearInput(element);
@@ -373,6 +380,11 @@ class device_HarmonyDevice {
                     duration: z.number().optional().describe('The duration of the long press in milliseconds'),
                     locate: getMidsceneLocationSchema().describe('The element to be long pressed')
                 }),
+                sample: {
+                    locate: {
+                        prompt: 'the message bubble'
+                    }
+                },
                 call: async (param)=>{
                     const element = param.locate;
                     if (!element) throw new Error('LongPress requires an element to be located');
@@ -774,6 +786,9 @@ const createPlatformActions = (device)=>({
             description: 'Execute HDC shell command on HarmonyOS device',
             interfaceAlias: 'runHdcShell',
             paramSchema: runHdcShellParamSchema,
+            sample: {
+                command: 'hidumper -s WindowManagerService -a'
+            },
             call: async (param)=>{
                 if (!param.command || '' === param.command.trim()) throw new Error('RunHdcShell requires a non-empty command parameter');
                 const hdc = await device.getHdc();
@@ -785,6 +800,9 @@ const createPlatformActions = (device)=>({
             description: 'Launch a HarmonyOS app or URL',
             interfaceAlias: 'launch',
             paramSchema: launchParamSchema,
+            sample: {
+                uri: 'com.example.app'
+            },
             call: async (param)=>{
                 if (!param.uri || '' === param.uri.trim()) throw new Error('Launch requires a non-empty uri parameter');
                 await device.launch(param.uri);

package/dist/es/cli.mjs

@@ -215,7 +215,7 @@ class HdcClient {
             width: Number.parseInt(renderSizeMatch[1], 10),
             height: Number.parseInt(renderSizeMatch[2], 10)
         };
-        const displayStdout = await this.shell('hidumper -s DisplayManagerService -a -a');
+        const displayStdout = await this.shell('hidumper -s DisplayManagerService -a');
         const displayMatch = displayStdout.match(/activeModes.*?(\d{3,5}),\s*(\d{3,5})/);
         if (displayMatch) return {
             width: Number.parseInt(displayMatch[1], 10),
@@ -247,6 +247,15 @@ function device_define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
+const harmonyInputParamSchema = z.object({
+    value: z.string().describe('The text to input. Provide the final content for replace/append modes, or an empty string when using clear mode to remove existing text.'),
+    mode: z.preprocess((val)=>'append' === val ? 'typeOnly' : val, z["enum"]([
+        'replace',
+        'clear',
+        'typeOnly'
+    ]).default('replace').optional().describe('Input mode: "replace" (default) - clear the field and input the value; "typeOnly" - type the value directly without clearing the field first; "clear" - attempt to clear the field (limited support on HarmonyOS).')),
+    locate: getMidsceneLocationSchema().describe('The input field to be filled').optional()
+});
 const defaultScrollUntilTimes = 10;
 const defaultSwipeSpeed = 600;
 const defaultFastSwipeSpeed = 2000;
@@ -301,15 +310,13 @@ class HarmonyDevice {
                 name: 'Input',
                 description: 'Input text into the input field',
                 interfaceAlias: 'aiInput',
-                paramSchema: z.object({
-                    value: z.string().describe('The text to input. Provide the final content for replace/append modes, or an empty string when using clear mode to remove existing text.'),
-                    mode: z.preprocess((val)=>'append' === val ? 'typeOnly' : val, z["enum"]([
-                        'replace',
-                        'clear',
-                        'typeOnly'
-                    ]).default('replace').optional().describe('Input mode: "replace" (default) - clear the field and input the value; "typeOnly" - type the value directly without clearing the field first; "clear" - attempt to clear the field (limited support on HarmonyOS).')),
-                    locate: getMidsceneLocationSchema().describe('The input field to be filled').optional()
-                }),
+                paramSchema: harmonyInputParamSchema,
+                sample: {
+                    value: 'test@example.com',
+                    locate: {
+                        prompt: 'the email input field'
+                    }
+                },
                 call: async (param)=>{
                     const element = param.locate;
                     if ('clear' === param.mode) return void await this.clearInput(element);
@@ -370,6 +377,11 @@ class HarmonyDevice {
                     duration: z.number().optional().describe('The duration of the long press in milliseconds'),
                     locate: getMidsceneLocationSchema().describe('The element to be long pressed')
                 }),
+                sample: {
+                    locate: {
+                        prompt: 'the message bubble'
+                    }
+                },
                 call: async (param)=>{
                     const element = param.locate;
                     if (!element) throw new Error('LongPress requires an element to be located');
@@ -771,6 +783,9 @@ const createPlatformActions = (device)=>({
             description: 'Execute HDC shell command on HarmonyOS device',
             interfaceAlias: 'runHdcShell',
             paramSchema: runHdcShellParamSchema,
+            sample: {
+                command: 'hidumper -s WindowManagerService -a'
+            },
             call: async (param)=>{
                 if (!param.command || '' === param.command.trim()) throw new Error('RunHdcShell requires a non-empty command parameter');
                 const hdc = await device.getHdc();
@@ -782,6 +797,9 @@ const createPlatformActions = (device)=>({
             description: 'Launch a HarmonyOS app or URL',
             interfaceAlias: 'launch',
             paramSchema: launchParamSchema,
+            sample: {
+                uri: 'com.example.app'
+            },
             call: async (param)=>{
                 if (!param.uri || '' === param.uri.trim()) throw new Error('Launch requires a non-empty uri parameter');
                 await device.launch(param.uri);
@@ -933,7 +951,7 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
 const tools = new HarmonyMidsceneTools();
 runToolsCLI(tools, 'midscene-harmony', {
     stripPrefix: 'harmony_',
-    version: "1.5.4-beta-20260310084708.0"
+    version: "1.5.4"
 }).catch((e)=>{
     if (!(e instanceof CLIError)) console.error(e);
     process.exit(e instanceof CLIError ? e.exitCode : 1);

package/dist/es/index.mjs

@@ -182,7 +182,7 @@ class HdcClient {
             width: Number.parseInt(renderSizeMatch[1], 10),
             height: Number.parseInt(renderSizeMatch[2], 10)
         };
-        const displayStdout = await this.shell('hidumper -s DisplayManagerService -a -a');
+        const displayStdout = await this.shell('hidumper -s DisplayManagerService -a');
         const displayMatch = displayStdout.match(/activeModes.*?(\d{3,5}),\s*(\d{3,5})/);
         if (displayMatch) return {
             width: Number.parseInt(displayMatch[1], 10),
@@ -214,6 +214,15 @@ function device_define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
+const harmonyInputParamSchema = z.object({
+    value: z.string().describe('The text to input. Provide the final content for replace/append modes, or an empty string when using clear mode to remove existing text.'),
+    mode: z.preprocess((val)=>'append' === val ? 'typeOnly' : val, z["enum"]([
+        'replace',
+        'clear',
+        'typeOnly'
+    ]).default('replace').optional().describe('Input mode: "replace" (default) - clear the field and input the value; "typeOnly" - type the value directly without clearing the field first; "clear" - attempt to clear the field (limited support on HarmonyOS).')),
+    locate: getMidsceneLocationSchema().describe('The input field to be filled').optional()
+});
 const defaultScrollUntilTimes = 10;
 const defaultSwipeSpeed = 600;
 const defaultFastSwipeSpeed = 2000;
@@ -268,15 +277,13 @@ class HarmonyDevice {
                 name: 'Input',
                 description: 'Input text into the input field',
                 interfaceAlias: 'aiInput',
-                paramSchema: z.object({
-                    value: z.string().describe('The text to input. Provide the final content for replace/append modes, or an empty string when using clear mode to remove existing text.'),
-                    mode: z.preprocess((val)=>'append' === val ? 'typeOnly' : val, z["enum"]([
-                        'replace',
-                        'clear',
-                        'typeOnly'
-                    ]).default('replace').optional().describe('Input mode: "replace" (default) - clear the field and input the value; "typeOnly" - type the value directly without clearing the field first; "clear" - attempt to clear the field (limited support on HarmonyOS).')),
-                    locate: getMidsceneLocationSchema().describe('The input field to be filled').optional()
-                }),
+                paramSchema: harmonyInputParamSchema,
+                sample: {
+                    value: 'test@example.com',
+                    locate: {
+                        prompt: 'the email input field'
+                    }
+                },
                 call: async (param)=>{
                     const element = param.locate;
                     if ('clear' === param.mode) return void await this.clearInput(element);
@@ -337,6 +344,11 @@ class HarmonyDevice {
                     duration: z.number().optional().describe('The duration of the long press in milliseconds'),
                     locate: getMidsceneLocationSchema().describe('The element to be long pressed')
                 }),
+                sample: {
+                    locate: {
+                        prompt: 'the message bubble'
+                    }
+                },
                 call: async (param)=>{
                     const element = param.locate;
                     if (!element) throw new Error('LongPress requires an element to be located');
@@ -738,6 +750,9 @@ const createPlatformActions = (device)=>({
             description: 'Execute HDC shell command on HarmonyOS device',
             interfaceAlias: 'runHdcShell',
             paramSchema: runHdcShellParamSchema,
+            sample: {
+                command: 'hidumper -s WindowManagerService -a'
+            },
             call: async (param)=>{
                 if (!param.command || '' === param.command.trim()) throw new Error('RunHdcShell requires a non-empty command parameter');
                 const hdc = await device.getHdc();
@@ -749,6 +764,9 @@ const createPlatformActions = (device)=>({
             description: 'Launch a HarmonyOS app or URL',
             interfaceAlias: 'launch',
             paramSchema: launchParamSchema,
+            sample: {
+                uri: 'com.example.app'
+            },
             call: async (param)=>{
                 if (!param.uri || '' === param.uri.trim()) throw new Error('Launch requires a non-empty uri parameter');
                 await device.launch(param.uri);

package/dist/es/mcp-server.mjs

@@ -214,7 +214,7 @@ class HdcClient {
             width: Number.parseInt(renderSizeMatch[1], 10),
             height: Number.parseInt(renderSizeMatch[2], 10)
         };
-        const displayStdout = await this.shell('hidumper -s DisplayManagerService -a -a');
+        const displayStdout = await this.shell('hidumper -s DisplayManagerService -a');
         const displayMatch = displayStdout.match(/activeModes.*?(\d{3,5}),\s*(\d{3,5})/);
         if (displayMatch) return {
             width: Number.parseInt(displayMatch[1], 10),
@@ -246,6 +246,15 @@ function device_define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
+const harmonyInputParamSchema = z.object({
+    value: z.string().describe('The text to input. Provide the final content for replace/append modes, or an empty string when using clear mode to remove existing text.'),
+    mode: z.preprocess((val)=>'append' === val ? 'typeOnly' : val, z["enum"]([
+        'replace',
+        'clear',
+        'typeOnly'
+    ]).default('replace').optional().describe('Input mode: "replace" (default) - clear the field and input the value; "typeOnly" - type the value directly without clearing the field first; "clear" - attempt to clear the field (limited support on HarmonyOS).')),
+    locate: getMidsceneLocationSchema().describe('The input field to be filled').optional()
+});
 const defaultScrollUntilTimes = 10;
 const defaultSwipeSpeed = 600;
 const defaultFastSwipeSpeed = 2000;
@@ -300,15 +309,13 @@ class HarmonyDevice {
                 name: 'Input',
                 description: 'Input text into the input field',
                 interfaceAlias: 'aiInput',
-                paramSchema: z.object({
-                    value: z.string().describe('The text to input. Provide the final content for replace/append modes, or an empty string when using clear mode to remove existing text.'),
-                    mode: z.preprocess((val)=>'append' === val ? 'typeOnly' : val, z["enum"]([
-                        'replace',
-                        'clear',
-                        'typeOnly'
-                    ]).default('replace').optional().describe('Input mode: "replace" (default) - clear the field and input the value; "typeOnly" - type the value directly without clearing the field first; "clear" - attempt to clear the field (limited support on HarmonyOS).')),
-                    locate: getMidsceneLocationSchema().describe('The input field to be filled').optional()
-                }),
+                paramSchema: harmonyInputParamSchema,
+                sample: {
+                    value: 'test@example.com',
+                    locate: {
+                        prompt: 'the email input field'
+                    }
+                },
                 call: async (param)=>{
                     const element = param.locate;
                     if ('clear' === param.mode) return void await this.clearInput(element);
@@ -369,6 +376,11 @@ class HarmonyDevice {
                     duration: z.number().optional().describe('The duration of the long press in milliseconds'),
                     locate: getMidsceneLocationSchema().describe('The element to be long pressed')
                 }),
+                sample: {
+                    locate: {
+                        prompt: 'the message bubble'
+                    }
+                },
                 call: async (param)=>{
                     const element = param.locate;
                     if (!element) throw new Error('LongPress requires an element to be located');
@@ -770,6 +782,9 @@ const createPlatformActions = (device)=>({
             description: 'Execute HDC shell command on HarmonyOS device',
             interfaceAlias: 'runHdcShell',
             paramSchema: runHdcShellParamSchema,
+            sample: {
+                command: 'hidumper -s WindowManagerService -a'
+            },
             call: async (param)=>{
                 if (!param.command || '' === param.command.trim()) throw new Error('RunHdcShell requires a non-empty command parameter');
                 const hdc = await device.getHdc();
@@ -781,6 +796,9 @@ const createPlatformActions = (device)=>({
             description: 'Launch a HarmonyOS app or URL',
             interfaceAlias: 'launch',
             paramSchema: launchParamSchema,
+            sample: {
+                uri: 'com.example.app'
+            },
             call: async (param)=>{
                 if (!param.uri || '' === param.uri.trim()) throw new Error('Launch requires a non-empty uri parameter');
                 await device.launch(param.uri);
@@ -936,7 +954,7 @@ class HarmonyMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/harmony-mcp',
-            version: "1.5.4-beta-20260310084708.0",
+            version: "1.5.4",
             description: 'Control the HarmonyOS device using natural language commands'
         }, toolsManager);
     }

package/dist/lib/bin.js

@@ -244,7 +244,7 @@ class HdcClient {
             width: Number.parseInt(renderSizeMatch[1], 10),
             height: Number.parseInt(renderSizeMatch[2], 10)
         };
-        const displayStdout = await this.shell('hidumper -s DisplayManagerService -a -a');
+        const displayStdout = await this.shell('hidumper -s DisplayManagerService -a');
         const displayMatch = displayStdout.match(/activeModes.*?(\d{3,5}),\s*(\d{3,5})/);
         if (displayMatch) return {
             width: Number.parseInt(displayMatch[1], 10),
@@ -276,6 +276,15 @@ function device_define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
+const harmonyInputParamSchema = core_namespaceObject.z.object({
+    value: core_namespaceObject.z.string().describe('The text to input. Provide the final content for replace/append modes, or an empty string when using clear mode to remove existing text.'),
+    mode: core_namespaceObject.z.preprocess((val)=>'append' === val ? 'typeOnly' : val, core_namespaceObject.z["enum"]([
+        'replace',
+        'clear',
+        'typeOnly'
+    ]).default('replace').optional().describe('Input mode: "replace" (default) - clear the field and input the value; "typeOnly" - type the value directly without clearing the field first; "clear" - attempt to clear the field (limited support on HarmonyOS).')),
+    locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The input field to be filled').optional()
+});
 const defaultScrollUntilTimes = 10;
 const defaultSwipeSpeed = 600;
 const defaultFastSwipeSpeed = 2000;
@@ -330,15 +339,13 @@ class device_HarmonyDevice {
                 name: 'Input',
                 description: 'Input text into the input field',
                 interfaceAlias: 'aiInput',
-                paramSchema: core_namespaceObject.z.object({
-                    value: core_namespaceObject.z.string().describe('The text to input. Provide the final content for replace/append modes, or an empty string when using clear mode to remove existing text.'),
-                    mode: core_namespaceObject.z.preprocess((val)=>'append' === val ? 'typeOnly' : val, core_namespaceObject.z["enum"]([
-                        'replace',
-                        'clear',
-                        'typeOnly'
-                    ]).default('replace').optional().describe('Input mode: "replace" (default) - clear the field and input the value; "typeOnly" - type the value directly without clearing the field first; "clear" - attempt to clear the field (limited support on HarmonyOS).')),
-                    locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The input field to be filled').optional()
-                }),
+                paramSchema: harmonyInputParamSchema,
+                sample: {
+                    value: 'test@example.com',
+                    locate: {
+                        prompt: 'the email input field'
+                    }
+                },
                 call: async (param)=>{
                     const element = param.locate;
                     if ('clear' === param.mode) return void await this.clearInput(element);
@@ -399,6 +406,11 @@ class device_HarmonyDevice {
                     duration: core_namespaceObject.z.number().optional().describe('The duration of the long press in milliseconds'),
                     locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The element to be long pressed')
                 }),
+                sample: {
+                    locate: {
+                        prompt: 'the message bubble'
+                    }
+                },
                 call: async (param)=>{
                     const element = param.locate;
                     if (!element) throw new Error('LongPress requires an element to be located');
@@ -800,6 +812,9 @@ const createPlatformActions = (device)=>({
             description: 'Execute HDC shell command on HarmonyOS device',
             interfaceAlias: 'runHdcShell',
             paramSchema: runHdcShellParamSchema,
+            sample: {
+                command: 'hidumper -s WindowManagerService -a'
+            },
             call: async (param)=>{
                 if (!param.command || '' === param.command.trim()) throw new Error('RunHdcShell requires a non-empty command parameter');
                 const hdc = await device.getHdc();
@@ -811,6 +826,9 @@ const createPlatformActions = (device)=>({
             description: 'Launch a HarmonyOS app or URL',
             interfaceAlias: 'launch',
             paramSchema: launchParamSchema,
+            sample: {
+                uri: 'com.example.app'
+            },
             call: async (param)=>{
                 if (!param.uri || '' === param.uri.trim()) throw new Error('Launch requires a non-empty uri parameter');
                 await device.launch(param.uri);

package/dist/lib/cli.js

@@ -240,7 +240,7 @@ class HdcClient {
             width: Number.parseInt(renderSizeMatch[1], 10),
             height: Number.parseInt(renderSizeMatch[2], 10)
         };
-        const displayStdout = await this.shell('hidumper -s DisplayManagerService -a -a');
+        const displayStdout = await this.shell('hidumper -s DisplayManagerService -a');
         const displayMatch = displayStdout.match(/activeModes.*?(\d{3,5}),\s*(\d{3,5})/);
         if (displayMatch) return {
             width: Number.parseInt(displayMatch[1], 10),
@@ -272,6 +272,15 @@ function device_define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
+const harmonyInputParamSchema = core_namespaceObject.z.object({
+    value: core_namespaceObject.z.string().describe('The text to input. Provide the final content for replace/append modes, or an empty string when using clear mode to remove existing text.'),
+    mode: core_namespaceObject.z.preprocess((val)=>'append' === val ? 'typeOnly' : val, core_namespaceObject.z["enum"]([
+        'replace',
+        'clear',
+        'typeOnly'
+    ]).default('replace').optional().describe('Input mode: "replace" (default) - clear the field and input the value; "typeOnly" - type the value directly without clearing the field first; "clear" - attempt to clear the field (limited support on HarmonyOS).')),
+    locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The input field to be filled').optional()
+});
 const defaultScrollUntilTimes = 10;
 const defaultSwipeSpeed = 600;
 const defaultFastSwipeSpeed = 2000;
@@ -326,15 +335,13 @@ class HarmonyDevice {
                 name: 'Input',
                 description: 'Input text into the input field',
                 interfaceAlias: 'aiInput',
-                paramSchema: core_namespaceObject.z.object({
-                    value: core_namespaceObject.z.string().describe('The text to input. Provide the final content for replace/append modes, or an empty string when using clear mode to remove existing text.'),
-                    mode: core_namespaceObject.z.preprocess((val)=>'append' === val ? 'typeOnly' : val, core_namespaceObject.z["enum"]([
-                        'replace',
-                        'clear',
-                        'typeOnly'
-                    ]).default('replace').optional().describe('Input mode: "replace" (default) - clear the field and input the value; "typeOnly" - type the value directly without clearing the field first; "clear" - attempt to clear the field (limited support on HarmonyOS).')),
-                    locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The input field to be filled').optional()
-                }),
+                paramSchema: harmonyInputParamSchema,
+                sample: {
+                    value: 'test@example.com',
+                    locate: {
+                        prompt: 'the email input field'
+                    }
+                },
                 call: async (param)=>{
                     const element = param.locate;
                     if ('clear' === param.mode) return void await this.clearInput(element);
@@ -395,6 +402,11 @@ class HarmonyDevice {
                     duration: core_namespaceObject.z.number().optional().describe('The duration of the long press in milliseconds'),
                     locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The element to be long pressed')
                 }),
+                sample: {
+                    locate: {
+                        prompt: 'the message bubble'
+                    }
+                },
                 call: async (param)=>{
                     const element = param.locate;
                     if (!element) throw new Error('LongPress requires an element to be located');
@@ -796,6 +808,9 @@ const createPlatformActions = (device)=>({
             description: 'Execute HDC shell command on HarmonyOS device',
             interfaceAlias: 'runHdcShell',
             paramSchema: runHdcShellParamSchema,
+            sample: {
+                command: 'hidumper -s WindowManagerService -a'
+            },
             call: async (param)=>{
                 if (!param.command || '' === param.command.trim()) throw new Error('RunHdcShell requires a non-empty command parameter');
                 const hdc = await device.getHdc();
@@ -807,6 +822,9 @@ const createPlatformActions = (device)=>({
             description: 'Launch a HarmonyOS app or URL',
             interfaceAlias: 'launch',
             paramSchema: launchParamSchema,
+            sample: {
+                uri: 'com.example.app'
+            },
             call: async (param)=>{
                 if (!param.uri || '' === param.uri.trim()) throw new Error('Launch requires a non-empty uri parameter');
                 await device.launch(param.uri);
@@ -958,7 +976,7 @@ class HarmonyMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
 const tools = new HarmonyMidsceneTools();
 (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-harmony', {
     stripPrefix: 'harmony_',
-    version: "1.5.4-beta-20260310084708.0"
+    version: "1.5.4"
 }).catch((e)=>{
     if (!(e instanceof cli_namespaceObject.CLIError)) console.error(e);
     process.exit(e instanceof cli_namespaceObject.CLIError ? e.exitCode : 1);

package/dist/lib/index.js

@@ -223,7 +223,7 @@ class HdcClient {
             width: Number.parseInt(renderSizeMatch[1], 10),
             height: Number.parseInt(renderSizeMatch[2], 10)
         };
-        const displayStdout = await this.shell('hidumper -s DisplayManagerService -a -a');
+        const displayStdout = await this.shell('hidumper -s DisplayManagerService -a');
         const displayMatch = displayStdout.match(/activeModes.*?(\d{3,5}),\s*(\d{3,5})/);
         if (displayMatch) return {
             width: Number.parseInt(displayMatch[1], 10),
@@ -255,6 +255,15 @@ function device_define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
+const harmonyInputParamSchema = core_namespaceObject.z.object({
+    value: core_namespaceObject.z.string().describe('The text to input. Provide the final content for replace/append modes, or an empty string when using clear mode to remove existing text.'),
+    mode: core_namespaceObject.z.preprocess((val)=>'append' === val ? 'typeOnly' : val, core_namespaceObject.z["enum"]([
+        'replace',
+        'clear',
+        'typeOnly'
+    ]).default('replace').optional().describe('Input mode: "replace" (default) - clear the field and input the value; "typeOnly" - type the value directly without clearing the field first; "clear" - attempt to clear the field (limited support on HarmonyOS).')),
+    locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The input field to be filled').optional()
+});
 const defaultScrollUntilTimes = 10;
 const defaultSwipeSpeed = 600;
 const defaultFastSwipeSpeed = 2000;
@@ -309,15 +318,13 @@ class HarmonyDevice {
                 name: 'Input',
                 description: 'Input text into the input field',
                 interfaceAlias: 'aiInput',
-                paramSchema: core_namespaceObject.z.object({
-                    value: core_namespaceObject.z.string().describe('The text to input. Provide the final content for replace/append modes, or an empty string when using clear mode to remove existing text.'),
-                    mode: core_namespaceObject.z.preprocess((val)=>'append' === val ? 'typeOnly' : val, core_namespaceObject.z["enum"]([
-                        'replace',
-                        'clear',
-                        'typeOnly'
-                    ]).default('replace').optional().describe('Input mode: "replace" (default) - clear the field and input the value; "typeOnly" - type the value directly without clearing the field first; "clear" - attempt to clear the field (limited support on HarmonyOS).')),
-                    locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The input field to be filled').optional()
-                }),
+                paramSchema: harmonyInputParamSchema,
+                sample: {
+                    value: 'test@example.com',
+                    locate: {
+                        prompt: 'the email input field'
+                    }
+                },
                 call: async (param)=>{
                     const element = param.locate;
                     if ('clear' === param.mode) return void await this.clearInput(element);
@@ -378,6 +385,11 @@ class HarmonyDevice {
                     duration: core_namespaceObject.z.number().optional().describe('The duration of the long press in milliseconds'),
                     locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The element to be long pressed')
                 }),
+                sample: {
+                    locate: {
+                        prompt: 'the message bubble'
+                    }
+                },
                 call: async (param)=>{
                     const element = param.locate;
                     if (!element) throw new Error('LongPress requires an element to be located');
@@ -779,6 +791,9 @@ const createPlatformActions = (device)=>({
             description: 'Execute HDC shell command on HarmonyOS device',
             interfaceAlias: 'runHdcShell',
             paramSchema: runHdcShellParamSchema,
+            sample: {
+                command: 'hidumper -s WindowManagerService -a'
+            },
             call: async (param)=>{
                 if (!param.command || '' === param.command.trim()) throw new Error('RunHdcShell requires a non-empty command parameter');
                 const hdc = await device.getHdc();
@@ -790,6 +805,9 @@ const createPlatformActions = (device)=>({
             description: 'Launch a HarmonyOS app or URL',
             interfaceAlias: 'launch',
             paramSchema: launchParamSchema,
+            sample: {
+                uri: 'com.example.app'
+            },
             call: async (param)=>{
                 if (!param.uri || '' === param.uri.trim()) throw new Error('Launch requires a non-empty uri parameter');
                 await device.launch(param.uri);