copilotkit 0.0.0-main-20260402184302

package/dist/commands/logout.js

@@ -0,0 +1,375 @@
+// src/commands/logout.ts
+import chalk3 from "chalk";
+
+// src/services/auth.service.ts
+import Conf2 from "conf";
+import cors from "cors";
+import express from "express";
+import crypto2 from "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...\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.yellow("Your authentication has expired. Re-authenticating...")
+      );
+      try {
+        const loginResult = await this.login({ exitAfterLogin: false });
+        return loginResult;
+      } catch (loginError) {
+        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, reject) => {
+      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;
+        if (state !== req.query.state) {
+          res.status(401).json({ message: "Invalid state" });
+          spinner.fail("Invalid state");
+          server.close();
+          reject(new Error("OAuth state mismatch"));
+          return;
+        }
+        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
+          }
+        });
+        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.0-main-20260402184302";
+
+// 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") {
+      Sentry.captureException(err);
+    }
+    const message = err?.message ?? "Unknown error";
+    this.log("\n" + chalk2.red(message) + "\n");
+    const exitCode = err?.oclif?.exit ?? 1;
+    this.exit(exitCode);
+  }
+  async finally() {
+    if (process.env.SENTRY_DISABLED === "true") {
+      return;
+    }
+    Sentry.close();
+  }
+  async run() {
+  }
+  async checkCLIVersion() {
+    try {
+      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;
+      }
+    } catch {
+    }
+  }
+  async gracefulError(message) {
+    this.log("\n" + chalk2.red(message));
+    process.exit(1);
+  }
+};
+
+// src/commands/logout.ts
+var CloudLogout = class _CloudLogout extends BaseCommand {
+  constructor(argv, config, authService = new AuthService()) {
+    super(argv, config);
+    this.authService = authService;
+  }
+  static description = "Logout from Copilot Cloud";
+  static examples = ["<%= config.bin %> logout"];
+  async run() {
+    await this.parse(_CloudLogout);
+    this.log("Logging out...\n");
+    await this.authService.logout(this);
+    this.log(chalk3.green("Successfully logged out!"));
+  }
+};
+export {
+  CloudLogout as default
+};
+//# sourceMappingURL=logout.js.map

