create-spatius-app 0.1.2 → 0.1.3-beta.2

package/dist/cli.js

@@ -40,6 +40,103 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
+// src/errors.ts
+function normalizeError(error) {
+  if (error instanceof CliError) {
+    return error;
+  }
+  if (error instanceof Error && error.message.trim() !== "") {
+    return new CliError("UNKNOWN_ERROR", error.message);
+  }
+  return new CliError(
+    "UNKNOWN_ERROR",
+    "An unexpected error occurred while creating the project."
+  );
+}
+var EXIT_CODES, CliError, PromptCancelledError;
+var init_errors = __esm({
+  "src/errors.ts"() {
+    "use strict";
+    EXIT_CODES = {
+      cancelled: 130,
+      filesystem: 4,
+      general: 1,
+      invalidArgument: 2,
+      success: 0,
+      targetConflict: 3
+    };
+    CliError = class extends Error {
+      code;
+      exitCode;
+      path;
+      recovery;
+      constructor(code, message, { exitCode = EXIT_CODES.general, path: path2, recovery } = {}) {
+        super(message);
+        this.name = "CliError";
+        this.code = code;
+        this.exitCode = exitCode;
+        this.path = path2;
+        this.recovery = recovery;
+      }
+    };
+    PromptCancelledError = class extends CliError {
+      constructor(message = "Project creation was cancelled.") {
+        super("CANCELLED", message, {
+          exitCode: EXIT_CODES.cancelled,
+          recovery: "Run the command again when you are ready."
+        });
+        this.name = "PromptCancelledError";
+      }
+    };
+  }
+});
+
+// src/catalog.ts
+function validateSelection(stack) {
+  if (!Object.hasOwn(stacks, stack)) {
+    throw new CliError("INVALID_ARGUMENT", `Unsupported stack: ${stack}`, {
+      exitCode: EXIT_CODES.invalidArgument
+    });
+  }
+  return { stack };
+}
+async function selectCatalog(options) {
+  if (options.stack !== void 0) return validateSelection(options.stack);
+  const choices = Object.entries(stacks).map(([value, stack]) => ({
+    value,
+    label: stack.label
+  }));
+  return validateSelection(
+    options.interactive ? await options.prompts.choose(
+      "Which voice AI provider?",
+      choices,
+      DEFAULT_STACK
+    ) : DEFAULT_STACK
+  );
+}
+var stacks, DEFAULT_STACK;
+var init_catalog = __esm({
+  "src/catalog.ts"() {
+    "use strict";
+    init_errors();
+    stacks = {
+      "cloudflare-livekit": {
+        label: "LiveKit",
+        web: "cloudflare",
+        agent: "livekit",
+        provider: "livekit"
+      },
+      "cloudflare-agora": {
+        label: "Agora Conversational AI",
+        web: "cloudflare",
+        agent: "agora",
+        provider: "agora"
+      }
+    };
+    DEFAULT_STACK = "cloudflare-livekit";
+  }
+});
+
 // node_modules/.pnpm/sisteransi@1.0.5/node_modules/sisteransi/src/index.js
 var require_src = __commonJS({
   "node_modules/.pnpm/sisteransi@1.0.5/node_modules/sisteransi/src/index.js"(exports, module) {
@@ -123,7 +220,7 @@ var require_dist = __commonJS({
       determineAgent: () => determineAgent2
     });
     module.exports = __toCommonJS(src_exports);
-    var import_promises9 = __require("fs/promises");
+    var import_promises13 = __require("fs/promises");
     var import_node_fs4 = __require("fs");
     var DEVIN_LOCAL_PATH = "/opt/.devin";
     var CURSOR = "cursor";
@@ -211,7 +308,7 @@ var require_dist = __commonJS({
         return { isAgent: true, agent: { name: GITHUB_COPILOT } };
       }
       try {
-        await (0, import_promises9.access)(DEVIN_LOCAL_PATH, import_node_fs4.constants.F_OK);
+        await (0, import_promises13.access)(DEVIN_LOCAL_PATH, import_node_fs4.constants.F_OK);
         return { isAgent: true, agent: { name: DEVIN } };
       } catch (_error) {
       }
@@ -220,57 +317,6 @@ var require_dist = __commonJS({
   }
 });
 
-// src/errors.ts
-function normalizeError(error) {
-  if (error instanceof CliError) {
-    return error;
-  }
-  if (error instanceof Error && error.message.trim() !== "") {
-    return new CliError("UNKNOWN_ERROR", error.message);
-  }
-  return new CliError(
-    "UNKNOWN_ERROR",
-    "An unexpected error occurred while creating the project."
-  );
-}
-var EXIT_CODES, CliError, PromptCancelledError;
-var init_errors = __esm({
-  "src/errors.ts"() {
-    "use strict";
-    EXIT_CODES = {
-      cancelled: 130,
-      filesystem: 4,
-      general: 1,
-      invalidArgument: 2,
-      success: 0,
-      targetConflict: 3
-    };
-    CliError = class extends Error {
-      code;
-      exitCode;
-      path;
-      recovery;
-      constructor(code, message, { exitCode = EXIT_CODES.general, path: path2, recovery } = {}) {
-        super(message);
-        this.name = "CliError";
-        this.code = code;
-        this.exitCode = exitCode;
-        this.path = path2;
-        this.recovery = recovery;
-      }
-    };
-    PromptCancelledError = class extends CliError {
-      constructor(message = "Project creation was cancelled.") {
-        super("CANCELLED", message, {
-          exitCode: EXIT_CODES.cancelled,
-          recovery: "Run the command again when you are ready."
-        });
-        this.name = "PromptCancelledError";
-      }
-    };
-  }
-});
-
 // src/package-managers.ts
 import { execFile, spawn } from "child_process";
 function requiresWindowsCommandShell(command, platform = process.platform) {
@@ -531,7 +577,7 @@ function selectPythonPackageManager(inventory, explicit, platform = process.plat
 }
 function assertPackageManagersAvailable(packageManagers) {
   const unavailable = [packageManagers.javascript, packageManagers.python].find(
-    (manager) => !manager.available
+    (manager) => manager !== void 0 && !manager.available
   );
   if (unavailable !== void 0) {
     throw new CliError(
@@ -571,24 +617,74 @@ var init_package_managers = __esm({
   }
 });
 
-// src/setup/project.ts
-import { lstat } from "fs/promises";
+// src/project-config.ts
+import { lstat, readFile } from "fs/promises";
 import { join as join2 } from "path";
+async function readProjectConfig(directory) {
+  const path2 = join2(directory, "spatius.config.json");
+  try {
+    const stats = await lstat(path2);
+    if (!stats.isFile() || stats.isSymbolicLink())
+      throw new Error("Expected a regular file");
+    const value = JSON.parse(await readFile(path2, "utf8"));
+    if (value && typeof value === "object" && "version" in value && value.version !== 2)
+      throw new CliError(
+        "INVALID_ARGUMENT",
+        "Unsupported spatius.config.json version. Expected version 2.",
+        { path: path2, exitCode: EXIT_CODES.invalidArgument }
+      );
+    if (!value || typeof value !== "object" || !("version" in value) || value.version !== 2 || !("stack" in value) || typeof value.stack !== "string")
+      throw new Error("Unsupported project configuration");
+    return { version: 2, ...validateSelection(value.stack) };
+  } catch (error) {
+    if (error instanceof CliError) throw error;
+    if (error instanceof Error && "code" in error && error.code === "ENOENT")
+      return void 0;
+    throw new CliError("INVALID_ARGUMENT", "Invalid spatius.config.json.", {
+      path: path2,
+      exitCode: EXIT_CODES.invalidArgument
+    });
+  }
+}
+async function webEnvironmentPath(directory) {
+  await readProjectConfig(directory);
+  return ".dev.vars";
+}
+var init_project_config = __esm({
+  "src/project-config.ts"() {
+    "use strict";
+    init_catalog();
+    init_errors();
+  }
+});
+
+// src/setup/project.ts
+import { lstat as lstat2 } from "fs/promises";
+import { join as join4 } from "path";
 async function assertSpatiusProject(targetDirectory) {
   try {
-    const target = await lstat(targetDirectory);
+    const target = await lstat2(targetDirectory);
     if (!target.isDirectory() || target.isSymbolicLink()) {
       throw new Error("not a regular directory");
     }
+    const config = await readProjectConfig(targetDirectory);
+    const paths = config ? [
+      "package.json",
+      "spatius.config.json",
+      await webEnvironmentPath(targetDirectory) + ".example",
+      "worker/index.ts",
+      "agent/src/agent.py",
+      "agent/.env.example"
+    ] : requiredProjectPaths;
     await Promise.all([
       ...requiredProjectDirectories.map(async (relativePath) => {
-        const stats = await lstat(join2(targetDirectory, relativePath));
+        const stats = await lstat2(join4(targetDirectory, relativePath));
         if (!stats.isDirectory() || stats.isSymbolicLink()) {
           throw new Error(`${relativePath} is not a regular directory`);
         }
       }),
-      ...requiredProjectPaths.map(async (relativePath) => {
-        const stats = await lstat(join2(targetDirectory, relativePath));
+      ...paths.map(async (relativePath) => {
+        const stats = await lstat2(join4(targetDirectory, relativePath));
         if (!stats.isFile() || stats.isSymbolicLink()) {
           throw new Error(`${relativePath} is not a regular file`);
         }
@@ -610,6 +706,7 @@ var requiredProjectPaths, requiredProjectDirectories;
 var init_project = __esm({
   "src/setup/project.ts"() {
     "use strict";
+    init_project_config();
     init_errors();
     requiredProjectPaths = [
       "package.json",
@@ -648,14 +745,14 @@ var init_voices = __esm({
 // src/setup/environment.ts
 import {
   chmod,
-  lstat as lstat2,
-  readFile as readFile2,
+  lstat as lstat3,
+  readFile as readFile3,
   rename,
   rm,
   writeFile as writeFile2
 } from "fs/promises";
 import { randomUUID as randomUUID2 } from "crypto";
-import { join as join4 } from "path";
+import { join as join5 } from "path";
 function parseQuotedValue(rawValue) {
   const value = rawValue.trim();
   if (value.startsWith('"')) {
@@ -810,7 +907,7 @@ function isMissingFile(error) {
 }
 async function readOptionalCredentialFile(path2) {
   try {
-    const stats = await lstat2(path2);
+    const stats = await lstat3(path2);
     if (stats.isSymbolicLink() || !stats.isFile()) {
       throw new CliError(
         "FILESYSTEM_ERROR",
@@ -822,7 +919,7 @@ async function readOptionalCredentialFile(path2) {
         }
       );
     }
-    return await readFile2(path2, "utf8");
+    return await readFile3(path2, "utf8");
   } catch (error) {
     if (isMissingFile(error)) {
       return void 0;
@@ -831,10 +928,11 @@ async function readOptionalCredentialFile(path2) {
   }
 }
 async function readCredentialFileState(targetDirectory) {
+  const webPath = await webEnvironmentPath(targetDirectory);
   const [worker, agent, workerExample] = await Promise.all([
-    readOptionalCredentialFile(join4(targetDirectory, ".dev.vars")),
-    readOptionalCredentialFile(join4(targetDirectory, "agent", ".env.local")),
-    readOptionalCredentialFile(join4(targetDirectory, ".dev.vars.example"))
+    readOptionalCredentialFile(join5(targetDirectory, webPath)),
+    readOptionalCredentialFile(join5(targetDirectory, "agent", ".env.local")),
+    readOptionalCredentialFile(join5(targetDirectory, webPath + ".example"))
   ]);
   return {
     agent,
@@ -906,23 +1004,24 @@ async function pathExists(path2, fileSystem) {
   }
 }
 async function writeCredentialFilesAtomically(targetDirectory, contents, fileSystem = defaultAtomicFileSystem) {
+  const webPath = await webEnvironmentPath(targetDirectory);
   const nonce = randomUUID2();
   const targets = [
     {
       backupMoved: false,
-      backupPath: join4(targetDirectory, `.dev.vars.${nonce}.backup`),
-      destinationPath: join4(targetDirectory, ".dev.vars"),
+      backupPath: join5(targetDirectory, `.dev.vars.${nonce}.backup`),
+      destinationPath: join5(targetDirectory, webPath),
       hadOriginal: false,
       installed: false,
-      stagedPath: join4(targetDirectory, `.dev.vars.${nonce}.tmp`)
+      stagedPath: join5(targetDirectory, `.dev.vars.${nonce}.tmp`)
     },
     {
       backupMoved: false,
-      backupPath: join4(targetDirectory, "agent", `.env.local.${nonce}.backup`),
-      destinationPath: join4(targetDirectory, "agent", ".env.local"),
+      backupPath: join5(targetDirectory, "agent", `.env.local.${nonce}.backup`),
+      destinationPath: join5(targetDirectory, "agent", ".env.local"),
       hadOriginal: false,
       installed: false,
-      stagedPath: join4(targetDirectory, "agent", `.env.local.${nonce}.tmp`)
+      stagedPath: join5(targetDirectory, "agent", `.env.local.${nonce}.tmp`)
     }
   ];
   const payloads = [contents.worker, contents.agent];
@@ -983,9 +1082,10 @@ async function writeCredentialFilesAtomically(targetDirectory, contents, fileSys
   }
 }
 async function readCredentialExamples(targetDirectory) {
+  const webPath = await webEnvironmentPath(targetDirectory);
   const [worker, agent] = await Promise.all([
-    readFile2(join4(targetDirectory, ".dev.vars.example"), "utf8"),
-    readFile2(join4(targetDirectory, "agent", ".env.example"), "utf8")
+    readFile3(join5(targetDirectory, webPath + ".example"), "utf8"),
+    readFile3(join5(targetDirectory, "agent", ".env.example"), "utf8")
   ]);
   return { agent, worker };
 }
@@ -993,6 +1093,7 @@ var WORKER_MANAGED_KEYS, AGENT_MANAGED_KEYS, assignmentPattern, defaultAtomicFil
 var init_environment = __esm({
   "src/setup/environment.ts"() {
     "use strict";
+    init_project_config();
     init_errors();
     WORKER_MANAGED_KEYS = [
       "LIVEKIT_URL",
@@ -1012,8 +1113,8 @@ var init_environment = __esm({
     assignmentPattern = /^\s*(?:export\s+)?([A-Za-z_][A-Za-z\d_]*)\s*=\s*(.*)$/u;
     defaultAtomicFileSystem = {
       chmod,
-      lstat: lstat2,
-      readFile: (path2) => readFile2(path2),
+      lstat: lstat3,
+      readFile: (path2) => readFile3(path2),
       rename,
       rm: (path2) => rm(path2, { force: true }),
       writeFile: writeFile2
@@ -8351,12 +8452,12 @@ var require_dist2 = __commonJS({
 // src/setup/livekit.ts
 import { createHmac } from "crypto";
 import { spawn as spawn2 } from "child_process";
-import { chmod as chmod2, mkdtemp, readFile as readFile3, rm as rm2, writeFile as writeFile3 } from "fs/promises";
+import { chmod as chmod2, mkdtemp, readFile as readFile4, rm as rm2, writeFile as writeFile3 } from "fs/promises";
 import { homedir, tmpdir } from "os";
-import { join as join5 } from "path";
-async function readLiveKitProjects(configPath = join5(homedir(), ".livekit", "cli-config.yaml")) {
+import { join as join6 } from "path";
+async function readLiveKitProjects(configPath = join6(homedir(), ".livekit", "cli-config.yaml")) {
   try {
-    const config = (0, import_yaml.parse)(await readFile3(configPath, "utf8"));
+    const config = (0, import_yaml.parse)(await readFile4(configPath, "utf8"));
     if (config == null) return [];
     if (typeof config !== "object" || !("projects" in config) || !Array.isArray(config.projects))
       throw new Error();
@@ -8519,12 +8620,12 @@ async function loadLiveKitCredentialsWithCli({
   projectName
 } = {}) {
   const directory = await fileSystem.mkdtemp(
-    join5(temporaryRoot, "create-spatius-app-livekit-")
+    join6(temporaryRoot, "create-spatius-app-livekit-")
   );
   try {
     await fileSystem.chmod(directory, 448);
     await fileSystem.writeFile(
-      join5(directory, ".env.example"),
+      join6(directory, ".env.example"),
       "LIVEKIT_URL=\nLIVEKIT_API_KEY=\nLIVEKIT_API_SECRET=\n",
       384
     );
@@ -8543,7 +8644,7 @@ async function loadLiveKitCredentialsWithCli({
       }
     );
     const values = parseDotenv(
-      await fileSystem.readFile(join5(directory, ".env.local"))
+      await fileSystem.readFile(join6(directory, ".env.local"))
     );
     const validated = validateCredentialBundle({
       liveKit: {
@@ -8643,7 +8744,7 @@ var init_livekit = __esm({
     defaultTemporaryFileSystem = {
       chmod: chmod2,
       mkdtemp,
-      readFile: (path2) => readFile3(path2, "utf8"),
+      readFile: (path2) => readFile4(path2, "utf8"),
       remove: (path2) => rm2(path2, {
         force: true,
         maxRetries: 3,
@@ -10094,7 +10195,7 @@ async function runCredentialSetup({
   const examples = await readExamples(targetDirectory);
   const rendered = buildCredentialFileContents(state, examples, credentials);
   await writeFiles(targetDirectory, rendered);
-  onStatus("Saved .dev.vars and agent/.env.local for local development only.");
+  onStatus("Saved local web and agent credentials for local development only.");
   return "configured";
 }
 var init_wizard = __esm({
@@ -10113,6 +10214,9 @@ var init_wizard = __esm({
   }
 });
 
+// src/cli.ts
+init_catalog();
+
 // node_modules/.pnpm/@clack+core@1.4.3/node_modules/@clack/core/dist/index.mjs
 import { styleText } from "util";
 import { stdout, stdin } from "process";
@@ -14699,7 +14803,7 @@ var program = new Command();
 
 // src/cli.ts
 init_errors();
-import { readFile as readFile4 } from "fs/promises";
+import { readFile as readFile7 } from "fs/promises";
 import process5 from "process";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
@@ -14744,18 +14848,22 @@ init_package_managers();
 import { spawn as spawn3 } from "child_process";
 
 // src/templates.ts
-init_errors();
-import { fileURLToPath } from "url";
+init_project_config();
+init_catalog();
 
-// src/templates/cloudflare-livekit/index.ts
-init_errors();
+// src/templates/composed.ts
+import { writeFile as writeFile6 } from "fs/promises";
+import { join as join9 } from "path";
+
+// src/templates/agora.ts
 init_package_managers();
-init_project();
+import { readFile as readFile6, writeFile as writeFile5 } from "fs/promises";
+import { basename as basename3, join as join8 } from "path";
 
 // src/templates/cloudflare-livekit/configure.ts
 init_package_managers();
 import { randomUUID } from "crypto";
-import { readFile, writeFile } from "fs/promises";
+import { access, readFile as readFile2, writeFile } from "fs/promises";
 import { basename, join as join3 } from "path";
 function toValidPackageName(value) {
   const normalized = value.trim().toLowerCase().replace(/\s+/gu, "-").replace(/^[._-]+/u, "").replace(/[^a-z\d~._-]+/gu, "-").replace(/-+/gu, "-").slice(0, 214).replace(/-$/u, "");
@@ -14771,6 +14879,7 @@ function npmRequiresScriptAllowlist(version) {
 function createReplacements(packageManagers, platform) {
   const javascript = packageManagers.javascript;
   const python = packageManagers.python;
+  if (!python) throw new Error("LiveKit templates require Python tooling.");
   return /* @__PURE__ */ new Map([
     [
       "{{SPATIUS_JAVASCRIPT_PACKAGE_MANAGER}}",
@@ -14842,7 +14951,7 @@ function createReplacements(packageManagers, platform) {
   ]);
 }
 async function renderFile(path2, replacements) {
-  let contents = await readFile(path2, "utf8");
+  let contents = await readFile2(path2, "utf8");
   for (const [token, replacement] of replacements) {
     contents = contents.replaceAll(token, replacement);
   }
@@ -14854,7 +14963,7 @@ async function configureGeneratedTemplate(targetDirectory, {
   projectName = basename(targetDirectory)
 }) {
   const packagePath = join3(targetDirectory, "package.json");
-  const packageContents = await readFile(packagePath, "utf8");
+  const packageContents = await readFile2(packagePath, "utf8");
   const metadata = JSON.parse(packageContents);
   const javascript = packageManagers.javascript;
   const run = (script) => javascriptRunCommand(javascript.name, script);
@@ -14893,7 +15002,7 @@ async function configureGeneratedTemplate(targetDirectory, {
   if (javascript.name === "npm") {
     const packageLockPath = join3(targetDirectory, "package-lock.json");
     const packageLock = JSON.parse(
-      await readFile(packageLockPath, "utf8")
+      await readFile2(packageLockPath, "utf8")
     );
     packageLock.name = metadata.name;
     if (packageLock.packages?.[""] !== void 0) {
@@ -14912,12 +15021,18 @@ async function configureGeneratedTemplate(targetDirectory, {
   await Promise.all(
     [
       ".dev.vars.example",
+      ".env.local.example",
       "wrangler.jsonc",
       "agent/src/agent.py",
       "agent/README.md",
       "worker/index.test.ts"
     ].map(
-      async (relativePath) => renderFile(join3(targetDirectory, relativePath), agentReplacements)
+      async (relativePath) => access(join3(targetDirectory, relativePath)).then(
+        () => renderFile(join3(targetDirectory, relativePath), agentReplacements)
+      ).catch((error) => {
+        if (!(error instanceof Error && "code" in error && error.code === "ENOENT"))
+          throw error;
+      })
     )
   );
   await Promise.all(
@@ -14952,6 +15067,7 @@ function createInstallPlan(targetDirectory, packageManagers, platform = process.
       `Installing JavaScript dependencies with ${javascript.name}`
     )
   ];
+  if (!python) return steps;
   if (python.name === "uv") {
     steps.push(
       commandStep(
@@ -14990,6 +15106,9 @@ function createInstallPlan(targetDirectory, packageManagers, platform = process.
 }
 
 // src/templates/cloudflare-livekit/index.ts
+init_errors();
+init_package_managers();
+init_project();
 var credentialSetupStep = {
   command: "npx create-spatius-app setup . --interactive",
   reason: "Connect LiveKit and Spatius accounts and select an avatar and voice in a secure interactive terminal. Never paste secrets into chat.",
@@ -15017,8 +15136,9 @@ var cloudflareLivekitTemplate = {
     "- agent/     Python LiveKit agent"
   ],
   includeFile(path2, configuration) {
+    if (path2 === "worker-configuration.d.ts") return false;
     const javascript = configuration?.packageManagers.javascript.name ?? "pnpm";
-    const python = configuration?.packageManagers.python.name ?? "uv";
+    const python = configuration?.packageManagers.python?.name ?? "uv";
     if (path2 === "package-lock.json") return javascript === "npm";
     if (["npmrc", "pnpm-lock.yaml", "pnpm-workspace.yaml"].includes(path2)) {
       return javascript === "pnpm";
@@ -15042,6 +15162,8 @@ var cloudflareLivekitTemplate = {
     platform,
     pythonPackageManager
   }) {
+    if (!pythonPackageManager)
+      throw new Error("LiveKit templates require Python tooling.");
     return [
       ...dependenciesInstalled ? [] : [
         javascriptInstallCommand(javascriptPackageManager),
@@ -15074,16 +15196,339 @@ var cloudflareLivekitTemplate = {
   ]
 };
 
+// src/setup/agora.ts
+init_environment();
+init_errors();
+init_project_config();
+import { lstat as lstat4, readFile as readFile5, rename as rename2, rm as rm3, writeFile as writeFile4 } from "fs/promises";
+import { join as join7 } from "path";
+import { randomUUID as randomUUID3 } from "crypto";
+var runAgoraSetup = async ({
+  targetDirectory,
+  prompts,
+  onStatus = () => void 0
+}) => {
+  const target = await lstat4(targetDirectory);
+  if (!target.isDirectory() || target.isSymbolicLink())
+    throw new CliError(
+      "INVALID_ARGUMENT",
+      "Expected a regular project directory.",
+      { exitCode: EXIT_CODES.invalidArgument }
+    );
+  const config = await readProjectConfig(targetDirectory);
+  if (config?.stack !== "cloudflare-agora")
+    throw new CliError(
+      "INVALID_ARGUMENT",
+      "Expected a Cloudflare + Agora project.",
+      { exitCode: EXIT_CODES.invalidArgument }
+    );
+  for (const name of ["package.json", ".dev.vars.example", "worker/agora.ts"]) {
+    const stats = await lstat4(join7(targetDirectory, name));
+    if (!stats.isFile() || stats.isSymbolicLink())
+      throw new CliError(
+        "INVALID_ARGUMENT",
+        "Expected regular project files.",
+        { exitCode: EXIT_CODES.invalidArgument }
+      );
+  }
+  const path2 = join7(targetDirectory, ".dev.vars");
+  let existing;
+  try {
+    const stats = await lstat4(path2);
+    if (!stats.isFile() || stats.isSymbolicLink())
+      throw new Error("Unsafe credential path");
+    existing = await readFile5(path2, "utf8");
+  } catch (error) {
+    if (!(error instanceof Error && "code" in error && error.code === "ENOENT"))
+      throw new CliError("FILESYSTEM_ERROR", "Cannot safely read .dev.vars.", {
+        exitCode: EXIT_CODES.filesystem,
+        path: path2
+      });
+  }
+  if (existing && !await prompts.confirm(
+    "Replace existing Agora and Spatius credentials? Other variables are preserved.",
+    false
+  ))
+    return "unchanged";
+  const values = {};
+  const previous = parseDotenv(existing ?? "");
+  const secretKeys = ["AGORA_APP_CERTIFICATE", "SPATIUS_API_KEY"];
+  for (const key of [
+    "AGORA_APP_ID",
+    "AGORA_APP_CERTIFICATE",
+    "AGORA_PIPELINE_ID",
+    "SPATIUS_APP_ID",
+    "SPATIUS_API_KEY",
+    "SPATIUS_AVATAR_ID",
+    "SPATIUS_REGION",
+    "AGORA_AVATAR_SAMPLE_RATE"
+  ]) {
+    const defaults = {
+      SPATIUS_REGION: "cn-beijing",
+      AGORA_AVATAR_SAMPLE_RATE: "24000"
+    };
+    while (true) {
+      const value = secretKeys.includes(key) ? await prompts.password(key) : await prompts.input(key, {
+        initialValue: previous.get(key) ?? defaults[key]
+      });
+      if (isPlaceholderValue(value) || new RegExp("\\p{Cc}", "u").test(value)) {
+        onStatus("Enter a non-empty value without control characters.");
+        continue;
+      }
+      if (["AGORA_APP_ID", "AGORA_APP_CERTIFICATE"].includes(key) && !/^[a-f\d]{32}$/iu.test(value)) {
+        onStatus(
+          "Agora App ID and certificate must contain 32 hexadecimal characters."
+        );
+        continue;
+      }
+      if (key === "AGORA_AVATAR_SAMPLE_RATE" && ![8e3, 16e3, 22050, 24e3, 32e3, 44100, 48e3].includes(
+        Number(value)
+      )) {
+        onStatus("Choose a supported audio sample rate.");
+        continue;
+      }
+      values[key] = value;
+      break;
+    }
+  }
+  const rendered = mergeDotenv(
+    existing ?? await readFile5(join7(targetDirectory, ".dev.vars.example"), "utf8"),
+    values
+  );
+  const temporary = join7(targetDirectory, `.dev.vars.${randomUUID3()}.tmp`);
+  try {
+    await writeFile4(temporary, rendered, { flag: "wx", mode: 384 });
+    await rename2(temporary, path2);
+  } finally {
+    await rm3(temporary, { force: true });
+  }
+  onStatus(
+    "Saved .dev.vars. Configure an English assistant in the published Agora pipeline, with its TTS sample rate matching AGORA_AVATAR_SAMPLE_RATE. No cloud services were started."
+  );
+  return "configured";
+};
+
+// src/templates/agora.ts
+init_project_config();
+var files = /* @__PURE__ */ new Set([
+  "package.json",
+  "package-lock.json",
+  "pnpm-lock.yaml",
+  "pnpm-workspace.yaml",
+  "npmrc",
+  "gitignore",
+  ".editorconfig",
+  ".prettierrc.json",
+  ".prettierignore",
+  "README.md",
+  "AGENTS.md",
+  "DEPLOYMENT.md",
+  "spatius.config.json",
+  "index.html",
+  "tsconfig.json",
+  "tsconfig.web.json",
+  "tsconfig.worker.json",
+  "tsconfig.node.json",
+  "vite.config.ts",
+  "vitest.config.ts",
+  "eslint.config.mjs",
+  "dev.vars.example",
+  "wrangler.jsonc",
+  "scripts/check-worker.mjs",
+  "worker/index.ts",
+  "worker/index.test.ts",
+  "worker/agora.ts",
+  "worker/agora.test.ts",
+  "worker/capability.ts",
+  "worker/capability.test.ts",
+  "web/App.tsx",
+  "web/main.tsx",
+  "web/styles.css",
+  "web/agora-session.ts",
+  "web/agora-session.test.ts",
+  "web/components/transcript-view.tsx",
+  "web/components/transcript-panel.tsx",
+  "web/components/icons.tsx",
+  "web/components/agents-ui/agent-chat-input.tsx",
+  "web/components/agents-ui/LICENSE",
+  "web/components/agents-ui/PROVENANCE.md"
+]);
+var agoraTemplate = {
+  id: "cloudflare-agora",
+  stack: "cloudflare-agora",
+  requiresPython: false,
+  humanSteps: [
+    {
+      command: "npx create-spatius-app setup . --interactive",
+      reason: "Enter Agora and Spatius credentials in a secure interactive terminal and configure a published English Agora pipeline. Never paste secrets into chat.",
+      requiresHuman: true,
+      requiresTty: true
+    }
+  ],
+  directory: "templates/cloudflare-livekit",
+  description: "Cloudflare Workers + Agora Conversational AI",
+  components: [
+    "- web/       React + Spatius AvatarKit + Agora",
+    "- worker/    Cloudflare API; Agora hosts the conversational agent"
+  ],
+  layers: [
+    { directory: "templates/layers/catalog" },
+    {
+      directory: "templates/layers/agora",
+      overrides: [
+        "package.json",
+        "package-lock.json",
+        "pnpm-lock.yaml",
+        "web/App.tsx",
+        "worker/index.ts",
+        "worker/index.test.ts",
+        "tsconfig.worker.json",
+        ".dev.vars.example",
+        "wrangler.jsonc",
+        "vitest.config.ts",
+        "README.md",
+        "AGENTS.md"
+      ]
+    }
+  ],
+  includeFile(path2, configuration) {
+    if (!cloudflareLivekitTemplate.includeFile(path2, configuration)) return false;
+    return files.has(path2) || [...files].some((file) => file.startsWith(path2 + "/")) || path2 === "web/assets" || path2.startsWith("web/assets/");
+  },
+  mapFile(path2) {
+    return cloudflareLivekitTemplate.mapFile(path2);
+  },
+  async configure(directory, configuration) {
+    const manager = configuration.packageManagers.javascript;
+    const run = (script) => javascriptRunCommand(manager.name, script);
+    const path2 = join8(directory, "package.json");
+    const pkg = JSON.parse(await readFile6(path2, "utf8"));
+    pkg.name = toValidPackageName(
+      configuration.projectName ?? basename3(directory)
+    );
+    if (manager.version && manager.version !== "unknown")
+      pkg.packageManager = `${manager.name}@${manager.version}`;
+    else delete pkg.packageManager;
+    pkg.scripts.check = [
+      "format:check",
+      "lint",
+      "typecheck",
+      "test",
+      "build",
+      "test:worker"
+    ].map(run).join(" && ");
+    pkg.scripts.deploy = `${run("build")} && wrangler deploy`;
+    if (manager.name === "bun")
+      pkg.trustedDependencies = ["core-js", "esbuild", "workerd"];
+    else if (manager.name === "npm" && Number.parseInt(manager.version ?? "", 10) >= 12)
+      pkg.allowScripts = { "core-js": true, esbuild: true, workerd: true };
+    await writeFile5(path2, JSON.stringify(pkg, null, 2) + "\n");
+    if (manager.name === "npm") {
+      const lockPath = join8(directory, "package-lock.json");
+      const lock = JSON.parse(await readFile6(lockPath, "utf8"));
+      lock.name = pkg.name;
+      lock.packages[""].name = pkg.name;
+      await writeFile5(lockPath, JSON.stringify(lock, null, 2) + "\n");
+    }
+    await writeFile5(
+      join8(directory, "spatius.config.json"),
+      JSON.stringify({ version: 2, stack: "cloudflare-agora" }, null, 2) + "\n"
+    );
+    for (const name of ["README.md", "AGENTS.md"]) {
+      const path3 = join8(directory, name);
+      await writeFile5(
+        path3,
+        (await readFile6(path3, "utf8")).replaceAll("__INSTALL__", javascriptInstallCommand(manager.name)).replaceAll("__DEV__", run("dev")).replaceAll("__CHECK__", run("check"))
+      );
+    }
+    await writeFile5(
+      join8(directory, "DEPLOYMENT.md"),
+      `# Cloudflare Workers + Agora Conversational AI
+
+Run \`${run("wrangler -- login")}\`. Set your non-secret configuration from .dev.vars in the vars section of wrangler.jsonc. Upload AGORA_APP_CERTIFICATE and SPATIUS_API_KEY with \`${run("wrangler -- secret put AGORA_APP_CERTIFICATE")}\` (repeat for SPATIUS_API_KEY). Run \`${run("deploy")}\` to deploy the React frontend and API as one Cloudflare Worker.
+
+Agora hosts the conversational agent. There is no Python worker, Node server, container, or database to deploy. Enable Agora Conversational AI and RTM, publish an English assistant pipeline, and set AGORA_PIPELINE_ID. The pipeline owns its models and voice. Match AGORA_AVATAR_SAMPLE_RATE to its TTS output.
+
+Session creation starts a hosted agent. Disconnect and initialization failures stop it through the Worker API. Page-close cleanup is best effort, with a 60-second idle timeout fallback. Sessions and client tokens last 30 minutes; start a fresh conversation afterward.
+
+Local setup writes .dev.vars only. It never provisions Cloudflare services or uploads secrets.
+`
+    );
+  },
+  createInstallPlan(directory, managers, platform) {
+    return createInstallPlan(
+      directory,
+      { javascript: managers.javascript },
+      platform
+    );
+  },
+  nextSteps({
+    dependenciesInstalled,
+    credentialsConfigured,
+    javascriptPackageManager
+  }) {
+    return [
+      ...dependenciesInstalled ? [] : [javascriptInstallCommand(javascriptPackageManager)],
+      ...credentialsConfigured ? [] : ["npx create-spatius-app setup . --interactive"],
+      javascriptRunCommand(javascriptPackageManager, "dev")
+    ];
+  },
+  setup: {
+    recognizes: async (directory) => (await readProjectConfig(directory))?.stack === "cloudflare-agora",
+    run: runAgoraSetup
+  },
+  verification: [
+    { javascript: "npm", scripts: ["check"] },
+    { javascript: "pnpm", scripts: ["check"] }
+  ]
+};
+
+// src/templates/composed.ts
+init_package_managers();
+function composeTemplate(stack) {
+  if (stack === "cloudflare-agora") return agoraTemplate;
+  return {
+    ...cloudflareLivekitTemplate,
+    stack,
+    requiresPython: true,
+    layers: [{ directory: "templates/layers/catalog" }],
+    async configure(directory, configuration) {
+      await cloudflareLivekitTemplate.configure(directory, configuration);
+      await writeFile6(
+        join9(directory, "spatius.config.json"),
+        JSON.stringify({ version: 2, stack }, null, 2) + "\n"
+      );
+      const manager = configuration.packageManagers.javascript.name;
+      const run = (script) => javascriptRunCommand(manager, script);
+      await writeFile6(
+        join9(directory, "DEPLOYMENT.md"),
+        `# Cloudflare Workers + LiveKit Cloud
+
+Run \`${run("wrangler -- login")}\`, set the non-secret configuration from .dev.vars.example in wrangler.jsonc, and upload LIVEKIT_API_KEY and LIVEKIT_API_SECRET using \`${run("wrangler -- secret put LIVEKIT_API_SECRET")}\` (repeat for the key). Run \`${run("deploy")}\` to deploy the frontend and API together.
+
+From agent/, run \`lk cloud auth\` and \`lk agent create\` for the first deployment. Configure the agent secrets from agent/.env.example. Use \`lk agent deploy\` for updates.
+
+Deploy the agent before opening conversations. Use separate LiveKit projects for development and production. Local setup never uploads secrets.
+`
+      );
+    }
+  };
+}
+
+// src/templates.ts
+init_errors();
+import { fileURLToPath } from "url";
+
 // src/scaffold.ts
 init_errors();
 import { constants } from "fs";
-import { copyFile, lstat as lstat4, mkdir, readdir as readdir2, rm as rm3 } from "fs/promises";
-import { basename as basename3, dirname as dirname2, isAbsolute, join as join6, win32 as win322 } from "path";
+import { copyFile, lstat as lstat6, mkdir, readdir as readdir2, rm as rm4 } from "fs/promises";
+import { basename as basename4, dirname as dirname2, isAbsolute, join as join10, win32 as win322 } from "path";
 
 // src/project-directory.ts
 init_errors();
 import { homedir as homedir2 } from "os";
-import { lstat as lstat3, readdir } from "fs/promises";
+import { lstat as lstat5, readdir } from "fs/promises";
 import { parse as parse2, resolve } from "path";
 function normalizeTargetDirectory(input, currentWorkingDirectory = process.cwd()) {
   return resolve(currentWorkingDirectory, input);
@@ -15115,7 +15560,7 @@ function assertSafeTargetDirectory(targetDirectory, homeDirectory = homedir2())
 }
 async function inspectTargetDirectory(targetDirectory) {
   try {
-    const stats = await lstat3(targetDirectory);
+    const stats = await lstat5(targetDirectory);
     if (!stats.isDirectory() || stats.isSymbolicLink()) {
       return "not-a-directory";
     }
@@ -15187,10 +15632,10 @@ function assertRelativeDestination(path2) {
   }
 }
 async function listTemplateFiles(templateDirectory, template, configuration, relativeDirectory = "") {
-  const entries = await readdir2(join6(templateDirectory, relativeDirectory), {
+  const entries = await readdir2(join10(templateDirectory, relativeDirectory), {
     withFileTypes: true
   });
-  const files = [];
+  const files2 = [];
   for (const entry of entries) {
     if (shouldIgnoreTemplateEntry(entry.name)) continue;
     const source = [relativeDirectory, entry.name].filter(Boolean).join("/");
@@ -15199,7 +15644,7 @@ async function listTemplateFiles(templateDirectory, template, configuration, rel
       throw new Error("Bundled templates must not contain symbolic links.");
     }
     if (entry.isDirectory()) {
-      files.push(
+      files2.push(
         ...await listTemplateFiles(
           templateDirectory,
           template,
@@ -15210,12 +15655,12 @@ async function listTemplateFiles(templateDirectory, template, configuration, rel
     } else if (entry.isFile()) {
       const destination = template.mapFile(source);
       assertRelativeDestination(destination);
-      files.push({ source, destination });
+      files2.push({ source, destination });
     } else {
       throw new Error("Bundled templates must contain regular files.");
     }
   }
-  return files;
+  return files2;
 }
 async function createScaffoldPlan({
   configuration,
@@ -15227,7 +15672,7 @@ async function createScaffoldPlan({
   const targetState = await assertTargetDirectoryAvailable(targetDirectory);
   let entries;
   try {
-    const root = await lstat4(templateDirectory);
+    const root = await lstat6(templateDirectory);
     if (!root.isDirectory() || root.isSymbolicLink()) {
       throw new Error("The template must be a regular directory.");
     }
@@ -15236,6 +15681,33 @@ async function createScaffoldPlan({
       template,
       configuration
     );
+    for (const layer of template.layers ?? []) {
+      const directory = resolveTemplateDirectory({
+        ...template,
+        directory: layer.directory
+      });
+      const root2 = await lstat6(directory);
+      if (!root2.isDirectory() || root2.isSymbolicLink())
+        throw new Error("Invalid template layer.");
+      const additions = await listTemplateFiles(
+        directory,
+        template,
+        configuration
+      );
+      for (const addition of additions) {
+        const index = entries.findIndex(
+          (entry) => entry.destination === addition.destination
+        );
+        if (index >= 0) {
+          if (!layer.overrides?.includes(addition.destination))
+            throw new Error(
+              `Undeclared template override: ${addition.destination}`
+            );
+          entries.splice(index, 1);
+        }
+        entries.push({ ...addition, directory });
+      }
+    }
     const destinations = /* @__PURE__ */ new Set();
     const directories = /* @__PURE__ */ new Map();
     for (const { destination } of entries) {
@@ -15294,11 +15766,11 @@ async function createScaffoldPlan({
 }
 async function rollback(targetDirectory, targetCreated, createdPaths) {
   if (targetCreated) {
-    await rm3(targetDirectory, { force: true, recursive: true });
+    await rm4(targetDirectory, { force: true, recursive: true });
     return;
   }
   for (const path2 of [...createdPaths].reverse()) {
-    await rm3(path2, { force: true, recursive: true });
+    await rm4(path2, { force: true, recursive: true });
   }
 }
 async function scaffoldProject({
@@ -15333,9 +15805,9 @@ async function scaffoldProject({
       targetCreated = true;
     }
     for (const entry of plan.entries) {
-      const source = join6(templateDirectory, entry.source);
-      const destination = join6(targetDirectory, entry.destination);
-      const stats = await lstat4(source);
+      const source = join10(entry.directory ?? templateDirectory, entry.source);
+      const destination = join10(targetDirectory, entry.destination);
+      const stats = await lstat6(source);
       if (!stats.isFile() || stats.isSymbolicLink()) {
         throw new Error("A template source is no longer a regular file.");
       }
@@ -15352,7 +15824,7 @@ async function scaffoldProject({
     );
     throw new CliError(
       "FILESYSTEM_ERROR",
-      "Could not create " + basename3(targetDirectory) + ": " + (error instanceof Error ? error.message : "unknown filesystem error"),
+      "Could not create " + basename4(targetDirectory) + ": " + (error instanceof Error ? error.message : "unknown filesystem error"),
       {
         exitCode: EXIT_CODES.filesystem,
         path: targetDirectory,
@@ -15366,16 +15838,26 @@ async function scaffoldProject({
 // src/templates.ts
 init_package_managers();
 var DEFAULT_TEMPLATE_ID = "cloudflare-livekit";
-var templateRegistry = {
-  [DEFAULT_TEMPLATE_ID]: cloudflareLivekitTemplate
-};
+var templateRegistry = Object.fromEntries(
+  Object.keys(stacks).map((stack) => [
+    stack,
+    composeTemplate(stack)
+  ])
+);
 function getTemplate(id = DEFAULT_TEMPLATE_ID) {
-  return templateRegistry[id];
+  const template = templateRegistry[id];
+  if (!template)
+    throw new CliError("INVALID_ARGUMENT", `Unknown template: ${id}`, {
+      exitCode: EXIT_CODES.invalidArgument
+    });
+  return template;
 }
 function resolveTemplateDirectory(template = getTemplate()) {
   return fileURLToPath(new URL(`../${template.directory}/`, import.meta.url));
 }
-async function resolveProjectTemplate(targetDirectory, templates = Object.values(templateRegistry)) {
+async function resolveProjectTemplate(targetDirectory, templates = [getTemplate()]) {
+  const config = await readProjectConfig(targetDirectory);
+  if (config) return getTemplate(config.stack);
   const matches = [];
   for (const template of templates) {
     if (await template.setup.recognizes(targetDirectory))
@@ -15568,10 +16050,10 @@ function resolveInteractionMode({
 init_package_managers();
 
 // src/output.ts
-var OUTPUT_SCHEMA_VERSION = 3;
+var OUTPUT_SCHEMA_VERSION = 4;
 function createSuccessResult({
   dryRun,
-  files,
+  files: files2,
   generatorVersion,
   dependenciesInstalled,
   javascriptPackageManager,
@@ -15587,7 +16069,7 @@ function createSuccessResult({
       gitInitialized: false
     },
     command: "create",
-    created: dryRun ? [] : [...files],
+    created: dryRun ? [] : [...files2],
     dryRun,
     generatorVersion,
     humanSteps: template.humanSteps.map((step) => ({ ...step })),
@@ -15600,12 +16082,12 @@ function createSuccessResult({
     ok: true,
     packageManagers: {
       javascript: javascriptPackageManager,
-      python: pythonPackageManager.name
+      ...pythonPackageManager ? { python: pythonPackageManager.name } : {}
     },
     projectDirectory,
     schemaVersion: OUTPUT_SCHEMA_VERSION,
-    template: "default",
-    wouldCreate: dryRun ? [...files] : []
+    stack: template.stack ?? "cloudflare-livekit",
+    wouldCreate: dryRun ? [...files2] : []
   };
 }
 function createFailureResult(error) {
@@ -16035,7 +16517,10 @@ var PromptSession = class {
     return this.confirm("Install dependencies now?", true);
   }
   shouldConfigureCredentials() {
-    return this.confirm("Configure LiveKit and Spatius credentials now?", true);
+    return this.confirm(
+      "Configure provider and Spatius credentials now?",
+      true
+    );
   }
 };
 
@@ -16079,7 +16564,7 @@ async function readPackageVersion() {
   const packagePath = fileURLToPath2(
     new URL("../package.json", import.meta.url)
   );
-  const contents = await readFile4(packagePath, "utf8");
+  const contents = await readFile7(packagePath, "utf8");
   const metadata = JSON.parse(contents);
   return metadata.version;
 }
@@ -16177,7 +16662,7 @@ function managerOptions(managers) {
     value: manager.name
   }));
 }
-async function resolvePackageManagers(options, interactive, prompts) {
+async function resolvePackageManagers(options, interactive, prompts, requiresPython = true) {
   if (!interactive && (options.install !== true || options.dryRun)) {
     const inventory2 = { javascript: [], python: [] };
     const javascriptDefault2 = options.packageManager ?? inferInvokingPackageManager(process5.env.npm_config_user_agent) ?? "npm";
@@ -16187,15 +16672,17 @@ async function resolvePackageManagers(options, interactive, prompts) {
         javascriptDefault2,
         process5.env.npm_config_user_agent
       ),
-      python: selectPythonPackageManager(
-        inventory2,
-        options.pythonPackageManager ?? "uv"
-      )
+      ...requiresPython ? {
+        python: selectPythonPackageManager(
+          inventory2,
+          options.pythonPackageManager ?? "uv"
+        )
+      } : {}
     };
   }
   const inventory = await detectPackageManagers({
     ...options.packageManager === void 0 ? {} : { javascript: [options.packageManager] },
-    ...options.pythonPackageManager === void 0 ? {} : { python: [options.pythonPackageManager] }
+    ...!requiresPython ? { python: [] } : options.pythonPackageManager === void 0 ? {} : { python: [options.pythonPackageManager] }
   });
   const javascriptDefault = !interactive && options.packageManager === void 0 && inventory.javascript.length === 0 ? "npm" : options.packageManager;
   const pythonDefault = !interactive && options.pythonPackageManager === void 0 && inventory.python.length === 0 ? "uv" : options.pythonPackageManager;
@@ -16204,7 +16691,7 @@ async function resolvePackageManagers(options, interactive, prompts) {
     javascriptDefault,
     process5.env.npm_config_user_agent
   );
-  let python = selectPythonPackageManager(inventory, pythonDefault);
+  let python = requiresPython ? selectPythonPackageManager(inventory, pythonDefault) : void 0;
   if (interactive && options.packageManager === void 0) {
     const selectedName = await prompts.choose(
       "Which JavaScript package manager?",
@@ -16215,7 +16702,7 @@ async function resolvePackageManagers(options, interactive, prompts) {
       (manager) => manager.name === selectedName
     );
   }
-  if (interactive && options.pythonPackageManager === void 0) {
+  if (interactive && python && options.pythonPackageManager === void 0) {
     const selectedName = await prompts.choose(
       "Which Python package manager?",
       managerOptions(inventory.python),
@@ -16226,7 +16713,7 @@ async function resolvePackageManagers(options, interactive, prompts) {
   return { javascript, python };
 }
 function renderManagerSummary(javascript, python) {
-  return `${javascript.name} + ${python.name}`;
+  return python ? `${javascript.name} + ${python.name}` : javascript.name;
 }
 function isTestTerminalOverride() {
   return process5.env.NODE_ENV === "test" && process5.env.CREATE_SPATIUS_APP_TEST_INTERACTIVE === "1";
@@ -16256,6 +16743,7 @@ async function detectExecutionAgent() {
 }
 async function runCreateCommand(version, projectDirectoryArgument, rawOptions) {
   const options = {
+    stack: rawOptions.stack,
     debug: rawOptions.debug === true,
     dryRun: rawOptions.dryRun === true,
     install: rawOptions.install,
@@ -16300,6 +16788,14 @@ async function runCreateCommand(version, projectDirectoryArgument, rawOptions) {
         `${theme.accent("create-spatius-app")} ${theme.highlight(`v${version}`)}`
       );
     }
+    const selection = await selectCatalog({ ...options, interactive, prompts });
+    const template = getTemplate(selection.stack);
+    if (template.requiresPython === false && options.pythonPackageManager)
+      throw new CliError(
+        "INVALID_ARGUMENT",
+        "This stack does not use Python. Remove --python-package-manager.",
+        { exitCode: EXIT_CODES.invalidArgument }
+      );
     const projectDirectoryInput = await resolveProjectDirectoryInput({
       argument: projectDirectoryArgument,
       interactive,
@@ -16309,13 +16805,13 @@ async function runCreateCommand(version, projectDirectoryArgument, rawOptions) {
     const packageManagers = await resolvePackageManagers(
       options,
       interactive,
-      prompts
+      prompts,
+      template.requiresPython !== false
     );
     const shouldInstall = !options.dryRun && (options.install ?? (interactive ? await prompts.shouldInstall() : false));
     if (shouldInstall) {
       assertPackageManagersAvailable(packageManagers);
     }
-    const template = getTemplate();
     const configuration = { packageManagers };
     const scaffold = options.dryRun ? await createScaffoldPlan({
       configuration,
@@ -16494,7 +16990,12 @@ async function runSetupCommand(version, projectDirectoryArgument, rawOptions) {
   }
 }
 function addCreateOptions(command) {
-  return command.option("-y, --yes", "accept safe defaults without prompting").addOption(new Option("--interactive", "force interactive prompts")).addOption(new Option("--no-interactive", "disable interactive prompts")).addOption(
+  return command.addOption(
+    new Option(
+      "--stack <stack>",
+      "voice provider on Cloudflare Workers"
+    ).choices(Object.keys(stacks))
+  ).option("-y, --yes", "accept safe defaults without prompting").addOption(new Option("--interactive", "force interactive prompts")).addOption(new Option("--no-interactive", "disable interactive prompts")).addOption(
     new Option(
       "--package-manager <manager>",
       "use pnpm, bun, or npm for JavaScript dependencies"
@@ -16504,12 +17005,14 @@ function addCreateOptions(command) {
       "--python-package-manager <manager>",
       "use uv or pip for Python dependencies"
     ).choices(PYTHON_PACKAGE_MANAGERS)
-  ).option("--install", "install JavaScript and Python dependencies").option("--no-install", "skip dependency installation").option("--setup", "configure local LiveKit and Spatius credentials").option("--no-setup", "skip credential setup").option("--debug", "write safe Spatius request diagnostics to stderr").option("--json", "emit one machine-readable JSON result").option("--dry-run", "validate and show planned files without writing");
+  ).option("--install", "install dependencies for the selected provider").option("--no-install", "skip dependency installation").option("--setup", "configure local provider and Spatius credentials").option("--no-setup", "skip credential setup").option("--debug", "write safe Spatius request diagnostics to stderr").option("--json", "emit one machine-readable JSON result").option("--dry-run", "validate and show planned files without writing");
 }
 async function main() {
   const version = await readPackageVersion();
   const program2 = addCreateOptions(
-    new Command().name("create-spatius-app").description(getTemplate().description).version(version).argument(
+    new Command().name("create-spatius-app").description(
+      "Create a Spatius voice-avatar app with LiveKit or Agora Conversational AI on Cloudflare Workers."
+    ).version(version).argument(
       "[project-directory]",
       "directory in which to create the project"
     )
@@ -16519,6 +17022,7 @@ async function main() {
     `
 Examples:
   npx create-spatius-app my-app
+  npx create-spatius-app my-app --stack cloudflare-agora
   npx create-spatius-app my-app --package-manager pnpm --python-package-manager uv
   npx create-spatius-app my-app --no-setup
   npx create-spatius-app my-app --setup --interactive
@@ -16529,7 +17033,7 @@ Examples:
     async (projectDirectoryArgument, rawOptions) => runCreateCommand(version, projectDirectoryArgument, rawOptions)
   );
   program2.command("setup").description(
-    "securely configure local LiveKit and Spatius credentials for an existing generated project"
+    "securely configure local provider credentials for an existing generated project"
   ).argument("[project-directory]", "generated project to configure", ".").addOption(new Option("--interactive", "allow browser and secret prompts")).addOption(new Option("--no-interactive", "disable interactive prompts")).option("--debug", "write safe Spatius request diagnostics to stderr").addHelpText(
     "after",
     `
@@ -16567,4 +17071,3 @@ try {
   }
   process5.exitCode = normalizedError.exitCode;
 }
-//# sourceMappingURL=cli.js.map