copilotkit 0.0.48 → 0.0.50

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 path6 from "path";
-import fs6 from "fs";
+import { Flags as Flags3 } from "@oclif/core";
+import inquirer4 from "inquirer";
+import path7 from "path";
+import fs7 from "fs";
 
 // src/services/auth.service.ts
 import Conf2 from "conf";
@@ -284,7 +284,7 @@ import { Command } from "@oclif/core";
 import Sentry, { consoleIntegration } from "@sentry/node";
 
 // src/utils/version.ts
-var LIB_VERSION = "0.0.48";
+var LIB_VERSION = "0.0.50";
 
 // src/commands/base-command.ts
 import chalk2 from "chalk";
@@ -332,9 +332,406 @@ var BaseCommand = class extends Command {
   }
 };
 
+// src/commands/create.ts
+import { Flags, Args } from "@oclif/core";
+import inquirer2 from "inquirer";
+import chalk3 from "chalk";
+import fs from "fs-extra";
+import path from "path";
+import { promisify } from "util";
+import { pipeline } from "stream";
+import { createWriteStream } from "fs";
+import { extract } from "tar";
+import ora2 from "ora";
+var streamPipeline = promisify(pipeline);
+var theme = {
+  primary: chalk3.magenta,
+  secondary: chalk3.gray,
+  tertiary: chalk3.gray,
+  error: chalk3.red,
+  command: chalk3.blue,
+  success: chalk3.green,
+  warning: chalk3.yellow,
+  divider: chalk3.gray("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"),
+  bottomPadding: ""
+};
+var TEMPLATE_REPOS = {
+  "langgraph-py": "copilotkit/with-langgraph-python",
+  "langgraph-js": "copilotkit/with-langgraph-js",
+  mastra: "copilotkit/with-mastra",
+  flows: "copilotkit/with-crewai-flows",
+  llamaindex: "copilotkit/with-llamaindex",
+  agno: "copilotkit/with-agno",
+  "pydantic-ai": "copilotkit/with-pydantic-ai",
+  ag2: "ag2ai/ag2-copilotkit-starter"
+};
+var FRAMEWORK_DOCUMENTATION = {
+  "langgraph-py": "https://langchain-ai.github.io/langgraph/concepts/why-langgraph",
+  "langgraph-js": "https://langchain-ai.github.io/langgraphjs",
+  flows: "https://docs.crewai.com/guides/flows/first-flow",
+  mastra: "https://mastra.ai/en/docs",
+  "pydantic-ai": "https://ai.pydantic.dev/ag-ui/",
+  llamaindex: "https://docs.llamaindex.ai/en/stable",
+  agno: "https://docs.agno.com/",
+  ag2: "https://docs.ag2.ai/latest/docs/user-guide/basic-concepts/overview"
+};
+var FRAMEWORK_EMOJI = {
+  "langgraph-js": "\u{1F99C}",
+  "langgraph-py": "\u{1F99C}",
+  flows: "\u{1F465}",
+  mastra: "\u{1F311}",
+  "pydantic-ai": "\u{1F53C}",
+  llamaindex: "\u{1F999}",
+  ag2: "\u{1F916}",
+  agno: "\u{1F170}\uFE0F"
+};
+var KITE = `
+\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF
+\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u281F\u2819\u28FF\u285B\u283B\u283F\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF
+\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u280B\u2800\u2800\u2808\u28BF\u2844\u2800\u2800\u2800\u2808\u2809\u2819\u28FB\u28FF\u28FF\u28FF
+\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u281F\u2801\u2800\u2800\u2800\u2800\u2808\u28BF\u2844\u2800\u2880\u28E0\u28F4\u283E\u280B\u28B8\u28FF\u28FF
+\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u285F\u2801\u2880\u28C0\u28C0\u28C0\u28C0\u28E4\u28E4\u287E\u28BF\u285F\u281B\u2809\u2800\u2800\u2800\u2800\u28FF\u28FF
+\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u285B\u281B\u281B\u281B\u2809\u2809\u2809\u2801\u2800\u28A0\u287F\u28FF\u2840\u2800\u2800\u2800\u2800\u2800\u28FF\u28FF
+\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28C6\u2800\u2800\u2800\u2800\u2800\u2800\u28F0\u285F\u2800\u2838\u28E7\u2800\u2800\u2800\u2800\u28A0\u28FF\u28FF
+\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28F7\u28C4\u2800\u2800\u2880\u28FC\u280F\u2800\u2800\u2800\u28FF\u2840\u2800\u2800\u2800\u28B8\u28FF\u28FF
+\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u2802\u28E0\u287F\u2801\u2800\u2800\u2800\u2800\u28B8\u2847\u2800\u2800\u2800\u28FF\u28FF\u28FF
+\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u281F\u28E1\u28FE\u28FF\u28C4\u2800\u2800\u2800\u2800\u2800\u28B8\u2847\u2800\u2800\u28B0\u28FF\u28FF\u28FF
+\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u285F\u281B\u287F\u280B\u28E1\u28FE\u28FF\u28FF\u28FF\u28FF\u28E6\u2840\u2800\u2800\u2800\u28B8\u2847\u2800\u2800\u28FF\u28FF\u28FF\u28FF
+\u28FF\u28FF\u28FF\u28FF\u287F\u283F\u28FF\u2837\u2802\u2840\u2818\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28F7\u2840\u2800\u2800\u28B8\u2847\u2800\u28FC\u28FF\u28FF\u28FF\u28FF
+\u28FF\u28FF\u283B\u28BF\u2877\u2800\u2801\u2834\u28FF\u28F7\u28FE\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u2844\u2800\u28FE\u2807\u28F4\u28FF\u28FF\u28FF\u28FF\u28FF
+\u287F\u281B\u2800\u2800\u28B4\u28FE\u28F7\u28F6\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28E4\u28FF\u28FE\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF
+\u28F7\u28FE\u28FF\u28E4\u28FE\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF\u28FF
+`;
+var Create = class _Create extends BaseCommand {
+  constructor(argv, config, authService = new AuthService()) {
+    super(argv, config);
+    this.authService = authService;
+  }
+  trpcClient = null;
+  analytics = null;
+  startTime = Date.now();
+  analyticsQueue = [];
+  static description = "Create a new CopilotKit project with Next.js and Cloud setup";
+  static examples = [
+    "$ copilotkit create my-app",
+    "$ copilotkit create my-app --framework langgraph-js",
+    "$ copilotkit create -n my-app -f langgraph-js"
+  ];
+  static flags = {
+    ...BaseCommand.flags,
+    framework: Flags.string({
+      char: "f",
+      description: "Agent framework to use",
+      options: Object.keys(TEMPLATE_REPOS),
+      required: false
+    }),
+    name: Flags.string({
+      char: "n",
+      description: "Name of the project",
+      required: false
+    }),
+    "no-banner": Flags.boolean({
+      char: "q",
+      description: "Removes the banner",
+      default: false,
+      required: false
+    }),
+    project: Flags.string({
+      description: "project ID (can be found in the Copilot Cloud dashboard)"
+    })
+  };
+  static args = {
+    projectName: Args.string({
+      description: "Name of the project",
+      required: false
+    })
+  };
+  async run() {
+    const { args, flags } = await this.parse(_Create);
+    try {
+      this.analytics = new AnalyticsService();
+      if (!flags["no-banner"]) {
+        this.log(theme.primary(KITE));
+        this.log(theme.primary("~ Welcome to CopilotKit! ~\n"));
+        this.log(theme.divider);
+        if ((!flags.name || flags.projectName) && !flags.framework) {
+          this.log("\n" + theme.secondary("Just a few questions to get started!\n"));
+        }
+      }
+      const projectName = flags.name || args.projectName || await this.promptProjectName();
+      const agentFramework = flags.framework || await this.promptAgentFramework();
+      this.queueAnalytics("cli.create.started", {
+        framework_selected: agentFramework,
+        project_name: projectName,
+        flags_used: Object.keys(flags).filter((key) => flags[key] !== void 0 && key !== "help")
+      });
+      const projectDir = path.resolve(process.cwd(), projectName);
+      if (fs.existsSync(projectDir)) {
+        this.log(theme.error(`
+Directory "${projectName}" already exists.`));
+        this.log(theme.secondary("\nYou can:"));
+        this.log(theme.secondary("  1. Choose a different project name"));
+        this.log(theme.secondary("  2. Remove the existing directory manually if you want to use this name\n"));
+        this.exit(1);
+      }
+      this.log(chalk3.cyan("\n\u{1F511} Now get your API key"));
+      this.log(chalk3.gray("Setting up your cloud account and retrieving your API key...\n"));
+      let cloudSetupInfo = null;
+      try {
+        cloudSetupInfo = await this.setupCloudApiKey(flags);
+        if (this.analytics && cloudSetupInfo.cliToken) {
+          const trpcClient2 = createTRPCClient(cloudSetupInfo.cliToken);
+          const me = await trpcClient2.me.query();
+          if (me.user && me.organization) {
+            this.analytics = new AnalyticsService({
+              userId: me.user.id,
+              organizationId: me.organization.id,
+              email: me.user.email
+            });
+          }
+        }
+        this.queueAnalytics("cli.create.cloud_setup_completed", {
+          framework: agentFramework,
+          project_id: cloudSetupInfo.selectedProjectId,
+          api_key_retrieved: !!cloudSetupInfo.apiKey
+        });
+      } catch (error) {
+        this.queueAnalytics("cli.create.cloud_setup_failed", {
+          framework: agentFramework,
+          error: error.message
+        });
+        throw error;
+      }
+      const options = {
+        projectName,
+        agentFramework,
+        apiKey: cloudSetupInfo?.apiKey,
+        projectId: cloudSetupInfo?.selectedProjectId
+      };
+      const spinner = ora2({
+        text: theme.secondary.bold("Creating your project..."),
+        color: "cyan",
+        spinner: "dots"
+      }).start();
+      try {
+        await fs.ensureDir(projectDir);
+        spinner.text = theme.secondary.bold("Downloading template...");
+        await this.downloadTemplate(projectDir, options.agentFramework);
+        if (options.apiKey) {
+          spinner.text = theme.secondary.bold("Configuring API key...");
+          await this.configureApiKey(projectDir, options.apiKey);
+        }
+        spinner.succeed(theme.secondary.bold(`Project "${projectName}" created successfully!`));
+        this.queueAnalytics("cli.create.project_created", {
+          framework: agentFramework,
+          project_name: projectName,
+          has_api_key: !!options.apiKey,
+          duration_ms: Date.now() - this.startTime
+        });
+        this.log("\n" + theme.divider);
+        this.log(
+          "\n" + theme.secondary.bold(
+            `\u{1FA81}\u{1F91D}${FRAMEWORK_EMOJI[options.agentFramework]} All set! 
+
+Your project is ready with Copilot Cloud configured.`
+          )
+        );
+        this.log("\n" + theme.secondary("Next steps:"));
+        this.log(theme.secondary(`  \u2022 ${theme.command(`cd ${projectName}`)}`));
+        this.log(theme.secondary("  \u2022 Follow the setup instructions in the README.md"));
+        this.log("\n" + theme.secondary("Documentation:"));
+        this.log(theme.secondary("  \u2022 ") + theme.command("https://docs.copilotkit.ai"));
+        this.log(theme.secondary("  \u2022 ") + theme.command(FRAMEWORK_DOCUMENTATION[options.agentFramework]));
+        this.log(theme.bottomPadding);
+        this.queueAnalytics("cli.create.completed", {
+          framework: agentFramework,
+          project_name: projectName,
+          cloud_setup_completed: !!cloudSetupInfo,
+          api_key_configured: !!options.apiKey,
+          duration_ms: Date.now() - this.startTime
+        });
+        await this.flushAnalytics();
+      } catch (error) {
+        spinner.fail(theme.error(`Failed to create project: ${error.message}`));
+        this.queueAnalytics("cli.create.failed", {
+          framework: agentFramework,
+          project_name: projectName,
+          error: error.message,
+          step: "project_creation",
+          duration_ms: Date.now() - this.startTime
+        });
+        await this.flushAnalytics();
+        this.exit(1);
+      }
+    } catch (error) {
+      this.queueAnalytics("cli.create.failed", {
+        error: error.message,
+        step: "initialization",
+        duration_ms: Date.now() - this.startTime
+      });
+      await this.flushAnalytics();
+      this.gracefulError(error.message);
+    }
+  }
+  async promptProjectName() {
+    const { projectName } = await inquirer2.prompt([
+      {
+        type: "input",
+        name: "projectName",
+        message: theme.secondary("What is your project named?"),
+        validate: (input) => {
+          if (!input) return theme.error("Project name is required");
+          if (!/^[a-z0-9-]+$/.test(input)) {
+            return theme.error("Project name can only contain lowercase letters, numbers, and hyphens");
+          }
+          if (input.length > 30) {
+            return theme.error("Project name must be less than 30 characters");
+          }
+          return true;
+        }
+      }
+    ]);
+    return projectName;
+  }
+  async promptAgentFramework() {
+    const { framework } = await inquirer2.prompt([
+      {
+        type: "list",
+        name: "framework",
+        message: theme.secondary("Which agent framework would you like to use?"),
+        choices: [
+          { name: `${FRAMEWORK_EMOJI["langgraph-py"]} LangGraph (Python)`, value: "langgraph-py" },
+          { name: `${FRAMEWORK_EMOJI["langgraph-js"]} LangGraph (JavaScript)`, value: "langgraph-js" },
+          { name: `${FRAMEWORK_EMOJI.mastra} Mastra`, value: "mastra" },
+          { name: `${FRAMEWORK_EMOJI["pydantic-ai"]} Pydantic AI`, value: "pydantic-ai" },
+          { name: `${FRAMEWORK_EMOJI.flows} CrewAI Flows`, value: "flows" },
+          { name: `${FRAMEWORK_EMOJI.llamaindex} LlamaIndex`, value: "llamaindex" },
+          { name: `${FRAMEWORK_EMOJI.agno}  Agno`, value: "agno" },
+          { name: `${FRAMEWORK_EMOJI.ag2} AG2`, value: "ag2" }
+        ]
+      }
+    ]);
+    return framework;
+  }
+  async downloadTemplate(projectDir, framework) {
+    const repo = TEMPLATE_REPOS[framework];
+    const url = `https://github.com/${repo}/archive/refs/heads/main.tar.gz`;
+    try {
+      const response = await fetch(url);
+      if (!response.ok) throw new Error(`Failed to download template: ${response.statusText}`);
+      const tempFile = path.join(projectDir, "template.tar.gz");
+      const fileStream = createWriteStream(tempFile);
+      if (!response.body) throw new Error("Failed to get response body");
+      await streamPipeline(response.body, fileStream);
+      await extract({
+        file: tempFile,
+        cwd: projectDir,
+        strip: 1
+      });
+      await fs.remove(tempFile);
+    } catch (error) {
+      throw new Error(`Failed to download template: ${error.message}`);
+    }
+  }
+  /**
+   * Queue an analytics event to be sent later (non-blocking)
+   */
+  queueAnalytics(event, properties) {
+    this.analyticsQueue.push({ event, properties });
+  }
+  /**
+   * Send all queued analytics events in fire-and-forget manner
+   */
+  async flushAnalytics() {
+    if (!this.analytics || this.analyticsQueue.length === 0) {
+      return;
+    }
+    const promises = this.analyticsQueue.map(
+      ({ event, properties }) => this.analytics.track({ event, properties }).catch(() => {
+      })
+    );
+    Promise.all(promises).catch(() => {
+    });
+    if (this.analytics) {
+      this.analytics.shutdown().catch(() => {
+      });
+    }
+  }
+  async setupCloudApiKey(flags) {
+    const { cliToken, organization } = await this.authService.requireLogin(this, "cloud-features");
+    this.trpcClient = createTRPCClient(cliToken);
+    const availableProjects = await this.trpcClient.listOrgProjects.query({ orgId: organization.id });
+    let selectedProjectId;
+    if (flags.project) {
+      if (!availableProjects.some((project) => project.id === flags.project)) {
+        this.log(chalk3.red(`\u{1F4C1} Project with ID ${flags.project} not found`));
+        process.exit(1);
+      }
+      selectedProjectId = flags.project;
+      this.log(chalk3.green(`\u{1F4C1} Selected project ${selectedProjectId}`));
+    } else if (availableProjects.length === 1) {
+      selectedProjectId = availableProjects[0].id;
+      this.log(chalk3.green(`\u{1F4C1} Auto-selected project ${selectedProjectId}`));
+    } else {
+      const { projectId } = await inquirer2.prompt([
+        {
+          name: "projectId",
+          type: "list",
+          message: "\u{1F4C1} Choose a project:",
+          choices: availableProjects.map((project) => ({
+            value: project.id,
+            name: `${project.name} (ID: ${project.id})`
+          }))
+        }
+      ]);
+      selectedProjectId = projectId;
+    }
+    const spinner = ora2({
+      text: "Retrieving your API key...",
+      color: "cyan"
+    }).start();
+    try {
+      const copilotCloudPublicApiKey = await this.trpcClient.getCopilotCloudPublicApiKey.query({
+        projectId: selectedProjectId
+      });
+      if (!copilotCloudPublicApiKey?.key) {
+        spinner.fail("Failed to retrieve API key");
+        throw new Error("No API key found for the selected project");
+      }
+      spinner.succeed("\u2705 API key retrieved successfully");
+      return {
+        cliToken,
+        organization,
+        selectedProjectId,
+        apiKey: copilotCloudPublicApiKey.key
+      };
+    } catch (error) {
+      spinner.fail("Failed to retrieve API key");
+      throw error;
+    }
+  }
+  async configureApiKey(projectDir, apiKey) {
+    const envPath = path.join(projectDir, ".env.local");
+    const envExamplePath = path.join(projectDir, ".env.example");
+    try {
+      let envContent = "";
+      if (await fs.pathExists(envExamplePath)) {
+        envContent = await fs.readFile(envExamplePath, "utf8");
+        envContent = envContent.replace(/COPILOT_CLOUD_PUBLIC_API_KEY=.*/g, `COPILOT_CLOUD_PUBLIC_API_KEY=${apiKey}`);
+      } else {
+        envContent = `COPILOT_CLOUD_PUBLIC_API_KEY=${apiKey}
+`;
+      }
+      await fs.writeFile(envPath, envContent);
+    } catch (error) {
+      console.warn("Warning: Could not configure API key in .env.local file");
+    }
+  }
+};
+
 // src/lib/init/types/questions.ts
 import { z } from "zod";