package/dist/commands/logout.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/commands/logout.ts","../../src/services/auth.service.ts","../../src/utils/trpc.ts","../../src/services/analytics.service.ts","../../src/commands/base-command.ts","../../src/utils/version.ts"],"sourcesContent":["import { Config } from \"@oclif/core\";\nimport chalk from \"chalk\";\nimport ora from \"ora\";\n\nimport { AuthService } from \"../services/auth.service.js\";\nimport { BaseCommand } from \"./base-command.js\";\n\nexport default class CloudLogout extends BaseCommand {\n  static override description = \"Logout from Copilot Cloud\";\n\n  static override examples = [\"<%= config.bin %> logout\"];\n\n  constructor(\n    argv: string[],\n    config: Config,\n    private authService = new AuthService(),\n  ) {\n    super(argv, config);\n  }\n\n  public async run(): Promise<void> {\n    await this.parse(CloudLogout);\n    this.log(\"Logging out...\\n\");\n    await this.authService.logout(this);\n    this.log(chalk.green(\"Successfully logged out!\"));\n  }\n}\n","// @ts-ignore\nimport Conf from \"conf\";\nimport cors from \"cors\";\nimport express from \"express\";\nimport crypto from \"node:crypto\";\nimport open from \"open\";\nimport getPort from \"get-port\";\nimport ora from \"ora\";\nimport chalk from \"chalk\";\nimport inquirer from \"inquirer\";\nimport { Command } from \"@oclif/core\";\nimport { createTRPCClient } from \"../utils/trpc.js\";\nimport { AnalyticsService } from \"../services/analytics.service.js\";\nimport { BaseCommand } from \"../commands/base-command.js\";\n\ninterface LoginResponse {\n  cliToken: string;\n  user: {\n    email: string;\n    id: string;\n  };\n  organization: {\n    id: string;\n  };\n}\n\nexport class AuthService {\n  private readonly config = new Conf({ projectName: \"CopilotKitCLI\" });\n  private readonly COPILOT_CLOUD_BASE_URL =\n    process.env.COPILOT_CLOUD_BASE_URL || \"https://cloud.copilotkit.ai\";\n\n  getToken(): string | undefined {\n    return this.config.get(\"cliToken\") as string | undefined;\n  }\n\n  getCLIToken(): string | undefined {\n    const cliToken = this.config.get(\"cliToken\") as string | undefined;\n    return cliToken;\n  }\n\n  async logout(cmd: BaseCommand): Promise<void> {\n    this.config.delete(\"cliToken\");\n  }\n\n  async requireLogin(\n    cmd: Command,\n    context?: \"cloud-features\" | \"general\",\n  ): Promise<LoginResponse> {\n    let cliToken = this.getCLIToken();\n    // Check authentication\n    if (!cliToken) {\n      try {\n        let shouldLogin = true;\n\n        // For cloud features, automatically proceed with login\n        // For general usage, ask for confirmation\n        if (context !== \"cloud-features\") {\n          const response = await inquirer.prompt([\n            {\n              name: \"shouldLogin\",\n              type: \"confirm\",\n              message:\n                \"🪁 You are not yet authenticated. Authenticate with Copilot Cloud? (press Enter to confirm)\",\n              default: true,\n            },\n          ]);\n          shouldLogin = response.shouldLogin;\n        }\n\n        if (shouldLogin) {\n          // Show different message for cloud features vs general usage\n          if (context === \"cloud-features\") {\n            cmd.log(\n              chalk.cyan(\"\\n🚀 Setting up Copilot Cloud authentication...\\n\"),\n            );\n          }\n          const loginResult = await this.login({ exitAfterLogin: false });\n          cliToken = loginResult.cliToken;\n          return loginResult;\n        } else {\n          cmd.error(\"Authentication required to proceed.\");\n        }\n      } catch (error) {\n        if (error instanceof Error && error.name === \"ExitPromptError\") {\n          cmd.error(chalk.yellow(\"\\nAuthentication cancelled\"));\n        }\n\n        throw error;\n      }\n    }\n\n    let me;\n\n    const trpcClient = createTRPCClient(cliToken);\n    try {\n      me = await trpcClient.me.query();\n    } catch (error) {\n      // Token is invalid/expired, trigger new login\n      cmd.log(\n        chalk.yellow(\"Your authentication has expired. Re-authenticating...\"),\n      );\n      try {\n        const loginResult = await this.login({ exitAfterLogin: false });\n        return loginResult;\n      } catch (loginError) {\n        cmd.log(\n          chalk.red(\n            \"Could not authenticate with Copilot Cloud. Please run: npx copilotkit@latest login\",\n          ),\n        );\n        process.exit(1);\n      }\n    }\n\n    if (!me.organization || !me.user) {\n      cmd.error(\"Authentication required to proceed.\");\n    }\n\n    return { cliToken, user: me.user, organization: me.organization };\n  }\n\n  async login(\n    { exitAfterLogin }: { exitAfterLogin?: boolean } = { exitAfterLogin: true },\n  ): Promise<LoginResponse> {\n    const spinner = ora(\"🪁 Opening browser for authentication...\").start();\n    let analytics: AnalyticsService;\n    analytics = new AnalyticsService();\n\n    const app = express();\n    app.use(cors());\n    app.use(express.urlencoded({ extended: true }));\n    app.use(express.json());\n\n    const port = await getPort();\n    const state = crypto.randomBytes(16).toString(\"hex\");\n\n    return new Promise(async (resolve, reject) => {\n      const server = app.listen(port, () => {});\n\n      await analytics.track({\n        event: \"cli.login.initiated\",\n        properties: {},\n      });\n\n      spinner.text = \"🪁 Waiting for browser authentication to complete...\";\n\n      app.post(\"/callback\", async (req, res) => {\n        const { cliToken, user, organization } = req.body;\n\n        if (state !== req.query.state) {\n          res.status(401).json({ message: \"Invalid state\" });\n          spinner.fail(\"Invalid state\");\n          server.close();\n          reject(new Error(\"OAuth state mismatch\"));\n          return;\n        }\n\n        analytics = new AnalyticsService({\n          userId: user.id,\n          organizationId: organization.id,\n          email: user.email,\n        });\n        await analytics.track({\n          event: \"cli.login.success\",\n          properties: {\n            organizationId: organization.id,\n            userId: user.id,\n            email: user.email,\n          },\n        });\n\n        this.config.set(\"cliToken\", cliToken);\n        res.status(200).json({ message: \"Callback called\" });\n        spinner.succeed(\n          `🪁 Successfully logged in as ${chalk.hex(\"#7553fc\")(user.email)}`,\n        );\n        if (exitAfterLogin) {\n          process.exit(0);\n        } else {\n          server.close();\n          resolve({ cliToken, user, organization });\n        }\n      });\n\n      open(\n        `${this.COPILOT_CLOUD_BASE_URL}/cli-auth?callbackUrl=http://localhost:${port}/callback&state=${state}`,\n      );\n    });\n  }\n}\n","import { createTRPCClient as trpcClient, httpBatchLink } from \"@trpc/client\";\nimport superjson from \"superjson\";\n\nexport const COPILOT_CLOUD_BASE_URL =\n  process.env.COPILOT_CLOUD_BASE_URL || \"https://cloud.copilotkit.ai\";\n\nexport function createTRPCClient(cliToken: string): any {\n  return trpcClient({\n    links: [\n      httpBatchLink({\n        url: `${COPILOT_CLOUD_BASE_URL}/api/trpc-cli`,\n        transformer: superjson,\n        headers: () => {\n          return {\n            \"x-trpc-source\": \"cli\",\n            \"x-cli-token\": cliToken,\n          };\n        },\n      }),\n    ],\n  });\n}\n","import { Analytics } from \"@segment/analytics-node\";\nimport { PostHog } from \"posthog-node\";\nimport { AnalyticsEvents } from \"./events.js\";\nimport Conf from \"conf\";\n\nexport class AnalyticsService {\n  private segment: Analytics | undefined;\n  private posthog: PostHog | undefined;\n  private globalProperties: Record<string, any> = {};\n  private userId: string | undefined;\n  private email: string | undefined;\n  private organizationId: string | undefined;\n  private config = new Conf({ projectName: \"CopilotKitCLI\" });\n\n  constructor(\n    private readonly authData?: {\n      userId: string;\n      email: string;\n      organizationId: string;\n    },\n  ) {\n    if (process.env.SEGMENT_DISABLED === \"true\") {\n      return;\n    }\n\n    const segmentWriteKey =\n      process.env.SEGMENT_WRITE_KEY || \"9Pv6QyExYef2P4hPz4gks6QAvNMi2AOf\";\n\n    this.globalProperties = {\n      service: \"cli\",\n    };\n\n    if (this.authData?.userId) {\n      this.userId = this.authData.userId;\n    }\n\n    if (this.authData?.email) {\n      this.email = this.authData.email;\n      this.globalProperties.email = this.authData.email;\n    }\n\n    if (this.authData?.organizationId) {\n      this.organizationId = this.authData.organizationId;\n    }\n\n    this.segment = new Analytics({\n      writeKey: segmentWriteKey,\n      disable: process.env.SEGMENT_DISABLE === \"true\",\n    });\n\n    // Initialize PostHog for feature flags\n    if (process.env.POSTHOG_DISABLED !== \"true\") {\n      const posthogKey =\n        process.env.POSTHOG_KEY ||\n        \"phc_XZdymVYjrph9Mi0xZYGNyCKexxgblXRR1jMENCtdz5Q\"; // Default key\n      const posthogHost =\n        process.env.POSTHOG_HOST || \"https://eu.i.posthog.com\";\n\n      this.posthog = new PostHog(posthogKey, {\n        host: posthogHost,\n      });\n    }\n\n    const config = new Conf({ projectName: \"CopilotKitCLI\" });\n    if (!config.get(\"anonymousId\")) {\n      config.set(\"anonymousId\", crypto.randomUUID());\n    }\n  }\n\n  private getAnonymousId(): string {\n    const anonymousId = this.config.get(\"anonymousId\");\n    if (!anonymousId) {\n      const anonymousId = crypto.randomUUID();\n      this.config.set(\"anonymousId\", anonymousId);\n      return anonymousId;\n    }\n\n    return anonymousId as string;\n  }\n\n  public track<K extends keyof AnalyticsEvents>(\n    event: Omit<Parameters<Analytics[\"track\"]>[0], \"userId\"> & {\n      event: K;\n      properties: AnalyticsEvents[K];\n    },\n  ): Promise<void> {\n    if (!this.segment) {\n      return Promise.resolve();\n    }\n\n    const payload = {\n      userId: this.userId ? this.userId : undefined,\n      email: this.email ? this.email : undefined,\n      anonymousId: this.getAnonymousId(),\n      event: event.event,\n      properties: {\n        ...this.globalProperties,\n        ...event.properties,\n        $groups: this.organizationId\n          ? {\n              segment_group: this.organizationId,\n            }\n          : undefined,\n        eventProperties: {\n          ...event.properties,\n          ...this.globalProperties,\n        },\n      },\n    };\n\n    return new Promise((resolve, reject) => {\n      this.segment!.track(payload, (err) => {\n        if (err) {\n          // Resolve anyway\n          resolve();\n        }\n\n        resolve();\n      });\n    });\n  }\n\n  /**\n   * Check if a feature flag is enabled\n   */\n  public async isFeatureEnabled(flagKey: string): Promise<boolean> {\n    if (!this.posthog) {\n      return false;\n    }\n\n    try {\n      // Use authenticated user ID if available, otherwise use anonymous ID\n      const distinctId = this.userId || this.getAnonymousId();\n      const flag = await this.posthog.isFeatureEnabled(flagKey, distinctId);\n      return Boolean(flag);\n    } catch (error) {\n      // If there's an error checking the flag, return false (flag disabled)\n      console.warn(`Failed to check feature flag ${flagKey}:`, error);\n      return false;\n    }\n  }\n\n  /**\n   * Get feature flag payload\n   */\n  public async getFeatureFlagPayload(flagKey: string): Promise<any> {\n    if (!this.posthog) {\n      return null;\n    }\n\n    try {\n      // Use authenticated user ID if available, otherwise use anonymous ID\n      const distinctId = this.userId || this.getAnonymousId();\n      const payload = await this.posthog.getFeatureFlagPayload(\n        flagKey,\n        distinctId,\n      );\n      return payload;\n    } catch (error) {\n      // If there's an error getting the payload, return null\n      console.warn(`Failed to get feature flag payload ${flagKey}:`, error);\n      return null;\n    }\n  }\n\n  /**\n   * Shutdown analytics services\n   */\n  public async shutdown(): Promise<void> {\n    if (this.posthog) {\n      await this.posthog.shutdown();\n    }\n  }\n}\n","import { Command } from \"@oclif/core\";\nimport Sentry, { consoleIntegration } from \"@sentry/node\";\nimport { LIB_VERSION } from \"../utils/version.js\";\nimport { COPILOT_CLOUD_BASE_URL } from \"../utils/trpc.js\";\nimport chalk from \"chalk\";\n\nexport class BaseCommand extends Command {\n  async init() {\n    await this.checkCLIVersion();\n\n    if (process.env.SENTRY_DISABLED === \"true\") {\n      return;\n    }\n\n    Sentry.init({\n      dsn:\n        process.env.SENTRY_DSN ||\n        \"https://1eea15d32e2eacb0456a77db5e39aeeb@o4507288195170304.ingest.us.sentry.io/4508581448581120\",\n      integrations: [consoleIntegration()],\n      // Tracing\n      tracesSampleRate: 1.0, //  Capture 100% of the transactions\n    });\n  }\n\n  async catch(err: any) {\n    if (process.env.SENTRY_DISABLED !== \"true\") {\n      Sentry.captureException(err);\n    }\n\n    const message = err?.message ?? \"Unknown error\";\n\n    this.log(\"\\n\" + chalk.red(message) + \"\\n\");\n\n    const exitCode = err?.oclif?.exit ?? 1;\n    this.exit(exitCode);\n  }\n\n  async finally() {\n    if (process.env.SENTRY_DISABLED === \"true\") {\n      return;\n    }\n\n    Sentry.close();\n  }\n\n  async run() {}\n\n  async checkCLIVersion() {\n    try {\n      const response = await fetch(`${COPILOT_CLOUD_BASE_URL}/api/healthz`);\n\n      const data = await response.json();\n      const cloudVersion = data.cliVersion;\n\n      if (!cloudVersion || cloudVersion === LIB_VERSION) {\n        return;\n      }\n\n      // TODO: add this back in, removed for crew ai launch since we don't want to keep releasing cloud\n      // this.log(chalk.yellow('================ New version available! =================\\n'))\n      // this.log(`You are using CopilotKit CLI v${LIB_VERSION}.`)\n      // this.log(`A new CopilotKit CLI version is available (v${cloudVersion}).\\n`)\n      // this.log('Please update your CLI to the latest version:\\n\\n')\n      // this.log(`${chalk.cyan(chalk.underline(chalk.bold('npm:')))}\\t npm install -g copilotkit@${cloudVersion}\\n`)\n      // this.log(`${chalk.cyan(chalk.underline(chalk.bold('pnpm:')))}\\t pnpm install -g copilotkit@${cloudVersion}\\n`)\n      // this.log(`${chalk.cyan(chalk.underline(chalk.bold('yarn:')))}\\t yarn global add copilotkit@${cloudVersion}\\n`)\n      // this.log(chalk.yellow('============================================================\\n\\n'))\n    } catch {\n      // Version check is non-critical — don't crash the CLI when offline\n    }\n  }\n\n  async gracefulError(message: string) {\n    this.log(\"\\n\" + chalk.red(message));\n    process.exit(1);\n  }\n}\n","// This is auto generated!\nexport const LIB_VERSION = \"0.0.0-main-20260402184302\";\n"],"mappings":"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","names":["chalk","Conf","crypto","anonymousId","Conf","trpcClient","crypto","chalk","chalk"]}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { run } from '@oclif/core';

