copilotkit 0.0.58 → 0.0.59

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) Atai Barkai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/dist/commands/base-command.js

@@ -3,7 +3,7 @@ import { Command } from "@oclif/core";
 import Sentry, { consoleIntegration } from "@sentry/node";
 
 // src/utils/version.ts
-var LIB_VERSION = "0.0.58";
+var LIB_VERSION = "0.0.59";
 
 // src/utils/trpc.ts
 import { createTRPCClient as trpcClient, httpBatchLink } from "@trpc/client";
@@ -44,11 +44,14 @@ var BaseCommand = class extends Command {
   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;
+    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) {

package/dist/commands/base-command.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/commands/base-command.ts","../../src/utils/version.ts","../../src/utils/trpc.ts"],"sourcesContent":["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    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  }\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.58\";\n","import {createTRPCClient as trpcClient, httpBatchLink} from '@trpc/client'\nimport superjson from 'superjson'\n\nexport const COPILOT_CLOUD_BASE_URL = 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"],"mappings":";AAAA,SAAQ,eAAc;AACtB,OAAO,UAAS,0BAAyB;;;ACAlC,IAAM,cAAc;;;ACD3B,SAAQ,oBAAoB,YAAY,qBAAoB;AAC5D,OAAO,eAAe;AAEf,IAAM,yBAAyB,QAAQ,IAAI,0BAA0B;;;AFC5E,OAAO,WAAW;AAEX,IAAM,cAAN,cAA0B,QAAQ;AAAA,EACvC,MAAM,OAAO;AACX,UAAM,KAAK,gBAAgB;AAE3B,QAAI,QAAQ,IAAI,oBAAoB,QAAQ;AAC1C;AAAA,IACF;AAEA,WAAO,KAAK;AAAA,MACV,KACE,QAAQ,IAAI,cACZ;AAAA,MACF,cAAc,CAAC,mBAAmB,CAAC;AAAA;AAAA,MAEnC,kBAAkB;AAAA;AAAA,IACpB,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,MAAM,KAAU;AACpB,QAAI,QAAQ,IAAI,oBAAoB,QAAQ;AAC1C,aAAO,iBAAiB,GAAG;AAAA,IAC7B;AAEA,UAAM,UAAU,KAAK,WAAW;AAEhC,SAAK,IAAI,OAAO,MAAM,IAAI,OAAO,IAAI,IAAI;AAEzC,UAAM,WAAW,KAAK,OAAO,QAAQ;AACrC,SAAK,KAAK,QAAQ;AAAA,EACpB;AAAA,EAEA,MAAM,UAAU;AACd,QAAI,QAAQ,IAAI,oBAAoB,QAAQ;AAC1C;AAAA,IACF;AAEA,WAAO,MAAM;AAAA,EACf;AAAA,EAEA,MAAM,MAAM;AAAA,EAAC;AAAA,EAEb,MAAM,kBAAkB;AACtB,UAAM,WAAW,MAAM,MAAM,GAAG,sBAAsB,cAAc;AAEpE,UAAM,OAAO,MAAM,SAAS,KAAK;AACjC,UAAM,eAAe,KAAK;AAE1B,QAAI,CAAC,gBAAgB,iBAAiB,aAAa;AACjD;AAAA,IACF;AAAA,EAWF;AAAA,EAEA,MAAM,cAAc,SAAiB;AACnC,SAAK,IAAI,OAAO,MAAM,IAAI,OAAO,CAAC;AAClC,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;","names":[]}
+{"version":3,"sources":["../../src/commands/base-command.ts","../../src/utils/version.ts","../../src/utils/trpc.ts"],"sourcesContent":["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.59\";\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"],"mappings":";AAAA,SAAS,eAAe;AACxB,OAAO,UAAU,0BAA0B;;;ACApC,IAAM,cAAc;;;ACD3B,SAAS,oBAAoB,YAAY,qBAAqB;AAC9D,OAAO,eAAe;AAEf,IAAM,yBACX,QAAQ,IAAI,0BAA0B;;;AFAxC,OAAO,WAAW;AAEX,IAAM,cAAN,cAA0B,QAAQ;AAAA,EACvC,MAAM,OAAO;AACX,UAAM,KAAK,gBAAgB;AAE3B,QAAI,QAAQ,IAAI,oBAAoB,QAAQ;AAC1C;AAAA,IACF;AAEA,WAAO,KAAK;AAAA,MACV,KACE,QAAQ,IAAI,cACZ;AAAA,MACF,cAAc,CAAC,mBAAmB,CAAC;AAAA;AAAA,MAEnC,kBAAkB;AAAA;AAAA,IACpB,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,MAAM,KAAU;AACpB,QAAI,QAAQ,IAAI,oBAAoB,QAAQ;AAC1C,aAAO,iBAAiB,GAAG;AAAA,IAC7B;AAEA,UAAM,UAAU,KAAK,WAAW;AAEhC,SAAK,IAAI,OAAO,MAAM,IAAI,OAAO,IAAI,IAAI;AAEzC,UAAM,WAAW,KAAK,OAAO,QAAQ;AACrC,SAAK,KAAK,QAAQ;AAAA,EACpB;AAAA,EAEA,MAAM,UAAU;AACd,QAAI,QAAQ,IAAI,oBAAoB,QAAQ;AAC1C;AAAA,IACF;AAEA,WAAO,MAAM;AAAA,EACf;AAAA,EAEA,MAAM,MAAM;AAAA,EAAC;AAAA,EAEb,MAAM,kBAAkB;AACtB,QAAI;AACF,YAAM,WAAW,MAAM,MAAM,GAAG,sBAAsB,cAAc;AAEpE,YAAM,OAAO,MAAM,SAAS,KAAK;AACjC,YAAM,eAAe,KAAK;AAE1B,UAAI,CAAC,gBAAgB,iBAAiB,aAAa;AACjD;AAAA,MACF;AAAA,IAWF,QAAQ;AAAA,IAER;AAAA,EACF;AAAA,EAEA,MAAM,cAAc,SAAiB;AACnC,SAAK,IAAI,OAAO,MAAM,IAAI,OAAO,CAAC;AAClC,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;","names":[]}

