copilotkit 0.0.42 → 0.0.43-alpha.1

package/dist/lib/init/index.js

@@ -14,6 +14,7 @@ var CHAT_COMPONENTS = ["CopilotChat", "CopilotSidebar", "Headless", "CopilotPopu
 var LANGGRAPH_AGENTS = ["Python Starter", "TypeScript Starter"];
 var CREW_FLOW_TEMPLATES = ["Starter"];
 var YES_NO = ["Yes", "No"];
+var DEPLOYMENT_CHOICES = ["Copilot Cloud", "Self-hosted"];
 var sanitizers = {
   // Remove trailing slash from URLs
   url: (value) => {
@@ -42,6 +43,7 @@ var ChatComponentSchema = z.enum(CHAT_COMPONENTS);
 var LangGraphAgentSchema = z.enum(LANGGRAPH_AGENTS);
 var CrewFlowTemplateSchema = z.enum(CREW_FLOW_TEMPLATES);
 var YesNoSchema = z.enum(YES_NO);
+var DeploymentChoiceSchema = z.enum(DEPLOYMENT_CHOICES);
 var UrlSchema = z.preprocess(
   (val) => sanitizers.url(String(val)),
   z.string().url("Please enter a valid URL").min(1, "URL is required")
@@ -54,8 +56,6 @@ 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,
@@ -63,6 +63,7 @@ var ConfigSchema = z.object({
   // Yes/No fields
   alreadyDeployed: YesNoSchema.optional(),
   fastApiEnabled: YesNoSchema.optional(),
+  // DEPRECATED: useCopilotCloud - consolidated with signupForCopilotCloud
   useCopilotCloud: YesNoSchema.optional(),
   // LangGraph specific fields
   langGraphAgent: LangGraphAgentSchema.optional(),
@@ -80,7 +81,10 @@ var ConfigSchema = z.object({
   llmToken: LLMApiKeySchema.optional(),
   // IDE Documentation setup fields
   setupIDEDocs: YesNoSchema.optional(),
-  selectedIDE: z.union([z.enum(["cursor", "windsurf"]), z.literal("skip")]).optional()
+  selectedIDE: z.union([z.enum(["cursor", "windsurf"]), z.literal("skip")]).optional(),
+  // NEW: A/B/C test fields
+  deploymentChoice: DeploymentChoiceSchema.optional()
+  // For branch B only (Cloud vs Self-hosted)
 }).refine(
   (data) => {
     if (data.mode === "CrewAI") {
@@ -106,10 +110,6 @@ 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 }),
@@ -124,6 +124,11 @@ var ConfigFlags = {
   "selected-ide": Flags.string({
     description: "IDE to configure with documentation rules",
     options: ["cursor", "windsurf", "skip"]
+  }),
+  // NEW: A/B/C test flags
+  "deployment-choice": Flags.string({
+    description: "Choose between Copilot Cloud or Self-hosted deployment",
+    options: DEPLOYMENT_CHOICES
   })
 };
 
@@ -131,8 +136,8 @@ var ConfigFlags = {
 var BASE_URL = "https://registry.copilotkit.ai/r";
 var templateMapping = {
   // Runtimes
-  RemoteEndpoint: `${BASE_URL}/remote-endpoint-starter.json`,
-  LangGraphPlatformRuntime: `${BASE_URL}/langgraph-platform-starter.json`,
+  RemoteEndpoint: `${BASE_URL}/remote-endpoint.json`,
+  LangGraphPlatformRuntime: `${BASE_URL}/langgraph-platform-runtime.json`,
   // CrewAI
   CrewEnterprise: [`${BASE_URL}/coagents-crew-starter.json`],
   CrewFlowsEnterprise: [`${BASE_URL}/coagents-starter-crewai-flows.json`],
@@ -312,190 +317,212 @@ var validateUrl = (input) => {
 var validateRequired = (input) => {
   return sanitizers.trim(input) ? true : "This field is required";
 };
-var questions = [
-  // 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";
+function getQuestionsForBranch(branch) {
+  const baseQuestions = getBaseQuestions();
+  switch (branch) {
+    case "A":
+      return [...baseQuestions];
+    case "B":
+      return [...baseQuestions, ...getDeploymentChoiceQuestions()];
+    case "C":
+    default:
+      return [...baseQuestions, ...getCloudDeploymentQuestions()];
+  }
+}
+function getBaseQuestions() {
+  return [
+    {
+      type: "select",
+      name: "mode",
+      message: "\u{1F916} How will you be interacting with AI?",
+      choices: Array.from(MODES),
+      validate: (input) => {
+        try {
+          ModeSchema.parse(input);
+          return true;
+        } catch (error) {
+          return "Please select a valid mode";
+        }
       }
-    }
-  },
-  // Core setup questions - always shown after signup
-  {
-    type: "select",
-    name: "mode",
-    message: "\u{1F916} How will you be interacting with AI?",
-    choices: Array.from(MODES),
-    validate: (input) => {
-      try {
-        ModeSchema.parse(input);
-        return true;
-      } catch (error) {
-        return "Please select a valid mode";
+    },
+    // CrewAI specific questions
+    {
+      type: "select",
+      name: "crewType",
+      message: "\u{1F465} What kind of CrewAI implementation would you like to use?",
+      choices: Array.from(CREW_TYPES),
+      when: (answers) => answers.mode === "CrewAI",
+      validate: (input) => {
+        try {
+          CrewTypeSchema.parse(input);
+          return true;
+        } catch (error) {
+          return "Please select a valid crew type";
+        }
       }
-    }
-  },
-  // CrewAI specific questions - shown when CrewAI selected
-  {
-    type: "select",
-    name: "crewType",
-    message: "\u{1F465} What kind of CrewAI implementation would you like to use?",
-    choices: Array.from(CREW_TYPES),
-    when: (answers) => answers.mode === "CrewAI",
-    validate: (input) => {
-      try {
-        CrewTypeSchema.parse(input);
-        return true;
-      } catch (error) {
-        return "Please select a valid crew type";
+    },
+    {
+      type: "input",
+      name: "crewName",
+      message: "\u{1F465} What would you like to name your crew? (can be anything)",
+      when: (answers) => answers.mode === "CrewAI",
+      default: "MyCopilotCrew",
+      validate: validateRequired,
+      sanitize: sanitizers.trim
+    },
+    {
+      type: "input",
+      name: "crewUrl",
+      message: "\u{1F517} Enter your Crew's Enterprise URL (more info at https://app.crewai.com):",
+      when: (answers) => answers.mode === "CrewAI",
+      validate: validateUrl,
+      sanitize: sanitizers.url
+    },
+    {
+      type: "input",
+      name: "crewBearerToken",
+      message: "\u{1F511} Enter your Crew's bearer token:",
+      when: (answers) => answers.mode === "CrewAI",
+      sensitive: true,
+      validate: validateRequired,
+      sanitize: sanitizers.trim
+    },
+    // LangGraph specific questions
+    {
+      type: "yes/no",
+      name: "alreadyDeployed",
+      message: "\u{1F99C}\u{1F517} Do you have an existing LangGraph agent?",
+      when: (answers) => answers.mode === "LangGraph",
+      validate: (input) => {
+        try {
+          YesNoSchema.parse(input);
+          return true;
+        } catch (error) {
+          return "Please select Yes or No";
+        }
       }
-    }
-  },
-  // CrewAI specific questions - shown when CrewAI Crews or Flows selected
-  {
-    type: "input",
-    name: "crewName",
-    message: "\u{1F465} What would you like to name your crew? (can be anything)",
-    when: (answers) => answers.mode === "CrewAI",
-    default: "MyCopilotCrew",
-    validate: validateRequired,
-    sanitize: sanitizers.trim
-  },
-  {
-    type: "input",
-    name: "crewUrl",
-    message: "\u{1F517} Enter your Crew's Enterprise URL (more info at https://app.crewai.com):",
-    when: (answers) => answers.mode === "CrewAI",
-    validate: validateUrl,
-    sanitize: sanitizers.url
-  },
-  {
-    type: "input",
-    name: "crewBearerToken",
-    message: "\u{1F511} Enter your Crew's bearer token:",
-    when: (answers) => answers.mode === "CrewAI",
-    sensitive: true,
-    validate: validateRequired,
-    sanitize: sanitizers.trim
-  },
-  // LangGraph specific questions - shown when LangGraph selected
-  {
-    type: "yes/no",
-    name: "alreadyDeployed",
-    message: "\u{1F99C}\u{1F517} Do you have an existing LangGraph agent?",
-    when: (answers) => answers.mode === "LangGraph",
-    validate: (input) => {
-      try {
-        YesNoSchema.parse(input);
-        return true;
-      } catch (error) {
-        return "Please select Yes or No";
+    },
+    {
+      type: "yes/no",
+      name: "langGraphPlatform",
+      message: "\u{1F99C}\u{1F517} Do you already have a LangGraph Agent URL? (remote or localhost)",
+      when: (answers) => answers.mode === "LangGraph" && answers.alreadyDeployed === "Yes",
+      validate: (input) => {
+        try {
+          YesNoSchema.parse(input);
+          return true;
+        } catch (error) {
+          return "Please select Yes or No";
+        }
       }
-    }
-  },
-  {
-    type: "yes/no",
-    name: "langGraphPlatform",
-    message: "\u{1F99C}\u{1F517} Do you already have a LangGraph Agent URL? (remote or localhost)",
-    when: (answers) => answers.mode === "LangGraph" && answers.alreadyDeployed === "Yes",
-    validate: (input) => {
-      try {
-        YesNoSchema.parse(input);
-        return true;
-      } catch (error) {
-        return "Please select Yes or No";
+    },
+    {
+      type: "input",
+      name: "langGraphPlatformUrl",
+      message: "\u{1F99C}\u{1F517} Enter your LangGraph Agent URL (remote or localhost)",
+      when: (answers) => answers.mode === "LangGraph" && answers.alreadyDeployed === "Yes" && answers.langGraphPlatform === "Yes",
+      validate: validateUrl,
+      sanitize: sanitizers.url
+    },
+    {
+      type: "select",
+      name: "langGraphAgent",
+      message: "\u{1F4E6} Choose a LangGraph starter template:",
+      choices: Array.from(LANGGRAPH_AGENTS),
+      when: (answers) => answers.mode === "LangGraph" && answers.alreadyDeployed === "No"
+    },
+    {
+      type: "input",
+      name: "langSmithApiKey",
+      message: "\u{1F99C}\u{1F517} Enter your LangSmith API key (required by LangGraph Platform) :",
+      when: (answers) => answers.mode === "LangGraph" && answers.langGraphPlatform === "Yes" && !(answers.langGraphPlatformUrl && isLocalhost(answers.langGraphPlatformUrl)),
+      sensitive: true,
+      validate: validateRequired,
+      sanitize: sanitizers.apiKey
+    },
+    // LLM Token for self-hosted setups
+    {
+      type: "input",
+      name: "llmToken",
+      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.deploymentChoice === "Self-hosted" || answers.mode === "MCP" && answers.deploymentChoice === "Self-hosted" || answers.mode === "Standard" && answers.useCopilotCloud !== "Yes" || answers.mode === "MCP" && answers.useCopilotCloud !== "Yes",
+      sensitive: true,
+      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"
     }
-  },
-  {
-    type: "input",
-    name: "langGraphPlatformUrl",
-    message: "\u{1F99C}\u{1F517} Enter your LangGraph Agent URL (remote or localhost)",
-    when: (answers) => answers.mode === "LangGraph" && answers.alreadyDeployed === "Yes" && answers.langGraphPlatform === "Yes",
-    validate: validateUrl,
-    sanitize: sanitizers.url
-  },
-  {
-    type: "select",
-    name: "langGraphAgent",
-    message: "\u{1F4E6} Choose a LangGraph starter template:",
-    choices: Array.from(LANGGRAPH_AGENTS),
-    when: (answers) => answers.mode === "LangGraph" && answers.alreadyDeployed === "No"
-  },
-  {
-    type: "input",
-    name: "langSmithApiKey",
-    message: "\u{1F99C}\u{1F517} Enter your LangSmith API key (required by LangGraph Platform) :",
-    when: (answers) => answers.mode === "LangGraph" && answers.langGraphPlatform === "Yes" && !(answers.langGraphPlatformUrl && isLocalhost(answers.langGraphPlatformUrl)),
-    sensitive: true,
-    validate: validateRequired,
-    sanitize: sanitizers.apiKey
-  },
-  // Deployment options
-  {
-    type: "yes/no",
-    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" && !linkToDocs.includes(answers.mode || "") && !isLocalhost(answers.langGraphPlatformUrl || ""),
-    validate: (input) => {
-      try {
-        YesNoSchema.parse(input);
-        return true;
-      } catch (error) {
-        return "Please select Yes or No";
+  ];
+}
+function getDeploymentChoiceQuestions() {
+  return [
+    {
+      type: "select",
+      name: "deploymentChoice",
+      message: "\u{1F680} Use Copilot Cloud, or self-hosted?",
+      choices: Array.from(DEPLOYMENT_CHOICES),
+      validate: (input) => {
+        try {
+          DeploymentChoiceSchema.parse(input);
+          return true;
+        } catch (error) {
+          return "Please select a valid deployment option";
+        }
       }
     }
-  },
-  {
-    type: "input",
-    name: "llmToken",
-    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,
-    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";
+  ];
+}
+function getCloudDeploymentQuestions() {
+  return [
+    {
+      type: "yes/no",
+      name: "useCopilotCloud",
+      message: "\u{1FA81} Deploy with Copilot Cloud? (recommended for production)",
+      when: (answers) => answers.mode === "Standard" || answers.mode === "MCP" || answers.mode === "LangGraph" && answers.alreadyDeployed === "No" || // Include new LangGraph agents
+      answers.mode !== "CrewAI" && // Crews only cloud, flows are self-hosted
+      answers.alreadyDeployed === "Yes" && answers.langGraphPlatform !== "No" && !linkToDocs.includes(answers.mode || "") && !isLocalhost(answers.langGraphPlatformUrl || ""),
+      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"
-  }
-];
+  ];
+}
+var questions = getQuestionsForBranch("C");
 
 // src/lib/init/scaffold/shadcn.ts
 import spawn from "cross-spawn";
@@ -504,16 +531,12 @@ async function scaffoldShadCN(flags, userAnswers) {
     const components = [];
     switch (userAnswers.mode) {
       case "LangGraph":
-        if (userAnswers.langGraphAgent || flags.booth) {
-          components.push(...templateMapping.LangGraphStarter);
-        } else {
-          components.push(templateMapping.LangGraphGeneric);
-          if (userAnswers.useCopilotCloud !== "Yes") {
-            if (userAnswers.langGraphPlatform === "Yes") {
-              components.push(templateMapping.LangGraphPlatformRuntime);
-            } else {
-              components.push(templateMapping.RemoteEndpoint);
-            }
+        components.push(templateMapping.LangGraphGeneric);
+        if (userAnswers.deploymentChoice === "Self-hosted" || userAnswers.useCopilotCloud === "No") {
+          if (userAnswers.langGraphPlatform === "Yes") {
+            components.push(templateMapping.LangGraphPlatformRuntime);
+          } else {
+            components.push(templateMapping.RemoteEndpoint);
           }
         }
         break;
@@ -528,13 +551,13 @@ async function scaffoldShadCN(flags, userAnswers) {
         break;
       case "MCP":
         components.push(templateMapping.McpStarter);
-        if (userAnswers.useCopilotCloud !== "Yes") {
+        if (userAnswers.deploymentChoice === "Self-hosted" || userAnswers.useCopilotCloud === "No") {
           components.push(templateMapping.McpRuntime);
         }
         break;
       case "Standard":
         components.push(templateMapping.StandardStarter);
-        if (userAnswers.useCopilotCloud !== "Yes") {
+        if (userAnswers.deploymentChoice === "Self-hosted" || userAnswers.useCopilotCloud === "No") {
           components.push(templateMapping.StandardRuntime);
         }
         break;
@@ -584,6 +607,12 @@ async function getLangGraphAgents(url, langSmithApiKey) {
 
 // src/lib/init/scaffold/env.ts
 import inquirer from "inquirer";
+function needsCloudDeployment(userAnswers) {
+  return userAnswers.deploymentChoice === "Copilot Cloud" || // Branch B choice
+  userAnswers.useCopilotCloud === "Yes" || // Branch C choice
+  userAnswers.mode === "CrewAI" || // CrewAI always needs cloud
+  !userAnswers.deploymentChoice && !userAnswers.useCopilotCloud;
+}
 async function scaffoldEnv(flags, userAnswers) {
   try {
     const envFile = path2.join(process.cwd(), ".env");
@@ -592,6 +621,7 @@ async function scaffoldEnv(flags, userAnswers) {
     } else {
     }
     let newEnvValues = "";
+    const isCloudDeployment = needsCloudDeployment(userAnswers);
     if (userAnswers.copilotCloudPublicApiKey) {
       newEnvValues += `NEXT_PUBLIC_COPILOT_API_KEY=${userAnswers.copilotCloudPublicApiKey}
 `;
@@ -613,7 +643,7 @@ async function scaffoldEnv(flags, userAnswers) {
 `;
       newEnvValues += `LANGGRAPH_DEPLOYMENT_URL=http://localhost:8123
 `;
-    } else if (userAnswers.langGraphPlatform === "Yes" && userAnswers.useCopilotCloud !== "Yes") {
+    } else if (userAnswers.langGraphPlatform === "Yes" && !isCloudDeployment) {
       newEnvValues += `LANGGRAPH_DEPLOYMENT_URL=${userAnswers.langGraphPlatformUrl}
 `;
     } else if (userAnswers.langGraphRemoteEndpointURL) {
@@ -623,12 +653,15 @@ async function scaffoldEnv(flags, userAnswers) {
     if (flags.runtimeUrl) {
       newEnvValues += `NEXT_PUBLIC_COPILOTKIT_RUNTIME_URL=${flags.runtimeUrl}
 `;
-    } else if (userAnswers.useCopilotCloud !== "Yes" && userAnswers.crewType !== "Crews" && userAnswers.crewType !== "Flows") {
+    } else if (!isCloudDeployment && userAnswers.crewType !== "Crews" && userAnswers.crewType !== "Flows") {
       newEnvValues += `NEXT_PUBLIC_COPILOTKIT_RUNTIME_URL=/api/copilotkit
 `;
     }
     if (userAnswers.langGraphPlatformUrl && (userAnswers.langSmithApiKey || isLocalhost(userAnswers.langGraphPlatformUrl))) {
-      const langGraphAgents = await getLangGraphAgents(userAnswers.langGraphPlatformUrl, userAnswers.langSmithApiKey || "");
+      const langGraphAgents = await getLangGraphAgents(
+        userAnswers.langGraphPlatformUrl,
+        userAnswers.langSmithApiKey || ""
+      );
       let langGraphAgent = "";
       if (langGraphAgents.length > 1) {
         const { langGraphAgentChoice } = await inquirer.prompt([
@@ -937,6 +970,8 @@ export {
   ConfigSchema,
   CrewFlowTemplateSchema,
   CrewTypeSchema,
+  DEPLOYMENT_CHOICES,
+  DeploymentChoiceSchema,
   IDE_DOCS_CONFIGS,
   LANGGRAPH_AGENTS,
   LLMApiKeySchema,
@@ -951,6 +986,7 @@ export {
   addCrewInputs,
   cloneGitHubSubdirectory,
   detectInstalledIDEs,
+  getQuestionsForBranch,
   handleIDEDocsSetup,
   isLocalhost,
   isValidGitHubUrl,