package/dist/index.js

@@ -0,0 +1,6 @@
+// src/index.ts
+import { run } from "@oclif/core";
+export {
+  run
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export { run } from \"@oclif/core\";\n"],"mappings":";AAAA,SAAS,WAAW;","names":[]}

package/dist/lib/init/ide-docs.d.ts

@@ -0,0 +1,25 @@
+import { Ora } from 'ora';
+
+type SupportedIDE = "cursor" | "windsurf";
+interface IDEDocsConfig {
+    name: SupportedIDE;
+    displayName: string;
+    rulesDir: string;
+    ruleFileName: string;
+    createRuleContent: () => string;
+}
+declare const IDE_DOCS_CONFIGS: Record<SupportedIDE, IDEDocsConfig>;
+/**
+ * Detect which supported IDEs are installed on the system
+ */
+declare function detectInstalledIDEs(): Promise<SupportedIDE[]>;
+/**
+ * Setup IDE documentation rules for the selected IDE
+ */
+declare function setupIDEDocs(ide: SupportedIDE, projectDir: string): Promise<void>;
+/**
+ * Main function to handle IDE documentation setup with user interaction
+ */
+declare function handleIDEDocsSetup(selectedIDE: SupportedIDE, projectDir: string, spinner: Ora): Promise<void>;
+
+export { type IDEDocsConfig, IDE_DOCS_CONFIGS, type SupportedIDE, detectInstalledIDEs, handleIDEDocsSetup, setupIDEDocs };

