create-agents24-app 0.2.0 → 0.2.2

package/README.md

@@ -1,8 +1,8 @@
 # create-agents24-app
 
-Last Updated: 2026-09-02
+Last Updated: 2026-09-07
 
-Create a canonical Agents24 React/Vite application:
+Create a canonical Agents24 React application:
 
 ```bash
 npm create agents24-app@latest
@@ -28,7 +28,15 @@ Use `--starter deep-research` for the Planner/Researcher/Critic template, or omi
 
 The generator fetches the active compatible catalog and downloads only the selected immutable Package V2 archive. It verifies the advertised size and SHA-256 before extracting an editable `agents24/` tree with a fresh package identity. `customer-support` contains the Support Agent and empty reranked RAG foundation; `deep-research` contains the bounded Planner, Researcher, and Critic architecture with the same optional knowledge foundation. Templates never ingest content or configure credentials. `setup` combines apply, publish, and application configuration.
 
-Choose a direct client deployment or a server-backed BFF, then paste a preset code from [shadcn/create](https://ui.shadcn.com/create). Soft preset `b2D1FHzlY` is the canonical default.
+Choose a server-backed BFF (default) or direct client deployment. BFF offers Next.js (default) or Vite + Hono; direct client uses Vite. The Agent starter is an independent choice. Then paste a preset code from [shadcn/create](https://ui.shadcn.com/create). Soft preset `b2D1FHzlY` is the canonical default.
+
+```bash
+npm create agents24-app@latest my-app -- --integration bff --stack nextjs
+npm create agents24-app@latest my-app -- --integration bff --stack vite-hono
+npm create agents24-app@latest my-app -- --integration client-deployment
+```
+
+`--stack` accepts `nextjs`, `vite-hono`, or `vite`; invalid integration/stack combinations fail before generation. `--yes` now defaults to BFF + Next.js, replacing the old direct-client default. Existing Hono apps remain supported by lifecycle commands, including apps without `agents24.stack` metadata; generation does not migrate them.
 
 The normal flow does not ask for an API base URL. Generated apps use `https://api.agents24.dev`; `--base-url` remains an advanced override for localhost, staging, private deployments, or proxies. Direct mode wires public deployment authentication through the browser session controller. BFF mode exposes a Guest host-identity adapter for customer-owned identity and login/logout navigation.
 
@@ -55,4 +63,14 @@ points to the same canonical scaffold and package guidance.
 
 ## Maintainer development
 
+The stack-selection change is implemented in source and awaits canonical package publication and actual Vercel qualification. Do not assume the currently published `latest` contains it until release receipts confirm that version.
+
+## Hosting
+
+Next.js uses Node 22/24, builds without runtime credentials, and starts with the generated `build`/`start` scripts on Vercel, Railway, Render, or another Node host. For containers, enable `output: "standalone"` in `next.config.ts` before building; package `.next/static` and any `public` assets with the standalone server. Its nonce-based CSP requires dynamic, non-cached HTML. Browser BFF requests stay same-origin and credentials remain server-only.
+
+Vite + Hono keeps its Node-server deployment. It does not generate a Vercel serverless adapter. Set host environment variables separately: `agents24 publish` publishes Agent resources, and `setup` configures the local app; neither deploys your website or sets up Artifact hosting.
+
+## Local package development
+
 From the repository root, `pnpm dev:agents24` incrementally prepares the current coordinated package train, publishes it to an ephemeral loopback registry, launches this packed interactive CLI, installs the selected app, and starts it. To refresh an existing isolated generated app after every package source or version change, use `pnpm dev:agents24 -- --serve /absolute/path/to/app`; it force-reinstalls that app. Use `pnpm dev:agents24 -- --template customer-support` or `--template deep-research` to generate and set up an official template against the platform catalog. Set `AGENTS24_BASE_URL` when targeting a local backend. Unchanged tarballs, scans, and packed runners are reused from the bounded development cache; add `--fresh` for a clean rebuild.

package/dist/{chunk-ADXMZ3TT.js → chunk-F2J72UHQ.js}

@@ -2,6 +2,14 @@
 
 // src/types.ts
 var INTEGRATIONS = ["client-deployment", "bff"];
+var STACKS = ["nextjs", "vite-hono", "vite"];
+function resolveStack(integration, stack) {
+  const selected = stack ?? (integration === "bff" ? "nextjs" : "vite");
+  if (!INTEGRATIONS.includes(integration) || !STACKS.includes(selected) || (integration === "bff" ? selected === "vite" : selected !== "vite")) {
+    throw new Error(`Invalid stack/integration combination: ${selected} with ${integration}. Use bff with nextjs or vite-hono, or client-deployment with vite.`);
+  }
+  return selected;
+}
 var PACKAGE_MANAGERS = ["pnpm", "npm", "yarn", "bun"];
 var DEFAULT_PRESET = "b2D1FHzlY";
 
