copilotkit 0.0.39 → 0.0.41

package/dist/commands/init.js

@@ -1,8 +1,8 @@
 // src/commands/init.ts
 import { Flags as Flags2 } from "@oclif/core";
 import inquirer3 from "inquirer";
-import path5 from "path";
-import fs5 from "fs";
+import path6 from "path";
+import fs6 from "fs";
 
 // src/services/auth.service.ts
 import Conf2 from "conf";
@@ -222,7 +222,7 @@ import { Command } from "@oclif/core";
 import Sentry, { consoleIntegration } from "@sentry/node";
 
 // src/utils/version.ts
-var LIB_VERSION = "0.0.39";
+var LIB_VERSION = "0.0.41";
 
 // src/commands/base-command.ts
 import chalk2 from "chalk";
@@ -280,7 +280,7 @@ var isLocalhost = (url) => {
 };
 
 // src/lib/init/types/questions.ts
-var MODES = ["LangGraph", "CrewAI", "Mastra", "AG2", "MCP", "Standard"];
+var MODES = ["LangGraph", "CrewAI", "Mastra", "LlamaIndex", "Agno", "AG2", "MCP", "Standard"];
 var CREW_TYPES = ["Crews", "Flows"];
 var CHAT_COMPONENTS = ["CopilotChat", "CopilotSidebar", "Headless", "CopilotPopup"];
 var LANGGRAPH_AGENTS = ["Python Starter", "TypeScript Starter"];
@@ -323,6 +323,7 @@ var ApiKeySchema = z.preprocess(
   (val) => sanitizers.apiKey(String(val)),
   z.string().min(1, "API key is required")
 );
