@midscene/shared 1.6.3-beta-20260402103943.0 → 1.6.3

package/dist/es/cli/cli-runner.mjs

@@ -89,7 +89,7 @@ function printHelp(scriptName, commands, version) {
     }
     console.log(`\nUsage: ${scriptName} <command> [options]\n`);
     console.log('Commands:');
-    for (const { name, def } of commands)console.log(`  ${name.padEnd(30)} ${def.description}`);
+    for (const { name, def } of commands.filter((command)=>!command.hidden))console.log(`  ${name.padEnd(30)} ${def.description}`);
     console.log(`  ${'version'.padEnd(30)} Show CLI version`);
     console.log(`\nRun "${scriptName} <command> --help" for more info.`);
 }
@@ -105,6 +105,18 @@ async function runToolsCLI(tools, scriptName, options) {
             name: removePrefix(def.name, options?.stripPrefix).toLowerCase(),
             def
         }));
+    if (options?.extraCommands?.length) commands.push(...options.extraCommands.flatMap((cmd)=>[
+            {
+                name: cmd.name.toLowerCase(),
+                def: cmd.def,
+                hidden: cmd.hidden
+            },
+            ...(cmd.aliases ?? []).map((alias)=>({
+                    name: alias.toLowerCase(),
+                    def: cmd.def,
+                    hidden: true
+                }))
+        ]));
     const cliVersion = options?.version;
     const [commandName, ...restArgs] = rawArgs;
     if (!commandName || '--help' === commandName || '-h' === commandName) {

package/dist/lib/cli/cli-runner.js

@@ -131,7 +131,7 @@ function printHelp(scriptName, commands, version) {
     }
     console.log(`\nUsage: ${scriptName} <command> [options]\n`);
     console.log('Commands:');
-    for (const { name, def } of commands)console.log(`  ${name.padEnd(30)} ${def.description}`);
+    for (const { name, def } of commands.filter((command)=>!command.hidden))console.log(`  ${name.padEnd(30)} ${def.description}`);
     console.log(`  ${'version'.padEnd(30)} Show CLI version`);
     console.log(`\nRun "${scriptName} <command> --help" for more info.`);
 }
@@ -147,6 +147,18 @@ async function runToolsCLI(tools, scriptName, options) {
             name: removePrefix(def.name, options?.stripPrefix).toLowerCase(),
             def
         }));
+    if (options?.extraCommands?.length) commands.push(...options.extraCommands.flatMap((cmd)=>[
+            {
+                name: cmd.name.toLowerCase(),
+                def: cmd.def,
+                hidden: cmd.hidden
+            },
+            ...(cmd.aliases ?? []).map((alias)=>({
+                    name: alias.toLowerCase(),
+                    def: cmd.def,
+                    hidden: true
+                }))
+        ]));
     const cliVersion = options?.version;
     const [commandName, ...restArgs] = rawArgs;
     if (!commandName || '--help' === commandName || '-h' === commandName) {

package/dist/types/cli/cli-runner.d.ts

@@ -1,8 +1,16 @@
 import type { BaseMidsceneTools } from '../mcp/base-tools';
+import type { ToolDefinition } from '../mcp/types';
+export interface CLIExtraCommand {
+    name: string;
+    def: ToolDefinition;
+    aliases?: string[];
+    hidden?: boolean;
+}
 export interface CLIRunnerOptions {
     stripPrefix?: string;
     argv?: string[];
     version?: string;
+    extraCommands?: CLIExtraCommand[];
 }
 export declare class CLIError extends Error {
     exitCode: number;

package/dist/types/cli/index.d.ts

@@ -1,2 +1,2 @@
 export { runToolsCLI, CLIError, parseValue, parseCliArgs, removePrefix, } from './cli-runner';
-export type { CLIRunnerOptions } from './cli-runner';
+export type { CLIRunnerOptions, CLIExtraCommand } from './cli-runner';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/shared",
-  "version": "1.6.3-beta-20260402103943.0",
+  "version": "1.6.3",
   "repository": "https://github.com/web-infra-dev/midscene",
   "homepage": "https://midscenejs.com/",
   "types": "./dist/types/index.d.ts",

package/src/cli/cli-runner.ts

@@ -15,12 +15,21 @@ const debug = getDebug('cli-runner');
 interface CLICommand {
   name: string;
   def: ToolDefinition;
+  hidden?: boolean;
+}
+
+export interface CLIExtraCommand {
+  name: string;
+  def: ToolDefinition;
+  aliases?: string[];
+  hidden?: boolean;
 }
 
 export interface CLIRunnerOptions {
   stripPrefix?: string;
   argv?: string[];
   version?: string;
+  extraCommands?: CLIExtraCommand[];
 }
 
 export class CLIError extends Error {
@@ -142,7 +151,7 @@ function printHelp(
   }
   console.log(`\nUsage: ${scriptName} <command> [options]\n`);
   console.log('Commands:');
-  for (const { name, def } of commands) {
+  for (const { name, def } of commands.filter((command) => !command.hidden)) {
     console.log(`  ${name.padEnd(30)} ${def.description}`);
   }
   console.log(`  ${'version'.padEnd(30)} Show CLI version`);
@@ -169,6 +178,22 @@ export async function runToolsCLI(
     name: removePrefix(def.name, options?.stripPrefix).toLowerCase(),
     def,
   }));
+  if (options?.extraCommands?.length) {
+    commands.push(
+      ...options.extraCommands.flatMap((cmd) => [
+        {
+          name: cmd.name.toLowerCase(),
+          def: cmd.def,
+          hidden: cmd.hidden,
+        },
+        ...(cmd.aliases ?? []).map((alias) => ({
+          name: alias.toLowerCase(),
+          def: cmd.def,
+          hidden: true,
+        })),
+      ]),
+    );
+  }
   const cliVersion = options?.version;
 
   const [commandName, ...restArgs] = rawArgs;

package/src/cli/index.ts

@@ -5,4 +5,4 @@ export {
   parseCliArgs,
   removePrefix,
 } from './cli-runner';
-export type { CLIRunnerOptions } from './cli-runner';
+export type { CLIRunnerOptions, CLIExtraCommand } from './cli-runner';