copilotkit 0.0.41 → 0.0.42-alpha.0

package/dist/commands/init.js

@@ -38,6 +38,7 @@ function createTRPCClient(cliToken) {
 
 // src/services/analytics.service.ts
 import { Analytics } from "@segment/analytics-node";
+import { PostHog } from "posthog-node";
 import Conf from "conf";
 var AnalyticsService = class {
   constructor(authData) {
@@ -63,12 +64,20 @@ var AnalyticsService = class {
       writeKey: segmentWriteKey,
       disable: process.env.SEGMENT_DISABLE === "true"
     });
+    if (process.env.POSTHOG_DISABLED !== "true") {
+      const posthogKey = process.env.POSTHOG_KEY || "phc_XZdymVYjrph9Mi0xZYGNyCKexxgblXRR1jMENCtdz5Q";
+      const posthogHost = process.env.POSTHOG_HOST || "https://eu.i.posthog.com";
+      this.posthog = new PostHog(posthogKey, {
+        host: posthogHost
+      });
+    }
     const config = new Conf({ projectName: "CopilotKitCLI" });
     if (!config.get("anonymousId")) {
       config.set("anonymousId", crypto.randomUUID());
     }
   }
   segment;
+  posthog;
   globalProperties = {};
   userId;
   email;
@@ -113,6 +122,30 @@ var AnalyticsService = class {
       });
     });
   }
+  /**
+   * Check if a feature flag is enabled
+   */
+  async isFeatureEnabled(flagKey) {
+    if (!this.posthog) {
+      return false;
+    }
+    try {
+      const distinctId = this.userId || this.getAnonymousId();
+      const flag = await this.posthog.isFeatureEnabled(flagKey, distinctId);
+      return Boolean(flag);
+    } catch (error) {
+      console.warn(`Failed to check feature flag ${flagKey}:`, error);
+      return false;
+    }
+  }
+  /**
+   * Shutdown analytics services
+   */
+  async shutdown() {
+    if (this.posthog) {
+      await this.posthog.shutdown();
+    }
+  }
 };
 
 // src/services/auth.service.ts