+var LLMApiKeySchema = z.preprocess((val) => sanitizers.apiKey(String(val)), z.string().optional());
 var NameSchema = z.preprocess((val) => sanitizers.trim(String(val)), z.string().min(1, "Name is required"));
 var ConfigSchema = z.object({
   // Core fields
@@ -346,7 +347,10 @@ var ConfigSchema = z.object({
   // API keys and tokens
   copilotCloudPublicApiKey: z.string().optional(),
   langSmithApiKey: ApiKeySchema.optional(),
-  llmToken: ApiKeySchema.optional()
+  llmToken: LLMApiKeySchema.optional(),
+  // IDE Documentation setup fields
+  setupIDEDocs: YesNoSchema.optional(),
+  selectedIDE: z.union([z.enum(["cursor", "windsurf"]), z.literal("skip")]).optional()
 }).refine(
   (data) => {
     if (data.mode === "CrewAI") {
@@ -381,7 +385,12 @@ var ConfigFlags = {
   "crew-url": Flags.string({ description: "URL endpoint for your CrewAI agent" }),
   "crew-bearer-token": Flags.string({ description: "Bearer token for CrewAI authentication" }),
   "langsmith-api-key": Flags.string({ description: "LangSmith API key for LangGraph observability" }),
-  "llm-token": Flags.string({ description: "API key for your preferred LLM provider" })
+  "llm-token": Flags.string({ description: "API key for your preferred LLM provider" }),
+  "setup-ide-docs": Flags.string({ description: "Setup IDE documentation rules for AI assistance", options: YES_NO }),
+  "selected-ide": Flags.string({
+    description: "IDE to configure with documentation rules",
+    options: ["cursor", "windsurf", "skip"]
+  })
 };
 
 // src/lib/init/types/templates.ts
@@ -404,7 +413,158 @@ var templateMapping = {
   McpRuntime: `${BASE_URL}/mcp-starter-runtime.json`
 };
 
+// src/lib/init/ide-docs.ts
+import path from "path";
+import { existsSync } from "fs";
+import * as fs from "fs/promises";
+import chalk3 from "chalk";
+var COPILOTKIT_DOC_RULE_TEMPLATE = `---
+description: CopilotKit Documentation - Complete CopilotKit framework documentation for AI assistance
+alwaysApply: false
+---
+
+# CopilotKit Documentation
+
+For ANY question about CopilotKit, use the comprehensive documentation available at:
+@https://docs.copilotkit.ai/llms-full.txt
+
+This contains the complete CopilotKit documentation including:
+- API references and hooks (useCopilotChat, useCopilotAction, etc.)
+- Component library documentation (CopilotKit, CopilotChat, etc.)
+- Integration guides and examples
+- Best practices and patterns
+- Troubleshooting and FAQs
+
+Always reference this documentation when working with CopilotKit to provide accurate, up-to-date information.
+`;
+var IDE_DOCS_CONFIGS = {
+  cursor: {
+    name: "cursor",
+    displayName: "Cursor",
+    rulesDir: ".cursor/rules",
+    ruleFileName: "00-copilotkit-docs.mdc",
+    createRuleContent: () => COPILOTKIT_DOC_RULE_TEMPLATE
+  },
+  windsurf: {
+    name: "windsurf",
+    displayName: "Windsurf",
+    rulesDir: ".windsurf/rules",
+    ruleFileName: "00-copilotkit-docs.md",
+    createRuleContent: () => COPILOTKIT_DOC_RULE_TEMPLATE
+  }
+};
+async function ensureDir(dirPath) {
+  try {
+    await fs.mkdir(dirPath, { recursive: true });
+  } catch (error) {
+    if (!existsSync(dirPath)) {
+      throw error;
+    }
+  }
+}
+async function pathExists(filePath) {
+  try {
+    await fs.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function checkIDEInstallation(ide) {
+  try {
+    const homeDir = process.env.HOME || process.env.USERPROFILE || "";
+    let configPath;
+    switch (ide) {
+      case "cursor":
+        configPath = path.join(homeDir, ".cursor");
+        break;
+      case "windsurf":
+        configPath = path.join(homeDir, ".codeium", "windsurf");
+        break;
+      default:
+        return false;
+    }
+    return existsSync(configPath);
+  } catch {
+    return false;
+  }
+}
+async function detectInstalledIDEs() {
+  const allIDEs = ["cursor", "windsurf"];
+  const installedIDEs = [];
+  for (const ide of allIDEs) {
+    if (await checkIDEInstallation(ide)) {
+      installedIDEs.push(ide);
+    }
+  }
+  return installedIDEs;
+}
+async function setupIDEDocs(ide, projectDir) {
+  const config = IDE_DOCS_CONFIGS[ide];
+  const rulesDir = path.join(projectDir, config.rulesDir);
+  const ruleFilePath = path.join(rulesDir, config.ruleFileName);
+  await ensureDir(rulesDir);
+  if (await pathExists(ruleFilePath)) {
+    console.log(chalk3.yellow(`\u26A0\uFE0F  CopilotKit documentation rule already exists for ${config.displayName}`));
+    return;
+  }
+  const ruleContent = config.createRuleContent();
+  await fs.writeFile(ruleFilePath, ruleContent, "utf8");
+}
+function getIDEInstructions(ide) {
+  const config = IDE_DOCS_CONFIGS[ide];
+  const instructions = [
+    chalk3.cyan(`\u{1F4DA} CopilotKit documentation configured for ${config.displayName}!`),
+    "",
+    chalk3.bold("What this does:"),
+    "  \u2022 Adds CopilotKit documentation context to your IDE AI assistant",
+    "  \u2022 Provides accurate, up-to-date information about CopilotKit APIs",
+    "  \u2022 Improves code suggestions and help responses",
+    "",
+    chalk3.bold("Location:"),
+    `  \u2022 Rule file: ${chalk3.gray(path.join(config.rulesDir, config.ruleFileName))}`,
+    "",
+    chalk3.bold("Usage:"),
+    "  \u2022 Your IDE AI assistant now has access to CopilotKit documentation",
+    "  \u2022 Ask questions about CopilotKit APIs, components, and patterns",
+    "  \u2022 The AI will reference official documentation for accurate answers"
+  ];
+  if (ide === "cursor") {
+    instructions.push(
+      "",
+      chalk3.bold("Next steps for Cursor:"),
+      "  \u2022 Restart Cursor if currently open",
+      "  \u2022 The rule will be automatically available in your AI context",
+      "  \u2022 Start a new chat to use the documentation context"
+    );
+  } else if (ide === "windsurf") {
+    instructions.push(
+      "",
+      chalk3.bold("Next steps for Windsurf:"),
+      "  \u2022 Restart Windsurf if currently open",
+      "  \u2022 The rule will be automatically available in your AI context",
+      "  \u2022 Start a new chat to use the documentation context"
+    );
+  }
+  return instructions;
+}
+async function handleIDEDocsSetup(selectedIDE, projectDir, spinner) {
+  try {
+    spinner.text = chalk3.cyan(`Setting up CopilotKit documentation for ${IDE_DOCS_CONFIGS[selectedIDE].displayName}...`);
+    await setupIDEDocs(selectedIDE, projectDir);
+    spinner.succeed(chalk3.green(`CopilotKit documentation configured for ${IDE_DOCS_CONFIGS[selectedIDE].displayName}`));
+    const instructions = getIDEInstructions(selectedIDE);
+    console.log("\n" + instructions.join("\n"));
+  } catch (error) {
+    spinner.fail(
+      chalk3.red(`Failed to setup IDE documentation: ${error instanceof Error ? error.message : "Unknown error"}`)
+    );
+    throw error;
+  }
+}
+
 // src/lib/init/questions.ts
+var linkToDocs = ["Mastra", "AG2", "LlamaIndex", "Agno"];
 var validateUrl = (input) => {
   try {
     const sanitized = sanitizers.url(input);
@@ -536,7 +696,7 @@ var questions = [
     name: "useCopilotCloud",
     message: "\u{1FA81} Deploy with Copilot Cloud? (recommended for production)",
     when: (answers) => answers.mode === "Standard" || answers.mode === "MCP" || answers.mode !== "CrewAI" && // Crews only cloud, flows are self-hosted
-    answers.alreadyDeployed === "Yes" && answers.langGraphPlatform !== "No" && answers.mode !== "Mastra" && answers.mode !== "AG2" && !isLocalhost(answers.langGraphPlatformUrl || ""),
+    answers.alreadyDeployed === "Yes" && answers.langGraphPlatform !== "No" && !linkToDocs.includes(answers.mode || "") && !isLocalhost(answers.langGraphPlatformUrl || ""),
     validate: (input) => {
       try {
         YesNoSchema.parse(input);
@@ -549,11 +709,43 @@ var questions = [
   {
     type: "input",
     name: "llmToken",
-    message: "\u{1F511} Enter your OpenAI API key (required for LLM interfacing):",
+    message: "\u{1F511} Enter your OpenAI API key (optional - leave empty to configure your LLM later):",
     when: (answers) => answers.mode === "LangGraph" && answers.alreadyDeployed === "No" || answers.mode === "Standard" && answers.useCopilotCloud !== "Yes" || answers.mode === "MCP" && answers.useCopilotCloud !== "Yes",
     sensitive: true,
-    validate: validateRequired,
     sanitize: sanitizers.apiKey
+  },
+  // IDE Documentation Setup Questions
+  {
+    type: "yes/no",
+    name: "setupIDEDocs",
+    message: "\u{1F4DA} Would you like to add CopilotKit documentation to your IDE? (Provides AI assistant with CopilotKit context)",
+    when: async () => {
+      const installedIDEs = await detectInstalledIDEs();
+      return installedIDEs.length > 0;
+    },
+    validate: (input) => {
+      try {
+        YesNoSchema.parse(input);
+        return true;
+      } catch (error) {
+        return "Please select Yes or No";
+      }
+    }
+  },
+  {
+    type: "select",
+    name: "selectedIDE",
+    message: "\u{1F4BB} Which IDE would you like to configure with CopilotKit documentation?",
+    choices: async () => {
+      const installedIDEs = await detectInstalledIDEs();
+      const choices = installedIDEs.map((ide) => ({
+        name: IDE_DOCS_CONFIGS[ide].displayName,
+        value: ide
+      }));
+      choices.push({ name: "Skip", value: "skip" });
+      return choices;
+    },
+    when: (answers) => answers.setupIDEDocs === "Yes"
   }
 ];
 
@@ -619,8 +811,8 @@ async function scaffoldShadCN(flags, userAnswers) {
 }
 
 // src/lib/init/scaffold/env.ts
-import path from "path";
-import fs from "fs";
+import path2 from "path";
+import fs2 from "fs";
 
 // src/lib/init/scaffold/langgraph-assistants.ts
 async function getLangGraphAgents(url, langSmithApiKey) {
@@ -646,9 +838,9 @@ async function getLangGraphAgents(url, langSmithApiKey) {
 import inquirer2 from "inquirer";
 async function scaffoldEnv(flags, userAnswers) {
   try {
-    const envFile = path.join(process.cwd(), ".env");
-    if (!fs.existsSync(envFile)) {
-      fs.writeFileSync(envFile, "", "utf8");
+    const envFile = path2.join(process.cwd(), ".env");
+    if (!fs2.existsSync(envFile)) {
+      fs2.writeFileSync(envFile, "", "utf8");
     } else {
     }
     let newEnvValues = "";
@@ -673,7 +865,7 @@ async function scaffoldEnv(flags, userAnswers) {
 `;
       newEnvValues += `LANGGRAPH_DEPLOYMENT_URL=http://localhost:8123
 `;
-    } else if (userAnswers.langGraphPlatform === "Yes" && userAnswers.useCopilotCloud === "No") {
+    } else if (userAnswers.langGraphPlatform === "Yes" && userAnswers.useCopilotCloud !== "Yes") {
       newEnvValues += `LANGGRAPH_DEPLOYMENT_URL=${userAnswers.langGraphPlatformUrl}
 `;
     } else if (userAnswers.langGraphRemoteEndpointURL) {
@@ -687,8 +879,8 @@ async function scaffoldEnv(flags, userAnswers) {
       newEnvValues += `NEXT_PUBLIC_COPILOTKIT_RUNTIME_URL=/api/copilotkit
 `;
     }
-    if (userAnswers.langGraphPlatformUrl && userAnswers.langSmithApiKey) {
-      const langGraphAgents = await getLangGraphAgents(userAnswers.langGraphPlatformUrl, userAnswers.langSmithApiKey);
+    if (userAnswers.langGraphPlatformUrl && (userAnswers.langSmithApiKey || isLocalhost(userAnswers.langGraphPlatformUrl))) {
+      const langGraphAgents = await getLangGraphAgents(userAnswers.langGraphPlatformUrl, userAnswers.langSmithApiKey || "");
       let langGraphAgent = "";
       if (langGraphAgents.length > 1) {
         const { langGraphAgentChoice } = await inquirer2.prompt([
@@ -712,7 +904,7 @@ async function scaffoldEnv(flags, userAnswers) {
 `;
     }
     if (newEnvValues) {
-      fs.appendFileSync(envFile, newEnvValues);
+      fs2.appendFileSync(envFile, newEnvValues);
     }
   } catch (error) {
     throw error;
@@ -721,59 +913,59 @@ async function scaffoldEnv(flags, userAnswers) {
 
 // src/lib/init/scaffold/github.ts
 import { execSync } from "child_process";
-import * as fs2 from "fs";
-import * as path2 from "path";
+import * as fs3 from "fs";
+import * as path3 from "path";
 import * as os from "os";
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 async function cloneGitHubSubdirectory(githubUrl, destinationPath, spinner) {
   try {
     const { owner, repo, branch, subdirectoryPath } = parseGitHubUrl(githubUrl);
-    spinner.text = chalk3.cyan(`Cloning from ${owner}/${repo}...`);
+    spinner.text = chalk4.cyan(`Cloning from ${owner}/${repo}...`);
     return await sparseCheckout(owner, repo, branch, subdirectoryPath, destinationPath, spinner);
   } catch (error) {
-    spinner.text = chalk3.red(`Failed to clone from GitHub: ${error}`);
+    spinner.text = chalk4.red(`Failed to clone from GitHub: ${error}`);
     return false;
   }
 }
 async function sparseCheckout(owner, repo, branch, subdirectoryPath, destinationPath, spinner) {
-  const tempDir = fs2.mkdtempSync(path2.join(os.tmpdir(), "copilotkit-sparse-"));
+  const tempDir = fs3.mkdtempSync(path3.join(os.tmpdir(), "copilotkit-sparse-"));
   try {
-    spinner.text = chalk3.cyan("Creating temporary workspace...");
+    spinner.text = chalk4.cyan("Creating temporary workspace...");
     execSync("git init", { cwd: tempDir, stdio: "pipe" });
-    spinner.text = chalk3.cyan("Connecting to repository...");
+    spinner.text = chalk4.cyan("Connecting to repository...");
     execSync(`git remote add origin https://github.com/${owner}/${repo}.git`, { cwd: tempDir, stdio: "pipe" });
     execSync("git config core.sparseCheckout true", { cwd: tempDir, stdio: "pipe" });
-    fs2.writeFileSync(path2.join(tempDir, ".git/info/sparse-checkout"), subdirectoryPath);
-    spinner.text = chalk3.cyan("Downloading agent files...");
+    fs3.writeFileSync(path3.join(tempDir, ".git/info/sparse-checkout"), subdirectoryPath);
+    spinner.text = chalk4.cyan("Downloading agent files...");
     execSync(`git pull origin ${branch} --depth=1`, { cwd: tempDir, stdio: "pipe" });
-    const sourcePath = path2.join(tempDir, subdirectoryPath);
-    if (!fs2.existsSync(sourcePath)) {
+    const sourcePath = path3.join(tempDir, subdirectoryPath);
+    if (!fs3.existsSync(sourcePath)) {
       throw new Error(`Subdirectory '${subdirectoryPath}' not found in the repository.`);
     }
-    fs2.mkdirSync(destinationPath, { recursive: true });
-    spinner.text = chalk3.cyan("Installing agent files...");
+    fs3.mkdirSync(destinationPath, { recursive: true });
+    spinner.text = chalk4.cyan("Installing agent files...");
     await copyDirectoryAsync(sourcePath, destinationPath);
     return true;
   } finally {
     try {
-      fs2.rmSync(tempDir, { recursive: true, force: true });
+      fs3.rmSync(tempDir, { recursive: true, force: true });
     } catch (error) {
       console.warn(`Failed to clean up temporary directory: ${error}`);
     }
   }
 }
 async function copyDirectoryAsync(source, destination) {
-  if (!fs2.existsSync(destination)) {
-    fs2.mkdirSync(destination, { recursive: true });
+  if (!fs3.existsSync(destination)) {
+    fs3.mkdirSync(destination, { recursive: true });
   }
-  const entries = fs2.readdirSync(source, { withFileTypes: true });
+  const entries = fs3.readdirSync(source, { withFileTypes: true });
   for (const entry of entries) {
-    const srcPath = path2.join(source, entry.name);
-    const destPath = path2.join(destination, entry.name);
+    const srcPath = path3.join(source, entry.name);
+    const destPath = path3.join(destination, entry.name);
     if (entry.isDirectory()) {
       await copyDirectoryAsync(srcPath, destPath);
     } else {
-      fs2.copyFileSync(srcPath, destPath);
+      fs3.copyFileSync(srcPath, destPath);
     }
     if (entries.length > 10) {
       await new Promise((resolve) => setTimeout(resolve, 1));
@@ -802,20 +994,20 @@ function parseGitHubUrl(githubUrl) {
 
 // src/lib/init/scaffold/packages.ts
 import spawn2 from "cross-spawn";
-import chalk4 from "chalk";
+import chalk5 from "chalk";
 import ora2 from "ora";
 
 // src/lib/init/scaffold/agent.ts
 import ora3 from "ora";
-import chalk5 from "chalk";
-import path3 from "path";
-import fs3 from "fs";
+import chalk6 from "chalk";
+import path4 from "path";
+import fs4 from "fs";
 async function scaffoldAgent(userAnswers) {
   if (userAnswers.mode === "CrewAI" || userAnswers.mode === "LangGraph" && !userAnswers.langGraphAgent || userAnswers.mode === "Standard" || userAnswers.mode === "MCP") {
     return;
   }
   const spinner = ora3({
-    text: chalk5.cyan("Setting up AI agent..."),
+    text: chalk6.cyan("Setting up AI agent..."),
     color: "cyan"
   }).start();
   let template = "";
@@ -829,13 +1021,13 @@ async function scaffoldAgent(userAnswers) {
       break;
   }
   if (!template) {
-    spinner.fail(chalk5.red("Failed to determine agent template"));
+    spinner.fail(chalk6.red("Failed to determine agent template"));
     throw new Error("Failed to determine agent template");
   }
-  const agentDir = path3.join(process.cwd(), "agent");
+  const agentDir = path4.join(process.cwd(), "agent");
   try {
     await cloneGitHubSubdirectory(template, agentDir, spinner);
-    spinner.text = chalk5.cyan("Creating agent environment variables...");
+    spinner.text = chalk6.cyan("Creating agent environment variables...");
     let envContent = "";
     if (userAnswers.llmToken) {
       envContent += `OPENAI_API_KEY=${userAnswers.llmToken}
@@ -846,26 +1038,26 @@ async function scaffoldAgent(userAnswers) {
 `;
     }
     if (envContent) {
-      const agentEnvFile = path3.join(agentDir, ".env");
-      fs3.writeFileSync(agentEnvFile, envContent, "utf8");
-      spinner.text = chalk5.cyan("Added API keys to agent .env file");
+      const agentEnvFile = path4.join(agentDir, ".env");
+      fs4.writeFileSync(agentEnvFile, envContent, "utf8");
+      spinner.text = chalk6.cyan("Added API keys to agent .env file");
     }
     if (userAnswers.mode === "LangGraph" && userAnswers.langSmithApiKey) {
       envContent += `LANGSMITH_API_KEY=${userAnswers.langSmithApiKey}
 `;
     }
     if (envContent) {
-      const agentEnvFile = path3.join(agentDir, ".env");
-      fs3.writeFileSync(agentEnvFile, envContent, "utf8");
-      spinner.text = chalk5.cyan("Added API keys to agent .env file");
+      const agentEnvFile = path4.join(agentDir, ".env");
+      fs4.writeFileSync(agentEnvFile, envContent, "utf8");
+      spinner.text = chalk6.cyan("Added API keys to agent .env file");
     }
     if (envContent) {
-      const agentEnvFile = path3.join(agentDir, ".env");
-      fs3.writeFileSync(agentEnvFile, envContent, "utf8");
-      spinner.text = chalk5.cyan("Added API keys to agent .env file");
+      const agentEnvFile = path4.join(agentDir, ".env");
+      fs4.writeFileSync(agentEnvFile, envContent, "utf8");
+      spinner.text = chalk6.cyan("Added API keys to agent .env file");
     }
   } catch (error) {
-    spinner.fail(chalk5.red("Failed to clone agent template"));
+    spinner.fail(chalk6.red("Failed to clone agent template"));
     throw error;
   }
   spinner.succeed(`${userAnswers.mode} agent cloned successfully`);
@@ -885,29 +1077,29 @@ var AgentTemplates = {
 };
 
 // src/lib/init/scaffold/crew-inputs.ts
-import * as fs4 from "fs/promises";
+import * as fs5 from "fs/promises";
 import ora4 from "ora";
-import * as path4 from "path";
+import * as path5 from "path";
 async function addCrewInputs(url, token) {
   try {
     const spinner = ora4("Analyzing crew inputs...").start();
     const inputs = await getCrewInputs(url, token);
     spinner.text = "Adding inputs to app/copilotkit/page.tsx...";
-    let filePath = path4.join(process.cwd(), "app", "copilotkit", "page.tsx");
+    let filePath = path5.join(process.cwd(), "app", "copilotkit", "page.tsx");
     try {
-      await fs4.access(filePath);
+      await fs5.access(filePath);
     } catch {
-      filePath = path4.join(process.cwd(), "src", "app", "copilotkit", "page.tsx");
+      filePath = path5.join(process.cwd(), "src", "app", "copilotkit", "page.tsx");
     }
     try {
-      await fs4.access(filePath);
+      await fs5.access(filePath);
     } catch {
       throw new Error("app/copilotkit/page.tsx and src/app/copilotkit/page.tsx not found");
     }
-    let fileContent = await fs4.readFile(filePath, "utf8");
+    let fileContent = await fs5.readFile(filePath, "utf8");
     const inputsString = JSON.stringify(inputs);
     fileContent = fileContent.replace(/\[["']YOUR_INPUTS_HERE["']\]/g, inputsString);
-    await fs4.writeFile(filePath, fileContent, "utf8");
+    await fs5.writeFile(filePath, fileContent, "utf8");
     spinner.succeed("Successfully added crew inputs to app/copilotkit/page.tsx");
   } catch (error) {
     console.error("Error updating crew inputs:", error);
@@ -928,7 +1120,7 @@ async function getCrewInputs(url, token) {
 }
 
 // src/commands/init.ts
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 import ora5 from "ora";
 var CloudInit = class _CloudInit extends BaseCommand {
   constructor(argv, config, authService = new AuthService()) {
@@ -948,11 +1140,11 @@ var CloudInit = class _CloudInit extends BaseCommand {
   async run() {
     const { flags } = await this.parse(_CloudInit);
     try {
-      this.log(chalk6.magenta("\n\u{1FA81} Welcome to CopilotKit"));
+      this.log(chalk7.magenta("\n\u{1FA81} Welcome to CopilotKit"));
       if (flags.booth) {
-        this.log(chalk6.gray("Thanks for giving CopilotKit a try! Now, let's try to impress you \u{1F4AA}\n"));
+        this.log(chalk7.gray("Thanks for giving CopilotKit a try! Now, let's try to impress you \u{1F4AA}\n"));
       } else {
-        this.log(chalk6.gray("Let's power up your Next.js project with AI capabilities\n"));
+        this.log(chalk7.gray("Let's power up your Next.js project with AI capabilities\n"));
       }
       this.validateProjectCompatibility(flags);
       let userAnswers;
@@ -962,12 +1154,20 @@ var CloudInit = class _CloudInit extends BaseCommand {
         userAnswers = await this.getUserAnswers(flags);
       }
       if (userAnswers.mode === "Mastra") {
-        this.log(chalk6.magenta(`
-\u{1F517} Please go to https://docs.copilotkit.ai/mastra/quickstart/mastra to get started.`));
+        this.log(chalk7.magenta(`
+\u{1F517} Please go to https://docs.copilotkit.ai/mastra/quickstart to get started.`));
         process.exit(0);
       } else if (userAnswers.mode === "AG2") {
-        this.log(chalk6.magenta(`
-\u{1F517} Please go to https://docs.copilotkit.ai/ag2/quickstart/ag2 to get started.`));
+        this.log(chalk7.magenta(`
+\u{1F517} Please go to https://docs.copilotkit.ai/ag2/quickstart to get started.`));
+        process.exit(0);
+      } else if (userAnswers.mode === "Agno") {
+        this.log(chalk7.magenta(`
+\u{1F517} Please go to https://docs.copilotkit.ai/agno/quickstart to get started.`));
+        process.exit(0);
+      } else if (userAnswers.mode === "LlamaIndex") {
+        this.log(chalk7.magenta(`
+\u{1F517} Please go to https://docs.copilotkit.ai/llamaindex/quickstart to get started.`));
         process.exit(0);
       }
       const needsCloudSetup = userAnswers.useCopilotCloud === "Yes" || userAnswers.mode === "CrewAI";
@@ -975,16 +1175,27 @@ var CloudInit = class _CloudInit extends BaseCommand {
       await scaffoldEnv(flags, userAnswers);
       await scaffoldShadCN(flags, userAnswers);
       if (!flags.booth) await scaffoldAgent(userAnswers);
-      if (userAnswers.crewType === "Crews" && userAnswers.crewUrl && userAnswers.crewBearerToken)
+      if (userAnswers.crewUrl && userAnswers.crewBearerToken)
         await addCrewInputs(userAnswers.crewUrl, userAnswers.crewBearerToken);
+      if (userAnswers.setupIDEDocs === "Yes" && userAnswers.selectedIDE !== "skip") {
+        const ideDocsSpinner = ora5({
+          text: "Setting up CopilotKit IDE documentation...",
+          color: "cyan"
+        }).start();
+        try {
+          await handleIDEDocsSetup(userAnswers.selectedIDE, flags.dir, ideDocsSpinner);
+        } catch (error) {
+          ideDocsSpinner.fail("IDE documentation setup failed, but you can configure it manually later");
+        }
+      }
       if (flags.booth) {
         this.log("\n-----\n");
-        this.log(chalk6.magenta("\u{1F389} Your CopilotKit setup is complete! \u{1F389}\n"));
-        this.log(chalk6.bold("\n\u{1F680} Next steps:"));
-        this.log(`  - Start the Next.js app: ${chalk6.gray("$")} ${chalk6.cyan("npm run dev")}`);
-        this.log(`  - Navigate to ${chalk6.blue("http://localhost:3000/copilotkit")}`);
+        this.log(chalk7.magenta("\u{1F389} Your CopilotKit setup is complete! \u{1F389}\n"));
+        this.log(chalk7.bold("\n\u{1F680} Next steps:"));
+        this.log(`  - Start the Next.js app: ${chalk7.gray("$")} ${chalk7.cyan("npm run dev")}`);
+        this.log(`  - Navigate to ${chalk7.blue("http://localhost:3000/copilotkit")}`);
         this.log(`  - Talk to your agent.`);
-        this.log(chalk6.magenta("\nThanks for giving CopilotKit a try! \u{1FA81}\n"));
+        this.log(chalk7.magenta("\nThanks for giving CopilotKit a try! \u{1FA81}\n"));
       } else {
         this.finalSummary(userAnswers);
       }
@@ -1027,7 +1238,7 @@ var CloudInit = class _CloudInit extends BaseCommand {
     if (Object.keys(initialAnswers).length > 0) {
       this.log("\nUsing the following values from provided flags:");
       Object.entries(initialAnswers).forEach(([key, value]) => {
-        this.log(`  ${chalk6.green(key)}: ${value}`);
+        this.log(`  ${chalk7.green(key)}: ${value}`);
       });
       this.log("");
     }
@@ -1075,7 +1286,7 @@ var CloudInit = class _CloudInit extends BaseCommand {
       this.log(
         "\nCurrently the CLI only supports scaffolding LangGraph Platform agents. Use our quickstart guide to get started:\n"
       );
-      this.log(chalk6.blue("https://docs.copilotkit.ai/coagents/quickstart/langgraph"));
+      this.log(chalk7.blue("https://docs.copilotkit.ai/coagents/quickstart/langgraph"));
       process.exit(0);
     }
     try {
@@ -1087,12 +1298,12 @@ var CloudInit = class _CloudInit extends BaseCommand {
       const spinner = ora5({ text: "Validation failed...", color: "red" }).start();
       if (error.errors) {
         const formattedErrors = error.errors.map((err) => `- ${err.path.join(".")}: ${err.message}`).join("\n");
-        spinner.fail(chalk6.red("Configuration validation failed:"));
-        console.error(chalk6.red(formattedErrors));
+        spinner.fail(chalk7.red("Configuration validation failed:"));
+        console.error(chalk7.red(formattedErrors));
         process.exit(1);
       }
-      spinner.fail(chalk6.red("Unexpected validation error:"));
-      console.error(chalk6.red(error.message || "Unknown error"));
+      spinner.fail(chalk7.red("Unexpected validation error:"));
+      console.error(chalk7.red(error.message || "Unknown error"));
       process.exit(1);
     }
   }
@@ -1103,11 +1314,11 @@ var CloudInit = class _CloudInit extends BaseCommand {
     let selectedProjectId;
     if (flags.project) {
       if (!availableProjects.some((project) => project.id === flags.project)) {
-        this.log(chalk6.red(`\u{1F4C1} Project with ID ${flags.project} not found`));
+        this.log(chalk7.red(`\u{1F4C1} Project with ID ${flags.project} not found`));
         process.exit(1);
       }
       selectedProjectId = flags.project;
-      this.log(chalk6.green(`\u{1F4C1} Selected project ${selectedProjectId}`));
+      this.log(chalk7.green(`\u{1F4C1} Selected project ${selectedProjectId}`));
     } else {
       const { projectId } = await inquirer3.prompt([
         {
@@ -1139,12 +1350,12 @@ var CloudInit = class _CloudInit extends BaseCommand {
       const updatedConfig = ConfigSchema.parse(sanitizedConfig);
       Object.assign(userAnswers, updatedConfig);
     } catch (error) {
-      this.log(chalk6.red(`Failed to update configuration with Copilot Cloud API key: ${error.message}`));
+      this.log(chalk7.red(`Failed to update configuration with Copilot Cloud API key: ${error.message}`));
     }
     if (userAnswers.crewUrl && userAnswers.crewName && userAnswers.crewBearerToken) {
       const isFlow = userAnswers.crewType === "Flows";
       const crewSpinner = ora5({
-        text: chalk6(`\u{1F465} Adding CrewAI ${isFlow ? "Flow" : "Crew"} to Copilot Cloud...`),
+        text: chalk7(`\u{1F465} Adding CrewAI ${isFlow ? "Flow" : "Crew"} to Copilot Cloud...`),
         color: "cyan"
       }).start();
       try {
@@ -1160,22 +1371,22 @@ var CloudInit = class _CloudInit extends BaseCommand {
             crewApiBearerToken: userAnswers.crewBearerToken
           }
         });
-        crewSpinner.succeed(chalk6(`\u{1F465} CrewAI ${isFlow ? "Flow" : "Crew"} added to Copilot Cloud`));
+        crewSpinner.succeed(chalk7(`\u{1F465} CrewAI ${isFlow ? "Flow" : "Crew"} added to Copilot Cloud`));
       } catch (error) {
-        crewSpinner.fail(chalk6(`\u{1F465} Failed to add CrewAI ${isFlow ? "Flow" : "Crew"} to Copilot Cloud`));
+        crewSpinner.fail(chalk7(`\u{1F465} Failed to add CrewAI ${isFlow ? "Flow" : "Crew"} to Copilot Cloud`));
         console.error(error);
         process.exit(1);
       }
     }
     if (userAnswers.mode === "LangGraph" && userAnswers.useCopilotCloud === "Yes" && userAnswers.alreadyDeployed === "Yes") {
       const langGraphSpinner = ora5({
-        text: chalk6("\u{1F99C}\u{1F517} Adding LangGraph to Copilot Cloud..."),
+        text: chalk7("\u{1F99C}\u{1F517} Adding LangGraph to Copilot Cloud..."),
         color: "cyan"
       }).start();
       if (userAnswers.langGraphPlatform === "Yes" && userAnswers.langGraphPlatformUrl) {
         try {
           if (!userAnswers.langSmithApiKey) {
-            langGraphSpinner.fail(chalk6("\u{1F99C}\u{1F517} LangSmith API key not found. Please provide a valid LangSmith API key."));
+            langGraphSpinner.fail(chalk7("\u{1F99C}\u{1F517} LangSmith API key not found. Please provide a valid LangSmith API key."));
             process.exit(1);
           }
           await this.trpcClient.createLGCRemoteEndpoint.mutate({
@@ -1188,9 +1399,9 @@ var CloudInit = class _CloudInit extends BaseCommand {
               agents: []
             }
           });
-          langGraphSpinner.succeed(chalk6("\u{1F99C}\u{1F517} LangGraph Cloud remote endpoint created"));
+          langGraphSpinner.succeed(chalk7("\u{1F99C}\u{1F517} LangGraph Cloud remote endpoint created"));
         } catch (error) {
-          langGraphSpinner.fail(chalk6("\u{1F99C}\u{1F517} Failed to create LangGraph Cloud remote endpoint. Please try again."));
+          langGraphSpinner.fail(chalk7("\u{1F99C}\u{1F517} Failed to create LangGraph Cloud remote endpoint. Please try again."));
           process.exit(1);
         }
       } else if (userAnswers.langGraphRemoteEndpointURL) {
@@ -1204,9 +1415,9 @@ var CloudInit = class _CloudInit extends BaseCommand {
               // Already sanitized
             }
           });
-          langGraphSpinner.succeed(chalk6("\u{1F99C}\u{1F517} LangGraph remote endpoint created"));
+          langGraphSpinner.succeed(chalk7("\u{1F99C}\u{1F517} LangGraph remote endpoint created"));
         } catch (error) {
-          langGraphSpinner.fail(chalk6("\u{1F99C}\u{1F517} Failed to create LangGraph remote endpoint. Please try again."));
+          langGraphSpinner.fail(chalk7("\u{1F99C}\u{1F517} Failed to create LangGraph remote endpoint. Please try again."));
           process.exit(1);
         }
       }
@@ -1215,17 +1426,17 @@ var CloudInit = class _CloudInit extends BaseCommand {
   validateProjectCompatibility(flags) {
     const spinner = ora5("Checking Next.js project compatibility...").start();
     try {
-      const projectPath = path5.resolve(process.cwd(), flags.dir);
-      if (!fs5.existsSync(projectPath)) {
+      const projectPath = path6.resolve(process.cwd(), flags.dir);
+      if (!fs6.existsSync(projectPath)) {
         spinner.fail(`Directory ${flags.dir} does not exist`);
         throw new Error(`Please provide a valid Next.js project directory.`);
       }
-      const packageJsonPath = path5.join(projectPath, "package.json");
-      if (!fs5.existsSync(packageJsonPath)) {
+      const packageJsonPath = path6.join(projectPath, "package.json");
+      if (!fs6.existsSync(packageJsonPath)) {
         spinner.fail(`No package.json found in ${projectPath}`);
         throw new Error(`Please provide a valid Next.js project with a package.json file.`);
       }
-      const packageJson = JSON.parse(fs5.readFileSync(packageJsonPath, "utf8"));
+      const packageJson = JSON.parse(fs6.readFileSync(packageJsonPath, "utf8"));
       if (!packageJson.dependencies?.next && !packageJson.devDependencies?.next) {
         spinner.fail(`Not a Next.js project`);
         throw new Error(
@@ -1236,9 +1447,9 @@ var CloudInit = class _CloudInit extends BaseCommand {
       return true;
     } catch (error) {
       if (!spinner.isSpinning) {
-        this.log(chalk6.red(error.message));
+        this.log(chalk7.red(error.message));
       } else {
-        spinner.fail(chalk6.red(error.message));
+        spinner.fail(chalk7.red(error.message));
       }
       process.exit(1);
     }
@@ -1248,9 +1459,9 @@ var CloudInit = class _CloudInit extends BaseCommand {
     let agentSetupMessage = "";
     if (userAnswers.mode === "CrewAI") {
       if (userAnswers.crewType === "Crews") {
-        agentSetupMessage = `Using your Crew from ${chalk6.cyan(userAnswers.crewUrl || "the provided URL")}.`;
+        agentSetupMessage = `Using your Crew from ${chalk7.cyan(userAnswers.crewUrl || "the provided URL")}.`;
       } else if (userAnswers.crewType === "Flows") {
-        agentSetupMessage = `We've scaffolded a ${chalk6.cyan("CrewAI Flow")} agent in the ${chalk6.cyan("./agent")} directory.`;
+        agentSetupMessage = `We've scaffolded a ${chalk7.cyan("CrewAI Flow")} agent in the ${chalk7.cyan("./agent")} directory.`;
         agentDevInstructions = "poetry lock && poetry install && poetry run demo";
       }
     }
@@ -1258,11 +1469,11 @@ var CloudInit = class _CloudInit extends BaseCommand {
       case "LangGraph":
         switch (userAnswers.langGraphAgent) {
           case "Python Starter":
-            agentSetupMessage = `We've scaffolded a ${chalk6.cyan(userAnswers.langGraphAgent || "LangGraph")} agent in the ${chalk6.cyan("./agent")} directory.`;
+            agentSetupMessage = `We've scaffolded a ${chalk7.cyan(userAnswers.langGraphAgent || "LangGraph")} agent in the ${chalk7.cyan("./agent")} directory.`;
             agentDevInstructions = "poetry lock && poetry install && npx @langchain/langgraph-cli dev --port 8123";
             break;
           case "TypeScript Starter":
-            agentSetupMessage = `We've scaffolded a ${chalk6.cyan(userAnswers.langGraphAgent || "LangGraph")} agent in the ${chalk6.cyan("./agent")} directory.`;
+            agentSetupMessage = `We've scaffolded a ${chalk7.cyan(userAnswers.langGraphAgent || "LangGraph")} agent in the ${chalk7.cyan("./agent")} directory.`;
             agentDevInstructions = "npm install && npm run dev";
             break;
           default:
@@ -1272,29 +1483,32 @@ var CloudInit = class _CloudInit extends BaseCommand {
       case "CrewAI":
         switch (userAnswers.crewType) {
           case "Crews":
-            agentSetupMessage = `Using your Crew from ${chalk6.cyan(userAnswers.crewUrl || "the provided URL")}.`;
+            agentSetupMessage = `Using your Crew from ${chalk7.cyan(userAnswers.crewUrl || "the provided URL")}.`;
             break;
           case "Flows":
-            agentSetupMessage = `We've scaffolded a ${chalk6.cyan("CrewAI Flow")} agent in the ${chalk6.cyan("./agent")} directory.`;
+            agentSetupMessage = `We've scaffolded a ${chalk7.cyan("CrewAI Flow")} agent in the ${chalk7.cyan("./agent")} directory.`;
             break;
         }
         break;
       default:
     }
     this.log("\n-----\n");
-    this.log(chalk6.magenta("\u{1F389} Your CopilotKit setup is complete! \u{1F389}\n"));
-    this.log(chalk6.bold(`\u{1F4CB} Recap`));
+    this.log(chalk7.magenta("\u{1F389} Your CopilotKit setup is complete! \u{1F389}\n"));
+    this.log(chalk7.bold(`\u{1F4CB} Recap`));
     this.log(`  - CopilotKit has been added to your Next.js app.`);
     if (agentSetupMessage) this.log(`  - ${agentSetupMessage}`);
     if (userAnswers.useCopilotCloud || userAnswers.crewType === "Crews") this.log(`  - With Copilot Cloud.`);
-    this.log(chalk6.bold("\n\u{1F680} Next steps:"));
-    this.log(`  - Start your Next.js app: ${chalk6.gray("$")} ${chalk6.cyan("npm run dev")}`);
+    this.log(chalk7.bold("\n\u{1F680} Next steps:"));
+    this.log(`  - Start your Next.js app: ${chalk7.gray("$")} ${chalk7.cyan("npm run dev")}`);
     if (agentDevInstructions)
-      this.log(`  - Start your agent: ${chalk6.gray("$")} ${chalk6.cyan(`cd agent && ${agentDevInstructions}`)}`);
-    this.log(`  - Navigate to ${chalk6.blue("http://localhost:3000/copilotkit")}`);
+      this.log(`  - Start your agent: ${chalk7.gray("$")} ${chalk7.cyan(`cd agent && ${agentDevInstructions}`)}`);
+    this.log(`  - Navigate to ${chalk7.blue("http://localhost:3000/copilotkit")}`);
     this.log(`  - Talk to your agent.`);
-    this.log(`  - Read the docs: ${chalk6.blue("https://docs.copilotkit.ai")}`);
-    this.log(chalk6.magenta("\nEnjoy building with CopilotKit \u{1FA81}\n"));
+    if (userAnswers.setupIDEDocs === "Yes" && userAnswers.selectedIDE !== "skip") {
+      this.log(`  - Your IDE now has CopilotKit documentation context for better AI assistance.`);
+    }
+    this.log(`  - Read the docs: ${chalk7.blue("https://docs.copilotkit.ai")}`);
+    this.log(chalk7.magenta("\nEnjoy building with CopilotKit \u{1FA81}\n"));
   }
 };
 export {