create-agents24-app 0.1.2 → 0.1.4

package/README.md

@@ -1,6 +1,6 @@
 # create-agents24-app
 
-Last Updated: 2026-08-06
+Last Updated: 2026-08-13
 
 Create a canonical Agents24 React/Vite application:
 
@@ -13,17 +13,20 @@ Create the self-contained RAG starter with:
 ```bash
 npm create agents24-app@latest my-agent -- --starter rag
 cd my-agent
-agents24 install ./agents24
+agents24 prepare ./agents24
+agents24 plan ./agents24
+agents24 apply ./agents24
+agents24 publish ./agents24
 pnpm dev
 ```
 
-The starter adds an editable `agents24/` source package containing an Agent, a managed Knowledge Store, and its retrieval pipeline. Installation imports and publishes the Agent through the canonical Agent publication API, which publishes its required RAG dependencies. It does not run ingestion; the Knowledge Store starts empty and can be populated later.
+The starter adds an editable Package V2 source tree containing an Agent, managed Knowledge Store, retrieval pipeline, and managed content. `apply` creates or updates drafts and mirrors draft Store content; `publish` atomically promotes the unchanged current draft. `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.
 
 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.
 
-Generation does not require a deployment ID, Agent ID, or API key. `agents24 install` detects the generated app and configures its selected integration. Client deployment writes `VITE_AGENTS24_DEPLOYMENT_ID` and copies an explicit non-production `AGENTS24_BASE_URL` as public `VITE_AGENTS24_BASE_URL`; BFF writes `AGENTS24_API_KEY` and `AGENTS24_AGENT_ID`. Use `--no-write-env` to configure those values later.
+Generation does not require a deployment ID, Agent ID, or API key. `agents24 setup` detects the generated app and configures its selected integration. Direct-client mode retains `VITE_AGENTS24_DEPLOYMENT_ID`; BFF writes only `AGENTS24_API_KEY` and `AGENTS24_AGENT_ID` and uses no deployment. The generator creates `SESSION_COOKIE_SECRET` for the default signed guest session, and setup preserves it. Generated BFFs use draft runtime locally and published runtime in production; direct clients are published-only. Use `--no-write-env` to configure platform values later.
 
 Generated apps own their Shadcn component source, while `@agents24/client`, `@agents24/react`, and `@agents24/chat-react` provide the hardened runtime, state, streaming markdown, and MCP security behavior. Run `pnpm --filter create-agents24-app materialize:fixture` to create a disposable local fixture from the same canonical source used by the generator.
 
@@ -46,4 +49,4 @@ points to the same canonical scaffold and package guidance.
 
 ## Maintainer 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. Use `pnpm dev:agents24 -- --rag` to generate the RAG starter and run its `agents24/` package through the locally packed installer before starting the app. Set `AGENTS24_BASE_URL` when targeting a local backend; the installer reads `AGENTS24_API_KEY` from the environment or its masked prompt. Unchanged tarballs, scans, and packed runners are reused from the bounded development cache; add `--fresh` after `--` for a clean rebuild. The resulting app and lockfile are disposable local fixtures because their registry disappears on exit. `pnpm release:canary` publishes a clean committed train to the opt-in npm `dev` tag after bounded registry smoke validation. Neither command changes npm `rc` or `latest`.
+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. Use `pnpm dev:agents24 -- --rag` to generate the RAG starter and run its `agents24/` package through the locally packed `prepare`, `plan`, and `apply` lifecycle before starting the app. Set `AGENTS24_BASE_URL` when targeting a local backend; the CLI reads `AGENTS24_API_KEY` from the environment or its masked prompt. Unchanged tarballs, scans, and packed runners are reused from the bounded development cache; add `--fresh` after `--` for a clean rebuild. The resulting app and lockfile are disposable local fixtures because their registry disappears on exit. `pnpm release:canary` publishes a clean committed train to the opt-in npm `dev` tag after bounded registry smoke validation. Neither command changes npm `rc` or `latest`.

package/dist/{chunk-PXJTBSPX.js → chunk-3P5GRBYP.js}

@@ -126,9 +126,8 @@ function envFiles(options) {
       "# AGENTS24_BASE_URL=http://localhost:8026 # optional advanced override",
       "AGENTS24_API_KEY=your_server_only_api_key",
       "AGENTS24_AGENT_ID=your_agent_uuid",
-      "AGENTS24_DEPLOYMENT_ID=your_deployment_uuid",
-      "AGENTS24_CUSTOMER_ISSUER=https://your-app.example",
       "AGENTS24_AGENT_VERSION_ID=",
+      "# AGENTS24_RUNTIME_TARGET=draft # optional server-only override",
       "SESSION_COOKIE_SECRET=generate_at_least_32_random_bytes",
       "PORT=3001",
       ""
@@ -136,8 +135,6 @@ function envFiles(options) {
     local: [
       ...baseUrlOverride,
       ...options.agentId ? [`AGENTS24_AGENT_ID=${value(options.agentId)}`] : [],
-      ...options.deploymentId ? [`AGENTS24_DEPLOYMENT_ID=${value(options.deploymentId)}`] : [],
-      "AGENTS24_CUSTOMER_ISSUER=https://your-app.example",
       ...options.agentVersionId ? [`AGENTS24_AGENT_VERSION_ID=${value(options.agentVersionId)}`] : [],
       `SESSION_COOKIE_SECRET=${value(randomBytes(32).toString("base64url"))}`,
       "PORT=3001",
@@ -217,15 +214,9 @@ function createApp(options) {
       "__PM_BUILD__": runScriptCommand(options.packageManager, "build"),
       "__PM_PRODUCTION__": runScriptCommand(options.packageManager, options.integration === "bff" ? "start" : "preview"),
       "__PM_PRESET__": `${runScriptCommand(options.packageManager, "preset")} --`,
-      "__STARTER_SETUP__": options.starter ? `## Publish the included Agent
+      "__STARTER_SETUP__": options.starter ? `## Set up the included Agent
 
-This repository includes an editable Agent package in \`agents24/\`. From this directory run:
-
-\`\`\`bash
-agents24 install ./agents24
-\`\`\`
-
-The installer publishes the Agent and its RAG dependencies, then configures this app. It creates no ingestion job; the managed Knowledge Store starts empty.` : ""
+This 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.` : ""
     });
     const gitignore = join(staging, "_gitignore");
     if (existsSync(gitignore)) renameSync(gitignore, join(staging, ".gitignore"));
@@ -254,4 +245,4 @@ export {
   installDependencies,
   createApp
 };
-//# sourceMappingURL=chunk-PXJTBSPX.js.map
+//# sourceMappingURL=chunk-3P5GRBYP.js.map

package/dist/chunk-3P5GRBYP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/generator.ts"],"sourcesContent":["export const INTEGRATIONS = [\"client-deployment\", \"bff\"] as const;\nexport const PACKAGE_MANAGERS = [\"pnpm\", \"npm\", \"yarn\", \"bun\"] as const;\nexport const STARTERS = [\"rag\"] as const;\nexport const DEFAULT_PRESET = \"b2D1FHzlY\";\n\nexport type Integration = (typeof INTEGRATIONS)[number];\nexport type PackageManager = (typeof PACKAGE_MANAGERS)[number];\nexport type Starter = (typeof STARTERS)[number];\n\nexport type CreateAppOptions = {\n  directory: string;\n  integration: Integration;\n  preset: string;\n  packageManager: PackageManager;\n  install: boolean;\n  baseUrl: string;\n  starter?: Starter;\n  deploymentId?: string;\n  agentId?: 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 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 ? { starter: options.starter } : {}),\n    },\n    scripts,\n    dependencies,\n    devDependencies,\n  };\n}\n\nfunction envFiles(options: CreateAppOptions): { example: string; local: string } {\n  const value = (input: string | undefined) => JSON.stringify(String(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      \"AGENTS24_AGENT_ID=your_agent_uuid\",\n      \"AGENTS24_AGENT_VERSION_ID=\",\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.agentId ? [`AGENTS24_AGENT_ID=${value(options.agentId)}`] : []),\n      ...(options.agentVersionId ? [`AGENTS24_AGENT_VERSION_ID=${value(options.agentVersionId)}`] : []),\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    if (options.starter) copyLayer(`starters/${options.starter}`, staging);\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);\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"],"mappings":"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","names":["require"]}

package/dist/cli.js

@@ -5,7 +5,7 @@ import {
   PACKAGE_MANAGERS,
   STARTERS,
   createApp
-} from "./chunk-PXJTBSPX.js";
+} from "./chunk-3P5GRBYP.js";
 
 // src/cli.ts
 import { writeFileSync } from "fs";
@@ -67,7 +67,7 @@ Options:
   --yes                            Disable prompts; required values must be supplied
   --help
 
-Run agents24 install after generation to publish and configure the app.`;
+Run agents24 apply for drafts, agents24 publish for production, or agents24 setup to perform both and configure the app.`;
 
 // src/prompts.ts
 import process2 from "process";
@@ -166,7 +166,6 @@ async function resolveOptions(args) {
   }
   const fields = {
     agentId: flag(args, "agent-id"),
-    deploymentId: flag(args, "deployment-id"),
     agentVersionId: flag(args, "agent-version-id")
   };
   for (const [name, value] of Object.entries(fields)) {

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-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-version-id <uuid>        Optional pinned BFF version\n  --starter <rag>                  Include an editable Agent + RAG source package\n  --no-install\n  --yes                            Disable prompts; required values must be supplied\n  --help\n\nRun agents24 install after generation to publish 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  STARTERS,\n  DEFAULT_PRESET,\n  type CreateAppOptions,\n  type Integration,\n  type PackageManager,\n  type Starter,\n} from \"./types.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 starter = oneOf<Starter>(flag(args, \"starter\"), STARTERS, \"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  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    deploymentId: flag(args, \"deployment-id\"),\n    agentVersionId: flag(args, \"agent-version-id\"),\n  };\n  for (const [name, value] of Object.entries(fields)) {\n    if (!value) continue;\n    if (!UUID.test(value)) throw new Error(`--${name.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)} must be a valid UUID.`);\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      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-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-version-id <uuid>        Optional pinned BFF version\n  --starter <rag>                  Include an editable Agent + RAG source package\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  STARTERS,\n  DEFAULT_PRESET,\n  type CreateAppOptions,\n  type Integration,\n  type PackageManager,\n  type Starter,\n} from \"./types.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 starter = oneOf<Starter>(flag(args, \"starter\"), STARTERS, \"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  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    agentVersionId: flag(args, \"agent-version-id\"),\n  };\n  for (const [name, value] of Object.entries(fields)) {\n    if (!value) continue;\n    if (!UUID.test(value)) throw new Error(`--${name.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)} must be a valid UUID.`);\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"]}

package/dist/index.js

@@ -6,7 +6,7 @@ import {
   STARTERS,
   createApp,
   installDependencies
-} from "./chunk-PXJTBSPX.js";
+} from "./chunk-3P5GRBYP.js";
 export {
   DEFAULT_PRESET,
   INTEGRATIONS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-agents24-app",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Create a production-ready Agents24 React application.",
   "license": "MIT",
   "repository": {

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

@@ -8,8 +8,6 @@ catch (error) {
 const REQUIRED = [
   "AGENTS24_API_KEY",
   "AGENTS24_AGENT_ID",
-  "AGENTS24_DEPLOYMENT_ID",
-  "AGENTS24_CUSTOMER_ISSUER",
   "SESSION_COOKIE_SECRET",
 ] as const;
 
@@ -23,8 +21,10 @@ 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_AGENT_VERSION_ID: String(process.env.AGENTS24_AGENT_VERSION_ID || "").trim() || undefined,
+  AGENTS24_RUNTIME_TARGET: String(process.env.AGENTS24_RUNTIME_TARGET || "").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 (env.AGENTS24_RUNTIME_TARGET && !["draft", "published"].includes(env.AGENTS24_RUNTIME_TARGET)) throw new Error("AGENTS24_RUNTIME_TARGET must be draft or published.");

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

@@ -16,8 +16,8 @@ const client = new Agents24({
 const agents24 = createAgents24BffHandler({
   client,
   agentId: env.AGENTS24_AGENT_ID,
-  deploymentId: env.AGENTS24_DEPLOYMENT_ID,
   agentVersionId: env.AGENTS24_AGENT_VERSION_ID,
+  runtimeTarget: (env.AGENTS24_RUNTIME_TARGET || (process.env.NODE_ENV === "production" ? "published" : "draft")) as "draft" | "published",
   resolvePrincipal: resolveAgents24Principal,
   revokePrincipal: (request) => revokeAgents24Principal(request),
 });

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

@@ -36,12 +36,13 @@ function cookie(value: string, request: Request, maxAge = MAX_AGE): string {
 }
 
 // Replace this function with your application session lookup. Never accept a
-// user ID supplied by browser request data.
+// user ID supplied by browser request data. Authenticated hosts may also return
+// a stable `issuer` to share customer governance across Agents and applications.
 export function resolveAgents24Principal(request: Request): AgentBffPrincipalResolution {
   const existing = verifiedId(parseCookies(request)[COOKIE]);
   const subject = existing || randomUUID();
   return {
-    principal: { issuer: env.AGENTS24_CUSTOMER_ISSUER, subject, externalSessionId: subject },
+    principal: { subject, externalSessionId: subject },
     ...(existing ? {} : { responseHeaders: { "Set-Cookie": cookie(`${subject}.${signature(subject)}`, request) } }),
   };
 }

package/templates/starters/rag/agents24/agents24.yaml

@@ -1,10 +1,13 @@
-schema: agents24.package/v1
+schema: agents24.package/v2
 name: __APP_NAME__-rag
 description: A conversational Agent backed by a managed Knowledge Store.
 resources:
-  - rag/knowledge.yaml
-  - stores/knowledge.yaml
-  - workflows/main.yaml
+  - key: support-agent
+    path: workflows/main.yaml
+  - key: support-rag
+    path: rag/knowledge.yaml
+  - key: support-store
+    path: stores/knowledge.yaml
 requires:
   models:
     embedding:

package/templates/starters/rag/agents24/knowledge/getting-started.md

@@ -0,0 +1,3 @@
+# Getting started
+
+Replace this file with your product knowledge. Files under `knowledge/` are mirrored exactly into the managed Knowledge Store on each apply.

package/templates/starters/rag/agents24/stores/knowledge.yaml

@@ -8,3 +8,5 @@ chunking:
   chunk_overlap: 50
 retrieval_policy: semantic_only
 default_namespace: knowledge
+content:
+  - ../knowledge/**

package/versions.json

@@ -1,9 +1,9 @@
 {
   "agents24": {
-    "@agents24/client": "^0.2.1",
-    "@agents24/react": "^0.2.1",
-    "@agents24/chat-react": "^0.5.1",
-    "@agents24/node": "^0.2.1"
+    "@agents24/client": "^0.2.2",
+    "@agents24/react": "^0.2.2",
+    "@agents24/chat-react": "^0.5.4",
+    "@agents24/node": "^0.4.0"
   },
   "runtime": {
     "react": "^19.2.3",

package/dist/chunk-PXJTBSPX.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/types.ts","../src/generator.ts"],"sourcesContent":["export const INTEGRATIONS = [\"client-deployment\", \"bff\"] as const;\nexport const PACKAGE_MANAGERS = [\"pnpm\", \"npm\", \"yarn\", \"bun\"] as const;\nexport const STARTERS = [\"rag\"] as const;\nexport const DEFAULT_PRESET = \"b2D1FHzlY\";\n\nexport type Integration = (typeof INTEGRATIONS)[number];\nexport type PackageManager = (typeof PACKAGE_MANAGERS)[number];\nexport type Starter = (typeof STARTERS)[number];\n\nexport type CreateAppOptions = {\n  directory: string;\n  integration: Integration;\n  preset: string;\n  packageManager: PackageManager;\n  install: boolean;\n  baseUrl: string;\n  starter?: Starter;\n  deploymentId?: string;\n  agentId?: 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 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 ? { starter: options.starter } : {}),\n    },\n    scripts,\n    dependencies,\n    devDependencies,\n  };\n}\n\nfunction envFiles(options: CreateAppOptions): { example: string; local: string } {\n  const value = (input: string | undefined) => JSON.stringify(String(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      \"AGENTS24_AGENT_ID=your_agent_uuid\",\n      \"AGENTS24_DEPLOYMENT_ID=your_deployment_uuid\",\n      \"AGENTS24_CUSTOMER_ISSUER=https://your-app.example\",\n      \"AGENTS24_AGENT_VERSION_ID=\",\n      \"SESSION_COOKIE_SECRET=generate_at_least_32_random_bytes\",\n      \"PORT=3001\",\n      \"\",\n    ].join(\"\\n\"),\n    local: [\n      ...baseUrlOverride,\n      ...(options.agentId ? [`AGENTS24_AGENT_ID=${value(options.agentId)}`] : []),\n      ...(options.deploymentId ? [`AGENTS24_DEPLOYMENT_ID=${value(options.deploymentId)}`] : []),\n      \"AGENTS24_CUSTOMER_ISSUER=https://your-app.example\",\n      ...(options.agentVersionId ? [`AGENTS24_AGENT_VERSION_ID=${value(options.agentVersionId)}`] : []),\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    if (options.starter) copyLayer(`starters/${options.starter}`, staging);\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        ? `## Publish the included Agent\\n\\nThis repository includes an editable Agent package in \\`agents24/\\`. From this directory run:\\n\\n\\`\\`\\`bash\\nagents24 install ./agents24\\n\\`\\`\\`\\n\\nThe installer publishes the Agent and its RAG dependencies, then configures this app. It creates no ingestion job; the managed Knowledge Store starts empty.`\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);\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"],"mappings":"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","names":["require"]}