@agentforge/cli 0.3.8 → 0.4.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 Tom Van Schoor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/dist/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var commander = require('commander');
-var chalk = require('chalk');
+var chalk7 = require('chalk');
 var path = require('path');
 var ora = require('ora');
 var inquirer = require('inquirer');
@@ -13,7 +13,7 @@ var execa = require('execa');
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
-var chalk__default = /*#__PURE__*/_interopDefault(chalk);
+var chalk7__default = /*#__PURE__*/_interopDefault(chalk7);
 var path__default = /*#__PURE__*/_interopDefault(path);
 var ora__default = /*#__PURE__*/_interopDefault(ora);
 var inquirer__default = /*#__PURE__*/_interopDefault(inquirer);
@@ -23,20 +23,20 @@ var fs__default = /*#__PURE__*/_interopDefault(fs);
 var Logger = class {
   spinner = null;
   info(message) {
-    console.log(chalk__default.default.blue("\u2139"), message);
+    console.log(chalk7__default.default.blue("\u2139"), message);
   }
   success(message) {
-    console.log(chalk__default.default.green("\u2714"), message);
+    console.log(chalk7__default.default.green("\u2714"), message);
   }
   warn(message) {
-    console.log(chalk__default.default.yellow("\u26A0"), message);
+    console.log(chalk7__default.default.yellow("\u26A0"), message);
   }
   error(message) {
-    console.log(chalk__default.default.red("\u2716"), message);
+    console.log(chalk7__default.default.red("\u2716"), message);
   }
   debug(message) {
     if (process.env.DEBUG) {
-      console.log(chalk__default.default.gray("\u{1F41B}"), message);
+      console.log(chalk7__default.default.gray("\u{1F41B}"), message);
     }
   }
   startSpinner(message) {
@@ -69,19 +69,19 @@ var Logger = class {
     console.log();
   }
   divider() {
-    console.log(chalk__default.default.gray("\u2500".repeat(50)));
+    console.log(chalk7__default.default.gray("\u2500".repeat(50)));
   }
   header(message) {
     this.newLine();
-    console.log(chalk__default.default.bold.cyan(message));
+    console.log(chalk7__default.default.bold.cyan(message));
     this.divider();
   }
   code(code) {
-    console.log(chalk__default.default.gray("  " + code));
+    console.log(chalk7__default.default.gray("  " + code));
   }
   list(items) {
     items.forEach((item) => {
-      console.log(chalk__default.default.gray("  \u2022"), item);
+      console.log(chalk7__default.default.gray("  \u2022"), item);
     });
   }
 };
@@ -188,12 +188,13 @@ async function promptAgentSetup(defaults = {}) {
   ]);
 }
 async function promptToolSetup(defaults = {}) {
-  return inquirer__default.default.prompt([
+  const answers = await inquirer__default.default.prompt([
     {
       type: "input",
       name: "name",
       message: "Tool name:",
       default: defaults.name,
+      when: () => !defaults.name,
       validate: (input) => {
         if (!input) return "Tool name is required";
         if (!/^[a-zA-Z][a-zA-Z0-9]*$/.test(input)) {
@@ -212,25 +213,52 @@ async function promptToolSetup(defaults = {}) {
         { name: "File - File operations", value: "file" },
         { name: "Utility - General utilities", value: "utility" }
       ],
-      default: defaults.category || "utility"
+      default: defaults.category || "utility",
+      when: () => !defaults.category
     },
     {
       type: "input",
       name: "description",
       message: "Tool description:",
       default: defaults.description,
+      when: () => !defaults.description,
       validate: (input) => {
         if (!input) return "Tool description is required";
         return true;
       }
     },
+    {
+      type: "list",
+      name: "structure",
+      message: "Tool structure:",
+      choices: [
+        {
+          name: "Single file - Simple tools (<150 lines, single responsibility)",
+          value: "single"
+        },
+        {
+          name: "Multi-file - Complex tools (multiple providers, >150 lines)",
+          value: "multi"
+        }
+      ],
+      default: defaults.structure || "single",
+      when: () => !defaults.structure
+    },
     {
       type: "confirm",
       name: "generateTests",
       message: "Generate tests?",
-      default: defaults.generateTests !== false
+      default: defaults.generateTests !== false,
+      when: () => defaults.generateTests === void 0
     }
   ]);
+  return {
+    name: defaults.name || answers.name,
+    category: defaults.category || answers.category,
+    description: defaults.description || answers.description,
+    structure: defaults.structure || answers.structure,
+    generateTests: defaults.generateTests !== void 0 ? defaults.generateTests : answers.generateTests
+  };
 }
 var __filename$1 = url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
 var __dirname$1 = path__default.default.dirname(__filename$1);
@@ -422,9 +450,9 @@ async function createCommand(projectName, options) {
       initGit: options.git
     });
     logger.newLine();
-    logger.info(`Creating project: ${chalk__default.default.cyan(answers.projectName)}`);
-    logger.info(`Template: ${chalk__default.default.cyan(answers.template)}`);
-    logger.info(`Package manager: ${chalk__default.default.cyan(answers.packageManager)}`);
+    logger.info(`Creating project: ${chalk7__default.default.cyan(answers.projectName)}`);
+    logger.info(`Template: ${chalk7__default.default.cyan(answers.template)}`);
+    logger.info(`Package manager: ${chalk7__default.default.cyan(answers.packageManager)}`);
     logger.newLine();
     logger.startSpinner("Creating project directory...");
     await ensureDir(targetPath);
@@ -472,7 +500,7 @@ async function createCommand(projectName, options) {
       }
     }
     logger.newLine();
-    logger.success(chalk__default.default.bold.green("\u2728 Project created successfully!"));
+    logger.success(chalk7__default.default.bold.green("\u2728 Project created successfully!"));
     logger.newLine();
     logger.header("\u{1F4DD} Next Steps");
     logger.list([
@@ -609,8 +637,8 @@ async function agentCreateCommand(name, options) {
       generateTests: options.test
     });
     logger.newLine();
-    logger.info(`Creating agent: ${chalk__default.default.cyan(answers.name)}`);
-    logger.info(`Pattern: ${chalk__default.default.cyan(answers.pattern)}`);
+    logger.info(`Creating agent: ${chalk7__default.default.cyan(answers.name)}`);
+    logger.info(`Pattern: ${chalk7__default.default.cyan(answers.pattern)}`);
     logger.newLine();
     const cwd = process.cwd();
     const agentDir = path__default.default.join(cwd, "src", "agents");
@@ -630,12 +658,12 @@ async function agentCreateCommand(name, options) {
       logger.succeedSpinner("Test file created");
     }
     logger.newLine();
-    logger.success(chalk__default.default.bold.green("\u2728 Agent created successfully!"));
+    logger.success(chalk7__default.default.bold.green("\u2728 Agent created successfully!"));
     logger.newLine();
     logger.header("\u{1F4DD} Next Steps");
     logger.list([
-      `Edit ${chalk__default.default.cyan(`src/agents/${answers.name}.ts`)} to customize your agent`,
-      answers.generateTests ? `Run ${chalk__default.default.cyan(`pnpm test tests/agents/${answers.name}.test.ts`)} to test your agent` : ""
+      `Edit ${chalk7__default.default.cyan(`src/agents/${answers.name}.ts`)} to customize your agent`,
+      answers.generateTests ? `Run ${chalk7__default.default.cyan(`pnpm test tests/agents/${answers.name}.test.ts`)} to test your agent` : ""
     ].filter(Boolean));
   } catch (error) {
     logger.error(`Failed to create agent: ${error.message}`);
@@ -755,10 +783,10 @@ async function agentListCommand(options) {
     const agentFiles = await findFiles("*.ts", agentDir);
     if (agentFiles.length === 0) {
       logger.warn("No agents found");
-      logger.info(`Create an agent with: ${chalk__default.default.cyan("agentforge agent:create <name>")}`);
+      logger.info(`Create an agent with: ${chalk7__default.default.cyan("agentforge agent:create <name>")}`);
       return;
     }
-    logger.info(`Found ${chalk__default.default.cyan(agentFiles.length)} agent(s):
+    logger.info(`Found ${chalk7__default.default.cyan(agentFiles.length)} agent(s):
 `);
     for (const file of agentFiles) {
       const agentName = path__default.default.basename(file, ".ts");
@@ -767,22 +795,22 @@ async function agentListCommand(options) {
         const content = await readFile(agentPath);
         const pattern = extractPattern(content);
         const description = extractDescription(content);
-        logger.info(chalk__default.default.bold.cyan(`  ${agentName}`));
+        logger.info(chalk7__default.default.bold.cyan(`  ${agentName}`));
         if (pattern) {
           logger.info(`    Pattern: ${pattern}`);
         }
         if (description) {
           logger.info(`    Description: ${description}`);
         }
-        logger.info(`    Path: ${chalk__default.default.gray(agentPath)}`);
+        logger.info(`    Path: ${chalk7__default.default.gray(agentPath)}`);
         logger.newLine();
       } else {
-        logger.info(`  \u2022 ${chalk__default.default.cyan(agentName)}`);
+        logger.info(`  \u2022 ${chalk7__default.default.cyan(agentName)}`);
       }
     }
     if (!options.verbose) {
       logger.newLine();
-      logger.info(`Use ${chalk__default.default.cyan("--verbose")} for more details`);
+      logger.info(`Use ${chalk7__default.default.cyan("--verbose")} for more details`);
     }
   } catch (error) {
     logger.error(`Failed to list agents: ${error.message}`);
@@ -809,10 +837,10 @@ async function agentTestCommand(name, options) {
     const testFile = path__default.default.join(cwd, "tests", "agents", `${name}.test.ts`);
     if (!await pathExists(testFile)) {
       logger.error(`Test file not found: ${testFile}`);
-      logger.info(`Create tests with: ${chalk__default.default.cyan(`agentforge agent:create ${name} --test`)}`);
+      logger.info(`Create tests with: ${chalk7__default.default.cyan(`agentforge agent:create ${name} --test`)}`);
       process.exit(1);
     }
-    logger.info(`Testing agent: ${chalk__default.default.cyan(name)}`);
+    logger.info(`Testing agent: ${chalk7__default.default.cyan(name)}`);
     logger.info(`Watch mode: ${options.watch ? "Yes" : "No"}`);
     logger.newLine();
     const packageManager = await detectPackageManager(cwd);
@@ -830,8 +858,8 @@ async function agentTestCommand(name, options) {
 async function agentDeployCommand(name, options) {
   try {
     logger.header("\u{1F680} Deploy Agent");
-    logger.info(`Agent: ${chalk__default.default.cyan(name)}`);
-    logger.info(`Environment: ${chalk__default.default.cyan(options.environment || "production")}`);
+    logger.info(`Agent: ${chalk7__default.default.cyan(name)}`);
+    logger.info(`Environment: ${chalk7__default.default.cyan(options.environment || "production")}`);
     logger.info(`Dry run: ${options.dryRun ? "Yes" : "No"}`);
     logger.newLine();
     if (options.dryRun) {
@@ -847,7 +875,7 @@ async function agentDeployCommand(name, options) {
       logger.succeedSpinner("Agent deployed successfully");
     }
     logger.newLine();
-    logger.success(chalk__default.default.bold.green("\u2728 Deployment completed!"));
+    logger.success(chalk7__default.default.bold.green("\u2728 Deployment completed!"));
     logger.newLine();
     logger.info("Note: Actual deployment implementation coming soon");
     logger.info("For now, please use the deployment templates in the templates/deployment directory");
@@ -863,38 +891,37 @@ async function toolCreateCommand(name, options) {
     const answers = await promptToolSetup({
       name,
       category: options.category,
+      structure: options.structure,
+      description: options.description,
       generateTests: options.test
     });
     logger.newLine();
-    logger.info(`Creating tool: ${chalk__default.default.cyan(answers.name)}`);
-    logger.info(`Category: ${chalk__default.default.cyan(answers.category)}`);
+    logger.info(`Creating tool: ${chalk7__default.default.cyan(answers.name)}`);
+    logger.info(`Category: ${chalk7__default.default.cyan(answers.category)}`);
+    logger.info(`Structure: ${chalk7__default.default.cyan(answers.structure)}`);
     logger.newLine();
     const cwd = process.cwd();
-    const toolDir = path__default.default.join(cwd, "src", "tools");
-    const toolFile = path__default.default.join(toolDir, `${answers.name}.ts`);
-    logger.startSpinner("Creating tool file...");
-    await ensureDir(toolDir);
-    const toolContent = generateToolContent(answers.name, answers.category, answers.description);
-    await writeFile(toolFile, toolContent);
-    logger.succeedSpinner("Tool file created");
-    if (answers.generateTests) {
-      logger.startSpinner("Creating test file...");
-      const testDir = path__default.default.join(cwd, "tests", "tools");
-      const testFile = path__default.default.join(testDir, `${answers.name}.test.ts`);
-      await ensureDir(testDir);
-      const testContent = generateTestContent2(answers.name);
-      await writeFile(testFile, testContent);
-      logger.succeedSpinner("Test file created");
+    if (answers.structure === "multi") {
+      await createMultiFileTool(cwd, answers);
+    } else {
+      await createSingleFileTool(cwd, answers);
     }
     logger.newLine();
-    logger.success(chalk__default.default.bold.green("\u2728 Tool created successfully!"));
+    logger.success(chalk7__default.default.bold.green("\u2728 Tool created successfully!"));
     logger.newLine();
     logger.header("\u{1F4DD} Next Steps");
-    logger.list([
-      `Edit ${chalk__default.default.cyan(`src/tools/${answers.name}.ts`)} to implement your tool`,
-      answers.generateTests ? `Run ${chalk__default.default.cyan(`pnpm test tests/tools/${answers.name}.test.ts`)} to test your tool` : "",
+    const nextSteps = answers.structure === "multi" ? [
+      `Edit ${chalk7__default.default.cyan(`src/tools/${answers.name}/index.ts`)} to implement your tool`,
+      `Add providers in ${chalk7__default.default.cyan(`src/tools/${answers.name}/providers/`)}`,
+      `Define types in ${chalk7__default.default.cyan(`src/tools/${answers.name}/types.ts`)}`,
+      answers.generateTests ? `Run ${chalk7__default.default.cyan(`pnpm test ${answers.name}`)} to test your tool` : "",
       `Register the tool in your agent's tool registry`
-    ].filter(Boolean));
+    ] : [
+      `Edit ${chalk7__default.default.cyan(`src/tools/${answers.name}.ts`)} to implement your tool`,
+      answers.generateTests ? `Run ${chalk7__default.default.cyan(`pnpm test tests/tools/${answers.name}.test.ts`)} to test your tool` : "",
+      `Register the tool in your agent's tool registry`
+    ];
+    logger.list(nextSteps.filter(Boolean));
   } catch (error) {
     logger.error(`Failed to create tool: ${error.message}`);
     process.exit(1);
@@ -950,6 +977,46 @@ describe('${capitalize2(name)} Tool', () => {
 function capitalize2(str) {
   return str.charAt(0).toUpperCase() + str.slice(1);
 }
+async function createSingleFileTool(cwd, answers) {
+  const toolDir = path__default.default.join(cwd, "src", "tools");
+  const toolFile = path__default.default.join(toolDir, `${answers.name}.ts`);
+  logger.startSpinner("Creating tool file...");
+  await ensureDir(toolDir);
+  const toolContent = generateToolContent(answers.name, answers.category, answers.description);
+  await writeFile(toolFile, toolContent);
+  logger.succeedSpinner("Tool file created");
+  if (answers.generateTests) {
+    logger.startSpinner("Creating test file...");
+    const testDir = path__default.default.join(cwd, "tests", "tools");
+    const testFile = path__default.default.join(testDir, `${answers.name}.test.ts`);
+    await ensureDir(testDir);
+    const testContent = generateTestContent2(answers.name);
+    await writeFile(testFile, testContent);
+    logger.succeedSpinner("Test file created");
+  }
+}
+async function createMultiFileTool(cwd, answers) {
+  const toolDir = path__default.default.join(cwd, "src", "tools", answers.name);
+  logger.startSpinner("Creating tool directory structure...");
+  await ensureDir(toolDir);
+  const templatePath = getTemplatePath("tool-multi");
+  const replacements = {
+    TOOL_NAME: answers.name,
+    TOOL_NAME_PASCAL: capitalize2(answers.name),
+    TOOL_NAME_CAMEL: answers.name.charAt(0).toLowerCase() + answers.name.slice(1),
+    TOOL_DESCRIPTION: answers.description,
+    TOOL_CATEGORY: answers.category
+  };
+  await copyTemplate(templatePath, toolDir, replacements);
+  logger.succeedSpinner("Tool directory structure created");
+  if (!answers.generateTests) {
+    logger.startSpinner("Cleaning up test files...");
+    const fs4 = await import('fs-extra');
+    const testDir = path__default.default.join(toolDir, "__tests__");
+    await fs4.remove(testDir);
+    logger.succeedSpinner("Test files removed");
+  }
+}
 async function toolListCommand(options) {
   try {
     logger.header("\u{1F4CB} List Tools");
@@ -958,7 +1025,7 @@ async function toolListCommand(options) {
     const toolFiles = await findFiles("*.ts", toolDir);
     if (toolFiles.length === 0) {
       logger.warn("No tools found");
-      logger.info(`Create a tool with: ${chalk__default.default.cyan("agentforge tool:create <name>")}`);
+      logger.info(`Create a tool with: ${chalk7__default.default.cyan("agentforge tool:create <name>")}`);
       return;
     }
     let filteredTools = toolFiles;
@@ -977,7 +1044,7 @@ async function toolListCommand(options) {
       logger.warn(`No tools found in category: ${options.category}`);
       return;
     }
-    logger.info(`Found ${chalk__default.default.cyan(filteredTools.length)} tool(s):
+    logger.info(`Found ${chalk7__default.default.cyan(filteredTools.length)} tool(s):
 `);
     for (const file of filteredTools) {
       const toolName = path__default.default.basename(file, ".ts");
@@ -986,22 +1053,22 @@ async function toolListCommand(options) {
         const content = await readFile(toolPath);
         const category = extractCategory(content);
         const description = extractDescription2(content);
-        logger.info(chalk__default.default.bold.cyan(`  ${toolName}`));
+        logger.info(chalk7__default.default.bold.cyan(`  ${toolName}`));
         if (category) {
           logger.info(`    Category: ${category}`);
         }
         if (description) {
           logger.info(`    Description: ${description}`);
         }
-        logger.info(`    Path: ${chalk__default.default.gray(toolPath)}`);
+        logger.info(`    Path: ${chalk7__default.default.gray(toolPath)}`);
         logger.newLine();
       } else {
-        logger.info(`  \u2022 ${chalk__default.default.cyan(toolName)}`);
+        logger.info(`  \u2022 ${chalk7__default.default.cyan(toolName)}`);
       }
     }
     if (!options.verbose) {
       logger.newLine();
-      logger.info(`Use ${chalk__default.default.cyan("--verbose")} for more details`);
+      logger.info(`Use ${chalk7__default.default.cyan("--verbose")} for more details`);
     }
   } catch (error) {
     logger.error(`Failed to list tools: ${error.message}`);
@@ -1023,10 +1090,10 @@ async function toolTestCommand(name, options) {
     const testFile = path__default.default.join(cwd, "tests", "tools", `${name}.test.ts`);
     if (!await pathExists(testFile)) {
       logger.error(`Test file not found: ${testFile}`);
-      logger.info(`Create tests with: ${chalk__default.default.cyan(`agentforge tool:create ${name} --test`)}`);
+      logger.info(`Create tests with: ${chalk7__default.default.cyan(`agentforge tool:create ${name} --test`)}`);
       process.exit(1);
     }
-    logger.info(`Testing tool: ${chalk__default.default.cyan(name)}`);
+    logger.info(`Testing tool: ${chalk7__default.default.cyan(name)}`);
     logger.info(`Watch mode: ${options.watch ? "Yes" : "No"}`);
     logger.newLine();
     const packageManager = await detectPackageManager(cwd);
@@ -1044,8 +1111,8 @@ async function toolTestCommand(name, options) {
 async function toolPublishCommand(name, options) {
   try {
     logger.header("\u{1F4E6} Publish Tool");
-    logger.info(`Tool: ${chalk__default.default.cyan(name)}`);
-    logger.info(`Tag: ${chalk__default.default.cyan(options.tag || "latest")}`);
+    logger.info(`Tool: ${chalk7__default.default.cyan(name)}`);
+    logger.info(`Tag: ${chalk7__default.default.cyan(options.tag || "latest")}`);
     logger.info(`Dry run: ${options.dryRun ? "Yes" : "No"}`);
     logger.newLine();
     if (options.dryRun) {
@@ -1077,7 +1144,7 @@ async function toolPublishCommand(name, options) {
       logger.succeedSpinner("Published to npm");
     }
     logger.newLine();
-    logger.success(chalk__default.default.bold.green("\u2728 Tool published successfully!"));
+    logger.success(chalk7__default.default.bold.green("\u2728 Tool published successfully!"));
     logger.newLine();
     logger.info("Note: Actual npm publishing implementation coming soon");
     logger.info("For now, please use npm publish manually");
@@ -1102,7 +1169,7 @@ agent.command("list").description("List all agents").option("-v, --verbose", "Sh
 agent.command("test <name>").description("Test a specific agent").option("-w, --watch", "Watch mode").action(agentTestCommand);
 agent.command("deploy <name>").description("Deploy an agent").option("-e, --environment <env>", "Deployment environment", "production").option("--dry-run", "Dry run without actual deployment").action(agentDeployCommand);
 var tool = program.command("tool").description("Manage tools");
-tool.command("create <name>").description("Create a new tool").option("-c, --category <category>", "Tool category (web, data, file, utility)", "utility").option("--no-test", "Skip test generation").action(toolCreateCommand);
+tool.command("create <name>").description("Create a new tool").option("-c, --category <category>", "Tool category (web, data, file, utility)", "utility").option("-s, --structure <structure>", "Tool structure (single, multi)", "single").option("-d, --description <description>", "Tool description").option("--no-test", "Skip test generation").action(toolCreateCommand);
 tool.command("list").description("List all tools").option("-c, --category <category>", "Filter by category").option("-v, --verbose", "Show detailed information").action(toolListCommand);
 tool.command("test <name>").description("Test a specific tool").option("-w, --watch", "Watch mode").action(toolTestCommand);
 tool.command("publish <name>").description("Publish a tool to npm").option("--tag <tag>", "npm tag", "latest").option("--dry-run", "Dry run without actual publishing").action(toolPublishCommand);
@@ -1112,7 +1179,7 @@ async function run() {
     await program.parseAsync(process.argv);
   } catch (error) {
     if (error.code !== "commander.help" && error.code !== "commander.version") {
-      console.error(chalk__default.default.red("Error:"), error.message);
+      console.error(chalk7__default.default.red("Error:"), error.message);
       process.exit(1);
     }
   }