package/dist/commands/create.d.ts

@@ -8,7 +8,7 @@ declare class Create extends BaseCommand {
     static flags: {
         framework: _oclif_core_interfaces.OptionFlag<string | undefined, _oclif_core_interfaces.CustomOptions>;
         name: _oclif_core_interfaces.OptionFlag<string | undefined, _oclif_core_interfaces.CustomOptions>;
-        'no-banner': _oclif_core_interfaces.BooleanFlag<boolean>;
+        "no-banner": _oclif_core_interfaces.BooleanFlag<boolean>;
         project: _oclif_core_interfaces.OptionFlag<string | undefined, _oclif_core_interfaces.CustomOptions>;
     };
     static args: {

package/dist/commands/create.js

@@ -1,9 +1,9 @@
 // src/commands/create.ts
 import { Flags, Args } from "@oclif/core";
 import inquirer from "inquirer";
-import chalk2 from "chalk";
-import fs from "fs-extra";
-import path from "path";
+import chalk3 from "chalk";
+import fs2 from "fs-extra";
+import path2 from "path";
 import { promisify } from "util";
 import { pipeline } from "stream";
 import { createWriteStream } from "fs";
@@ -15,7 +15,7 @@ import { Command } from "@oclif/core";
 import Sentry, { consoleIntegration } from "@sentry/node";
 
 // src/utils/version.ts
-var LIB_VERSION = "0.0.58";
+var LIB_VERSION = "0.0.59";
 
 // src/utils/trpc.ts
 import { createTRPCClient as trpcClient, httpBatchLink } from "@trpc/client";
@@ -56,11 +56,14 @@ var BaseCommand = class extends Command {
   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;
+    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) {
@@ -69,34 +72,144 @@ var BaseCommand = class extends Command {
   }
 };
 
+// src/lib/init/scaffold/github.ts
+import { execSync } from "child_process";
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+import chalk2 from "chalk";
+async function cloneGitHubSubdirectory(githubUrl, destinationPath, spinner) {
+  try {
+    const { owner, repo, branch, subdirectoryPath } = parseGitHubUrl(githubUrl);
+    spinner.text = chalk2.cyan(`Cloning from ${owner}/${repo}...`);
+    return await sparseCheckout(
+      owner,
+      repo,
+      branch,
+      subdirectoryPath,
+      destinationPath,
+      spinner
+    );
+  } catch (error) {
+    spinner.text = chalk2.red(`Failed to clone from GitHub: ${error}`);
+    return false;
+  }
+}
+async function sparseCheckout(owner, repo, branch, subdirectoryPath, destinationPath, spinner) {
+  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "copilotkit-sparse-"));
+  try {
+    spinner.text = chalk2.cyan("Creating temporary workspace...");
+    execSync("git init", { cwd: tempDir, stdio: "pipe" });
+    spinner.text = chalk2.cyan("Connecting to repository...");
+    execSync(`git remote add origin https://github.com/${owner}/${repo}.git`, {
+      cwd: tempDir,
+      stdio: "pipe"
+    });
+    execSync("git config core.sparseCheckout true", {
+      cwd: tempDir,
+      stdio: "pipe"
+    });
+    fs.writeFileSync(
+      path.join(tempDir, ".git/info/sparse-checkout"),
+      subdirectoryPath
+    );
+    spinner.text = chalk2.cyan("Downloading agent files...");
+    execSync(`git pull origin ${branch} --depth=1`, {
+      cwd: tempDir,
+      stdio: "pipe"
+    });
+    const sourcePath = path.join(tempDir, subdirectoryPath);
+    if (!fs.existsSync(sourcePath)) {
+      throw new Error(
+        `Subdirectory '${subdirectoryPath}' not found in the repository.`
+      );
+    }
+    fs.mkdirSync(destinationPath, { recursive: true });
+    spinner.text = chalk2.cyan("Installing agent files...");
+    await copyDirectoryAsync(sourcePath, destinationPath);
+    return true;
+  } finally {
+    try {
+      fs.rmSync(tempDir, { recursive: true, force: true });
+    } catch (error) {
+      console.warn(`Failed to clean up temporary directory: ${error}`);
+    }
+  }
+}
+async function copyDirectoryAsync(source, destination) {
+  if (!fs.existsSync(destination)) {
+    fs.mkdirSync(destination, { recursive: true });
+  }
+  const entries = fs.readdirSync(source, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(source, entry.name);
+    const destPath = path.join(destination, entry.name);
+    if (entry.isDirectory()) {
+      await copyDirectoryAsync(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+    if (entries.length > 10) {
+      await new Promise((resolve) => setTimeout(resolve, 1));
+    }
+  }
+}
+function parseGitHubUrl(githubUrl) {
+  const url = new URL(githubUrl);
+  if (url.hostname !== "github.com") {
+    throw new Error("Only GitHub URLs are supported");
+  }
+  const pathParts = url.pathname.split("/").filter(Boolean);
+  if (pathParts.length < 2) {
+    throw new Error("Invalid GitHub URL format");
+  }
+  const owner = pathParts[0];
+  const repo = pathParts[1];
+  let branch = "main";
+  let subdirectoryPath = "";
+  if (pathParts.length > 3 && (pathParts[2] === "tree" || pathParts[2] === "blob")) {
+    branch = pathParts[3];
+    subdirectoryPath = pathParts.slice(4).join("/");
+  }
+  return { owner, repo, branch, subdirectoryPath };
+}
+function isValidGitHubUrl(url) {
+  try {
+    const parsedUrl = new URL(url);
+    return parsedUrl.hostname === "github.com" && parsedUrl.pathname.split("/").filter(Boolean).length >= 2;
+  } catch {
+    return false;
+  }
+}
+
 // src/commands/create.ts
 var streamPipeline = promisify(pipeline);
 var theme = {
-  primary: chalk2.magenta,
-  secondary: chalk2.gray,
-  tertiary: chalk2.gray,
-  error: chalk2.red,
-  command: chalk2.blue,
-  success: chalk2.green,
-  warning: chalk2.yellow,
-  divider: chalk2.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",
-  "pydantic-ai": "copilotkit/with-pydantic-ai",
+  "langgraph-py": "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/langgraph-python",
+  "langgraph-js": "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/langgraph-js",
+  mastra: "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/mastra",
+  flows: "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/crewai-flows",
+  llamaindex: "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/llamaindex",
+  agno: "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/agno",
+  "pydantic-ai": "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/pydantic-ai",
   ag2: "ag2ai/ag2-copilotkit-starter",
-  adk: "copilotkit/with-adk",
-  "aws-strands-py": "copilotkit/with-strands-python",
-  a2a: "copilotkit/with-a2a-middleware",
-  "microsoft-agent-framework-dotnet": "copilotkit/with-microsoft-agent-framework-dotnet",
-  "microsoft-agent-framework-py": "copilotkit/with-microsoft-agent-framework-python",
-  "mcp-apps": "copilotkit/with-mcp-apps"
+  adk: "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/adk",
+  "aws-strands-py": "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/strands-python",
+  a2a: "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/a2a-middleware",
+  "microsoft-agent-framework-dotnet": "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/ms-agent-framework-dotnet",
+  "microsoft-agent-framework-py": "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/ms-agent-framework-python",
+  "mcp-apps": "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/mcp-apps"
 };
 var FRAMEWORK_DOCUMENTATION = {
   "langgraph-py": "https://langchain-ai.github.io/langgraph/concepts/why-langgraph",
@@ -192,30 +305,42 @@ var Create = class _Create extends BaseCommand {
       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"));
+      if (!flags.name && !args.projectName && !flags.framework) {
+        this.log(
+          "\n" + theme.secondary("Just a few questions to get started!\n")
+        );
       }
     }
     const projectNameInput = flags.name || args.projectName || await this.promptProjectName();
     const projectName = projectNameInput.trim();
     const usingCurrentDir = projectName === "." || projectName === "./";
     const agentFramework = flags.framework || await this.promptAgentFramework();
-    const projectDir = usingCurrentDir ? process.cwd() : path.resolve(process.cwd(), projectName);
+    const projectDir = usingCurrentDir ? process.cwd() : path2.resolve(process.cwd(), projectName);
     if (usingCurrentDir) {
       const allowedEntries = /* @__PURE__ */ new Set([".git", ".gitignore", ".DS_Store"]);
-      const existingEntries = await fs.readdir(projectDir);
-      const blockingEntries = existingEntries.filter((entry) => !allowedEntries.has(entry));
+      const existingEntries = await fs2.readdir(projectDir);
+      const blockingEntries = existingEntries.filter(
+        (entry) => !allowedEntries.has(entry)
+      );
       if (blockingEntries.length > 0) {
         this.log(theme.error("\nCurrent directory is not empty."));
-        this.log(theme.secondary("\nPlease run create in an empty directory or specify a new project name."));
+        this.log(
+          theme.secondary(
+            "\nPlease run create in an empty directory or specify a new project name."
+          )
+        );
         this.exit(1);
       }
-    } else if (await fs.pathExists(projectDir)) {
+    } else if (await fs2.pathExists(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.log(
+        theme.secondary(
+          "  2. Remove the existing directory manually if you want to use this name\n"
+        )
+      );
       this.exit(1);
     }
     const options = {
@@ -228,11 +353,13 @@ Directory "${projectName}" already exists.`));
       spinner: "dots"
     }).start();
     try {
-      await fs.ensureDir(projectDir);
+      await fs2.ensureDir(projectDir);
       spinner.text = theme.secondary.bold("Downloading template...");
-      await this.downloadTemplate(projectDir, options.agentFramework);
+      await this.downloadTemplate(projectDir, options.agentFramework, spinner);
       const displayName = usingCurrentDir ? "current directory" : `"${projectName}"`;
-      spinner.succeed(theme.secondary.bold(`Project ${displayName} created successfully!`));
+      spinner.succeed(
+        theme.secondary.bold(`Project ${displayName} created successfully!`)
+      );
     } catch (error) {
       spinner.fail(theme.error(`Failed to create project: ${error.message}`));
       this.exit(1);
@@ -247,14 +374,24 @@ Your project is ready to explore CopilotKit locally.`
     );
     this.log("\n" + theme.secondary("Next steps:"));
     if (usingCurrentDir) {
-      this.log(theme.secondary("  \u2022 You are already inside your new project directory"));
+      this.log(
+        theme.secondary(
+          "  \u2022 You are already inside your new project directory"
+        )
+      );
     } else {
       this.log(theme.secondary(`  \u2022 ${theme.command(`cd ${projectName}`)}`));
     }
-    this.log(theme.secondary("  \u2022 Follow the setup instructions in the README.md"));
+    this.log(
+      theme.secondary("  \u2022 Follow the setup instructions in the README.md")
+    );
     this.log("\n" + theme.secondary("Documentation:"));
-    this.log(theme.secondary("  \u2022 ") + theme.command("https://docs.copilotkit.ai"));
-    this.log(theme.secondary("  \u2022 ") + theme.command(FRAMEWORK_DOCUMENTATION[options.agentFramework]));
+    this.log(
+      theme.secondary("  \u2022 ") + theme.command("https://docs.copilotkit.ai")
+    );
+    this.log(
+      theme.secondary("  \u2022 ") + theme.command(FRAMEWORK_DOCUMENTATION[options.agentFramework])
+    );
     this.log(theme.bottomPadding);
   }
   async promptProjectName() {
@@ -266,7 +403,9 @@ Your project is ready to explore CopilotKit locally.`
         validate: (input) => {
           if (!input) return theme.error("Project name is required");
           if (!/^[a-z0-9-]+$/.test(input)) {
-            return theme.error("Project name can only contain lowercase letters, numbers, and hyphens");
+            return theme.error(
+              "Project name can only contain lowercase letters, numbers, and hyphens"
+            );
           }
           if (input.length > 30) {
             return theme.error("Project name must be less than 30 characters");
@@ -282,13 +421,27 @@ Your project is ready to explore CopilotKit locally.`
       {
         type: "list",
         name: "framework",
-        message: theme.secondary("Which agent framework would you like to use?"),
+        message: theme.secondary(
+          "Which agent framework would you like to use?"
+        ),
         choices: [
-          { name: `${FRAMEWORK_EMOJI["langgraph-py"]} LangGraph (Python)`, value: "langgraph-py" },
-          { name: `${FRAMEWORK_EMOJI["langgraph-js"]} LangGraph (JavaScript)`, value: "langgraph-js" },
+          {
+            name: `${FRAMEWORK_EMOJI["langgraph-py"]} LangGraph (Python)`,
+            value: "langgraph-py"
+          },
+          {
+            name: `${FRAMEWORK_EMOJI["langgraph-js"]} LangGraph (JavaScript)`,
+            value: "langgraph-js"
+          },
           { name: `${FRAMEWORK_EMOJI.mastra} Mastra`, value: "mastra" },
-          { name: `${FRAMEWORK_EMOJI["pydantic-ai"]} Pydantic AI`, value: "pydantic-ai" },
-          { name: `${FRAMEWORK_EMOJI["aws-strands-py"]} AWS Strands (Python)`, value: "aws-strands-py" },
+          {
+            name: `${FRAMEWORK_EMOJI["pydantic-ai"]} Pydantic AI`,
+            value: "pydantic-ai"
+          },
+          {
+            name: `${FRAMEWORK_EMOJI["aws-strands-py"]} AWS Strands (Python)`,
+            value: "aws-strands-py"
+          },
           { name: `${FRAMEWORK_EMOJI.adk} ADK`, value: "adk" },
           {
             name: `${FRAMEWORK_EMOJI["microsoft-agent-framework-dotnet"]} Microsoft Agent Framework (.NET)`,
@@ -298,9 +451,15 @@ Your project is ready to explore CopilotKit locally.`
             name: `${FRAMEWORK_EMOJI["microsoft-agent-framework-py"]} Microsoft Agent Framework (Python)`,
             value: "microsoft-agent-framework-py"
           },
-          { name: `${FRAMEWORK_EMOJI["mcp-apps"]} MCP Apps`, value: "mcp-apps" },
+          {
+            name: `${FRAMEWORK_EMOJI["mcp-apps"]} MCP Apps`,
+            value: "mcp-apps"
+          },
           { name: `${FRAMEWORK_EMOJI.flows} CrewAI Flows`, value: "flows" },
-          { name: `${FRAMEWORK_EMOJI.llamaindex} LlamaIndex`, value: "llamaindex" },
+          {
+            name: `${FRAMEWORK_EMOJI.llamaindex} LlamaIndex`,
+            value: "llamaindex"
+          },
           { name: `${FRAMEWORK_EMOJI.agno}  Agno`, value: "agno" },
           { name: `${FRAMEWORK_EMOJI.ag2} AG2`, value: "ag2" },
           { name: `${FRAMEWORK_EMOJI.a2a} A2A`, value: "a2a" }
@@ -309,13 +468,25 @@ Your project is ready to explore CopilotKit locally.`
     ]);
     return framework;
   }
-  async downloadTemplate(projectDir, framework) {
-    const repo = TEMPLATE_REPOS[framework];
-    const url = `https://github.com/${repo}/archive/refs/heads/main.tar.gz`;
+  async downloadTemplate(projectDir, framework, spinner) {
+    const templateRef = TEMPLATE_REPOS[framework];
+    if (isValidGitHubUrl(templateRef)) {
+      const success = await cloneGitHubSubdirectory(
+        templateRef,
+        projectDir,
+        spinner
+      );
+      if (!success) {
+        throw new Error(`Failed to clone template from ${templateRef}`);
+      }
+      return;
+    }
+    const url = `https://github.com/${templateRef}/archive/refs/heads/main.tar.gz`;
     try {
       const response = await fetch(url);
-      if (!response.ok) throw new Error(`Failed to download template: ${response.statusText}`);
-      const tempFile = path.join(projectDir, "template.tar.gz");
+      if (!response.ok)
+        throw new Error(`Failed to download template: ${response.statusText}`);
+      const tempFile = path2.join(projectDir, "template.tar.gz");
       const fileStream = createWriteStream(tempFile);
       if (!response.body) throw new Error("Failed to get response body");
       await streamPipeline(response.body, fileStream);
@@ -324,7 +495,7 @@ Your project is ready to explore CopilotKit locally.`
         cwd: projectDir,
         strip: 1
       });
-      await fs.remove(tempFile);
+      await fs2.remove(tempFile);
     } catch (error) {
       throw new Error(`Failed to download template: ${error.message}`);
     }