@alcyone-labs/arg-parser 2.1.1 → 2.2.1

package/dist/index.mjs

@@ -284,7 +284,9 @@ class JsonConfigPlugin extends ConfigPlugin {
       const { _meta, ...config } = parsed;
       return config;
     } catch (error) {
-      throw new Error(`Failed to parse JSON: ${error instanceof Error ? error.message : String(error)}`);
+      throw new Error(
+        `Failed to parse JSON: ${error instanceof Error ? error.message : String(error)}`
+      );
     }
   }
   generate(_config, flags, parsedArgs) {
@@ -500,7 +502,9 @@ function enableConfigPlugins(pluginNames) {
             globalConfigPluginRegistry.registerPlugin(tomlPlugin);
           }
         } catch (error) {
-          console.warn(`Failed to enable TOML plugin: ${error instanceof Error ? error.message : String(error)}`);
+          console.warn(
+            `Failed to enable TOML plugin: ${error instanceof Error ? error.message : String(error)}`
+          );
         }
         break;
       case "yaml":
@@ -511,7 +515,9 @@ function enableConfigPlugins(pluginNames) {
             globalConfigPluginRegistry.registerPlugin(yamlPlugin);
           }
         } catch (error) {
-          console.warn(`Failed to enable YAML plugin: ${error instanceof Error ? error.message : String(error)}`);
+          console.warn(
+            `Failed to enable YAML plugin: ${error instanceof Error ? error.message : String(error)}`
+          );
         }
         break;
       default:
@@ -535,14 +541,18 @@ class ConfigurationManager {
     } else if (appName && appName !== "Argument Parser") {
       baseName = appName;
     }
