uloop-cli 0.68.1 → 0.68.3

package/dist/cli.bundle.cjs

@@ -795,7 +795,7 @@ ${itemIndentStr}`);
 var require_option = __commonJS({
   "node_modules/commander/lib/option.js"(exports2) {
     var { InvalidArgumentError: InvalidArgumentError2 } = require_error();
-    var Option2 = class {
+    var Option3 = class {
       /**
        * Initialize a new `Option` with the given `flags` and `description`.
        *
@@ -1099,7 +1099,7 @@ var require_option = __commonJS({
         );
       return { shortFlag, longFlag };
     }
-    exports2.Option = Option2;
+    exports2.Option = Option3;
     exports2.DualOptions = DualOptions;
   }
 });
@@ -1195,7 +1195,7 @@ var require_command = __commonJS({
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
     var { Help: Help2, stripColor } = require_help();
-    var { Option: Option2, DualOptions } = require_option();
+    var { Option: Option3, DualOptions } = require_option();
     var { suggestSimilar } = require_suggestSimilar();
     var Command2 = class _Command extends EventEmitter {
       /**
@@ -1680,7 +1680,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Option} new option
        */
       createOption(flags, description) {
-        return new Option2(flags, description);
+        return new Option3(flags, description);
       }
       /**
        * Wrap parseArgs to catch 'commander.invalidArgument'.
@@ -1805,7 +1805,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @private
        */
       _optionEx(config, flags, description, fn, defaultValue) {
-        if (typeof flags === "object" && flags instanceof Option2) {
+        if (typeof flags === "object" && flags instanceof Option3) {
           throw new Error(
             "To add an Option object use addOption() instead of option() or requiredOption()"
           );
@@ -3437,13 +3437,13 @@ var require_commander = __commonJS({
     var { Command: Command2 } = require_command();
     var { CommanderError: CommanderError2, InvalidArgumentError: InvalidArgumentError2 } = require_error();
     var { Help: Help2 } = require_help();
-    var { Option: Option2 } = require_option();
+    var { Option: Option3 } = require_option();
     exports2.program = new Command2();
     exports2.createCommand = (name) => new Command2(name);
-    exports2.createOption = (flags, description) => new Option2(flags, description);
+    exports2.createOption = (flags, description) => new Option3(flags, description);
     exports2.createArgument = (name, description) => new Argument2(name, description);
     exports2.Command = Command2;
-    exports2.Option = Option2;
+    exports2.Option = Option3;
     exports2.Argument = Argument2;
     exports2.Help = Help2;
     exports2.CommanderError = CommanderError2;
@@ -5824,7 +5824,7 @@ var import_path3 = require("path");
 
 // src/default-tools.json
 var default_tools_default = {
-  version: "0.68.1",
+  version: "0.68.3",
   tools: [
     {
       name: "compile",
@@ -6064,6 +6064,34 @@ var default_tools_default = {
         }
       }
     },
+    {
+      name: "get-unity-search-providers",
+      description: "Get detailed information about Unity Search providers including display names, descriptions, active status, and capabilities",
+      inputSchema: {
+        type: "object",
+        properties: {
+          ProviderId: {
+            type: "string",
+            description: "Specific provider ID to get details for (empty = all providers). Examples: 'asset', 'scene', 'menu', 'settings'"
+          },
+          ActiveOnly: {
+            type: "boolean",
+            description: "Whether to include only active providers",
+            default: false
+          },
+          SortByPriority: {
+            type: "boolean",
+            description: "Sort providers by priority (lower number = higher priority)",
+            default: true
+          },
+          IncludeDescriptions: {
+            type: "boolean",
+            description: "Include detailed descriptions for each provider",
+            default: true
+          }
+        }
+      }
+    },
     {
       name: "get-menu-items",
       description: "Retrieve Unity MenuItems",
@@ -6263,21 +6291,24 @@ var default_tools_default = {
 // src/tool-cache.ts
 var CACHE_DIR = ".uloop";
 var CACHE_FILE = "tools.json";
-function getCacheDir() {
+function getCacheDir(projectPath) {
+  if (projectPath !== void 0) {
+    return (0, import_path3.join)(projectPath, CACHE_DIR);
+  }
   const projectRoot = findUnityProjectRoot();
   if (projectRoot === null) {
     return (0, import_path3.join)(process.cwd(), CACHE_DIR);
   }
   return (0, import_path3.join)(projectRoot, CACHE_DIR);
 }
-function getCachePath() {
-  return (0, import_path3.join)(getCacheDir(), CACHE_FILE);
+function getCachePath(projectPath) {
+  return (0, import_path3.join)(getCacheDir(projectPath), CACHE_FILE);
 }
 function getDefaultTools() {
   return default_tools_default;
 }
-function loadToolsCache() {
-  const cachePath = getCachePath();
+function loadToolsCache(projectPath) {
+  const cachePath = getCachePath(projectPath);
   if ((0, import_fs3.existsSync)(cachePath)) {
     try {
       const content = (0, import_fs3.readFileSync)(cachePath, "utf-8");
@@ -6303,6 +6334,10 @@ function hasCacheFile() {
 function getCacheFilePath() {
   return getCachePath();
 }
+function getDefaultToolNames() {
+  const defaultTools = getDefaultTools();
+  return new Set(defaultTools.tools.map((tool) => tool.name));
+}
 function getCachedServerVersion() {
   const cachePath = getCachePath();
   if (!(0, import_fs3.existsSync)(cachePath)) {
@@ -6318,7 +6353,7 @@ function getCachedServerVersion() {
 }
 
 // src/version.ts
-var VERSION = "0.68.1";
+var VERSION = "0.68.3";
 
 // src/spinner.ts
 var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
@@ -6916,7 +6951,7 @@ var DEPRECATED_SKILLS = [
   "uloop-capture-window",
   // renamed to uloop-screenshot in v0.54.0
   "uloop-get-provider-details"
-  // internal development-only tool, not for end users
+  // renamed to uloop-get-unity-search-providers
 ];
 
 // src/tool-settings-loader.ts
@@ -8703,8 +8738,12 @@ async function runLaunchCommand(projectPath, options) {
 }
 
 // src/commands/focus-window.ts
-function registerFocusWindowCommand(program3) {
-  program3.command("focus-window").description("Bring Unity Editor window to front using OS-level commands").option("--project-path <path>", "Unity project path").action(async (options) => {
+function registerFocusWindowCommand(program3, helpGroup) {
+  const cmd = program3.command("focus-window").description("Bring Unity Editor window to front using OS-level commands").option("--project-path <path>", "Unity project path");
+  if (helpGroup !== void 0) {
+    cmd.helpGroup(helpGroup);
+  }
+  cmd.action(async (options) => {
     let projectRoot;
     if (options.projectPath !== void 0) {
       try {
@@ -8762,8 +8801,17 @@ function registerFocusWindowCommand(program3) {
 }
 
 // src/cli.ts
+var FOCUS_WINDOW_COMMAND = "focus-window";
 var LAUNCH_COMMAND = "launch";
 var UPDATE_COMMAND = "update";
+var HELP_GROUP_BUILTIN_TOOLS = "Built-in Tools:";
+var HELP_GROUP_THIRD_PARTY_TOOLS = "Third-party Tools:";
+var HELP_GROUP_CLI_COMMANDS = "CLI Commands:";
+var HELP_GROUP_ORDER = [
+  HELP_GROUP_CLI_COMMANDS,
+  HELP_GROUP_BUILTIN_TOOLS,
+  HELP_GROUP_THIRD_PARTY_TOOLS
+];
 var NO_SYNC_FLAGS = ["-v", "--version", "-h", "--help"];
 var BUILTIN_COMMANDS = [
   "list",
@@ -8773,12 +8821,47 @@ var BUILTIN_COMMANDS = [
   "fix",
   "skills",
   LAUNCH_COMMAND,
-  "focus-window"
+  FOCUS_WINDOW_COMMAND
 ];
 var program2 = new Command();
-program2.name("uloop").description("Unity MCP CLI - Direct communication with Unity Editor").version(VERSION, "-v, --version", "Output the version number").showHelpAfterError("(run with -h for available options)");
+program2.name("uloop").description("Unity MCP CLI - Direct communication with Unity Editor").version(VERSION, "-v, --version", "Output the version number").showHelpAfterError("(run with -h for available options)").configureHelp({
+  sortSubcommands: true,
+  // commander.js default groupItems determines group display order by registration order,
+  // but CLI commands are registered at module level (before tools), so the default order
+  // would be wrong. We re-implement to enforce HELP_GROUP_ORDER.
+  groupItems(unsortedItems, visibleItems, getGroup) {
+    const groupMap = /* @__PURE__ */ new Map();
+    for (const item of unsortedItems) {
+      const group = getGroup(item);
+      if (!groupMap.has(group)) {
+        groupMap.set(group, []);
+      }
+    }
+    for (const item of visibleItems) {
+      const group = getGroup(item);
+      if (!groupMap.has(group)) {
+        groupMap.set(group, []);
+      }
+      groupMap.get(group).push(item);
+    }
+    const ordered = /* @__PURE__ */ new Map();
+    for (const key of HELP_GROUP_ORDER) {
+      const items = groupMap.get(key);
+      if (items !== void 0) {
+        ordered.set(key, items);
+        groupMap.delete(key);
+      }
+    }
+    for (const [key, value] of groupMap) {
+      ordered.set(key, value);
+    }
+    return ordered;
+  }
+});
 program2.option("--list-commands", "List all command names (for shell completion)");
 program2.option("--list-options <cmd>", "List options for a command (for shell completion)");
+program2.commandsGroup(HELP_GROUP_CLI_COMMANDS);
+program2.helpCommand(true);
 program2.command("list").description("List all available tools from Unity").option("-p, --port <port>", "Unity TCP port").option("--project-path <path>", "Unity project path").action(async (options) => {
   await runWithErrorHandling(() => listAvailableTools(extractGlobalOptions(options)));
 });
@@ -8799,12 +8882,12 @@ program2.command("fix").description("Clean up stale lock files that may prevent
 });
 registerSkillsCommand(program2);
 registerLaunchCommand(program2);
-registerFocusWindowCommand(program2);
-function registerToolCommand(tool) {
+function registerToolCommand(tool, helpGroup) {
   if (BUILTIN_COMMANDS.includes(tool.name)) {
     return;
   }
-  const cmd = program2.command(tool.name).description(tool.description);
+  const firstLine = tool.description.split("\n")[0];
+  const cmd = program2.command(tool.name).description(firstLine).helpGroup(helpGroup);
   const properties = tool.inputSchema.properties;
   for (const [propName, propInfo] of Object.entries(properties)) {
     const optionStr = generateOptionString(propName, propInfo);
@@ -8923,6 +9006,9 @@ function convertValue(value, propInfo) {
   }
   return value;
 }
+function getToolHelpGroup(toolName, defaultToolNames) {
+  return defaultToolNames.has(toolName) ? HELP_GROUP_BUILTIN_TOOLS : HELP_GROUP_THIRD_PARTY_TOOLS;
+}
 function extractGlobalOptions(options) {
   return {
     port: options["port"],
@@ -9253,9 +9339,14 @@ function handleCompletionOptions() {
   const projectPath = extractSyncGlobalOptions(args).projectPath;
   if (args.includes("--list-commands")) {
     const tools = loadToolsCache();
-    const enabledTools = projectPath !== void 0 ? filterEnabledTools(tools.tools, projectPath) : tools.tools;
-    const allCommands = [...BUILTIN_COMMANDS, ...enabledTools.map((t) => t.name)];
-    console.log(allCommands.join("\n"));
+    const enabledTools = filterEnabledTools(tools.tools, projectPath);
+    const allCommands = [
+      ...BUILTIN_COMMANDS.filter(
+        (cmd) => cmd !== FOCUS_WINDOW_COMMAND || isToolEnabled(cmd, projectPath)
+      ),
+      ...enabledTools.map((t) => t.name)
+    ];
+    console.log(allCommands.sort().join("\n"));
     return true;
   }
   const listOptionsIdx = args.indexOf("--list-options");
@@ -9271,7 +9362,9 @@ function listOptionsForCommand(cmdName, projectPath) {
     return;
   }
   const tools = loadToolsCache();
-  const tool = projectPath !== void 0 ? filterEnabledTools(tools.tools, projectPath).find((t) => t.name === cmdName) : tools.tools.find((t) => t.name === cmdName);
+  const tool = filterEnabledTools(tools.tools, projectPath).find(
+    (t) => t.name === cmdName
+  );
   if (!tool) {
     return;
   }
@@ -9283,6 +9376,9 @@ function listOptionsForCommand(cmdName, projectPath) {
   console.log(options.join("\n"));
 }
 function commandExists(cmdName, projectPath) {
+  if (cmdName === FOCUS_WINDOW_COMMAND) {
+    return isToolEnabled(FOCUS_WINDOW_COMMAND, projectPath);
+  }
   if (BUILTIN_COMMANDS.includes(cmdName)) {
     return true;
   }
@@ -9295,6 +9391,20 @@ function shouldSkipAutoSync(cmdName, args) {
   }
   return args.some((arg) => NO_SYNC_FLAGS.includes(arg));
 }
+var OPTIONS_WITH_VALUE = /* @__PURE__ */ new Set(["--port", "-p", "--project-path"]);
+function findCommandName(args) {
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg.startsWith("-")) {
+      if (OPTIONS_WITH_VALUE.has(arg)) {
+        i++;
+      }
+      continue;
+    }
+    return arg;
+  }
+  return void 0;
+}
 function extractSyncGlobalOptions(args) {
   const options = {};
   for (let i = 0; i < args.length; i++) {
@@ -9329,15 +9439,21 @@ async function main() {
     return;
   }
   const args = process.argv.slice(2);
-  const cmdName = args.find((arg) => !arg.startsWith("-"));
   const syncGlobalOptions = extractSyncGlobalOptions(args);
+  const cmdName = findCommandName(args);
   const NO_PROJECT_COMMANDS = [UPDATE_COMMAND, "completion"];
   const skipProjectDetection = cmdName === void 0 || NO_PROJECT_COMMANDS.includes(cmdName);
   if (skipProjectDetection) {
-    const defaultTools = getDefaultTools();
-    const tools = syncGlobalOptions.projectPath !== void 0 ? filterEnabledTools(defaultTools.tools, syncGlobalOptions.projectPath) : defaultTools.tools;
+    const defaultToolNames2 = getDefaultToolNames();
+    const isTopLevelHelp = cmdName === void 0 && (args.includes("-h") || args.includes("--help"));
+    const shouldFilter = syncGlobalOptions.projectPath !== void 0 || isTopLevelHelp;
+    const sourceTools = shouldFilter ? loadToolsCache(syncGlobalOptions.projectPath).tools : getDefaultTools().tools;
+    const tools = shouldFilter ? filterEnabledTools(sourceTools, syncGlobalOptions.projectPath) : sourceTools;
+    if (!shouldFilter || isToolEnabled(FOCUS_WINDOW_COMMAND, syncGlobalOptions.projectPath)) {
+      registerFocusWindowCommand(program2, HELP_GROUP_BUILTIN_TOOLS);
+    }
     for (const tool of tools) {
-      registerToolCommand(tool);
+      registerToolCommand(tool, getToolHelpGroup(tool.name, defaultToolNames2));
     }
     program2.parse();
     return;
@@ -9366,8 +9482,12 @@ async function main() {
   }
   const toolsCache = loadToolsCache();
   const projectPath = syncGlobalOptions.projectPath;
+  const defaultToolNames = getDefaultToolNames();
+  if (isToolEnabled(FOCUS_WINDOW_COMMAND, projectPath)) {
+    registerFocusWindowCommand(program2, HELP_GROUP_BUILTIN_TOOLS);
+  }
   for (const tool of filterEnabledTools(toolsCache.tools, projectPath)) {
-    registerToolCommand(tool);
+    registerToolCommand(tool, getToolHelpGroup(tool.name, defaultToolNames));
   }
   if (cmdName && !commandExists(cmdName, projectPath)) {
     if (!isToolEnabled(cmdName, projectPath)) {
@@ -9380,7 +9500,7 @@ async function main() {
       const newCache = loadToolsCache();
       const tool = filterEnabledTools(newCache.tools, projectPath).find((t) => t.name === cmdName);
       if (tool) {
-        registerToolCommand(tool);
+        registerToolCommand(tool, getToolHelpGroup(tool.name, defaultToolNames));
         console.log(`\x1B[32m\u2713 Found '${cmdName}' after sync.\x1B[0m
 `);
       } else {