@settlemint/sdk-mcp 1.2.2-prc6ef5d96 → 1.2.2-prd7c032b8

package/dist/mcp.js

@@ -37543,18 +37543,18 @@ var require_help = __commonJS((exports) => {
   class Help {
     constructor() {
       this.helpWidth = undefined;
+      this.minWidthToWrap = 40;
       this.sortSubcommands = false;
       this.sortOptions = false;
       this.showGlobalOptions = false;
     }
+    prepareContext(contextOptions) {
+      this.helpWidth = this.helpWidth ?? contextOptions.helpWidth ?? 80;
+    }
     visibleCommands(cmd) {
       const visibleCommands = cmd.commands.filter((cmd2) => !cmd2._hidden);
-      if (cmd._hasImplicitHelpCommand()) {
-        const [, helpName, helpArgs] = cmd._helpCommandnameAndArgs.match(/([^ ]+) *(.*)/);
-        const helpCommand = cmd.createCommand(helpName).helpOption(false);
-        helpCommand.description(cmd._helpCommandDescription);
-        if (helpArgs)
-          helpCommand.arguments(helpArgs);
+      const helpCommand = cmd._getHelpCommand();
+      if (helpCommand && !helpCommand._hidden) {
         visibleCommands.push(helpCommand);
       }
       if (this.sortSubcommands) {
@@ -37572,18 +37572,17 @@ var require_help = __commonJS((exports) => {
     }
     visibleOptions(cmd) {
       const visibleOptions = cmd.options.filter((option) => !option.hidden);
-      const showShortHelpFlag = cmd._hasHelpOption && cmd._helpShortFlag && !cmd._findOption(cmd._helpShortFlag);
-      const showLongHelpFlag = cmd._hasHelpOption && !cmd._findOption(cmd._helpLongFlag);
-      if (showShortHelpFlag || showLongHelpFlag) {
-        let helpOption;
-        if (!showShortHelpFlag) {
-          helpOption = cmd.createOption(cmd._helpLongFlag, cmd._helpDescription);
-        } else if (!showLongHelpFlag) {
-          helpOption = cmd.createOption(cmd._helpShortFlag, cmd._helpDescription);
-        } else {
-          helpOption = cmd.createOption(cmd._helpFlags, cmd._helpDescription);
+      const helpOption = cmd._getHelpOption();
+      if (helpOption && !helpOption.hidden) {
+        const removeShort = helpOption.short && cmd._findOption(helpOption.short);
+        const removeLong = helpOption.long && cmd._findOption(helpOption.long);
+        if (!removeShort && !removeLong) {
+          visibleOptions.push(helpOption);
+        } else if (helpOption.long && !removeLong) {
+          visibleOptions.push(cmd.createOption(helpOption.long, helpOption.description));
+        } else if (helpOption.short && !removeShort) {
+          visibleOptions.push(cmd.createOption(helpOption.short, helpOption.description));
         }
-        visibleOptions.push(helpOption);
       }
       if (this.sortOptions) {
         visibleOptions.sort(this.compareOptions);
@@ -37626,22 +37625,22 @@ var require_help = __commonJS((exports) => {
     }
     longestSubcommandTermLength(cmd, helper) {
       return helper.visibleCommands(cmd).reduce((max, command) => {
-        return Math.max(max, helper.subcommandTerm(command).length);
+        return Math.max(max, this.displayWidth(helper.styleSubcommandTerm(helper.subcommandTerm(command))));
       }, 0);
     }
     longestOptionTermLength(cmd, helper) {
       return helper.visibleOptions(cmd).reduce((max, option) => {
-        return Math.max(max, helper.optionTerm(option).length);
+        return Math.max(max, this.displayWidth(helper.styleOptionTerm(helper.optionTerm(option))));
       }, 0);
     }
     longestGlobalOptionTermLength(cmd, helper) {
       return helper.visibleGlobalOptions(cmd).reduce((max, option) => {
-        return Math.max(max, helper.optionTerm(option).length);
+        return Math.max(max, this.displayWidth(helper.styleOptionTerm(helper.optionTerm(option))));
       }, 0);
     }
     longestArgumentTermLength(cmd, helper) {
       return helper.visibleArguments(cmd).reduce((max, argument) => {
-        return Math.max(max, helper.argumentTerm(argument).length);
+        return Math.max(max, this.displayWidth(helper.styleArgumentTerm(helper.argumentTerm(argument))));
       }, 0);
     }
     commandUsage(cmd) {
@@ -37692,95 +37691,199 @@ var require_help = __commonJS((exports) => {
         extraInfo.push(`default: ${argument.defaultValueDescription || JSON.stringify(argument.defaultValue)}`);
       }
       if (extraInfo.length > 0) {
-        const extraDescripton = `(${extraInfo.join(", ")})`;
+        const extraDescription = `(${extraInfo.join(", ")})`;
         if (argument.description) {
-          return `${argument.description} ${extraDescripton}`;
+          return `${argument.description} ${extraDescription}`;
         }
-        return extraDescripton;
+        return extraDescription;
       }
       return argument.description;
     }
     formatHelp(cmd, helper) {
       const termWidth = helper.padWidth(cmd, helper);
-      const helpWidth = helper.helpWidth || 80;
-      const itemIndentWidth = 2;
-      const itemSeparatorWidth = 2;
-      function formatItem(term, description) {
-        if (description) {
-          const fullText = `${term.padEnd(termWidth + itemSeparatorWidth)}${description}`;
-          return helper.wrap(fullText, helpWidth - itemIndentWidth, termWidth + itemSeparatorWidth);
-        }
-        return term;
-      }
-      function formatList(textArray) {
-        return textArray.join(`
-`).replace(/^/gm, " ".repeat(itemIndentWidth));
+      const helpWidth = helper.helpWidth ?? 80;
+      function callFormatItem(term, description) {
+        return helper.formatItem(term, termWidth, description, helper);
       }
-      let output = [`Usage: ${helper.commandUsage(cmd)}`, ""];
+      let output = [
+        `${helper.styleTitle("Usage:")} ${helper.styleUsage(helper.commandUsage(cmd))}`,
+        ""
+      ];
       const commandDescription = helper.commandDescription(cmd);
       if (commandDescription.length > 0) {
-        output = output.concat([helper.wrap(commandDescription, helpWidth, 0), ""]);
+        output = output.concat([
+          helper.boxWrap(helper.styleCommandDescription(commandDescription), helpWidth),
+          ""
+        ]);
       }
       const argumentList = helper.visibleArguments(cmd).map((argument) => {
-        return formatItem(helper.argumentTerm(argument), helper.argumentDescription(argument));
+        return callFormatItem(helper.styleArgumentTerm(helper.argumentTerm(argument)), helper.styleArgumentDescription(helper.argumentDescription(argument)));
       });
       if (argumentList.length > 0) {
-        output = output.concat(["Arguments:", formatList(argumentList), ""]);
+        output = output.concat([
+          helper.styleTitle("Arguments:"),
+          ...argumentList,
+          ""
+        ]);
       }
       const optionList = helper.visibleOptions(cmd).map((option) => {
-        return formatItem(helper.optionTerm(option), helper.optionDescription(option));
+        return callFormatItem(helper.styleOptionTerm(helper.optionTerm(option)), helper.styleOptionDescription(helper.optionDescription(option)));
       });
       if (optionList.length > 0) {
-        output = output.concat(["Options:", formatList(optionList), ""]);
+        output = output.concat([
+          helper.styleTitle("Options:"),
+          ...optionList,
+          ""
+        ]);
       }
-      if (this.showGlobalOptions) {
+      if (helper.showGlobalOptions) {
         const globalOptionList = helper.visibleGlobalOptions(cmd).map((option) => {
-          return formatItem(helper.optionTerm(option), helper.optionDescription(option));
+          return callFormatItem(helper.styleOptionTerm(helper.optionTerm(option)), helper.styleOptionDescription(helper.optionDescription(option)));
         });
         if (globalOptionList.length > 0) {
-          output = output.concat(["Global Options:", formatList(globalOptionList), ""]);
+          output = output.concat([
+            helper.styleTitle("Global Options:"),
+            ...globalOptionList,
+            ""
+          ]);
         }
       }
       const commandList = helper.visibleCommands(cmd).map((cmd2) => {
-        return formatItem(helper.subcommandTerm(cmd2), helper.subcommandDescription(cmd2));
+        return callFormatItem(helper.styleSubcommandTerm(helper.subcommandTerm(cmd2)), helper.styleSubcommandDescription(helper.subcommandDescription(cmd2)));
       });
       if (commandList.length > 0) {
-        output = output.concat(["Commands:", formatList(commandList), ""]);
+        output = output.concat([
+          helper.styleTitle("Commands:"),
+          ...commandList,
+          ""
+        ]);
       }
       return output.join(`
 `);
     }
+    displayWidth(str) {
+      return stripColor(str).length;
+    }
+    styleTitle(str) {
+      return str;
+    }
+    styleUsage(str) {
+      return str.split(" ").map((word) => {
+        if (word === "[options]")
+          return this.styleOptionText(word);
+        if (word === "[command]")
+          return this.styleSubcommandText(word);
+        if (word[0] === "[" || word[0] === "<")
+          return this.styleArgumentText(word);
+        return this.styleCommandText(word);
+      }).join(" ");
+    }
+    styleCommandDescription(str) {
+      return this.styleDescriptionText(str);
+    }
+    styleOptionDescription(str) {
+      return this.styleDescriptionText(str);
+    }
+    styleSubcommandDescription(str) {
+      return this.styleDescriptionText(str);
+    }
+    styleArgumentDescription(str) {
+      return this.styleDescriptionText(str);
+    }
+    styleDescriptionText(str) {
+      return str;
+    }
+    styleOptionTerm(str) {
+      return this.styleOptionText(str);
+    }
+    styleSubcommandTerm(str) {
+      return str.split(" ").map((word) => {
+        if (word === "[options]")
+          return this.styleOptionText(word);
+        if (word[0] === "[" || word[0] === "<")
+          return this.styleArgumentText(word);
+        return this.styleSubcommandText(word);
+      }).join(" ");
+    }
+    styleArgumentTerm(str) {
+      return this.styleArgumentText(str);
+    }
+    styleOptionText(str) {
+      return str;
+    }
+    styleArgumentText(str) {
+      return str;
+    }
+    styleSubcommandText(str) {
+      return str;
+    }
+    styleCommandText(str) {
+      return str;
+    }
     padWidth(cmd, helper) {
       return Math.max(helper.longestOptionTermLength(cmd, helper), helper.longestGlobalOptionTermLength(cmd, helper), helper.longestSubcommandTermLength(cmd, helper), helper.longestArgumentTermLength(cmd, helper));
     }
-    wrap(str, width, indent2, minColumnWidth = 40) {
-      const indents = " \\f\\t\\v   -   　\uFEFF";
-      const manualIndent = new RegExp(`[\\n][${indents}]+`);
-      if (str.match(manualIndent))
-        return str;
-      const columnWidth = width - indent2;
-      if (columnWidth < minColumnWidth)
+    preformatted(str) {
+      return /\n[^\S\r\n]/.test(str);
+    }
+    formatItem(term, termWidth, description, helper) {
+      const itemIndent = 2;
+      const itemIndentStr = " ".repeat(itemIndent);
+      if (!description)
+        return itemIndentStr + term;
+      const paddedTerm = term.padEnd(termWidth + term.length - helper.displayWidth(term));
+      const spacerWidth = 2;
+      const helpWidth = this.helpWidth ?? 80;
+      const remainingWidth = helpWidth - termWidth - spacerWidth - itemIndent;
+      let formattedDescription;
+      if (remainingWidth < this.minWidthToWrap || helper.preformatted(description)) {
+        formattedDescription = description;
+      } else {
+        const wrappedDescription = helper.boxWrap(description, remainingWidth);
+        formattedDescription = wrappedDescription.replace(/\n/g, `
+` + " ".repeat(termWidth + spacerWidth));
+      }
+      return itemIndentStr + paddedTerm + " ".repeat(spacerWidth) + formattedDescription.replace(/\n/g, `
+${itemIndentStr}`);
+    }
+    boxWrap(str, width) {
+      if (width < this.minWidthToWrap)
         return str;
-      const leadingStr = str.slice(0, indent2);
-      const columnText = str.slice(indent2).replace(`\r
-`, `
-`);
-      const indentString = " ".repeat(indent2);
-      const zeroWidthSpace = "​";
-      const breaks = `\\s${zeroWidthSpace}`;
-      const regex = new RegExp(`
-|.{1,${columnWidth - 1}}([${breaks}]|$)|[^${breaks}]+?([${breaks}]|$)`, "g");
-      const lines = columnText.match(regex) || [];
-      return leadingStr + lines.map((line, i) => {
-        if (line === `
-`)
-          return "";
-        return (i > 0 ? indentString : "") + line.trimEnd();
-      }).join(`
+      const rawLines = str.split(/\r\n|\n/);
+      const chunkPattern = /[\s]*[^\s]+/g;
+      const wrappedLines = [];
+      rawLines.forEach((line) => {
+        const chunks = line.match(chunkPattern);
+        if (chunks === null) {
+          wrappedLines.push("");
+          return;
+        }
+        let sumChunks = [chunks.shift()];
+        let sumWidth = this.displayWidth(sumChunks[0]);
+        chunks.forEach((chunk) => {
+          const visibleWidth = this.displayWidth(chunk);
+          if (sumWidth + visibleWidth <= width) {
+            sumChunks.push(chunk);
+            sumWidth += visibleWidth;
+            return;
+          }
+          wrappedLines.push(sumChunks.join(""));
+          const nextChunk = chunk.trimStart();
+          sumChunks = [nextChunk];
+          sumWidth = this.displayWidth(nextChunk);
+        });
+        wrappedLines.push(sumChunks.join(""));
+      });
+      return wrappedLines.join(`
 `);
     }
   }
+  function stripColor(str) {
+    const sgrPattern = /\x1b\[\d*(;\d*)*m/g;
+    return str.replace(sgrPattern, "");
+  }
   exports.Help = Help;
+  exports.stripColor = stripColor;
 });
 
 // ../../node_modules/commander/lib/option.js
@@ -37875,7 +37978,10 @@ var require_option = __commonJS((exports) => {
       return this.short.replace(/^-/, "");
     }
     attributeName() {
-      return camelcase(this.name().replace(/^no-/, ""));
+      if (this.negate) {
+        return camelcase(this.name().replace(/^no-/, ""));
+      }
+      return camelcase(this.name());
     }
     is(arg) {
       return this.short === arg || this.long === arg;
@@ -37920,18 +38026,41 @@ var require_option = __commonJS((exports) => {
   function splitOptionFlags(flags) {
     let shortFlag;
     let longFlag;
-    const flagParts = flags.split(/[ |,]+/);
-    if (flagParts.length > 1 && !/^[[<]/.test(flagParts[1]))
+    const shortFlagExp = /^-[^-]$/;
+    const longFlagExp = /^--[^-]/;
+    const flagParts = flags.split(/[ |,]+/).concat("guard");
+    if (shortFlagExp.test(flagParts[0]))
       shortFlag = flagParts.shift();
-    longFlag = flagParts.shift();
-    if (!shortFlag && /^-[^-]$/.test(longFlag)) {
+    if (longFlagExp.test(flagParts[0]))
+      longFlag = flagParts.shift();
+    if (!shortFlag && shortFlagExp.test(flagParts[0]))
+      shortFlag = flagParts.shift();
+    if (!shortFlag && longFlagExp.test(flagParts[0])) {
       shortFlag = longFlag;
-      longFlag = undefined;
-    }
+      longFlag = flagParts.shift();
+    }
+    if (flagParts[0].startsWith("-")) {
+      const unsupportedFlag = flagParts[0];
+      const baseError = `option creation failed due to '${unsupportedFlag}' in option flags '${flags}'`;
+      if (/^-[^-][^-]/.test(unsupportedFlag))
+        throw new Error(`${baseError}
+- a short flag is a single dash and a single character
+  - either use a single dash and a single character (for a short flag)
+  - or use a double dash for a long option (and can have two, like '--ws, --workspace')`);
+      if (shortFlagExp.test(unsupportedFlag))
+        throw new Error(`${baseError}
+- too many short flags`);
+      if (longFlagExp.test(unsupportedFlag))
+        throw new Error(`${baseError}
+- too many long flags`);
+      throw new Error(`${baseError}
+- unrecognised flag format`);
+    }
+    if (shortFlag === undefined && longFlag === undefined)
+      throw new Error(`option creation failed due to no flags found in '${flags}'.`);
     return { shortFlag, longFlag };
   }
   exports.Option = Option;
-  exports.splitOptionFlags = splitOptionFlags;
   exports.DualOptions = DualOptions;
 });
 
@@ -38010,15 +38139,15 @@ var require_suggestSimilar = __commonJS((exports) => {
 
 // ../../node_modules/commander/lib/command.js
 var require_command = __commonJS((exports) => {
-  var EventEmitter2 = __require("events").EventEmitter;
-  var childProcess = __require("child_process");
-  var path2 = __require("path");
-  var fs = __require("fs");
-  var process3 = __require("process");
+  var EventEmitter2 = __require("node:events").EventEmitter;
+  var childProcess = __require("node:child_process");
+  var path2 = __require("node:path");
+  var fs = __require("node:fs");
+  var process3 = __require("node:process");
   var { Argument, humanReadableArgName } = require_argument();
   var { CommanderError } = require_error3();
-  var { Help } = require_help();
-  var { Option, splitOptionFlags, DualOptions } = require_option();
+  var { Help, stripColor } = require_help();
+  var { Option, DualOptions } = require_option();
   var { suggestSimilar } = require_suggestSimilar();
 
   class Command extends EventEmitter2 {
@@ -38028,7 +38157,7 @@ var require_command = __commonJS((exports) => {
       this.options = [];
       this.parent = null;
       this._allowUnknownOption = false;
-      this._allowExcessArguments = true;
+      this._allowExcessArguments = false;
       this.registeredArguments = [];
       this._args = this.registeredArguments;
       this.args = [];
@@ -38055,35 +38184,27 @@ var require_command = __commonJS((exports) => {
       this._lifeCycleHooks = {};
       this._showHelpAfterError = false;
       this._showSuggestionAfterError = true;
+      this._savedState = null;
       this._outputConfiguration = {
         writeOut: (str) => process3.stdout.write(str),
         writeErr: (str) => process3.stderr.write(str),
+        outputError: (str, write) => write(str),
         getOutHelpWidth: () => process3.stdout.isTTY ? process3.stdout.columns : undefined,
         getErrHelpWidth: () => process3.stderr.isTTY ? process3.stderr.columns : undefined,
-        outputError: (str, write) => write(str)
+        getOutHasColors: () => useColor() ?? (process3.stdout.isTTY && process3.stdout.hasColors?.()),
+        getErrHasColors: () => useColor() ?? (process3.stderr.isTTY && process3.stderr.hasColors?.()),
+        stripColor: (str) => stripColor(str)
       };
       this._hidden = false;
-      this._hasHelpOption = true;
-      this._helpFlags = "-h, --help";
-      this._helpDescription = "display help for command";
-      this._helpShortFlag = "-h";
-      this._helpLongFlag = "--help";
+      this._helpOption = undefined;
       this._addImplicitHelpCommand = undefined;
-      this._helpCommandName = "help";
-      this._helpCommandnameAndArgs = "help [command]";
-      this._helpCommandDescription = "display help for command";
+      this._helpCommand = undefined;
       this._helpConfiguration = {};
     }
     copyInheritedSettings(sourceCommand) {
       this._outputConfiguration = sourceCommand._outputConfiguration;
-      this._hasHelpOption = sourceCommand._hasHelpOption;
-      this._helpFlags = sourceCommand._helpFlags;
-      this._helpDescription = sourceCommand._helpDescription;
-      this._helpShortFlag = sourceCommand._helpShortFlag;
-      this._helpLongFlag = sourceCommand._helpLongFlag;
-      this._helpCommandName = sourceCommand._helpCommandName;
-      this._helpCommandnameAndArgs = sourceCommand._helpCommandnameAndArgs;
-      this._helpCommandDescription = sourceCommand._helpCommandDescription;
+      this._helpOption = sourceCommand._helpOption;
+      this._helpCommand = sourceCommand._helpCommand;
       this._helpConfiguration = sourceCommand._helpConfiguration;
       this._exitCallback = sourceCommand._exitCallback;
       this._storeOptionsAsProperties = sourceCommand._storeOptionsAsProperties;
@@ -38121,7 +38242,7 @@ var require_command = __commonJS((exports) => {
       cmd._executableFile = opts.executableFile || null;
       if (args)
         cmd.arguments(args);
-      this.commands.push(cmd);
+      this._registerCommand(cmd);
       cmd.parent = this;
       cmd.copyInheritedSettings(this);
       if (desc)
@@ -38166,8 +38287,9 @@ var require_command = __commonJS((exports) => {
         this._defaultCommandName = cmd._name;
       if (opts.noHelp || opts.hidden)
         cmd._hidden = true;
-      this.commands.push(cmd);
+      this._registerCommand(cmd);
       cmd.parent = this;
+      cmd._checkForBrokenPassThrough();
       return this;
     }
     createArgument(name, description) {
@@ -38200,24 +38322,42 @@ var require_command = __commonJS((exports) => {
       this.registeredArguments.push(argument);
       return this;
     }
-    addHelpCommand(enableOrNameAndArgs, description) {
-      if (enableOrNameAndArgs === false) {
-        this._addImplicitHelpCommand = false;
-      } else {
-        this._addImplicitHelpCommand = true;
-        if (typeof enableOrNameAndArgs === "string") {
-          this._helpCommandName = enableOrNameAndArgs.split(" ")[0];
-          this._helpCommandnameAndArgs = enableOrNameAndArgs;
-        }
-        this._helpCommandDescription = description || this._helpCommandDescription;
+    helpCommand(enableOrNameAndArgs, description) {
+      if (typeof enableOrNameAndArgs === "boolean") {
+        this._addImplicitHelpCommand = enableOrNameAndArgs;
+        return this;
+      }
+      enableOrNameAndArgs = enableOrNameAndArgs ?? "help [command]";
+      const [, helpName, helpArgs] = enableOrNameAndArgs.match(/([^ ]+) *(.*)/);
+      const helpDescription = description ?? "display help for command";
+      const helpCommand = this.createCommand(helpName);
+      helpCommand.helpOption(false);
+      if (helpArgs)
+        helpCommand.arguments(helpArgs);
+      if (helpDescription)
+        helpCommand.description(helpDescription);
+      this._addImplicitHelpCommand = true;
+      this._helpCommand = helpCommand;
+      return this;
+    }
+    addHelpCommand(helpCommand, deprecatedDescription) {
+      if (typeof helpCommand !== "object") {
+        this.helpCommand(helpCommand, deprecatedDescription);
+        return this;
       }
+      this._addImplicitHelpCommand = true;
+      this._helpCommand = helpCommand;
       return this;
     }
-    _hasImplicitHelpCommand() {
-      if (this._addImplicitHelpCommand === undefined) {
-        return this.commands.length && !this._actionHandler && !this._findCommand("help");
+    _getHelpCommand() {
+      const hasImplicitHelpCommand = this._addImplicitHelpCommand ?? (this.commands.length && !this._actionHandler && !this._findCommand("help"));
+      if (hasImplicitHelpCommand) {
+        if (this._helpCommand === undefined) {
+          this.helpCommand(undefined, undefined);
+        }
+        return this._helpCommand;
       }
-      return this._addImplicitHelpCommand;
+      return null;
     }
     hook(event, listener) {
       const allowedValues = ["preSubcommand", "preAction", "postAction"];
@@ -38279,7 +38419,29 @@ Expecting one of '${allowedValues.join("', '")}'`);
         throw err;
       }
     }
+    _registerOption(option) {
+      const matchingOption = option.short && this._findOption(option.short) || option.long && this._findOption(option.long);
+      if (matchingOption) {
+        const matchingFlag = option.long && this._findOption(option.long) ? option.long : option.short;
+        throw new Error(`Cannot add option '${option.flags}'${this._name && ` to command '${this._name}'`} due to conflicting flag '${matchingFlag}'
+-  already used by option '${matchingOption.flags}'`);
+      }
+      this.options.push(option);
+    }
+    _registerCommand(command) {
+      const knownBy = (cmd) => {
+        return [cmd.name()].concat(cmd.aliases());
+      };
+      const alreadyUsed = knownBy(command).find((name) => this._findCommand(name));
+      if (alreadyUsed) {
+        const existingCmd = knownBy(this._findCommand(alreadyUsed)).join("|");
+        const newCmd = knownBy(command).join("|");
+        throw new Error(`cannot add command '${newCmd}' as already have command '${existingCmd}'`);
+      }
+      this.commands.push(command);
+    }
     addOption(option) {
+      this._registerOption(option);
       const oname = option.name();
       const name = option.attributeName();
       if (option.negate) {
@@ -38290,7 +38452,6 @@ Expecting one of '${allowedValues.join("', '")}'`);
       } else if (option.defaultValue !== undefined) {
         this.setOptionValueWithSource(name, option.defaultValue, "default");
       }
-      this.options.push(option);
       const handleOptionValue = (val, invalidValueMessage, valueSource) => {
         if (val == null && option.presetArg !== undefined) {
           val = option.presetArg;
@@ -38368,15 +38529,21 @@ Expecting one of '${allowedValues.join("', '")}'`);
     }
     passThroughOptions(passThrough = true) {
       this._passThroughOptions = !!passThrough;
-      if (!!this.parent && passThrough && !this.parent._enablePositionalOptions) {
-        throw new Error("passThroughOptions can not be used without turning on enablePositionalOptions for parent command(s)");
-      }
+      this._checkForBrokenPassThrough();
       return this;
     }
+    _checkForBrokenPassThrough() {
+      if (this.parent && this._passThroughOptions && !this.parent._enablePositionalOptions) {
+        throw new Error(`passThroughOptions cannot be used for '${this._name}' without turning on enablePositionalOptions for parent command(s)`);
+      }
+    }
     storeOptionsAsProperties(storeAsProperties = true) {
       if (this.options.length) {
         throw new Error("call .storeOptionsAsProperties() before adding options");
       }
+      if (Object.keys(this._optionValues).length) {
+        throw new Error("call .storeOptionsAsProperties() before setting option values");
+      }
       this._storeOptionsAsProperties = !!storeAsProperties;
       return this;
     }
@@ -38415,11 +38582,17 @@ Expecting one of '${allowedValues.join("', '")}'`);
         throw new Error("first parameter to parse must be array or undefined");
       }
       parseOptions = parseOptions || {};
-      if (argv === undefined) {
-        argv = process3.argv;
-        if (process3.versions && process3.versions.electron) {
+      if (argv === undefined && parseOptions.from === undefined) {
+        if (process3.versions?.electron) {
           parseOptions.from = "electron";
         }
+        const execArgv = process3.execArgv ?? [];
+        if (execArgv.includes("-e") || execArgv.includes("--eval") || execArgv.includes("-p") || execArgv.includes("--print")) {
+          parseOptions.from = "eval";
+        }
+      }
+      if (argv === undefined) {
+        argv = process3.argv;
       }
       this.rawArgs = argv.slice();
       let userArgs;
@@ -38440,6 +38613,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
         case "user":
           userArgs = argv.slice(0);
           break;
+        case "eval":
+          userArgs = argv.slice(1);
+          break;
         default:
           throw new Error(`unexpected parse option { from: '${parseOptions.from}' }`);
       }
@@ -38449,15 +38625,53 @@ Expecting one of '${allowedValues.join("', '")}'`);
       return userArgs;
     }
     parse(argv, parseOptions) {
+      this._prepareForParse();
       const userArgs = this._prepareUserArgs(argv, parseOptions);
       this._parseCommand([], userArgs);
       return this;
     }
     async parseAsync(argv, parseOptions) {
+      this._prepareForParse();
       const userArgs = this._prepareUserArgs(argv, parseOptions);
       await this._parseCommand([], userArgs);
       return this;
     }
+    _prepareForParse() {
+      if (this._savedState === null) {
+        this.saveStateBeforeParse();
+      } else {
+        this.restoreStateBeforeParse();
+      }
+    }
+    saveStateBeforeParse() {
+      this._savedState = {
+        _name: this._name,
+        _optionValues: { ...this._optionValues },
+        _optionValueSources: { ...this._optionValueSources }
+      };
+    }
+    restoreStateBeforeParse() {
+      if (this._storeOptionsAsProperties)
+        throw new Error(`Can not call parse again when storeOptionsAsProperties is true.
+- either make a new Command for each call to parse, or stop storing options as properties`);
+      this._name = this._savedState._name;
+      this._scriptPath = null;
+      this.rawArgs = [];
+      this._optionValues = { ...this._savedState._optionValues };
+      this._optionValueSources = { ...this._savedState._optionValueSources };
+      this.args = [];
+      this.processedArgs = [];
+    }
+    _checkForMissingExecutable(executableFile, executableDir, subcommandName) {
+      if (fs.existsSync(executableFile))
+        return;
+      const executableDirMessage = executableDir ? `searched for local subcommand relative to directory '${executableDir}'` : "no directory for search for local subcommand, use .executableDir() to supply a custom directory";
+      const executableMissing = `'${executableFile}' does not exist
+ - if '${subcommandName}' is not meant to be an executable command, remove description parameter from '.command()' and use '.description()' instead
+ - if the default executable name is not suitable, use the executableFile option to supply a custom name or path
+ - ${executableDirMessage}`;
+      throw new Error(executableMissing);
+    }
     _executeSubCommand(subcommand, args) {
       args = args.slice();
       let launchWithNode = false;
@@ -38481,7 +38695,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let resolvedScriptPath;
         try {
           resolvedScriptPath = fs.realpathSync(this._scriptPath);
-        } catch (err) {
+        } catch {
           resolvedScriptPath = this._scriptPath;
         }
         executableDir = path2.resolve(path2.dirname(resolvedScriptPath), executableDir);
@@ -38507,6 +38721,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           proc2 = childProcess.spawn(executableFile, args, { stdio: "inherit" });
         }
       } else {
+        this._checkForMissingExecutable(executableFile, executableDir, subcommand._name);
         args.unshift(executableFile);
         args = incrementNodeInspectorPort(process3.execArgv).concat(args);
         proc2 = childProcess.spawn(process3.execPath, args, { stdio: "inherit" });
@@ -38522,21 +38737,17 @@ Expecting one of '${allowedValues.join("', '")}'`);
         });
       }
       const exitCallback = this._exitCallback;
-      if (!exitCallback) {
-        proc2.on("close", process3.exit.bind(process3));
-      } else {
-        proc2.on("close", () => {
-          exitCallback(new CommanderError(process3.exitCode || 0, "commander.executeSubCommandAsync", "(close)"));
-        });
-      }
+      proc2.on("close", (code) => {
+        code = code ?? 1;
+        if (!exitCallback) {
+          process3.exit(code);
+        } else {
+          exitCallback(new CommanderError(code, "commander.executeSubCommandAsync", "(close)"));
+        }
+      });
       proc2.on("error", (err) => {
         if (err.code === "ENOENT") {
-          const executableDirMessage = executableDir ? `searched for local subcommand relative to directory '${executableDir}'` : "no directory for search for local subcommand, use .executableDir() to supply a custom directory";
-          const executableMissing = `'${executableFile}' does not exist
- - if '${subcommand._name}' is not meant to be an executable command, remove description parameter from '.command()' and use '.description()' instead
- - if the default executable name is not suitable, use the executableFile option to supply a custom name or path
- - ${executableDirMessage}`;
-          throw new Error(executableMissing);
+          this._checkForMissingExecutable(executableFile, executableDir, subcommand._name);
         } else if (err.code === "EACCES") {
           throw new Error(`'${executableFile}' not executable`);
         }
@@ -38554,6 +38765,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
       const subCommand = this._findCommand(commandName);
       if (!subCommand)
         this.help({ error: true });
+      subCommand._prepareForParse();
       let promiseChain;
       promiseChain = this._chainOrCallSubCommandHook(promiseChain, subCommand, "preSubcommand");
       promiseChain = this._chainOrCall(promiseChain, () => {
@@ -38573,9 +38785,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
       if (subCommand && !subCommand._executableHandler) {
         subCommand.help();
       }
-      return this._dispatchSubcommand(subcommandName, [], [
-        this._helpLongFlag || this._helpShortFlag
-      ]);
+      return this._dispatchSubcommand(subcommandName, [], [this._getHelpOption()?.long ?? this._getHelpOption()?.short ?? "--help"]);
     }
     _checkNumberOfArguments() {
       this.registeredArguments.forEach((arg, i) => {
@@ -38669,17 +38879,17 @@ Expecting one of '${allowedValues.join("', '")}'`);
       if (operands && this._findCommand(operands[0])) {
         return this._dispatchSubcommand(operands[0], operands.slice(1), unknown2);
       }
-      if (this._hasImplicitHelpCommand() && operands[0] === this._helpCommandName) {
+      if (this._getHelpCommand() && operands[0] === this._getHelpCommand().name()) {
         return this._dispatchHelpCommand(operands[1]);
       }
       if (this._defaultCommandName) {
-        outputHelpIfRequested(this, unknown2);
+        this._outputHelpIfRequested(unknown2);
         return this._dispatchSubcommand(this._defaultCommandName, operands, unknown2);
       }
       if (this.commands.length && this.args.length === 0 && !this._actionHandler && !this._defaultCommandName) {
         this.help({ error: true });
       }
-      outputHelpIfRequested(this, parsed.unknown);
+      this._outputHelpIfRequested(parsed.unknown);
       this._checkForMissingMandatoryOptions();
       this._checkForConflictingOptions();
       const checkForUnknownOptions = () => {
@@ -38836,7 +39046,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
             if (args.length > 0)
               unknown2.push(...args);
             break;
-          } else if (arg === this._helpCommandName && this._hasImplicitHelpCommand()) {
+          } else if (this._getHelpCommand() && arg === this._getHelpCommand().name()) {
             operands.push(arg);
             if (args.length > 0)
               operands.push(...args);
@@ -38998,7 +39208,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
       description = description || "output the version number";
       const versionOption = this.createOption(flags, description);
       this._versionOptionName = versionOption.attributeName();
-      this.options.push(versionOption);
+      this._registerOption(versionOption);
       this.on("option:" + versionOption.name(), () => {
         this._outputConfiguration.writeOut(`${str}
 `);
@@ -39030,6 +39240,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
       }
       if (alias === command._name)
         throw new Error("Command alias can't be the same as its name");
+      const matchingCommand = this.parent?._findCommand(alias);
+      if (matchingCommand) {
+        const existingCmd = [matchingCommand.name()].concat(matchingCommand.aliases()).join("|");
+        throw new Error(`cannot add alias '${alias}' to command '${this.name()}' as already have command '${existingCmd}'`);
+      }
       command._aliases.push(alias);
       return this;
     }
@@ -39046,7 +39261,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
         const args = this.registeredArguments.map((arg) => {
           return humanReadableArgName(arg);
         });
-        return [].concat(this.options.length || this._hasHelpOption ? "[options]" : [], this.commands.length ? "[command]" : [], this.registeredArguments.length ? args : []).join(" ");
+        return [].concat(this.options.length || this._helpOption !== null ? "[options]" : [], this.commands.length ? "[command]" : [], this.registeredArguments.length ? args : []).join(" ");
       }
       this._usage = str;
       return this;
@@ -39069,23 +39284,38 @@ Expecting one of '${allowedValues.join("', '")}'`);
     }
     helpInformation(contextOptions) {
       const helper = this.createHelp();
-      if (helper.helpWidth === undefined) {
-        helper.helpWidth = contextOptions && contextOptions.error ? this._outputConfiguration.getErrHelpWidth() : this._outputConfiguration.getOutHelpWidth();
-      }
-      return helper.formatHelp(this, helper);
+      const context = this._getOutputContext(contextOptions);
+      helper.prepareContext({
+        error: context.error,
+        helpWidth: context.helpWidth,
+        outputHasColors: context.hasColors
+      });
+      const text = helper.formatHelp(this, helper);
+      if (context.hasColors)
+        return text;
+      return this._outputConfiguration.stripColor(text);
     }
-    _getHelpContext(contextOptions) {
+    _getOutputContext(contextOptions) {
       contextOptions = contextOptions || {};
-      const context = { error: !!contextOptions.error };
-      let write;
-      if (context.error) {
-        write = (arg) => this._outputConfiguration.writeErr(arg);
+      const error = !!contextOptions.error;
+      let baseWrite;
+      let hasColors2;
+      let helpWidth;
+      if (error) {
+        baseWrite = (str) => this._outputConfiguration.writeErr(str);
+        hasColors2 = this._outputConfiguration.getErrHasColors();
+        helpWidth = this._outputConfiguration.getErrHelpWidth();
       } else {
-        write = (arg) => this._outputConfiguration.writeOut(arg);
-      }
-      context.write = contextOptions.write || write;
-      context.command = this;
-      return context;
+        baseWrite = (str) => this._outputConfiguration.writeOut(str);
+        hasColors2 = this._outputConfiguration.getOutHasColors();
+        helpWidth = this._outputConfiguration.getOutHelpWidth();
+      }
+      const write = (str) => {
+        if (!hasColors2)
+          str = this._outputConfiguration.stripColor(str);
+        return baseWrite(str);
+      };
+      return { error, write, hasColors: hasColors2, helpWidth };
     }
     outputHelp(contextOptions) {
       let deprecatedCallback;
@@ -39093,38 +39323,55 @@ Expecting one of '${allowedValues.join("', '")}'`);
         deprecatedCallback = contextOptions;
         contextOptions = undefined;
       }
-      const context = this._getHelpContext(contextOptions);
-      this._getCommandAndAncestors().reverse().forEach((command) => command.emit("beforeAllHelp", context));
-      this.emit("beforeHelp", context);
-      let helpInformation = this.helpInformation(context);
+      const outputContext = this._getOutputContext(contextOptions);
+      const eventContext = {
+        error: outputContext.error,
+        write: outputContext.write,
+        command: this
+      };
+      this._getCommandAndAncestors().reverse().forEach((command) => command.emit("beforeAllHelp", eventContext));
+      this.emit("beforeHelp", eventContext);
+      let helpInformation = this.helpInformation({ error: outputContext.error });
       if (deprecatedCallback) {
         helpInformation = deprecatedCallback(helpInformation);
         if (typeof helpInformation !== "string" && !Buffer.isBuffer(helpInformation)) {
           throw new Error("outputHelp callback must return a string or a Buffer");
         }
       }
-      context.write(helpInformation);
-      if (this._helpLongFlag) {
-        this.emit(this._helpLongFlag);
+      outputContext.write(helpInformation);
+      if (this._getHelpOption()?.long) {
+        this.emit(this._getHelpOption().long);
       }
-      this.emit("afterHelp", context);
-      this._getCommandAndAncestors().forEach((command) => command.emit("afterAllHelp", context));
+      this.emit("afterHelp", eventContext);
+      this._getCommandAndAncestors().forEach((command) => command.emit("afterAllHelp", eventContext));
     }
     helpOption(flags, description) {
       if (typeof flags === "boolean") {
-        this._hasHelpOption = flags;
+        if (flags) {
+          this._helpOption = this._helpOption ?? undefined;
+        } else {
+          this._helpOption = null;
+        }
         return this;
       }
-      this._helpFlags = flags || this._helpFlags;
-      this._helpDescription = description || this._helpDescription;
-      const helpFlags = splitOptionFlags(this._helpFlags);
-      this._helpShortFlag = helpFlags.shortFlag;
-      this._helpLongFlag = helpFlags.longFlag;
+      flags = flags ?? "-h, --help";
+      description = description ?? "display help for command";
+      this._helpOption = this.createOption(flags, description);
+      return this;
+    }
+    _getHelpOption() {
+      if (this._helpOption === undefined) {
+        this.helpOption(undefined, undefined);
+      }
+      return this._helpOption;
+    }
+    addHelpOption(option) {
+      this._helpOption = option;
       return this;
     }
     help(contextOptions) {
       this.outputHelp(contextOptions);
-      let exitCode = process3.exitCode || 0;
+      let exitCode = Number(process3.exitCode ?? 0);
       if (exitCode === 0 && contextOptions && typeof contextOptions !== "function" && contextOptions.error) {
         exitCode = 1;
       }
@@ -39151,12 +39398,13 @@ Expecting one of '${allowedValues.join("', '")}'`);
       });
       return this;
     }
-  }
-  function outputHelpIfRequested(cmd, args) {
-    const helpOption = cmd._hasHelpOption && args.find((arg) => arg === cmd._helpLongFlag || arg === cmd._helpShortFlag);
-    if (helpOption) {
-      cmd.outputHelp();
-      cmd._exit(0, "commander.helpDisplayed", "(outputHelp)");
+    _outputHelpIfRequested(args) {
+      const helpOption = this._getHelpOption();
+      const helpRequested = helpOption && args.find((arg) => helpOption.is(arg));
+      if (helpRequested) {
+        this.outputHelp();
+        this._exit(0, "commander.helpDisplayed", "(outputHelp)");
+      }
     }
   }
   function incrementNodeInspectorPort(args) {
@@ -39188,18 +39436,28 @@ Expecting one of '${allowedValues.join("', '")}'`);
       return arg;
     });
   }
+  function useColor() {
+    if (process3.env.NO_COLOR || process3.env.FORCE_COLOR === "0" || process3.env.FORCE_COLOR === "false")
+      return false;
+    if (process3.env.FORCE_COLOR || process3.env.CLICOLOR_FORCE !== undefined)
+      return true;
+    return;
+  }
   exports.Command = Command;
+  exports.useColor = useColor;
 });
 
 // ../../node_modules/commander/index.js
-var require_commander = __commonJS((exports, module) => {
+var require_commander = __commonJS((exports) => {
   var { Argument } = require_argument();
   var { Command } = require_command();
   var { CommanderError, InvalidArgumentError } = require_error3();
   var { Help } = require_help();
   var { Option } = require_option();
-  exports = module.exports = new Command;
-  exports.program = exports;
+  exports.program = new Command;
+  exports.createCommand = (name) => new Command(name);
+  exports.createOption = (flags, description) => new Option(flags, description);
+  exports.createArgument = (name, description) => new Argument(name, description);
   exports.Command = Command;
   exports.Option = Option;
   exports.Argument = Argument;
@@ -64181,7 +64439,7 @@ var {
 var package_default = {
   name: "@settlemint/sdk-mcp",
   description: "MCP interface for SettleMint SDK, providing development tools and project management capabilities",
-  version: "1.2.2-prc6ef5d96",
+  version: "1.2.2-prd7c032b8",
   type: "module",
   private: false,
   license: "FSL-1.1-MIT",
@@ -64223,10 +64481,10 @@ var package_default = {
     "@graphql-tools/load": "8.0.19",
     "@graphql-tools/url-loader": "8.0.31",
     "@modelcontextprotocol/sdk": "1.7.0",
-    "@settlemint/sdk-js": "1.2.2-prc6ef5d96",
-    "@settlemint/sdk-utils": "1.2.2-prc6ef5d96",
+    "@settlemint/sdk-js": "1.2.2-prd7c032b8",
+    "@settlemint/sdk-utils": "1.2.2-prd7c032b8",
     "@commander-js/extra-typings": "11.1.0",
-    commander: "11.1.0",
+    commander: "13.1.0",
     zod: "3.24.2"
   },
   devDependencies: {},
@@ -69646,4 +69904,4 @@ await main().catch((error2) => {
   process.exit(1);
 });
 
-//# debugId=C5CE9663D99A8C8564756E2164756E21
+//# debugId=71E34174832D7A1564756E2164756E21