-    baseName = baseName.split(/[\s-_]+/).map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join("");
+    baseName = baseName.split(/[\s-_]+/).map(
+      (word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()
+    ).join("");
     return `${baseName}.env`;
   }
   /**
    * Handles the --s-save-to-env system flag at the final parser level
    */
   handleSaveToEnvFlag(processArgs, parserChain) {
-    const saveToEnvIndex = processArgs.findIndex((arg) => arg === "--s-save-to-env");
+    const saveToEnvIndex = processArgs.findIndex(
+      (arg) => arg === "--s-save-to-env"
+    );
     if (saveToEnvIndex !== -1) {
       let filePath;
       if (saveToEnvIndex + 1 < processArgs.length) {
@@ -568,7 +578,11 @@ class ConfigurationManager {
       const finalParser = parserChain[parserChain.length - 1];
       const parsedArgs = finalParser.getLastParseResult();
       if (!parsedArgs) {
-        console.log(simpleChalk.yellow("No parsed arguments available. Run the command first to generate configuration."));
+        console.log(
+          simpleChalk.yellow(
+            "No parsed arguments available. Run the command first to generate configuration."
+          )
+        );
         return;
       }
       const allFlags = [];
@@ -601,10 +615,18 @@ class ConfigurationManager {
       fs.writeFileSync(filePath, content, "utf8");
       console.log(simpleChalk.green(`✅ Configuration saved to: ${filePath}`));
       console.log(simpleChalk.gray(`Format: ${ext || ".env"}`));
-      console.log(simpleChalk.gray(`Flags saved: ${Object.keys(parsedArgs.args).length}`));
+      console.log(
+        simpleChalk.gray(`Flags saved: ${Object.keys(parsedArgs.args).length}`)
+      );
     } catch (error) {
-      console.error(simpleChalk.red(`❌ Failed to save configuration: ${error instanceof Error ? error.message : String(error)}`));
-      throw new Error(`Failed to save configuration: ${error instanceof Error ? error.message : String(error)}`);
+      console.error(
+        simpleChalk.red(
+          `❌ Failed to save configuration: ${error instanceof Error ? error.message : String(error)}`
+        )
+      );
+      throw new Error(
+        `Failed to save configuration: ${error instanceof Error ? error.message : String(error)}`
+      );
     }
   }
   /**
@@ -641,7 +663,11 @@ class ConfigurationManager {
       }
       return this.convertConfigToFlagValues(rawConfig, parserChain);
     } catch (error) {
-      console.warn(simpleChalk.yellow(`Warning: Could not load config file ${filePath}: ${error instanceof Error ? error.message : String(error)}`));
+      console.warn(
+        simpleChalk.yellow(
+          `Warning: Could not load config file ${filePath}: ${error instanceof Error ? error.message : String(error)}`
+        )
+      );
       return {};
     }
   }
@@ -675,7 +701,9 @@ class ConfigurationManager {
     if (plugin) {
       return plugin.parse(content);
     }
-    console.warn("YAML plugin not available, using simple parser. Install js-yaml and enable YAML plugin for full support.");
+    console.warn(
+      "YAML plugin not available, using simple parser. Install js-yaml and enable YAML plugin for full support."
+    );
     const config = {};
     const lines = content.split("\n");
     let currentKey = null;
@@ -726,7 +754,9 @@ class ConfigurationManager {
     try {
       return JSON.parse(content) || {};
     } catch (error) {
-      throw new Error(`Failed to parse JSON: ${error instanceof Error ? error.message : String(error)}`);
+      throw new Error(
+        `Failed to parse JSON: ${error instanceof Error ? error.message : String(error)}`
+      );
     }
   }
   /**
@@ -737,7 +767,9 @@ class ConfigurationManager {
     if (plugin) {
       return plugin.parse(content);
     }
-    console.warn("TOML plugin not available, using simple parser. Install smol-toml and enable TOML plugin for full support.");
+    console.warn(
+      "TOML plugin not available, using simple parser. Install smol-toml and enable TOML plugin for full support."
+    );
     const config = {};
     const lines = content.split("\n");
     for (const line of lines) {
@@ -768,13 +800,19 @@ class ConfigurationManager {
     for (const [key, value] of Object.entries(rawConfig)) {
       let flag = allFlags.find((f) => f["name"] === key);
       if (!flag) {
-        flag = allFlags.find((f) => f["name"].toLowerCase() === key.toLowerCase());
+        flag = allFlags.find(
+          (f) => f["name"].toLowerCase() === key.toLowerCase()
+        );
       }
       if (flag) {
         try {
           flagValues[flag["name"]] = this.convertValueToFlagType(value, flag);
         } catch (error) {
-          console.warn(simpleChalk.yellow(`Warning: Could not convert config value for flag '${key}': ${error instanceof Error ? error.message : String(error)}`));
+          console.warn(
+            simpleChalk.yellow(
+              `Warning: Could not convert config value for flag '${key}': ${error instanceof Error ? error.message : String(error)}`
+            )
+          );
         }
       }
     }
@@ -811,17 +849,23 @@ class ConfigurationManager {
       }
       const num = Number(value);
       if (isNaN(num)) {
-        throw new Error(`Cannot convert '${value}' to number for flag '${flag["name"]}'`);
+        throw new Error(
+          `Cannot convert '${value}' to number for flag '${flag["name"]}'`
+        );
       }
       return num;
     } else if (isBooleanType) {
       if (typeof value === "boolean") return value;
       if (typeof value === "string") {
         const lower = value.toLowerCase();
-        if (lower === "true" || lower === "1" || lower === "yes" || lower === "on") return true;
-        if (lower === "false" || lower === "0" || lower === "no" || lower === "off") return false;
+        if (lower === "true" || lower === "1" || lower === "yes" || lower === "on")
+          return true;
+        if (lower === "false" || lower === "0" || lower === "no" || lower === "off")
+          return false;
       }
-      throw new Error(`Cannot convert '${value}' to boolean for flag '${flag["name"]}'`);
+      throw new Error(
+        `Cannot convert '${value}' to boolean for flag '${flag["name"]}'`
+      );
     } else if (flagType === "table") {
       if (Array.isArray(value)) return value;
       if (typeof value === "string") {
@@ -832,13 +876,17 @@ class ConfigurationManager {
           return value.split(",").map((v) => v.trim());
         }
       }
-      throw new Error(`Cannot convert '${value}' to table for flag '${flag["name"]}'`);
+      throw new Error(
+        `Cannot convert '${value}' to table for flag '${flag["name"]}'`
+      );
     } else {
       if (typeof flagType === "function") {
         try {
           return flagType(value);
         } catch (error) {
-          throw new Error(`Custom type conversion failed for flag '${flag["name"]}': ${error instanceof Error ? error.message : String(error)}`);
+          throw new Error(
+            `Custom type conversion failed for flag '${flag["name"]}': ${error instanceof Error ? error.message : String(error)}`
+          );
         }
       }
       return String(value);
@@ -913,7 +961,9 @@ class ConfigurationManager {
         if (Array.isArray(value)) {
           lines.push(`${flag["name"]}:`);
           for (const item of value) {
-            lines.push(`  - ${typeof item === "string" && item.includes(" ") ? `"${item}"` : item}`);
+            lines.push(
+              `  - ${typeof item === "string" && item.includes(" ") ? `"${item}"` : item}`
+            );
           }
         } else if (typeof value === "string" && value.includes(" ")) {
           lines.push(`${flag["name"]}: "${value}"`);
@@ -1014,8 +1064,8 @@ const zodFlagSchema = z.object({
       // Native Object constructor
       message: "Must be Object constructor"
     }),
-    z.function().args(z.string()).returns(z.any()),
-    // Custom parser function (value: string) => any
+    z.function().args(z.string()).returns(z.union([z.any(), z.promise(z.any())])),
+    // Custom parser function (value: string) => any | Promise<any>
     z.string().refine(
       // String literal types
       (value) => ["boolean", "string", "number", "array", "object"].includes(
@@ -1176,22 +1226,46 @@ class DxtGenerator {
     try {
       const isTestMode = process.env["NODE_ENV"] === "test" || ((_a = process.argv[0]) == null ? void 0 : _a.includes("vitest")) || ((_b = process.argv[1]) == null ? void 0 : _b.includes("vitest")) || ((_c = process.argv[1]) == null ? void 0 : _c.includes("tinypool"));
       if (isTestMode) {
-        return await this.handleTestModeDxtGeneration(processArgs, buildDxtIndex);
+        return await this.handleTestModeDxtGeneration(
+          processArgs,
+          buildDxtIndex
+        );
       }
       const entryPointFile = process.argv[1];
       if (!entryPointFile || !fs.existsSync(entryPointFile)) {
-        console.error(simpleChalk.red(`Error: Entry point file not found: ${entryPointFile}`));
+        console.error(
+          simpleChalk.red(`Error: Entry point file not found: ${entryPointFile}`)
+        );
         return this._handleExit(1, "Entry point file not found", "error");
       }
-      console.log(simpleChalk.cyan(`
-🔧 Building DXT package for entry point: ${path.basename(entryPointFile)}`));
-      await this.buildDxtWithTsdown(entryPointFile);
+      const outputDir = processArgs[buildDxtIndex + 1] || "./dxt";
+      console.log(
+        simpleChalk.cyan(
+          `
+🔧 Building DXT package for entry point: ${path.basename(entryPointFile)}`
+        )
+      );
+      console.log(simpleChalk.gray(`Output directory: ${outputDir}`));
+      await this.buildDxtWithTsdown(entryPointFile, outputDir);
       console.log(simpleChalk.green(`
 ✅ DXT package generation completed!`));
-      return this._handleExit(0, "DXT package generation completed", "success", { entryPoint: entryPointFile });
+      return this._handleExit(
+        0,
+        "DXT package generation completed",
+        "success",
+        { entryPoint: entryPointFile, outputDir }
+      );
     } catch (error) {
-      console.error(simpleChalk.red(`Error generating DXT package: ${error instanceof Error ? error.message : String(error)}`));
-      return this._handleExit(1, `Error generating DXT package: ${error instanceof Error ? error.message : String(error)}`, "error");
+      console.error(
+        simpleChalk.red(
+          `Error generating DXT package: ${error instanceof Error ? error.message : String(error)}`
+        )
+      );
+      return this._handleExit(
+        1,
+        `Error generating DXT package: ${error instanceof Error ? error.message : String(error)}`,
+        "error"
+      );
     }
   }
   /**
@@ -1231,7 +1305,10 @@ class DxtGenerator {
         })),
         icon: "logo.jpg"
       };
-      fs.writeFileSync(path.join(buildDir, "manifest.json"), JSON.stringify(manifest, null, 2));
+      fs.writeFileSync(
+        path.join(buildDir, "manifest.json"),
+        JSON.stringify(manifest, null, 2)
+      );
       const packageJson = {
         name: serverInfo.name,
         version: serverInfo.version,
@@ -1239,7 +1316,10 @@ class DxtGenerator {
         main: "index.mjs",
         type: "module"
       };
-      fs.writeFileSync(path.join(buildDir, "package.json"), JSON.stringify(packageJson, null, 2));
+      fs.writeFileSync(
+        path.join(buildDir, "package.json"),
+        JSON.stringify(packageJson, null, 2)
+      );
       const readme = `# ${serverInfo.name}
 
 ${serverInfo.description}
@@ -1248,13 +1328,25 @@ Generated by @alcyone-labs/arg-parser`;
       fs.writeFileSync(path.join(buildDir, "README.md"), readme);
       const buildScript = `#!/bin/bash
 echo "Mock DXT build script for ${serverInfo.name}"`;
-      fs.writeFileSync(path.join(buildDir, "build-dxt-package.sh"), buildScript);
-      return this._handleExit(0, "DXT package generation completed", "success", {
-        entryPoint: "test-mode",
-        outputDir: buildDir
-      });
+      fs.writeFileSync(
+        path.join(buildDir, "build-dxt-package.sh"),
+        buildScript
+      );
+      return this._handleExit(
+        0,
+        "DXT package generation completed",
+        "success",
+        {
+          entryPoint: "test-mode",
+          outputDir: buildDir
+        }
+      );
     } catch (error) {
-      return this._handleExit(1, `Test mode DXT generation failed: ${error instanceof Error ? error.message : String(error)}`, "error");
+      return this._handleExit(
+        1,
+        `Test mode DXT generation failed: ${error instanceof Error ? error.message : String(error)}`,
+        "error"
+      );
     }
   }
   /**
@@ -1275,9 +1367,17 @@ echo "Mock DXT build script for ${serverInfo.name}"`;
       fs.mkdirSync(serverDir, { recursive: true });
     }
     const logoFilename = await this.addLogoToFolder(buildDir, serverInfo);
-    const manifest = this.createDxtManifest(serverInfo, tools, mcpSubCommand, logoFilename);
+    const manifest = this.createDxtManifest(
+      serverInfo,
+      tools,
+      mcpSubCommand,
+      logoFilename
+    );
     this.validateDxtManifest(manifest);
-    fs.writeFileSync(path.join(buildDir, "manifest.json"), JSON.stringify(manifest, null, 2));
+    fs.writeFileSync(
+      path.join(buildDir, "manifest.json"),
+      JSON.stringify(manifest, null, 2)
+    );
     this.addOriginalCliToFolder(buildDir);
     const bundledCliPath = await this.bundleOriginalCliWithTsdown(serverDir);
     const serverScript = this.createServerScript(serverInfo, bundledCliPath);
@@ -1286,10 +1386,16 @@ echo "Mock DXT build script for ${serverInfo.name}"`;
     try {
       fs.chmodSync(serverScriptPath, 493);
     } catch (error) {
-      console.warn("⚠ Could not set executable permission on server script:", error instanceof Error ? error.message : String(error));
+      console.warn(
+        "⚠ Could not set executable permission on server script:",
+        error instanceof Error ? error.message : String(error)
+      );
     }
     const packageJson = this.createDxtPackageJson(serverInfo);
-    fs.writeFileSync(path.join(buildDir, "package.json"), JSON.stringify(packageJson, null, 2));
+    fs.writeFileSync(
+      path.join(buildDir, "package.json"),
+      JSON.stringify(packageJson, null, 2)
+    );
     const readme = this.createDxtReadme(serverInfo);
     fs.writeFileSync(path.join(buildDir, "README.md"), readme);
     const buildScript = this.createSimpleBuildScript(serverInfo);
@@ -1301,11 +1407,15 @@ echo "Mock DXT build script for ${serverInfo.name}"`;
     } catch (error) {
     }
     console.log(simpleChalk.green(`  ✓ Generated DXT package folder: ${folderName}`));
-    console.log(simpleChalk.gray(`    Server: ${serverInfo.name} v${serverInfo.version}`));
+    console.log(
+      simpleChalk.gray(`    Server: ${serverInfo.name} v${serverInfo.version}`)
+    );
     console.log(simpleChalk.gray(`    Tools: ${tools.length} tool(s)`));
     console.log(simpleChalk.gray(`    Location: ${buildDir}`));
-    console.log(simpleChalk.cyan(`
-📦 Creating DXT package using Anthropic's dxt pack...`));
+    console.log(
+      simpleChalk.cyan(`
+📦 Creating DXT package using Anthropic's dxt pack...`)
+    );
     console.log(simpleChalk.cyan(`
 📋 Manual steps to create your DXT package:`));
     console.log(simpleChalk.white(`   cd ${path.relative(process.cwd(), buildDir)}`));
@@ -1368,7 +1478,9 @@ echo "Mock DXT build script for ${serverInfo.name}"`;
             toolOptions = mcpConfig.toolOptions;
           }
         }
-        const mcpTools = this.argParserInstance.toMcpTools(toolOptions);
+        const mcpTools = this.argParserInstance.toMcpTools(
+          toolOptions
+        );
         return mcpTools.map((tool) => ({
           name: tool.name,
           description: tool.description
@@ -1392,16 +1504,24 @@ echo "Mock DXT build script for ${serverInfo.name}"`;
           });
         }
       }
-      return tools.length > 0 ? tools : [{
-        name: "main",
-        description: "Main command tool"
-      }];
+      return tools.length > 0 ? tools : [
+        {
+          name: "main",
+          description: "Main command tool"
+        }
+      ];
     } catch (error) {
-      console.warn(simpleChalk.yellow(`Warning: Could not generate detailed tool list: ${error instanceof Error ? error.message : String(error)}`));
-      return [{
-        name: "main",
-        description: "Main command tool"
-      }];
+      console.warn(
+        simpleChalk.yellow(
+          `Warning: Could not generate detailed tool list: ${error instanceof Error ? error.message : String(error)}`
+        )
+      );
+      return [
+        {
+          name: "main",
+          description: "Main command tool"
+        }
+      ];
     }
   }
   createDxtManifest(serverInfo, tools, mcpSubCommand, logoFilename) {
@@ -1424,7 +1544,9 @@ echo "Mock DXT build script for ${serverInfo.name}"`;
       }
     }
     if (!author) {
-      throw new Error("DXT manifest requires author information. Please provide it via withMcp() serverInfo.author, addMcpSubCommand serverInfo.author, or in package.json");
+      throw new Error(
+        "DXT manifest requires author information. Please provide it via withMcp() serverInfo.author, addMcpSubCommand serverInfo.author, or in package.json"
+      );
     }
     const cliArgs = this.generateCliArgsForDxt(mcpSubCommand);
     const { envVars, userConfig } = this.generateEnvAndUserConfig();
@@ -1467,31 +1589,41 @@ echo "Mock DXT build script for ${serverInfo.name}"`;
   }
   validateDxtManifest(manifest) {
     const errors = [];
-    if (!manifest.dxt_version) errors.push("Missing required field: dxt_version");
+    if (!manifest.dxt_version)
+      errors.push("Missing required field: dxt_version");
     if (!manifest.name) errors.push("Missing required field: name");
     if (!manifest.version) errors.push("Missing required field: version");
     if (!manifest.server) errors.push("Missing required field: server");
     if (!manifest.author) errors.push("Missing required field: author");
     if (manifest.server) {
-      if (!manifest.server.type) errors.push("Missing required field: server.type");
-      if (!manifest.server.entry_point) errors.push("Missing required field: server.entry_point");
-      if (!manifest.server.mcp_config) errors.push("Missing required field: server.mcp_config");
+      if (!manifest.server.type)
+        errors.push("Missing required field: server.type");
+      if (!manifest.server.entry_point)
+        errors.push("Missing required field: server.entry_point");
+      if (!manifest.server.mcp_config)
+        errors.push("Missing required field: server.mcp_config");
       if (manifest.server.mcp_config) {
-        if (!manifest.server.mcp_config.command) errors.push("Missing required field: server.mcp_config.command");
+        if (!manifest.server.mcp_config.command)
+          errors.push("Missing required field: server.mcp_config.command");
         if (!manifest.server.mcp_config.args || !Array.isArray(manifest.server.mcp_config.args)) {
-          errors.push("Missing or invalid field: server.mcp_config.args (must be array)");
+          errors.push(
+            "Missing or invalid field: server.mcp_config.args (must be array)"
+          );
         }
       }
     }
     if (manifest.author && typeof manifest.author === "object") {
-      if (!manifest.author.name) errors.push("Missing required field: author.name");
+      if (!manifest.author.name)
+        errors.push("Missing required field: author.name");
     }
     if (manifest.dxt_version && manifest.dxt_version !== "0.1") {
       errors.push("Unsupported dxt_version: only '0.1' is currently supported");
     }
     if (errors.length > 0) {
-      throw new Error(`DXT manifest validation failed:
-${errors.map((e) => `  - ${e}`).join("\n")}`);
+      throw new Error(
+        `DXT manifest validation failed:
+${errors.map((e) => `  - ${e}`).join("\n")}`
+      );
     }
   }
   createServerScript(serverInfo, bundledCliPath) {
@@ -1535,27 +1667,34 @@ originalCli.parse(['--s-mcp-serve']);
     try {
       const originalPackageJsonPath = path.join(process.cwd(), "package.json");
       if (fs.existsSync(originalPackageJsonPath)) {
-        const originalPackageJson = JSON.parse(fs.readFileSync(originalPackageJsonPath, "utf8"));
+        const originalPackageJson = JSON.parse(
+          fs.readFileSync(originalPackageJsonPath, "utf8")
+        );
         originalDependencies = originalPackageJson.dependencies || {};
       }
     } catch (error) {
-      console.warn("⚠ Could not read original package.json for dependencies:", error instanceof Error ? error.message : String(error));
+      console.warn(
+        "⚠ Could not read original package.json for dependencies:",
+        error instanceof Error ? error.message : String(error)
+      );
     }
     const dependencies2 = {
       ...originalDependencies,
       "@alcyone-labs/arg-parser": argParserDependency,
       "@alcyone-labs/simple-mcp-logger": "^1.0.0",
       "@modelcontextprotocol/sdk": "^1.15.0",
-      "zod": "^3.22.4"
+      zod: "^3.22.4"
     };
     const devDependencies = {
-      "tsup": "^8.3.5"
+      tsup: "^8.3.5"
     };
     Object.keys(dependencies2).forEach((key) => {
       const depValue = dependencies2[key];
       if (key !== "@alcyone-labs/arg-parser" && typeof depValue === "string" && depValue.startsWith("file:")) {
         delete dependencies2[key];
-        console.warn(`⚠ Removed file: dependency ${key} from DXT package (not suitable for distribution)`);
+        console.warn(
+          `⚠ Removed file: dependency ${key} from DXT package (not suitable for distribution)`
+        );
       }
     });
     return {
@@ -1901,7 +2040,7 @@ For autonomous packages, follow the build instructions above.
    * Adds the logo to the build folder if available
    * @returns The filename of the logo that was added, or undefined if no logo was added
    */
-  async addLogoToFolder(buildDir, serverInfo) {
+  async addLogoToFolder(buildDir, serverInfo, entryPointFile) {
     try {
       let logoBuffer = null;
       let logoFilename = "logo.jpg";
@@ -1920,13 +2059,27 @@ For autonomous packages, follow the build instructions above.
               }
               console.log("✓ Downloaded logo from URL");
             } else {
-              console.warn(`⚠ Failed to download logo: HTTP ${response.status}`);
+              console.warn(
+                `⚠ Failed to download logo: HTTP ${response.status}`
+              );
             }
           } catch (error) {
-            console.warn("⚠ Failed to download logo from URL:", error instanceof Error ? error.message : String(error));
+            console.warn(
+              "⚠ Failed to download logo from URL:",
+              error instanceof Error ? error.message : String(error)
+            );
           }
         } else {
-          const logoPath = path.resolve(customLogo);
+          let logoPath;
+          if (entryPointFile && !path.isAbsolute(customLogo)) {
+            const entryDir = path.dirname(entryPointFile);
+            logoPath = path.resolve(entryDir, customLogo);
+            console.log(
+              `📍 Resolving logo path relative to entry point: ${logoPath}`
+            );
+          } else {
+            logoPath = path.resolve(customLogo);
+          }
           if (fs.existsSync(logoPath)) {
             logoBuffer = fs.readFileSync(logoPath);
             logoFilename = path.basename(logoPath);
@@ -1940,17 +2093,32 @@ For autonomous packages, follow the build instructions above.
         const currentDir = path.dirname(new URL(import.meta.url).pathname);
         let logoPath = path.join(currentDir, "assets", "logo_1_small.jpg");
         if (!fs.existsSync(logoPath)) {
-          logoPath = path.join(currentDir, "..", "docs", "MCP", "icons", "logo_1_small.jpg");
+          logoPath = path.join(
+            currentDir,
+            "..",
+            "docs",
+            "MCP",
+            "icons",
+            "logo_1_small.jpg"
+          );
         }
         if (!fs.existsSync(logoPath)) {
-          logoPath = path.join(process.cwd(), "docs", "MCP", "icons", "logo_1_small.jpg");
+          logoPath = path.join(
+            process.cwd(),
+            "docs",
+            "MCP",
+            "icons",
+            "logo_1_small.jpg"
+          );
         }
         if (fs.existsSync(logoPath)) {
           logoBuffer = fs.readFileSync(logoPath);
           logoFilename = "logo.jpg";
           console.log("✓ Added default logo to build folder");
         } else {
-          console.warn("⚠ No logo found (custom or default), build folder will be created without icon");
+          console.warn(
+            "⚠ No logo found (custom or default), build folder will be created without icon"
+          );
           return void 0;
         }
       }
@@ -1960,7 +2128,10 @@ For autonomous packages, follow the build instructions above.
       }
       return void 0;
     } catch (error) {
-      console.warn("⚠ Failed to add logo to build folder:", error instanceof Error ? error.message : String(error));
+      console.warn(
+        "⚠ Failed to add logo to build folder:",
+        error instanceof Error ? error.message : String(error)
+      );
       return void 0;
     }
   }