@@ -129,19 +162,26 @@ var AuthService = class {
   async logout(cmd) {
     this.config.delete("cliToken");
   }
-  async requireLogin(cmd) {
+  async requireLogin(cmd, context) {
     let cliToken = this.getCLIToken();
     if (!cliToken) {
       try {
-        const { shouldLogin } = await inquirer.prompt([
-          {
-            name: "shouldLogin",
-            type: "confirm",
-            message: "\u{1FA81} You are not yet authenticated. Authenticate with Copilot Cloud? (press Enter to confirm)",
-            default: true
-          }
-        ]);
+        let shouldLogin = true;
+        if (context !== "cloud-features") {
+          const response = await inquirer.prompt([
+            {
+              name: "shouldLogin",
+              type: "confirm",
+              message: "\u{1FA81} You are not yet authenticated. Authenticate with Copilot Cloud? (press Enter to confirm)",
+              default: true
+            }
+          ]);
+          shouldLogin = response.shouldLogin;
+        }
         if (shouldLogin) {
+          if (context === "cloud-features") {
+            cmd.log(chalk.cyan("\n\u{1F680} Setting up Copilot Cloud authentication for your selected features...\n"));
+          }
           const loginResult = await this.login({ exitAfterLogin: false });
           cliToken = loginResult.cliToken;
           return loginResult;
@@ -222,7 +262,7 @@ import { Command } from "@oclif/core";
 import Sentry, { consoleIntegration } from "@sentry/node";
 
 // src/utils/version.ts
-var LIB_VERSION = "0.0.41";
+var LIB_VERSION = "0.0.42-alpha.0";
 
 // src/commands/base-command.ts
 import chalk2 from "chalk";
@@ -326,6 +366,8 @@ var ApiKeySchema = z.preprocess(
 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({
+  // NEW: Early signup field
+  signupForCopilotCloud: YesNoSchema.optional(),
   // Core fields
   copilotKitVersion: z.string().optional(),
   mode: ModeSchema,
@@ -376,6 +418,10 @@ var ConfigSchema = z.object({
 );
 var ConfigFlags = {
   booth: Flags.boolean({ description: "Use CopilotKit in booth mode", default: false, char: "b" }),
+  "signup-for-copilot-cloud": Flags.string({
+    description: "Sign up for Copilot Cloud for error tracking and debugging insights",
+    options: YES_NO
+  }),
   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 }),
@@ -579,7 +625,21 @@ var validateRequired = (input) => {
   return sanitizers.trim(input) ? true : "This field is required";
 };
 var questions = [
-  // Core setup questions - always shown first
+  // NEW: Early signup question - first question for maximum visibility
+  {
+    type: "yes/no",
+    name: "signupForCopilotCloud",
+    message: "\u{1FA81} Sign up for Copilot Cloud to enable error tracking and get production-ready hosting? (Recommended)",
+    validate: (input) => {
+      try {
+        YesNoSchema.parse(input);
+        return true;
+      } catch (error) {
+        return "Please select Yes or No";
+      }
+    }
+  },
+  // Core setup questions - always shown after signup
   {
     type: "select",
     name: "mode",
@@ -1128,6 +1188,9 @@ var CloudInit = class _CloudInit extends BaseCommand {
     this.authService = authService;
   }
   trpcClient = null;
+  analytics = null;
+  startTime = Date.now();
+  analyticsQueue = [];
   static description = "Set up CopilotKit in your Next.js project";
   static examples = ["<%= config.bin %> init"];
   static flags = {
@@ -1140,19 +1203,31 @@ var CloudInit = class _CloudInit extends BaseCommand {
   async run() {
     const { flags } = await this.parse(_CloudInit);
     try {
+      this.analytics = new AnalyticsService();
       this.log(chalk7.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"));
       } else {
         this.log(chalk7.gray("Let's power up your Next.js project with AI capabilities\n"));
       }
-      this.validateProjectCompatibility(flags);
+      const projectValidated = this.validateProjectCompatibility(flags);
+      this.queueAnalytics("cli.init.started", {
+        nextjs_detected: projectValidated,
+        flags_used: Object.keys(flags).filter((key) => flags[key] !== void 0 && key !== "help")
+      });
       let userAnswers;
+      let cloudSetupInfo = null;
       if (flags.booth) {
         userAnswers = await this.getBoothAnswers();
       } else {
-        userAnswers = await this.getUserAnswers(flags);
+        const result = await this.getUserAnswers(flags);
+        userAnswers = result.config;
+        cloudSetupInfo = result.cloudSetupInfo;
       }
+      this.queueAnalytics("cli.init.mode_selected", {
+        mode: userAnswers.mode,
+        early_signup_completed: !!cloudSetupInfo
+      });
       if (userAnswers.mode === "Mastra") {
         this.log(chalk7.magenta(`
 \u{1F517} Please go to https://docs.copilotkit.ai/mastra/quickstart to get started.`));
@@ -1170,11 +1245,28 @@ var CloudInit = class _CloudInit extends BaseCommand {
 \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";
-      if (needsCloudSetup) await this.setupCloud(flags, userAnswers);
+      const needsCloudDeployment = userAnswers.useCopilotCloud === "Yes" || userAnswers.mode === "CrewAI";
+      if (userAnswers.useCopilotCloud) {
+        this.queueAnalytics("cli.init.cloud_deployment_selected", {
+          choice: userAnswers.useCopilotCloud,
+          mode: userAnswers.mode,
+          early_signup_completed: !!cloudSetupInfo
+        });
+      }
+      if (needsCloudDeployment) {
+        if (cloudSetupInfo) {
+          await this.completeCloudDeploymentSetup(flags, userAnswers, cloudSetupInfo);
+        } else {
+          await this.setupCloud(flags, userAnswers);
+        }
+      }
       await scaffoldEnv(flags, userAnswers);
       await scaffoldShadCN(flags, userAnswers);
-      if (!flags.booth) await scaffoldAgent(userAnswers);
+      let agentScaffolded = false;
+      if (!flags.booth) {
+        await scaffoldAgent(userAnswers);
+        agentScaffolded = true;
+      }
       if (userAnswers.crewUrl && userAnswers.crewBearerToken)
         await addCrewInputs(userAnswers.crewUrl, userAnswers.crewBearerToken);
       if (userAnswers.setupIDEDocs === "Yes" && userAnswers.selectedIDE !== "skip") {
@@ -1188,6 +1280,15 @@ var CloudInit = class _CloudInit extends BaseCommand {
           ideDocsSpinner.fail("IDE documentation setup failed, but you can configure it manually later");
         }
       }
+      this.queueAnalytics("cli.init.completed", {
+        mode: userAnswers.mode,
+        early_signup_completed: !!cloudSetupInfo,
+        cloud_deployment: needsCloudDeployment,
+        agent_scaffolded: agentScaffolded,
+        api_key_in_env: !!userAnswers.copilotCloudPublicApiKey,
+        duration_ms: Date.now() - this.startTime
+      });
+      await this.flushAnalytics();
       if (flags.booth) {
         this.log("\n-----\n");
         this.log(chalk7.magenta("\u{1F389} Your CopilotKit setup is complete! \u{1F389}\n"));
@@ -1200,9 +1301,39 @@ var CloudInit = class _CloudInit extends BaseCommand {
         this.finalSummary(userAnswers);
       }
     } catch (error) {
+      this.queueAnalytics("cli.init.failed", {
+        error: error.message,
+        step: "unknown",
+        duration_ms: Date.now() - this.startTime
+      });
+      await this.flushAnalytics();
       this.gracefulError(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 getBoothAnswers() {
     const url = await inquirer3.prompt({
       type: "input",
@@ -1235,14 +1366,72 @@ 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(`  ${chalk7.green(key)}: ${value}`);
+    let signupAnswer = initialAnswers.signupForCopilotCloud;
+    let isCloudByDefault = false;
+    try {
+      isCloudByDefault = await this.analytics.isFeatureEnabled("cloud-by-default");
+    } catch {
+    }
+    if (!signupAnswer) {
+      if (isCloudByDefault) {
+        this.queueAnalytics("cli.init.early_signup_prompt_shown", {});
+        const signupResult = await inquirer3.prompt([
+          {
+            type: "list",
+            name: "signupForCopilotCloud",
+            message: "\u{1FA81} Sign up for Copilot Cloud to enable error tracking and get production-ready hosting? (Recommended)",
+            choices: ["Yes", "No"]
+          }
+        ]);
+        signupAnswer = signupResult.signupForCopilotCloud;
+      } else {
+        signupAnswer = "No";
+      }
+    }
+    if (isCloudByDefault || initialAnswers.signupForCopilotCloud) {
+      this.queueAnalytics("cli.init.early_signup_selected", {
+        choice: signupAnswer,
+        cloud_by_default_enabled: isCloudByDefault
       });
-      this.log("");
     }
-    const inquirerQuestions = questions.map((q) => {
+    let cloudSetupInfo = null;
+    let earlyApiKey;
+    if (signupAnswer === "Yes") {
+      try {
+        const tempConfig = { ...initialAnswers, signupForCopilotCloud: signupAnswer };
+        const earlySignupResult = await this.handleEarlyCloudSignup(flags, tempConfig);
+        cloudSetupInfo = earlySignupResult;
+        earlyApiKey = earlySignupResult.apiKey;
+        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.init.early_signup_completed", {
+          userId: cloudSetupInfo.organization?.id || "unknown",
+          organizationId: cloudSetupInfo.organization?.id || "unknown",
+          email: "unknown",
+          // Will be updated when we get user info
+          projectId: cloudSetupInfo.selectedProjectId || "unknown",
+          api_key_retrieved: !!earlyApiKey
+        });
+      } catch (error) {
+        this.queueAnalytics("cli.init.early_signup_failed", {
+          error: error.message,
+          step: "auth"
+          // Could be more specific based on where it failed
+        });
+        throw error;
+      }
+    }
+    const remainingQuestions = questions.slice(1);
+    const inquirerQuestions = remainingQuestions.map((q) => {
       if (initialAnswers[q.name] !== void 0) {
         return null;
       }
@@ -1250,7 +1439,7 @@ var CloudInit = class _CloudInit extends BaseCommand {
         name: q.name,
         message: q.message,
         when: (answers2) => {
-          const combinedAnswers = { ...initialAnswers, ...answers2 };
+          const combinedAnswers = { ...initialAnswers, signupForCopilotCloud: signupAnswer, ...answers2 };
           return q.when ? q.when(combinedAnswers) : true;
         },
         default: q.default,
@@ -1281,7 +1470,13 @@ var CloudInit = class _CloudInit extends BaseCommand {
       }
     }).filter((q) => q !== null);
     const promptAnswers = await inquirer3.prompt(inquirerQuestions);
-    const answers = { ...initialAnswers, ...promptAnswers };
+    const answers = {
+      ...initialAnswers,
+      signupForCopilotCloud: signupAnswer,
+      ...promptAnswers,
+      ...earlyApiKey && { copilotCloudPublicApiKey: earlyApiKey }
+      // Add API key if we got one from early signup
+    };
     if (answers.langGraphPlatform === "No") {
       this.log(
         "\nCurrently the CLI only supports scaffolding LangGraph Platform agents. Use our quickstart guide to get started:\n"
@@ -1293,7 +1488,7 @@ var CloudInit = class _CloudInit extends BaseCommand {
       const spinner = ora5({ text: "Validating configuration...", color: "green" }).start();
       const validatedConfig = ConfigSchema.parse(answers);
       spinner.succeed(`\u{1F50D} Configuration validated successfully`);
-      return validatedConfig;
+      return { config: validatedConfig, cloudSetupInfo };
     } catch (error) {
       const spinner = ora5({ text: "Validation failed...", color: "red" }).start();
       if (error.errors) {
@@ -1308,7 +1503,7 @@ var CloudInit = class _CloudInit extends BaseCommand {
     }
   }
   async setupCloud(flags, userAnswers) {
-    const { cliToken, organization } = await this.authService.requireLogin(this);
+    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;
@@ -1423,6 +1618,129 @@ var CloudInit = class _CloudInit extends BaseCommand {
       }
     }
   }
+  async handleEarlyCloudSignup(flags, userAnswers) {
+    this.log(chalk7.cyan("\n\u{1F680} Great choice! Let's get you set up with Copilot Cloud...\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`));
+        process.exit(1);
+      }
+      selectedProjectId = flags.project;
+      this.log(chalk7.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}`));
+    } else {
+      const { projectId } = await inquirer3.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;
+    }
+    let apiKey;
+    if (selectedProjectId) {
+      const spinner = ora5({
+        text: "Setting up error tracking and debugging insights...",
+        color: "cyan"
+      }).start();
+      try {
+        const copilotCloudPublicApiKey = await this.trpcClient.getCopilotCloudPublicApiKey.query({
+          projectId: selectedProjectId
+        });
+        apiKey = copilotCloudPublicApiKey?.key;
+        spinner.succeed("\u2705 Error tracking and debugging insights enabled");
+      } catch (error) {
+        spinner.fail("Failed to set up error tracking, but continuing with setup");
+        console.error(error);
+      }
+    }
+    this.log(chalk7.green("\u2705 Copilot Cloud setup complete! Error tracking enabled for better debugging.\n"));
+    return { cliToken, organization, selectedProjectId, apiKey };
+  }
+  async completeCloudDeploymentSetup(flags, userAnswers, cloudSetupInfo) {
+    if (!this.trpcClient) {
+      this.trpcClient = createTRPCClient(cloudSetupInfo.cliToken);
+    }
+    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...`),
+        color: "cyan"
+      }).start();
+      try {
+        await this.trpcClient.createRemoteEndpoint.mutate({
+          type: isFlow ? "CrewAIFlows" : "CrewAI",
+          projectId: selectedProjectId,
+          config: {
+            type: isFlow ? "CrewAIFlows" : "CrewAI",
+            url: userAnswers.crewUrl,
+            agentName: userAnswers.crewName,
+            agentDescription: `A helpful CrewAI ${isFlow ? "Flow" : "Crew"}`,
+            crewApiBearerToken: userAnswers.crewBearerToken
+          }
+        });
+        crewSpinner.succeed(chalk7(`\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`));
+        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..."),
+        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."));
+            process.exit(1);
+          }
+          await this.trpcClient.createLGCRemoteEndpoint.mutate({
+            type: "LangGraphCloud",
+            projectId: selectedProjectId,
+            config: {
+              deploymentUrl: userAnswers.langGraphPlatformUrl,
+              langsmithApiKey: userAnswers.langSmithApiKey,
+              agents: []
+            }
+          });
+          langGraphSpinner.succeed(chalk7("\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."));
+          process.exit(1);
+        }
+      } else if (userAnswers.langGraphRemoteEndpointURL) {
+        try {
+          await this.trpcClient.createRemoteEndpoint.mutate({
+            type: "CopilotKit",
+            projectId: selectedProjectId,
+            config: {
+              type: "CopilotKit",
+              url: userAnswers.langGraphRemoteEndpointURL
+            }
+          });
+          langGraphSpinner.succeed(chalk7("\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."));
+          process.exit(1);
+        }
+      }
+    }
+  }
   validateProjectCompatibility(flags) {
     const spinner = ora5("Checking Next.js project compatibility...").start();
     try {
@@ -1497,13 +1815,24 @@ var CloudInit = class _CloudInit extends BaseCommand {
     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.`);
+    if (userAnswers.signupForCopilotCloud === "Yes") {
+      if (userAnswers.useCopilotCloud === "Yes" || userAnswers.crewType === "Crews") {
+        this.log(`  - \u{1F680} Configured for Copilot Cloud deployment with error tracking.`);
+      } else {
+        this.log(`  - \u{1F41B} Error tracking enabled for better debugging and insights.`);
+      }
+    } else if (userAnswers.useCopilotCloud === "Yes" || userAnswers.crewType === "Crews") {
+      this.log(`  - \u{1F680} Configured for Copilot Cloud deployment.`);
+    }
     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: ${chalk7.gray("$")} ${chalk7.cyan(`cd agent && ${agentDevInstructions}`)}`);
     this.log(`  - Navigate to ${chalk7.blue("http://localhost:3000/copilotkit")}`);
     this.log(`  - Talk to your agent.`);
+    if (userAnswers.copilotCloudPublicApiKey) {
+      this.log(`  - \u{1F41B} Errors and performance data will be visible in your Copilot Cloud dashboard.`);
+    }
     if (userAnswers.setupIDEDocs === "Yes" && userAnswers.selectedIDE !== "skip") {
       this.log(`  - Your IDE now has CopilotKit documentation context for better AI assistance.`);
     }