-import { Flags } from "@oclif/core";
+import { Flags as Flags2 } from "@oclif/core";
 
 // src/lib/init/utils.ts
 var isLocalhost = (url) => {
@@ -443,24 +840,24 @@ var ConfigSchema = z.object({
   }
 );
 var ConfigFlags = {
-  booth: Flags.boolean({ description: "Use CopilotKit in booth mode", default: false, char: "b" }),
-  mode: Flags.string({ description: "How you will be interacting with AI", options: MODES, char: "m" }),
-  "copilotkit-version": Flags.string({ description: "CopilotKit version to use (e.g. 1.7.0)" }),
-  "use-copilot-cloud": Flags.string({ description: "Use Copilot Cloud for production-ready hosting", options: YES_NO }),
-  "langgraph-agent": Flags.string({ description: "LangGraph agent template to use", options: LANGGRAPH_AGENTS }),
-  "crew-type": Flags.string({ description: "CrewAI implementation type", options: CREW_TYPES }),
-  "crew-name": Flags.string({ description: "Name for your CrewAI agent" }),
-  "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" }),
-  "setup-ide-docs": Flags.string({ description: "Setup IDE documentation rules for AI assistance", options: YES_NO }),
-  "selected-ide": Flags.string({
+  booth: Flags2.boolean({ description: "Use CopilotKit in booth mode", default: false, char: "b" }),
+  mode: Flags2.string({ description: "How you will be interacting with AI", options: MODES, char: "m" }),
+  "copilotkit-version": Flags2.string({ description: "CopilotKit version to use (e.g. 1.7.0)" }),
+  "use-copilot-cloud": Flags2.string({ description: "Use Copilot Cloud for production-ready hosting", options: YES_NO }),
+  "langgraph-agent": Flags2.string({ description: "LangGraph agent template to use", options: LANGGRAPH_AGENTS }),
+  "crew-type": Flags2.string({ description: "CrewAI implementation type", options: CREW_TYPES }),
+  "crew-name": Flags2.string({ description: "Name for your CrewAI agent" }),
+  "crew-url": Flags2.string({ description: "URL endpoint for your CrewAI agent" }),
+  "crew-bearer-token": Flags2.string({ description: "Bearer token for CrewAI authentication" }),
+  "langsmith-api-key": Flags2.string({ description: "LangSmith API key for LangGraph observability" }),
+  "llm-token": Flags2.string({ description: "API key for your preferred LLM provider" }),
+  "setup-ide-docs": Flags2.string({ description: "Setup IDE documentation rules for AI assistance", options: YES_NO }),
+  "selected-ide": Flags2.string({
     description: "IDE to configure with documentation rules",
     options: ["cursor", "windsurf", "skip"]
   }),
   // NEW: A/B/C test flags
-  "deployment-choice": Flags.string({
+  "deployment-choice": Flags2.string({
     description: "Choose between Copilot Cloud or Self-hosted deployment",
     options: DEPLOYMENT_CHOICES
   })
@@ -487,10 +884,10 @@ var templateMapping = {
 };
 
 // src/lib/init/ide-docs.ts
-import path from "path";
+import path2 from "path";
 import { existsSync } from "fs";
-import * as fs from "fs/promises";
-import chalk3 from "chalk";
+import * as fs2 from "fs/promises";
+import chalk4 from "chalk";
 var COPILOTKIT_DOC_RULE_TEMPLATE = `---
 description: CopilotKit Documentation - Complete CopilotKit framework documentation for AI assistance
 alwaysApply: false
@@ -528,7 +925,7 @@ var IDE_DOCS_CONFIGS = {
 };
 async function ensureDir(dirPath) {
   try {
-    await fs.mkdir(dirPath, { recursive: true });
+    await fs2.mkdir(dirPath, { recursive: true });
   } catch (error) {
     if (!existsSync(dirPath)) {
       throw error;
@@ -537,7 +934,7 @@ async function ensureDir(dirPath) {
 }
 async function pathExists(filePath) {
   try {
-    await fs.access(filePath);
+    await fs2.access(filePath);
     return true;
   } catch {
     return false;
@@ -549,10 +946,10 @@ async function checkIDEInstallation(ide) {
     let configPath;
     switch (ide) {
       case "cursor":
-        configPath = path.join(homeDir, ".cursor");
+        configPath = path2.join(homeDir, ".cursor");
         break;
       case "windsurf":
-        configPath = path.join(homeDir, ".codeium", "windsurf");
+        configPath = path2.join(homeDir, ".codeium", "windsurf");
         break;
       default:
         return false;
@@ -574,30 +971,30 @@ async function detectInstalledIDEs() {
 }
 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);
+  const rulesDir = path2.join(projectDir, config.rulesDir);
+  const ruleFilePath = path2.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}`));
+    console.log(chalk4.yellow(`\u26A0\uFE0F  CopilotKit documentation rule already exists for ${config.displayName}`));
     return;
   }
   const ruleContent = config.createRuleContent();
-  await fs.writeFile(ruleFilePath, ruleContent, "utf8");
+  await fs2.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}!`),
+    chalk4.cyan(`\u{1F4DA} CopilotKit documentation configured for ${config.displayName}!`),
     "",
-    chalk3.bold("What this does:"),
+    chalk4.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))}`,
+    chalk4.bold("Location:"),
+    `  \u2022 Rule file: ${chalk4.gray(path2.join(config.rulesDir, config.ruleFileName))}`,
     "",