@@ -2010,7 +2181,12 @@ globalThis.console = {
       }
     }
     if (lastImportIndex >= 0) {
-      lines.splice(lastImportIndex + 1, 0, "", ...consoleReplacement.trim().split("\n"));
+      lines.splice(
+        lastImportIndex + 1,
+        0,
+        "",
+        ...consoleReplacement.trim().split("\n")
+      );
       return lines.join("\n");
     } else {
       return consoleReplacement + cliSource;
@@ -2035,14 +2211,32 @@ globalThis.console = {
         path.join(process.cwd(), `${appCommandName}.js`),
         path.join(process.cwd(), `${appCommandName}.mjs`),
         // Look for files with the app command name (sanitized)
-        path.join(process.cwd(), `${appCommandName.replace(/[^a-zA-Z0-9-]/g, "-")}.js`),
-        path.join(process.cwd(), `${appCommandName.replace(/[^a-zA-Z0-9-]/g, "-")}.mjs`),
+        path.join(
+          process.cwd(),
+          `${appCommandName.replace(/[^a-zA-Z0-9-]/g, "-")}.js`
+        ),
+        path.join(
+          process.cwd(),
+          `${appCommandName.replace(/[^a-zA-Z0-9-]/g, "-")}.mjs`
+        ),
         // Look for files with app name patterns
-        path.join(process.cwd(), `${appName.toLowerCase().replace(/\s+/g, "-")}-cli.js`),
-        path.join(process.cwd(), `${appName.toLowerCase().replace(/\s+/g, "-")}-cli.mjs`),
+        path.join(
+          process.cwd(),
+          `${appName.toLowerCase().replace(/\s+/g, "-")}-cli.js`
+        ),
+        path.join(
+          process.cwd(),
+          `${appName.toLowerCase().replace(/\s+/g, "-")}-cli.mjs`
+        ),
         // Look for files with first word of app name + cli
-        path.join(process.cwd(), `${appName.split(" ")[0].toLowerCase()}-cli.js`),
-        path.join(process.cwd(), `${appName.split(" ")[0].toLowerCase()}-cli.mjs`)
+        path.join(
+          process.cwd(),
+          `${appName.split(" ")[0].toLowerCase()}-cli.js`
+        ),
+        path.join(
+          process.cwd(),
+          `${appName.split(" ")[0].toLowerCase()}-cli.mjs`
+        )
       ];
       let cliSourcePath = null;
       for (const filePath of possibleCliFiles) {
@@ -2062,7 +2256,9 @@ globalThis.console = {
           "import $1 from '@alcyone-labs/arg-parser';"
         );
         cliSource = this.processCliSourceForMcp(cliSource);
-        const parserVariableMatch = cliSource.match(/const\s+(\w+)\s*=\s*ArgParser\.withMcp\(/);
+        const parserVariableMatch = cliSource.match(
+          /const\s+(\w+)\s*=\s*ArgParser\.withMcp\(/
+        );
         if (parserVariableMatch) {
           const parserVariable = parserVariableMatch[1];
           cliSource += `
@@ -2128,26 +2324,38 @@ if (process.argv.includes('serve')) {
 }
 `;
         } else {
-          console.warn("⚠ Could not find ArgParser instance in CLI source, MCP server may not work properly");
+          console.warn(
+            "⚠ Could not find ArgParser instance in CLI source, MCP server may not work properly"
+          );
         }
         const serverDir = path.join(buildDir, "server");
         if (!fs.existsSync(serverDir)) {
           fs.mkdirSync(serverDir, { recursive: true });
         }
         fs.writeFileSync(path.join(serverDir, "original-cli.mjs"), cliSource);
-        console.log(`✓ Added original CLI source to build folder: ${path.basename(cliSourcePath)}`);
+        console.log(
+          `✓ Added original CLI source to build folder: ${path.basename(cliSourcePath)}`
+        );
       } else {
-        console.warn("⚠ Original CLI source not found, handlers may not work properly");
-        console.warn("  Searched for:", possibleCliFiles.map((f) => path.basename(f)).join(", "));
+        console.warn(
+          "⚠ Original CLI source not found, handlers may not work properly"
+        );
+        console.warn(
+          "  Searched for:",
+          possibleCliFiles.map((f) => path.basename(f)).join(", ")
+        );
       }
     } catch (error) {
-      console.warn("⚠ Failed to add original CLI source:", error instanceof Error ? error.message : String(error));
+      console.warn(
+        "⚠ Failed to add original CLI source:",
+        error instanceof Error ? error.message : String(error)
+      );
     }
   }
   /**
    * Builds a complete DXT package using TSDown CLI for autonomous execution
    */
-  async buildDxtWithTsdown(entryPointFile) {
+  async buildDxtWithTsdown(entryPointFile, outputDir = "./dxt") {
     try {
       console.log(simpleChalk.cyan("🔧 Building DXT package with TSDown..."));
       const entryDir = path.dirname(entryPointFile);
@@ -2165,7 +2373,7 @@ if (process.argv.includes('serve')) {
         console.log(simpleChalk.gray(`Building with TSDown: ${entryFileName}`));
         const buildConfig = {
           entry: [entryFileName],
-          outDir: "dxt",
+          outDir: path.resolve(process.cwd(), outputDir),
           format: ["esm"],
           target: "node22",
           noExternal: () => true,
@@ -2178,13 +2386,35 @@ if (process.argv.includes('serve')) {
             ...(() => {
               const possibleLogoPaths = [
                 // From built library assets
-                path.join(path.dirname(new URL(import.meta.url).pathname), "..", "assets", "logo_1_small.jpg"),
+                path.join(
+                  path.dirname(new URL(import.meta.url).pathname),
+                  "..",
+                  "assets",
+                  "logo_1_small.jpg"
+                ),
                 // From node_modules
-                path.join(process.cwd(), "node_modules", "@alcyone-labs", "arg-parser", "dist", "assets", "logo_1_small.jpg"),
+                path.join(
+                  process.cwd(),
+                  "node_modules",
+                  "@alcyone-labs",
+                  "arg-parser",
+                  "dist",
+                  "assets",
+                  "logo_1_small.jpg"
+                ),
                 // From package root dist/assets (for local build)
                 path.join(process.cwd(), "dist", "assets", "logo_1_small.jpg"),
                 // From library root (development)
-                path.join(process.cwd(), "..", "..", "..", "docs", "MCP", "icons", "logo_1_small.jpg")
+                path.join(
+                  process.cwd(),
+                  "..",
+                  "..",
+                  "..",
+                  "docs",
+                  "MCP",
+                  "icons",
+                  "logo_1_small.jpg"
+                )
               ];
               for (const logoPath of possibleLogoPaths) {
                 if (fs.existsSync(logoPath)) {
@@ -2192,7 +2422,9 @@ if (process.argv.includes('serve')) {
                   return [{ from: logoPath, to: "logo.jpg" }];
                 }
               }
-              console.log(simpleChalk.yellow("⚠ Logo not found in any expected location"));
+              console.log(
+                simpleChalk.yellow("⚠ Logo not found in any expected location")
+              );
               return [];
             })()
           ],
@@ -2232,20 +2464,39 @@ export default ${JSON.stringify(buildConfig, null, 2)};
 // To run manually:
 // npx tsdown -c tsdown.config.dxt.ts
 `;
-          fs.writeFileSync(path.join("dxt", "tsdown.config.dxt.ts"), configContent);
-          console.log(simpleChalk.gray("📝 Debug config written to dxt/tsdown.config.dxt.ts"));
+          fs.writeFileSync(
+            path.join("dxt", "tsdown.config.dxt.ts"),
+            configContent
+          );
+          console.log(
+            simpleChalk.gray("📝 Debug config written to dxt/tsdown.config.dxt.ts")
+          );
         }
         await build(buildConfig);
         console.log(simpleChalk.green("✅ TSDown bundling completed"));
-        await this.copyLogoManually();
-        await this.setupDxtPackageFiles(entryPointFile);
+        const actualOutputFilename = this.detectTsdownOutputFile(
+          outputDir,
+          entryFileName
+        );
+        await this.copyLogoManually(outputDir);
+        await this.setupDxtPackageFiles(
+          entryPointFile,
+          outputDir,
+          actualOutputFilename ?? void 0
+        );
         console.log(simpleChalk.cyan("📦 DXT package ready for packing"));
-        console.log(simpleChalk.gray("To complete the process, run: npx @anthropic-ai/dxt pack dxt/"));
+        console.log(
+          simpleChalk.gray(
+            `To complete the process, run: npx @anthropic-ai/dxt pack ${outputDir}/`
+          )
+        );
       } finally {
         process.chdir(originalCwd);
       }
     } catch (error) {
-      throw new Error(`TSDown DXT build failed: ${error instanceof Error ? error.message : String(error)}`);
+      throw new Error(
+        `TSDown DXT build failed: ${error instanceof Error ? error.message : String(error)}`
+      );
     }
   }
   /**
@@ -2254,13 +2505,17 @@ export default ${JSON.stringify(buildConfig, null, 2)};
   async bundleOriginalCliWithTsdown(serverDir) {
     try {
       const { build } = await import("tsdown");
-      console.log(simpleChalk.cyan("🔧 Bundling CLI with TSDown for autonomous execution..."));
+      console.log(
+        simpleChalk.cyan("🔧 Bundling CLI with TSDown for autonomous execution...")
+      );
       const configContent = this.getTsdownConfigContent();
       const localConfigPath = path.join(serverDir, "tsdown.config.mjs");
       fs.writeFileSync(localConfigPath, configContent);
       const originalCliPath = path.join(serverDir, "original-cli.mjs");
       if (!fs.existsSync(originalCliPath)) {
-        console.warn(simpleChalk.yellow("⚠ Original CLI not found, skipping TSDown bundling"));
+        console.warn(
+          simpleChalk.yellow("⚠ Original CLI not found, skipping TSDown bundling")
+        );
         return null;
       }
       const buildOptions = {
@@ -2281,7 +2536,10 @@ export default ${JSON.stringify(buildConfig, null, 2)};
         outExtension: () => ({ js: ".bundled.mjs" }),
         alias: {
           // Alias chalk to SimpleChalk for autonomous builds
-          chalk: path.resolve(process.cwd(), "node_modules/@alcyone-labs/arg-parser/dist/SimpleChalk.mjs")
+          chalk: path.resolve(
+            process.cwd(),
+            "node_modules/@alcyone-labs/arg-parser/dist/SimpleChalk.mjs"
+          )
         },
         external: [
           // Only Node.js built-ins - everything else gets bundled for true autonomy
@@ -2373,8 +2631,15 @@ export default ${JSON.stringify(buildConfig, null, 2)};
         }
       }
       if (bundledPath && bundledFileName) {
-        console.log(simpleChalk.green(`✅ TSDown bundling completed successfully: ${bundledFileName}`));
-        const expectedBundledPath = path.join(serverDir, "original-cli.bundled.mjs");
+        console.log(
+          simpleChalk.green(
+            `✅ TSDown bundling completed successfully: ${bundledFileName}`
+          )
+        );
+        const expectedBundledPath = path.join(
+          serverDir,
+          "original-cli.bundled.mjs"
+        );
         if (bundledPath !== expectedBundledPath) {
           fs.renameSync(bundledPath, expectedBundledPath);
           bundledFileName = "original-cli.bundled.mjs";
@@ -2386,15 +2651,24 @@ export default ${JSON.stringify(buildConfig, null, 2)};
         try {
           fs.chmodSync(expectedBundledPath, 493);
         } catch (error) {
-          console.warn("⚠ Could not set executable permission on bundled file:", error instanceof Error ? error.message : String(error));
+          console.warn(
+            "⚠ Could not set executable permission on bundled file:",
+            error instanceof Error ? error.message : String(error)
+          );
         }
         return bundledFileName;
       } else {
-        console.warn(simpleChalk.yellow("⚠ TSDown bundling failed, bundled file not found"));
+        console.warn(
+          simpleChalk.yellow("⚠ TSDown bundling failed, bundled file not found")
+        );
         return null;
       }
     } catch (error) {
-      console.warn(simpleChalk.yellow(`⚠ TSDown bundling failed: ${error instanceof Error ? error.message : String(error)}`));
+      console.warn(
+        simpleChalk.yellow(
+          `⚠ TSDown bundling failed: ${error instanceof Error ? error.message : String(error)}`
+        )
+      );
       console.log(simpleChalk.gray("  Falling back to non-bundled approach"));
       return null;
     }
@@ -2449,22 +2723,44 @@ export default ${JSON.stringify(buildConfig, null, 2)};
    */
   getTsdownConfigContent() {
     const currentDir = path.dirname(new URL(import.meta.url).pathname);
-    const assetsConfigPath = path.join(currentDir, "..", "assets", "tsdown.dxt.config.ts");
+    const assetsConfigPath = path.join(
+      currentDir,
+      "..",
+      "assets",
+      "tsdown.dxt.config.ts"
+    );
     if (fs.existsSync(assetsConfigPath)) {
       try {
         const content = fs.readFileSync(assetsConfigPath, "utf-8");
-        return content.replace('/// <reference types="tsdown" />', "").replace('import { defineConfig } from "tsdown/config";', 'import { defineConfig } from "tsdown";').replace("export default defineConfig(", "export default defineConfig(");
+        return content.replace('/// <reference types="tsdown" />', "").replace(
+          'import { defineConfig } from "tsdown/config";',
+          'import { defineConfig } from "tsdown";'
+        ).replace(
+          "export default defineConfig(",
+          "export default defineConfig("
+        );
       } catch (error) {
-        console.warn(simpleChalk.yellow("⚠ Could not read TSDown config from assets, using fallback"));
+        console.warn(
+          simpleChalk.yellow(
+            "⚠ Could not read TSDown config from assets, using fallback"
+          )
+        );
       }
     }
     const rootConfigPath = path.join(process.cwd(), "tsdown.dxt.config.ts");
     if (fs.existsSync(rootConfigPath)) {
       try {
         const content = fs.readFileSync(rootConfigPath, "utf-8");
-        return content.replace('/// <reference types="tsdown" />', "").replace('import { defineConfig } from "tsdown/config";', 'import { defineConfig } from "tsdown";');
+        return content.replace('/// <reference types="tsdown" />', "").replace(
+          'import { defineConfig } from "tsdown/config";',
+          'import { defineConfig } from "tsdown";'
+        );
       } catch (error) {
-        console.warn(simpleChalk.yellow("⚠ Could not read TSDown config from root, using default"));
+        console.warn(
+          simpleChalk.yellow(
+            "⚠ Could not read TSDown config from root, using default"
+          )
+        );
       }
     }
     return `import { defineConfig } from "tsdown";
@@ -2495,9 +2791,22 @@ export default defineConfig({
   getDxtIgnoreTemplatePath() {
     const possiblePaths = [
       // 1. From the built library assets (when installed via npm)
-      path.join(path.dirname(new URL(import.meta.url).pathname), "..", "assets", ".dxtignore.template"),
+      path.join(
+        path.dirname(new URL(import.meta.url).pathname),
+        "..",
+        "assets",
+        ".dxtignore.template"
+      ),
       // 2. From node_modules/@alcyone-labs/arg-parser/dist/assets (when installed via npm)
-      path.join(process.cwd(), "node_modules", "@alcyone-labs", "arg-parser", "dist", "assets", ".dxtignore.template"),
+      path.join(
+        process.cwd(),
+        "node_modules",
+        "@alcyone-labs",
+        "arg-parser",
+        "dist",
+        "assets",
+        ".dxtignore.template"
+      ),
       // 3. From the root directory (development/local build)
       path.join(process.cwd(), ".dxtignore.template"),
       // 4. From the library root (when using local file dependency)
@@ -2513,13 +2822,13 @@ export default defineConfig({
     return "";
   }
   /**
-   * Sets up DXT package files (manifest.json) in the dxt output directory
+   * Sets up DXT package files (manifest.json) in the output directory
    */
-  async setupDxtPackageFiles(entryPointFile) {
+  async setupDxtPackageFiles(entryPointFile, outputDir = "./dxt", actualOutputFilename) {
     var _a, _b, _c, _d, _e;
-    const dxtDir = "./dxt";
+    const dxtDir = path.resolve(process.cwd(), outputDir);
     if (!fs.existsSync(dxtDir)) {
-      throw new Error("TSDown output directory (dxt) not found");
+      throw new Error(`TSDown output directory (${outputDir}) not found`);
     }
     const packageJsonPath = path.join(process.cwd(), "package.json");
     let packageInfo = {};
@@ -2538,7 +2847,11 @@ export default defineConfig({
         description: tool.description
       }));
     } catch (error) {
-      console.warn(simpleChalk.yellow(`Warning: Could not generate unified tool list: ${error instanceof Error ? error.message : String(error)}`));
+      console.warn(
+        simpleChalk.yellow(
+          `Warning: Could not generate unified tool list: ${error instanceof Error ? error.message : String(error)}`
+        )
+      );
       const mainFlags2 = this.argParserInstance.flags;
       const properties2 = {};
       const required2 = [];
@@ -2559,10 +2872,12 @@ export default defineConfig({
         }
       }
       const commandName = this.argParserInstance.getAppCommandName();
-      tools = [{
-        name: commandName || packageInfo.name || "cli-tool",
-        description: packageInfo.description || this.argParserInstance.getDescription() || "CLI tool"
-      }];
+      tools = [
+        {
+          name: commandName || packageInfo.name || "cli-tool",
+          description: packageInfo.description || this.argParserInstance.getDescription() || "CLI tool"
+        }
+      ];
     }
     const envVars = {};
     const userConfig = {};
@@ -2604,7 +2919,18 @@ export default defineConfig({
       }
     }
     const serverInfo = this.extractMcpServerInfo();
-    const entryFileName = path.basename(entryPointFile);
+    let logoFilename = "logo.jpg";
+    if (serverInfo == null ? void 0 : serverInfo.logo) {
+      const customLogoFilename = await this.addLogoToFolder(
+        dxtDir,
+        serverInfo,
+        entryPointFile
+      );
+      if (customLogoFilename) {
+        logoFilename = customLogoFilename;
+      }
+    }
+    const entryFileName = actualOutputFilename || path.basename(entryPointFile).replace(/\.ts$/, ".js");
     const manifest = {
       dxt_version: "0.1",
       name: serverInfo.name || packageInfo.name || "mcp-server",
@@ -2620,15 +2946,12 @@ export default defineConfig({
         entry_point: entryFileName,
         mcp_config: {
           command: "node",
-          args: [
-            `\${__dirname}/${entryFileName}`,
-            "--s-mcp-serve"
-          ],
+          args: [`\${__dirname}/${entryFileName}`, "--s-mcp-serve"],
           env: envVars
         }
       },
       tools,
-      icon: "logo.jpg",
+      icon: logoFilename,
       ...Object.keys(userConfig).length > 0 && { user_config: userConfig },
       repository: {
         type: "git",
@@ -2636,27 +2959,56 @@ export default defineConfig({
       },
       license: packageInfo.license || "MIT"
     };
-    fs.writeFileSync(path.join(dxtDir, "manifest.json"), JSON.stringify(manifest, null, 2));
+    fs.writeFileSync(
+      path.join(dxtDir, "manifest.json"),
+      JSON.stringify(manifest, null, 2)
+    );
     console.log(simpleChalk.gray("✅ DXT package files set up"));
   }
   /**
    * Manually copy logo since TSDown's copy option doesn't work programmatically
    */
-  async copyLogoManually() {
-    const dxtDir = "./dxt";
+  async copyLogoManually(outputDir = "./dxt") {
+    const dxtDir = path.resolve(process.cwd(), outputDir);
     if (!fs.existsSync(dxtDir)) {
-      console.warn(simpleChalk.yellow("⚠ DXT directory not found, skipping logo copy"));
+      console.warn(
+        simpleChalk.yellow(
+          `⚠ Output directory (${outputDir}) not found, skipping logo copy`
+        )
+      );
       return;
     }
     const possibleLogoPaths = [
       // From built library assets
-      path.join(path.dirname(new URL(import.meta.url).pathname), "..", "assets", "logo_1_small.jpg"),
+      path.join(
+        path.dirname(new URL(import.meta.url).pathname),
+        "..",
+        "assets",
+        "logo_1_small.jpg"
+      ),
       // From node_modules
-      path.join(process.cwd(), "node_modules", "@alcyone-labs", "arg-parser", "dist", "assets", "logo_1_small.jpg"),
+      path.join(
+        process.cwd(),
+        "node_modules",
+        "@alcyone-labs",
+        "arg-parser",
+        "dist",
+        "assets",
+        "logo_1_small.jpg"
+      ),
       // From package root dist/assets (for local build)
       path.join(process.cwd(), "dist", "assets", "logo_1_small.jpg"),
       // From library root (development)
-      path.join(process.cwd(), "..", "..", "..", "docs", "MCP", "icons", "logo_1_small.jpg")
+      path.join(
+        process.cwd(),
+        "..",
+        "..",
+        "..",
+        "docs",
+        "MCP",
+        "icons",
+        "logo_1_small.jpg"
+      )
     ];
     for (const logoPath of possibleLogoPaths) {
       if (fs.existsSync(logoPath)) {
@@ -2665,12 +3017,78 @@ export default defineConfig({
           console.log(simpleChalk.gray(`✅ Logo copied from: ${logoPath}`));
           return;
         } catch (error) {
-          console.warn(simpleChalk.yellow(`⚠ Failed to copy logo from ${logoPath}: ${error}`));
+          console.warn(
+            simpleChalk.yellow(`⚠ Failed to copy logo from ${logoPath}: ${error}`)
+          );
         }
       }
     }
     console.warn(simpleChalk.yellow("⚠ Logo not found in any expected location"));
   }
+  /**
+   * Detects the actual output filename generated by TSDown
+   */
+  detectTsdownOutputFile(outputDir, expectedBaseName) {
+    try {
+      const dxtDir = path.resolve(process.cwd(), outputDir);
+      if (!fs.existsSync(dxtDir)) {
+        console.warn(
+          simpleChalk.yellow(`⚠ Output directory (${outputDir}) not found`)
+        );
+        return null;
+      }
+      const files = fs.readdirSync(dxtDir).filter(
+        (file) => (file.endsWith(".js") || file.endsWith(".mjs")) && !file.includes("chunk-") && !file.includes("dist-") && !file.startsWith(".")
+      );
+      const baseNameWithoutExt = path.parse(expectedBaseName).name;
+      for (const ext of [".js", ".mjs"]) {
+        const exactMatch = `${baseNameWithoutExt}${ext}`;
+        if (files.includes(exactMatch)) {
+          console.log(simpleChalk.gray(`✓ Detected TSDown output: ${exactMatch}`));
+          return exactMatch;
+        }
+      }
+      const mainFiles = files.filter(
+        (file) => !file.includes("chunk") && !file.includes("dist") && file !== "logo.jpg" && file !== "manifest.json"
+      );
+      if (mainFiles.length === 1) {
+        console.log(simpleChalk.gray(`✓ Detected TSDown output: ${mainFiles[0]}`));
+        return mainFiles[0];
+      }
+      if (mainFiles.length > 1) {
+        let bestMatch = mainFiles[0];
+        let bestScore = 0;
+        for (const file of mainFiles) {
+          const filePath = path.join(dxtDir, file);
+          const stats = fs.statSync(filePath);
+          const nameScore = file.includes(baseNameWithoutExt) ? 100 : 0;
+          const sizeScore = Math.min(stats.size / 1e3, 50);
+          const totalScore = nameScore + sizeScore;
+          if (totalScore > bestScore) {
+            bestScore = totalScore;
+            bestMatch = file;
+          }
+        }
+        console.log(
+          simpleChalk.gray(
+            `✓ Detected TSDown output: ${bestMatch} (best match from ${mainFiles.length} candidates)`
+          )
+        );
+        return bestMatch;
+      }
+      console.warn(
+        simpleChalk.yellow(`⚠ Could not detect TSDown output file in ${outputDir}`)
+      );
+      return null;
+    } catch (error) {
+      console.warn(
+        simpleChalk.yellow(
+          `⚠ Error detecting TSDown output: ${error instanceof Error ? error.message : String(error)}`
+        )
+      );
+      return null;
+    }
+  }
 }
 class McpNotificationsManager {
   constructor() {
@@ -2824,10 +3242,16 @@ class McpNotificationsManager {
   sendNotificationToClient(client, type2) {
     try {
       if (client.connection && typeof client.connection.sendNotification === "function") {
-        client.connection.sendNotification(`notifications/${type2}/list_changed`, {});
+        client.connection.sendNotification(
+          `notifications/${type2}/list_changed`,
+          {}
+        );
       }
     } catch (error) {
-      console.error(`Error sending notification to client ${client.clientId}:`, error);
+      console.error(
+        `Error sending notification to client ${client.clientId}:`,
+        error
+      );
       this.removeClient(client.clientId);
     }
   }
@@ -2916,7 +3340,9 @@ class McpPromptsManager {
       return await entry.config.handler(validatedArgs);
     } catch (error) {
       if (error instanceof z.ZodError) {
-        throw new Error(`Invalid arguments for prompt '${name}': ${error.message}`);
+        throw new Error(
+          `Invalid arguments for prompt '${name}': ${error.message}`
+        );
       }
       throw error;
     }
@@ -3116,7 +3542,9 @@ class McpResourcesManager {
     try {
       new ResourceTemplateParser(config.uriTemplate);
     } catch (error) {
-      throw new Error(`Invalid URI template '${config.uriTemplate}': ${error instanceof Error ? error.message : String(error)}`);
+      throw new Error(
+        `Invalid URI template '${config.uriTemplate}': ${error instanceof Error ? error.message : String(error)}`
+      );
     }
   }
   /**
@@ -3221,6 +3649,97 @@ const _FlagManager = class _FlagManager {
 __flags = new WeakMap();
 _throwForDuplicateFlags = new WeakMap();
 let FlagManager = _FlagManager;
+function detectEntryPoint() {
+  try {
+    if (process.argv[1] && fs.existsSync(process.argv[1])) {
+      return process.argv[1];
+    }
+    if (typeof require !== "undefined" && require.main && require.main.filename) {
+      return require.main.filename;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function getEntryPointFromImportMeta(importMetaUrl) {
+  if (importMetaUrl.startsWith("file://")) {
+    return decodeURIComponent(importMetaUrl.replace("file://", ""));
+  }
+  return importMetaUrl;
+}
+function normalizePath(path2) {
+  return path2.trim();
+}
+function resolveLogPath(logPath, fallbackEntryPoint) {
+  if (typeof logPath === "string") {
+    const normalizedPath2 = normalizePath(logPath);
+    if (path.isAbsolute(normalizedPath2)) {
+      return normalizedPath2;
+    }
+    if (normalizedPath2.startsWith("cwd:")) {
+      const relativePath = normalizedPath2.slice(4);
+      return path.resolve(process.cwd(), relativePath);
+    }
+    const entryPoint = detectEntryPoint() || fallbackEntryPoint;
+    if (entryPoint) {
+      return path.resolve(path.dirname(entryPoint), normalizedPath2);
+    }
+    console.warn(
+      `Warning: Could not detect entry point for log path resolution. Using process.cwd() as fallback. Path: ${normalizedPath2}`
+    );
+    return path.resolve(process.cwd(), normalizedPath2);
+  }
+  const { path: logFilePath, relativeTo = "entry", basePath } = logPath;
+  const normalizedPath = normalizePath(logFilePath);
+  switch (relativeTo) {
+    case "absolute":
+      if (basePath) {
+        return path.resolve(basePath, normalizedPath);
+      }
+      if (path.isAbsolute(normalizedPath)) {
+        return normalizedPath;
+      }
+      console.warn(
+        `Warning: relativeTo 'absolute' specified but no basePath provided and path is not absolute. Using process.cwd() as fallback. Path: ${normalizedPath}`
+      );
+      return path.resolve(process.cwd(), normalizedPath);
+    case "cwd":
+      return path.resolve(process.cwd(), normalizedPath);
+    case "entry":
+    default:
+      const entryPoint = detectEntryPoint() || fallbackEntryPoint;
+      if (entryPoint) {
+        return path.resolve(path.dirname(entryPoint), normalizedPath);
+      }
+      console.warn(
+        `Warning: Could not detect entry point for log path resolution. Using process.cwd() as fallback. Path: ${normalizedPath}`
+      );
+      return path.resolve(process.cwd(), normalizedPath);
+  }
+}
+function entryRelative(path2) {
+  return {
+    path: path2,
+    relativeTo: "entry"
+  };
+}
+function cwdRelative(path2) {
+  return {
+    path: path2,
+    relativeTo: "cwd"
+  };
+}
+function absolutePath(path2, basePath) {
+  return {
+    path: path2,
+    relativeTo: "absolute",
+    basePath
+  };
+}
+function legacyCwdPath(path2) {
+  return `cwd:${path2}`;
+}
 class ArgParserError extends Error {
   constructor(message, cmdChain = []) {
     super(message);
@@ -3349,7 +3868,7 @@ const _ArgParserBase = class _ArgParserBase {
   getSubCommands() {
     return __privateGet(this, _subCommands);
   }
-  _addToOutput(flag, arg, output, _parseOptions) {
+  async _addToOutput(flag, arg, output, _parseOptions) {
     let value = arg;
     if (flag["type"] === Boolean) {
       if (typeof arg === "boolean") {
@@ -3360,7 +3879,8 @@ const _ArgParserBase = class _ArgParserBase {
         value = new flag["type"](value);
       }
     } else if (typeof flag["type"] === "function") {
-      value = flag["type"](value);
+      const result = flag["type"](value);
+      value = result && typeof result.then === "function" ? await result : result;
     } else if (typeof flag["type"] === "object") {
       value = new flag["type"](value);
     }
@@ -3473,7 +3993,26 @@ const _ArgParserBase = class _ArgParserBase {
     }
   }
   async parse(processArgs, options) {
-    var _a;
+    var _a, _b;
+    if (processArgs === void 0) {
+      if (typeof process !== "undefined" && process.argv && Array.isArray(process.argv)) {
+        processArgs = process.argv.slice(2);
+        const isCliMode = !__privateGet(this, _parentParser) && !!__privateGet(this, _appCommandName);
+        const isMcpMode = (options == null ? void 0 : options.isMcp) || ((_a = globalThis.console) == null ? void 0 : _a.mcpError);
+        if (isCliMode && !isMcpMode) {
+          console.warn(
+            `Warning: parse() called without arguments. Auto-detected Node.js environment and using process.argv.slice(2).`
+          );
+          console.warn(
+            `For explicit control, call parse(process.argv.slice(2)) instead.`
+          );
+        }
+      } else {
+        throw new Error(
+          "parse() called without arguments in non-Node.js environment. Please provide arguments explicitly: parse(['--flag', 'value'])"
+        );
+      }
+    }
     const originalProcessArgs = [...processArgs];
     const shouldPreventExecution = typeof process !== "undefined" && (process.env["ARGPARSER_FUZZY_MODE"] === "true" || process.argv && process.argv.includes("--s-enable-fuzzy") && !processArgs.includes("--s-enable-fuzzy")) && !(options == null ? void 0 : options.skipHelpHandling);
     if (shouldPreventExecution) {
@@ -3492,11 +4031,11 @@ const _ArgParserBase = class _ArgParserBase {
         commandChain: identifiedCommandChain,
         parserChain: identifiedParserChain
       } = __privateMethod(this, _ArgParserBase_instances, _identifyCommandChainAndParsers_fn).call(this, processArgs, this, [], [this]);
-      const saveToEnvResult = __privateMethod(_a = identifiedFinalParser, _ArgParserBase_instances, _handleSaveToEnvFlag_fn).call(_a, processArgs, identifiedParserChain);
+      const saveToEnvResult = __privateMethod(_b = identifiedFinalParser, _ArgParserBase_instances, _handleSaveToEnvFlag_fn).call(_b, processArgs, identifiedParserChain);
       if (saveToEnvResult !== false) {
         return saveToEnvResult === true ? {} : saveToEnvResult;
       }
-      const { finalArgs, handlerToExecute } = this._parseRecursive(
+      const { finalArgs, handlerToExecute } = await this._parseRecursive(
         processArgs,
         this,
         {},
@@ -3560,7 +4099,7 @@ const _ArgParserBase = class _ArgParserBase {
    * Recursive helper for parsing arguments and handling sub-commands.
    * This method assumes the global help check has already been performed in `parse`.
    */
-  _parseRecursive(argsToParse, currentParser, accumulatedParentArgs, commandChainSoFar, options, parentParser) {
+  async _parseRecursive(argsToParse, currentParser, accumulatedParentArgs, commandChainSoFar, options, parentParser) {
     var _a, _b;
     let subCommandIndex = -1;
     let subCommandName = null;
@@ -3573,7 +4112,7 @@ const _ArgParserBase = class _ArgParserBase {
       }
     }
     const argsForCurrentLevel = subCommandIndex === -1 ? argsToParse : argsToParse.slice(0, subCommandIndex);
-    const { parsedArgs: currentLevelArgs, firstUnconsumedIndex } = __privateMethod(_a = currentParser, _ArgParserBase_instances, parseFlags_fn).call(_a, argsForCurrentLevel, options);
+    const { parsedArgs: currentLevelArgs, firstUnconsumedIndex } = await __privateMethod(_a = currentParser, _ArgParserBase_instances, parseFlags_fn).call(_a, argsForCurrentLevel, options);
     __privateMethod(_b = currentParser, _ArgParserBase_instances, _applyDefaultValues_fn).call(_b, currentLevelArgs, currentParser);
     const combinedArgsFromThisAndParents = {
       ...accumulatedParentArgs,
@@ -3627,7 +4166,7 @@ const _ArgParserBase = class _ArgParserBase {
       ...accumulatedParentArgs,
       ...currentLevelArgs
     };
-    return this._parseRecursive(
+    return await this._parseRecursive(
       nextArgs,
       nextParser,
       combinedArgsForNextLevel,
@@ -4030,7 +4569,7 @@ _handleGlobalChecks_fn = async function(processArgs, options) {
     const rootArgsSlice = rootSubCommandIndex === -1 ? remainingArgs : remainingArgs.slice(0, rootSubCommandIndex);
     parsingSteps.push({ level: "(root)", argsSlice: rootArgsSlice });
     try {
-      const { parsedArgs: rootParsedArgs } = __privateMethod(_a = currentParser, _ArgParserBase_instances, parseFlags_fn).call(_a, rootArgsSlice, { skipHelpHandling: true });
+      const { parsedArgs: rootParsedArgs } = await __privateMethod(_a = currentParser, _ArgParserBase_instances, parseFlags_fn).call(_a, rootArgsSlice, { skipHelpHandling: true });
       parsingSteps[0].parsed = rootParsedArgs;
       accumulatedArgs = { ...accumulatedArgs, ...rootParsedArgs };
     } catch (e) {
@@ -4059,7 +4598,7 @@ _handleGlobalChecks_fn = async function(processArgs, options) {
       };
       parsingSteps.push(stepInfo);
       try {
-        const { parsedArgs: currentLevelParsedArgs } = __privateMethod(_c = currentParser, _ArgParserBase_instances, parseFlags_fn).call(_c, currentLevelArgsSlice, {
+        const { parsedArgs: currentLevelParsedArgs } = await __privateMethod(_c = currentParser, _ArgParserBase_instances, parseFlags_fn).call(_c, currentLevelArgsSlice, {
           skipHelpHandling: true
         });
         stepInfo.parsed = currentLevelParsedArgs;
@@ -4245,7 +4784,7 @@ _prepareAndExecuteHandler_fn = function(handlerToExecute, finalArgs, skipHandler
     }
   }
 };
-parseFlags_fn = function(args, options) {
+parseFlags_fn = async function(args, options) {
   var _a, _b;
   const flags = __privateGet(this, _flagManager).flags;
   const output = Object.fromEntries(
@@ -4268,7 +4807,7 @@ parseFlags_fn = function(args, options) {
         const itemToCheck = args[i];
         const matches = regex.exec(`${itemToCheck}`);
         if ((_a = matches == null ? void 0 : matches.groups) == null ? void 0 : _a["arg"]) {
-          this._addToOutput(
+          await this._addToOutput(
             flagToCheck,
             (_b = matches == null ? void 0 : matches.groups) == null ? void 0 : _b["arg"],
             output,
@@ -4291,12 +4830,12 @@ parseFlags_fn = function(args, options) {
       if (flagToCheck["options"].includes(value)) {
         consumedIndices.add(index2);
         if (flagToCheck["flagOnly"]) {
-          this._addToOutput(flagToCheck, true, output, options);
+          await this._addToOutput(flagToCheck, true, output, options);
         } else if (nextValueExists && !nextValueIsFlag) {
-          this._addToOutput(flagToCheck, nextValue, output, options);
+          await this._addToOutput(flagToCheck, nextValue, output, options);
           consumedIndices.add(nextIndex);
         } else if (flagToCheck["type"] === Boolean) {
-          this._addToOutput(flagToCheck, true, output, options);
+          await this._addToOutput(flagToCheck, true, output, options);
         }
         if (!flagToCheck["allowMultiple"]) break;
       }
@@ -4598,15 +5137,16 @@ _handleBuildDxtFlag_fn = async function(processArgs, buildDxtIndex) {
 };
 _handleMcpServeFlag_fn = async function(processArgs, _mcpServeIndex) {
   var _a;
+  const transportOptions = __privateMethod(this, _ArgParserBase_instances, _parseMcpTransportOptions_fn).call(this, processArgs);
+  const mcpServerConfig = __privateMethod(this, _ArgParserBase_instances, _getMcpServerConfiguration_fn).call(this);
+  const effectiveLogPath = transportOptions.logPath || (mcpServerConfig == null ? void 0 : mcpServerConfig.logPath) || "./logs/mcp.log";
+  const resolvedLogPath = resolveLogPath(effectiveLogPath);
   let mcpLogger;
   try {
     const mcpLoggerModule = await Function(
       'return import("@alcyone-labs/simple-mcp-logger")'
     )();
-    mcpLogger = mcpLoggerModule.createMcpLogger(
-      "MCP Serve",
-      "./logs/mcp.log"
-    );
+    mcpLogger = mcpLoggerModule.createMcpLogger("MCP Serve", resolvedLogPath);
     globalThis.console = mcpLogger;
   } catch {
     mcpLogger = {
@@ -4617,7 +5157,6 @@ _handleMcpServeFlag_fn = async function(processArgs, _mcpServeIndex) {
     mcpLogger.mcpError(
       "Starting --s-mcp-serve system flag handler - console hijacked for MCP safety"
     );
-    const mcpServerConfig = __privateMethod(this, _ArgParserBase_instances, _getMcpServerConfiguration_fn).call(this);
     if (!mcpServerConfig) {
       mcpLogger.mcpError(
         "No MCP server configuration found. Use withMcp() or addMcpSubCommand() to configure MCP server."
@@ -4631,13 +5170,16 @@ _handleMcpServeFlag_fn = async function(processArgs, _mcpServeIndex) {
     mcpLogger.mcpError(
       `Found MCP server configuration: ${((_a = mcpServerConfig.serverInfo) == null ? void 0 : _a.name) || "unnamed"}`
     );
-    const transportOptions = __privateMethod(this, _ArgParserBase_instances, _parseMcpTransportOptions_fn).call(this, processArgs);
+    mcpLogger.mcpError(`Using log path: ${resolvedLogPath}`);
     mcpLogger.mcpError(
       `Transport options: ${JSON.stringify(transportOptions)}`
     );
     try {
       mcpLogger.mcpError("Starting unified MCP server with all tools");
-      await __privateMethod(this, _ArgParserBase_instances, _startUnifiedMcpServer_fn).call(this, mcpServerConfig, transportOptions);
+      await __privateMethod(this, _ArgParserBase_instances, _startUnifiedMcpServer_fn).call(this, mcpServerConfig, {
+        ...transportOptions,
+        logPath: resolvedLogPath
+      });
       mcpLogger.mcpError("Successfully started unified MCP server");
     } catch (error) {
       mcpLogger.mcpError(
@@ -4706,7 +5248,8 @@ _startUnifiedMcpServer_fn = async function(mcpServerConfig, transportOptions) {
       await mcpParser.startMcpServerWithMultipleTransports(
         serverInfo,
         transportConfigs,
-        toolOptions
+        toolOptions,
+        transportOptions.logPath
       );
     } catch (error) {
       throw new Error(
@@ -4717,7 +5260,8 @@ _startUnifiedMcpServer_fn = async function(mcpServerConfig, transportOptions) {
     await mcpParser.startMcpServerWithMultipleTransports(
       serverInfo,
       defaultTransports,
-      toolOptions
+      toolOptions,
+      transportOptions.logPath
     );
   } else if (defaultTransport) {
     await mcpParser.startMcpServerWithTransport(
@@ -4729,7 +5273,8 @@ _startUnifiedMcpServer_fn = async function(mcpServerConfig, transportOptions) {
         path: defaultTransport.path,
         sessionIdGenerator: defaultTransport.sessionIdGenerator
       },
-      toolOptions
+      toolOptions,
+      transportOptions.logPath
     );
   } else {
     const transportType = transportOptions.transportType || "stdio";
@@ -4742,7 +5287,8 @@ _startUnifiedMcpServer_fn = async function(mcpServerConfig, transportOptions) {
       serverInfo,
       transportType,
       finalTransportOptions,
-      toolOptions
+      toolOptions,
+      transportOptions.logPath
     );
   }
 };
@@ -4809,6 +5355,12 @@ _parseMcpTransportOptions_fn = function(processArgs) {
           i++;
         }
         break;
+      case "--s-mcp-log-path":
+        if (nextArg && !nextArg.startsWith("-")) {
+          options.logPath = nextArg;
+          i++;
+        }
+        break;
       // Backward compatibility: support old flags but with deprecation warning
       case "--transport":
       case "--port":
@@ -6094,11 +6646,14 @@ Migration guide: https://github.com/alcyone-labs/arg-parser/blob/main/docs/MCP-M
    * @param toolOptions Optional MCP tool generation options
    * @returns Configured MCP server instance
    */
-  async createMcpServer(serverInfo, toolOptions) {
-    var _a;
-    const logger2 = createMcpLogger("MCP Server Creation", "./logs/mcp.log");
+  async createMcpServer(serverInfo, toolOptions, logPath) {
+    var _a, _b;
+    const resolvedLogPath = resolveLogPath(
+      logPath || ((_a = this._mcpServerConfig) == null ? void 0 : _a.logPath) || "./logs/mcp.log"
+    );
+    const logger2 = createMcpLogger("MCP Server Creation", resolvedLogPath);
     try {
-      const effectiveServerInfo = serverInfo || ((_a = this._mcpServerConfig) == null ? void 0 : _a.serverInfo);
+      const effectiveServerInfo = serverInfo || ((_b = this._mcpServerConfig) == null ? void 0 : _b.serverInfo);
       if (!effectiveServerInfo) {
         throw new Error(
           "No MCP server configuration found. Use withMcp() to configure server info or provide serverInfo parameter."
@@ -6279,11 +6834,11 @@ Migration guide: https://github.com/alcyone-labs/arg-parser/blob/main/docs/MCP-M
    * @param toolOptions Optional MCP tool generation options
    * @returns Promise that resolves when all servers are started
    */
-  async startMcpServerWithMultipleTransports(serverInfo, transports, toolOptions) {
-    const server = await this.createMcpServer(serverInfo, toolOptions);
+  async startMcpServerWithMultipleTransports(serverInfo, transports, toolOptions, logPath) {
+    const server = await this.createMcpServer(serverInfo, toolOptions, logPath);
     const startPromises = [];
     for (const transportConfig of transports) {
-      const promise = __privateMethod(this, _ArgParser_instances, _startSingleTransport_fn).call(this, server, serverInfo, transportConfig);
+      const promise = __privateMethod(this, _ArgParser_instances, _startSingleTransport_fn).call(this, server, serverInfo, transportConfig, logPath);
       startPromises.push(promise);
     }
     await Promise.all(startPromises);
@@ -6296,12 +6851,12 @@ Migration guide: https://github.com/alcyone-labs/arg-parser/blob/main/docs/MCP-M
    * @param toolOptions Optional MCP tool generation options
    * @returns Promise that resolves when server is connected
    */
-  async startMcpServerWithTransport(serverInfo, transportType, transportOptions = {}, toolOptions) {
-    const server = await this.createMcpServer(serverInfo, toolOptions);
+  async startMcpServerWithTransport(serverInfo, transportType, transportOptions = {}, toolOptions, logPath) {
+    const server = await this.createMcpServer(serverInfo, toolOptions, logPath);
     await __privateMethod(this, _ArgParser_instances, _startSingleTransport_fn).call(this, server, serverInfo, {
       type: transportType,
       ...transportOptions
-    });
+    }, logPath);
   }
   async parse(processArgs, options) {
     let result = await ArgParserBase.prototype.parse.call(
@@ -6563,8 +7118,9 @@ registerToolAsSubCommand_fn = function(toolConfig) {
     handler: toolConfig.handler
   });
 };
-_startSingleTransport_fn = async function(server, serverInfo, transportConfig) {
-  const logger2 = createMcpLogger("MCP Transport", "./logs/mcp.log");
+_startSingleTransport_fn = async function(server, serverInfo, transportConfig, logPath) {
+  const resolvedLogPath = resolveLogPath(logPath || "./logs/mcp.log");
+  const logger2 = createMcpLogger("MCP Transport", resolvedLogPath);
   try {
     logger2.mcpError(
       `Starting ${transportConfig.type} transport for server: ${serverInfo.name}`
@@ -6740,7 +7296,9 @@ class TomlConfigPlugin extends ConfigPlugin {
       }
       return parsed;
     } catch (error) {
-      throw new Error(`Failed to parse TOML: ${error instanceof Error ? error.message : String(error)}`);
+      throw new Error(
+        `Failed to parse TOML: ${error instanceof Error ? error.message : String(error)}`
+      );
     }
   }
   generate(_config, flags, parsedArgs) {
@@ -6780,7 +7338,9 @@ class TomlConfigPlugin extends ConfigPlugin {
       const tomlContent = this.tomlModule.stringify(configWithValues);
       return lines.join("\n") + "\n" + tomlContent;
     } catch (error) {
-      throw new Error(`Failed to generate TOML: ${error instanceof Error ? error.message : String(error)}`);
+      throw new Error(
+        `Failed to generate TOML: ${error instanceof Error ? error.message : String(error)}`
+      );
     }
   }
   /**
@@ -6816,7 +7376,10 @@ function createTomlPlugin() {
   try {
     return new TomlConfigPlugin();
   } catch (error) {
-    console.warn("TOML plugin not available:", error instanceof Error ? error.message : String(error));
+    console.warn(
+      "TOML plugin not available:",
+      error instanceof Error ? error.message : String(error)
+    );
     return null;
   }
 }
@@ -6832,7 +7395,10 @@ async function createTomlPluginAsync() {
     const tomlModule = await Promise.resolve().then(() => index$1);
     return new TomlConfigPlugin(tomlModule);
   } catch (error) {
-    console.warn("TOML plugin not available:", error instanceof Error ? error.message : String(error));
+    console.warn(
+      "TOML plugin not available:",
+      error instanceof Error ? error.message : String(error)
+    );
     return null;
   }
 }
@@ -6878,7 +7444,9 @@ class YamlConfigPlugin extends ConfigPlugin {
       }
       return parsed;
     } catch (error) {
-      throw new Error(`Failed to parse YAML: ${error instanceof Error ? error.message : String(error)}`);
+      throw new Error(
+        `Failed to parse YAML: ${error instanceof Error ? error.message : String(error)}`
+      );
     }
   }
   generate(_config, flags, parsedArgs) {
@@ -6912,7 +7480,9 @@ class YamlConfigPlugin extends ConfigPlugin {
       });
       return lines.join("\n") + "\n" + yamlContent;
     } catch (error) {
-      throw new Error(`Failed to generate YAML: ${error instanceof Error ? error.message : String(error)}`);
+      throw new Error(
+        `Failed to generate YAML: ${error instanceof Error ? error.message : String(error)}`
+      );
     }
   }
   /**
@@ -6942,7 +7512,10 @@ function createYamlPlugin() {
   try {
     return new YamlConfigPlugin();
   } catch (error) {
-    console.warn("YAML plugin not available:", error instanceof Error ? error.message : String(error));
+    console.warn(
+      "YAML plugin not available:",
+      error instanceof Error ? error.message : String(error)
+    );
     return null;
   }
 }
@@ -6958,7 +7531,10 @@ async function createYamlPluginAsync() {
     const yamlModule = await import("js-yaml");
     return new YamlConfigPlugin(yamlModule);
   } catch (error) {
-    console.warn("YAML plugin not available:", error instanceof Error ? error.message : String(error));
+    console.warn(
+      "YAML plugin not available:",
+      error instanceof Error ? error.message : String(error)
+    );
     return null;
   }
 }
@@ -6987,7 +7563,9 @@ class ArgParserFuzzyTester {
     const results = [];
     if (this.options.verbose) {
       console.log(`Discovered ${commandPaths.length} command paths:`);
-      commandPaths.forEach((path2) => console.log(`  ${path2.join(" ") || "(root)"}`));
+      commandPaths.forEach(
+        (path2) => console.log(`  ${path2.join(" ") || "(root)"}`)
+      );
     }
     for (const commandPath of commandPaths) {
       const pathResults = await this.testCommandPath(commandPath);
@@ -7013,7 +7591,12 @@ class ArgParserFuzzyTester {
     for (const [subCommandName, subCommand] of subCommands) {
       const newPath = [...currentPath, subCommandName];
       allPaths.push(newPath);
-      this.discoverSubCommandPaths(subCommand.parser, newPath, allPaths, depth + 1);
+      this.discoverSubCommandPaths(
+        subCommand.parser,
+        newPath,
+        allPaths,
+        depth + 1
+      );
     }
   }
   /**
@@ -24905,6 +25488,7 @@ export {
   simpleChalk as SimpleChalk,
   TomlConfigPlugin,
   YamlConfigPlugin,
+  absolutePath,
   convertFlagToJsonSchemaProperty,
   convertFlagsToJsonSchema,
   convertFlagsToZodSchema,
@@ -24918,14 +25502,20 @@ export {
   createTomlPluginAsync,
   createYamlPlugin,
   createYamlPluginAsync,
+  cwdRelative,
+  detectEntryPoint,
   enableConfigPlugins,
   enableOptionalConfigPlugins,
   enableOptionalConfigPluginsAsync,
+  entryRelative,
   extractSimplifiedResponse,
   generateMcpToolsFromArgParser,
+  getEntryPointFromImportMeta,
   getJsonSchemaTypeFromFlag,
   globalConfigPluginRegistry,
+  legacyCwdPath,
   logger,
+  resolveLogPath,
   zodFlagSchema
 };
 //# sourceMappingURL=index.mjs.map