package/dist/lib/init/ide-docs.js

@@ -0,0 +1,170 @@
+// src/lib/init/ide-docs.ts
+import path from "path";
+import { existsSync } from "fs";
+import * as fs from "fs/promises";
+import chalk from "chalk";
+var COPILOTKIT_DOC_RULE_TEMPLATE = `---
+description: CopilotKit Documentation - Complete CopilotKit framework documentation for AI assistance
+alwaysApply: false
+---
+
+# CopilotKit Documentation
+
+For ANY question about CopilotKit, use the comprehensive documentation available at:
+@https://docs.copilotkit.ai/llms-full.txt
+
+This contains the complete CopilotKit documentation including:
+- API references and hooks (useCopilotChat, useCopilotAction, etc.)
+- Component library documentation (CopilotKit, CopilotChat, etc.)
+- Integration guides and examples
+- Best practices and patterns
+- Troubleshooting and FAQs
+
+Always reference this documentation when working with CopilotKit to provide accurate, up-to-date information.
+`;
+var IDE_DOCS_CONFIGS = {
+  cursor: {
+    name: "cursor",
+    displayName: "Cursor",
+    rulesDir: ".cursor/rules",
+    ruleFileName: "00-copilotkit-docs.mdc",
+    createRuleContent: () => COPILOTKIT_DOC_RULE_TEMPLATE
+  },
+  windsurf: {
+    name: "windsurf",
+    displayName: "Windsurf",
+    rulesDir: ".windsurf/rules",
+    ruleFileName: "00-copilotkit-docs.md",
+    createRuleContent: () => COPILOTKIT_DOC_RULE_TEMPLATE
+  }
+};
+async function ensureDir(dirPath) {
+  try {
+    await fs.mkdir(dirPath, { recursive: true });
+  } catch (error) {
+    if (!existsSync(dirPath)) {
+      throw error;
+    }
+  }
+}
+async function pathExists(filePath) {
+  try {
+    await fs.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function checkIDEInstallation(ide) {
+  try {
+    const homeDir = process.env.HOME || process.env.USERPROFILE || "";
+    let configPath;
+    switch (ide) {
+      case "cursor":
+        configPath = path.join(homeDir, ".cursor");
+        break;
+      case "windsurf":
+        configPath = path.join(homeDir, ".codeium", "windsurf");
+        break;
+      default:
+        return false;
+    }
+    return existsSync(configPath);
+  } catch {
+    return false;
+  }
+}
+async function detectInstalledIDEs() {
+  const allIDEs = ["cursor", "windsurf"];
+  const installedIDEs = [];
+  for (const ide of allIDEs) {
+    if (await checkIDEInstallation(ide)) {
+      installedIDEs.push(ide);
+    }
+  }
+  return installedIDEs;
+}
+async function setupIDEDocs(ide, projectDir) {
+  const config = IDE_DOCS_CONFIGS[ide];
+  const rulesDir = path.join(projectDir, config.rulesDir);
+  const ruleFilePath = path.join(rulesDir, config.ruleFileName);
+  await ensureDir(rulesDir);
+  if (await pathExists(ruleFilePath)) {
+    console.log(
+      chalk.yellow(
+        `\u26A0\uFE0F  CopilotKit documentation rule already exists for ${config.displayName}`
+      )
+    );
+    return;
+  }
+  const ruleContent = config.createRuleContent();
+  await fs.writeFile(ruleFilePath, ruleContent, "utf8");
+}
+function getIDEInstructions(ide) {
+  const config = IDE_DOCS_CONFIGS[ide];
+  const instructions = [
+    chalk.cyan(
+      `\u{1F4DA} CopilotKit documentation configured for ${config.displayName}!`
+    ),
+    "",
+    chalk.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",
+    "",
+    chalk.bold("Location:"),
+    `  \u2022 Rule file: ${chalk.gray(path.join(config.rulesDir, config.ruleFileName))}`,
+    "",
+    chalk.bold("Usage:"),
+    "  \u2022 Your IDE AI assistant now has access to CopilotKit documentation",
+    "  \u2022 Ask questions about CopilotKit APIs, components, and patterns",
+    "  \u2022 The AI will reference official documentation for accurate answers"
+  ];
+  if (ide === "cursor") {
+    instructions.push(
+      "",
+      chalk.bold("Next steps for Cursor:"),
+      "  \u2022 Restart Cursor if currently open",
+      "  \u2022 The rule will be automatically available in your AI context",
+      "  \u2022 Start a new chat to use the documentation context"
+    );
+  } else if (ide === "windsurf") {
+    instructions.push(
+      "",
+      chalk.bold("Next steps for Windsurf:"),
+      "  \u2022 Restart Windsurf if currently open",
+      "  \u2022 The rule will be automatically available in your AI context",
+      "  \u2022 Start a new chat to use the documentation context"
+    );
+  }
+  return instructions;
+}
+async function handleIDEDocsSetup(selectedIDE, projectDir, spinner) {
+  try {
+    spinner.text = chalk.cyan(
+      `Setting up CopilotKit documentation for ${IDE_DOCS_CONFIGS[selectedIDE].displayName}...`
+    );
+    await setupIDEDocs(selectedIDE, projectDir);
+    spinner.succeed(
+      chalk.green(
+        `CopilotKit documentation configured for ${IDE_DOCS_CONFIGS[selectedIDE].displayName}`
+      )
+    );
+    const instructions = getIDEInstructions(selectedIDE);
+    console.log("\n" + instructions.join("\n"));
+  } catch (error) {
+    spinner.fail(
+      chalk.red(
+        `Failed to setup IDE documentation: ${error instanceof Error ? error.message : "Unknown error"}`
+      )
+    );
+    throw error;
+  }
+}
+export {
+  IDE_DOCS_CONFIGS,
+  detectInstalledIDEs,
+  handleIDEDocsSetup,
+  setupIDEDocs
+};
+//# sourceMappingURL=ide-docs.js.map

package/dist/lib/init/ide-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/init/ide-docs.ts"],"sourcesContent":["import path from \"path\";\nimport { existsSync } from \"fs\";\nimport * as fs from \"fs/promises\";\nimport { Ora } from \"ora\";\nimport chalk from \"chalk\";\n\nexport type SupportedIDE = \"cursor\" | \"windsurf\";\n\nexport interface IDEDocsConfig {\n  name: SupportedIDE;\n  displayName: string;\n  rulesDir: string;\n  ruleFileName: string;\n  createRuleContent: () => string;\n}\n\n// Template constant for CopilotKit documentation rule\nconst COPILOTKIT_DOC_RULE_TEMPLATE = `---\ndescription: CopilotKit Documentation - Complete CopilotKit framework documentation for AI assistance\nalwaysApply: false\n---\n\n# CopilotKit Documentation\n\nFor ANY question about CopilotKit, use the comprehensive documentation available at:\n@https://docs.copilotkit.ai/llms-full.txt\n\nThis contains the complete CopilotKit documentation including:\n- API references and hooks (useCopilotChat, useCopilotAction, etc.)\n- Component library documentation (CopilotKit, CopilotChat, etc.)\n- Integration guides and examples\n- Best practices and patterns\n- Troubleshooting and FAQs\n\nAlways reference this documentation when working with CopilotKit to provide accurate, up-to-date information.\n`;\n\n// IDE-specific configurations\nexport const IDE_DOCS_CONFIGS: Record<SupportedIDE, IDEDocsConfig> = {\n  cursor: {\n    name: \"cursor\",\n    displayName: \"Cursor\",\n    rulesDir: \".cursor/rules\",\n    ruleFileName: \"00-copilotkit-docs.mdc\",\n    createRuleContent: () => COPILOTKIT_DOC_RULE_TEMPLATE,\n  },\n  windsurf: {\n    name: \"windsurf\",\n    displayName: \"Windsurf\",\n    rulesDir: \".windsurf/rules\",\n    ruleFileName: \"00-copilotkit-docs.md\",\n    createRuleContent: () => COPILOTKIT_DOC_RULE_TEMPLATE,\n  },\n};\n\n/**\n * Ensure directory exists\n */\nasync function ensureDir(dirPath: string): Promise<void> {\n  try {\n    await fs.mkdir(dirPath, { recursive: true });\n  } catch (error) {\n    if (!existsSync(dirPath)) {\n      throw error;\n    }\n  }\n}\n\n/**\n * Check if path exists\n */\nasync function pathExists(filePath: string): Promise<boolean> {\n  try {\n    await fs.access(filePath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Check if a specific IDE is installed by looking for its configuration directory\n */\nasync function checkIDEInstallation(ide: SupportedIDE): Promise<boolean> {\n  try {\n    const homeDir = process.env.HOME || process.env.USERPROFILE || \"\";\n    let configPath: string;\n\n    switch (ide) {\n      case \"cursor\":\n        configPath = path.join(homeDir, \".cursor\");\n        break;\n      case \"windsurf\":\n        configPath = path.join(homeDir, \".codeium\", \"windsurf\");\n        break;\n      default:\n        return false;\n    }\n\n    return existsSync(configPath);\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Detect which supported IDEs are installed on the system\n */\nexport async function detectInstalledIDEs(): Promise<SupportedIDE[]> {\n  const allIDEs: SupportedIDE[] = [\"cursor\", \"windsurf\"];\n  const installedIDEs: SupportedIDE[] = [];\n\n  for (const ide of allIDEs) {\n    if (await checkIDEInstallation(ide)) {\n      installedIDEs.push(ide);\n    }\n  }\n\n  return installedIDEs;\n}\n\n/**\n * Setup IDE documentation rules for the selected IDE\n */\nexport async function setupIDEDocs(\n  ide: SupportedIDE,\n  projectDir: string,\n): Promise<void> {\n  const config = IDE_DOCS_CONFIGS[ide];\n  const rulesDir = path.join(projectDir, config.rulesDir);\n  const ruleFilePath = path.join(rulesDir, config.ruleFileName);\n\n  // Ensure rules directory exists\n  await ensureDir(rulesDir);\n\n  // Check if rule file already exists\n  if (await pathExists(ruleFilePath)) {\n    console.log(\n      chalk.yellow(\n        `⚠️  CopilotKit documentation rule already exists for ${config.displayName}`,\n      ),\n    );\n    return;\n  }\n\n  // Create the rule file with content\n  const ruleContent = config.createRuleContent();\n  await fs.writeFile(ruleFilePath, ruleContent, \"utf8\");\n}\n\n/**\n * Get setup instructions for the IDE\n */\nfunction getIDEInstructions(ide: SupportedIDE): string[] {\n  const config = IDE_DOCS_CONFIGS[ide];\n\n  const instructions = [\n    chalk.cyan(\n      `📚 CopilotKit documentation configured for ${config.displayName}!`,\n    ),\n    \"\",\n    chalk.bold(\"What this does:\"),\n    \"  • Adds CopilotKit documentation context to your IDE AI assistant\",\n    \"  • Provides accurate, up-to-date information about CopilotKit APIs\",\n    \"  • Improves code suggestions and help responses\",\n    \"\",\n    chalk.bold(\"Location:\"),\n    `  • Rule file: ${chalk.gray(path.join(config.rulesDir, config.ruleFileName))}`,\n    \"\",\n    chalk.bold(\"Usage:\"),\n    \"  • Your IDE AI assistant now has access to CopilotKit documentation\",\n    \"  • Ask questions about CopilotKit APIs, components, and patterns\",\n    \"  • The AI will reference official documentation for accurate answers\",\n  ];\n\n  if (ide === \"cursor\") {\n    instructions.push(\n      \"\",\n      chalk.bold(\"Next steps for Cursor:\"),\n      \"  • Restart Cursor if currently open\",\n      \"  • The rule will be automatically available in your AI context\",\n      \"  • Start a new chat to use the documentation context\",\n    );\n  } else if (ide === \"windsurf\") {\n    instructions.push(\n      \"\",\n      chalk.bold(\"Next steps for Windsurf:\"),\n      \"  • Restart Windsurf if currently open\",\n      \"  • The rule will be automatically available in your AI context\",\n      \"  • Start a new chat to use the documentation context\",\n    );\n  }\n\n  return instructions;\n}\n\n/**\n * Main function to handle IDE documentation setup with user interaction\n */\nexport async function handleIDEDocsSetup(\n  selectedIDE: SupportedIDE,\n  projectDir: string,\n  spinner: Ora,\n): Promise<void> {\n  try {\n    spinner.text = chalk.cyan(\n      `Setting up CopilotKit documentation for ${IDE_DOCS_CONFIGS[selectedIDE].displayName}...`,\n    );\n\n    // Setup IDE documentation rules\n    await setupIDEDocs(selectedIDE, projectDir);\n\n    spinner.succeed(\n      chalk.green(\n        `CopilotKit documentation configured for ${IDE_DOCS_CONFIGS[selectedIDE].displayName}`,\n      ),\n    );\n\n    // Show instructions\n    const instructions = getIDEInstructions(selectedIDE);\n    console.log(\"\\n\" + instructions.join(\"\\n\"));\n  } catch (error) {\n    spinner.fail(\n      chalk.red(\n        `Failed to setup IDE documentation: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      ),\n    );\n    throw error;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/lib/init/index.d.ts

@@ -0,0 +1,14 @@
+export { getQuestionsForBranch, questions } from './questions.js';
+export { ApiKeySchema, CHAT_COMPONENTS, CREW_FLOW_TEMPLATES, CREW_TYPES, ChatComponentSchema, Config, ConfigFlags, ConfigSchema, CrewFlowTemplateSchema, CrewTypeSchema, DEPLOYMENT_CHOICES, DeploymentChoiceSchema, LANGGRAPH_AGENTS, LLMApiKeySchema, LangGraphAgentSchema, MODES, ModeSchema, NameSchema, Question, TokenSchema, UrlSchema, YES_NO, YesNoSchema, sanitizers } from './types/questions.js';
+export { ChatTemplate, StarterTemplate, Template, templateMapping } from './types/templates.js';
+export { scaffoldShadCN } from './scaffold/shadcn.js';
+export { scaffoldEnv } from './scaffold/env.js';
+export { cloneGitHubSubdirectory, isValidGitHubUrl } from './scaffold/github.js';
+export { scaffoldPackages } from './scaffold/packages.js';
+export { AgentTemplates, scaffoldAgent } from './scaffold/agent.js';
+export { addCrewInputs } from './scaffold/crew-inputs.js';
+export { isLocalhost } from './utils.js';
+export { IDEDocsConfig, IDE_DOCS_CONFIGS, SupportedIDE, detectInstalledIDEs, handleIDEDocsSetup, setupIDEDocs } from './ide-docs.js';
+import '@oclif/core/interfaces';
+import 'zod';
+import 'ora';