-    chalk3.bold("Usage:"),
+    chalk4.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"
@@ -605,7 +1002,7 @@ function getIDEInstructions(ide) {
   if (ide === "cursor") {
     instructions.push(
       "",
-      chalk3.bold("Next steps for Cursor:"),
+      chalk4.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"
@@ -613,7 +1010,7 @@ function getIDEInstructions(ide) {
   } else if (ide === "windsurf") {
     instructions.push(
       "",
-      chalk3.bold("Next steps for Windsurf:"),
+      chalk4.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"
@@ -623,14 +1020,14 @@ function getIDEInstructions(ide) {
 }
 async function handleIDEDocsSetup(selectedIDE, projectDir, spinner) {
   try {
-    spinner.text = chalk3.cyan(`Setting up CopilotKit documentation for ${IDE_DOCS_CONFIGS[selectedIDE].displayName}...`);
+    spinner.text = chalk4.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}`));
+    spinner.succeed(chalk4.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"}`)
+      chalk4.red(`Failed to setup IDE documentation: ${error instanceof Error ? error.message : "Unknown error"}`)
     );
     throw error;
   }
@@ -914,8 +1311,8 @@ async function scaffoldShadCN(flags, userAnswers) {
 }
 
 // src/lib/init/scaffold/env.ts
-import path2 from "path";
-import fs2 from "fs";
+import path3 from "path";
+import fs3 from "fs";
 
 // src/lib/init/scaffold/langgraph-assistants.ts
 async function getLangGraphAgents(url, langSmithApiKey) {
@@ -938,7 +1335,7 @@ async function getLangGraphAgents(url, langSmithApiKey) {
 }
 
 // src/lib/init/scaffold/env.ts
-import inquirer2 from "inquirer";
+import inquirer3 from "inquirer";
 function needsCloudDeployment(userAnswers) {
   return userAnswers.deploymentChoice === "Copilot Cloud" || // Branch B choice
   userAnswers.useCopilotCloud === "Yes" || // Branch C choice
@@ -947,9 +1344,9 @@ function needsCloudDeployment(userAnswers) {
 }
 async function scaffoldEnv(flags, userAnswers) {
   try {
-    const envFile = path2.join(process.cwd(), ".env");
-    if (!fs2.existsSync(envFile)) {
-      fs2.writeFileSync(envFile, "", "utf8");
+    const envFile = path3.join(process.cwd(), ".env");
+    if (!fs3.existsSync(envFile)) {
+      fs3.writeFileSync(envFile, "", "utf8");
     } else {
     }
     let newEnvValues = "";
@@ -996,7 +1393,7 @@ async function scaffoldEnv(flags, userAnswers) {
       );
       let langGraphAgent = "";
       if (langGraphAgents.length > 1) {
-        const { langGraphAgentChoice } = await inquirer2.prompt([
+        const { langGraphAgentChoice } = await inquirer3.prompt([
           {
             type: "list",
             name: "langGraphAgentChoice",
@@ -1017,7 +1414,7 @@ async function scaffoldEnv(flags, userAnswers) {
 `;
     }
     if (newEnvValues) {
-      fs2.appendFileSync(envFile, newEnvValues);
+      fs3.appendFileSync(envFile, newEnvValues);
     }
   } catch (error) {
     throw error;
@@ -1026,59 +1423,59 @@ async function scaffoldEnv(flags, userAnswers) {
 
 // src/lib/init/scaffold/github.ts
 import { execSync } from "child_process";
-import * as fs3 from "fs";
-import * as path3 from "path";
+import * as fs4 from "fs";
+import * as path4 from "path";
 import * as os from "os";
-import chalk4 from "chalk";
+import chalk5 from "chalk";
 async function cloneGitHubSubdirectory(githubUrl, destinationPath, spinner) {
   try {
     const { owner, repo, branch, subdirectoryPath } = parseGitHubUrl(githubUrl);
-    spinner.text = chalk4.cyan(`Cloning from ${owner}/${repo}...`);
+    spinner.text = chalk5.cyan(`Cloning from ${owner}/${repo}...`);
     return await sparseCheckout(owner, repo, branch, subdirectoryPath, destinationPath, spinner);
   } catch (error) {
-    spinner.text = chalk4.red(`Failed to clone from GitHub: ${error}`);
+    spinner.text = chalk5.red(`Failed to clone from GitHub: ${error}`);
     return false;
   }
 }
 async function sparseCheckout(owner, repo, branch, subdirectoryPath, destinationPath, spinner) {
-  const tempDir = fs3.mkdtempSync(path3.join(os.tmpdir(), "copilotkit-sparse-"));
+  const tempDir = fs4.mkdtempSync(path4.join(os.tmpdir(), "copilotkit-sparse-"));
   try {
-    spinner.text = chalk4.cyan("Creating temporary workspace...");
+    spinner.text = chalk5.cyan("Creating temporary workspace...");
     execSync("git init", { cwd: tempDir, stdio: "pipe" });
-    spinner.text = chalk4.cyan("Connecting to repository...");
+    spinner.text = chalk5.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" });
-    fs3.writeFileSync(path3.join(tempDir, ".git/info/sparse-checkout"), subdirectoryPath);
-    spinner.text = chalk4.cyan("Downloading agent files...");
+    fs4.writeFileSync(path4.join(tempDir, ".git/info/sparse-checkout"), subdirectoryPath);
+    spinner.text = chalk5.cyan("Downloading agent files...");
     execSync(`git pull origin ${branch} --depth=1`, { cwd: tempDir, stdio: "pipe" });
-    const sourcePath = path3.join(tempDir, subdirectoryPath);
-    if (!fs3.existsSync(sourcePath)) {
+    const sourcePath = path4.join(tempDir, subdirectoryPath);
+    if (!fs4.existsSync(sourcePath)) {
       throw new Error(`Subdirectory '${subdirectoryPath}' not found in the repository.`);
     }
-    fs3.mkdirSync(destinationPath, { recursive: true });
-    spinner.text = chalk4.cyan("Installing agent files...");
+    fs4.mkdirSync(destinationPath, { recursive: true });
+    spinner.text = chalk5.cyan("Installing agent files...");
     await copyDirectoryAsync(sourcePath, destinationPath);
     return true;
   } finally {
     try {
-      fs3.rmSync(tempDir, { recursive: true, force: true });
+      fs4.rmSync(tempDir, { recursive: true, force: true });
     } catch (error) {
       console.warn(`Failed to clean up temporary directory: ${error}`);
     }
   }
 }
 async function copyDirectoryAsync(source, destination) {
-  if (!fs3.existsSync(destination)) {
-    fs3.mkdirSync(destination, { recursive: true });
+  if (!fs4.existsSync(destination)) {
+    fs4.mkdirSync(destination, { recursive: true });
   }
-  const entries = fs3.readdirSync(source, { withFileTypes: true });
+  const entries = fs4.readdirSync(source, { withFileTypes: true });
   for (const entry of entries) {
-    const srcPath = path3.join(source, entry.name);
-    const destPath = path3.join(destination, entry.name);
+    const srcPath = path4.join(source, entry.name);
+    const destPath = path4.join(destination, entry.name);
     if (entry.isDirectory()) {
       await copyDirectoryAsync(srcPath, destPath);
     } else {
-      fs3.copyFileSync(srcPath, destPath);
+      fs4.copyFileSync(srcPath, destPath);
     }
     if (entries.length > 10) {
       await new Promise((resolve) => setTimeout(resolve, 1));
@@ -1107,20 +1504,20 @@ function parseGitHubUrl(githubUrl) {
 
 // src/lib/init/scaffold/packages.ts
 import spawn2 from "cross-spawn";
-import chalk5 from "chalk";
-import ora2 from "ora";
+import chalk6 from "chalk";
+import ora3 from "ora";
 
 // src/lib/init/scaffold/agent.ts
-import ora3 from "ora";
-import chalk6 from "chalk";
-import path4 from "path";
-import fs4 from "fs";
+import ora4 from "ora";
+import chalk7 from "chalk";
+import path5 from "path";
+import fs5 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: chalk6.cyan("Setting up AI agent..."),
+  const spinner = ora4({
+    text: chalk7.cyan("Setting up AI agent..."),
     color: "cyan"
   }).start();
   let template = "";
@@ -1134,13 +1531,13 @@ async function scaffoldAgent(userAnswers) {
       break;
   }
   if (!template) {
-    spinner.fail(chalk6.red("Failed to determine agent template"));
+    spinner.fail(chalk7.red("Failed to determine agent template"));
     throw new Error("Failed to determine agent template");
   }
-  const agentDir = path4.join(process.cwd(), "agent");
+  const agentDir = path5.join(process.cwd(), "agent");
   try {
     await cloneGitHubSubdirectory(template, agentDir, spinner);
-    spinner.text = chalk6.cyan("Creating agent environment variables...");
+    spinner.text = chalk7.cyan("Creating agent environment variables...");
     let envContent = "";
     if (userAnswers.llmToken) {
       envContent += `OPENAI_API_KEY=${userAnswers.llmToken}
@@ -1151,26 +1548,26 @@ async function scaffoldAgent(userAnswers) {
 `;
     }
     if (envContent) {
-      const agentEnvFile = path4.join(agentDir, ".env");
-      fs4.writeFileSync(agentEnvFile, envContent, "utf8");
-      spinner.text = chalk6.cyan("Added API keys to agent .env file");
+      const agentEnvFile = path5.join(agentDir, ".env");
+      fs5.writeFileSync(agentEnvFile, envContent, "utf8");
+      spinner.text = chalk7.cyan("Added API keys to agent .env file");
     }
     if (userAnswers.mode === "LangGraph" && userAnswers.langSmithApiKey) {
       envContent += `LANGSMITH_API_KEY=${userAnswers.langSmithApiKey}
 `;
     }
     if (envContent) {
-      const agentEnvFile = path4.join(agentDir, ".env");
-      fs4.writeFileSync(agentEnvFile, envContent, "utf8");
-      spinner.text = chalk6.cyan("Added API keys to agent .env file");
+      const agentEnvFile = path5.join(agentDir, ".env");
+      fs5.writeFileSync(agentEnvFile, envContent, "utf8");
+      spinner.text = chalk7.cyan("Added API keys to agent .env file");
     }
     if (envContent) {
-      const agentEnvFile = path4.join(agentDir, ".env");
-      fs4.writeFileSync(agentEnvFile, envContent, "utf8");
-      spinner.text = chalk6.cyan("Added API keys to agent .env file");
+      const agentEnvFile = path5.join(agentDir, ".env");
+      fs5.writeFileSync(agentEnvFile, envContent, "utf8");
+      spinner.text = chalk7.cyan("Added API keys to agent .env file");
     }
   } catch (error) {
-    spinner.fail(chalk6.red("Failed to clone agent template"));
+    spinner.fail(chalk7.red("Failed to clone agent template"));
     throw error;
   }
   spinner.succeed(`${userAnswers.mode} agent cloned successfully`);
@@ -1190,29 +1587,29 @@ var AgentTemplates = {
 };
 
 // src/lib/init/scaffold/crew-inputs.ts
-import * as fs5 from "fs/promises";
-import ora4 from "ora";
-import * as path5 from "path";
+import * as fs6 from "fs/promises";
+import ora5 from "ora";
+import * as path6 from "path";
 async function addCrewInputs(url, token) {
   try {
-    const spinner = ora4("Analyzing crew inputs...").start();
+    const spinner = ora5("Analyzing crew inputs...").start();
     const inputs = await getCrewInputs(url, token);
     spinner.text = "Adding inputs to app/copilotkit/page.tsx...";
-    let filePath = path5.join(process.cwd(), "app", "copilotkit", "page.tsx");
+    let filePath = path6.join(process.cwd(), "app", "copilotkit", "page.tsx");
     try {
-      await fs5.access(filePath);
+      await fs6.access(filePath);
     } catch {
-      filePath = path5.join(process.cwd(), "src", "app", "copilotkit", "page.tsx");
+      filePath = path6.join(process.cwd(), "src", "app", "copilotkit", "page.tsx");
     }
     try {
-      await fs5.access(filePath);
+      await fs6.access(filePath);
     } catch {
       throw new Error("app/copilotkit/page.tsx and src/app/copilotkit/page.tsx not found");
     }
-    let fileContent = await fs5.readFile(filePath, "utf8");
+    let fileContent = await fs6.readFile(filePath, "utf8");
     const inputsString = JSON.stringify(inputs);
     fileContent = fileContent.replace(/\[["']YOUR_INPUTS_HERE["']\]/g, inputsString);
-    await fs5.writeFile(filePath, fileContent, "utf8");
+    await fs6.writeFile(filePath, fileContent, "utf8");
     spinner.succeed("Successfully added crew inputs to app/copilotkit/page.tsx");
   } catch (error) {
     console.error("Error updating crew inputs:", error);
@@ -1233,8 +1630,8 @@ async function getCrewInputs(url, token) {
 }
 
 // src/commands/init.ts
-import chalk7 from "chalk";
-import ora5 from "ora";
+import chalk8 from "chalk";
+import ora6 from "ora";
 var CloudInit = class _CloudInit extends BaseCommand {
   constructor(argv, config, authService = new AuthService()) {
     super(argv, config);
@@ -1244,24 +1641,31 @@ var CloudInit = class _CloudInit extends BaseCommand {
   analytics = null;
   startTime = Date.now();
   analyticsQueue = [];
-  static description = "Set up CopilotKit in your Next.js project";
-  static examples = ["<%= config.bin %> init"];
+  static description = "Set up CopilotKit in your Next.js project, or create a new project if none exists";
+  static examples = ["<%= config.bin %> init", "<%= config.bin %> init --dir ./my-app"];
   static flags = {
     ...BaseCommand.flags,
     ...ConfigFlags,
-    runtimeUrl: Flags2.string({ description: "runtime URL" }),
-    project: Flags2.string({ description: "project ID (can be found in the Copilot Cloud dashboard)" }),
-    dir: Flags2.string({ description: "directory of the Next.js project", default: "." })
+    runtimeUrl: Flags3.string({ description: "runtime URL" }),
+    project: Flags3.string({ description: "project ID (can be found in the Copilot Cloud dashboard)" }),
+    dir: Flags3.string({ description: "directory of the Next.js project", default: "." })
   };
   async run() {
     const { flags } = await this.parse(_CloudInit);
     try {
       this.analytics = new AnalyticsService();
-      this.log(chalk7.magenta("\n\u{1FA81} Welcome to CopilotKit"));
+      const nextJsAppExists = this.isNextJsProject(flags);
+      if (!nextJsAppExists) {
+        this.log(chalk8.gray("Running copilotkit create to set up a new project...\n"));
+        const createCommand = new Create(this.argv, this.config, this.authService);
+        await createCommand.run();
+        return;
+      }
+      this.log(chalk8.magenta("\n\u{1FA81} Welcome to CopilotKit"));
       if (flags.booth) {
-        this.log(chalk7.gray("Thanks for giving CopilotKit a try! Now, let's try to impress you \u{1F4AA}\n"));
+        this.log(chalk8.gray("Thanks for giving CopilotKit a try! Now, let's try to impress you \u{1F4AA}\n"));
       } else {
-        this.log(chalk7.gray("Let's power up your Next.js project with AI capabilities\n"));
+        this.log(chalk8.gray("Let's power up your Next.js project with AI capabilities\n"));
       }
       const projectValidated = this.validateProjectCompatibility(flags);
       this.queueAnalytics("cli.init.started", {
@@ -1283,19 +1687,19 @@ var CloudInit = class _CloudInit extends BaseCommand {
         deployment_choice: userAnswers.deploymentChoice
       });
       if (userAnswers.mode === "Mastra") {
-        this.log(chalk7.magenta(`
+        this.log(chalk8.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(chalk7.magenta(`
+        this.log(chalk8.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(`
+        this.log(chalk8.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(`
+        this.log(chalk8.magenta(`
 \u{1F517} Please go to https://docs.copilotkit.ai/llamaindex/quickstart to get started.`));
         process.exit(0);
       }
@@ -1326,7 +1730,7 @@ var CloudInit = class _CloudInit extends BaseCommand {
       if (userAnswers.crewUrl && userAnswers.crewBearerToken)
         await addCrewInputs(userAnswers.crewUrl, userAnswers.crewBearerToken);
       if (userAnswers.setupIDEDocs === "Yes" && userAnswers.selectedIDE !== "skip") {
-        const ideDocsSpinner = ora5({
+        const ideDocsSpinner = ora6({
           text: "Setting up CopilotKit IDE documentation...",
           color: "cyan"
         }).start();
@@ -1348,12 +1752,12 @@ var CloudInit = class _CloudInit extends BaseCommand {
       await this.flushAnalytics();
       if (flags.booth) {
         this.log("\n-----\n");
-        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(chalk8.magenta("\u{1F389} Your CopilotKit setup is complete! \u{1F389}\n"));
+        this.log(chalk8.bold("\n\u{1F680} Next steps:"));
+        this.log(`  - Start the Next.js app: ${chalk8.gray("$")} ${chalk8.cyan("npm run dev")}`);
+        this.log(`  - Navigate to ${chalk8.blue("http://localhost:3000/copilotkit")}`);
         this.log(`  - Talk to your agent.`);
-        this.log(chalk7.magenta("\nThanks for giving CopilotKit a try! \u{1FA81}\n"));
+        this.log(chalk8.magenta("\nThanks for giving CopilotKit a try! \u{1FA81}\n"));
       } else {
         this.finalSummary(userAnswers, cloudSetupInfo?.selectedProjectId);
       }
@@ -1410,7 +1814,7 @@ var CloudInit = class _CloudInit extends BaseCommand {
     }
   }
   async getBoothAnswers() {
-    const url = await inquirer3.prompt({
+    const url = await inquirer4.prompt({
       type: "input",
       message: "\u{1F99C}\u{1F517} What is the LangGraph's agent URL?",
       name: "agentURL",
@@ -1485,15 +1889,15 @@ var CloudInit = class _CloudInit extends BaseCommand {
           };
       }
     }).filter((q) => q !== null);
-    const promptAnswers = await inquirer3.prompt(inquirerQuestions);
+    const promptAnswers = await inquirer4.prompt(inquirerQuestions);
     const answers = {
       ...initialAnswers,
       ...promptAnswers,
       ...earlyApiKey && { copilotCloudPublicApiKey: earlyApiKey }
     };
     if (abcBranch === "B" && !cloudSetupInfo) {
-      this.log(chalk7.cyan("\n\u{1F511} Now you will get an API key"));
-      this.log(chalk7.gray("Setting up your cloud account and retrieving your API key...\n"));
+      this.log(chalk8.cyan("\n\u{1F511} Now you will get an API key"));
+      this.log(chalk8.gray("Setting up your cloud account and retrieving your API key...\n"));
       try {
         const tempConfig = { ...answers, signupForCopilotCloud: "Yes" };
         const cloudSignupResult = await this.setupApiKey(flags, tempConfig);
@@ -1524,8 +1928,8 @@ var CloudInit = class _CloudInit extends BaseCommand {
       }
     }
     if (abcBranch === "A" && !cloudSetupInfo) {
-      this.log(chalk7.cyan("\n\u{1F511} Now get your API key"));
-      this.log(chalk7.gray("Setting up your cloud account and retrieving your API key...\n"));
+      this.log(chalk8.cyan("\n\u{1F511} Now get your API key"));
+      this.log(chalk8.gray("Setting up your cloud account and retrieving your API key...\n"));
       try {
         const tempConfig = { ...answers, signupForCopilotCloud: "Yes" };
         const cloudSignupResult = await this.setupApiKey(flags, tempConfig);
@@ -1559,24 +1963,24 @@ 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(chalk7.blue("https://docs.copilotkit.ai/coagents/quickstart/langgraph"));
+      this.log(chalk8.blue("https://docs.copilotkit.ai/coagents/quickstart/langgraph"));
       process.exit(0);
     }
     try {
-      const spinner = ora5({ text: "Validating configuration...", color: "green" }).start();
+      const spinner = ora6({ text: "Validating configuration...", color: "green" }).start();
       const validatedConfig = ConfigSchema.parse(answers);
       spinner.succeed(`\u{1F50D} Configuration validated successfully`);
       return { config: validatedConfig, cloudSetupInfo };
     } catch (error) {
-      const spinner = ora5({ text: "Validation failed...", color: "red" }).start();
+      const spinner = ora6({ text: "Validation failed...", color: "red" }).start();
       if (error.errors) {
         const formattedErrors = error.errors.map((err) => `- ${err.path.join(".")}: ${err.message}`).join("\n");
-        spinner.fail(chalk7.red("Configuration validation failed:"));
-        console.error(chalk7.red(formattedErrors));
+        spinner.fail(chalk8.red("Configuration validation failed:"));
+        console.error(chalk8.red(formattedErrors));
         process.exit(1);
       }
-      spinner.fail(chalk7.red("Unexpected validation error:"));
-      console.error(chalk7.red(error.message || "Unknown error"));
+      spinner.fail(chalk8.red("Unexpected validation error:"));
+      console.error(chalk8.red(error.message || "Unknown error"));
       process.exit(1);
     }
   }
@@ -1587,13 +1991,13 @@ var CloudInit = class _CloudInit extends BaseCommand {
     let selectedProjectId;
     if (flags.project) {
       if (!availableProjects.some((project) => project.id === flags.project)) {
-        this.log(chalk7.red(`\u{1F4C1} Project with ID ${flags.project} not found`));
+        this.log(chalk8.red(`\u{1F4C1} Project with ID ${flags.project} not found`));
         process.exit(1);
       }
       selectedProjectId = flags.project;
-      this.log(chalk7.green(`\u{1F4C1} Selected project ${selectedProjectId}`));
+      this.log(chalk8.green(`\u{1F4C1} Selected project ${selectedProjectId}`));
     } else {
-      const { projectId } = await inquirer3.prompt([
+      const { projectId } = await inquirer4.prompt([
         {
           name: "projectId",
           type: "list",
@@ -1623,12 +2027,12 @@ var CloudInit = class _CloudInit extends BaseCommand {
       const updatedConfig = ConfigSchema.parse(sanitizedConfig);
       Object.assign(userAnswers, updatedConfig);
     } catch (error) {
-      this.log(chalk7.red(`Failed to update configuration with Copilot Cloud API key: ${error.message}`));
+      this.log(chalk8.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: chalk7(`\u{1F465} Adding CrewAI ${isFlow ? "Flow" : "Crew"} to Copilot Cloud...`),
+      const crewSpinner = ora6({
+        text: chalk8(`\u{1F465} Adding CrewAI ${isFlow ? "Flow" : "Crew"} to Copilot Cloud...`),
         color: "cyan"
       }).start();
       try {
@@ -1644,22 +2048,22 @@ var CloudInit = class _CloudInit extends BaseCommand {
             crewApiBearerToken: userAnswers.crewBearerToken
           }
         });
-        crewSpinner.succeed(chalk7(`\u{1F465} CrewAI ${isFlow ? "Flow" : "Crew"} added to Copilot Cloud`));
+        crewSpinner.succeed(chalk8(`\u{1F465} CrewAI ${isFlow ? "Flow" : "Crew"} added to Copilot Cloud`));
       } catch (error) {
-        crewSpinner.fail(chalk7(`\u{1F465} Failed to add CrewAI ${isFlow ? "Flow" : "Crew"} to Copilot Cloud`));
+        crewSpinner.fail(chalk8(`\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: chalk7("\u{1F99C}\u{1F517} Adding LangGraph to Copilot Cloud..."),
+      const langGraphSpinner = ora6({
+        text: chalk8("\u{1F99C}\u{1F517} Adding LangGraph to Copilot Cloud..."),
         color: "cyan"
       }).start();
       if (userAnswers.langGraphPlatform === "Yes" && userAnswers.langGraphPlatformUrl) {
         try {
           if (!userAnswers.langSmithApiKey) {
-            langGraphSpinner.fail(chalk7("\u{1F99C}\u{1F517} LangSmith API key not found. Please provide a valid LangSmith API key."));
+            langGraphSpinner.fail(chalk8("\u{1F99C}\u{1F517} LangSmith API key not found. Please provide a valid LangSmith API key."));
             process.exit(1);
           }
           await this.trpcClient.createLGCRemoteEndpoint.mutate({
@@ -1672,9 +2076,9 @@ var CloudInit = class _CloudInit extends BaseCommand {
               agents: []
             }
           });
-          langGraphSpinner.succeed(chalk7("\u{1F99C}\u{1F517} LangGraph Cloud remote endpoint created"));
+          langGraphSpinner.succeed(chalk8("\u{1F99C}\u{1F517} LangGraph Cloud remote endpoint created"));
         } catch (error) {
-          langGraphSpinner.fail(chalk7("\u{1F99C}\u{1F517} Failed to create LangGraph Cloud remote endpoint. Please try again."));
+          langGraphSpinner.fail(chalk8("\u{1F99C}\u{1F517} Failed to create LangGraph Cloud remote endpoint. Please try again."));
           process.exit(1);
         }
       } else if (userAnswers.langGraphRemoteEndpointURL) {
@@ -1688,32 +2092,32 @@ var CloudInit = class _CloudInit extends BaseCommand {
               // Already sanitized
             }
           });
-          langGraphSpinner.succeed(chalk7("\u{1F99C}\u{1F517} LangGraph remote endpoint created"));
+          langGraphSpinner.succeed(chalk8("\u{1F99C}\u{1F517} LangGraph remote endpoint created"));
         } catch (error) {
-          langGraphSpinner.fail(chalk7("\u{1F99C}\u{1F517} Failed to create LangGraph remote endpoint. Please try again."));
+          langGraphSpinner.fail(chalk8("\u{1F99C}\u{1F517} Failed to create LangGraph remote endpoint. Please try again."));
           process.exit(1);
         }
       }
     }
   }
   async setupApiKey(flags, userAnswers) {
-    this.log(chalk7.cyan("\n\u{1F511} Setting up your API key...\n"));
+    this.log(chalk8.cyan("\n\u{1F511} Setting up your API key...\n"));
     const { cliToken, organization } = await this.authService.requireLogin(this, "cloud-features");
     this.trpcClient = createTRPCClient(cliToken);
     const availableProjects = await this.trpcClient.listOrgProjects.query({ orgId: organization.id });
     let selectedProjectId;
     if (flags.project) {
       if (!availableProjects.some((project) => project.id === flags.project)) {
-        this.log(chalk7.red(`\u{1F4C1} Project with ID ${flags.project} not found`));
+        this.log(chalk8.red(`\u{1F4C1} Project with ID ${flags.project} not found`));
         process.exit(1);
       }
       selectedProjectId = flags.project;
-      this.log(chalk7.green(`\u{1F4C1} Selected project ${selectedProjectId}`));
+      this.log(chalk8.green(`\u{1F4C1} Selected project ${selectedProjectId}`));
     } else if (availableProjects.length === 1) {
       selectedProjectId = availableProjects[0].id;
-      this.log(chalk7.green(`\u{1F4C1} Auto-selected project ${selectedProjectId}`));
+      this.log(chalk8.green(`\u{1F4C1} Auto-selected project ${selectedProjectId}`));
     } else {
-      const { projectId } = await inquirer3.prompt([
+      const { projectId } = await inquirer4.prompt([
         {
           name: "projectId",
           type: "list",
@@ -1728,7 +2132,7 @@ var CloudInit = class _CloudInit extends BaseCommand {
     }
     let apiKey;
     if (selectedProjectId) {
-      const spinner = ora5({
+      const spinner = ora6({
         text: "Retrieving your API key...",
         color: "cyan"
       }).start();
@@ -1743,7 +2147,7 @@ var CloudInit = class _CloudInit extends BaseCommand {
         console.error(error);
       }
     }
-    this.log(chalk7.green("\u2705 API key setup complete!\n"));
+    this.log(chalk8.green("\u2705 API key setup complete!\n"));
     return { cliToken, organization, selectedProjectId, apiKey };
   }
   async completeCloudDeploymentSetup(flags, userAnswers, cloudSetupInfo) {
@@ -1753,8 +2157,8 @@ var CloudInit = class _CloudInit extends BaseCommand {
     const selectedProjectId = cloudSetupInfo.selectedProjectId;
     if (userAnswers.crewUrl && userAnswers.crewName && userAnswers.crewBearerToken) {
       const isFlow = userAnswers.crewType === "Flows";
-      const crewSpinner = ora5({
-        text: chalk7(`\u{1F465} Adding CrewAI ${isFlow ? "Flow" : "Crew"} to Copilot Cloud...`),
+      const crewSpinner = ora6({
+        text: chalk8(`\u{1F465} Adding CrewAI ${isFlow ? "Flow" : "Crew"} to Copilot Cloud...`),
         color: "cyan"
       }).start();
       try {
@@ -1769,22 +2173,22 @@ var CloudInit = class _CloudInit extends BaseCommand {
             crewApiBearerToken: userAnswers.crewBearerToken
           }
         });
-        crewSpinner.succeed(chalk7(`\u{1F465} CrewAI ${isFlow ? "Flow" : "Crew"} added to Copilot Cloud`));
+        crewSpinner.succeed(chalk8(`\u{1F465} CrewAI ${isFlow ? "Flow" : "Crew"} added to Copilot Cloud`));
       } catch (error) {
-        crewSpinner.fail(chalk7(`\u{1F465} Failed to add CrewAI ${isFlow ? "Flow" : "Crew"} to Copilot Cloud`));
+        crewSpinner.fail(chalk8(`\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: chalk7("\u{1F99C}\u{1F517} Adding LangGraph to Copilot Cloud..."),
+      const langGraphSpinner = ora6({
+        text: chalk8("\u{1F99C}\u{1F517} Adding LangGraph to Copilot Cloud..."),
         color: "cyan"
       }).start();
       if (userAnswers.langGraphPlatform === "Yes" && userAnswers.langGraphPlatformUrl) {
         try {
           if (!userAnswers.langSmithApiKey) {
-            langGraphSpinner.fail(chalk7("\u{1F99C}\u{1F517} LangSmith API key not found. Please provide a valid LangSmith API key."));
+            langGraphSpinner.fail(chalk8("\u{1F99C}\u{1F517} LangSmith API key not found. Please provide a valid LangSmith API key."));
             process.exit(1);
           }
           await this.trpcClient.createLGCRemoteEndpoint.mutate({
@@ -1796,9 +2200,9 @@ var CloudInit = class _CloudInit extends BaseCommand {
               agents: []
             }
           });
-          langGraphSpinner.succeed(chalk7("\u{1F99C}\u{1F517} LangGraph Cloud remote endpoint created"));
+          langGraphSpinner.succeed(chalk8("\u{1F99C}\u{1F517} LangGraph Cloud remote endpoint created"));
         } catch (error) {
-          langGraphSpinner.fail(chalk7("\u{1F99C}\u{1F517} Failed to create LangGraph Cloud remote endpoint. Please try again."));
+          langGraphSpinner.fail(chalk8("\u{1F99C}\u{1F517} Failed to create LangGraph Cloud remote endpoint. Please try again."));
           process.exit(1);
         }
       } else if (userAnswers.langGraphRemoteEndpointURL) {
@@ -1811,41 +2215,57 @@ var CloudInit = class _CloudInit extends BaseCommand {
               url: userAnswers.langGraphRemoteEndpointURL
             }
           });
-          langGraphSpinner.succeed(chalk7("\u{1F99C}\u{1F517} LangGraph remote endpoint created"));
+          langGraphSpinner.succeed(chalk8("\u{1F99C}\u{1F517} LangGraph remote endpoint created"));
         } catch (error) {
-          langGraphSpinner.fail(chalk7("\u{1F99C}\u{1F517} Failed to create LangGraph remote endpoint. Please try again."));
+          langGraphSpinner.fail(chalk8("\u{1F99C}\u{1F517} Failed to create LangGraph remote endpoint. Please try again."));
           process.exit(1);
         }
       }
     }
   }
-  validateProjectCompatibility(flags) {
-    const spinner = ora5("Checking Next.js project compatibility...").start();
+  isNextJsProject(flags) {
     try {
-      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 projectPath = path7.resolve(process.cwd(), flags.dir);
+      if (!fs7.existsSync(projectPath)) {
+        return false;
       }
-      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 packageJsonPath = path7.join(projectPath, "package.json");
+      if (!fs7.existsSync(packageJsonPath)) {
+        return false;
       }
-      const packageJson = JSON.parse(fs6.readFileSync(packageJsonPath, "utf8"));
-      if (!packageJson.dependencies?.next && !packageJson.devDependencies?.next) {
+      const packageJson = JSON.parse(fs7.readFileSync(packageJsonPath, "utf8"));
+      return !!(packageJson.dependencies?.next || packageJson.devDependencies?.next);
+    } catch {
+      return false;
+    }
+  }
+  validateProjectCompatibility(flags) {
+    const spinner = ora6("Checking Next.js project compatibility...").start();
+    try {
+      if (!this.isNextJsProject(flags)) {
+        const projectPath2 = path7.resolve(process.cwd(), flags.dir);
+        if (!fs7.existsSync(projectPath2)) {
+          spinner.fail(`Directory ${flags.dir} does not exist`);
+          throw new Error(`Please provide a valid Next.js project directory.`);
+        }
+        const packageJsonPath = path7.join(projectPath2, "package.json");
+        if (!fs7.existsSync(packageJsonPath)) {
+          spinner.fail(`No package.json found in ${projectPath2}`);
+          throw new Error(`Please provide a valid Next.js project with a package.json file.`);
+        }
         spinner.fail(`Not a Next.js project`);
         throw new Error(
-          `Directory ${projectPath} does not appear to be a Next.js project. Make sure it has next in dependencies.`
+          `Directory ${projectPath2} does not appear to be a Next.js project. Make sure it has next in dependencies.`
         );
       }
+      const projectPath = path7.resolve(process.cwd(), flags.dir);
       spinner.succeed(`\u{1F53C} Valid Next.js project detected at ${projectPath}`);
       return true;
     } catch (error) {
       if (!spinner.isSpinning) {
-        this.log(chalk7.red(error.message));
+        this.log(chalk8.red(error.message));
       } else {
-        spinner.fail(chalk7.red(error.message));
+        spinner.fail(chalk8.red(error.message));
       }
       process.exit(1);
     }
@@ -1855,9 +2275,9 @@ var CloudInit = class _CloudInit extends BaseCommand {
     let agentSetupMessage = "";
     if (userAnswers.mode === "CrewAI") {
       if (userAnswers.crewType === "Crews") {
-        agentSetupMessage = `Using your Crew from ${chalk7.cyan(userAnswers.crewUrl || "the provided URL")}.`;
+        agentSetupMessage = `Using your Crew from ${chalk8.cyan(userAnswers.crewUrl || "the provided URL")}.`;
       } else if (userAnswers.crewType === "Flows") {
-        agentSetupMessage = `We've scaffolded a ${chalk7.cyan("CrewAI Flow")} agent in the ${chalk7.cyan("./agent")} directory.`;
+        agentSetupMessage = `We've scaffolded a ${chalk8.cyan("CrewAI Flow")} agent in the ${chalk8.cyan("./agent")} directory.`;
         agentDevInstructions = "poetry lock && poetry install && poetry run demo";
       }
     }
@@ -1865,11 +2285,11 @@ var CloudInit = class _CloudInit extends BaseCommand {
       case "LangGraph":
         switch (userAnswers.langGraphAgent) {
           case "Python Starter":
-            agentSetupMessage = `We've scaffolded a ${chalk7.cyan(userAnswers.langGraphAgent || "LangGraph")} agent in the ${chalk7.cyan("./agent")} directory.`;
+            agentSetupMessage = `We've scaffolded a ${chalk8.cyan(userAnswers.langGraphAgent || "LangGraph")} agent in the ${chalk8.cyan("./agent")} directory.`;
             agentDevInstructions = "poetry lock && poetry install && poetry run demo";
             break;
           case "TypeScript Starter":
-            agentSetupMessage = `We've scaffolded a ${chalk7.cyan(userAnswers.langGraphAgent || "LangGraph")} agent in the ${chalk7.cyan("./agent")} directory.`;
+            agentSetupMessage = `We've scaffolded a ${chalk8.cyan(userAnswers.langGraphAgent || "LangGraph")} agent in the ${chalk8.cyan("./agent")} directory.`;
             agentDevInstructions = "npm install && npm run dev";
             break;
           default:
@@ -1879,18 +2299,18 @@ var CloudInit = class _CloudInit extends BaseCommand {
       case "CrewAI":
         switch (userAnswers.crewType) {
           case "Crews":
-            agentSetupMessage = `Using your Crew from ${chalk7.cyan(userAnswers.crewUrl || "the provided URL")}.`;
+            agentSetupMessage = `Using your Crew from ${chalk8.cyan(userAnswers.crewUrl || "the provided URL")}.`;
             break;
           case "Flows":
-            agentSetupMessage = `We've scaffolded a ${chalk7.cyan("CrewAI Flow")} agent in the ${chalk7.cyan("./agent")} directory.`;
+            agentSetupMessage = `We've scaffolded a ${chalk8.cyan("CrewAI Flow")} agent in the ${chalk8.cyan("./agent")} directory.`;
             break;
         }
         break;
       default:
     }
     this.log("\n-----\n");
-    this.log(chalk7.magenta("\u{1F389} Your CopilotKit setup is complete! \u{1F389}\n"));
-    this.log(chalk7.bold(`\u{1F4CB} Recap`));
+    this.log(chalk8.magenta("\u{1F389} Your CopilotKit setup is complete! \u{1F389}\n"));
+    this.log(chalk8.bold(`\u{1F4CB} Recap`));
     this.log(`  - CopilotKit has been added to your Next.js app.`);
     if (agentSetupMessage) this.log(`  - ${agentSetupMessage}`);
     const isCloudDeployment = userAnswers.deploymentChoice === "Copilot Cloud" || // Branch B choice
@@ -1903,23 +2323,23 @@ var CloudInit = class _CloudInit extends BaseCommand {
     } else if (isSelfHosted) {
       this.log(`  - \u{1F3E0} Configured for self-hosted deployment.`);
     }
-    this.log(chalk7.bold("\n\u{1F680} Next steps:"));
-    this.log(`  - Start your Next.js app: ${chalk7.gray("$")} ${chalk7.cyan("npm run dev")}`);
+    this.log(chalk8.bold("\n\u{1F680} Next steps:"));
+    this.log(`  - Start your Next.js app: ${chalk8.gray("$")} ${chalk8.cyan("npm run dev")}`);
     if (agentDevInstructions) {
-      this.log(`  - Start your agent: ${chalk7.gray("$")} ${chalk7.cyan(`cd agent && ${agentDevInstructions}`)}`);
+      this.log(`  - Start your agent: ${chalk8.gray("$")} ${chalk8.cyan(`cd agent && ${agentDevInstructions}`)}`);
       if (isCloudDeployment) {
         this.log(
-          `  - Create local tunnel for your agent: ${chalk7.gray("$")} ${chalk7.cyan(`npx copilotkit@latest dev --port <value>${projectId ? ` --project ${projectId}` : " [--project <value>]"}`)}`
+          `  - Create local tunnel for your agent: ${chalk8.gray("$")} ${chalk8.cyan(`npx copilotkit@latest dev --port <value>${projectId ? ` --project ${projectId}` : " [--project <value>]"}`)}`
         );
       }
     }
-    this.log(`  - Navigate to ${chalk7.blue("http://localhost:3000/copilotkit")}`);
+    this.log(`  - Navigate to ${chalk8.blue("http://localhost:3000/copilotkit")}`);
     this.log(`  - Talk to your agent.`);
     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"));
+    this.log(`  - Read the docs: ${chalk8.blue("https://docs.copilotkit.ai")}`);
+    this.log(chalk8.magenta("\nEnjoy building with CopilotKit \u{1FA81}\n"));
   }
 };
 export {