copilotkit 0.0.45 → 0.0.47

package/dist/commands/create.js

@@ -1,55 +1,379 @@
 // src/commands/create.ts
-import { Command, Flags, Args } from "@oclif/core";
-import inquirer from "inquirer";
-import chalk from "chalk";
+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";
+
+// src/services/auth.service.ts
+import Conf2 from "conf";
+import cors from "cors";
+import express from "express";
+import crypto2 from "node:crypto";
+import open from "open";
+import getPort from "get-port";
 import ora from "ora";
+import chalk from "chalk";
+import inquirer from "inquirer";
+
+// src/utils/trpc.ts
+import { createTRPCClient as trpcClient, httpBatchLink } from "@trpc/client";
+import superjson from "superjson";
+var COPILOT_CLOUD_BASE_URL = process.env.COPILOT_CLOUD_BASE_URL || "https://cloud.copilotkit.ai";
+function createTRPCClient(cliToken) {
+  return trpcClient({
+    links: [
+      httpBatchLink({
+        url: `${COPILOT_CLOUD_BASE_URL}/api/trpc-cli`,
+        transformer: superjson,
+        headers: () => {
+          return {
+            "x-trpc-source": "cli",
+            "x-cli-token": 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) {
+    this.authData = authData;
+    if (process.env.SEGMENT_DISABLED === "true") {
+      return;
+    }
+    const segmentWriteKey = process.env.SEGMENT_WRITE_KEY || "9Pv6QyExYef2P4hPz4gks6QAvNMi2AOf";
+    this.globalProperties = {
+      service: "cli"
+    };
+    if (this.authData?.userId) {
+      this.userId = this.authData.userId;
+    }
+    if (this.authData?.email) {
+      this.email = this.authData.email;
+      this.globalProperties.email = this.authData.email;
+    }
+    if (this.authData?.organizationId) {
+      this.organizationId = this.authData.organizationId;
+    }
+    this.segment = new Analytics({
+      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;
+  organizationId;
+  config = new Conf({ projectName: "CopilotKitCLI" });
+  getAnonymousId() {
+    const anonymousId = this.config.get("anonymousId");
+    if (!anonymousId) {
+      const anonymousId2 = crypto.randomUUID();
+      this.config.set("anonymousId", anonymousId2);
+      return anonymousId2;
+    }
+    return anonymousId;
+  }
+  track(event) {
+    if (!this.segment) {
+      return Promise.resolve();
+    }
+    const payload = {
+      userId: this.userId ? this.userId : void 0,
+      email: this.email ? this.email : void 0,
+      anonymousId: this.getAnonymousId(),
+      event: event.event,
+      properties: {
+        ...this.globalProperties,
+        ...event.properties,
+        $groups: this.organizationId ? {
+          segment_group: this.organizationId
+        } : void 0,
+        eventProperties: {
+          ...event.properties,
+          ...this.globalProperties
+        }
+      }
+    };
+    return new Promise((resolve, reject) => {
+      this.segment.track(payload, (err) => {
+        if (err) {
+          resolve();
+        }
+        resolve();
+      });
+    });
+  }
+  /**
+   * 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;
+    }
+  }
+  /**
+   * Get feature flag payload
+   */
+  async getFeatureFlagPayload(flagKey) {
+    if (!this.posthog) {
+      return null;
+    }
+    try {
+      const distinctId = this.userId || this.getAnonymousId();
+      const payload = await this.posthog.getFeatureFlagPayload(flagKey, distinctId);
+      return payload;
+    } catch (error) {
+      console.warn(`Failed to get feature flag payload ${flagKey}:`, error);
+      return null;
+    }
+  }
+  /**
+   * Shutdown analytics services
+   */
+  async shutdown() {
+    if (this.posthog) {
+      await this.posthog.shutdown();
+    }
+  }
+};
+
+// src/services/auth.service.ts
+var AuthService = class {
+  config = new Conf2({ projectName: "CopilotKitCLI" });
+  COPILOT_CLOUD_BASE_URL = process.env.COPILOT_CLOUD_BASE_URL || "https://cloud.copilotkit.ai";
+  getToken() {
+    return this.config.get("cliToken");
+  }
+  getCLIToken() {
+    const cliToken = this.config.get("cliToken");
+    return cliToken;
+  }
+  async logout(cmd) {
+    this.config.delete("cliToken");
+  }
+  async requireLogin(cmd, context) {
+    let cliToken = this.getCLIToken();
+    if (!cliToken) {
+      try {
+        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;
+        } else {
+          cmd.error("Authentication required to proceed.");
+        }
+      } catch (error) {
+        if (error instanceof Error && error.name === "ExitPromptError") {
+          cmd.error(chalk.yellow("\nAuthentication cancelled"));
+        }
+        throw error;
+      }
+    }
+    let me;
+    const trpcClient2 = createTRPCClient(cliToken);
+    try {
+      me = await trpcClient2.me.query();
+    } catch (error) {
+      cmd.log(chalk.red("Could not authenticate with Copilot Cloud. Please run: npx copilotkit@latest login"));
+      process.exit(1);
+    }
+    if (!me.organization || !me.user) {
+      cmd.error("Authentication required to proceed.");
+    }
+    return { cliToken, user: me.user, organization: me.organization };
+  }
+  async login({ exitAfterLogin } = { exitAfterLogin: true }) {
+    const spinner = ora("\u{1FA81} Opening browser for authentication...").start();
+    let analytics;
+    analytics = new AnalyticsService();
+    const app = express();
+    app.use(cors());
+    app.use(express.urlencoded({ extended: true }));
+    app.use(express.json());
+    const port = await getPort();
+    const state = crypto2.randomBytes(16).toString("hex");
+    return new Promise(async (resolve) => {
+      const server = app.listen(port, () => {
+      });
+      await analytics.track({
+        event: "cli.login.initiated",
+        properties: {}
+      });
+      spinner.text = "\u{1FA81} Waiting for browser authentication to complete...";
+      app.post("/callback", async (req, res) => {
+        const { cliToken, user, organization } = req.body;
+        analytics = new AnalyticsService({ userId: user.id, organizationId: organization.id, email: user.email });
+        await analytics.track({
+          event: "cli.login.success",
+          properties: {
+            organizationId: organization.id,
+            userId: user.id,
+            email: user.email
+          }
+        });
+        if (state !== req.query.state) {
+          res.status(401).json({ message: "Invalid state" });
+          spinner.fail("Invalid state");
+          return;
+        }
+        this.config.set("cliToken", cliToken);
+        res.status(200).json({ message: "Callback called" });
+        spinner.succeed(`\u{1FA81} Successfully logged in as ${chalk.hex("#7553fc")(user.email)}`);
+        if (exitAfterLogin) {
+          process.exit(0);
+        } else {
+          server.close();
+          resolve({ cliToken, user, organization });
+        }
+      });
+      open(`${this.COPILOT_CLOUD_BASE_URL}/cli-auth?callbackUrl=http://localhost:${port}/callback&state=${state}`);
+    });
+  }
+};
+
+// src/commands/base-command.ts
+import { Command } from "@oclif/core";
+import Sentry, { consoleIntegration } from "@sentry/node";
+
+// src/utils/version.ts
+var LIB_VERSION = "0.0.47";
+
+// src/commands/base-command.ts
+import chalk2 from "chalk";
+var BaseCommand = class extends Command {
+  async init() {
+    await this.checkCLIVersion();
+    if (process.env.SENTRY_DISABLED === "true") {
+      return;
+    }
+    Sentry.init({
+      dsn: process.env.SENTRY_DSN || "https://1eea15d32e2eacb0456a77db5e39aeeb@o4507288195170304.ingest.us.sentry.io/4508581448581120",
+      integrations: [consoleIntegration()],
+      // Tracing
+      tracesSampleRate: 1
+      //  Capture 100% of the transactions
+    });
+  }
+  async catch(err) {
+    if (process.env.SENTRY_DISABLED === "true") {
+      super.catch(err);
+      return;
+    }
+    Sentry.captureException(err);
+    super.catch(err);
+  }
+  async finally() {
+    if (process.env.SENTRY_DISABLED === "true") {
+      return;
+    }
+    Sentry.close();
+  }
+  async run() {
+  }
+  async checkCLIVersion() {
+    const response = await fetch(`${COPILOT_CLOUD_BASE_URL}/api/healthz`);
+    const data = await response.json();
+    const cloudVersion = data.cliVersion;
+    if (!cloudVersion || cloudVersion === LIB_VERSION) {
+      return;
+    }
+  }
+  async gracefulError(message) {
+    this.log("\n" + chalk2.red(message));
+    process.exit(1);
+  }
+};
+
+// src/commands/create.ts
 var streamPipeline = promisify(pipeline);
 var theme = {
-  primary: chalk.magenta,
-  secondary: chalk.black,
-  tertiary: chalk.gray,
-  error: chalk.red,
-  command: chalk.blue,
-  success: chalk.green,
-  warning: chalk.yellow,
-  divider: chalk.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"),
+  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",
+  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"
+  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",
+  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"
+  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}",
+  flows: "\u{1F465}",
+  mastra: "\u{1F311}",
   "pydantic-ai": "\u{1F53C}",
-  "llamaindex": "\u{1F999}",
-  "ag2": "\u{1F916}",
-  "agno": "\u{1F170}\uFE0F"
+  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
@@ -68,14 +392,23 @@ var KITE = `
 \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 Command {
-  static description = "Create a new CopilotKit project with Next.js";
+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",
@@ -92,6 +425,9 @@ var Create = class _Create extends Command {
       description: "Removes the banner",
       default: false,
       required: false
+    }),
+    project: Flags.string({
+      description: "project ID (can be found in the Copilot Cloud dashboard)"
     })
   };
   static args = {
@@ -102,58 +438,141 @@ var Create = class _Create extends Command {
   };
   async run() {
     const { args, flags } = await this.parse(_Create);
-    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"));
+    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();
-    const options = {
-      projectName,
-      agentFramework
-    };
-    const projectDir = path.resolve(process.cwd(), projectName);
-    if (fs.existsSync(projectDir)) {
-      this.log(theme.error(`
+      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);
-    }
-    const spinner = ora({
-      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);
-      spinner.succeed(theme.secondary.bold(`Project "${projectName}" created successfully!`));
-      this.log("\n" + theme.divider);
-      this.log("\n" + theme.secondary.bold(`\u{1FA81}\u{1F91D}${FRAMEWORK_EMOJI[options.agentFramework]} All set! 
+        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! 
 
-You're ready to start building.`));
-      this.log("\n" + theme.secondary("Next steps:"));
-      this.log(theme.secondary(`  1. ${theme.command(`cd ${projectName}`)}`));
-      this.log(theme.secondary("  2. 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("https://docs.ag-ui.com"));
-      this.log(theme.secondary("  \u2022 ") + theme.command(FRAMEWORK_DOCUMENTATION[options.agentFramework]));
-      this.log(theme.bottomPadding);
+Your project is ready with Copilot Cloud configured.`
+          )
+        );
+        this.log("\n" + theme.secondary("Next steps:"));
+        this.log(theme.secondary(`  1. ${theme.command(`cd ${projectName}`)}`));
+        this.log(theme.secondary("  2. Follow the setup instructions in the README.md"));
+        if (options.projectId) {
+          this.log(
+            theme.secondary(
+              `  3. Create local tunnel for development: ${theme.command(`npx copilotkit@latest dev --port <value> --project ${options.projectId}`)}`
+            )
+          );
+        }
+        this.log("\n" + theme.secondary("Documentation:"));
+        this.log(theme.secondary("  \u2022 ") + theme.command("https://docs.copilotkit.ai"));
+        this.log(theme.secondary("  \u2022 ") + theme.command("https://docs.ag-ui.com"));
+        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) {
-      spinner.fail(theme.error(`Failed to create project: ${error.message}`));
-      this.exit(1);
+      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 inquirer.prompt([
+    const { projectName } = await inquirer2.prompt([
       {
         type: "input",
         name: "projectName",
@@ -173,7 +592,7 @@ You're ready to start building.`));
     return projectName;
   }
   async promptAgentFramework() {
-    const { framework } = await inquirer.prompt([
+    const { framework } = await inquirer2.prompt([
       {
         type: "list",
         name: "framework",
@@ -212,6 +631,100 @@ You're ready to start building.`));
       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");
+    }
+  }
 };
 export {
   Create as default