@chat-js/cli 0.6.2 → 0.6.3

package/dist/index.js

@@ -3844,7 +3844,7 @@ var {
 // package.json
 var package_default = {
   name: "@chat-js/cli",
-  version: "0.6.2",
+  version: "0.6.3",
   description: "CLI for creating and extending ChatJS apps",
   license: "Apache-2.0",
   repository: {
@@ -3895,8 +3895,8 @@ var package_default = {
 };
 
 // src/commands/add.ts
-import fs4 from "node:fs/promises";
-import path6 from "node:path";
+import fs6 from "node:fs/promises";
+import path8 from "node:path";
 
 // ../../node_modules/.bun/@clack+core@1.2.0/node_modules/@clack/core/dist/index.mjs
 import { styleText as y } from "node:util";
@@ -5184,9 +5184,96 @@ ${c2}
   }
 } }).prompt();
 
-// src/registry/fetch.ts
-import fs from "node:fs/promises";
+// src/utils/get-config.ts
+import { spawn } from "node:child_process";
+import path2 from "node:path";
+
+// src/utils/get-package-manager.ts
+import fs from "node:fs";
 import path from "node:path";
+function inferPackageManager(cwd = process.cwd()) {
+  let currentDir = path.resolve(cwd);
+  while (true) {
+    if (fs.existsSync(path.join(currentDir, "pnpm-lock.yaml")))
+      return "pnpm";
+    if (fs.existsSync(path.join(currentDir, "yarn.lock")))
+      return "yarn";
+    if (fs.existsSync(path.join(currentDir, "package-lock.json")))
+      return "npm";
+    if (fs.existsSync(path.join(currentDir, "bun.lock")) || fs.existsSync(path.join(currentDir, "bun.lockb"))) {
+      return "bun";
+    }
+    const parentDir = path.dirname(currentDir);
+    if (parentDir === currentDir) {
+      break;
+    }
+    currentDir = parentDir;
+  }
+  const ua = process.env.npm_config_user_agent ?? "";
+  if (ua.startsWith("pnpm/"))
+    return "pnpm";
+  if (ua.startsWith("yarn/"))
+    return "yarn";
+  if (ua.startsWith("npm/"))
+    return "npm";
+  if (ua.startsWith("bun/"))
+    return "bun";
+  return "npm";
+}
+
+// src/utils/get-config.ts
+var EVAL_SCRIPT = `
+import userConfig from "./chat.config.ts";
+import { applyDefaults } from "./lib/config-schema";
+process.stdout.write(JSON.stringify(applyDefaults(userConfig)));
+`;
+function getTsEvalCommand(pm) {
+  switch (pm) {
+    case "bun":
+      return ["bun", ["--eval", EVAL_SCRIPT]];
+    case "pnpm":
+      return ["pnpm", ["dlx", "tsx", "--eval", EVAL_SCRIPT]];
+    case "yarn":
+      return ["yarn", ["dlx", "tsx", "--eval", EVAL_SCRIPT]];
+    default:
+      return ["npx", ["tsx", "--eval", EVAL_SCRIPT]];
+  }
+}
+async function loadProjectConfig(cwd) {
+  const pm = inferPackageManager(cwd);
+  const [cmd, args] = getTsEvalCommand(pm);
+  const stdout = await new Promise((resolve, reject) => {
+    const child = spawn(cmd, args, {
+      cwd,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    const out = [];
+    const err = [];
+    child.stdout?.on("data", (d3) => out.push(String(d3)));
+    child.stderr?.on("data", (d3) => err.push(String(d3)));
+    child.on("error", (e) => reject(new Error(`Could not spawn ${cmd}. Make sure ${pm} is installed.
+${e.message}`)));
+    child.on("close", (code) => {
+      if (code === 0)
+        resolve(out.join(""));
+      else
+        reject(new Error(`Failed to load config:
+${err.join("").trim()}`));
+    });
+  });
+  const parsed = JSON.parse(stdout);
+  return {
+    paths: {
+      tools: parsed?.paths?.tools ?? "@/tools/chatjs"
+    }
+  };
+}
+function resolveToolsPath(alias, cwd) {
+  if (alias.startsWith("@/")) {
+    return path2.join(cwd, alias.slice(2));
+  }
+  return path2.resolve(cwd, alias);
+}
 
 // ../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/external.js
 var exports_external = {};
@@ -5953,10 +6040,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path) {
-  if (!path)
+function getElementAtPath(obj, path3) {
+  if (!path3)
     return obj;
-  return path.reduce((acc, key) => acc?.[key], obj);
+  return path3.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -6337,11 +6424,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path, issues) {
+function prefixIssues(path3, issues) {
   return issues.map((iss) => {
     var _a;
     (_a = iss).path ?? (_a.path = []);
-    iss.path.unshift(path);
+    iss.path.unshift(path3);
     return iss;
   });
 }
@@ -6524,7 +6611,7 @@ function formatError(error, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error2, path = []) => {
+  const processError = (error2, path3 = []) => {
     var _a, _b;
     for (const issue2 of error2.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
@@ -6534,7 +6621,7 @@ function treeifyError(error, mapper = (issue2) => issue2.message) {
       } else if (issue2.code === "invalid_element") {
         processError({ issues: issue2.issues }, issue2.path);
       } else {
-        const fullpath = [...path, ...issue2.path];
+        const fullpath = [...path3, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -6566,8 +6653,8 @@ function treeifyError(error, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path) {
+  const path3 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path3) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -18314,13 +18401,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path = ref.slice(1).split("/").filter(Boolean);
-  if (path.length === 0) {
+  const path3 = ref.slice(1).split("/").filter(Boolean);
+  if (path3.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path[0] === defsKey) {
-    const key = path[1];
+  if (path3[0] === defsKey) {
+    const key = path3[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -18720,173 +18807,6 @@ function date4(params) {
 
 // ../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/external.js
 config(en_default());
-// src/registry/schema.ts
-var envRequirementSchema = exports_external.object({
-  description: exports_external.string().optional(),
-  options: exports_external.array(exports_external.array(exports_external.string()))
-});
-var registryToolFileSchema = exports_external.object({
-  path: exports_external.string(),
-  content: exports_external.string(),
-  type: exports_external.enum(["tool", "renderer", "lib", "component", "hook"]),
-  target: exports_external.string()
-});
-var registryToolItemSchema = exports_external.object({
-  name: exports_external.string(),
-  description: exports_external.string().optional(),
-  dependencies: exports_external.array(exports_external.string()).optional(),
-  devDependencies: exports_external.array(exports_external.string()).optional(),
-  registryDependencies: exports_external.array(exports_external.string()).optional(),
-  envRequirements: exports_external.array(envRequirementSchema).optional(),
-  files: exports_external.array(registryToolFileSchema)
-});
-
-// src/registry/fetch.ts
-var DEFAULT_REGISTRY_URL = "https://registry.chatjs.dev/items/{name}.json";
-function getRegistryUrl(override) {
-  return override ?? process.env.CHATJS_REGISTRY_URL ?? DEFAULT_REGISTRY_URL;
-}
-async function fetchRegistryItem(name, registryUrl) {
-  const template = getRegistryUrl(registryUrl);
-  const resolved = template.replace("{name}", encodeURIComponent(name));
-  const isLocalPath = resolved.startsWith(".") || path.isAbsolute(resolved);
-  const filePath = resolved.startsWith(".") ? path.resolve(process.cwd(), resolved) : resolved;
-  let raw;
-  if (isLocalPath) {
-    const content = await fs.readFile(filePath, "utf8").catch(() => {
-      throw new Error(`Tool "${name}" not found at ${filePath}`);
-    });
-    raw = JSON.parse(content);
-  } else {
-    const res = await fetch(filePath).catch(() => {
-      throw new Error(`Could not reach registry. Check your internet connection.`);
-    });
-    if (res.status === 404)
-      throw new Error(`Tool "${name}" not found in registry.`);
-    if (!res.ok)
-      throw new Error(`Registry fetch failed: ${res.status} ${res.statusText}`);
-    raw = await res.json();
-  }
-  return registryToolItemSchema.parse(raw);
-}
-
-// src/registry/resolve.ts
-async function resolveRegistryItems(names, registryUrl) {
-  const seen = new Set;
-  const items = [];
-  async function visit(name) {
-    if (seen.has(name)) {
-      return;
-    }
-    seen.add(name);
-    const item = await fetchRegistryItem(name, registryUrl);
-    for (const dependency of item.registryDependencies ?? []) {
-      await visit(dependency);
-    }
-    items.push(item);
-  }
-  for (const name of names) {
-    await visit(name);
-  }
-  return {
-    items,
-    dependencies: Array.from(new Set(items.flatMap((item) => item.dependencies ?? []))),
-    devDependencies: Array.from(new Set(items.flatMap((item) => item.devDependencies ?? []))),
-    files: items.flatMap((item) => item.files)
-  };
-}
-
-// src/utils/get-config.ts
-import { spawn } from "node:child_process";
-import path3 from "node:path";
-
-// src/utils/get-package-manager.ts
-import fs2 from "node:fs";
-import path2 from "node:path";
-function inferPackageManager(cwd = process.cwd()) {
-  let currentDir = path2.resolve(cwd);
-  while (true) {
-    if (fs2.existsSync(path2.join(currentDir, "pnpm-lock.yaml")))
-      return "pnpm";
-    if (fs2.existsSync(path2.join(currentDir, "yarn.lock")))
-      return "yarn";
-    if (fs2.existsSync(path2.join(currentDir, "package-lock.json")))
-      return "npm";
-    if (fs2.existsSync(path2.join(currentDir, "bun.lock")) || fs2.existsSync(path2.join(currentDir, "bun.lockb"))) {
-      return "bun";
-    }
-    const parentDir = path2.dirname(currentDir);
-    if (parentDir === currentDir) {
-      break;
-    }
-    currentDir = parentDir;
-  }
-  const ua = process.env.npm_config_user_agent ?? "";
-  if (ua.startsWith("pnpm/"))
-    return "pnpm";
-  if (ua.startsWith("yarn/"))
-    return "yarn";
-  if (ua.startsWith("npm/"))
-    return "npm";
-  if (ua.startsWith("bun/"))
-    return "bun";
-  return "npm";
-}
-
-// src/utils/get-config.ts
-var EVAL_SCRIPT = `
-import userConfig from "./chat.config.ts";
-import { applyDefaults } from "./lib/config-schema";
-process.stdout.write(JSON.stringify(applyDefaults(userConfig)));
-`;
-function getTsEvalCommand(pm) {
-  switch (pm) {
-    case "bun":
-      return ["bun", ["--eval", EVAL_SCRIPT]];
-    case "pnpm":
-      return ["pnpm", ["dlx", "tsx", "--eval", EVAL_SCRIPT]];
-    case "yarn":
-      return ["yarn", ["dlx", "tsx", "--eval", EVAL_SCRIPT]];
-    default:
-      return ["npx", ["tsx", "--eval", EVAL_SCRIPT]];
-  }
-}
-async function loadProjectConfig(cwd) {
-  const pm = inferPackageManager(cwd);
-  const [cmd, args] = getTsEvalCommand(pm);
-  const stdout = await new Promise((resolve, reject) => {
-    const child = spawn(cmd, args, {
-      cwd,
-      stdio: ["ignore", "pipe", "pipe"]
-    });
-    const out = [];
-    const err = [];
-    child.stdout?.on("data", (d3) => out.push(String(d3)));
-    child.stderr?.on("data", (d3) => err.push(String(d3)));
-    child.on("error", (e) => reject(new Error(`Could not spawn ${cmd}. Make sure ${pm} is installed.
-${e.message}`)));
-    child.on("close", (code) => {
-      if (code === 0)
-        resolve(out.join(""));
-      else
-        reject(new Error(`Failed to load config:
-${err.join("").trim()}`));
-    });
-  });
-  const parsed = JSON.parse(stdout);
-  return {
-    paths: {
-      tools: parsed?.paths?.tools ?? "@/tools/chatjs"
-    }
-  };
-}
-function resolveToolsPath(alias, cwd) {
-  if (alias.startsWith("@/")) {
-    return path3.join(cwd, alias.slice(2));
-  }
-  return path3.resolve(cwd, alias);
-}
-
 // ../../node_modules/.bun/kleur@4.1.5/node_modules/kleur/colors.mjs
 var FORCE_COLOR;
 var NODE_DISABLE_COLORS;
@@ -18993,6 +18913,118 @@ function handleError(error48) {
   process.exit(1);
 }
 
+// src/utils/install-registry-tools.ts
+import fs5 from "node:fs/promises";
+import path7 from "node:path";
+
+// src/registry/fetch.ts
+import fs2 from "node:fs/promises";
+import path3 from "node:path";
+
+// src/registry/schema.ts
+var envRequirementSchema = exports_external.object({
+  description: exports_external.string().optional(),
+  options: exports_external.array(exports_external.array(exports_external.string()))
+});
+var registryToolFileSchema = exports_external.object({
+  path: exports_external.string(),
+  content: exports_external.string(),
+  type: exports_external.enum(["tool", "renderer", "lib", "component", "hook"]),
+  target: exports_external.string()
+});
+var registryToolItemSchema = exports_external.object({
+  name: exports_external.string(),
+  description: exports_external.string().optional(),
+  hidden: exports_external.boolean().optional(),
+  dependencies: exports_external.array(exports_external.string()).optional(),
+  devDependencies: exports_external.array(exports_external.string()).optional(),
+  registryDependencies: exports_external.array(exports_external.string()).optional(),
+  envRequirements: exports_external.array(envRequirementSchema).optional(),
+  files: exports_external.array(registryToolFileSchema)
+});
+var registryIndexItemSchema = exports_external.object({
+  name: exports_external.string(),
+  description: exports_external.string().optional(),
+  hidden: exports_external.boolean().optional()
+});
+
+// src/registry/fetch.ts
+var DEFAULT_REGISTRY_URL = "https://unpkg.com/@chat-js/registry@0/items/{name}.json";
+function getRegistryUrl(override) {
+  return override ?? process.env.CHATJS_REGISTRY_URL ?? DEFAULT_REGISTRY_URL;
+}
+function getRegistryIndexUrl(registryUrl) {
+  const template = getRegistryUrl(registryUrl);
+  if (template.includes("{name}")) {
+    return template.replace(/(\{name\}\.json|\{name\})$/, "index.json");
+  }
+  if (template.startsWith(".") || path3.isAbsolute(template)) {
+    return path3.join(path3.dirname(template), "index.json");
+  }
+  return new URL("../index.json", template).toString();
+}
+async function fetchJson(source) {
+  const isLocalPath = source.startsWith(".") || path3.isAbsolute(source);
+  const filePath = source.startsWith(".") ? path3.resolve(process.cwd(), source) : source;
+  if (isLocalPath) {
+    const content = await fs2.readFile(filePath, "utf8").catch(() => {
+      throw new Error(`Registry resource not found at ${filePath}`);
+    });
+    return JSON.parse(content);
+  }
+  const res = await fetch(filePath).catch(() => {
+    throw new Error(`Could not reach registry. Check your internet connection.`);
+  });
+  if (res.status === 404) {
+    throw new Error(`Registry resource not found: ${filePath}`);
+  }
+  if (!res.ok) {
+    throw new Error(`Registry fetch failed: ${res.status} ${res.statusText}`);
+  }
+  return res.json();
+}
+async function fetchRegistryIndex(registryUrl) {
+  const raw = await fetchJson(getRegistryIndexUrl(registryUrl));
+  return registryIndexItemSchema.array().parse(raw);
+}
+async function fetchRegistryItem(name, registryUrl) {
+  const template = getRegistryUrl(registryUrl);
+  const resolved = template.replace("{name}", encodeURIComponent(name));
+  const raw = await fetchJson(resolved).catch((error48) => {
+    if (error48 instanceof Error && error48.message.startsWith("Registry resource not found")) {
+      throw new Error(`Tool "${name}" not found in registry.`);
+    }
+    throw error48;
+  });
+  return registryToolItemSchema.parse(raw);
+}
+
+// src/registry/resolve.ts
+async function resolveRegistryItems(names, registryUrl) {
+  const seen = new Set;
+  const items = [];
+  async function visit(name) {
+    if (seen.has(name)) {
+      return;
+    }
+    seen.add(name);
+    const item = await fetchRegistryItem(name, registryUrl);
+    for (const dependency of item.registryDependencies ?? []) {
+      await visit(dependency);
+    }
+    items.push(item);
+  }
+  for (const name of names) {
+    await visit(name);
+  }
+  return {
+    items,
+    dependencies: Array.from(new Set(items.flatMap((item) => item.dependencies ?? []))),
+    devDependencies: Array.from(new Set(items.flatMap((item) => item.devDependencies ?? []))),
+    files: items.flatMap((item) => item.files)
+  };
+}
+
 // src/utils/inject-tool.ts
 var MARKERS = {
   toolImports: {
@@ -19085,6 +19117,10 @@ function createEmptyUiTemplate() {
 `;
 }
 
+// src/utils/install-deps.ts
+import fs3 from "node:fs/promises";
+import path4 from "node:path";
+
 // src/utils/run-command.ts
 import { spawn as spawn2 } from "node:child_process";
 async function runCommand(command, args, cwd) {
@@ -19106,13 +19142,31 @@ ${stderr.join("")}`.trim()));
 }
 
 // src/utils/install-deps.ts
-async function installDependencies(deps, devDeps, cwd) {
+async function updatePackageJsonDependencies(deps, devDeps, cwd) {
+  const packageJsonPath = path4.join(cwd, "package.json");
+  const packageJson = JSON.parse(await fs3.readFile(packageJsonPath, "utf8"));
+  packageJson.dependencies ??= {};
+  packageJson.devDependencies ??= {};
+  for (const dependency of deps) {
+    packageJson.dependencies[dependency] ??= "latest";
+  }
+  for (const dependency of devDeps) {
+    packageJson.devDependencies[dependency] ??= "latest";
+  }
+  await fs3.writeFile(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}
+`);
+}
+async function installDependencies(deps, devDeps, cwd, installNow = true, packageManager) {
   const dependencies = Array.from(new Set(deps));
   const developmentDependencies = Array.from(new Set(devDeps));
   if (!dependencies.length && !developmentDependencies.length) {
     return;
   }
-  const pm = inferPackageManager(cwd);
+  if (!installNow) {
+    await updatePackageJsonDependencies(dependencies, developmentDependencies, cwd);
+    return;
+  }
+  const pm = packageManager ?? inferPackageManager(cwd);
   if (dependencies.length) {
     const args = pm === "yarn" ? ["add", ...dependencies] : ["add", ...dependencies];
     await runCommand(pm, args, cwd);
@@ -20499,11 +20553,11 @@ function spinner(text, options) {
 }
 
 // src/utils/write-files.ts
-import fs3 from "node:fs/promises";
-import path5 from "node:path";
+import fs4 from "node:fs/promises";
+import path6 from "node:path";
 
 // src/utils/is-safe-target.ts
-import path4 from "node:path";
+import path5 from "node:path";
 function isSafeTarget(targetPath, root) {
   if (targetPath.includes("\x00")) {
     return false;
@@ -20518,8 +20572,8 @@ function isSafeTarget(targetPath, root) {
   } catch {
     return false;
   }
-  const normalizedTarget = path4.normalize(decodedPath.replace(/\\/g, "/"));
-  const normalizedRoot = path4.normalize(root);
+  const normalizedTarget = path5.normalize(decodedPath.replace(/\\/g, "/"));
+  const normalizedRoot = path5.normalize(root);
   const targetSegments = decodedPath.replace(/\\/g, "/").split("/").filter(Boolean);
   const normalizedSegments = normalizedTarget.split(/[\\/]+/).filter(Boolean);
   if (targetSegments.includes("..") || normalizedSegments.includes("..")) {
@@ -20528,8 +20582,8 @@ function isSafeTarget(targetPath, root) {
   if (/^[a-zA-Z]:[\\/]/.test(decodedPath)) {
     return false;
   }
-  const resolvedPath = path4.isAbsolute(normalizedTarget) ? normalizedTarget : path4.resolve(normalizedRoot, normalizedTarget);
-  return resolvedPath === normalizedRoot || resolvedPath.startsWith(`${normalizedRoot}${path4.sep}`);
+  const resolvedPath = path5.isAbsolute(normalizedTarget) ? normalizedTarget : path5.resolve(normalizedRoot, normalizedTarget);
+  return resolvedPath === normalizedRoot || resolvedPath.startsWith(`${normalizedRoot}${path5.sep}`);
 }
 
 // src/utils/write-files.ts
@@ -20537,14 +20591,14 @@ function rewriteToolkitImports(content, toolsAlias) {
   return content.replace(/(["'])@toolkit\/(lib|components|hooks)\/([^"'`]+)\1/g, (_match, quote, kind, rest) => `${quote}${toolsAlias}/_shared/${kind}/${rest}${quote}`);
 }
 async function assertNoSymlinkTraversal(dest, toolsDir) {
-  const relativeParent = path5.relative(toolsDir, path5.dirname(dest));
-  const segments = relativeParent.split(path5.sep).filter((segment) => segment.length > 0);
+  const relativeParent = path6.relative(toolsDir, path6.dirname(dest));
+  const segments = relativeParent.split(path6.sep).filter((segment) => segment.length > 0);
   let currentPath = toolsDir;
   for (const segment of segments) {
-    currentPath = path5.join(currentPath, segment);
-    const stat = await fs3.lstat(currentPath).catch(() => null);
+    currentPath = path6.join(currentPath, segment);
+    const stat = await fs4.lstat(currentPath).catch(() => null);
     if (stat?.isSymbolicLink()) {
-      throw new Error(`Refusing to write through symlinked path "${path5.relative(toolsDir, currentPath)}"`);
+      throw new Error(`Refusing to write through symlinked path "${path6.relative(toolsDir, currentPath)}"`);
     }
   }
 }
@@ -20559,45 +20613,166 @@ async function writeToolFiles(files, {
     if (!isSafeTarget(file2.target, toolsDir)) {
       throw new Error(`Refusing to write "${file2.target}" outside the tools directory`);
     }
-    const dest = path5.resolve(toolsDir, file2.target);
+    const dest = path6.resolve(toolsDir, file2.target);
     await assertNoSymlinkTraversal(dest, toolsDir);
-    const exists = await fs3.access(dest).then(() => true).catch(() => false);
+    const exists = await fs4.access(dest).then(() => true).catch(() => false);
     if (exists && !overwrite) {
       existing.push(dest);
       continue;
     }
-    await fs3.mkdir(path5.dirname(dest), { recursive: true });
-    const realToolsDir = await fs3.realpath(toolsDir).catch(() => path5.resolve(toolsDir));
-    const realParentDir = await fs3.realpath(path5.dirname(dest));
-    if (realParentDir !== realToolsDir && !realParentDir.startsWith(`${realToolsDir}${path5.sep}`)) {
+    await fs4.mkdir(path6.dirname(dest), { recursive: true });
+    const realToolsDir = await fs4.realpath(toolsDir).catch(() => path6.resolve(toolsDir));
+    const realParentDir = await fs4.realpath(path6.dirname(dest));
+    if (realParentDir !== realToolsDir && !realParentDir.startsWith(`${realToolsDir}${path6.sep}`)) {
       throw new Error(`Refusing to write "${file2.target}" outside the tools directory`);
     }
     if (exists) {
-      const stat = await fs3.lstat(dest);
+      const stat = await fs4.lstat(dest);
       if (stat.isSymbolicLink()) {
         throw new Error(`Refusing to overwrite symlinked file "${file2.target}"`);
       }
     }
     const content = dest.endsWith(".ts") || dest.endsWith(".tsx") || dest.endsWith(".js") ? rewriteToolkitImports(file2.content, toolsAlias) : file2.content;
-    await fs3.writeFile(dest, content, "utf8");
+    await fs4.writeFile(dest, content, "utf8");
     written.push(dest);
   }
   return { written, existing };
 }
 
-// src/commands/add.ts
+// src/utils/install-registry-tools.ts
+function isRequirementSatisfied(requirement, env2) {
+  return requirement.options.some((option) => option.every((name) => Boolean(env2[name])));
+}
 function formatRequirementDescription(requirement) {
   return requirement.description ?? requirement.options.map((option) => option.join(" + ")).join(" or ");
 }
+async function installRegistryTools({
+  tools,
+  cwd,
+  toolsDir,
+  toolsAlias,
+  overwrite = false,
+  registryUrl,
+  installDependenciesNow = true,
+  packageManager,
+  confirmOverwrite
+}) {
+  if (tools.length === 0) {
+    return;
+  }
+  const toolsIndexPath = path7.join(toolsDir, "tools.ts");
+  const uiIndexPath = path7.join(toolsDir, "ui.ts");
+  const fetchSpinner = spinner(tools.length === 1 ? `Fetching ${tools[0]}...` : "Fetching tools...");
+  fetchSpinner.start();
+  let resolution;
+  try {
+    resolution = await resolveRegistryItems(tools, registryUrl);
+    fetchSpinner.succeed(tools.length === 1 ? `Fetched ${tools[0]}` : `Fetched ${tools.length} tools`);
+  } catch (err) {
+    fetchSpinner.fail("Failed to fetch tools");
+    throw err;
+  }
+  const filesToWrite = resolution.files;
+  const dependencies = resolution.dependencies;
+  const devDependencies = resolution.devDependencies;
+  const missingEnvRequirements = resolution.items.flatMap((item) => (item.envRequirements ?? []).filter((requirement) => !isRequirementSatisfied(requirement, process.env)).map((requirement) => ({
+    tool: item.name,
+    requirement: formatRequirementDescription(requirement)
+  })));
+  let effectiveOverwrite = overwrite;
+  const writeSpinner = spinner("Writing files...");
+  writeSpinner.start();
+  const initialWrite = await writeToolFiles(filesToWrite, {
+    overwrite: effectiveOverwrite,
+    toolsDir,
+    toolsAlias
+  });
+  if (initialWrite.existing.length > 0 && !effectiveOverwrite) {
+    writeSpinner.stop();
+    const shouldOverwrite = confirmOverwrite ? await confirmOverwrite(initialWrite.existing) : false;
+    if (!shouldOverwrite) {
+      throw new Error(`Tool install would overwrite existing files. Re-run with overwrite enabled.`);
+    }
+    effectiveOverwrite = true;
+  }
+  let writtenFiles = initialWrite.written;
+  if (effectiveOverwrite && initialWrite.existing.length > 0) {
+    writeSpinner.start();
+    const secondWrite = await writeToolFiles(filesToWrite, {
+      overwrite: true,
+      toolsDir,
+      toolsAlias
+    });
+    writtenFiles = secondWrite.written;
+  }
+  writeSpinner.succeed(writtenFiles.length > 0 ? `Wrote ${writtenFiles.map((file2) => path7.relative(cwd, file2)).join(", ")}` : `No file changes needed for ${tools.join(", ")}`);
+  if (dependencies.length > 0 || devDependencies.length > 0) {
+    const depsSpinner = spinner(installDependenciesNow ? "Installing dependencies..." : "Updating package.json dependencies...");
+    depsSpinner.start();
+    try {
+      await installDependencies(dependencies, devDependencies, cwd, installDependenciesNow, packageManager);
+      const installed = [
+        ...dependencies,
+        ...devDependencies.map((dep) => `${dep} (dev)`)
+      ];
+      depsSpinner.succeed(`${installDependenciesNow ? "Installed" : "Recorded"}: ${installed.join(", ")}`);
+    } catch (err) {
+      depsSpinner.fail(installDependenciesNow ? "Failed to install dependencies" : "Failed to update package.json dependencies");
+      throw err;
+    }
+  }
+  if (missingEnvRequirements.length > 0) {
+    const details = missingEnvRequirements.map(({ tool, requirement }) => `${tool}: ${requirement}`).join(", ");
+    O2.warn(`Missing env vars for installed tools: ${details}`);
+  }
+  const injectSpinner = spinner("Updating tool registry index...");
+  injectSpinner.start();
+  try {
+    let toolsSource;
+    let uiSource;
+    try {
+      toolsSource = await fs5.readFile(toolsIndexPath, "utf8");
+    } catch {
+      toolsSource = createEmptyToolsTemplate();
+    }
+    try {
+      uiSource = await fs5.readFile(uiIndexPath, "utf8");
+    } catch {
+      uiSource = createEmptyUiTemplate();
+    }
+    let updated = { toolsSource, uiSource };
+    for (const name of tools) {
+      const mainItem = resolution.items.find((item) => item.name === name);
+      const shouldInject = mainItem?.files.some((file2) => file2.type === "tool" || file2.type === "renderer") ?? false;
+      if (!shouldInject)
+        continue;
+      updated = injectTool({
+        toolsSource: updated.toolsSource,
+        uiSource: updated.uiSource,
+        name,
+        toolsAlias
+      });
+    }
+    await fs5.mkdir(path7.dirname(toolsIndexPath), { recursive: true });
+    await fs5.writeFile(toolsIndexPath, updated.toolsSource, "utf8");
+    await fs5.writeFile(uiIndexPath, updated.uiSource, "utf8");
+    injectSpinner.succeed("Updated tool registry index");
+  } catch (err) {
+    injectSpinner.fail("Failed to update tool registry index");
+    throw err;
+  }
+}
+
+// src/commands/add.ts
 var add = new Command().name("add").description("add a tool to an existing ChatJS project").argument("[tools...]", "tool names to add (e.g. word-count)").option("-y, --yes", "skip confirmation prompt", false).option("-o, --overwrite", "overwrite existing files without prompting", false).option("-c, --cwd <cwd>", "the working directory (defaults to current directory)", process.cwd()).option("-r, --registry <url>", "registry URL or local path template (e.g. ./packages/registry/items/{name}.json)").action(async (tools, opts) => {
   try {
-    const cwd = path6.resolve(opts.cwd);
+    const cwd = path8.resolve(opts.cwd);
     if (tools.length === 0) {
       O2.error("Please specify one or more tool names, e.g. chatjs add word-count");
       process.exit(1);
     }
     try {
-      await fs4.stat(path6.join(cwd, "chat.config.ts"));
+      await fs6.stat(path8.join(cwd, "chat.config.ts"));
     } catch {
       O2.error("No chat.config.ts found. Run `chat-js create` first or specify --cwd.");
       process.exit(1);
@@ -20614,129 +20789,29 @@ var add = new Command().name("add").description("add a tool to an existing ChatJ
       throw err;
     }
     const toolsDir = resolveToolsPath(config2.paths.tools, cwd);
-    const toolsIndexPath = path6.join(toolsDir, "tools.ts");
-    const uiIndexPath = path6.join(toolsDir, "ui.ts");
     if (!opts.yes) {
       const answer = await ot2({
-        message: `Install ${tools.join(", ")} into ${path6.relative(process.cwd(), toolsDir)}/?`
+        message: `Install ${tools.join(", ")} into ${path8.relative(process.cwd(), toolsDir)}/?`
       });
       if (q(answer) || !answer) {
         gt("Cancelled.");
         process.exit(0);
       }
     }
-    const processedItems = new Set;
-    for (const name of tools) {
-      O2.step(`Installing ${name}`);
-      const fetchSpinner = spinner(`Fetching ${name}...`);
-      fetchSpinner.start();
-      let resolution;
-      try {
-        resolution = await resolveRegistryItems([name], opts.registry);
-        fetchSpinner.succeed(`Fetched ${name}`);
-      } catch (err) {
-        fetchSpinner.fail(`Failed to fetch ${name}`);
-        throw err;
-      }
-      const itemsToInstall = resolution.items.filter((item) => {
-        if (processedItems.has(item.name)) {
-          return false;
-        }
-        processedItems.add(item.name);
-        return true;
-      });
-      const filesToWrite = itemsToInstall.flatMap((item) => item.files);
-      const dependencies = Array.from(new Set(itemsToInstall.flatMap((item) => item.dependencies ?? [])));
-      const devDependencies = Array.from(new Set(itemsToInstall.flatMap((item) => item.devDependencies ?? [])));
-      const requiredEnvRequirements = itemsToInstall.flatMap((item) => (item.envRequirements ?? []).map((requirement) => ({
-        tool: item.name,
-        requirement: formatRequirementDescription(requirement)
-      })));
-      const mainItem = resolution.items.find((item) => item.name === name);
-      const overwrite = opts.overwrite;
-      try {
-        const writeSpinner = spinner("Writing files...");
-        writeSpinner.start();
-        const { written, existing } = await writeToolFiles(filesToWrite, {
-          overwrite,
-          toolsDir,
-          toolsAlias: config2.paths.tools
+    await installRegistryTools({
+      tools,
+      cwd,
+      toolsDir,
+      toolsAlias: config2.paths.tools,
+      overwrite: opts.overwrite,
+      registryUrl: opts.registry,
+      confirmOverwrite: async (existingFiles) => {
+        const answer = await ot2({
+          message: `${existingFiles.map((file2) => path8.relative(cwd, file2)).join(", ")} already exist. Overwrite?`
         });
-        writeSpinner.stop();
-        if (existing.length > 0 && !overwrite) {
-          const answer = await ot2({
-            message: `${existing.map((f) => path6.relative(cwd, f)).join(", ")} already exist. Overwrite?`
-          });
-          if (q(answer) || !answer) {
-            O2.warn(`Kept existing files for ${name}; installed remaining new files`);
-          } else {
-            const { written: rest } = await writeToolFiles(filesToWrite, {
-              overwrite: true,
-              toolsDir,
-              toolsAlias: config2.paths.tools
-            });
-            written.push(...rest);
-          }
-        }
-        if (written.length > 0) {
-          O2.step(written.map((f) => path6.relative(cwd, f)).join(", "));
-        } else {
-          O2.step(`No file changes needed for ${name}`);
-        }
-      } catch (err) {
-        O2.error("Failed to write files");
-        throw err;
+        return !(q(answer) || !answer);
       }
-      if (dependencies.length > 0 || devDependencies.length > 0) {
-        const depsSpinner = spinner("Installing dependencies...");
-        depsSpinner.start();
-        try {
-          await installDependencies(dependencies, devDependencies, cwd);
-          const installed = [
-            ...dependencies,
-            ...devDependencies.map((dep) => `${dep} (dev)`)
-          ];
-          depsSpinner.succeed(`Installed: ${installed.join(", ")}`);
-        } catch (err) {
-          depsSpinner.fail("Failed to install dependencies");
-          throw err;
-        }
-      }
-      if (requiredEnvRequirements.length > 0) {
-        const details = requiredEnvRequirements.map(({ tool, requirement }) => `${tool}: ${requirement}`).join(", ");
-        O2.warn(`Required env vars for installed tools: ${details}`);
-      }
-      const injectSpinner = spinner("Updating tool registry index...");
-      injectSpinner.start();
-      try {
-        let toolsSource;
-        let uiSource;
-        try {
-          toolsSource = await fs4.readFile(toolsIndexPath, "utf8");
-        } catch {
-          toolsSource = createEmptyToolsTemplate();
-        }
-        try {
-          uiSource = await fs4.readFile(uiIndexPath, "utf8");
-        } catch {
-          uiSource = createEmptyUiTemplate();
-        }
-        const shouldInject = mainItem?.files.some((file2) => file2.type === "tool" || file2.type === "renderer") ?? false;
-        const updated = shouldInject ? injectTool({
-          toolsSource,
-          uiSource,
-          name,
-          toolsAlias: config2.paths.tools
-        }) : { toolsSource, uiSource };
-        await fs4.mkdir(path6.dirname(toolsIndexPath), { recursive: true });
-        await fs4.writeFile(toolsIndexPath, updated.toolsSource, "utf8");
-        await fs4.writeFile(uiIndexPath, updated.uiSource, "utf8");
-        injectSpinner.succeed("Updated tool registry index");
-      } catch (err) {
-        injectSpinner.fail("Failed to update tool registry index");
-        throw err;
-      }
-    }
+    });
     gt(`Done! ${tools.length === 1 ? `"${tools[0]}"` : `${tools.length} tools`} installed successfully.`);
   } catch (error48) {
     handleError(error48);
@@ -20745,7 +20820,7 @@ var add = new Command().name("add").description("add a tool to an existing ChatJ
 
 // src/commands/config.ts
 import { spawn as spawn3 } from "node:child_process";
-import path7 from "node:path";
+import path9 from "node:path";
 var EVAL_SCRIPT2 = `
 import userConfig from "./chat.config.ts";
 import { applyDefaults } from "./lib/config-schema";
@@ -20765,7 +20840,7 @@ function getTsEvalCommand2(pm) {
 }
 var config2 = new Command().name("config").description("print the resolved configuration for the current ChatJS project").option("-c, --cwd <cwd>", "the working directory (defaults to current directory)", process.cwd()).action(async (opts) => {
   try {
-    const cwd = path7.resolve(opts.cwd);
+    const cwd = path9.resolve(opts.cwd);
     const pm = inferPackageManager();
     const [cmd, args] = getTsEvalCommand2(pm);
     await new Promise((resolve, reject) => {
@@ -20812,6 +20887,16 @@ var DESCRIPTIONS = new Map([
     "authentication.vercel",
     "Vercel OAuth (requires VERCEL_APP_CLIENT_ID + VERCEL_APP_CLIENT_SECRET)"
   ],
+  ["ai.tools.mcp.enabled", "Requires MCP_ENCRYPTION_KEY"],
+  ["ai.tools.documents.enabled", "Document create/edit/review support"],
+  ["ai.tools.webSearch.enabled", "Requires TAVILY_API_KEY or FIRECRAWL_API_KEY"],
+  ["ai.tools.urlRetrieval.enabled", "Requires FIRECRAWL_API_KEY"],
+  [
+    "ai.tools.codeExecution.enabled",
+    "Requires Vercel sandbox credentials outside Vercel"
+  ],
+  ["ai.tools.image.enabled", "Requires BLOB_READ_WRITE_TOKEN"],
+  ["ai.tools.deepResearch.enabled", "Requires web search access"],
   [
     "paths.tools",
     "Import alias for the installable tools registry index and tool files"
@@ -20853,14 +20938,14 @@ ${spaces}}`;
 function generateConfig(obj, indent, pathPrefix) {
   const spaces = "  ".repeat(indent);
   return Object.entries(obj).map(([key, value]) => {
-    const path8 = pathPrefix ? `${pathPrefix}.${key}` : key;
-    const desc = DESCRIPTIONS.get(path8);
+    const path10 = pathPrefix ? `${pathPrefix}.${key}` : key;
+    const desc = DESCRIPTIONS.get(path10);
     const comment = desc ? ` // ${desc}` : "";
     if (typeof value === "object" && value !== null && !Array.isArray(value)) {
-      const nested = generateConfig(value, indent + 1, path8);
+      const nested = generateConfig(value, indent + 1, path10);
       return `${spaces}${formatKey(key)}: {
 ${nested}
-${spaces}},`;
+${spaces}},${comment}`;
     }
     return `${spaces}${formatKey(key)}: ${formatValue(value, indent)},${comment}`;
   }).join(`
@@ -20884,7 +20969,10 @@ function buildConfigTs(input) {
       aiProviders: ["OpenAI", "Anthropic", "Google"],
       paymentProcessors: []
     },
-    features: input.features,
+    features: {
+      attachments: input.coreFeatures.attachments,
+      parallelResponses: input.coreFeatures.parallelResponses
+    },
     legal: {
       minimumAge: 13,
       governingLaw: "United States",
@@ -20898,7 +20986,39 @@ function buildConfigTs(input) {
     desktopApp: {
       enabled: input.withElectron
     },
-    ai: { gateway: input.gateway },
+    ai: {
+      gateway: input.gateway,
+      tools: {
+        mcp: {
+          enabled: input.coreFeatures.mcp
+        },
+        followupSuggestions: {
+          enabled: input.coreFeatures.followupSuggestions
+        },
+        documents: {
+          enabled: input.coreFeatures.documents,
+          types: input.documentTypes
+        },
+        webSearch: {
+          enabled: input.builtInTools.webSearch
+        },
+        urlRetrieval: {
+          enabled: input.builtInTools.urlRetrieval
+        },
+        deepResearch: {
+          enabled: input.builtInTools.deepResearch
+        },
+        codeExecution: {
+          enabled: input.builtInTools.codeExecution
+        },
+        image: {
+          enabled: input.builtInTools.imageGeneration
+        },
+        video: {
+          enabled: input.builtInTools.videoGeneration
+        }
+      }
+    },
     paths: {
       tools: "@/tools/chatjs"
     },
@@ -20973,7 +21093,17 @@ var gatewayEnvRequirements = {
     description: "OPENAI_COMPATIBLE_BASE_URL + OPENAI_COMPATIBLE_API_KEY"
   }
 };
-var featureEnvRequirements = {
+var coreFeatureEnvRequirements = {
+  mcp: {
+    options: [["MCP_ENCRYPTION_KEY"]],
+    description: "MCP_ENCRYPTION_KEY"
+  },
+  attachments: {
+    options: [["BLOB_READ_WRITE_TOKEN"]],
+    description: "BLOB_READ_WRITE_TOKEN"
+  }
+};
+var builtInToolEnvRequirements = {
   webSearch: {
     options: [["TAVILY_API_KEY"], ["FIRECRAWL_API_KEY"]],
     description: "TAVILY_API_KEY or FIRECRAWL_API_KEY"
@@ -20986,24 +21116,20 @@ var featureEnvRequirements = {
     options: [["TAVILY_API_KEY"], ["FIRECRAWL_API_KEY"]],
     description: "TAVILY_API_KEY or FIRECRAWL_API_KEY"
   },
-  mcp: {
-    options: [["MCP_ENCRYPTION_KEY"]],
-    description: "MCP_ENCRYPTION_KEY"
+  codeExecution: {
+    options: [
+      ["VERCEL_OIDC_TOKEN"],
+      ["VERCEL_TEAM_ID", "VERCEL_PROJECT_ID", "VERCEL_TOKEN"]
+    ],
+    description: "VERCEL_OIDC_TOKEN or VERCEL_TEAM_ID + VERCEL_PROJECT_ID + VERCEL_TOKEN"
   },
   imageGeneration: {
     options: [["BLOB_READ_WRITE_TOKEN"]],
     description: "BLOB_READ_WRITE_TOKEN"
   },
-  attachments: {
+  videoGeneration: {
     options: [["BLOB_READ_WRITE_TOKEN"]],
     description: "BLOB_READ_WRITE_TOKEN"
-  },
-  sandbox: {
-    options: [
-      ["VERCEL_OIDC_TOKEN"],
-      ["VERCEL_TEAM_ID", "VERCEL_PROJECT_ID", "VERCEL_TOKEN"]
-    ],
-    description: "VERCEL_OIDC_TOKEN or VERCEL_TEAM_ID + VERCEL_PROJECT_ID + VERCEL_TOKEN"
   }
 };
 var authEnvRequirements = {
@@ -21052,16 +21178,21 @@ var GATEWAYS = [
   "openai-compatible"
 ];
 var AUTH_PROVIDERS = ["google", "github", "vercel"];
-var FEATURE_KEYS = [
-  "sandbox",
+var CORE_FEATURE_KEYS = [
+  "attachments",
+  "parallelResponses",
+  "documents",
+  "mcp",
+  "followupSuggestions"
+];
+var DOCUMENT_TYPE_KEYS = ["text", "code", "sheet"];
+var BUILT_IN_TOOL_KEYS = [
   "webSearch",
   "urlRetrieval",
   "deepResearch",
-  "mcp",
+  "codeExecution",
   "imageGeneration",
-  "attachments",
-  "followupSuggestions",
-  "parallelResponses"
+  "videoGeneration"
 ];
 
 // src/helpers/env-checklist.ts
@@ -21095,10 +21226,21 @@ function collectEnvChecklist(input) {
   entries.push(...gwEntries);
   const featureItems = [];
   const seen = new Set;
-  for (const feature of FEATURE_KEYS) {
-    if (!input.features[feature])
+  for (const feature of CORE_FEATURE_KEYS) {
+    if (!input.coreFeatures[feature])
+      continue;
+    const requirement = coreFeatureEnvRequirements[feature];
+    if (!requirement)
+      continue;
+    if (seen.has(requirement.description))
       continue;
-    const requirement = featureEnvRequirements[feature];
+    seen.add(requirement.description);
+    featureItems.push(...requirementToEntries(requirement));
+  }
+  for (const tool of BUILT_IN_TOOL_KEYS) {
+    if (!input.builtInTools[tool])
+      continue;
+    const requirement = builtInToolEnvRequirements[tool];
     if (!requirement)
       continue;
     if (seen.has(requirement.description))
@@ -21118,32 +21260,63 @@ function collectEnvChecklist(input) {
 }
 
 // src/helpers/prompts.ts
-var FEATURE_DEFAULTS = {
-  sandbox: false,
+var CORE_FEATURE_DEFAULTS = {
+  attachments: false,
+  parallelResponses: true,
+  documents: true,
+  mcp: false,
+  followupSuggestions: true
+};
+var DOCUMENT_TYPE_DEFAULTS = {
+  text: true,
+  code: true,
+  sheet: true
+};
+var BUILT_IN_TOOL_DEFAULTS = {
   webSearch: false,
   urlRetrieval: false,
   deepResearch: false,
-  mcp: false,
+  codeExecution: false,
   imageGeneration: false,
-  attachments: false,
-  followupSuggestions: true,
-  parallelResponses: true
+  videoGeneration: false
 };
 var AUTH_DEFAULTS = {
   google: false,
   github: true,
   vercel: false
 };
-var FEATURE_LABELS = {
-  sandbox: "Code Sandbox",
+var CORE_FEATURE_LABELS = {
+  attachments: "Attachments",
+  parallelResponses: "Parallel Responses",
+  documents: "Documents",
+  mcp: "MCP Tool Servers",
+  followupSuggestions: "Follow-up Suggestions"
+};
+var DOCUMENT_TYPE_LABELS = {
+  text: "Text Documents",
+  code: "Code Documents",
+  sheet: "Spreadsheet Documents"
+};
+var DOCUMENT_TYPE_HINTS = {
+  text: "Notes, guides, markdown, and long-form writing",
+  code: "Code files and snippets",
+  sheet: "CSV-based tables and structured data"
+};
+var BUILT_IN_TOOL_LABELS = {
   webSearch: "Web Search",
   urlRetrieval: "URL Retrieval",
   deepResearch: "Deep Research",
-  mcp: "MCP Tool Servers",
+  codeExecution: "Code Sandbox",
   imageGeneration: "Image Generation",
-  attachments: "File Attachments",
-  followupSuggestions: "Follow-up Suggestions",
-  parallelResponses: "Parallel Responses"
+  videoGeneration: "Video Generation"
+};
+var BUILT_IN_TOOL_HINTS = {
+  webSearch: "Search the web from chat",
+  urlRetrieval: "Fetch structured content from a specific URL",
+  deepResearch: "Run multi-step web research and generate reports",
+  codeExecution: "Execute code in a sandboxed environment",
+  imageGeneration: "Generate images inside chat",
+  videoGeneration: "Generate videos inside chat"
 };
 var AUTH_LABELS = {
   google: "Google OAuth",
@@ -21159,9 +21332,13 @@ function handleCancel(value) {
 function toKebabCase(value) {
   return (value ?? "").trim().toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
 }
+function toSelectionRecord(keys, selected) {
+  return Object.fromEntries(keys.map((key) => [key, selected.includes(key)]));
+}
 async function promptProjectName(targetArg, skipPrompt) {
-  if (skipPrompt)
+  if (skipPrompt) {
     return toKebabCase(targetArg ?? "my-chat-app") || "my-chat-app";
+  }
   const name = await Ot({
     message: "What is your project named?",
     initialValue: targetArg ?? "my-chat-app",
@@ -21189,32 +21366,76 @@ async function promptGateway(skipPrompt) {
   handleCancel(gateway);
   return gateway;
 }
-async function promptFeatures(skipPrompt) {
+async function promptCoreFeatures(skipPrompt) {
   if (skipPrompt)
-    return { ...FEATURE_DEFAULTS };
-  const defaultFeatures = FEATURE_KEYS.filter((key) => FEATURE_DEFAULTS[key]);
-  const selectedFeatures = await yt({
-    message: `Which ${highlighter.info("features")} would you like to enable? ${highlighter.dim("(space to toggle, enter to submit)")}`,
-    options: FEATURE_KEYS.map((key) => ({
+    return { ...CORE_FEATURE_DEFAULTS };
+  const selected = await yt({
+    message: `Which ${highlighter.info("core features")} would you like to enable? ${highlighter.dim("(space to toggle, enter to submit)")}`,
+    options: CORE_FEATURE_KEYS.map((key) => ({
       value: key,
-      label: FEATURE_LABELS[key],
-      hint: featureEnvRequirements[key]?.description
+      label: CORE_FEATURE_LABELS[key],
+      hint: key === "documents" ? "Create, edit, and review documents in chat" : coreFeatureEnvRequirements[key]?.description
     })),
-    initialValues: defaultFeatures,
+    initialValues: CORE_FEATURE_KEYS.filter((key) => CORE_FEATURE_DEFAULTS[key]),
     required: false
   });
-  handleCancel(selectedFeatures);
-  const features = { ...FEATURE_DEFAULTS };
-  for (const key of FEATURE_KEYS) {
-    features[key] = false;
+  handleCancel(selected);
+  return toSelectionRecord(CORE_FEATURE_KEYS, selected);
+}
+async function promptDocumentTypes(skipPrompt, documentsEnabled) {
+  if (!documentsEnabled) {
+    return toSelectionRecord(DOCUMENT_TYPE_KEYS, []);
   }
-  for (const key of selectedFeatures) {
-    features[key] = true;
+  if (skipPrompt)
+    return { ...DOCUMENT_TYPE_DEFAULTS };
+  const selected = await yt({
+    message: `Which ${highlighter.info("document types")} would you like to enable? ${highlighter.dim("(space to toggle, enter to submit)")}`,
+    options: DOCUMENT_TYPE_KEYS.map((key) => ({
+      value: key,
+      label: DOCUMENT_TYPE_LABELS[key],
+      hint: DOCUMENT_TYPE_HINTS[key]
+    })),
+    initialValues: DOCUMENT_TYPE_KEYS.filter((key) => DOCUMENT_TYPE_DEFAULTS[key]),
+    required: false
+  });
+  handleCancel(selected);
+  return toSelectionRecord(DOCUMENT_TYPE_KEYS, selected);
+}
+async function promptAssistantTools(registryItems, skipPrompt) {
+  const installableItems = registryItems.filter((item) => !item.hidden);
+  if (skipPrompt) {
+    return {
+      builtInTools: { ...BUILT_IN_TOOL_DEFAULTS },
+      installableTools: []
+    };
   }
-  if (features.deepResearch) {
-    features.webSearch = true;
+  const selected = await yt({
+    message: `Which ${highlighter.info("assistant tools")} would you like to enable? ${highlighter.dim("(space to toggle, enter to submit)")}`,
+    options: [
+      ...BUILT_IN_TOOL_KEYS.map((key) => ({
+        value: key,
+        label: BUILT_IN_TOOL_LABELS[key],
+        hint: builtInToolEnvRequirements[key]?.description ?? BUILT_IN_TOOL_HINTS[key]
+      })),
+      ...installableItems.map((item) => ({
+        value: item.name,
+        label: item.name,
+        hint: item.description
+      }))
+    ],
+    initialValues: BUILT_IN_TOOL_KEYS.filter((key) => BUILT_IN_TOOL_DEFAULTS[key]),
+    required: false
+  });
+  handleCancel(selected);
+  const selectedValues = selected;
+  const builtInTools = toSelectionRecord(BUILT_IN_TOOL_KEYS, selectedValues.filter((value) => BUILT_IN_TOOL_KEYS.includes(value)));
+  if (builtInTools.deepResearch) {
+    builtInTools.webSearch = true;
   }
-  return features;
+  return {
+    builtInTools,
+    installableTools: selectedValues.filter((value) => !BUILT_IN_TOOL_KEYS.includes(value))
+  };
 }
 async function promptAuth(skipPrompt) {
   if (skipPrompt)
@@ -21238,15 +21459,7 @@ async function promptAuth(skipPrompt) {
       logger.warn("At least one auth provider is required. Please select one.");
     }
   }
-  const auth = {
-    google: false,
-    github: false,
-    vercel: false
-  };
-  for (const p2 of selectedProviders) {
-    auth[p2] = true;
-  }
-  return auth;
+  return toSelectionRecord(AUTH_PROVIDERS, selectedProviders);
 }
 async function promptElectron(skipPrompt, explicitChoice) {
   if (typeof explicitChoice === "boolean") {
@@ -21527,7 +21740,7 @@ async function applyElectronTemplateSourceTransforms(destination) {
   await replaceInFile(tsconfigPath, [['"../chat/*"', '"../*"']]);
   const packageJsonPath = join(destination, "package.json");
   await replaceInFile(packageJsonPath, [
-    ['"name": "@chatjs/electron"', '"name": "__PROJECT_NAME__-electron"'],
+    ['"name": "@chat-js/electron"', '"name": "__PROJECT_NAME__-electron"'],
     [
       '"url": "https://github.com/FranciscoMoretti/chat-js.git"',
       '"url": "https://github.com/__GITHUB_OWNER__/__GITHUB_REPO__.git"'
@@ -21720,9 +21933,10 @@ var createOptionsSchema = exports_external.object({
   install: exports_external.boolean(),
   electron: exports_external.boolean().optional(),
   fromGit: exports_external.string().optional(),
+  registry: exports_external.string().optional(),
   packageManager: exports_external.enum(["bun", "npm", "pnpm", "yarn"]).optional()
 });
-var create = new Command().name("create").description("scaffold a new ChatJS chat application").argument("[directory]", "target directory for the project").option("-y, --yes", "skip prompts and use defaults", false).option("--no-install", "skip dependency installation").option("--electron", "include the Electron desktop app").option("--no-electron", "do not include the Electron desktop app").option("--package-manager <manager>", "package manager for install + next steps (bun, npm, pnpm, yarn)").option("--from-git <url>", "clone from a git repository instead of the built-in scaffold").action(async (directory, opts) => {
+var create = new Command().name("create").description("scaffold a new ChatJS chat application").argument("[directory]", "target directory for the project").option("-y, --yes", "skip prompts and use defaults", false).option("--no-install", "skip dependency installation").option("--electron", "include the Electron desktop app").option("--no-electron", "do not include the Electron desktop app").option("-r, --registry <url>", "registry URL or local path template (e.g. ./packages/registry/items/{name}.json)").option("--package-manager <manager>", "package manager for install + next steps (bun, npm, pnpm, yarn)").option("--from-git <url>", "clone from a git repository instead of the built-in scaffold").action(async (directory, opts) => {
   try {
     const options = createOptionsSchema.parse({
       target: directory,
@@ -21733,16 +21947,29 @@ var create = new Command().name("create").description("scaffold a new ChatJS cha
       mt("Create ChatJS App");
     }
     const initialTarget = resolveCreateTarget(options.target);
-    const promptedProjectName = await promptProjectName(initialTarget.projectName, options.yes);
-    const projectName = promptedProjectName;
+    const projectName = await promptProjectName(initialTarget.projectName, options.yes);
     const targetDir = options.target ? initialTarget.targetDir : resolve2(process.cwd(), projectName);
     const displayPath = options.target ? initialTarget.displayPath : projectName;
     await ensureTargetEmpty(targetDir);
-    const appName = projectName.split("-").map((w3) => w3.charAt(0).toUpperCase() + w3.slice(1)).join(" ");
+    const appName = projectName.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
     const appPrefix = projectName;
     const appUrl = "http://localhost:3000";
     const gateway = await promptGateway(options.yes);
-    const features = await promptFeatures(options.yes);
+    const coreFeatures = await promptCoreFeatures(options.yes);
+    const documentTypes = await promptDocumentTypes(options.yes, coreFeatures.documents);
+    let registryItems = [];
+    if (!options.yes) {
+      const registrySpinner = spinner("Loading installable tools...");
+      registrySpinner.start();
+      try {
+        registryItems = await fetchRegistryIndex(options.registry);
+        registrySpinner.succeed("Installable tools loaded.");
+      } catch (error48) {
+        registrySpinner.fail("Could not load installable tools.");
+        logger.warn(error48 instanceof Error ? error48.message : "Continuing with built-in tools only.");
+      }
+    }
+    const assistantTools = await promptAssistantTools(registryItems, options.yes);
     const auth = await promptAuth(options.yes);
     const withElectron = await promptElectron(options.yes, options.electron);
     logger.break();
@@ -21777,7 +22004,9 @@ var create = new Command().name("create").description("scaffold a new ChatJS cha
         appUrl,
         withElectron,
         gateway,
-        features,
+        coreFeatures,
+        documentTypes,
+        builtInTools: assistantTools.builtInTools,
         auth
       });
       await writeFile2(join2(targetDir, "chat.config.ts"), configSource);
@@ -21787,6 +22016,18 @@ var create = new Command().name("create").description("scaffold a new ChatJS cha
       throw error48;
     }
     const installNow = !options.install ? false : await promptInstall(packageManager, options.yes);
+    if (assistantTools.installableTools.length > 0) {
+      const toolsDir = resolveToolsPath("@/tools/chatjs", targetDir);
+      await installRegistryTools({
+        tools: assistantTools.installableTools,
+        cwd: targetDir,
+        toolsDir,
+        toolsAlias: "@/tools/chatjs",
+        registryUrl: options.registry,
+        installDependenciesNow: false,
+        packageManager
+      });
+    }
     if (installNow) {
       const installSpinner = spinner(`Installing dependencies with ${highlighter.info(packageManager)}...`).start();
       try {
@@ -21797,7 +22038,12 @@ var create = new Command().name("create").description("scaffold a new ChatJS cha
         throw error48;
       }
     }
-    const envEntries = collectEnvChecklist({ gateway, features, auth });
+    const envEntries = collectEnvChecklist({
+      gateway,
+      coreFeatures,
+      builtInTools: assistantTools.builtInTools,
+      auth
+    });
     gt("Your ChatJS app is ready!");
     logger.info("Next steps:");
     logger.break();