@midscene/harmony 1.12.4-beta-20260904041024.0 → 1.12.4

package/dist/es/bin.mjs

@@ -14,6 +14,8 @@ import { getTmpFile, sleep } from "@midscene/core/utils";
 import { createImgBase64ByFormat } from "@midscene/shared/img";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
+import { createAgentTestRunnerNodeDefinition } from "@midscene/core/agent/test-runner";
+import { z as v4_z } from "zod/v4";
 const defaultAppNameMapping = {
     设置: 'com.huawei.hmos.settings',
     Settings: 'com.huawei.hmos.settings',
@@ -1004,6 +1006,103 @@ const createPlatformActions = (device)=>({
             }
         })
     });
+const defineHarmonyAgentNode = createAgentTestRunnerNodeDefinition('a Harmony Agent');
+const nonBlankText = (description)=>v4_z.string().regex(/\S/, 'value must contain a non-whitespace character').describe(description);
+const launchInputSchema = v4_z.strictObject({
+    uri: nonBlankText('The app, URL, URI, bundle name, or bundle/Ability target to launch.')
+});
+const terminateInputSchema = v4_z.strictObject({
+    uri: nonBlankText('The bundle name or app name to terminate.')
+});
+const runHdcShellInputSchema = v4_z.strictObject({
+    command: nonBlankText('The shell command to execute, without an hdc shell prefix.')
+});
+const emptyInputSchema = v4_z.strictObject({});
+const launchNode = defineHarmonyAgentNode({
+    method: 'launch',
+    description: 'Launch an application through the current Harmony Agent.',
+    stringInputKey: 'uri',
+    inputSchema: launchInputSchema,
+    toArgs: (input)=>[
+            input.uri
+        ],
+    toResult: (_output, input)=>({
+            summary: `Launched ${input.uri}`
+        })
+});
+const terminateNode = defineHarmonyAgentNode({
+    method: 'terminate',
+    description: 'Terminate an application through the current Harmony Agent.',
+    stringInputKey: 'uri',
+    inputSchema: terminateInputSchema,
+    toArgs: (input)=>[
+            input.uri
+        ],
+    toResult: (_output, input)=>({
+            summary: `Terminated ${input.uri}`
+        })
+});
+const runHdcShellNode = defineHarmonyAgentNode({
+    method: 'runHdcShell',
+    title: 'Run an HDC shell command',
+    description: 'Execute a shell command through the current Harmony Agent. Pass only the shell command, without the hdc shell prefix.',
+    stringInputKey: 'command',
+    inputSchema: runHdcShellInputSchema,
+    toArgs (input, context) {
+        context.signal.throwIfAborted();
+        if (/^\s*hdc(?:\s|$)/i.test(input.command)) throw new TypeError('command must not include an hdc or hdc shell prefix.');
+        return [
+            input.command
+        ];
+    },
+    toResult (stdout) {
+        if ('string' != typeof stdout) throw new TypeError('runHdcShell() must return stdout as a string.');
+        return {
+            summary: `Executed HDC shell command (${stdout.length} stdout characters)`,
+            data: {
+                stdout
+            }
+        };
+    }
+});
+const backNode = defineHarmonyAgentNode({
+    method: 'back',
+    description: 'Trigger the Harmony system back operation.',
+    stringInputKey: false,
+    inputSchema: emptyInputSchema,
+    toArgs: ()=>[],
+    toResult: ()=>({
+            summary: 'Triggered Harmony back'
+        })
+});
+const homeNode = defineHarmonyAgentNode({
+    method: 'home',
+    description: 'Trigger the Harmony system home operation.',
+    stringInputKey: false,
+    inputSchema: emptyInputSchema,
+    toArgs: ()=>[],
+    toResult: ()=>({
+            summary: 'Triggered Harmony home'
+        })
+});
+const recentAppsNode = defineHarmonyAgentNode({
+    method: 'recentApps',
+    description: 'Trigger the Harmony system recent apps operation.',
+    stringInputKey: false,
+    inputSchema: emptyInputSchema,
+    toArgs: ()=>[],
+    toResult: ()=>({
+            summary: 'Triggered Harmony recentApps'
+        })
+});
+const harmonyAgentTestRunnerNodeDefinitions = [
+    launchNode,
+    terminateNode,
+    runHdcShellNode,
+    backNode,
+    homeNode,
+    recentAppsNode
+];
 const debugUtils = getDebug('harmony:utils');
 async function utils_getConnectedDevices(hdcPath, options = {}) {
     try {
@@ -1036,6 +1135,12 @@ function agent_define_property(obj, key, value) {
 }
 getDebug('harmony:agent');
 class HarmonyAgent extends Agent {
+    static getTestRunnerNodeDefinitions() {
+        return [
+            ...Agent.getTestRunnerNodeDefinitions(),
+            ...harmonyAgentTestRunnerNodeDefinitions
+        ];
+    }
     async launch(uri) {
         const action = this.wrapActionInActionSpace('Launch');
         return action({

package/dist/es/cli.mjs

@@ -12,6 +12,8 @@ import { getTmpFile, sleep } from "@midscene/core/utils";
 import { createImgBase64ByFormat } from "@midscene/shared/img";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
+import { createAgentTestRunnerNodeDefinition } from "@midscene/core/agent/test-runner";
+import { z as v4_z } from "zod/v4";
 const defaultAppNameMapping = {
     设置: 'com.huawei.hmos.settings',
     Settings: 'com.huawei.hmos.settings',
@@ -1002,6 +1004,103 @@ const createPlatformActions = (device)=>({
             }
         })
     });
+const defineHarmonyAgentNode = createAgentTestRunnerNodeDefinition('a Harmony Agent');
+const nonBlankText = (description)=>v4_z.string().regex(/\S/, 'value must contain a non-whitespace character').describe(description);
+const launchInputSchema = v4_z.strictObject({
+    uri: nonBlankText('The app, URL, URI, bundle name, or bundle/Ability target to launch.')
+});
+const terminateInputSchema = v4_z.strictObject({
+    uri: nonBlankText('The bundle name or app name to terminate.')
+});
+const runHdcShellInputSchema = v4_z.strictObject({
+    command: nonBlankText('The shell command to execute, without an hdc shell prefix.')
+});
+const emptyInputSchema = v4_z.strictObject({});
+const launchNode = defineHarmonyAgentNode({
+    method: 'launch',
+    description: 'Launch an application through the current Harmony Agent.',
+    stringInputKey: 'uri',
+    inputSchema: launchInputSchema,
+    toArgs: (input)=>[
+            input.uri
+        ],
+    toResult: (_output, input)=>({
+            summary: `Launched ${input.uri}`
+        })
+});
+const terminateNode = defineHarmonyAgentNode({
+    method: 'terminate',
+    description: 'Terminate an application through the current Harmony Agent.',
+    stringInputKey: 'uri',
+    inputSchema: terminateInputSchema,
+    toArgs: (input)=>[
+            input.uri
+        ],
+    toResult: (_output, input)=>({
+            summary: `Terminated ${input.uri}`
+        })
+});
+const runHdcShellNode = defineHarmonyAgentNode({
+    method: 'runHdcShell',
+    title: 'Run an HDC shell command',
+    description: 'Execute a shell command through the current Harmony Agent. Pass only the shell command, without the hdc shell prefix.',
+    stringInputKey: 'command',
+    inputSchema: runHdcShellInputSchema,
+    toArgs (input, context) {
+        context.signal.throwIfAborted();
+        if (/^\s*hdc(?:\s|$)/i.test(input.command)) throw new TypeError('command must not include an hdc or hdc shell prefix.');
+        return [
+            input.command
+        ];
+    },
+    toResult (stdout) {
+        if ('string' != typeof stdout) throw new TypeError('runHdcShell() must return stdout as a string.');
+        return {
+            summary: `Executed HDC shell command (${stdout.length} stdout characters)`,
+            data: {
+                stdout
+            }
+        };
+    }
+});
+const backNode = defineHarmonyAgentNode({
+    method: 'back',
+    description: 'Trigger the Harmony system back operation.',
+    stringInputKey: false,
+    inputSchema: emptyInputSchema,
+    toArgs: ()=>[],
+    toResult: ()=>({
+            summary: 'Triggered Harmony back'
+        })
+});
+const homeNode = defineHarmonyAgentNode({
+    method: 'home',
+    description: 'Trigger the Harmony system home operation.',
+    stringInputKey: false,
+    inputSchema: emptyInputSchema,
+    toArgs: ()=>[],
+    toResult: ()=>({
+            summary: 'Triggered Harmony home'
+        })
+});
+const recentAppsNode = defineHarmonyAgentNode({
+    method: 'recentApps',
+    description: 'Trigger the Harmony system recent apps operation.',
+    stringInputKey: false,
+    inputSchema: emptyInputSchema,
+    toArgs: ()=>[],
+    toResult: ()=>({
+            summary: 'Triggered Harmony recentApps'
+        })
+});
+const harmonyAgentTestRunnerNodeDefinitions = [
+    launchNode,
+    terminateNode,
+    runHdcShellNode,
+    backNode,
+    homeNode,
+    recentAppsNode
+];
 const debugUtils = getDebug('harmony:utils');
 async function getConnectedDevices(hdcPath, options = {}) {
     try {
@@ -1034,6 +1133,12 @@ function agent_define_property(obj, key, value) {
 }
 const debugAgent = getDebug('harmony:agent');
 class HarmonyAgent extends Agent {
+    static getTestRunnerNodeDefinitions() {
+        return [
+            ...Agent.getTestRunnerNodeDefinitions(),
+            ...harmonyAgentTestRunnerNodeDefinitions
+        ];
+    }
     async launch(uri) {
         const action = this.wrapActionInActionSpace('Launch');
         return action({
@@ -1187,7 +1292,7 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
 const tools = new HarmonyMidsceneTools();
 runToolsCLI(tools, 'midscene-harmony', {
     stripPrefix: 'harmony_',
-    version: "1.12.4-beta-20260904041024.0",
+    version: "1.12.4",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     process.exit(reportCLIError(e));

package/dist/es/index.mjs

@@ -9,6 +9,8 @@ import { mergeAndNormalizeAppNameMapping, normalizeForComparison, repeat } from
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import { Agent } from "@midscene/core/agent";
+import { createAgentTestRunnerNodeDefinition } from "@midscene/core/agent/test-runner";
+import { z as v4_z } from "zod/v4";
 import { agentBehaviorInitArgShape, extractAgentBehaviorInitArgs, getAgentInitArgsSignature, shouldRebuildAgentForInitArgs } from "@midscene/shared/agent-tools/agent-behavior-init-args";
 import { BaseMidsceneTools } from "@midscene/shared/agent-tools/base-tools";
 import { overrideAIConfig } from "@midscene/shared/env";
@@ -1007,6 +1009,103 @@ const defaultAppNameMapping = {
     百度: 'com.baidu.baiduapp',
     携程: 'com.ctrip.harmonynext'
 };
+const defineHarmonyAgentNode = createAgentTestRunnerNodeDefinition('a Harmony Agent');
+const nonBlankText = (description)=>v4_z.string().regex(/\S/, 'value must contain a non-whitespace character').describe(description);
+const launchInputSchema = v4_z.strictObject({
+    uri: nonBlankText('The app, URL, URI, bundle name, or bundle/Ability target to launch.')
+});
+const terminateInputSchema = v4_z.strictObject({
+    uri: nonBlankText('The bundle name or app name to terminate.')
+});
+const runHdcShellInputSchema = v4_z.strictObject({
+    command: nonBlankText('The shell command to execute, without an hdc shell prefix.')
+});
+const emptyInputSchema = v4_z.strictObject({});
+const launchNode = defineHarmonyAgentNode({
+    method: 'launch',
+    description: 'Launch an application through the current Harmony Agent.',
+    stringInputKey: 'uri',
+    inputSchema: launchInputSchema,
+    toArgs: (input)=>[
+            input.uri
+        ],
+    toResult: (_output, input)=>({
+            summary: `Launched ${input.uri}`
+        })
+});
+const terminateNode = defineHarmonyAgentNode({
+    method: 'terminate',
+    description: 'Terminate an application through the current Harmony Agent.',
+    stringInputKey: 'uri',
+    inputSchema: terminateInputSchema,
+    toArgs: (input)=>[
+            input.uri
+        ],
+    toResult: (_output, input)=>({
+            summary: `Terminated ${input.uri}`
+        })
+});
+const runHdcShellNode = defineHarmonyAgentNode({
+    method: 'runHdcShell',
+    title: 'Run an HDC shell command',
+    description: 'Execute a shell command through the current Harmony Agent. Pass only the shell command, without the hdc shell prefix.',
+    stringInputKey: 'command',
+    inputSchema: runHdcShellInputSchema,
+    toArgs (input, context) {
+        context.signal.throwIfAborted();
+        if (/^\s*hdc(?:\s|$)/i.test(input.command)) throw new TypeError('command must not include an hdc or hdc shell prefix.');
+        return [
+            input.command
+        ];
+    },
+    toResult (stdout) {
+        if ('string' != typeof stdout) throw new TypeError('runHdcShell() must return stdout as a string.');
+        return {
+            summary: `Executed HDC shell command (${stdout.length} stdout characters)`,
+            data: {
+                stdout
+            }
+        };
+    }
+});
+const backNode = defineHarmonyAgentNode({
+    method: 'back',
+    description: 'Trigger the Harmony system back operation.',
+    stringInputKey: false,
+    inputSchema: emptyInputSchema,
+    toArgs: ()=>[],
+    toResult: ()=>({
+            summary: 'Triggered Harmony back'
+        })
+});
+const homeNode = defineHarmonyAgentNode({
+    method: 'home',
+    description: 'Trigger the Harmony system home operation.',
+    stringInputKey: false,
+    inputSchema: emptyInputSchema,
+    toArgs: ()=>[],
+    toResult: ()=>({
+            summary: 'Triggered Harmony home'
+        })
+});
+const recentAppsNode = defineHarmonyAgentNode({
+    method: 'recentApps',
+    description: 'Trigger the Harmony system recent apps operation.',
+    stringInputKey: false,
+    inputSchema: emptyInputSchema,
+    toArgs: ()=>[],
+    toResult: ()=>({
+            summary: 'Triggered Harmony recentApps'
+        })
+});
+const harmonyAgentTestRunnerNodeDefinitions = [
+    launchNode,
+    terminateNode,
+    runHdcShellNode,
+    backNode,
+    homeNode,
+    recentAppsNode
+];
 const debugUtils = getDebug('harmony:utils');
 async function getConnectedDevices(hdcPath, options = {}) {
     try {
@@ -1039,6 +1138,12 @@ function agent_define_property(obj, key, value) {
 }
 const debugAgent = getDebug('harmony:agent');
 class HarmonyAgent extends Agent {
+    static getTestRunnerNodeDefinitions() {
+        return [
+            ...Agent.getTestRunnerNodeDefinitions(),
+            ...harmonyAgentTestRunnerNodeDefinitions
+        ];
+    }
     async launch(uri) {
         const action = this.wrapActionInActionSpace('Launch');
         return action({
@@ -1367,4 +1472,4 @@ const harmonyPlaygroundPlatform = definePlaygroundPlatform({
         };
     }
 });
-export { HarmonyAgent, HarmonyDevice, HarmonyMidsceneTools, agentFromHdcDevice, getConnectedDevices, harmonyPlaygroundPlatform, overrideAIConfig };
+export { HarmonyAgent, HarmonyDevice, HarmonyMidsceneTools, agentFromHdcDevice, getConnectedDevices, harmonyAgentTestRunnerNodeDefinitions, harmonyPlaygroundPlatform, launchInputSchema, overrideAIConfig, runHdcShellInputSchema, terminateInputSchema };

package/dist/es/test-runner.mjs

@@ -0,0 +1,100 @@
+import { createAgentTestRunnerNodeDefinition } from "@midscene/core/agent/test-runner";
+import { z } from "zod/v4";
+const defineHarmonyAgentNode = createAgentTestRunnerNodeDefinition('a Harmony Agent');
+const nonBlankText = (description)=>z.string().regex(/\S/, 'value must contain a non-whitespace character').describe(description);
+const launchInputSchema = z.strictObject({
+    uri: nonBlankText('The app, URL, URI, bundle name, or bundle/Ability target to launch.')
+});
+const terminateInputSchema = z.strictObject({
+    uri: nonBlankText('The bundle name or app name to terminate.')
+});
+const runHdcShellInputSchema = z.strictObject({
+    command: nonBlankText('The shell command to execute, without an hdc shell prefix.')
+});
+const emptyInputSchema = z.strictObject({});
+const launchNode = defineHarmonyAgentNode({
+    method: 'launch',
+    description: 'Launch an application through the current Harmony Agent.',
+    stringInputKey: 'uri',
+    inputSchema: launchInputSchema,
+    toArgs: (input)=>[
+            input.uri
+        ],
+    toResult: (_output, input)=>({
+            summary: `Launched ${input.uri}`
+        })
+});
+const terminateNode = defineHarmonyAgentNode({
+    method: 'terminate',
+    description: 'Terminate an application through the current Harmony Agent.',
+    stringInputKey: 'uri',
+    inputSchema: terminateInputSchema,
+    toArgs: (input)=>[
+            input.uri
+        ],
+    toResult: (_output, input)=>({
+            summary: `Terminated ${input.uri}`
+        })
+});
+const runHdcShellNode = defineHarmonyAgentNode({
+    method: 'runHdcShell',
+    title: 'Run an HDC shell command',
+    description: 'Execute a shell command through the current Harmony Agent. Pass only the shell command, without the hdc shell prefix.',
+    stringInputKey: 'command',
+    inputSchema: runHdcShellInputSchema,
+    toArgs (input, context) {
+        context.signal.throwIfAborted();
+        if (/^\s*hdc(?:\s|$)/i.test(input.command)) throw new TypeError('command must not include an hdc or hdc shell prefix.');
+        return [
+            input.command
+        ];
+    },
+    toResult (stdout) {
+        if ('string' != typeof stdout) throw new TypeError('runHdcShell() must return stdout as a string.');
+        return {
+            summary: `Executed HDC shell command (${stdout.length} stdout characters)`,
+            data: {
+                stdout
+            }
+        };
+    }
+});
+const backNode = defineHarmonyAgentNode({
+    method: 'back',
+    description: 'Trigger the Harmony system back operation.',
+    stringInputKey: false,
+    inputSchema: emptyInputSchema,
+    toArgs: ()=>[],
+    toResult: ()=>({
+            summary: 'Triggered Harmony back'
+        })
+});
+const homeNode = defineHarmonyAgentNode({
+    method: 'home',
+    description: 'Trigger the Harmony system home operation.',
+    stringInputKey: false,
+    inputSchema: emptyInputSchema,
+    toArgs: ()=>[],
+    toResult: ()=>({
+            summary: 'Triggered Harmony home'
+        })
+});
+const recentAppsNode = defineHarmonyAgentNode({
+    method: 'recentApps',
+    description: 'Trigger the Harmony system recent apps operation.',
+    stringInputKey: false,
+    inputSchema: emptyInputSchema,
+    toArgs: ()=>[],
+    toResult: ()=>({
+            summary: 'Triggered Harmony recentApps'
+        })
+});
+const harmonyAgentTestRunnerNodeDefinitions = [
+    launchNode,
+    terminateNode,
+    runHdcShellNode,
+    backNode,
+    homeNode,
+    recentAppsNode
+];
+export { harmonyAgentTestRunnerNodeDefinitions, launchInputSchema, runHdcShellInputSchema, terminateInputSchema };