@@ -98,6 +106,21 @@ function generatedManifest(options, name) {
   };
   if (options.integration === "bff") {
     dependencies["@agents24/node"] = versions.agents24["@agents24/node"];
+    dependencies.zod = versions.runtime.zod;
+  }
+  if (options.stack === "nextjs") {
+    dependencies.next = versions.runtime.next;
+    dependencies["server-only"] = versions.runtime["server-only"];
+    delete devDependencies.vite;
+    delete devDependencies["@vitejs/plugin-react"];
+    delete devDependencies["@tailwindcss/vite"];
+    devDependencies["@tailwindcss/postcss"] = versions.development["@tailwindcss/postcss"];
+    scripts.dev = "next dev";
+    scripts.build = "next build";
+    scripts.start = "next start";
+    delete scripts.preview;
+  }
+  if (options.stack === "vite-hono") {
     dependencies.hono = versions.runtime.hono;
     dependencies["@hono/node-server"] = versions.runtime["@hono/node-server"];
     devDependencies.concurrently = versions.development.concurrently;
@@ -115,6 +138,7 @@ function generatedManifest(options, name) {
     engines: { node: "^22.0.0 || ^24.0.0" },
     agents24: {
       integration: options.integration,
+      stack: options.stack,
       package_manager: options.packageManager,
       preset: options.preset,
       scaffold_sha256: scaffoldManifest.sha256,
@@ -219,6 +243,7 @@ function applyShadcnPreset(directory, preset) {
   clearPresetInstallArtifacts(directory);
 }
 function createApp(options) {
+  options = { ...options, stack: resolveStack(options.integration, options.stack) };
   const destination = resolve(options.directory);
   assertDestination(destination);
   const name = packageName(destination);
@@ -230,12 +255,18 @@ function createApp(options) {
     cpSync(scaffoldRoot, staging, { recursive: true, force: true });
     rmSync(join(staging, "manifest.json"), { force: true });
     copyLayer("common", staging);
-    copyLayer(`integrations/${options.integration}`, staging);
+    if (options.integration === "bff") copyLayer("shared/bff", staging);
+    copyLayer(`integrations/${options.stack === "nextjs" ? "nextjs" : options.integration}`, staging);
+    if (options.stack === "nextjs") {
+      for (const file of ["index.html", "src/vite-env.d.ts"]) rmSync(join(staging, file), { force: true });
+    }
     materializeTemplate(staging, options);
     replaceTemplateValues(staging, {
       "__APP_NAME__": name,
       "__PRESET__": options.preset,
       "__INTEGRATION__": options.integration,
+      "__STACK__": options.stack,
+      "__HOSTING__": options.stack === "nextjs" ? "Next.js runs on Vercel or any supported Node host, including Railway and Render. Configure server variables from `.env.example` in your host; `next build` does not need runtime credentials. For containers, enable `output: 'standalone'` in `next.config.ts` before building, then copy `.next/standalone`, `.next/static` (to `.next/static` in the standalone directory), and `public` if present, then run `node server.js` with `HOSTNAME=0.0.0.0`. The document CSP uses a fresh nonce and dynamic HTML rendering. BFF routes are never cached. Streaming duration is limited by your hosting plan; the route requests 300 seconds." : options.stack === "vite-hono" ? "The production command runs the Hono Node server and serves the built Vite frontend. Configure server variables from `.env.example` in your host. This Node template does not include a Vercel serverless routing adapter." : "Deploy `dist/` to a static host. The preview command is for local verification. Configure the exact public origin in your Client Deployment and set its public build variables before building.",
       "__CONNECT_SOURCE__": options.integration === "client-deployment" ? " __AGENTS24_CONNECT_SOURCE__" : "",
       "__PM_DEV__": runScriptCommand(options.packageManager, "dev"),
       "__PM_BUILD__": runScriptCommand(options.packageManager, "build"),
@@ -411,6 +442,8 @@ async function selectTemplate(baseUrl, catalog, id) {
 
 export {
   INTEGRATIONS,
+  STACKS,
+  resolveStack,
   PACKAGE_MANAGERS,
   DEFAULT_PRESET,
   installDependencies,
@@ -419,4 +452,4 @@ export {
   compatibleTemplates,
   selectTemplate
 };
-//# sourceMappingURL=chunk-ADXMZ3TT.js.map
+//# sourceMappingURL=chunk-F2J72UHQ.js.map

package/dist/chunk-F2J72UHQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/generator.ts","../src/template-catalog.ts"],"sourcesContent":["export const INTEGRATIONS = [\"client-deployment\", \"bff\"] as const;\nexport const STACKS = [\"nextjs\", \"vite-hono\", \"vite\"] as const;\nexport type Stack = (typeof STACKS)[number];\n\nexport function resolveStack(integration: Integration, stack?: Stack): Stack {\n  const selected = stack ?? (integration === \"bff\" ? \"nextjs\" : \"vite\");\n  if (!INTEGRATIONS.includes(integration) || !STACKS.includes(selected) ||\n      (integration === \"bff\" ? selected === \"vite\" : selected !== \"vite\")) {\n    throw new Error(`Invalid stack/integration combination: ${selected} with ${integration}. Use bff with nextjs or vite-hono, or client-deployment with vite.`);\n  }\n  return selected;\n}\nexport const PACKAGE_MANAGERS = [\"pnpm\", \"npm\", \"yarn\", \"bun\"] as const;\nexport const DEFAULT_PRESET = \"b2D1FHzlY\";\n\nexport type Integration = (typeof INTEGRATIONS)[number];\nexport type PackageManager = (typeof PACKAGE_MANAGERS)[number];\nexport type Starter = string;\n\nexport type TemplateSelection = {\n  id: Starter;\n  version: string;\n  displayName: string;\n  sha256: string;\n  catalogRevision: string;\n  files: Map<string, string>;\n};\n\nexport type CreateAppOptions = {\n  directory: string;\n  integration: Integration;\n  stack?: Stack;\n  preset: string;\n  packageManager: PackageManager;\n  install: boolean;\n  baseUrl: string;\n  starter?: TemplateSelection;\n  deploymentId?: string;\n  agentId?: string;\n  agentAlias?: string;\n  agentVersionId?: string;\n};\n\nexport type GeneratedApp = {\n  directory: string;\n  packageName: string;\n};\n","import { spawnSync } from \"node:child_process\";\nimport { randomBytes } from \"node:crypto\";\nimport {\n  chmodSync,\n  cpSync,\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  renameSync,\n  rmSync,\n  statSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { basename, dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { createRequire } from \"node:module\";\n\nimport { DEFAULT_PRESET, resolveStack, type CreateAppOptions, type GeneratedApp, type PackageManager } from \"./types.js\";\n\ntype Versions = {\n  agents24: Record<string, string>;\n  runtime: Record<string, string>;\n  development: Record<string, string>;\n};\n\nconst packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), \"..\");\nconst templateRoot = join(packageRoot, \"templates\");\nconst scaffoldRoot = join(packageRoot, \"dist/scaffold\");\nconst scaffoldManifest = JSON.parse(readFileSync(join(packageRoot, \"dist/scaffold-manifest.json\"), \"utf8\")) as {\n  dependencies: Record<string, string>;\n  devDependencies: Record<string, string>;\n  sha256: string;\n};\nconst versions = JSON.parse(readFileSync(join(packageRoot, \"versions.json\"), \"utf8\")) as Versions;\nconst require = createRequire(import.meta.url);\n\nfunction packageName(directory: string): string {\n  const value = basename(resolve(directory))\n    .toLowerCase()\n    .replace(/[^a-z0-9._-]+/g, \"-\")\n    .replace(/^[._-]+|[._-]+$/g, \"\");\n  if (!value || !/^[a-z0-9]/.test(value)) throw new Error(\"The destination does not produce a valid npm package name.\");\n  return value;\n}\n\nfunction assertDestination(destination: string): void {\n  if (!existsSync(destination)) return;\n  if (!statSync(destination).isDirectory()) throw new Error(\"The destination already exists and is not a directory.\");\n  if (readdirSync(destination).length > 0) throw new Error(\"The destination directory must be empty.\");\n}\n\nfunction walk(directory: string): string[] {\n  return readdirSync(directory, { withFileTypes: true }).flatMap((entry) => {\n    const path = join(directory, entry.name);\n    return entry.isDirectory() ? walk(path) : [path];\n  });\n}\n\nfunction replaceTemplateValues(directory: string, replacements: Record<string, string>): void {\n  for (const file of walk(directory)) {\n    if (file.endsWith(\".png\") || file.endsWith(\".ico\")) continue;\n    let content = readFileSync(file, \"utf8\");\n    for (const [token, value] of Object.entries(replacements)) content = content.split(token).join(value);\n    writeFileSync(file, content);\n  }\n}\n\nfunction copyLayer(name: string, destination: string): void {\n  cpSync(join(templateRoot, name), destination, { recursive: true, force: true });\n}\n\nfunction materializeTemplate(destination: string, options: CreateAppOptions): void {\n  if (!options.starter) return;\n  const packageId = `pkg_${randomBytes(16).toString(\"hex\")}`;\n  let replacedManifest = false;\n  for (const [path, original] of options.starter.files) {\n    let content = original;\n    if (path === \"agents24.yaml\") {\n      content = content.replace(/^(package_id:\\s*)[^\\s#]+/m, `$1${packageId}`);\n      replacedManifest = content !== original;\n    }\n    const target = join(destination, \"agents24\", path);\n    mkdirSync(dirname(target), { recursive: true });\n    writeFileSync(target, content);\n  }\n  if (!replacedManifest) throw new Error(\"The selected Agent template has no replaceable package_id.\");\n}\n\nfunction generatedManifest(options: CreateAppOptions, name: string): Record<string, unknown> {\n  const dependencies: Record<string, string> = {\n    \"@agents24/client\": versions.agents24[\"@agents24/client\"]!,\n    \"@agents24/react\": versions.agents24[\"@agents24/react\"]!,\n    \"@agents24/chat-react\": versions.agents24[\"@agents24/chat-react\"]!,\n    ...scaffoldManifest.dependencies,\n    react: versions.runtime.react!,\n    \"react-dom\": versions.runtime[\"react-dom\"]!,\n  };\n  const devDependencies: Record<string, string> = {\n    \"@types/node\": versions.development[\"@types/node\"]!,\n    \"@types/react\": versions.development[\"@types/react\"]!,\n    \"@types/react-dom\": versions.development[\"@types/react-dom\"]!,\n    \"@vitejs/plugin-react\": versions.development[\"@vitejs/plugin-react\"]!,\n    ...scaffoldManifest.devDependencies,\n    typescript: versions.development.typescript!,\n    vite: versions.development.vite!,\n  };\n  const scripts: Record<string, string> = {\n    dev: \"vite\",\n    build: \"tsc --noEmit && vite build\",\n    preview: \"vite preview\",\n    preset: \"node scripts/apply-preset.mjs\",\n  };\n  if (options.integration === \"bff\") {\n    dependencies[\"@agents24/node\"] = versions.agents24[\"@agents24/node\"]!;\n    dependencies.zod = versions.runtime.zod!;\n  }\n  if (options.stack === \"nextjs\") {\n    dependencies.next = versions.runtime.next!;\n    dependencies[\"server-only\"] = versions.runtime[\"server-only\"]!;\n    delete devDependencies.vite;\n    delete devDependencies[\"@vitejs/plugin-react\"];\n    delete devDependencies[\"@tailwindcss/vite\"];\n    devDependencies[\"@tailwindcss/postcss\"] = versions.development[\"@tailwindcss/postcss\"]!;\n    scripts.dev = \"next dev\";\n    scripts.build = \"next build\";\n    scripts.start = \"next start\";\n    delete scripts.preview;\n  }\n  if (options.stack === \"vite-hono\") {\n    dependencies.hono = versions.runtime.hono!;\n    dependencies[\"@hono/node-server\"] = versions.runtime[\"@hono/node-server\"]!;\n    devDependencies.concurrently = versions.development.concurrently!;\n    devDependencies.tsx = versions.development.tsx!;\n    devDependencies.tsup = \"^8.5.1\";\n    scripts.dev = \"concurrently -k -n web,bff \\\"vite\\\" \\\"tsx watch server/index.ts\\\"\";\n    scripts.build = \"tsc --noEmit && vite build && tsup server/index.ts --format esm --platform node --out-dir server-dist --external @agents24/node --external hono --external @hono/node-server\";\n    scripts.start = \"node server-dist/index.js --production\";\n  }\n  return {\n    name,\n    private: true,\n    version: \"0.0.0\",\n    type: \"module\",\n    engines: { node: \"^22.0.0 || ^24.0.0\" },\n    agents24: {\n      integration: options.integration,\n      stack: options.stack,\n      package_manager: options.packageManager,\n      preset: options.preset,\n      scaffold_sha256: scaffoldManifest.sha256,\n      ...(options.starter ? { template: {\n        id: options.starter.id,\n        version: options.starter.version,\n        sha256: options.starter.sha256,\n        catalog_revision: options.starter.catalogRevision,\n      } } : {}),\n    },\n    scripts,\n    dependencies,\n    devDependencies,\n  };\n}\n\nfunction envFiles(options: CreateAppOptions, appName: string): { example: string; local: string } {\n  const value = (input: string | undefined) => JSON.stringify(String(input || \"\"));\n  const jsonValue = (input: unknown) => JSON.stringify(input);\n  const baseUrlOverride = options.baseUrl === \"https://api.agents24.dev\" ? [] : [\n    `${options.integration === \"client-deployment\" ? \"VITE_\" : \"\"}AGENTS24_BASE_URL=${value(options.baseUrl)}`,\n  ];\n  if (options.integration === \"client-deployment\") {\n    return {\n      example: \"# VITE_AGENTS24_BASE_URL=http://localhost:8026 # optional advanced override\\nVITE_AGENTS24_DEPLOYMENT_ID=acd_your_public_deployment_id\\n\",\n      local: [...baseUrlOverride, ...(options.deploymentId ? [`VITE_AGENTS24_DEPLOYMENT_ID=${value(options.deploymentId)}`] : []), \"\"].join(\"\\n\"),\n    };\n  }\n  return {\n    example: [\n      \"# AGENTS24_BASE_URL=http://localhost:8026 # optional advanced override\",\n      \"AGENTS24_API_KEY=your_server_only_api_key\",\n      \"# agentVersion accepts draft, latest, or an exact published version such as v1\",\n      \"AGENTS24_AGENTS=[{\\\"agentAlias\\\":\\\"your-agent-alias\\\",\\\"agentVersion\\\":\\\"v1\\\"}]\",\n      \"# agentId remains supported instead of agentAlias when UUID configuration is preferred\",\n      \"AGENTS24_INTEGRATION_ID=generate_one_stable_random_value\",\n      \"AGENTS24_INTEGRATION_NAME=your_app_name # optional\",\n      \"# AGENTS24_RUNTIME_TARGET=draft # optional server-only override\",\n      \"SESSION_COOKIE_SECRET=generate_at_least_32_random_bytes\",\n      \"PORT=3001\",\n      \"\",\n    ].join(\"\\n\"),\n    local: [\n      ...baseUrlOverride,\n      ...(options.agentAlias || options.agentId ? [\n        `AGENTS24_AGENTS=${jsonValue([{ ...(options.agentAlias ? { agentAlias: options.agentAlias } : { agentId: options.agentId }), ...(options.agentVersionId ? { agentVersionId: options.agentVersionId } : {}) }])}`,\n      ] : []),\n      `AGENTS24_INTEGRATION_ID=${value(randomBytes(24).toString(\"base64url\"))}`,\n      `AGENTS24_INTEGRATION_NAME=${value(appName)}`,\n      `SESSION_COOKIE_SECRET=${value(randomBytes(32).toString(\"base64url\"))}`,\n      \"PORT=3001\",\n      \"\",\n    ].join(\"\\n\"),\n  };\n}\n\nfunction installCommand(packageManager: PackageManager): [string, string[]] {\n  if (packageManager === \"npm\") return [\"npm\", [\"install\"]];\n  if (packageManager === \"yarn\") return [\"yarn\", []];\n  if (packageManager === \"bun\") return [\"bun\", [\"install\"]];\n  return [\"pnpm\", [\"install\", \"--ignore-workspace\"]];\n}\n\nfunction runScriptCommand(packageManager: PackageManager, script: string): string {\n  if (packageManager === \"npm\") return `npm run ${script}`;\n  if (packageManager === \"bun\") return `bun run ${script}`;\n  return `${packageManager} ${script}`;\n}\n\nexport function installDependencies(directory: string, packageManager: PackageManager): void {\n  const [command, args] = installCommand(packageManager);\n  const { AGENTS24_API_KEY: _apiKey, ...installerEnvironment } = process.env;\n  const result = spawnSync(command, args, { cwd: directory, stdio: \"inherit\", env: installerEnvironment });\n  if (result.error) throw new Error(`Could not start ${command}: ${result.error.message}`);\n  if (result.status !== 0) throw new Error(`${command} ${args.join(\" \")} failed with exit ${result.status}.`);\n}\n\nfunction clearPresetInstallArtifacts(directory: string): void {\n  for (const name of [\"node_modules\", \"bun.lock\", \"bun.lockb\", \"package-lock.json\", \"pnpm-lock.yaml\", \"yarn.lock\"]) {\n    rmSync(join(directory, name), { recursive: true, force: true });\n  }\n}\n\nfunction applyShadcnPreset(directory: string, preset: string): void {\n  if (preset === DEFAULT_PRESET) return;\n  const executable = require.resolve(\"shadcn\");\n  const { AGENTS24_API_KEY: _apiKey, ...presetEnvironment } = process.env;\n  const result = spawnSync(\n    process.execPath,\n    [executable, \"apply\", preset, \"--yes\", \"--silent\", \"--cwd\", directory],\n    { cwd: directory, encoding: \"utf8\", env: presetEnvironment },\n  );\n  if (result.error) throw new Error(`Could not start Shadcn preset materialization: ${result.error.message}`);\n  if (result.status !== 0) {\n    const detail = String(result.stderr || result.stdout || \"\").trim().split(\"\\n\").at(-1);\n    throw new Error(detail || `Shadcn could not apply preset ${preset}.`);\n  }\n  const scopeResult = spawnSync(\n    process.execPath,\n    [join(directory, \"scripts/scope-preset-theme.mjs\")],\n    { cwd: directory, encoding: \"utf8\" },\n  );\n  if (scopeResult.error) throw new Error(`Could not scope the selected Shadcn preset: ${scopeResult.error.message}`);\n  if (scopeResult.status !== 0) {\n    const detail = String(scopeResult.stderr || scopeResult.stdout || \"\").trim().split(\"\\n\").at(-1);\n    throw new Error(detail || `Could not scope Shadcn preset ${preset}.`);\n  }\n  clearPresetInstallArtifacts(directory);\n}\n\nexport function createApp(options: CreateAppOptions): GeneratedApp {\n  options = { ...options, stack: resolveStack(options.integration, options.stack) };\n  const destination = resolve(options.directory);\n  assertDestination(destination);\n  const name = packageName(destination);\n  const parent = dirname(destination);\n  mkdirSync(parent, { recursive: true });\n  const staging = join(parent, `.${name}.agents24-${randomBytes(6).toString(\"hex\")}`);\n  try {\n    mkdirSync(staging, { mode: 0o700 });\n    cpSync(scaffoldRoot, staging, { recursive: true, force: true });\n    rmSync(join(staging, \"manifest.json\"), { force: true });\n    copyLayer(\"common\", staging);\n    if (options.integration === \"bff\") copyLayer(\"shared/bff\", staging);\n    copyLayer(`integrations/${options.stack === \"nextjs\" ? \"nextjs\" : options.integration}`, staging);\n    if (options.stack === \"nextjs\") {\n      for (const file of [\"index.html\", \"src/vite-env.d.ts\"]) rmSync(join(staging, file), { force: true });\n    }\n    materializeTemplate(staging, options);\n    replaceTemplateValues(staging, {\n      \"__APP_NAME__\": name,\n      \"__PRESET__\": options.preset,\n      \"__INTEGRATION__\": options.integration,\n      \"__STACK__\": options.stack!,\n      \"__HOSTING__\": options.stack === \"nextjs\"\n        ? \"Next.js runs on Vercel or any supported Node host, including Railway and Render. Configure server variables from `.env.example` in your host; `next build` does not need runtime credentials. For containers, enable `output: 'standalone'` in `next.config.ts` before building, then copy `.next/standalone`, `.next/static` (to `.next/static` in the standalone directory), and `public` if present, then run `node server.js` with `HOSTNAME=0.0.0.0`. The document CSP uses a fresh nonce and dynamic HTML rendering. BFF routes are never cached. Streaming duration is limited by your hosting plan; the route requests 300 seconds.\"\n        : options.stack === \"vite-hono\"\n          ? \"The production command runs the Hono Node server and serves the built Vite frontend. Configure server variables from `.env.example` in your host. This Node template does not include a Vercel serverless routing adapter.\"\n          : \"Deploy `dist/` to a static host. The preview command is for local verification. Configure the exact public origin in your Client Deployment and set its public build variables before building.\",\n      \"__CONNECT_SOURCE__\": options.integration === \"client-deployment\" ? \" __AGENTS24_CONNECT_SOURCE__\" : \"\",\n      \"__PM_DEV__\": runScriptCommand(options.packageManager, \"dev\"),\n      \"__PM_BUILD__\": runScriptCommand(options.packageManager, \"build\"),\n      \"__PM_PRODUCTION__\": runScriptCommand(options.packageManager, options.integration === \"bff\" ? \"start\" : \"preview\"),\n      \"__PM_PRESET__\": `${runScriptCommand(options.packageManager, \"preset\")} --`,\n      \"__STARTER_SETUP__\": options.starter\n        ? `## Set up the included Agent\\n\\nThis repository includes an editable Resource Package in \\`agents24/\\`. For a BFF, run \\`agents24 apply ./agents24\\` to reconcile drafts and \\`agents24 publish ./agents24\\` for production. For a direct-client app, run \\`agents24 setup ./agents24 --app .\\` so publication happens before deployment configuration. Use \\`agents24 dev ./agents24\\` when a local Artifact server is required.`\n        : \"\",\n    });\n    const gitignore = join(staging, \"_gitignore\");\n    if (existsSync(gitignore)) renameSync(gitignore, join(staging, \".gitignore\"));\n    writeFileSync(join(staging, \"package.json\"), `${JSON.stringify(generatedManifest(options, name), null, 2)}\\n`);\n    applyShadcnPreset(staging, options.preset);\n    const env = envFiles(options, name);\n    writeFileSync(join(staging, \".env.example\"), env.example);\n    if (options.install) installDependencies(staging, options.packageManager);\n    writeFileSync(join(staging, \".env.local\"), env.local, { mode: 0o600 });\n    chmodSync(join(staging, \".env.local\"), 0o600);\n    if (existsSync(destination)) rmSync(destination, { recursive: true });\n    renameSync(staging, destination);\n    return { directory: destination, packageName: name };\n  } catch (error) {\n    rmSync(staging, { recursive: true, force: true });\n    throw error;\n  }\n}\n","import { createHash } from \"node:crypto\";\nimport { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from \"node:fs\";\nimport { homedir, tmpdir } from \"node:os\";\nimport { dirname, join } from \"node:path\";\n\nimport { unpackFiles } from \"@agents24/cli\";\n\nimport { type Starter, type TemplateSelection } from \"./types.js\";\n\ntype CatalogTemplate = {\n  id: string;\n  version: string;\n  display_name: string;\n  description: string;\n  compatibility: { min_generator_version?: string; resource_package_schema?: string };\n  archive: { sha256: string; size: number; download_url: string };\n};\n\ntype Catalog = {\n  schema_version: \"agents24.template-catalog.v1\";\n  revision: string;\n  templates: CatalogTemplate[];\n};\n\ntype CachedCatalog = { etag?: string; catalog: Catalog };\n\nconst GENERATOR_VERSION = \"0.2.0\";\nconst SHA256 = /^[0-9a-f]{64}$/;\nconst SEMVER = /^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)$/;\nconst TEMPLATE_ID = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;\n\nfunction cacheRoot(): string {\n  const override = String(process.env.AGENTS24_TEMPLATE_CACHE_DIR || \"\").trim();\n  if (override) return override;\n  const platformRoot = process.platform === \"win32\"\n    ? process.env.LOCALAPPDATA\n    : process.env.XDG_CACHE_HOME || join(homedir(), \".cache\");\n  return join(platformRoot || tmpdir(), \"agents24\", \"templates-v1\");\n}\n\nfunction atomicWrite(path: string, data: string | Uint8Array): void {\n  mkdirSync(dirname(path), { recursive: true, mode: 0o700 });\n  const temporary = `${path}.${process.pid}.tmp`;\n  writeFileSync(temporary, data, { mode: 0o600 });\n  renameSync(temporary, path);\n}\n\nfunction parseVersion(value: string): [number, number, number] | null {\n  const match = SEMVER.exec(value);\n  return match ? [Number(match[1]), Number(match[2]), Number(match[3])] : null;\n}\n\nfunction compatible(item: CatalogTemplate): boolean {\n  const minimum = parseVersion(String(item.compatibility?.min_generator_version || \"0.0.0\"));\n  const current = parseVersion(GENERATOR_VERSION)!;\n  if (!minimum || item.compatibility?.resource_package_schema !== \"2.0\") return false;\n  return current[0] > minimum[0]\n    || (current[0] === minimum[0] && current[1] > minimum[1])\n    || (current[0] === minimum[0] && current[1] === minimum[1] && current[2] >= minimum[2]);\n}\n\nfunction validateCatalog(value: unknown): Catalog {\n  const catalog = value as Catalog;\n  if (catalog?.schema_version !== \"agents24.template-catalog.v1\" || !SHA256.test(catalog.revision) || !Array.isArray(catalog.templates)) {\n    throw new Error(\"The Agents24 template catalog is invalid.\");\n  }\n  const ids = new Set<string>();\n  for (const item of catalog.templates) {\n    if (!TEMPLATE_ID.test(item?.id) || ids.has(item.id) || !SEMVER.test(item.version)\n      || !item.display_name || !SHA256.test(item.archive?.sha256) || !Number.isSafeInteger(item.archive?.size)\n      || item.archive.size < 1 || item.archive.size > 5 * 1024 * 1024 || !item.archive.download_url?.startsWith(\"/templates/\")) {\n      throw new Error(\"The Agents24 template catalog contains an invalid release.\");\n    }\n    ids.add(item.id);\n  }\n  return catalog;\n}\n\nfunction readCachedCatalog(path: string): CachedCatalog | null {\n  try {\n    const cached = JSON.parse(readFileSync(path, \"utf8\")) as CachedCatalog;\n    return { ...(cached.etag ? { etag: cached.etag } : {}), catalog: validateCatalog(cached.catalog) };\n  } catch {\n    return null;\n  }\n}\n\nexport async function loadTemplateCatalog(baseUrl: string): Promise<{ catalog: Catalog; live: boolean }> {\n  const path = join(cacheRoot(), \"catalog.json\");\n  const cached = existsSync(path) ? readCachedCatalog(path) : null;\n  try {\n    const response = await fetch(new URL(\"/templates\", `${baseUrl}/`), {\n      headers: cached?.etag ? { \"If-None-Match\": cached.etag } : {},\n      signal: AbortSignal.timeout(10_000),\n    });\n    if (response.status === 304 && cached) return { catalog: cached.catalog, live: true };\n    if (!response.ok) throw new Error(`catalog request returned ${response.status}`);\n    const catalog = validateCatalog(await response.json());\n    const etag = response.headers.get(\"etag\") || undefined;\n    atomicWrite(path, `${JSON.stringify({ ...(etag ? { etag } : {}), catalog })}\\n`);\n    return { catalog, live: true };\n  } catch (error) {\n    if (cached) return { catalog: cached.catalog, live: false };\n    const detail = error instanceof Error ? error.message : \"request failed\";\n    throw new Error(`Could not load the Agents24 template catalog (${detail}), and no verified cached catalog is available.`);\n  }\n}\n\nexport function compatibleTemplates(catalog: Catalog): CatalogTemplate[] {\n  return catalog.templates.filter(compatible);\n}\n\nfunction verifiedArchive(path: string, item: CatalogTemplate): Uint8Array | null {\n  try {\n    const archive = readFileSync(path);\n    if (archive.byteLength !== item.archive.size || createHash(\"sha256\").update(archive).digest(\"hex\") !== item.archive.sha256) return null;\n    unpackFiles(archive);\n    return archive;\n  } catch {\n    return null;\n  }\n}\n\nasync function readArchiveResponse(response: Response, expectedSize: number): Promise<Uint8Array> {\n  if (!response.body) throw new Error(\"Template download returned no archive body.\");\n  const reader = response.body.getReader();\n  const chunks: Uint8Array[] = [];\n  let size = 0;\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    size += value.byteLength;\n    if (size > expectedSize || size > 5 * 1024 * 1024) {\n      await reader.cancel();\n      throw new Error(\"Template download exceeds its advertised archive size.\");\n    }\n    chunks.push(value);\n  }\n  const archive = new Uint8Array(size);\n  let offset = 0;\n  for (const chunk of chunks) {\n    archive.set(chunk, offset);\n    offset += chunk.byteLength;\n  }\n  return archive;\n}\n\nexport async function selectTemplate(baseUrl: string, catalog: Catalog, id: string): Promise<TemplateSelection> {\n  if (id === \"rag\") throw new Error(\"The 'rag' starter was removed. Use --starter customer-support or --starter deep-research.\");\n  const item = catalog.templates.find((candidate) => candidate.id === id);\n  if (!item) throw new Error(`Template '${id}' is not available in the active catalog.`);\n  if (!compatible(item)) throw new Error(`Template '${id}' requires a newer create-agents24-app release.`);\n  const path = join(cacheRoot(), \"archives\", `${item.archive.sha256}.zip`);\n  let archive = existsSync(path) ? verifiedArchive(path, item) : null;\n  if (!archive) {\n    let response: Response;\n    try {\n      response = await fetch(new URL(item.archive.download_url, `${baseUrl}/`), { signal: AbortSignal.timeout(30_000) });\n    } catch (error) {\n      throw new Error(`Could not download template '${id}', and no verified cached archive is available.`);\n    }\n    if (!response.ok) throw new Error(`Could not download template '${id}' (HTTP ${response.status}).`);\n    const length = response.headers.get(\"content-length\");\n    if (length && Number(length) !== item.archive.size) throw new Error(`Template '${id}' download size does not match the catalog.`);\n    archive = await readArchiveResponse(response, item.archive.size);\n    if (archive.byteLength !== item.archive.size || createHash(\"sha256\").update(archive).digest(\"hex\") !== item.archive.sha256) {\n      throw new Error(`Template '${id}' failed integrity verification.`);\n    }\n    unpackFiles(archive);\n    atomicWrite(path, archive);\n  }\n  return {\n    id: item.id as Starter,\n    version: item.version,\n    displayName: item.display_name,\n    sha256: item.archive.sha256,\n    catalogRevision: catalog.revision,\n    files: unpackFiles(archive),\n  };\n}\n"],"mappings":"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","names":["require","existsSync","mkdirSync","readFileSync","renameSync","writeFileSync","dirname","join"]}

package/dist/cli.js

@@ -3,11 +3,13 @@ import {
   DEFAULT_PRESET,
   INTEGRATIONS,
   PACKAGE_MANAGERS,
+  STACKS,
   compatibleTemplates,
   createApp,
   loadTemplateCatalog,
+  resolveStack,
   selectTemplate
-} from "./chunk-ADXMZ3TT.js";
+} from "./chunk-F2J72UHQ.js";
 
 // src/cli.ts
 import { writeFileSync } from "fs";
@@ -18,6 +20,7 @@ import { intro, outro } from "@clack/prompts";
 import process from "process";
 var VALUE_FLAGS = /* @__PURE__ */ new Set([
   "integration",
+  "stack",
   "preset",
   "package-manager",
   "base-url",
@@ -59,6 +62,7 @@ Usage:
 
 Options:
   --integration <client-deployment|bff>
+  --stack <nextjs|vite-hono|vite>   BFF defaults to Next.js; direct client uses Vite
   --preset <shadcn-preset-code>     Defaults to b2D1FHzlY
   --package-manager <pnpm|npm|yarn|bun>
   --base-url <url>
@@ -122,6 +126,7 @@ async function resolveOptions(args) {
   const nonInteractive = args.flags.yes === true;
   let directory = args.directory;
   let integration = oneOf(flag(args, "integration"), INTEGRATIONS, "integration");
+  let stack = oneOf(flag(args, "stack"), STACKS, "stack");
   let preset = flag(args, "preset");
   let packageManager = oneOf(flag(args, "package-manager"), PACKAGE_MANAGERS, "package-manager");
   let baseUrl = flag(args, "base-url");
@@ -131,38 +136,33 @@ async function resolveOptions(args) {
     directory ||= await requiredText("Where should the app be created?", "my-agents24-app");
     if (!integration) {
       const result = await select({ message: "How should the app connect?", options: [
-        { value: "client-deployment", label: "Client deployment", hint: "Direct anonymous browser connection" },
-        { value: "bff", label: "Server BFF", hint: "API key remains on your Node server" }
+        { value: "bff", label: "Server BFF (recommended)", hint: "API key remains on your server" },
+        { value: "client-deployment", label: "Client deployment", hint: "Direct browser connection" }
       ] });
       cancelled(result);
       integration = result;
     }
-    preset ||= await requiredText(
-      "Shadcn preset code",
-      DEFAULT_PRESET,
-      (value) => PRESET.test(value) ? void 0 : "Enter a valid Shadcn preset code."
-    );
-    if (!packageManager) {
-      const detected = detectedPackageManager();
-      const result = await select({ message: "Package manager", initialValue: detected, options: PACKAGE_MANAGERS.map((value) => ({ value, label: value })) });
-      cancelled(result);
-      packageManager = result;
-    }
-    if (args.flags["no-install"] !== true) {
-      const result = await confirm({ message: "Install dependencies?", initialValue: true });
+    if (integration === "bff" && !stack) {
+      const result = await select({ message: "Application stack", initialValue: "nextjs", options: [
+        { value: "nextjs", label: "Next.js (recommended)", hint: "Full-stack App Router application" },
+        { value: "vite-hono", label: "Vite + Hono", hint: "Vite frontend and Node server" }
+      ] });
       cancelled(result);
-      install = result;
+      stack = result;
     }
   }
+  integration ||= "bff";
+  stack = resolveStack(integration, stack);
+  if (integration === "bff" && flag(args, "deployment-id")) throw new Error("--deployment-id requires --integration client-deployment.");
+  if (integration === "client-deployment" && ["agent-id", "agent-alias", "agent-version-id"].some((name) => flag(args, name))) {
+    throw new Error("Agent selectors require --integration bff.");
+  }
   directory = String(directory || "").trim();
-  integration ||= "client-deployment";
-  preset ||= DEFAULT_PRESET;
-  packageManager ||= detectedPackageManager();
   baseUrl ||= "https://api.agents24.dev";
   const urlError = validateUrl(baseUrl);
   if (!directory) throw new Error("A destination directory is required.");
   if (urlError) throw new Error(urlError);
-  if (!PRESET.test(preset)) throw new Error("--preset must be a valid Shadcn preset code.");
+  if (preset && !PRESET.test(preset)) throw new Error("--preset must be a valid Shadcn preset code.");
   let starter;
   if (requestedStarter || !nonInteractive) {
     const { catalog } = await loadTemplateCatalog(baseUrl);
@@ -181,10 +181,30 @@ async function resolveOptions(args) {
     }
     if (selectedId) starter = await selectTemplate(baseUrl, catalog, selectedId);
   }
+  if (!nonInteractive) {
+    preset ||= await requiredText(
+      "Shadcn preset code",
+      DEFAULT_PRESET,
+      (value) => PRESET.test(value) ? void 0 : "Enter a valid Shadcn preset code."
+    );
+    if (!packageManager) {
+      const detected = detectedPackageManager();
+      const result = await select({ message: "Package manager", initialValue: detected, options: PACKAGE_MANAGERS.map((value) => ({ value, label: value })) });
+      cancelled(result);
+      packageManager = result;
+    }
+    if (args.flags["no-install"] !== true) {
+      const result = await confirm({ message: "Install dependencies?", initialValue: true });
+      cancelled(result);
+      install = result;
+    }
+  }
+  preset ||= DEFAULT_PRESET;
+  packageManager ||= detectedPackageManager();
   if (integration === "client-deployment") {
     const deploymentId = flag(args, "deployment-id");
     if (deploymentId && !DEPLOYMENT_ID.test(deploymentId)) throw new Error("--deployment-id must be a valid public acd_\u2026 deployment ID.");
-    return { directory, integration, preset, packageManager, install, baseUrl, starter, deploymentId };
+    return { directory, integration, stack, preset, packageManager, install, baseUrl, starter, deploymentId };
   }
   const fields = {
     agentId: flag(args, "agent-id"),
@@ -197,7 +217,7 @@ async function resolveOptions(args) {
   if (fields.agentAlias && !/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(fields.agentAlias)) {
     throw new Error("--agent-alias must be lowercase kebab-case.");
   }
-  return { directory, integration, preset, packageManager, install, baseUrl, starter, ...fields };
+  return { directory, integration, stack, preset, packageManager, install, baseUrl, starter, ...fields };
 }
 
 // src/cli.ts
@@ -221,6 +241,7 @@ async function main() {
       ...generated,
       install: options.install,
       integration: options.integration,
+      stack: options.stack,
       packageManager: options.packageManager
     })}
 `, { mode: 384 });

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts","../src/arguments.ts","../src/prompts.ts"],"sourcesContent":["import { writeFileSync } from \"node:fs\";\nimport process from \"node:process\";\nimport { intro, outro } from \"@clack/prompts\";\n\nimport { HELP, parseArguments } from \"./arguments.js\";\nimport { createApp } from \"./generator.js\";\nimport { resolveOptions } from \"./prompts.js\";\n\nfunction scriptCommand(packageManager: string, script: string): string {\n  if (packageManager === \"npm\") return `npm run ${script}`;\n  if (packageManager === \"bun\") return `bun run ${script}`;\n  return `${packageManager} ${script}`;\n}\n\nasync function main(): Promise<void> {\n  const args = parseArguments();\n  if (args.flags.help) {\n    process.stdout.write(`${HELP}\\n`);\n    return;\n  }\n  intro(\"Create Agents24 App\");\n  const options = await resolveOptions(args);\n  const generated = createApp(options);\n  if (process.env.AGENTS24_CREATE_RESULT_FILE) {\n    writeFileSync(process.env.AGENTS24_CREATE_RESULT_FILE, `${JSON.stringify({\n      ...generated,\n      install: options.install,\n      integration: options.integration,\n      packageManager: options.packageManager,\n    })}\\n`, { mode: 0o600 });\n  }\n  const relative = generated.directory.startsWith(`${process.cwd()}/`)\n    ? generated.directory.slice(process.cwd().length + 1)\n    : generated.directory;\n  const install = `${options.packageManager} install`;\n  const productionScript = options.integration === \"bff\" ? \"start\" : \"preview\";\n  outro([\n    `Created ${generated.packageName}`,\n    \"\",\n    `  cd ${relative}`,\n    `  ${install}${options.install ? \"  # already completed\" : \"\"}`,\n    `  ${scriptCommand(options.packageManager, \"dev\")}`,\n    `  ${scriptCommand(options.packageManager, \"build\")}`,\n    `  ${scriptCommand(options.packageManager, productionScript)}`,\n  ].join(\"\\n\"));\n}\n\nmain().catch((error: unknown) => {\n  const message = error instanceof Error ? error.message : \"App creation failed.\";\n  process.stderr.write(`create-agents24-app: ${message}\\n`);\n  process.exitCode = 1;\n});\n","import process from \"node:process\";\n\nexport type ParsedArguments = {\n  directory?: string;\n  flags: Record<string, string | boolean>;\n};\n\nconst VALUE_FLAGS = new Set([\n  \"integration\",\n  \"preset\",\n  \"package-manager\",\n  \"base-url\",\n  \"deployment-id\",\n  \"agent-id\",\n  \"agent-alias\",\n  \"agent-version-id\",\n  \"starter\",\n]);\nconst BOOLEAN_FLAGS = new Set([\"yes\", \"no-install\", \"help\"]);\n\nexport function parseArguments(argv = process.argv.slice(2)): ParsedArguments {\n  const flags: Record<string, string | boolean> = {};\n  let directory: string | undefined;\n  for (let index = 0; index < argv.length; index += 1) {\n    const argument = argv[index] || \"\";\n    if (!argument.startsWith(\"--\")) {\n      if (directory) throw new Error(\"Only one destination directory may be provided.\");\n      directory = argument;\n      continue;\n    }\n    const [rawName, inlineValue] = argument.slice(2).split(\"=\", 2);\n    if (BOOLEAN_FLAGS.has(rawName)) {\n      if (inlineValue !== undefined) throw new Error(`--${rawName} does not accept a value.`);\n      flags[rawName] = true;\n      continue;\n    }\n    if (!VALUE_FLAGS.has(rawName)) throw new Error(`Unknown option: --${rawName}`);\n    const value = inlineValue ?? argv[index + 1];\n    if (!value || value.startsWith(\"--\")) throw new Error(`--${rawName} requires a value.`);\n    flags[rawName] = value;\n    if (inlineValue === undefined) index += 1;\n  }\n  return { ...(directory ? { directory } : {}), flags };\n}\n\nexport const HELP = `Create an Agents24 React application.\n\nUsage:\n  npm create agents24-app@latest [directory] [options]\n\nOptions:\n  --integration <client-deployment|bff>\n  --preset <shadcn-preset-code>     Defaults to b2D1FHzlY\n  --package-manager <pnpm|npm|yarn|bun>\n  --base-url <url>\n  --deployment-id <acd_...>        Client deployment mode\n  --agent-id <uuid>                BFF mode\n  --agent-alias <alias>            BFF mode; preferred human-readable selector\n  --agent-version-id <uuid>        Optional pinned BFF version\n  --starter <template-id>          customer-support or deep-research\n  --no-install\n  --yes                            Disable prompts; required values must be supplied\n  --help\n\nRun agents24 apply for drafts, agents24 publish for production, or agents24 setup to perform both and configure the app.`;\n","import process from \"node:process\";\nimport { confirm, isCancel, select, text } from \"@clack/prompts\";\n\nimport type { ParsedArguments } from \"./arguments.js\";\nimport {\n  INTEGRATIONS,\n  PACKAGE_MANAGERS,\n  DEFAULT_PRESET,\n  type CreateAppOptions,\n  type Integration,\n  type PackageManager,\n} from \"./types.js\";\nimport { compatibleTemplates, loadTemplateCatalog, selectTemplate } from \"./template-catalog.js\";\n\nconst UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\nconst DEPLOYMENT_ID = /^acd_[A-Za-z0-9_-]{10,}$/;\nconst PRESET = /^[A-Za-z0-9]{6,32}$/;\n\nfunction cancelled<T>(value: T): asserts value is Exclude<T, symbol> {\n  if (isCancel(value)) throw new Error(\"App creation cancelled.\");\n}\n\nfunction flag(args: ParsedArguments, name: string): string | undefined {\n  const value = args.flags[name];\n  return typeof value === \"string\" ? value.trim() : undefined;\n}\n\nfunction oneOf<T extends string>(value: string | undefined, choices: readonly T[], field: string): T | undefined {\n  if (value === undefined) return undefined;\n  if (!choices.includes(value as T)) throw new Error(`${field} must be one of: ${choices.join(\", \")}.`);\n  return value as T;\n}\n\nfunction detectedPackageManager(): PackageManager {\n  const name = String(process.env.npm_config_user_agent || \"\").split(\"/\")[0];\n  return PACKAGE_MANAGERS.includes(name as PackageManager) ? name as PackageManager : \"pnpm\";\n}\n\nfunction validateUrl(value: string): string | undefined {\n  try {\n    const parsed = new URL(value);\n    if (/[\\r\\n\\0]/.test(value) || parsed.username || parsed.password || parsed.search || parsed.hash) {\n      return \"Use a base URL without credentials, query parameters, or fragments.\";\n    }\n    return parsed.protocol === \"https:\" || (parsed.protocol === \"http:\" && [\"localhost\", \"127.0.0.1\", \"::1\"].includes(parsed.hostname))\n      ? undefined\n      : \"Use HTTPS, or HTTP for a local development server.\";\n  } catch { return \"Enter a valid URL.\"; }\n}\n\nasync function requiredText(message: string, initialValue: string | undefined, validate?: (value: string) => string | undefined): Promise<string> {\n  const result = await text({\n    message,\n    ...(initialValue ? { initialValue } : {}),\n    validate(value) {\n      const normalized = String(value || \"\").trim();\n      return normalized ? validate?.(normalized) : \"This value is required.\";\n    },\n  });\n  cancelled(result);\n  return String(result).trim();\n}\n\nexport async function resolveOptions(args: ParsedArguments): Promise<CreateAppOptions> {\n  const nonInteractive = args.flags.yes === true;\n  let directory = args.directory;\n  let integration = oneOf(flag(args, \"integration\"), INTEGRATIONS, \"integration\");\n  let preset = flag(args, \"preset\");\n  let packageManager = oneOf(flag(args, \"package-manager\"), PACKAGE_MANAGERS, \"package-manager\");\n  let baseUrl = flag(args, \"base-url\");\n  const requestedStarter = flag(args, \"starter\");\n  let install = args.flags[\"no-install\"] !== true;\n\n  if (!nonInteractive) {\n    directory ||= await requiredText(\"Where should the app be created?\", \"my-agents24-app\");\n    if (!integration) {\n      const result = await select<Integration>({ message: \"How should the app connect?\", options: [\n        { value: \"client-deployment\", label: \"Client deployment\", hint: \"Direct anonymous browser connection\" },\n        { value: \"bff\", label: \"Server BFF\", hint: \"API key remains on your Node server\" },\n      ] });\n      cancelled(result); integration = result;\n    }\n    preset ||= await requiredText(\n      \"Shadcn preset code\",\n      DEFAULT_PRESET,\n      (value) => PRESET.test(value) ? undefined : \"Enter a valid Shadcn preset code.\",\n    );\n    if (!packageManager) {\n      const detected = detectedPackageManager();\n      const result = await select<PackageManager>({ message: \"Package manager\", initialValue: detected, options: PACKAGE_MANAGERS.map((value) => ({ value, label: value })) });\n      cancelled(result); packageManager = result;\n    }\n    if (args.flags[\"no-install\"] !== true) {\n      const result = await confirm({ message: \"Install dependencies?\", initialValue: true });\n      cancelled(result); install = result;\n    }\n  }\n\n  directory = String(directory || \"\").trim();\n  integration ||= \"client-deployment\";\n  preset ||= DEFAULT_PRESET;\n  packageManager ||= detectedPackageManager();\n  baseUrl ||= \"https://api.agents24.dev\";\n  const urlError = validateUrl(baseUrl);\n  if (!directory) throw new Error(\"A destination directory is required.\");\n  if (urlError) throw new Error(urlError);\n  if (!PRESET.test(preset)) throw new Error(\"--preset must be a valid Shadcn preset code.\");\n\n  let starter;\n  if (requestedStarter || !nonInteractive) {\n    const { catalog } = await loadTemplateCatalog(baseUrl);\n    let selectedId = requestedStarter;\n    if (!selectedId) {\n      const templates = compatibleTemplates(catalog);\n      const result = await select<string>({\n        message: \"Start with an Agent template?\",\n        options: [\n          { value: \"none\", label: \"No Agent template\" },\n          ...templates.map((item) => ({ value: item.id, label: item.display_name, hint: item.description })),\n        ],\n      });\n      cancelled(result);\n      selectedId = result === \"none\" ? undefined : result;\n    }\n    if (selectedId) starter = await selectTemplate(baseUrl, catalog, selectedId);\n  }\n\n  if (integration === \"client-deployment\") {\n    const deploymentId = flag(args, \"deployment-id\");\n    if (deploymentId && !DEPLOYMENT_ID.test(deploymentId)) throw new Error(\"--deployment-id must be a valid public acd_… deployment ID.\");\n    return { directory, integration, preset, packageManager, install, baseUrl, starter, deploymentId };\n  }\n\n  const fields = {\n    agentId: flag(args, \"agent-id\"),\n    agentAlias: flag(args, \"agent-alias\"),\n    agentVersionId: flag(args, \"agent-version-id\"),\n  };\n  if (fields.agentId && fields.agentAlias) throw new Error(\"Use either --agent-id or --agent-alias, not both.\");\n  if (fields.agentId && !UUID.test(fields.agentId)) throw new Error(\"--agent-id must be a valid UUID.\");\n  if (fields.agentVersionId && !UUID.test(fields.agentVersionId)) throw new Error(\"--agent-version-id must be a valid UUID.\");\n  if (fields.agentAlias && !/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(fields.agentAlias)) {\n    throw new Error(\"--agent-alias must be lowercase kebab-case.\");\n  }\n  return { directory, integration, preset, packageManager, install, baseUrl, starter, ...fields } as CreateAppOptions;\n}\n"],"mappings":"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","names":["process","process","process","process"]}
+{"version":3,"sources":["../src/cli.ts","../src/arguments.ts","../src/prompts.ts"],"sourcesContent":["import { writeFileSync } from \"node:fs\";\nimport process from \"node:process\";\nimport { intro, outro } from \"@clack/prompts\";\n\nimport { HELP, parseArguments } from \"./arguments.js\";\nimport { createApp } from \"./generator.js\";\nimport { resolveOptions } from \"./prompts.js\";\n\nfunction scriptCommand(packageManager: string, script: string): string {\n  if (packageManager === \"npm\") return `npm run ${script}`;\n  if (packageManager === \"bun\") return `bun run ${script}`;\n  return `${packageManager} ${script}`;\n}\n\nasync function main(): Promise<void> {\n  const args = parseArguments();\n  if (args.flags.help) {\n    process.stdout.write(`${HELP}\\n`);\n    return;\n  }\n  intro(\"Create Agents24 App\");\n  const options = await resolveOptions(args);\n  const generated = createApp(options);\n  if (process.env.AGENTS24_CREATE_RESULT_FILE) {\n    writeFileSync(process.env.AGENTS24_CREATE_RESULT_FILE, `${JSON.stringify({\n      ...generated,\n      install: options.install,\n      integration: options.integration,\n      stack: options.stack,\n      packageManager: options.packageManager,\n    })}\\n`, { mode: 0o600 });\n  }\n  const relative = generated.directory.startsWith(`${process.cwd()}/`)\n    ? generated.directory.slice(process.cwd().length + 1)\n    : generated.directory;\n  const install = `${options.packageManager} install`;\n  const productionScript = options.integration === \"bff\" ? \"start\" : \"preview\";\n  outro([\n    `Created ${generated.packageName}`,\n    \"\",\n    `  cd ${relative}`,\n    `  ${install}${options.install ? \"  # already completed\" : \"\"}`,\n    `  ${scriptCommand(options.packageManager, \"dev\")}`,\n    `  ${scriptCommand(options.packageManager, \"build\")}`,\n    `  ${scriptCommand(options.packageManager, productionScript)}`,\n  ].join(\"\\n\"));\n}\n\nmain().catch((error: unknown) => {\n  const message = error instanceof Error ? error.message : \"App creation failed.\";\n  process.stderr.write(`create-agents24-app: ${message}\\n`);\n  process.exitCode = 1;\n});\n","import process from \"node:process\";\n\nexport type ParsedArguments = {\n  directory?: string;\n  flags: Record<string, string | boolean>;\n};\n\nconst VALUE_FLAGS = new Set([\n  \"integration\",\n  \"stack\",\n  \"preset\",\n  \"package-manager\",\n  \"base-url\",\n  \"deployment-id\",\n  \"agent-id\",\n  \"agent-alias\",\n  \"agent-version-id\",\n  \"starter\",\n]);\nconst BOOLEAN_FLAGS = new Set([\"yes\", \"no-install\", \"help\"]);\n\nexport function parseArguments(argv = process.argv.slice(2)): ParsedArguments {\n  const flags: Record<string, string | boolean> = {};\n  let directory: string | undefined;\n  for (let index = 0; index < argv.length; index += 1) {\n    const argument = argv[index] || \"\";\n    if (!argument.startsWith(\"--\")) {\n      if (directory) throw new Error(\"Only one destination directory may be provided.\");\n      directory = argument;\n      continue;\n    }\n    const [rawName, inlineValue] = argument.slice(2).split(\"=\", 2);\n    if (BOOLEAN_FLAGS.has(rawName)) {\n      if (inlineValue !== undefined) throw new Error(`--${rawName} does not accept a value.`);\n      flags[rawName] = true;\n      continue;\n    }\n    if (!VALUE_FLAGS.has(rawName)) throw new Error(`Unknown option: --${rawName}`);\n    const value = inlineValue ?? argv[index + 1];\n    if (!value || value.startsWith(\"--\")) throw new Error(`--${rawName} requires a value.`);\n    flags[rawName] = value;\n    if (inlineValue === undefined) index += 1;\n  }\n  return { ...(directory ? { directory } : {}), flags };\n}\n\nexport const HELP = `Create an Agents24 React application.\n\nUsage:\n  npm create agents24-app@latest [directory] [options]\n\nOptions:\n  --integration <client-deployment|bff>\n  --stack <nextjs|vite-hono|vite>   BFF defaults to Next.js; direct client uses Vite\n  --preset <shadcn-preset-code>     Defaults to b2D1FHzlY\n  --package-manager <pnpm|npm|yarn|bun>\n  --base-url <url>\n  --deployment-id <acd_...>        Client deployment mode\n  --agent-id <uuid>                BFF mode\n  --agent-alias <alias>            BFF mode; preferred human-readable selector\n  --agent-version-id <uuid>        Optional pinned BFF version\n  --starter <template-id>          customer-support or deep-research\n  --no-install\n  --yes                            Disable prompts; required values must be supplied\n  --help\n\nRun agents24 apply for drafts, agents24 publish for production, or agents24 setup to perform both and configure the app.`;\n","import process from \"node:process\";\nimport { confirm, isCancel, select, text } from \"@clack/prompts\";\n\nimport type { ParsedArguments } from \"./arguments.js\";\nimport {\n  INTEGRATIONS,\n  STACKS,\n  resolveStack,\n  type Stack,\n  PACKAGE_MANAGERS,\n  DEFAULT_PRESET,\n  type CreateAppOptions,\n  type Integration,\n  type PackageManager,\n} from \"./types.js\";\nimport { compatibleTemplates, loadTemplateCatalog, selectTemplate } from \"./template-catalog.js\";\n\nconst UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\nconst DEPLOYMENT_ID = /^acd_[A-Za-z0-9_-]{10,}$/;\nconst PRESET = /^[A-Za-z0-9]{6,32}$/;\n\nfunction cancelled<T>(value: T): asserts value is Exclude<T, symbol> {\n  if (isCancel(value)) throw new Error(\"App creation cancelled.\");\n}\n\nfunction flag(args: ParsedArguments, name: string): string | undefined {\n  const value = args.flags[name];\n  return typeof value === \"string\" ? value.trim() : undefined;\n}\n\nfunction oneOf<T extends string>(value: string | undefined, choices: readonly T[], field: string): T | undefined {\n  if (value === undefined) return undefined;\n  if (!choices.includes(value as T)) throw new Error(`${field} must be one of: ${choices.join(\", \")}.`);\n  return value as T;\n}\n\nfunction detectedPackageManager(): PackageManager {\n  const name = String(process.env.npm_config_user_agent || \"\").split(\"/\")[0];\n  return PACKAGE_MANAGERS.includes(name as PackageManager) ? name as PackageManager : \"pnpm\";\n}\n\nfunction validateUrl(value: string): string | undefined {\n  try {\n    const parsed = new URL(value);\n    if (/[\\r\\n\\0]/.test(value) || parsed.username || parsed.password || parsed.search || parsed.hash) {\n      return \"Use a base URL without credentials, query parameters, or fragments.\";\n    }\n    return parsed.protocol === \"https:\" || (parsed.protocol === \"http:\" && [\"localhost\", \"127.0.0.1\", \"::1\"].includes(parsed.hostname))\n      ? undefined\n      : \"Use HTTPS, or HTTP for a local development server.\";\n  } catch { return \"Enter a valid URL.\"; }\n}\n\nasync function requiredText(message: string, initialValue: string | undefined, validate?: (value: string) => string | undefined): Promise<string> {\n  const result = await text({\n    message,\n    ...(initialValue ? { initialValue } : {}),\n    validate(value) {\n      const normalized = String(value || \"\").trim();\n      return normalized ? validate?.(normalized) : \"This value is required.\";\n    },\n  });\n  cancelled(result);\n  return String(result).trim();\n}\n\nexport async function resolveOptions(args: ParsedArguments): Promise<CreateAppOptions> {\n  const nonInteractive = args.flags.yes === true;\n  let directory = args.directory;\n  let integration = oneOf(flag(args, \"integration\"), INTEGRATIONS, \"integration\");\n  let stack = oneOf(flag(args, \"stack\"), STACKS, \"stack\");\n  let preset = flag(args, \"preset\");\n  let packageManager = oneOf(flag(args, \"package-manager\"), PACKAGE_MANAGERS, \"package-manager\");\n  let baseUrl = flag(args, \"base-url\");\n  const requestedStarter = flag(args, \"starter\");\n  let install = args.flags[\"no-install\"] !== true;\n\n  if (!nonInteractive) {\n    directory ||= await requiredText(\"Where should the app be created?\", \"my-agents24-app\");\n    if (!integration) {\n      const result = await select<Integration>({ message: \"How should the app connect?\", options: [\n        { value: \"bff\", label: \"Server BFF (recommended)\", hint: \"API key remains on your server\" },\n        { value: \"client-deployment\", label: \"Client deployment\", hint: \"Direct browser connection\" },\n      ] });\n      cancelled(result); integration = result;\n    }\n    if (integration === \"bff\" && !stack) {\n      const result = await select<Stack>({ message: \"Application stack\", initialValue: \"nextjs\", options: [\n        { value: \"nextjs\", label: \"Next.js (recommended)\", hint: \"Full-stack App Router application\" },\n        { value: \"vite-hono\", label: \"Vite + Hono\", hint: \"Vite frontend and Node server\" },\n      ] });\n      cancelled(result); stack = result;\n    }\n  }\n\n  integration ||= \"bff\";\n  stack = resolveStack(integration, stack);\n  if (integration === \"bff\" && flag(args, \"deployment-id\")) throw new Error(\"--deployment-id requires --integration client-deployment.\");\n  if (integration === \"client-deployment\" && [\"agent-id\", \"agent-alias\", \"agent-version-id\"].some((name) => flag(args, name))) {\n    throw new Error(\"Agent selectors require --integration bff.\");\n  }\n\n  directory = String(directory || \"\").trim();\n  baseUrl ||= \"https://api.agents24.dev\";\n  const urlError = validateUrl(baseUrl);\n  if (!directory) throw new Error(\"A destination directory is required.\");\n  if (urlError) throw new Error(urlError);\n  if (preset && !PRESET.test(preset)) throw new Error(\"--preset must be a valid Shadcn preset code.\");\n\n  let starter;\n  if (requestedStarter || !nonInteractive) {\n    const { catalog } = await loadTemplateCatalog(baseUrl);\n    let selectedId = requestedStarter;\n    if (!selectedId) {\n      const templates = compatibleTemplates(catalog);\n      const result = await select<string>({\n        message: \"Start with an Agent template?\",\n        options: [\n          { value: \"none\", label: \"No Agent template\" },\n          ...templates.map((item) => ({ value: item.id, label: item.display_name, hint: item.description })),\n        ],\n      });\n      cancelled(result);\n      selectedId = result === \"none\" ? undefined : result;\n    }\n    if (selectedId) starter = await selectTemplate(baseUrl, catalog, selectedId);\n  }\n\n  if (!nonInteractive) {\n    preset ||= await requiredText(\n      \"Shadcn preset code\",\n      DEFAULT_PRESET,\n      (value) => PRESET.test(value) ? undefined : \"Enter a valid Shadcn preset code.\",\n    );\n    if (!packageManager) {\n      const detected = detectedPackageManager();\n      const result = await select<PackageManager>({ message: \"Package manager\", initialValue: detected, options: PACKAGE_MANAGERS.map((value) => ({ value, label: value })) });\n      cancelled(result); packageManager = result;\n    }\n    if (args.flags[\"no-install\"] !== true) {\n      const result = await confirm({ message: \"Install dependencies?\", initialValue: true });\n      cancelled(result); install = result;\n    }\n  }\n  preset ||= DEFAULT_PRESET;\n  packageManager ||= detectedPackageManager();\n\n  if (integration === \"client-deployment\") {\n    const deploymentId = flag(args, \"deployment-id\");\n    if (deploymentId && !DEPLOYMENT_ID.test(deploymentId)) throw new Error(\"--deployment-id must be a valid public acd_… deployment ID.\");\n    return { directory, integration, stack, preset, packageManager, install, baseUrl, starter, deploymentId };\n  }\n\n  const fields = {\n    agentId: flag(args, \"agent-id\"),\n    agentAlias: flag(args, \"agent-alias\"),\n    agentVersionId: flag(args, \"agent-version-id\"),\n  };\n  if (fields.agentId && fields.agentAlias) throw new Error(\"Use either --agent-id or --agent-alias, not both.\");\n  if (fields.agentId && !UUID.test(fields.agentId)) throw new Error(\"--agent-id must be a valid UUID.\");\n  if (fields.agentVersionId && !UUID.test(fields.agentVersionId)) throw new Error(\"--agent-version-id must be a valid UUID.\");\n  if (fields.agentAlias && !/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(fields.agentAlias)) {\n    throw new Error(\"--agent-alias must be lowercase kebab-case.\");\n  }\n  return { directory, integration, stack, preset, packageManager, install, baseUrl, starter, ...fields } as CreateAppOptions;\n}\n"],"mappings":"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","names":["process","process","process","process"]}

package/dist/index.d.ts

@@ -1,4 +1,7 @@
 declare const INTEGRATIONS: readonly ["client-deployment", "bff"];
+declare const STACKS: readonly ["nextjs", "vite-hono", "vite"];
+type Stack = (typeof STACKS)[number];
+declare function resolveStack(integration: Integration, stack?: Stack): Stack;
 declare const PACKAGE_MANAGERS: readonly ["pnpm", "npm", "yarn", "bun"];
 declare const DEFAULT_PRESET = "b2D1FHzlY";
 type Integration = (typeof INTEGRATIONS)[number];
@@ -15,6 +18,7 @@ type TemplateSelection = {
 type CreateAppOptions = {
     directory: string;
     integration: Integration;
+    stack?: Stack;
     preset: string;
     packageManager: PackageManager;
     install: boolean;
@@ -60,4 +64,4 @@ declare function loadTemplateCatalog(baseUrl: string): Promise<{
 declare function compatibleTemplates(catalog: Catalog): CatalogTemplate[];
 declare function selectTemplate(baseUrl: string, catalog: Catalog, id: string): Promise<TemplateSelection>;
 
-export { type CreateAppOptions, DEFAULT_PRESET, type GeneratedApp, INTEGRATIONS, type Integration, PACKAGE_MANAGERS, type PackageManager, type Starter, type TemplateSelection, compatibleTemplates, createApp, installDependencies, loadTemplateCatalog, selectTemplate };
+export { type CreateAppOptions, DEFAULT_PRESET, type GeneratedApp, INTEGRATIONS, type Integration, PACKAGE_MANAGERS, type PackageManager, STACKS, type Stack, type Starter, type TemplateSelection, compatibleTemplates, createApp, installDependencies, loadTemplateCatalog, resolveStack, selectTemplate };

package/dist/index.js

@@ -3,20 +3,24 @@ import {
   DEFAULT_PRESET,
   INTEGRATIONS,
   PACKAGE_MANAGERS,
+  STACKS,
   compatibleTemplates,
   createApp,
   installDependencies,
   loadTemplateCatalog,
+  resolveStack,
   selectTemplate
-} from "./chunk-ADXMZ3TT.js";
+} from "./chunk-F2J72UHQ.js";
 export {
   DEFAULT_PRESET,
   INTEGRATIONS,
   PACKAGE_MANAGERS,
+  STACKS,
   compatibleTemplates,
   createApp,
   installDependencies,
   loadTemplateCatalog,
+  resolveStack,
   selectTemplate
 };
 //# sourceMappingURL=index.js.map

package/dist/scaffold/src/components/chat/chat-composer.tsx

@@ -290,9 +290,11 @@ export function ChatComposer({
             </Button>
           ) : (
             validationError ? (
-              <Tooltip tabIndex={0}>
+              <Tooltip>
                 <TooltipTrigger asChild>
-                  <Button size="icon" aria-label="Send message" disabled onClick={() => void submit()}><ArrowUp /></Button>
+                  <span tabIndex={0} aria-label={validationError}>
+                    <Button size="icon" aria-label="Send message" disabled onClick={() => void submit()}><ArrowUp /></Button>
+                  </span>
                 </TooltipTrigger>
                 <TooltipContent>{validationError}</TooltipContent>
               </Tooltip>

package/dist/scaffold-manifest.json

@@ -20,7 +20,7 @@
     "tailwindcss": "^4.1.16"
   },
   "source": "packages/agents24-chat-react/scaffold",
-  "sha256": "8327db5822a239a119e1dc5e1c6ce8cce9ada218b1baf0a7de32bcfc38f87a14",
+  "sha256": "219ce9cefa31343090e56a1f27418985a9f75fa1e1aaa59468e1cdaaf1b07841",
   "files": [
     "components.json",
     "manifest.json",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-agents24-app",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Create a production-ready Agents24 React application.",
   "license": "MIT",
   "repository": {
@@ -33,7 +33,7 @@
     "provenance": false
   },
   "dependencies": {
-    "@agents24/cli": "0.3.2",
+    "@agents24/cli": "0.3.4",
     "@clack/prompts": "1.7.0",
     "shadcn": "4.13.1"
   },

package/templates/common/README.md

@@ -1,8 +1,8 @@
 # __APP_NAME__
 
-Last Updated: 2026-07-29
+Last Updated: 2026-09-07
 
-This app was generated by `create-agents24-app` with the `__INTEGRATION__` integration and Shadcn preset `__PRESET__`.
+This app was generated by `create-agents24-app` with the `__INTEGRATION__` integration, `__STACK__` stack, and Shadcn preset `__PRESET__`.
 
 The app includes a strict document CSP. If you deploy the static client-deployment build without the generated BFF, configure your host to send `Content-Security-Policy: frame-ancestors 'none'`; browsers do not honor that directive in an HTML meta tag.
 
@@ -18,6 +18,10 @@ __STARTER_SETUP__
 
 ## Production
 
+__HOSTING__
+
+`agents24 publish` publishes Agent resources; it does not deploy this website or upload its environment variables.
+
 ```bash
 __PM_BUILD__
 __PM_PRODUCTION__

package/templates/common/_gitignore

@@ -1,6 +1,8 @@
 node_modules
 dist
 server-dist
+.next
+.vercel
 .env.local
 *.log
 *.tsbuildinfo

package/templates/integrations/bff/server/index.ts

@@ -2,26 +2,16 @@ import { readFile } from "node:fs/promises";
 import { resolve } from "node:path";
 import { serve } from "@hono/node-server";
 import { serveStatic } from "@hono/node-server/serve-static";
-import { Agents24 } from "@agents24/node";
-import { createAgents24BffHandler } from "@agents24/node/bff";
 import { Hono } from "hono";
 
-import { env } from "./env.js";
-import { resolveAgents24Principal, revokeAgents24Principal } from "./principal.js";
+import { getServerEnvironment } from "./env";
+import { handleAgents24 } from "./handler";
 
-const client = new Agents24({
-  baseUrl: env.AGENTS24_BASE_URL,
-  apiKey: env.AGENTS24_API_KEY,
-});
-const agents24 = createAgents24BffHandler({
-  client,
-  agents: env.AGENTS24_AGENTS,
-  integrationId: env.AGENTS24_INTEGRATION_ID,
-  integrationName: env.AGENTS24_INTEGRATION_NAME,
-  runtimeTarget: (env.AGENTS24_RUNTIME_TARGET || (process.env.NODE_ENV === "production" ? "published" : "draft")) as "draft" | "published",
-  resolvePrincipal: resolveAgents24Principal,
-  revokePrincipal: (request) => revokeAgents24Principal(request),
-});
+try { process.loadEnvFile(".env.local"); }
+catch (error) { if ((error as NodeJS.ErrnoException).code !== "ENOENT") throw error; }
+if (process.argv.includes("--production")) process.env.NODE_ENV = "production";
+const env = getServerEnvironment();
+const production = process.env.NODE_ENV === "production";
 const app = new Hono();
 
 app.use("*", async (context, next) => {
@@ -31,14 +21,14 @@ app.use("*", async (context, next) => {
   context.header("X-Content-Type-Options", "nosniff");
   context.header("X-Frame-Options", "DENY");
 });
-app.all("/api/agents24", (context) => agents24(context.req.raw));
-app.all("/api/agents24/*", (context) => agents24(context.req.raw));
+app.all("/api/agents24", (context) => handleAgents24(context.req.raw));
+app.all("/api/agents24/*", (context) => handleAgents24(context.req.raw));
 
-if (process.argv.includes("--production") || process.env.NODE_ENV === "production") {
+if (production) {
   app.use("*", serveStatic({ root: "./dist" }));
   app.get("*", async (context) => context.html(await readFile(resolve("dist/index.html"), "utf8")));
 }
 
-serve({ fetch: app.fetch, hostname: "127.0.0.1", port: env.PORT }, (info) => {
+serve({ fetch: app.fetch, hostname: production ? "0.0.0.0" : "127.0.0.1", port: env.PORT }, (info) => {
   process.stdout.write(`Agents24 app listening on http://127.0.0.1:${info.port}\n`);
 });

package/templates/integrations/nextjs/app/api/agents24/[[...path]]/route.ts

@@ -0,0 +1,14 @@
+import "server-only";
+import { handleAgents24 } from "../../../../server/handler";
+
+export const runtime = "nodejs";
+export const dynamic = "force-dynamic";
+export const maxDuration = 300;
+
+export const GET = handleAgents24;
+export const POST = handleAgents24;
+export const PUT = handleAgents24;
+export const PATCH = handleAgents24;
+export const DELETE = handleAgents24;
+export const HEAD = handleAgents24;
+export const OPTIONS = handleAgents24;

package/templates/integrations/nextjs/app/chat.tsx

@@ -0,0 +1,8 @@
+"use client";
+
+import dynamic from "next/dynamic";
+
+// The chat controller and query navigation own browser state. Do not initialize
+// them during server rendering or share a controller between server requests.
+const Chat = dynamic(() => import("@/chat-app"), { ssr: false });
+export default Chat;

package/templates/integrations/nextjs/app/layout.tsx

@@ -0,0 +1,10 @@
+import type { Metadata, Viewport } from "next";
+import type { ReactNode } from "react";
+import "../src/styles.css";
+
+export const metadata: Metadata = { title: "__APP_NAME__" };
+export const viewport: Viewport = { width: "device-width", initialScale: 1, viewportFit: "cover" };
+
+export default function RootLayout({ children }: { children: ReactNode }) {
+  return <html lang="en"><body><div id="root">{children}</div></body></html>;
+}

package/templates/integrations/nextjs/app/page.tsx

@@ -0,0 +1,8 @@
+import { connection } from "next/server";
+import Chat from "./chat";
+
+export default async function Page() {
+  // Each HTML response must use the fresh CSP nonce supplied by proxy.ts.
+  await connection();
+  return <Chat />;
+}

package/templates/integrations/nextjs/next-env.d.ts

@@ -0,0 +1,2 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />

package/templates/integrations/nextjs/next.config.ts

@@ -0,0 +1,13 @@
+import type { NextConfig } from "next";
+
+const config: NextConfig = {
+  poweredByHeader: false,
+  async headers() {
+    return [{ source: "/:path*", headers: [
+      { key: "Referrer-Policy", value: "no-referrer" },
+      { key: "X-Content-Type-Options", value: "nosniff" },
+      { key: "X-Frame-Options", value: "DENY" },
+    ] }];
+  },
+};
+export default config;

package/templates/integrations/nextjs/postcss.config.mjs

@@ -0,0 +1 @@
+export default { plugins: { "@tailwindcss/postcss": {} } };

package/templates/integrations/nextjs/proxy.ts

@@ -0,0 +1,29 @@
+import { randomBytes } from "node:crypto";
+import { NextResponse, type NextRequest } from "next/server";
+
+export function proxy(request: NextRequest) {
+  const nonce = randomBytes(16).toString("base64");
+  const development = process.env.NODE_ENV === "development";
+  const csp = [
+    "default-src 'self'",
+    "base-uri 'none'",
+    "object-src 'none'",
+    `script-src 'self' 'nonce-${nonce}' 'strict-dynamic'${development ? " 'unsafe-eval'" : ""}`,
+    `style-src 'self' 'nonce-${nonce}'`,
+    // Radix positioning and chat layout use React style attributes, not executable scripts.
+    "style-src-attr 'unsafe-inline'",
+    "font-src 'self' data:",
+    "img-src 'self' data: blob:",
+    `connect-src 'self'${development ? " ws: wss:" : ""}`,
+    "form-action 'self'",
+    "frame-ancestors 'none'",
+  ].join("; ");
+  const headers = new Headers(request.headers);
+  headers.set("Content-Security-Policy", csp);
+  const response = NextResponse.next({ request: { headers } });
+  response.headers.set("Content-Security-Policy", csp);
+  response.headers.set("Cache-Control", "private, no-store");
+  return response;
+}
+
+export const config = { matcher: ["/((?!api(?:/|$)|_next/|favicon.ico).*)"] };

package/templates/integrations/nextjs/src/chat-app.tsx

@@ -0,0 +1,23 @@
+"use client";
+
+import { createBffAgentClient } from "@agents24/client/bff";
+import { useState } from "react";
+import { Agents24ChatScaffold } from "@/index";
+import { useThreadQueryNavigation } from "@/use-thread-query-navigation";
+import { getHostIdentity } from "@/host-identity";
+
+export default function ChatApp() {
+  const [client] = useState(() => createBffAgentClient({ basePath: "/api/agents24" }));
+  const navigation = useThreadQueryNavigation();
+  return <Agents24ChatScaffold
+    client={client}
+    identity={getHostIdentity()}
+    activeThreadId={navigation.activeThreadId}
+    onActiveThreadIdChange={navigation.onActiveThreadIdChange}
+    completeMcpAuthorization={async ({ completion, serverId }) => {
+      if (completion.serverId !== serverId || !completion.connectionId) {
+        throw new Error("MCP authorization did not return the expected connection.");
+      }
+    }}
+  />;
+}

package/templates/integrations/nextjs/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["DOM", "DOM.Iterable", "ES2022"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": { "@/*": ["./src/*"] }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts", ".next/dev/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/templates/{integrations → shared}/bff/server/env.ts

@@ -1,10 +1,5 @@
 import process from "node:process";
 
-try { process.loadEnvFile?.(".env.local"); }
-catch (error) {
-  if ((error as NodeJS.ErrnoException).code !== "ENOENT") throw error;
-}
-
 const REQUIRED = [
   "AGENTS24_API_KEY",
   "AGENTS24_AGENTS",
@@ -62,21 +57,29 @@ function agentsConfig(): {
   return { agents, impliedRuntimeTarget: impliedTargets.values().next().value };
 }
 
-const parsedAgents = agentsConfig();
-const explicitRuntimeTarget = String(process.env.AGENTS24_RUNTIME_TARGET || "").trim() || undefined;
-if (explicitRuntimeTarget && !["draft", "published"].includes(explicitRuntimeTarget)) throw new Error("AGENTS24_RUNTIME_TARGET must be draft or published.");
-if (explicitRuntimeTarget && parsedAgents.impliedRuntimeTarget && explicitRuntimeTarget !== parsedAgents.impliedRuntimeTarget) {
-  throw new Error("AGENTS24_RUNTIME_TARGET conflicts with the configured agentVersion selectors.");
-}
+export function readServerEnvironment() {
+  const parsedAgents = agentsConfig();
+  const explicitRuntimeTarget = String(process.env.AGENTS24_RUNTIME_TARGET || "").trim() || undefined;
+  if (explicitRuntimeTarget && !["draft", "published"].includes(explicitRuntimeTarget)) throw new Error("AGENTS24_RUNTIME_TARGET must be draft or published.");
+  if (explicitRuntimeTarget && parsedAgents.impliedRuntimeTarget && explicitRuntimeTarget !== parsedAgents.impliedRuntimeTarget) {
+    throw new Error("AGENTS24_RUNTIME_TARGET conflicts with the configured agentVersion selectors.");
+  }
 
-export const env = {
-  ...Object.fromEntries(REQUIRED.map((name) => [name, required(name)])) as Record<(typeof REQUIRED)[number], string>,
-  AGENTS24_BASE_URL: String(process.env.AGENTS24_BASE_URL || "https://api.agents24.dev").trim(),
-  AGENTS24_AGENTS: parsedAgents.agents,
-  AGENTS24_RUNTIME_TARGET: explicitRuntimeTarget || parsedAgents.impliedRuntimeTarget,
-  AGENTS24_INTEGRATION_NAME: String(process.env.AGENTS24_INTEGRATION_NAME || "").trim() || undefined,
-  PORT: Number(process.env.PORT || 3001),
-};
+  const env = {
+    ...Object.fromEntries(REQUIRED.map((name) => [name, required(name)])) as Record<(typeof REQUIRED)[number], string>,
+    AGENTS24_BASE_URL: String(process.env.AGENTS24_BASE_URL || "https://api.agents24.dev").trim(),
+    AGENTS24_AGENTS: parsedAgents.agents,
+    AGENTS24_RUNTIME_TARGET: explicitRuntimeTarget || parsedAgents.impliedRuntimeTarget,
+    AGENTS24_INTEGRATION_NAME: String(process.env.AGENTS24_INTEGRATION_NAME || "").trim() || undefined,
+    PORT: Number(process.env.PORT || 3001),
+  };
 
-if (!Number.isInteger(env.PORT) || env.PORT < 1 || env.PORT > 65535) throw new Error("PORT must be a valid port.");
-if (env.SESSION_COOKIE_SECRET.length < 32) throw new Error("SESSION_COOKIE_SECRET must contain at least 32 characters.");
+  if (!Number.isInteger(env.PORT) || env.PORT < 1 || env.PORT > 65535) throw new Error("PORT must be a valid port.");
+  if (env.SESSION_COOKIE_SECRET.length < 32) throw new Error("SESSION_COOKIE_SECRET must contain at least 32 characters.");
+  return env;
+}
+
+let environment: ReturnType<typeof readServerEnvironment> | undefined;
+export function getServerEnvironment() {
+  return environment ??= readServerEnvironment();
+}

package/templates/shared/bff/server/handler.ts

@@ -0,0 +1,23 @@
+import { Agents24 } from "@agents24/node";
+import { createAgents24BffHandler, type Agents24BffHandler } from "@agents24/node/bff";
+import { getServerEnvironment } from "./env";
+import { resolveAgents24Principal, revokeAgents24Principal } from "./principal";
+
+let handler: Agents24BffHandler | undefined;
+
+// Initialize on the first runtime request, never while the host collects routes during a build.
+export function handleAgents24(request: Request): Promise<Response> {
+  if (!handler) {
+    const env = getServerEnvironment();
+    handler = createAgents24BffHandler({
+      client: new Agents24({ baseUrl: env.AGENTS24_BASE_URL, apiKey: env.AGENTS24_API_KEY }),
+      agents: env.AGENTS24_AGENTS,
+      integrationId: env.AGENTS24_INTEGRATION_ID,
+      integrationName: env.AGENTS24_INTEGRATION_NAME,
+      runtimeTarget: (env.AGENTS24_RUNTIME_TARGET || (process.env.NODE_ENV === "production" ? "published" : "draft")) as "draft" | "published",
+      resolvePrincipal: resolveAgents24Principal,
+      revokePrincipal: revokeAgents24Principal,
+    });
+  }
+  return handler(request);
+}

package/templates/{integrations → shared}/bff/server/principal.ts

@@ -1,13 +1,13 @@
 import { createHmac, randomUUID, timingSafeEqual } from "node:crypto";
 import type { AgentBffPrincipalResolution } from "@agents24/node/bff";
 
-import { env } from "./env.js";
+import { getServerEnvironment } from "./env";
 
 const COOKIE = "agents24_app_session";
 const MAX_AGE = 60 * 60 * 24 * 30;
 
 function signature(value: string): string {
-  return createHmac("sha256", env.SESSION_COOKIE_SECRET).update(value).digest("base64url");
+  return createHmac("sha256", getServerEnvironment().SESSION_COOKIE_SECRET).update(value).digest("base64url");
 }
 
 function parseCookies(request: Request): Record<string, string> {

package/templates/{integrations → shared}/bff/src/host-identity.ts

@@ -1,6 +1,6 @@
 import type { Agents24ChatIdentity } from "@/identity";
 
-/** Replace this adapter with your host application's authenticated identity. */
+/** Replace this adapter with your host application's authenticated display identity. */
 export function getHostIdentity(): Agents24ChatIdentity {
   return { state: "guest", displayName: "Guest" };
 }

package/versions.json

@@ -2,16 +2,20 @@
   "agents24": {
     "@agents24/client": "^0.2.4",
     "@agents24/react": "^0.2.4",
-    "@agents24/chat-react": "^0.5.7",
-    "@agents24/node": "^0.5.2"
+    "@agents24/chat-react": "^0.5.8",
+    "@agents24/node": "^0.5.3"
   },
   "runtime": {
+    "next": "^16.3.4",
+    "server-only": "^0.0.1",
+    "zod": "^4.5.4",
     "react": "^19.2.3",
     "react-dom": "^19.2.3",
     "hono": "^4.12.31",
     "@hono/node-server": "^2.0.10"
   },
   "development": {
+    "@tailwindcss/postcss": "^4.1.16",
     "@types/node": "^24.7.2",
     "@types/react": "^19.2.3",
     "@types/react-dom": "^19.2.3",

package/dist/chunk-ADXMZ3TT.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/types.ts","../src/generator.ts","../src/template-catalog.ts"],"sourcesContent":["export const INTEGRATIONS = [\"client-deployment\", \"bff\"] as const;\nexport const PACKAGE_MANAGERS = [\"pnpm\", \"npm\", \"yarn\", \"bun\"] as const;\nexport const DEFAULT_PRESET = \"b2D1FHzlY\";\n\nexport type Integration = (typeof INTEGRATIONS)[number];\nexport type PackageManager = (typeof PACKAGE_MANAGERS)[number];\nexport type Starter = string;\n\nexport type TemplateSelection = {\n  id: Starter;\n  version: string;\n  displayName: string;\n  sha256: string;\n  catalogRevision: string;\n  files: Map<string, string>;\n};\n\nexport type CreateAppOptions = {\n  directory: string;\n  integration: Integration;\n  preset: string;\n  packageManager: PackageManager;\n  install: boolean;\n  baseUrl: string;\n  starter?: TemplateSelection;\n  deploymentId?: string;\n  agentId?: string;\n  agentAlias?: string;\n  agentVersionId?: string;\n};\n\nexport type GeneratedApp = {\n  directory: string;\n  packageName: string;\n};\n","import { spawnSync } from \"node:child_process\";\nimport { randomBytes } from \"node:crypto\";\nimport {\n  chmodSync,\n  cpSync,\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  renameSync,\n  rmSync,\n  statSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { basename, dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { createRequire } from \"node:module\";\n\nimport { DEFAULT_PRESET, type CreateAppOptions, type GeneratedApp, type PackageManager } from \"./types.js\";\n\ntype Versions = {\n  agents24: Record<string, string>;\n  runtime: Record<string, string>;\n  development: Record<string, string>;\n};\n\nconst packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), \"..\");\nconst templateRoot = join(packageRoot, \"templates\");\nconst scaffoldRoot = join(packageRoot, \"dist/scaffold\");\nconst scaffoldManifest = JSON.parse(readFileSync(join(packageRoot, \"dist/scaffold-manifest.json\"), \"utf8\")) as {\n  dependencies: Record<string, string>;\n  devDependencies: Record<string, string>;\n  sha256: string;\n};\nconst versions = JSON.parse(readFileSync(join(packageRoot, \"versions.json\"), \"utf8\")) as Versions;\nconst require = createRequire(import.meta.url);\n\nfunction packageName(directory: string): string {\n  const value = basename(resolve(directory))\n    .toLowerCase()\n    .replace(/[^a-z0-9._-]+/g, \"-\")\n    .replace(/^[._-]+|[._-]+$/g, \"\");\n  if (!value || !/^[a-z0-9]/.test(value)) throw new Error(\"The destination does not produce a valid npm package name.\");\n  return value;\n}\n\nfunction assertDestination(destination: string): void {\n  if (!existsSync(destination)) return;\n  if (!statSync(destination).isDirectory()) throw new Error(\"The destination already exists and is not a directory.\");\n  if (readdirSync(destination).length > 0) throw new Error(\"The destination directory must be empty.\");\n}\n\nfunction walk(directory: string): string[] {\n  return readdirSync(directory, { withFileTypes: true }).flatMap((entry) => {\n    const path = join(directory, entry.name);\n    return entry.isDirectory() ? walk(path) : [path];\n  });\n}\n\nfunction replaceTemplateValues(directory: string, replacements: Record<string, string>): void {\n  for (const file of walk(directory)) {\n    if (file.endsWith(\".png\") || file.endsWith(\".ico\")) continue;\n    let content = readFileSync(file, \"utf8\");\n    for (const [token, value] of Object.entries(replacements)) content = content.split(token).join(value);\n    writeFileSync(file, content);\n  }\n}\n\nfunction copyLayer(name: string, destination: string): void {\n  cpSync(join(templateRoot, name), destination, { recursive: true, force: true });\n}\n\nfunction materializeTemplate(destination: string, options: CreateAppOptions): void {\n  if (!options.starter) return;\n  const packageId = `pkg_${randomBytes(16).toString(\"hex\")}`;\n  let replacedManifest = false;\n  for (const [path, original] of options.starter.files) {\n    let content = original;\n    if (path === \"agents24.yaml\") {\n      content = content.replace(/^(package_id:\\s*)[^\\s#]+/m, `$1${packageId}`);\n      replacedManifest = content !== original;\n    }\n    const target = join(destination, \"agents24\", path);\n    mkdirSync(dirname(target), { recursive: true });\n    writeFileSync(target, content);\n  }\n  if (!replacedManifest) throw new Error(\"The selected Agent template has no replaceable package_id.\");\n}\n\nfunction generatedManifest(options: CreateAppOptions, name: string): Record<string, unknown> {\n  const dependencies: Record<string, string> = {\n    \"@agents24/client\": versions.agents24[\"@agents24/client\"]!,\n    \"@agents24/react\": versions.agents24[\"@agents24/react\"]!,\n    \"@agents24/chat-react\": versions.agents24[\"@agents24/chat-react\"]!,\n    ...scaffoldManifest.dependencies,\n    react: versions.runtime.react!,\n    \"react-dom\": versions.runtime[\"react-dom\"]!,\n  };\n  const devDependencies: Record<string, string> = {\n    \"@types/node\": versions.development[\"@types/node\"]!,\n    \"@types/react\": versions.development[\"@types/react\"]!,\n    \"@types/react-dom\": versions.development[\"@types/react-dom\"]!,\n    \"@vitejs/plugin-react\": versions.development[\"@vitejs/plugin-react\"]!,\n    ...scaffoldManifest.devDependencies,\n    typescript: versions.development.typescript!,\n    vite: versions.development.vite!,\n  };\n  const scripts: Record<string, string> = {\n    dev: \"vite\",\n    build: \"tsc --noEmit && vite build\",\n    preview: \"vite preview\",\n    preset: \"node scripts/apply-preset.mjs\",\n  };\n  if (options.integration === \"bff\") {\n    dependencies[\"@agents24/node\"] = versions.agents24[\"@agents24/node\"]!;\n    dependencies.hono = versions.runtime.hono!;\n    dependencies[\"@hono/node-server\"] = versions.runtime[\"@hono/node-server\"]!;\n    devDependencies.concurrently = versions.development.concurrently!;\n    devDependencies.tsx = versions.development.tsx!;\n    devDependencies.tsup = \"^8.5.1\";\n    scripts.dev = \"concurrently -k -n web,bff \\\"vite\\\" \\\"tsx watch server/index.ts\\\"\";\n    scripts.build = \"tsc --noEmit && vite build && tsup server/index.ts --format esm --platform node --out-dir server-dist --external @agents24/node --external hono --external @hono/node-server\";\n    scripts.start = \"node server-dist/index.js --production\";\n  }\n  return {\n    name,\n    private: true,\n    version: \"0.0.0\",\n    type: \"module\",\n    engines: { node: \"^22.0.0 || ^24.0.0\" },\n    agents24: {\n      integration: options.integration,\n      package_manager: options.packageManager,\n      preset: options.preset,\n      scaffold_sha256: scaffoldManifest.sha256,\n      ...(options.starter ? { template: {\n        id: options.starter.id,\n        version: options.starter.version,\n        sha256: options.starter.sha256,\n        catalog_revision: options.starter.catalogRevision,\n      } } : {}),\n    },\n    scripts,\n    dependencies,\n    devDependencies,\n  };\n}\n\nfunction envFiles(options: CreateAppOptions, appName: string): { example: string; local: string } {\n  const value = (input: string | undefined) => JSON.stringify(String(input || \"\"));\n  const jsonValue = (input: unknown) => JSON.stringify(input);\n  const baseUrlOverride = options.baseUrl === \"https://api.agents24.dev\" ? [] : [\n    `${options.integration === \"client-deployment\" ? \"VITE_\" : \"\"}AGENTS24_BASE_URL=${value(options.baseUrl)}`,\n  ];\n  if (options.integration === \"client-deployment\") {\n    return {\n      example: \"# VITE_AGENTS24_BASE_URL=http://localhost:8026 # optional advanced override\\nVITE_AGENTS24_DEPLOYMENT_ID=acd_your_public_deployment_id\\n\",\n      local: [...baseUrlOverride, ...(options.deploymentId ? [`VITE_AGENTS24_DEPLOYMENT_ID=${value(options.deploymentId)}`] : []), \"\"].join(\"\\n\"),\n    };\n  }\n  return {\n    example: [\n      \"# AGENTS24_BASE_URL=http://localhost:8026 # optional advanced override\",\n      \"AGENTS24_API_KEY=your_server_only_api_key\",\n      \"# agentVersion accepts draft, latest, or an exact published version such as v1\",\n      \"AGENTS24_AGENTS=[{\\\"agentAlias\\\":\\\"your-agent-alias\\\",\\\"agentVersion\\\":\\\"v1\\\"}]\",\n      \"# agentId remains supported instead of agentAlias when UUID configuration is preferred\",\n      \"AGENTS24_INTEGRATION_ID=generate_one_stable_random_value\",\n      \"AGENTS24_INTEGRATION_NAME=your_app_name # optional\",\n      \"# AGENTS24_RUNTIME_TARGET=draft # optional server-only override\",\n      \"SESSION_COOKIE_SECRET=generate_at_least_32_random_bytes\",\n      \"PORT=3001\",\n      \"\",\n    ].join(\"\\n\"),\n    local: [\n      ...baseUrlOverride,\n      ...(options.agentAlias || options.agentId ? [\n        `AGENTS24_AGENTS=${jsonValue([{ ...(options.agentAlias ? { agentAlias: options.agentAlias } : { agentId: options.agentId }), ...(options.agentVersionId ? { agentVersionId: options.agentVersionId } : {}) }])}`,\n      ] : []),\n      `AGENTS24_INTEGRATION_ID=${value(randomBytes(24).toString(\"base64url\"))}`,\n      `AGENTS24_INTEGRATION_NAME=${value(appName)}`,\n      `SESSION_COOKIE_SECRET=${value(randomBytes(32).toString(\"base64url\"))}`,\n      \"PORT=3001\",\n      \"\",\n    ].join(\"\\n\"),\n  };\n}\n\nfunction installCommand(packageManager: PackageManager): [string, string[]] {\n  if (packageManager === \"npm\") return [\"npm\", [\"install\"]];\n  if (packageManager === \"yarn\") return [\"yarn\", []];\n  if (packageManager === \"bun\") return [\"bun\", [\"install\"]];\n  return [\"pnpm\", [\"install\", \"--ignore-workspace\"]];\n}\n\nfunction runScriptCommand(packageManager: PackageManager, script: string): string {\n  if (packageManager === \"npm\") return `npm run ${script}`;\n  if (packageManager === \"bun\") return `bun run ${script}`;\n  return `${packageManager} ${script}`;\n}\n\nexport function installDependencies(directory: string, packageManager: PackageManager): void {\n  const [command, args] = installCommand(packageManager);\n  const { AGENTS24_API_KEY: _apiKey, ...installerEnvironment } = process.env;\n  const result = spawnSync(command, args, { cwd: directory, stdio: \"inherit\", env: installerEnvironment });\n  if (result.error) throw new Error(`Could not start ${command}: ${result.error.message}`);\n  if (result.status !== 0) throw new Error(`${command} ${args.join(\" \")} failed with exit ${result.status}.`);\n}\n\nfunction clearPresetInstallArtifacts(directory: string): void {\n  for (const name of [\"node_modules\", \"bun.lock\", \"bun.lockb\", \"package-lock.json\", \"pnpm-lock.yaml\", \"yarn.lock\"]) {\n    rmSync(join(directory, name), { recursive: true, force: true });\n  }\n}\n\nfunction applyShadcnPreset(directory: string, preset: string): void {\n  if (preset === DEFAULT_PRESET) return;\n  const executable = require.resolve(\"shadcn\");\n  const { AGENTS24_API_KEY: _apiKey, ...presetEnvironment } = process.env;\n  const result = spawnSync(\n    process.execPath,\n    [executable, \"apply\", preset, \"--yes\", \"--silent\", \"--cwd\", directory],\n    { cwd: directory, encoding: \"utf8\", env: presetEnvironment },\n  );\n  if (result.error) throw new Error(`Could not start Shadcn preset materialization: ${result.error.message}`);\n  if (result.status !== 0) {\n    const detail = String(result.stderr || result.stdout || \"\").trim().split(\"\\n\").at(-1);\n    throw new Error(detail || `Shadcn could not apply preset ${preset}.`);\n  }\n  const scopeResult = spawnSync(\n    process.execPath,\n    [join(directory, \"scripts/scope-preset-theme.mjs\")],\n    { cwd: directory, encoding: \"utf8\" },\n  );\n  if (scopeResult.error) throw new Error(`Could not scope the selected Shadcn preset: ${scopeResult.error.message}`);\n  if (scopeResult.status !== 0) {\n    const detail = String(scopeResult.stderr || scopeResult.stdout || \"\").trim().split(\"\\n\").at(-1);\n    throw new Error(detail || `Could not scope Shadcn preset ${preset}.`);\n  }\n  clearPresetInstallArtifacts(directory);\n}\n\nexport function createApp(options: CreateAppOptions): GeneratedApp {\n  const destination = resolve(options.directory);\n  assertDestination(destination);\n  const name = packageName(destination);\n  const parent = dirname(destination);\n  mkdirSync(parent, { recursive: true });\n  const staging = join(parent, `.${name}.agents24-${randomBytes(6).toString(\"hex\")}`);\n  try {\n    mkdirSync(staging, { mode: 0o700 });\n    cpSync(scaffoldRoot, staging, { recursive: true, force: true });\n    rmSync(join(staging, \"manifest.json\"), { force: true });\n    copyLayer(\"common\", staging);\n    copyLayer(`integrations/${options.integration}`, staging);\n    materializeTemplate(staging, options);\n    replaceTemplateValues(staging, {\n      \"__APP_NAME__\": name,\n      \"__PRESET__\": options.preset,\n      \"__INTEGRATION__\": options.integration,\n      \"__CONNECT_SOURCE__\": options.integration === \"client-deployment\" ? \" __AGENTS24_CONNECT_SOURCE__\" : \"\",\n      \"__PM_DEV__\": runScriptCommand(options.packageManager, \"dev\"),\n      \"__PM_BUILD__\": runScriptCommand(options.packageManager, \"build\"),\n      \"__PM_PRODUCTION__\": runScriptCommand(options.packageManager, options.integration === \"bff\" ? \"start\" : \"preview\"),\n      \"__PM_PRESET__\": `${runScriptCommand(options.packageManager, \"preset\")} --`,\n      \"__STARTER_SETUP__\": options.starter\n        ? `## Set up the included Agent\\n\\nThis repository includes an editable Resource Package in \\`agents24/\\`. For a BFF, run \\`agents24 apply ./agents24\\` to reconcile drafts and \\`agents24 publish ./agents24\\` for production. For a direct-client app, run \\`agents24 setup ./agents24 --app .\\` so publication happens before deployment configuration. Use \\`agents24 dev ./agents24\\` when a local Artifact server is required.`\n        : \"\",\n    });\n    const gitignore = join(staging, \"_gitignore\");\n    if (existsSync(gitignore)) renameSync(gitignore, join(staging, \".gitignore\"));\n    writeFileSync(join(staging, \"package.json\"), `${JSON.stringify(generatedManifest(options, name), null, 2)}\\n`);\n    applyShadcnPreset(staging, options.preset);\n    const env = envFiles(options, name);\n    writeFileSync(join(staging, \".env.example\"), env.example);\n    if (options.install) installDependencies(staging, options.packageManager);\n    writeFileSync(join(staging, \".env.local\"), env.local, { mode: 0o600 });\n    chmodSync(join(staging, \".env.local\"), 0o600);\n    if (existsSync(destination)) rmSync(destination, { recursive: true });\n    renameSync(staging, destination);\n    return { directory: destination, packageName: name };\n  } catch (error) {\n    rmSync(staging, { recursive: true, force: true });\n    throw error;\n  }\n}\n","import { createHash } from \"node:crypto\";\nimport { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from \"node:fs\";\nimport { homedir, tmpdir } from \"node:os\";\nimport { dirname, join } from \"node:path\";\n\nimport { unpackFiles } from \"@agents24/cli\";\n\nimport { type Starter, type TemplateSelection } from \"./types.js\";\n\ntype CatalogTemplate = {\n  id: string;\n  version: string;\n  display_name: string;\n  description: string;\n  compatibility: { min_generator_version?: string; resource_package_schema?: string };\n  archive: { sha256: string; size: number; download_url: string };\n};\n\ntype Catalog = {\n  schema_version: \"agents24.template-catalog.v1\";\n  revision: string;\n  templates: CatalogTemplate[];\n};\n\ntype CachedCatalog = { etag?: string; catalog: Catalog };\n\nconst GENERATOR_VERSION = \"0.2.0\";\nconst SHA256 = /^[0-9a-f]{64}$/;\nconst SEMVER = /^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)$/;\nconst TEMPLATE_ID = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;\n\nfunction cacheRoot(): string {\n  const override = String(process.env.AGENTS24_TEMPLATE_CACHE_DIR || \"\").trim();\n  if (override) return override;\n  const platformRoot = process.platform === \"win32\"\n    ? process.env.LOCALAPPDATA\n    : process.env.XDG_CACHE_HOME || join(homedir(), \".cache\");\n  return join(platformRoot || tmpdir(), \"agents24\", \"templates-v1\");\n}\n\nfunction atomicWrite(path: string, data: string | Uint8Array): void {\n  mkdirSync(dirname(path), { recursive: true, mode: 0o700 });\n  const temporary = `${path}.${process.pid}.tmp`;\n  writeFileSync(temporary, data, { mode: 0o600 });\n  renameSync(temporary, path);\n}\n\nfunction parseVersion(value: string): [number, number, number] | null {\n  const match = SEMVER.exec(value);\n  return match ? [Number(match[1]), Number(match[2]), Number(match[3])] : null;\n}\n\nfunction compatible(item: CatalogTemplate): boolean {\n  const minimum = parseVersion(String(item.compatibility?.min_generator_version || \"0.0.0\"));\n  const current = parseVersion(GENERATOR_VERSION)!;\n  if (!minimum || item.compatibility?.resource_package_schema !== \"2.0\") return false;\n  return current[0] > minimum[0]\n    || (current[0] === minimum[0] && current[1] > minimum[1])\n    || (current[0] === minimum[0] && current[1] === minimum[1] && current[2] >= minimum[2]);\n}\n\nfunction validateCatalog(value: unknown): Catalog {\n  const catalog = value as Catalog;\n  if (catalog?.schema_version !== \"agents24.template-catalog.v1\" || !SHA256.test(catalog.revision) || !Array.isArray(catalog.templates)) {\n    throw new Error(\"The Agents24 template catalog is invalid.\");\n  }\n  const ids = new Set<string>();\n  for (const item of catalog.templates) {\n    if (!TEMPLATE_ID.test(item?.id) || ids.has(item.id) || !SEMVER.test(item.version)\n      || !item.display_name || !SHA256.test(item.archive?.sha256) || !Number.isSafeInteger(item.archive?.size)\n      || item.archive.size < 1 || item.archive.size > 5 * 1024 * 1024 || !item.archive.download_url?.startsWith(\"/templates/\")) {\n      throw new Error(\"The Agents24 template catalog contains an invalid release.\");\n    }\n    ids.add(item.id);\n  }\n  return catalog;\n}\n\nfunction readCachedCatalog(path: string): CachedCatalog | null {\n  try {\n    const cached = JSON.parse(readFileSync(path, \"utf8\")) as CachedCatalog;\n    return { ...(cached.etag ? { etag: cached.etag } : {}), catalog: validateCatalog(cached.catalog) };\n  } catch {\n    return null;\n  }\n}\n\nexport async function loadTemplateCatalog(baseUrl: string): Promise<{ catalog: Catalog; live: boolean }> {\n  const path = join(cacheRoot(), \"catalog.json\");\n  const cached = existsSync(path) ? readCachedCatalog(path) : null;\n  try {\n    const response = await fetch(new URL(\"/templates\", `${baseUrl}/`), {\n      headers: cached?.etag ? { \"If-None-Match\": cached.etag } : {},\n      signal: AbortSignal.timeout(10_000),\n    });\n    if (response.status === 304 && cached) return { catalog: cached.catalog, live: true };\n    if (!response.ok) throw new Error(`catalog request returned ${response.status}`);\n    const catalog = validateCatalog(await response.json());\n    const etag = response.headers.get(\"etag\") || undefined;\n    atomicWrite(path, `${JSON.stringify({ ...(etag ? { etag } : {}), catalog })}\\n`);\n    return { catalog, live: true };\n  } catch (error) {\n    if (cached) return { catalog: cached.catalog, live: false };\n    const detail = error instanceof Error ? error.message : \"request failed\";\n    throw new Error(`Could not load the Agents24 template catalog (${detail}), and no verified cached catalog is available.`);\n  }\n}\n\nexport function compatibleTemplates(catalog: Catalog): CatalogTemplate[] {\n  return catalog.templates.filter(compatible);\n}\n\nfunction verifiedArchive(path: string, item: CatalogTemplate): Uint8Array | null {\n  try {\n    const archive = readFileSync(path);\n    if (archive.byteLength !== item.archive.size || createHash(\"sha256\").update(archive).digest(\"hex\") !== item.archive.sha256) return null;\n    unpackFiles(archive);\n    return archive;\n  } catch {\n    return null;\n  }\n}\n\nasync function readArchiveResponse(response: Response, expectedSize: number): Promise<Uint8Array> {\n  if (!response.body) throw new Error(\"Template download returned no archive body.\");\n  const reader = response.body.getReader();\n  const chunks: Uint8Array[] = [];\n  let size = 0;\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    size += value.byteLength;\n    if (size > expectedSize || size > 5 * 1024 * 1024) {\n      await reader.cancel();\n      throw new Error(\"Template download exceeds its advertised archive size.\");\n    }\n    chunks.push(value);\n  }\n  const archive = new Uint8Array(size);\n  let offset = 0;\n  for (const chunk of chunks) {\n    archive.set(chunk, offset);\n    offset += chunk.byteLength;\n  }\n  return archive;\n}\n\nexport async function selectTemplate(baseUrl: string, catalog: Catalog, id: string): Promise<TemplateSelection> {\n  if (id === \"rag\") throw new Error(\"The 'rag' starter was removed. Use --starter customer-support or --starter deep-research.\");\n  const item = catalog.templates.find((candidate) => candidate.id === id);\n  if (!item) throw new Error(`Template '${id}' is not available in the active catalog.`);\n  if (!compatible(item)) throw new Error(`Template '${id}' requires a newer create-agents24-app release.`);\n  const path = join(cacheRoot(), \"archives\", `${item.archive.sha256}.zip`);\n  let archive = existsSync(path) ? verifiedArchive(path, item) : null;\n  if (!archive) {\n    let response: Response;\n    try {\n      response = await fetch(new URL(item.archive.download_url, `${baseUrl}/`), { signal: AbortSignal.timeout(30_000) });\n    } catch (error) {\n      throw new Error(`Could not download template '${id}', and no verified cached archive is available.`);\n    }\n    if (!response.ok) throw new Error(`Could not download template '${id}' (HTTP ${response.status}).`);\n    const length = response.headers.get(\"content-length\");\n    if (length && Number(length) !== item.archive.size) throw new Error(`Template '${id}' download size does not match the catalog.`);\n    archive = await readArchiveResponse(response, item.archive.size);\n    if (archive.byteLength !== item.archive.size || createHash(\"sha256\").update(archive).digest(\"hex\") !== item.archive.sha256) {\n      throw new Error(`Template '${id}' failed integrity verification.`);\n    }\n    unpackFiles(archive);\n    atomicWrite(path, archive);\n  }\n  return {\n    id: item.id as Starter,\n    version: item.version,\n    displayName: item.display_name,\n    sha256: item.archive.sha256,\n    catalogRevision: catalog.revision,\n    files: unpackFiles(archive),\n  };\n}\n"],"mappings":";;;AAAO,IAAM,eAAe,CAAC,qBAAqB,KAAK;AAChD,IAAM,mBAAmB,CAAC,QAAQ,OAAO,QAAQ,KAAK;AACtD,IAAM,iBAAiB;;;ACF9B,SAAS,iBAAiB;AAC1B,SAAS,mBAAmB;AAC5B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,UAAU,SAAS,MAAM,eAAe;AACjD,SAAS,qBAAqB;AAC9B,SAAS,qBAAqB;AAU9B,IAAM,cAAc,QAAQ,QAAQ,cAAc,YAAY,GAAG,CAAC,GAAG,IAAI;AACzE,IAAM,eAAe,KAAK,aAAa,WAAW;AAClD,IAAM,eAAe,KAAK,aAAa,eAAe;AACtD,IAAM,mBAAmB,KAAK,MAAM,aAAa,KAAK,aAAa,6BAA6B,GAAG,MAAM,CAAC;AAK1G,IAAM,WAAW,KAAK,MAAM,aAAa,KAAK,aAAa,eAAe,GAAG,MAAM,CAAC;AACpF,IAAMA,WAAU,cAAc,YAAY,GAAG;AAE7C,SAAS,YAAY,WAA2B;AAC9C,QAAM,QAAQ,SAAS,QAAQ,SAAS,CAAC,EACtC,YAAY,EACZ,QAAQ,kBAAkB,GAAG,EAC7B,QAAQ,oBAAoB,EAAE;AACjC,MAAI,CAAC,SAAS,CAAC,YAAY,KAAK,KAAK,EAAG,OAAM,IAAI,MAAM,4DAA4D;AACpH,SAAO;AACT;AAEA,SAAS,kBAAkB,aAA2B;AACpD,MAAI,CAAC,WAAW,WAAW,EAAG;AAC9B,MAAI,CAAC,SAAS,WAAW,EAAE,YAAY,EAAG,OAAM,IAAI,MAAM,wDAAwD;AAClH,MAAI,YAAY,WAAW,EAAE,SAAS,EAAG,OAAM,IAAI,MAAM,0CAA0C;AACrG;AAEA,SAAS,KAAK,WAA6B;AACzC,SAAO,YAAY,WAAW,EAAE,eAAe,KAAK,CAAC,EAAE,QAAQ,CAAC,UAAU;AACxE,UAAM,OAAO,KAAK,WAAW,MAAM,IAAI;AACvC,WAAO,MAAM,YAAY,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI;AAAA,EACjD,CAAC;AACH;AAEA,SAAS,sBAAsB,WAAmB,cAA4C;AAC5F,aAAW,QAAQ,KAAK,SAAS,GAAG;AAClC,QAAI,KAAK,SAAS,MAAM,KAAK,KAAK,SAAS,MAAM,EAAG;AACpD,QAAI,UAAU,aAAa,MAAM,MAAM;AACvC,eAAW,CAAC,OAAO,KAAK,KAAK,OAAO,QAAQ,YAAY,EAAG,WAAU,QAAQ,MAAM,KAAK,EAAE,KAAK,KAAK;AACpG,kBAAc,MAAM,OAAO;AAAA,EAC7B;AACF;AAEA,SAAS,UAAU,MAAc,aAA2B;AAC1D,SAAO,KAAK,cAAc,IAAI,GAAG,aAAa,EAAE,WAAW,MAAM,OAAO,KAAK,CAAC;AAChF;AAEA,SAAS,oBAAoB,aAAqB,SAAiC;AACjF,MAAI,CAAC,QAAQ,QAAS;AACtB,QAAM,YAAY,OAAO,YAAY,EAAE,EAAE,SAAS,KAAK,CAAC;AACxD,MAAI,mBAAmB;AACvB,aAAW,CAAC,MAAM,QAAQ,KAAK,QAAQ,QAAQ,OAAO;AACpD,QAAI,UAAU;AACd,QAAI,SAAS,iBAAiB;AAC5B,gBAAU,QAAQ,QAAQ,6BAA6B,KAAK,SAAS,EAAE;AACvE,yBAAmB,YAAY;AAAA,IACjC;AACA,UAAM,SAAS,KAAK,aAAa,YAAY,IAAI;AACjD,cAAU,QAAQ,MAAM,GAAG,EAAE,WAAW,KAAK,CAAC;AAC9C,kBAAc,QAAQ,OAAO;AAAA,EAC/B;AACA,MAAI,CAAC,iBAAkB,OAAM,IAAI,MAAM,4DAA4D;AACrG;AAEA,SAAS,kBAAkB,SAA2B,MAAuC;AAC3F,QAAM,eAAuC;AAAA,IAC3C,oBAAoB,SAAS,SAAS,kBAAkB;AAAA,IACxD,mBAAmB,SAAS,SAAS,iBAAiB;AAAA,IACtD,wBAAwB,SAAS,SAAS,sBAAsB;AAAA,IAChE,GAAG,iBAAiB;AAAA,IACpB,OAAO,SAAS,QAAQ;AAAA,IACxB,aAAa,SAAS,QAAQ,WAAW;AAAA,EAC3C;AACA,QAAM,kBAA0C;AAAA,IAC9C,eAAe,SAAS,YAAY,aAAa;AAAA,IACjD,gBAAgB,SAAS,YAAY,cAAc;AAAA,IACnD,oBAAoB,SAAS,YAAY,kBAAkB;AAAA,IAC3D,wBAAwB,SAAS,YAAY,sBAAsB;AAAA,IACnE,GAAG,iBAAiB;AAAA,IACpB,YAAY,SAAS,YAAY;AAAA,IACjC,MAAM,SAAS,YAAY;AAAA,EAC7B;AACA,QAAM,UAAkC;AAAA,IACtC,KAAK;AAAA,IACL,OAAO;AAAA,IACP,SAAS;AAAA,IACT,QAAQ;AAAA,EACV;AACA,MAAI,QAAQ,gBAAgB,OAAO;AACjC,iBAAa,gBAAgB,IAAI,SAAS,SAAS,gBAAgB;AACnE,iBAAa,OAAO,SAAS,QAAQ;AACrC,iBAAa,mBAAmB,IAAI,SAAS,QAAQ,mBAAmB;AACxE,oBAAgB,eAAe,SAAS,YAAY;AACpD,oBAAgB,MAAM,SAAS,YAAY;AAC3C,oBAAgB,OAAO;AACvB,YAAQ,MAAM;AACd,YAAQ,QAAQ;AAChB,YAAQ,QAAQ;AAAA,EAClB;AACA,SAAO;AAAA,IACL;AAAA,IACA,SAAS;AAAA,IACT,SAAS;AAAA,IACT,MAAM;AAAA,IACN,SAAS,EAAE,MAAM,qBAAqB;AAAA,IACtC,UAAU;AAAA,MACR,aAAa,QAAQ;AAAA,MACrB,iBAAiB,QAAQ;AAAA,MACzB,QAAQ,QAAQ;AAAA,MAChB,iBAAiB,iBAAiB;AAAA,MAClC,GAAI,QAAQ,UAAU,EAAE,UAAU;AAAA,QAChC,IAAI,QAAQ,QAAQ;AAAA,QACpB,SAAS,QAAQ,QAAQ;AAAA,QACzB,QAAQ,QAAQ,QAAQ;AAAA,QACxB,kBAAkB,QAAQ,QAAQ;AAAA,MACpC,EAAE,IAAI,CAAC;AAAA,IACT;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAEA,SAAS,SAAS,SAA2B,SAAqD;AAChG,QAAM,QAAQ,CAAC,UAA8B,KAAK,UAAU,OAAO,SAAS,EAAE,CAAC;AAC/E,QAAM,YAAY,CAAC,UAAmB,KAAK,UAAU,KAAK;AAC1D,QAAM,kBAAkB,QAAQ,YAAY,6BAA6B,CAAC,IAAI;AAAA,IAC5E,GAAG,QAAQ,gBAAgB,sBAAsB,UAAU,EAAE,qBAAqB,MAAM,QAAQ,OAAO,CAAC;AAAA,EAC1G;AACA,MAAI,QAAQ,gBAAgB,qBAAqB;AAC/C,WAAO;AAAA,MACL,SAAS;AAAA,MACT,OAAO,CAAC,GAAG,iBAAiB,GAAI,QAAQ,eAAe,CAAC,+BAA+B,MAAM,QAAQ,YAAY,CAAC,EAAE,IAAI,CAAC,GAAI,EAAE,EAAE,KAAK,IAAI;AAAA,IAC5I;AAAA,EACF;AACA,SAAO;AAAA,IACL,SAAS;AAAA,MACP;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,EAAE,KAAK,IAAI;AAAA,IACX,OAAO;AAAA,MACL,GAAG;AAAA,MACH,GAAI,QAAQ,cAAc,QAAQ,UAAU;AAAA,QAC1C,mBAAmB,UAAU,CAAC,EAAE,GAAI,QAAQ,aAAa,EAAE,YAAY,QAAQ,WAAW,IAAI,EAAE,SAAS,QAAQ,QAAQ,GAAI,GAAI,QAAQ,iBAAiB,EAAE,gBAAgB,QAAQ,eAAe,IAAI,CAAC,EAAG,CAAC,CAAC,CAAC;AAAA,MAChN,IAAI,CAAC;AAAA,MACL,2BAA2B,MAAM,YAAY,EAAE,EAAE,SAAS,WAAW,CAAC,CAAC;AAAA,MACvE,6BAA6B,MAAM,OAAO,CAAC;AAAA,MAC3C,yBAAyB,MAAM,YAAY,EAAE,EAAE,SAAS,WAAW,CAAC,CAAC;AAAA,MACrE;AAAA,MACA;AAAA,IACF,EAAE,KAAK,IAAI;AAAA,EACb;AACF;AAEA,SAAS,eAAe,gBAAoD;AAC1E,MAAI,mBAAmB,MAAO,QAAO,CAAC,OAAO,CAAC,SAAS,CAAC;AACxD,MAAI,mBAAmB,OAAQ,QAAO,CAAC,QAAQ,CAAC,CAAC;AACjD,MAAI,mBAAmB,MAAO,QAAO,CAAC,OAAO,CAAC,SAAS,CAAC;AACxD,SAAO,CAAC,QAAQ,CAAC,WAAW,oBAAoB,CAAC;AACnD;AAEA,SAAS,iBAAiB,gBAAgC,QAAwB;AAChF,MAAI,mBAAmB,MAAO,QAAO,WAAW,MAAM;AACtD,MAAI,mBAAmB,MAAO,QAAO,WAAW,MAAM;AACtD,SAAO,GAAG,cAAc,IAAI,MAAM;AACpC;AAEO,SAAS,oBAAoB,WAAmB,gBAAsC;AAC3F,QAAM,CAAC,SAAS,IAAI,IAAI,eAAe,cAAc;AACrD,QAAM,EAAE,kBAAkB,SAAS,GAAG,qBAAqB,IAAI,QAAQ;AACvE,QAAM,SAAS,UAAU,SAAS,MAAM,EAAE,KAAK,WAAW,OAAO,WAAW,KAAK,qBAAqB,CAAC;AACvG,MAAI,OAAO,MAAO,OAAM,IAAI,MAAM,mBAAmB,OAAO,KAAK,OAAO,MAAM,OAAO,EAAE;AACvF,MAAI,OAAO,WAAW,EAAG,OAAM,IAAI,MAAM,GAAG,OAAO,IAAI,KAAK,KAAK,GAAG,CAAC,qBAAqB,OAAO,MAAM,GAAG;AAC5G;AAEA,SAAS,4BAA4B,WAAyB;AAC5D,aAAW,QAAQ,CAAC,gBAAgB,YAAY,aAAa,qBAAqB,kBAAkB,WAAW,GAAG;AAChH,WAAO,KAAK,WAAW,IAAI,GAAG,EAAE,WAAW,MAAM,OAAO,KAAK,CAAC;AAAA,EAChE;AACF;AAEA,SAAS,kBAAkB,WAAmB,QAAsB;AAClE,MAAI,WAAW,eAAgB;AAC/B,QAAM,aAAaA,SAAQ,QAAQ,QAAQ;AAC3C,QAAM,EAAE,kBAAkB,SAAS,GAAG,kBAAkB,IAAI,QAAQ;AACpE,QAAM,SAAS;AAAA,IACb,QAAQ;AAAA,IACR,CAAC,YAAY,SAAS,QAAQ,SAAS,YAAY,SAAS,SAAS;AAAA,IACrE,EAAE,KAAK,WAAW,UAAU,QAAQ,KAAK,kBAAkB;AAAA,EAC7D;AACA,MAAI,OAAO,MAAO,OAAM,IAAI,MAAM,kDAAkD,OAAO,MAAM,OAAO,EAAE;AAC1G,MAAI,OAAO,WAAW,GAAG;AACvB,UAAM,SAAS,OAAO,OAAO,UAAU,OAAO,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,IAAI,EAAE,GAAG,EAAE;AACpF,UAAM,IAAI,MAAM,UAAU,iCAAiC,MAAM,GAAG;AAAA,EACtE;AACA,QAAM,cAAc;AAAA,IAClB,QAAQ;AAAA,IACR,CAAC,KAAK,WAAW,gCAAgC,CAAC;AAAA,IAClD,EAAE,KAAK,WAAW,UAAU,OAAO;AAAA,EACrC;AACA,MAAI,YAAY,MAAO,OAAM,IAAI,MAAM,+CAA+C,YAAY,MAAM,OAAO,EAAE;AACjH,MAAI,YAAY,WAAW,GAAG;AAC5B,UAAM,SAAS,OAAO,YAAY,UAAU,YAAY,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,IAAI,EAAE,GAAG,EAAE;AAC9F,UAAM,IAAI,MAAM,UAAU,iCAAiC,MAAM,GAAG;AAAA,EACtE;AACA,8BAA4B,SAAS;AACvC;AAEO,SAAS,UAAU,SAAyC;AACjE,QAAM,cAAc,QAAQ,QAAQ,SAAS;AAC7C,oBAAkB,WAAW;AAC7B,QAAM,OAAO,YAAY,WAAW;AACpC,QAAM,SAAS,QAAQ,WAAW;AAClC,YAAU,QAAQ,EAAE,WAAW,KAAK,CAAC;AACrC,QAAM,UAAU,KAAK,QAAQ,IAAI,IAAI,aAAa,YAAY,CAAC,EAAE,SAAS,KAAK,CAAC,EAAE;AAClF,MAAI;AACF,cAAU,SAAS,EAAE,MAAM,IAAM,CAAC;AAClC,WAAO,cAAc,SAAS,EAAE,WAAW,MAAM,OAAO,KAAK,CAAC;AAC9D,WAAO,KAAK,SAAS,eAAe,GAAG,EAAE,OAAO,KAAK,CAAC;AACtD,cAAU,UAAU,OAAO;AAC3B,cAAU,gBAAgB,QAAQ,WAAW,IAAI,OAAO;AACxD,wBAAoB,SAAS,OAAO;AACpC,0BAAsB,SAAS;AAAA,MAC7B,gBAAgB;AAAA,MAChB,cAAc,QAAQ;AAAA,MACtB,mBAAmB,QAAQ;AAAA,MAC3B,sBAAsB,QAAQ,gBAAgB,sBAAsB,iCAAiC;AAAA,MACrG,cAAc,iBAAiB,QAAQ,gBAAgB,KAAK;AAAA,MAC5D,gBAAgB,iBAAiB,QAAQ,gBAAgB,OAAO;AAAA,MAChE,qBAAqB,iBAAiB,QAAQ,gBAAgB,QAAQ,gBAAgB,QAAQ,UAAU,SAAS;AAAA,MACjH,iBAAiB,GAAG,iBAAiB,QAAQ,gBAAgB,QAAQ,CAAC;AAAA,MACtE,qBAAqB,QAAQ,UACzB;AAAA;AAAA,qYACA;AAAA,IACN,CAAC;AACD,UAAM,YAAY,KAAK,SAAS,YAAY;AAC5C,QAAI,WAAW,SAAS,EAAG,YAAW,WAAW,KAAK,SAAS,YAAY,CAAC;AAC5E,kBAAc,KAAK,SAAS,cAAc,GAAG,GAAG,KAAK,UAAU,kBAAkB,SAAS,IAAI,GAAG,MAAM,CAAC,CAAC;AAAA,CAAI;AAC7G,sBAAkB,SAAS,QAAQ,MAAM;AACzC,UAAM,MAAM,SAAS,SAAS,IAAI;AAClC,kBAAc,KAAK,SAAS,cAAc,GAAG,IAAI,OAAO;AACxD,QAAI,QAAQ,QAAS,qBAAoB,SAAS,QAAQ,cAAc;AACxE,kBAAc,KAAK,SAAS,YAAY,GAAG,IAAI,OAAO,EAAE,MAAM,IAAM,CAAC;AACrE,cAAU,KAAK,SAAS,YAAY,GAAG,GAAK;AAC5C,QAAI,WAAW,WAAW,EAAG,QAAO,aAAa,EAAE,WAAW,KAAK,CAAC;AACpE,eAAW,SAAS,WAAW;AAC/B,WAAO,EAAE,WAAW,aAAa,aAAa,KAAK;AAAA,EACrD,SAAS,OAAO;AACd,WAAO,SAAS,EAAE,WAAW,MAAM,OAAO,KAAK,CAAC;AAChD,UAAM;AAAA,EACR;AACF;;;AC7RA,SAAS,kBAAkB;AAC3B,SAAS,cAAAC,aAAY,aAAAC,YAAW,gBAAAC,eAAc,cAAAC,aAAY,iBAAAC,sBAAqB;AAC/E,SAAS,SAAS,cAAc;AAChC,SAAS,WAAAC,UAAS,QAAAC,aAAY;AAE9B,SAAS,mBAAmB;AAqB5B,IAAM,oBAAoB;AAC1B,IAAM,SAAS;AACf,IAAM,SAAS;AACf,IAAM,cAAc;AAEpB,SAAS,YAAoB;AAC3B,QAAM,WAAW,OAAO,QAAQ,IAAI,+BAA+B,EAAE,EAAE,KAAK;AAC5E,MAAI,SAAU,QAAO;AACrB,QAAM,eAAe,QAAQ,aAAa,UACtC,QAAQ,IAAI,eACZ,QAAQ,IAAI,kBAAkBA,MAAK,QAAQ,GAAG,QAAQ;AAC1D,SAAOA,MAAK,gBAAgB,OAAO,GAAG,YAAY,cAAc;AAClE;AAEA,SAAS,YAAY,MAAc,MAAiC;AAClE,EAAAL,WAAUI,SAAQ,IAAI,GAAG,EAAE,WAAW,MAAM,MAAM,IAAM,CAAC;AACzD,QAAM,YAAY,GAAG,IAAI,IAAI,QAAQ,GAAG;AACxC,EAAAD,eAAc,WAAW,MAAM,EAAE,MAAM,IAAM,CAAC;AAC9C,EAAAD,YAAW,WAAW,IAAI;AAC5B;AAEA,SAAS,aAAa,OAAgD;AACpE,QAAM,QAAQ,OAAO,KAAK,KAAK;AAC/B,SAAO,QAAQ,CAAC,OAAO,MAAM,CAAC,CAAC,GAAG,OAAO,MAAM,CAAC,CAAC,GAAG,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI;AAC1E;AAEA,SAAS,WAAW,MAAgC;AAClD,QAAM,UAAU,aAAa,OAAO,KAAK,eAAe,yBAAyB,OAAO,CAAC;AACzF,QAAM,UAAU,aAAa,iBAAiB;AAC9C,MAAI,CAAC,WAAW,KAAK,eAAe,4BAA4B,MAAO,QAAO;AAC9E,SAAO,QAAQ,CAAC,IAAI,QAAQ,CAAC,KACvB,QAAQ,CAAC,MAAM,QAAQ,CAAC,KAAK,QAAQ,CAAC,IAAI,QAAQ,CAAC,KACnD,QAAQ,CAAC,MAAM,QAAQ,CAAC,KAAK,QAAQ,CAAC,MAAM,QAAQ,CAAC,KAAK,QAAQ,CAAC,KAAK,QAAQ,CAAC;AACzF;AAEA,SAAS,gBAAgB,OAAyB;AAChD,QAAM,UAAU;AAChB,MAAI,SAAS,mBAAmB,kCAAkC,CAAC,OAAO,KAAK,QAAQ,QAAQ,KAAK,CAAC,MAAM,QAAQ,QAAQ,SAAS,GAAG;AACrI,UAAM,IAAI,MAAM,2CAA2C;AAAA,EAC7D;AACA,QAAM,MAAM,oBAAI,IAAY;AAC5B,aAAW,QAAQ,QAAQ,WAAW;AACpC,QAAI,CAAC,YAAY,KAAK,MAAM,EAAE,KAAK,IAAI,IAAI,KAAK,EAAE,KAAK,CAAC,OAAO,KAAK,KAAK,OAAO,KAC3E,CAAC,KAAK,gBAAgB,CAAC,OAAO,KAAK,KAAK,SAAS,MAAM,KAAK,CAAC,OAAO,cAAc,KAAK,SAAS,IAAI,KACpG,KAAK,QAAQ,OAAO,KAAK,KAAK,QAAQ,OAAO,IAAI,OAAO,QAAQ,CAAC,KAAK,QAAQ,cAAc,WAAW,aAAa,GAAG;AAC1H,YAAM,IAAI,MAAM,4DAA4D;AAAA,IAC9E;AACA,QAAI,IAAI,KAAK,EAAE;AAAA,EACjB;AACA,SAAO;AACT;AAEA,SAAS,kBAAkB,MAAoC;AAC7D,MAAI;AACF,UAAM,SAAS,KAAK,MAAMD,cAAa,MAAM,MAAM,CAAC;AACpD,WAAO,EAAE,GAAI,OAAO,OAAO,EAAE,MAAM,OAAO,KAAK,IAAI,CAAC,GAAI,SAAS,gBAAgB,OAAO,OAAO,EAAE;AAAA,EACnG,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,eAAsB,oBAAoB,SAA+D;AACvG,QAAM,OAAOI,MAAK,UAAU,GAAG,cAAc;AAC7C,QAAM,SAASN,YAAW,IAAI,IAAI,kBAAkB,IAAI,IAAI;AAC5D,MAAI;AACF,UAAM,WAAW,MAAM,MAAM,IAAI,IAAI,cAAc,GAAG,OAAO,GAAG,GAAG;AAAA,MACjE,SAAS,QAAQ,OAAO,EAAE,iBAAiB,OAAO,KAAK,IAAI,CAAC;AAAA,MAC5D,QAAQ,YAAY,QAAQ,GAAM;AAAA,IACpC,CAAC;AACD,QAAI,SAAS,WAAW,OAAO,OAAQ,QAAO,EAAE,SAAS,OAAO,SAAS,MAAM,KAAK;AACpF,QAAI,CAAC,SAAS,GAAI,OAAM,IAAI,MAAM,4BAA4B,SAAS,MAAM,EAAE;AAC/E,UAAM,UAAU,gBAAgB,MAAM,SAAS,KAAK,CAAC;AACrD,UAAM,OAAO,SAAS,QAAQ,IAAI,MAAM,KAAK;AAC7C,gBAAY,MAAM,GAAG,KAAK,UAAU,EAAE,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC,GAAI,QAAQ,CAAC,CAAC;AAAA,CAAI;AAC/E,WAAO,EAAE,SAAS,MAAM,KAAK;AAAA,EAC/B,SAAS,OAAO;AACd,QAAI,OAAQ,QAAO,EAAE,SAAS,OAAO,SAAS,MAAM,MAAM;AAC1D,UAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU;AACxD,UAAM,IAAI,MAAM,iDAAiD,MAAM,iDAAiD;AAAA,EAC1H;AACF;AAEO,SAAS,oBAAoB,SAAqC;AACvE,SAAO,QAAQ,UAAU,OAAO,UAAU;AAC5C;AAEA,SAAS,gBAAgB,MAAc,MAA0C;AAC/E,MAAI;AACF,UAAM,UAAUE,cAAa,IAAI;AACjC,QAAI,QAAQ,eAAe,KAAK,QAAQ,QAAQ,WAAW,QAAQ,EAAE,OAAO,OAAO,EAAE,OAAO,KAAK,MAAM,KAAK,QAAQ,OAAQ,QAAO;AACnI,gBAAY,OAAO;AACnB,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,eAAe,oBAAoB,UAAoB,cAA2C;AAChG,MAAI,CAAC,SAAS,KAAM,OAAM,IAAI,MAAM,6CAA6C;AACjF,QAAM,SAAS,SAAS,KAAK,UAAU;AACvC,QAAM,SAAuB,CAAC;AAC9B,MAAI,OAAO;AACX,SAAO,MAAM;AACX,UAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAC1C,QAAI,KAAM;AACV,YAAQ,MAAM;AACd,QAAI,OAAO,gBAAgB,OAAO,IAAI,OAAO,MAAM;AACjD,YAAM,OAAO,OAAO;AACpB,YAAM,IAAI,MAAM,wDAAwD;AAAA,IAC1E;AACA,WAAO,KAAK,KAAK;AAAA,EACnB;AACA,QAAM,UAAU,IAAI,WAAW,IAAI;AACnC,MAAI,SAAS;AACb,aAAW,SAAS,QAAQ;AAC1B,YAAQ,IAAI,OAAO,MAAM;AACzB,cAAU,MAAM;AAAA,EAClB;AACA,SAAO;AACT;AAEA,eAAsB,eAAe,SAAiB,SAAkB,IAAwC;AAC9G,MAAI,OAAO,MAAO,OAAM,IAAI,MAAM,2FAA2F;AAC7H,QAAM,OAAO,QAAQ,UAAU,KAAK,CAAC,cAAc,UAAU,OAAO,EAAE;AACtE,MAAI,CAAC,KAAM,OAAM,IAAI,MAAM,aAAa,EAAE,2CAA2C;AACrF,MAAI,CAAC,WAAW,IAAI,EAAG,OAAM,IAAI,MAAM,aAAa,EAAE,iDAAiD;AACvG,QAAM,OAAOI,MAAK,UAAU,GAAG,YAAY,GAAG,KAAK,QAAQ,MAAM,MAAM;AACvE,MAAI,UAAUN,YAAW,IAAI,IAAI,gBAAgB,MAAM,IAAI,IAAI;AAC/D,MAAI,CAAC,SAAS;AACZ,QAAI;AACJ,QAAI;AACF,iBAAW,MAAM,MAAM,IAAI,IAAI,KAAK,QAAQ,cAAc,GAAG,OAAO,GAAG,GAAG,EAAE,QAAQ,YAAY,QAAQ,GAAM,EAAE,CAAC;AAAA,IACnH,SAAS,OAAO;AACd,YAAM,IAAI,MAAM,gCAAgC,EAAE,iDAAiD;AAAA,IACrG;AACA,QAAI,CAAC,SAAS,GAAI,OAAM,IAAI,MAAM,gCAAgC,EAAE,WAAW,SAAS,MAAM,IAAI;AAClG,UAAM,SAAS,SAAS,QAAQ,IAAI,gBAAgB;AACpD,QAAI,UAAU,OAAO,MAAM,MAAM,KAAK,QAAQ,KAAM,OAAM,IAAI,MAAM,aAAa,EAAE,6CAA6C;AAChI,cAAU,MAAM,oBAAoB,UAAU,KAAK,QAAQ,IAAI;AAC/D,QAAI,QAAQ,eAAe,KAAK,QAAQ,QAAQ,WAAW,QAAQ,EAAE,OAAO,OAAO,EAAE,OAAO,KAAK,MAAM,KAAK,QAAQ,QAAQ;AAC1H,YAAM,IAAI,MAAM,aAAa,EAAE,kCAAkC;AAAA,IACnE;AACA,gBAAY,OAAO;AACnB,gBAAY,MAAM,OAAO;AAAA,EAC3B;AACA,SAAO;AAAA,IACL,IAAI,KAAK;AAAA,IACT,SAAS,KAAK;AAAA,IACd,aAAa,KAAK;AAAA,IAClB,QAAQ,KAAK,QAAQ;AAAA,IACrB,iBAAiB,QAAQ;AAAA,IACzB,OAAO,YAAY,OAAO;AAAA,EAC5B;AACF;","names":["require","existsSync","mkdirSync","readFileSync","renameSync","writeFileSync","dirname","join"]}