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

package/README.md

@@ -1,18 +1,18 @@
 # create-spatius-app
 
-Create a voice-avatar app with Spatius and React. Choose LiveKit with Cloudflare or Railway hosting, or Agora Conversational AI on Zeabur.
+Create a voice-avatar app with Spatius and React. Choose LiveKit or Agora Conversational AI. Both templates run the frontend and API on Cloudflare Workers.
 
 ## Quick start
 
 Requires Node.js 22.12+ and a [Spatius Studio](https://app.spatius.ai) account.
-LiveKit stacks also need Python 3.11–3.14 and a LiveKit Cloud project.
-The Agora stack needs an Agora account and no Python tooling.
+The LiveKit template also needs Python 3.11–3.14 and a LiveKit Cloud project.
+The Agora template needs an Agora account and no Python tooling.
 
 ```sh
 npx create-spatius-app my-app
 ```
 
-Choose a tech stack. Follow the remaining prompts to choose package managers, install dependencies, and
+Choose LiveKit or Agora Conversational AI. Follow the remaining prompts to choose package managers, install dependencies, and
 configure your provider and Spatius credentials.
 If LiveKit CLI is missing, setup offers to install it using Homebrew on macOS,
 WinGet on Windows, or LiveKit's Linux installer. You can also enter credentials
@@ -26,7 +26,7 @@ pnpm dev
 # Or: npm run dev / bun run dev
 ```
 
-This starts the frontend, API, and, for LiveKit stacks, the Python agent together. Generated DEPLOYMENT.md covers your selected hosting stack.
+This starts the frontend, API, and, for LiveKit, the Python agent together. Generated DEPLOYMENT.md covers deployment to Cloudflare Workers and, for LiveKit, LiveKit Cloud.
 Open the URL printed in your terminal and start a conversation.
 
 ## Use with a coding agent
@@ -47,15 +47,16 @@ npx create-spatius-app setup . --interactive
 
 This configures local development only; it does not deploy your app.
 
-## Choose a stack
+## Choose a provider
 
 ```sh
-npx create-spatius-app my-app --stack railway-livekit
+npx create-spatius-app my-app --stack cloudflare-livekit
+# Or:
+npx create-spatius-app my-app --stack cloudflare-agora
 ```
 
-Cloudflare and Railway web hosting can each be paired with LiveKit Cloud Agents
-or a LiveKit agent on Railway. The default is Cloudflare + LiveKit Cloud Agents.
-The `zeabur-agora` stack requires no Python tooling.
+LiveKit is the default and deploys its Python agent to LiveKit Cloud.
+Agora Conversational AI hosts the agent itself; its template needs no Python.
 
 ## More options
 

package/dist/cli.js

@@ -107,7 +107,11 @@ async function selectCatalog(options) {
     label: stack.label
   }));
   return validateSelection(
-    options.interactive ? await options.prompts.choose("Which stack?", choices, DEFAULT_STACK) : DEFAULT_STACK
+    options.interactive ? await options.prompts.choose(
+      "Which voice AI provider?",
+      choices,
+      DEFAULT_STACK
+    ) : DEFAULT_STACK
   );
 }
 var stacks, DEFAULT_STACK;
@@ -117,32 +121,14 @@ var init_catalog = __esm({
     init_errors();
     stacks = {
       "cloudflare-livekit": {
-        label: "Cloudflare + LiveKit Cloud Agents",
+        label: "LiveKit",
         web: "cloudflare",
         agent: "livekit",
         provider: "livekit"
       },
-      "cloudflare-livekit-railway": {
-        label: "Cloudflare + LiveKit Agents on Railway",
+      "cloudflare-agora": {
+        label: "Agora Conversational AI",
         web: "cloudflare",
-        agent: "railway",
-        provider: "livekit"
-      },
-      "railway-livekit-cloud": {
-        label: "Railway + LiveKit Cloud Agents",
-        web: "railway",
-        agent: "livekit",
-        provider: "livekit"
-      },
-      "railway-livekit": {
-        label: "Railway + LiveKit Agents on Railway",
-        web: "railway",
-        agent: "railway",
-        provider: "livekit"
-      },
-      "zeabur-agora": {
-        label: "Zeabur + Agora Conversational AI",
-        web: "zeabur",
         agent: "agora",
         provider: "agora"
       }
@@ -661,8 +647,8 @@ async function readProjectConfig(directory) {
   }
 }
 async function webEnvironmentPath(directory) {
-  const config = await readProjectConfig(directory);
-  return config && !config.stack.startsWith("cloudflare") ? ".env.local" : ".dev.vars";
+  await readProjectConfig(directory);
+  return ".dev.vars";
 }
 var init_project_config = __esm({
   "src/project-config.ts"() {
@@ -14817,7 +14803,7 @@ var program = new Command();
 
 // src/cli.ts
 init_errors();
-import { readFile as readFile8 } from "fs/promises";
+import { readFile as readFile7 } from "fs/promises";
 import process5 from "process";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
@@ -14865,6 +14851,10 @@ import { spawn as spawn3 } from "child_process";
 init_project_config();
 init_catalog();
 
+// src/templates/composed.ts
+import { writeFile as writeFile6 } from "fs/promises";
+import { join as join9 } from "path";
+
 // src/templates/agora.ts
 init_package_managers();
 import { readFile as readFile6, writeFile as writeFile5 } from "fs/promises";
@@ -15146,6 +15136,7 @@ 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";
     if (path2 === "package-lock.json") return javascript === "npm";
@@ -15225,17 +15216,13 @@ var runAgoraSetup = async ({
       { exitCode: EXIT_CODES.invalidArgument }
     );
   const config = await readProjectConfig(targetDirectory);
-  if (config?.stack !== "zeabur-agora")
+  if (config?.stack !== "cloudflare-agora")
     throw new CliError(
       "INVALID_ARGUMENT",
-      "Expected a Zeabur + Agora project.",
+      "Expected a Cloudflare + Agora project.",
       { exitCode: EXIT_CODES.invalidArgument }
     );
-  for (const name of [
-    "package.json",
-    ".env.local.example",
-    "worker/agora.ts"
-  ]) {
+  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(
@@ -15244,7 +15231,7 @@ var runAgoraSetup = async ({
         { exitCode: EXIT_CODES.invalidArgument }
       );
   }
-  const path2 = join7(targetDirectory, ".env.local");
+  const path2 = join7(targetDirectory, ".dev.vars");
   let existing;
   try {
     const stats = await lstat4(path2);
@@ -15253,7 +15240,7 @@ var runAgoraSetup = async ({
     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 .env.local.", {
+      throw new CliError("FILESYSTEM_ERROR", "Cannot safely read .dev.vars.", {
         exitCode: EXIT_CODES.filesystem,
         path: path2
       });
@@ -15305,10 +15292,10 @@ var runAgoraSetup = async ({
     }
   }
   const rendered = mergeDotenv(
-    existing ?? await readFile5(join7(targetDirectory, ".env.local.example"), "utf8"),
+    existing ?? await readFile5(join7(targetDirectory, ".dev.vars.example"), "utf8"),
     values
   );
-  const temporary = join7(targetDirectory, `.env.local.${randomUUID3()}.tmp`);
+  const temporary = join7(targetDirectory, `.dev.vars.${randomUUID3()}.tmp`);
   try {
     await writeFile4(temporary, rendered, { flag: "wx", mode: 384 });
     await rename2(temporary, path2);
@@ -15316,7 +15303,7 @@ var runAgoraSetup = async ({
     await rm3(temporary, { force: true });
   }
   onStatus(
-    "Saved .env.local. Configure an English assistant in the published Agora pipeline, with its TTS sample rate matching AGORA_AVATAR_SAMPLE_RATE. No cloud services were started."
+    "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";
 };
@@ -15330,8 +15317,6 @@ var files = /* @__PURE__ */ new Set([
   "pnpm-workspace.yaml",
   "npmrc",
   "gitignore",
-  "dockerignore",
-  "Dockerfile",
   ".editorconfig",
   ".prettierrc.json",
   ".prettierignore",
@@ -15341,12 +15326,17 @@ var files = /* @__PURE__ */ new Set([
   "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",
-  "env.example",
-  "server/index.ts",
+  "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",
@@ -15364,8 +15354,8 @@ var files = /* @__PURE__ */ new Set([
   "web/components/agents-ui/PROVENANCE.md"
 ]);
 var agoraTemplate = {
-  id: "zeabur-agora",
-  stack: "zeabur-agora",
+  id: "cloudflare-agora",
+  stack: "cloudflare-agora",
   requiresPython: false,
   humanSteps: [
     {
@@ -15376,17 +15366,13 @@ var agoraTemplate = {
     }
   ],
   directory: "templates/cloudflare-livekit",
-  description: "Zeabur + Agora Conversational AI",
+  description: "Cloudflare Workers + Agora Conversational AI",
   components: [
     "- web/       React + Spatius AvatarKit + Agora",
-    "- server/    Node HTTP API; Agora hosts the conversational agent"
+    "- worker/    Cloudflare API; Agora hosts the conversational agent"
   ],
   layers: [
     { directory: "templates/layers/catalog" },
-    {
-      directory: "templates/layers/node",
-      overrides: ["vite.config.ts", "package-lock.json", "pnpm-lock.yaml"]
-    },
     {
       directory: "templates/layers/agora",
       overrides: [
@@ -15395,7 +15381,10 @@ var agoraTemplate = {
         "pnpm-lock.yaml",
         "web/App.tsx",
         "worker/index.ts",
-        "tsconfig.json",
+        "worker/index.test.ts",
+        "tsconfig.worker.json",
+        ".dev.vars.example",
+        "wrangler.jsonc",
         "vitest.config.ts",
         "README.md",
         "AGENTS.md"
@@ -15407,7 +15396,7 @@ var agoraTemplate = {
     return files.has(path2) || [...files].some((file) => file.startsWith(path2 + "/")) || path2 === "web/assets" || path2.startsWith("web/assets/");
   },
   mapFile(path2) {
-    return path2 === "env.example" ? ".env.local.example" : cloudflareLivekitTemplate.mapFile(path2);
+    return cloudflareLivekitTemplate.mapFile(path2);
   },
   async configure(directory, configuration) {
     const manager = configuration.packageManagers.javascript;
@@ -15419,8 +15408,20 @@ var agoraTemplate = {
     );
     if (manager.version && manager.version !== "unknown")
       pkg.packageManager = `${manager.name}@${manager.version}`;
-    pkg.scripts.check = ["format:check", "lint", "typecheck", "test", "build"].map(run).join(" && ");
-    if (manager.name === "bun") pkg.trustedDependencies = ["esbuild"];
+    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");
@@ -15431,24 +15432,7 @@ var agoraTemplate = {
     }
     await writeFile5(
       join8(directory, "spatius.config.json"),
-      JSON.stringify({ version: 2, stack: "zeabur-agora" }, null, 2) + "\n"
-    );
-    const serverPath = join8(directory, "server/index.ts");
-    await writeFile5(
-      serverPath,
-      (await readFile6(serverPath, "utf8")).replace(
-        "import { handleRequest }",
-        "import type { AgoraEnvironment } from '../worker/agora.js';\nimport { handleRequest }"
-      ).replace(
-        "const env = process.env;",
-        "const env = process.env as unknown as AgoraEnvironment;"
-      )
-    );
-    const dockerPath = join8(directory, "Dockerfile");
-    const install = manager.name === "pnpm" ? "npm install --global pnpm@12.3.4 && pnpm install --frozen-lockfile" : manager.name === "bun" ? "npm install --global bun && bun install" : "npm ci";
-    await writeFile5(
-      dockerPath,
-      (await readFile6(dockerPath, "utf8")).replace("__SPATIUS_CONTAINER_INSTALL__", install).replace("__SPATIUS_CONTAINER_BUILD__", run("build"))
+      JSON.stringify({ version: 2, stack: "cloudflare-agora" }, null, 2) + "\n"
     );
     for (const name of ["README.md", "AGENTS.md"]) {
       const path3 = join8(directory, name);
@@ -15459,7 +15443,16 @@ var agoraTemplate = {
     }
     await writeFile5(
       join8(directory, "DEPLOYMENT.md"),
-      "# Zeabur + Agora Conversational AI\n\nCreate one Zeabur service from this repository with the repository root as build root. Set ZBPACK_DOCKERFILE_PATH=Dockerfile and PORT=8787. Copy the environment variables from .env.local.example into Zeabur service variables, then generate an HTTPS domain. Use /api/health for the health check. Git redeployments rebuild the same service.\n\nThe Node service serves both frontend and API. There is no Python worker or database. 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.\n\nSession creation starts a hosted agent. Disconnect and initialization failures stop it through the backend. 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.\n\nLocal setup writes .env.local only. It never provisions Zeabur or uploads secrets.\n"
+      `# 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) {
@@ -15481,7 +15474,7 @@ var agoraTemplate = {
     ];
   },
   setup: {
-    recognizes: async (directory) => (await readProjectConfig(directory))?.stack === "zeabur-agora",
+    recognizes: async (directory) => (await readProjectConfig(directory))?.stack === "cloudflare-agora",
     run: runAgoraSetup
   },
   verification: [
@@ -15491,105 +15484,33 @@ var agoraTemplate = {
 };
 
 // src/templates/composed.ts
-init_catalog();
-import { readFile as readFile7, writeFile as writeFile6 } from "fs/promises";
-import { join as join9 } from "path";
 init_package_managers();
 function composeTemplate(stack) {
-  if (stack === "zeabur-agora") return agoraTemplate;
-  const selected = stacks[stack];
-  const node = selected.web === "railway";
+  if (stack === "cloudflare-agora") return agoraTemplate;
   return {
     ...cloudflareLivekitTemplate,
-    id: stack,
     stack,
     requiresPython: true,
-    description: selected.label,
-    components: [
-      "- web/       React + Spatius AvatarKit",
-      `- ${node ? "server/" : "worker/"}    ${selected.web} API`,
-      "- agent/     Python LiveKit agent"
-    ],
-    layers: [
-      { directory: "templates/layers/catalog" },
-      ...selected.agent === "railway" ? [{ directory: "templates/layers/railway-agent" }] : [],
-      ...node ? [
-        {
-          directory: "templates/layers/node",
-          overrides: [
-            "vite.config.ts",
-            "scripts/dev-web.mjs",
-            "package-lock.json",
-            "pnpm-lock.yaml"
-          ]
-        }
-      ] : []
-    ],
-    includeFile(path2, configuration) {
-      if (node && ["wrangler.jsonc"].includes(path2)) return false;
-      return cloudflareLivekitTemplate.includeFile(path2, configuration);
-    },
-    mapFile(path2) {
-      return node && path2 === "dev.vars.example" ? ".env.local.example" : cloudflareLivekitTemplate.mapFile(path2);
-    },
+    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 packagePath = join9(directory, "package.json");
-      const pkg = JSON.parse(await readFile7(packagePath, "utf8"));
       const manager = configuration.packageManagers.javascript.name;
       const run = (script) => javascriptRunCommand(manager, script);
-      let deployment = `# ${selected.label}
+      await writeFile6(
+        join9(directory, "DEPLOYMENT.md"),
+        `# Cloudflare Workers + LiveKit Cloud
 
-`;
-      if (node) {
-        for (const name of ["README.md", "AGENTS.md", "agent/README.md"]) {
-          const path2 = join9(directory, name);
-          await writeFile6(
-            path2,
-            (await readFile7(path2, "utf8")).replaceAll("Cloudflare Workers", "Railway").replaceAll("Cloudflare Worker", "Node API").replaceAll(".dev.vars", ".env.local") + "\nSee DEPLOYMENT.md for this stack\u2019s deployment steps.\n"
-          );
-        }
-        const workerConfigPath = join9(directory, "tsconfig.worker.json");
-        await writeFile6(
-          workerConfigPath,
-          (await readFile7(workerConfigPath, "utf8")).replace(
-            '"types": ["./worker-configuration.d.ts"]',
-            '"types": ["./worker-configuration.d.ts", "node"]'
-          ).replace(
-            '"include": ["worker", "worker-configuration.d.ts"]',
-            '"include": ["worker", "worker-configuration.d.ts", "server"]'
-          )
-        );
-        delete pkg.devDependencies["@cloudflare/vite-plugin"];
-        delete pkg.devDependencies.wrangler;
-        pkg.dependencies.tsx = "4.23.13";
-        delete pkg.scripts["cf-typegen"];
-        delete pkg.scripts.wrangler;
-        pkg.scripts.start = "node --env-file-if-exists=.env.local node_modules/tsx/dist/cli.mjs server/index.ts";
-        pkg.scripts.deploy = "railway up";
-        const dockerPath = join9(directory, "Dockerfile");
-        const install = manager === "pnpm" ? "npm install --global pnpm@12.3.4 && pnpm install --frozen-lockfile" : manager === "bun" ? "npm install --global bun && bun install" : "npm ci";
-        await writeFile6(
-          dockerPath,
-          (await readFile7(dockerPath, "utf8")).replace("__SPATIUS_CONTAINER_INSTALL__", install).replace("__SPATIUS_CONTAINER_BUILD__", run("build"))
-        );
-        deployment += "Create a Railway service from this repository with the repository root as its build root and railway.json as its configuration. Add the variables from .env.local.example in Railway. Generate a public domain. The web service serves both the frontend and /api. Deploy with `railway up`; subsequent Git deployments rebuild the service.\n\n";
-      } else {
-        deployment += `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")}\`.
+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.
 
-`;
-      }
-      if (selected.agent === "railway") {
-        deployment += "Create a separate Railway agent service from this repository, with root directory /agent and configuration /agent/railway.json. Add the variables from agent/.env.example. Keep it running continuously; do not enable sleeping. No public domain is needed. Set PORT=8081 for the agent health check. Deploy this service independently of the web service.\n";
-      } else
-        deployment += "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.\n";
-      deployment += "\nDeploy the agent before opening conversations. Use separate LiveKit projects for development and production. Local setup never uploads secrets.\n";
-      await writeFile6(join9(directory, "DEPLOYMENT.md"), deployment);
-      await writeFile6(packagePath, JSON.stringify(pkg, null, 2) + "\n");
+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.
+`
+      );
     }
   };
 }
@@ -16643,7 +16564,7 @@ async function readPackageVersion() {
   const packagePath = fileURLToPath2(
     new URL("../package.json", import.meta.url)
   );
-  const contents = await readFile8(packagePath, "utf8");
+  const contents = await readFile7(packagePath, "utf8");
   const metadata = JSON.parse(contents);
   return metadata.version;
 }
@@ -17070,9 +16991,10 @@ async function runSetupCommand(version, projectDirectoryArgument, rawOptions) {
 }
 function addCreateOptions(command) {
   return command.addOption(
-    new Option("--stack <stack>", "application and deployment stack").choices(
-      Object.keys(stacks)
-    )
+    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>",
@@ -17083,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 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");
+  ).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"
     )
@@ -17098,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