@midscene/ios 1.5.4-beta-20260310030546.0 → 1.5.4

package/dist/es/bin.mjs

@@ -573,6 +573,16 @@ function _define_property(obj, key, value) {
     return obj;
 }
 const debugDevice = getDebug('ios:device');
+const iosInputParamSchema = 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.'),
+    autoDismissKeyboard: z.boolean().optional().describe('Whether to dismiss the keyboard after input. Defaults to true if not specified. Set to false to keep the keyboard visible after input.'),
+    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" - clear the field without inputting new text.')),
+    locate: getMidsceneLocationSchema().describe('The input field to be filled').optional()
+});
 const WDA_HTTP_METHODS = [
     'GET',
     'POST',
@@ -597,16 +607,13 @@ class device_IOSDevice {
                 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.'),
-                    autoDismissKeyboard: z.boolean().optional().describe('Whether to dismiss the keyboard after input. Defaults to true if not specified. Set to false to keep the keyboard visible after input.'),
-                    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" - clear the field without inputting new text.')),
-                    locate: getMidsceneLocationSchema().describe('The input field to be filled').optional()
-                }),
+                paramSchema: iosInputParamSchema,
+                sample: {
+                    value: 'test@example.com',
+                    locate: {
+                        prompt: 'the email input field'
+                    }
+                },
                 call: async (param)=>{
                     const element = param.locate;
                     if ('typeOnly' !== param.mode) await this.clearInput(element);
@@ -668,6 +675,11 @@ class device_IOSDevice {
                     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;
                     node_assert(element, 'LongPress requires an element to be located');
@@ -1157,6 +1169,10 @@ const createPlatformActions = (device)=>({
             description: 'Execute WebDriverAgent API request directly on iOS device',
             interfaceAlias: 'runWdaRequest',
             paramSchema: runWdaRequestParamSchema,
+            sample: {
+                method: 'GET',
+                endpoint: '/status'
+            },
             call: async (param)=>await device.runWdaRequest(param.method, param.endpoint, param.data)
         }),
         Launch: defineAction({

package/dist/es/cli.mjs

@@ -571,6 +571,16 @@ function _define_property(obj, key, value) {
     return obj;
 }
 const debugDevice = getDebug('ios:device');
+const iosInputParamSchema = 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.'),
+    autoDismissKeyboard: z.boolean().optional().describe('Whether to dismiss the keyboard after input. Defaults to true if not specified. Set to false to keep the keyboard visible after input.'),
+    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" - clear the field without inputting new text.')),
+    locate: getMidsceneLocationSchema().describe('The input field to be filled').optional()
+});
 const WDA_HTTP_METHODS = [
     'GET',
     'POST',
@@ -595,16 +605,13 @@ class IOSDevice {
                 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.'),
-                    autoDismissKeyboard: z.boolean().optional().describe('Whether to dismiss the keyboard after input. Defaults to true if not specified. Set to false to keep the keyboard visible after input.'),
-                    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" - clear the field without inputting new text.')),
-                    locate: getMidsceneLocationSchema().describe('The input field to be filled').optional()
-                }),
+                paramSchema: iosInputParamSchema,
+                sample: {
+                    value: 'test@example.com',
+                    locate: {
+                        prompt: 'the email input field'
+                    }
+                },
                 call: async (param)=>{
                     const element = param.locate;
                     if ('typeOnly' !== param.mode) await this.clearInput(element);
@@ -666,6 +673,11 @@ class IOSDevice {
                     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;
                     node_assert(element, 'LongPress requires an element to be located');
@@ -1155,6 +1167,10 @@ const createPlatformActions = (device)=>({
             description: 'Execute WebDriverAgent API request directly on iOS device',
             interfaceAlias: 'runWdaRequest',
             paramSchema: runWdaRequestParamSchema,
+            sample: {
+                method: 'GET',
+                endpoint: '/status'
+            },
             call: async (param)=>await device.runWdaRequest(param.method, param.endpoint, param.data)
         }),
         Launch: defineAction({
@@ -1268,7 +1284,8 @@ class IOSMidsceneTools extends BaseMidsceneTools {
 }
 const tools = new IOSMidsceneTools();
 runToolsCLI(tools, 'midscene-ios', {
-    stripPrefix: 'ios_'
+    stripPrefix: 'ios_',
+    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

@@ -390,6 +390,16 @@ function _define_property(obj, key, value) {
     return obj;
 }
 const debugDevice = getDebug('ios:device');
+const iosInputParamSchema = 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.'),
+    autoDismissKeyboard: z.boolean().optional().describe('Whether to dismiss the keyboard after input. Defaults to true if not specified. Set to false to keep the keyboard visible after input.'),
+    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" - clear the field without inputting new text.')),
+    locate: getMidsceneLocationSchema().describe('The input field to be filled').optional()
+});
 const WDA_HTTP_METHODS = [
     'GET',
     'POST',
@@ -414,16 +424,13 @@ class IOSDevice {
                 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.'),
-                    autoDismissKeyboard: z.boolean().optional().describe('Whether to dismiss the keyboard after input. Defaults to true if not specified. Set to false to keep the keyboard visible after input.'),
-                    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" - clear the field without inputting new text.')),
-                    locate: getMidsceneLocationSchema().describe('The input field to be filled').optional()
-                }),
+                paramSchema: iosInputParamSchema,
+                sample: {
+                    value: 'test@example.com',
+                    locate: {
+                        prompt: 'the email input field'
+                    }
+                },
                 call: async (param)=>{
                     const element = param.locate;
                     if ('typeOnly' !== param.mode) await this.clearInput(element);
@@ -485,6 +492,11 @@ class IOSDevice {
                     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;
                     node_assert(element, 'LongPress requires an element to be located');
@@ -974,6 +986,10 @@ const createPlatformActions = (device)=>({
             description: 'Execute WebDriverAgent API request directly on iOS device',
             interfaceAlias: 'runWdaRequest',
             paramSchema: runWdaRequestParamSchema,
+            sample: {
+                method: 'GET',
+                endpoint: '/status'
+            },
             call: async (param)=>await device.runWdaRequest(param.method, param.endpoint, param.data)
         }),
         Launch: defineAction({

package/dist/es/mcp-server.mjs

@@ -570,6 +570,16 @@ function _define_property(obj, key, value) {
     return obj;
 }
 const debugDevice = getDebug('ios:device');
+const iosInputParamSchema = 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.'),
+    autoDismissKeyboard: z.boolean().optional().describe('Whether to dismiss the keyboard after input. Defaults to true if not specified. Set to false to keep the keyboard visible after input.'),
+    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" - clear the field without inputting new text.')),
+    locate: getMidsceneLocationSchema().describe('The input field to be filled').optional()
+});
 const WDA_HTTP_METHODS = [
     'GET',
     'POST',
@@ -594,16 +604,13 @@ class IOSDevice {
                 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.'),
-                    autoDismissKeyboard: z.boolean().optional().describe('Whether to dismiss the keyboard after input. Defaults to true if not specified. Set to false to keep the keyboard visible after input.'),
-                    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" - clear the field without inputting new text.')),
-                    locate: getMidsceneLocationSchema().describe('The input field to be filled').optional()
-                }),
+                paramSchema: iosInputParamSchema,
+                sample: {
+                    value: 'test@example.com',
+                    locate: {
+                        prompt: 'the email input field'
+                    }
+                },
                 call: async (param)=>{
                     const element = param.locate;
                     if ('typeOnly' !== param.mode) await this.clearInput(element);
@@ -665,6 +672,11 @@ class IOSDevice {
                     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;
                     node_assert(element, 'LongPress requires an element to be located');
@@ -1154,6 +1166,10 @@ const createPlatformActions = (device)=>({
             description: 'Execute WebDriverAgent API request directly on iOS device',
             interfaceAlias: 'runWdaRequest',
             paramSchema: runWdaRequestParamSchema,
+            sample: {
+                method: 'GET',
+                endpoint: '/status'
+            },
             call: async (param)=>await device.runWdaRequest(param.method, param.endpoint, param.data)
         }),
         Launch: defineAction({
@@ -1272,7 +1288,7 @@ class IOSMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/ios-mcp',
-            version: "1.5.4-beta-20260310030546.0",
+            version: "1.5.4",
             description: 'Control the iOS device using natural language commands'
         }, toolsManager);
     }

package/dist/lib/bin.js

@@ -598,6 +598,16 @@ function _define_property(obj, key, value) {
     return obj;
 }
 const debugDevice = (0, logger_namespaceObject.getDebug)('ios:device');
+const iosInputParamSchema = 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.'),
+    autoDismissKeyboard: core_namespaceObject.z.boolean().optional().describe('Whether to dismiss the keyboard after input. Defaults to true if not specified. Set to false to keep the keyboard visible after input.'),
+    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" - clear the field without inputting new text.')),
+    locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The input field to be filled').optional()
+});
 const WDA_HTTP_METHODS = [
     'GET',
     'POST',
@@ -622,16 +632,13 @@ class device_IOSDevice {
                 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.'),
-                    autoDismissKeyboard: core_namespaceObject.z.boolean().optional().describe('Whether to dismiss the keyboard after input. Defaults to true if not specified. Set to false to keep the keyboard visible after input.'),
-                    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" - clear the field without inputting new text.')),
-                    locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The input field to be filled').optional()
-                }),
+                paramSchema: iosInputParamSchema,
+                sample: {
+                    value: 'test@example.com',
+                    locate: {
+                        prompt: 'the email input field'
+                    }
+                },
                 call: async (param)=>{
                     const element = param.locate;
                     if ('typeOnly' !== param.mode) await this.clearInput(element);
@@ -693,6 +700,11 @@ class device_IOSDevice {
                     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;
                     external_node_assert_default()(element, 'LongPress requires an element to be located');
@@ -1182,6 +1194,10 @@ const createPlatformActions = (device)=>({
             description: 'Execute WebDriverAgent API request directly on iOS device',
             interfaceAlias: 'runWdaRequest',
             paramSchema: runWdaRequestParamSchema,
+            sample: {
+                method: 'GET',
+                endpoint: '/status'
+            },
             call: async (param)=>await device.runWdaRequest(param.method, param.endpoint, param.data)
         }),
         Launch: (0, device_namespaceObject.defineAction)({

package/dist/lib/cli.js

@@ -595,6 +595,16 @@ function _define_property(obj, key, value) {
     return obj;
 }
 const debugDevice = (0, logger_namespaceObject.getDebug)('ios:device');
+const iosInputParamSchema = 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.'),
+    autoDismissKeyboard: core_namespaceObject.z.boolean().optional().describe('Whether to dismiss the keyboard after input. Defaults to true if not specified. Set to false to keep the keyboard visible after input.'),
+    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" - clear the field without inputting new text.')),
+    locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The input field to be filled').optional()
+});
 const WDA_HTTP_METHODS = [
     'GET',
     'POST',
@@ -619,16 +629,13 @@ class IOSDevice {
                 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.'),
-                    autoDismissKeyboard: core_namespaceObject.z.boolean().optional().describe('Whether to dismiss the keyboard after input. Defaults to true if not specified. Set to false to keep the keyboard visible after input.'),
-                    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" - clear the field without inputting new text.')),
-                    locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The input field to be filled').optional()
-                }),
+                paramSchema: iosInputParamSchema,
+                sample: {
+                    value: 'test@example.com',
+                    locate: {
+                        prompt: 'the email input field'
+                    }
+                },
                 call: async (param)=>{
                     const element = param.locate;
                     if ('typeOnly' !== param.mode) await this.clearInput(element);
@@ -690,6 +697,11 @@ class IOSDevice {
                     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;
                     external_node_assert_default()(element, 'LongPress requires an element to be located');
@@ -1179,6 +1191,10 @@ const createPlatformActions = (device)=>({
             description: 'Execute WebDriverAgent API request directly on iOS device',
             interfaceAlias: 'runWdaRequest',
             paramSchema: runWdaRequestParamSchema,
+            sample: {
+                method: 'GET',
+                endpoint: '/status'
+            },
             call: async (param)=>await device.runWdaRequest(param.method, param.endpoint, param.data)
         }),
         Launch: (0, device_namespaceObject.defineAction)({
@@ -1292,7 +1308,8 @@ class IOSMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
 }
 const tools = new IOSMidsceneTools();
 (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-ios', {
-    stripPrefix: 'ios_'
+    stripPrefix: 'ios_',
+    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

@@ -428,6 +428,16 @@ function _define_property(obj, key, value) {
     return obj;
 }
 const debugDevice = (0, logger_namespaceObject.getDebug)('ios:device');
+const iosInputParamSchema = 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.'),
+    autoDismissKeyboard: core_namespaceObject.z.boolean().optional().describe('Whether to dismiss the keyboard after input. Defaults to true if not specified. Set to false to keep the keyboard visible after input.'),
+    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" - clear the field without inputting new text.')),
+    locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The input field to be filled').optional()
+});
 const WDA_HTTP_METHODS = [
     'GET',
     'POST',
@@ -452,16 +462,13 @@ class IOSDevice {
                 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.'),
-                    autoDismissKeyboard: core_namespaceObject.z.boolean().optional().describe('Whether to dismiss the keyboard after input. Defaults to true if not specified. Set to false to keep the keyboard visible after input.'),
-                    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" - clear the field without inputting new text.')),
-                    locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The input field to be filled').optional()
-                }),
+                paramSchema: iosInputParamSchema,
+                sample: {
+                    value: 'test@example.com',
+                    locate: {
+                        prompt: 'the email input field'
+                    }
+                },
                 call: async (param)=>{
                     const element = param.locate;
                     if ('typeOnly' !== param.mode) await this.clearInput(element);
@@ -523,6 +530,11 @@ class IOSDevice {
                     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;
                     external_node_assert_default()(element, 'LongPress requires an element to be located');
@@ -1012,6 +1024,10 @@ const createPlatformActions = (device)=>({
             description: 'Execute WebDriverAgent API request directly on iOS device',
             interfaceAlias: 'runWdaRequest',
             paramSchema: runWdaRequestParamSchema,
+            sample: {
+                method: 'GET',
+                endpoint: '/status'
+            },
             call: async (param)=>await device.runWdaRequest(param.method, param.endpoint, param.data)
         }),
         Launch: (0, device_namespaceObject.defineAction)({

package/dist/lib/mcp-server.js

@@ -610,6 +610,16 @@ function _define_property(obj, key, value) {
     return obj;
 }
 const debugDevice = (0, logger_namespaceObject.getDebug)('ios:device');
+const iosInputParamSchema = 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.'),
+    autoDismissKeyboard: core_namespaceObject.z.boolean().optional().describe('Whether to dismiss the keyboard after input. Defaults to true if not specified. Set to false to keep the keyboard visible after input.'),
+    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" - clear the field without inputting new text.')),
+    locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The input field to be filled').optional()
+});
 const WDA_HTTP_METHODS = [
     'GET',
     'POST',
@@ -634,16 +644,13 @@ class IOSDevice {
                 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.'),
-                    autoDismissKeyboard: core_namespaceObject.z.boolean().optional().describe('Whether to dismiss the keyboard after input. Defaults to true if not specified. Set to false to keep the keyboard visible after input.'),
-                    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" - clear the field without inputting new text.')),
-                    locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The input field to be filled').optional()
-                }),
+                paramSchema: iosInputParamSchema,
+                sample: {
+                    value: 'test@example.com',
+                    locate: {
+                        prompt: 'the email input field'
+                    }
+                },
                 call: async (param)=>{
                     const element = param.locate;
                     if ('typeOnly' !== param.mode) await this.clearInput(element);
@@ -705,6 +712,11 @@ class IOSDevice {
                     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;
                     external_node_assert_default()(element, 'LongPress requires an element to be located');
@@ -1194,6 +1206,10 @@ const createPlatformActions = (device)=>({
             description: 'Execute WebDriverAgent API request directly on iOS device',
             interfaceAlias: 'runWdaRequest',
             paramSchema: runWdaRequestParamSchema,
+            sample: {
+                method: 'GET',
+                endpoint: '/status'
+            },
             call: async (param)=>await device.runWdaRequest(param.method, param.endpoint, param.data)
         }),
         Launch: (0, device_namespaceObject.defineAction)({
@@ -1312,7 +1328,7 @@ class IOSMCPServer extends mcp_namespaceObject.BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/ios-mcp',
-            version: "1.5.4-beta-20260310030546.0",
+            version: "1.5.4",
             description: 'Control the iOS device using natural language commands'
         }, toolsManager);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/ios",
-  "version": "1.5.4-beta-20260310030546.0",
+  "version": "1.5.4",
   "description": "iOS automation library for Midscene",
   "keywords": [
     "iOS UI automation",
@@ -43,10 +43,10 @@
   "dependencies": {
     "@inquirer/prompts": "^7.8.6",
     "open": "10.1.0",
-    "@midscene/webdriver": "1.5.4-beta-20260310030546.0",
-    "@midscene/playground": "1.5.4-beta-20260310030546.0",
-    "@midscene/shared": "1.5.4-beta-20260310030546.0",
-    "@midscene/core": "1.5.4-beta-20260310030546.0"
+    "@midscene/core": "1.5.4",
+    "@midscene/shared": "1.5.4",
+    "@midscene/webdriver": "1.5.4",
+    "@midscene/playground": "1.5.4"
   },
   "devDependencies": {
     "@rslib/core": "^0.18.3",

package/static/index.html

@@ -1 +1 @@
-<!doctype html><html><head><link rel="icon" href="/favicon.ico"><title>Midscene Playground</title><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><script defer src="/static/js/lib-react.7b1abe58.js"></script><script defer src="/static/js/148.23cd9828.js"></script><script defer src="/static/js/index.5dd18cad.js"></script><link href="/static/css/index.b190a147.css" rel="stylesheet"></head><body><div id="root"></div></body></html>
+<!doctype html><html><head><link rel="icon" href="/favicon.ico"><title>Midscene Playground</title><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><script defer src="/static/js/lib-react.7b1abe58.js"></script><script defer src="/static/js/148.23cd9828.js"></script><script defer src="/static/js/index.1f580227.js"></script><link href="/static/css/index.b190a147.css" rel="stylesheet"></head><body><div id="root"></div></body></html>