@langwatch/better-agents 0.1.19 → 0.1.20

package/dist/index.js

@@ -224,7 +224,7 @@ var ConsoleLogger = class {
    */
   detectDebugMode() {
     return Boolean(
-      process.env.SUPERAGENTS_DEBUG || process.argv.includes("--debug") || process.argv.includes("-d")
+      process.env.BETTERAGENTS_DEBUG || process.argv.includes("--debug") || process.argv.includes("-d")
     );
   }
   /**
@@ -565,7 +565,7 @@ var MastraFrameworkProvider = {
   language: "typescript",
   getKnowledge: getKnowledge2,
   getMCPConfig: getMCPConfig2,
-  setup: async ({ projectPath, config }) => {
+  setup: async () => {
   }
 };
 
@@ -621,7 +621,7 @@ var LangGraphPyFrameworkProvider = {
   language: "python",
   getKnowledge: getKnowledge3,
   getMCPConfig: getMCPConfig3,
-  setup: async ({ projectPath, config }) => {
+  setup: async () => {
   }
 };
 
@@ -683,7 +683,7 @@ var LangGraphTSFrameworkProvider = {
   language: "typescript",
   getKnowledge: getKnowledge4,
   getMCPConfig: getMCPConfig4,
-  setup: async ({ projectPath, config }) => {
+  setup: async () => {
   }
 };
 
@@ -790,7 +790,70 @@ var GoogleAdkFrameworkProvider = {
   getKnowledge: getKnowledge5,
   getMCPConfig: getMCPConfig5,
   // setup,
-  setup: async ({ projectPath, config }) => {
+  setup: async () => {
+  }
+};
+
+// src/providers/frameworks/vercel-ai/knowledge.ts
+var getKnowledge6 = () => ({
+  setupInstructions: "TypeScript w/pnpm + vitest",
+  toolingInstructions: "Use the Vercel MCP to learn about Vercel AI SDK and how to build agents",
+  agentsGuideSection: `## Framework-Specific Guidelines
+
+### Vercel AI SDK Framework
+
+**Always use the Vercel MCP for learning:**
+
+- The Vercel MCP server provides real-time documentation for Vercel AI SDK
+- Ask it questions about Vercel AI SDK APIs and best practices
+- Follow Vercel AI SDK's recommended patterns for agent development
+
+**When implementing agent features:**
+1. Consult the Vercel MCP: "How do I [do X] in Vercel AI SDK?"
+2. Use Vercel AI SDK's unified provider architecture
+3. Follow Vercel AI SDK's TypeScript patterns and conventions
+4. Leverage Vercel AI SDK's framework integrations (Next.js, React, Svelte, Vue, Node.js)
+
+**Initial setup:**
+1. Use \`pnpm init\` to create a new project
+2. Install dependencies: \`pnpm add ai @ai-sdk/openai\` (or other provider packages like \`@ai-sdk/anthropic\`, \`@ai-sdk/google\`)
+3. Set up TypeScript configuration
+4. Proceed with the user definition request to implement the agent and test it out
+5. Run the agent using \`pnpm tsx src/index.ts\` or integrate with your chosen framework
+
+**Key Concepts:**
+- **Unified Provider Architecture**: Consistent interface across multiple AI model providers
+- **generateText**: Generate text using any supported model
+- **streamText**: Stream text responses for real-time interactions
+- **Framework Integration**: Works with Next.js, React, Svelte, Vue, and Node.js
+
+---
+`
+});
+
+// src/providers/frameworks/vercel-ai/mcp-config.ts
+var getMCPConfig6 = () => ({
+  type: "stdio",
+  command: "uvx",
+  args: [
+    "--from",
+    "mcpdoc",
+    "mcpdoc",
+    "--urls",
+    "Vercel:https://ai-sdk.dev/docs/introduction",
+    "--transport",
+    "stdio"
+  ]
+});
+
+// src/providers/frameworks/vercel-ai/index.ts
+var VercelAIFrameworkProvider = {
+  id: "vercel-ai",
+  displayName: "Vercel AI SDK",
+  language: "typescript",
+  getKnowledge: getKnowledge6,
+  getMCPConfig: getMCPConfig6,
+  setup: async () => {
   }
 };
 
@@ -800,7 +863,8 @@ var PROVIDERS = {
   mastra: MastraFrameworkProvider,
   "langgraph-py": LangGraphPyFrameworkProvider,
   "langgraph-ts": LangGraphTSFrameworkProvider,
-  "google-adk": GoogleAdkFrameworkProvider
+  "google-adk": GoogleAdkFrameworkProvider,
+  "vercel-ai": VercelAIFrameworkProvider
 };
 var getFrameworkProvider = ({
   framework
@@ -879,7 +943,7 @@ var CliUtils = class {
 };
 
 // src/providers/languages/python/knowledge.ts
-var getKnowledge6 = () => ({
+var getKnowledge7 = () => ({
   setupInstructions: "Python with uv + pytest (install uv for them if they don't have it)",
   sourceExtensions: [".py"],
   testFramework: "pytest"
@@ -889,11 +953,11 @@ var getKnowledge6 = () => ({
 var PythonLanguageProvider = {
   id: "python",
   displayName: "Python",
-  getKnowledge: getKnowledge6
+  getKnowledge: getKnowledge7
 };
 
 // src/providers/languages/typescript/knowledge.ts
-var getKnowledge7 = () => ({
+var getKnowledge8 = () => ({
   setupInstructions: "TypeScript with pnpm + vitest (install pnpm for them if they don't have it)",
   sourceExtensions: [".ts", ".tsx"],
   testFramework: "vitest"
@@ -903,7 +967,7 @@ var getKnowledge7 = () => ({
 var TypeScriptLanguageProvider = {
   id: "typescript",
   displayName: "TypeScript",
-  getKnowledge: getKnowledge7
+  getKnowledge: getKnowledge8
 };
 
 // src/providers/languages/index.ts
@@ -1023,7 +1087,12 @@ var ClaudeCodingAssistantProvider = {
         cwd: projectPath
       });
       logger.userSuccess("Session complete!");
-    } catch {
+    } catch (error) {
+      if (error instanceof Error) {
+        logger.error(error, { step: "claude-launch-failed" });
+      } else {
+        logger.debug("claude-launch-failed", { error: String(error) });
+      }
       logger.userWarning(`Could not auto-launch ${this.displayName}.`);
       showManualLaunchInstructions({
         targetPath,
@@ -1035,35 +1104,84 @@ var ClaudeCodingAssistantProvider = {
     }
   }
 };
+var OSUtils = class {
+  /**
+   * Checks if we're running on a Unix platform (Mac/Linux/WSL).
+   *
+   * @returns true if running on Unix platform, false otherwise
+   *
+   * @example
+   * ```ts
+   * if (OSUtils.isUnix) {
+   *   // Unix-specific code
+   * }
+   * ```
+   */
+  static get isUnix() {
+    return os.platform() !== "win32";
+  }
+  /**
+   * Checks if we're running on macOS.
+   *
+   * @returns true if running on macOS, false otherwise
+   *
+   * @example
+   * ```ts
+   * if (OSUtils.isMac) {
+   *   // macOS-specific code
+   * }
+   * ```
+   */
+  static get isMac() {
+    return os.platform() === "darwin";
+  }
+};
 
 // src/providers/coding-assistants/cursor/index.ts
 var CursorCodingAssistantProvider = {
   id: "cursor",
-  displayName: "Cursor",
-  command: "",
+  displayName: "Cursor Agent",
+  command: "cursor-agent",
   async isAvailable() {
     return { installed: true };
   },
   async launch({
-    targetPath
+    projectPath,
+    targetPath,
+    prompt
   }) {
+    if (OSUtils.isMac) {
+      try {
+        logger.userInfo(`\u{1F916} Launching ${this.displayName}...`);
+        ProcessUtils.launchWithTerminalControl("cursor-agent", [prompt], {
+          cwd: projectPath
+        });
+        logger.userSuccess("Session complete!");
+        return;
+      } catch (error) {
+        if (error instanceof Error) {
+          logger.error(error, { step: "cursor-launch-failed" });
+        } else {
+          logger.debug("cursor-launch-failed", { error: String(error) });
+        }
+        logger.userWarning(`Could not auto-launch ${this.displayName}.`);
+      }
+    }
     const isCurrentDir = targetPath === ".";
+    const path14 = isCurrentDir ? "." : targetPath;
+    const composerShortcut = OSUtils.isMac ? "Cmd+I" : "Ctrl+I";
     logger.userPlain("");
-    logger.userPlain("To get started with Cursor:");
+    logger.userPlain("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
+    logger.userPlain("\u2502  \u{1F680} Next Steps                                      \u2502");
+    logger.userPlain("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");
     logger.userPlain("");
-    if (isCurrentDir) {
-      logger.userPlain("  1. Open the current folder in Cursor:");
-      logger.userPlain("");
-      logger.userPlain("     cursor .");
-    } else {
-      logger.userPlain("  1. Open the project in Cursor:");
-      logger.userPlain("");
-      logger.userPlain(`     cursor ${targetPath}`);
-    }
+    logger.userPlain(`  1. Launch Cursor with your project:`);
     logger.userPlain("");
-    logger.userPlain("  2. Open Cursor Composer (Cmd+I or Ctrl+I)");
+    logger.userPlain(`     cursor-agent ${path14}`);
     logger.userPlain("");
-    logger.userPlain("  3. Copy and paste the prompt above to start building your agent");
+    logger.userPlain(`  2. Open Cursor (${composerShortcut})`);
+    logger.userPlain("");
+    logger.userPlain("  3. Paste the prompt above and start building!");
     logger.userPlain("");
   }
 };
@@ -1145,6 +1263,11 @@ var KilocodeCodingAssistantProvider = {
       });
       logger.userSuccess("Session complete!");
     } catch (error) {
+      if (error instanceof Error) {
+        logger.error(error, { step: "kilocode-launch-failed" });
+      } else {
+        logger.debug("kilocode-launch-failed", { error: String(error) });
+      }
       logger.userWarning(`Could not auto-launch ${this.displayName}.`);
       showManualLaunchInstructions({
         targetPath,
@@ -1172,12 +1295,127 @@ var NoneCodingAssistantProvider = {
   }
 };
 
+// src/providers/coding-assistants/crush/index.ts
+var CrushCodingAssistantProvider = {
+  id: "crush",
+  displayName: "Crush",
+  command: "crush",
+  async isAvailable() {
+    const installed = await CliUtils.isCommandAvailable("crush");
+    return {
+      installed,
+      installCommand: installed ? void 0 : "npm install -g @charmland/crush"
+    };
+  },
+  async launch({ targetPath }) {
+    const isCurrentDir = targetPath === ".";
+    logger.userPlain("");
+    logger.userPlain("\u{1F498} Launch Crush");
+    logger.userPlain("");
+    if (isCurrentDir) {
+      logger.userPlain("  Run:");
+      logger.userPlain("");
+      logger.userPlain("    crush");
+    } else {
+      logger.userPlain("  Navigate to project and run via the following commands:");
+      logger.userPlain("");
+      logger.userPlain(`    cd ${targetPath}`);
+      logger.userPlain("    crush");
+    }
+    logger.userPlain("");
+    logger.userPlain("  Then paste the prompt above when Crush starts.");
+    logger.userPlain("");
+  }
+};
+
+// src/providers/coding-assistants/gemini-cli/index.ts
+var GeminiCLICodingAssistantProvider = {
+  id: "gemini-cli",
+  displayName: "Gemini CLI",
+  command: "gemini",
+  async isAvailable() {
+    const installed = await CliUtils.isCommandAvailable("gemini");
+    return {
+      installed,
+      installCommand: installed ? void 0 : "npm install -g @google/gemini-cli"
+    };
+  },
+  async launch({ projectPath, targetPath, prompt }) {
+    if (OSUtils.isUnix) {
+      try {
+        logger.userInfo(`\u{1F916} Launching ${this.displayName}...`);
+        ProcessUtils.launchWithTerminalControl("gemini", ["-p", prompt], { cwd: projectPath });
+        logger.userSuccess("Session complete!");
+        return;
+      } catch (error) {
+        if (error instanceof Error) {
+          logger.error(error, { step: "gemini-launch-failed" });
+        } else {
+          logger.debug("gemini-launch-failed", { error: String(error) });
+        }
+        logger.userWarning(`Could not auto-launch ${this.displayName}.`);
+      }
+    }
+    const isCurrentDir = targetPath === ".";
+    logger.userPlain("");
+    logger.userPlain("To get started with Gemini CLI:");
+    logger.userPlain("");
+    if (isCurrentDir) {
+      logger.userPlain("  Run:");
+      logger.userPlain("");
+      logger.userPlain(`    gemini -p "${prompt}"`);
+    } else {
+      logger.userPlain("  Navigate to project and run:");
+      logger.userPlain("");
+      logger.userPlain(`    cd ${targetPath}`);
+      logger.userPlain(`    gemini -p "${prompt}"`);
+    }
+    logger.userPlain("");
+  }
+};
+
+// src/providers/coding-assistants/qwen-code/index.ts
+var QwenCodeCodingAssistantProvider = {
+  id: "qwen-code",
+  displayName: "Qwen Code",
+  command: "qwen",
+  async isAvailable() {
+    const installed = await CliUtils.isCommandAvailable("qwen");
+    return {
+      installed,
+      installCommand: installed ? void 0 : "npm install -g @qwenlm/qwen-code"
+    };
+  },
+  async launch({ targetPath }) {
+    const isCurrentDir = targetPath === ".";
+    logger.userPlain("");
+    logger.userPlain("To get started with Qwen Code:");
+    logger.userPlain("");
+    if (isCurrentDir) {
+      logger.userPlain("  Run:");
+      logger.userPlain("");
+      logger.userPlain("    qwen");
+    } else {
+      logger.userPlain("  Navigate to project and run:");
+      logger.userPlain("");
+      logger.userPlain(`    cd ${targetPath}`);
+      logger.userPlain("    qwen");
+    }
+    logger.userPlain("");
+    logger.userPlain("  Then paste the prompt above when Qwen Code starts.");
+    logger.userPlain("");
+  }
+};
+
 // src/providers/coding-assistants/index.ts
 var PROVIDERS3 = {
   kilocode: KilocodeCodingAssistantProvider,
   "claude-code": ClaudeCodingAssistantProvider,
   cursor: CursorCodingAssistantProvider,
   antigravity: AntigravityCodingAssistantProvider,
+  crush: CrushCodingAssistantProvider,
+  "gemini-cli": GeminiCLICodingAssistantProvider,
+  "qwen-code": QwenCodeCodingAssistantProvider,
   none: NoneCodingAssistantProvider
 };
 var getCodingAssistantProvider = ({
@@ -1450,6 +1688,13 @@ var collectConfig = async () => {
         }
       }
     }
+    logger.userInfo("To get your LangWatch API key, visit:");
+    logger.userInfo("https://app.langwatch.ai/authorize");
+    const langwatchApiKey = await password({
+      message: "Enter your LangWatch API key (for prompt management, scenarios, evaluations and observability):",
+      mask: "*",
+      validate: validateLangWatchKey
+    });
     const codingAssistant = await select({
       message: "What is your preferred coding assistant for building the agent?",
       choices: await buildCodingAssistantChoices()
@@ -1507,14 +1752,24 @@ var collectConfig = async () => {
         }
       }
     }
+    if (codingAssistant === "gemini-cli") {
+      if (!process.env.GEMINI_API_KEY) {
+        logger.userInfo("When using Gemini API, you must specify the GEMINI_API_KEY environment variable.");
+        const geminiApiKey = await password({
+          message: "Enter your Gemini API key:",
+          mask: "*",
+          validate: (value) => {
+            if (!value || value.length < 5) {
+              return "API key is required and must be at least 5 characters";
+            }
+            return true;
+          }
+        });
+        process.env.GEMINI_API_KEY = geminiApiKey;
+        logger.userInfo("GEMINI_API_KEY has been set for this session.");
+      }
+    }
     logger.userInfo("\u2714\uFE0E Your coding assistant will finish setup later if needed\n");
-    logger.userInfo("To get your LangWatch API key, visit:");
-    logger.userInfo("https://app.langwatch.ai/authorize");
-    const langwatchApiKey = await password({
-      message: "Enter your LangWatch API key (for prompt management, scenarios, evaluations and observability):",
-      mask: "*",
-      validate: validateLangWatchKey
-    });
     const projectGoal = await input({
       message: "What is your agent going to do?",
       validate: validateProjectGoal
@@ -1780,7 +2035,7 @@ var buildOverviewSection = ({ config }) => {
 **Framework:** ${framework === "agno" ? "Agno" : framework === "langgraph-py" ? "LangGraph (Python)" : framework === "langgraph-ts" ? "LangGraph (TypeScript)" : framework === "google-adk" ? "Google ADK" : "Mastra"}
 **Language:** ${language === "python" ? "Python" : "TypeScript"}
 
-This project follows LangWatch best practices for building production-ready AI agents.
+This project follows the Better Agents standard for building production-ready AI agents.
 
 ---
 `;
@@ -2018,9 +2273,95 @@ var buildMCPConfig = ({
   }
   return mcpConfig;
 };
-var setupEditorConfigs = async ({
+var setupCLIConfigs = async ({
   projectPath,
+  config,
   mcpConfig
+}) => {
+  const assistant = config.codingAssistant;
+  if (assistant === "gemini-cli") {
+    const geminiConfigDir = path11.join(os.homedir(), ".gemini");
+    await fs11.mkdir(geminiConfigDir, { recursive: true });
+    const geminiConfigPath = path11.join(geminiConfigDir, "settings.json");
+    let geminiConfig = {};
+    try {
+      const existingContent = await fs11.readFile(geminiConfigPath, "utf-8");
+      geminiConfig = JSON.parse(existingContent);
+    } catch {
+    }
+    geminiConfig.mcpServers = structuredClone(mcpConfig.mcpServers);
+    await fs11.writeFile(
+      geminiConfigPath,
+      JSON.stringify(geminiConfig, null, 2)
+    );
+  }
+  if (assistant === "crush") {
+    const crushConfigPath = path11.join(projectPath, "crush.json");
+    let crushConfig = {
+      $schema: "https://charm.land/crush.json"
+    };
+    try {
+      const existingContent = await fs11.readFile(crushConfigPath, "utf-8");
+      crushConfig = JSON.parse(existingContent);
+    } catch {
+    }
+    if (!crushConfig.mcp) {
+      crushConfig.mcp = {};
+    }
+    const crushMCP = crushConfig.mcp;
+    for (const [key, server] of Object.entries(mcpConfig.mcpServers)) {
+      if (typeof server === "object" && server !== null) {
+        const serverConfig = server;
+        if ("type" in serverConfig && serverConfig.type === "http") {
+          crushMCP[key] = {
+            type: "http",
+            transport: serverConfig.transport || "http",
+            url: serverConfig.url
+          };
+        } else {
+          crushMCP[key] = {
+            type: "stdio",
+            command: serverConfig.command,
+            args: serverConfig.args || []
+          };
+        }
+      }
+    }
+    if (!crushConfig.projectContext) {
+      crushConfig.projectContext = {
+        framework: config.framework,
+        language: config.language,
+        goal: config.projectGoal
+      };
+    }
+    await fs11.writeFile(
+      crushConfigPath,
+      JSON.stringify(crushConfig, null, 2)
+    );
+  }
+  if (assistant === "qwen-code") {
+    const geminiConfigDir = path11.join(os.homedir(), ".gemini");
+    await fs11.mkdir(geminiConfigDir, { recursive: true });
+    const geminiConfigPath = path11.join(geminiConfigDir, "settings.json");
+    let geminiConfig = {};
+    try {
+      const existingContent = await fs11.readFile(geminiConfigPath, "utf-8");
+      geminiConfig = JSON.parse(existingContent);
+    } catch {
+    }
+    geminiConfig.mcpServers = JSON.parse(JSON.stringify(mcpConfig.mcpServers));
+    await fs11.writeFile(
+      geminiConfigPath,
+      JSON.stringify(geminiConfig, null, 2)
+    );
+  }
+};
+
+// src/builders/editor-setup-builder.ts
+var setupEditorConfigs = async ({
+  projectPath,
+  mcpConfig,
+  config
 }) => {
   const mcpConfigPath = path11.join(projectPath, ".mcp.json");
   await fs11.writeFile(mcpConfigPath, JSON.stringify(mcpConfig, null, 2));
@@ -2038,6 +2379,7 @@ var setupEditorConfigs = async ({
   const claudeMdContent = `@AGENTS.md
 `;
   await fs11.writeFile(claudeMdPath, claudeMdContent);
+  await setupCLIConfigs({ projectPath, config, mcpConfig });
 };
 
 // src/commands/init.ts
@@ -2060,7 +2402,7 @@ var showBanner = () => {
 };
 var initCommand = async (targetPath, debug = false) => {
   if (debug) {
-    process.env.SUPERAGENTS_DEBUG = "true";
+    process.env.BETTERAGENTS_DEBUG = "true";
   }
   const logger2 = new LoggerFacade();
   try {
@@ -2101,7 +2443,7 @@ var initCommand = async (targetPath, debug = false) => {
       await ensureGitignore({ projectPath: absolutePath });
       const editorTimer = projectLogger.startTimer("editor-setup");
       const mcpConfig = buildMCPConfig({ config });
-      await setupEditorConfigs({ projectPath: absolutePath, mcpConfig });
+      await setupEditorConfigs({ projectPath: absolutePath, mcpConfig, config });
       if (config.codingAssistant === "antigravity") {
         await setupAntigravityMCPConfig(mcpConfig);
       }
@@ -2143,15 +2485,15 @@ var packageJson = JSON.parse(
 );
 var program = new Command();
 program.name("better-agents").description(
-  "CLI for kicking off production-ready agent projects with LangWatch best practices"
+  "CLI for kicking off production-ready agent projects with the Better Agents standard"
 ).version(packageJson.version).option("-d, --debug", "Enable debug logging with structured JSON output");
 program.command("init").description("Initialize a new agent project").argument(
   "[path]",
   "Path to initialize the project (defaults to current directory)",
   "."
-).action((path13, options) => {
+).action((path14, options) => {
   const debug = options.parent?.debug || false;
-  return initCommand(path13, debug);
+  return initCommand(path14, debug);
 });
 program.parse();
 //# sourceMappingURL=index.js.map