@kitnai/cli 0.1.31 → 0.1.33

package/dist/index.js

@@ -163,8 +163,8 @@ import { z } from "zod";
 function getRegistryUrl(entry) {
   return typeof entry === "string" ? entry : entry.url;
 }
-function resolveRoutesAlias(config) {
-  const fw = config.framework ?? "hono";
+function resolveRoutesAlias(config2) {
+  const fw = config2.framework ?? "hono";
   return FRAMEWORK_TO_ADAPTER[fw] ?? fw;
 }
 async function readConfig(projectDir) {
@@ -175,8 +175,8 @@ async function readConfig(projectDir) {
     return null;
   }
 }
-async function writeConfig(projectDir, config) {
-  const data = { $schema: "https://kitn.dev/schema/config.json", ...config };
+async function writeConfig(projectDir, config2) {
+  const data = { $schema: "https://kitn.dev/schema/config.json", ...config2 };
   await writeFile2(join3(projectDir, CONFIG_FILE), JSON.stringify(data, null, 2) + "\n");
 }
 async function readLock(projectDir) {
@@ -197,17 +197,17 @@ async function writeLock(projectDir, lock) {
   }
   await writeFile2(join3(projectDir, LOCK_FILE), JSON.stringify(lock, null, 2) + "\n");
 }
-function getInstallPath(config, type, fileName, namespace) {
+function getInstallPath(config2, type, fileName, namespace) {
   const aliasKey = typeToAliasKey[type];
-  const baseAlias = config.aliases.base ?? "src/ai";
-  const base = config.aliases[aliasKey] ?? join3(baseAlias, aliasKey);
+  const baseAlias = config2.aliases.base ?? "src/ai";
+  const base = config2.aliases[aliasKey] ?? join3(baseAlias, aliasKey);
   if (namespace && namespace !== "@kitn") {
     const nsDir = namespace.replace("@", "");
     return join3(base, nsDir, fileName);
   }
   return join3(base, fileName);
 }
-var componentType, installedComponentSchema, registryEntrySchema, registryValueSchema, configSchema, FRAMEWORK_TO_ADAPTER, CONFIG_FILE, LOCK_FILE, lockSchema, typeToAliasKey;
+var componentType, installedComponentSchema, registryEntrySchema, registryValueSchema, DEFAULT_REGISTRY_URL, DEFAULT_REGISTRIES, DEFAULT_ALIASES, configSchema, FRAMEWORK_TO_ADAPTER, CONFIG_FILE, LOCK_FILE, lockSchema, typeToAliasKey;
 var init_config = __esm({
   "src/utils/config.ts"() {
     "use strict";
@@ -228,6 +228,22 @@ var init_config = __esm({
       description: z.string().optional()
     });
     registryValueSchema = z.union([z.string(), registryEntrySchema]);
+    DEFAULT_REGISTRY_URL = "https://kitn-ai.github.io/kitn/r/{type}/{name}.json";
+    DEFAULT_REGISTRIES = {
+      "@kitn": {
+        url: DEFAULT_REGISTRY_URL,
+        homepage: "https://kitn.ai",
+        description: "Official kitn AI agent components"
+      }
+    };
+    DEFAULT_ALIASES = {
+      base: "src/ai",
+      agents: "src/ai/agents",
+      tools: "src/ai/tools",
+      skills: "src/ai/skills",
+      storage: "src/ai/storage",
+      crons: "src/ai/crons"
+    };
     configSchema = z.object({
       $schema: z.string().optional(),
       runtime: z.enum(["bun", "node", "deno"]),
@@ -241,7 +257,9 @@ var init_config = __esm({
         crons: z.string().optional()
       }),
       registries: z.record(z.string(), registryValueSchema),
-      aiTools: z.array(z.string()).optional()
+      chatService: z.object({
+        url: z.string().optional()
+      }).optional()
     });
     FRAMEWORK_TO_ADAPTER = {
       hono: "hono",
@@ -268,38 +286,38 @@ function stripJsonc(text3) {
   return text3.replace(/\/\/.*$/gm, "").replace(/\/\*[\s\S]*?\*\//g, "").replace(/,\s*([}\]])/g, "$1");
 }
 function patchTsconfig(tsconfigContent, paths, removePrefixes) {
-  const config = JSON.parse(stripJsonc(tsconfigContent));
-  if (!config.compilerOptions) {
-    config.compilerOptions = {};
+  const config2 = JSON.parse(stripJsonc(tsconfigContent));
+  if (!config2.compilerOptions) {
+    config2.compilerOptions = {};
   }
-  if (!config.compilerOptions.paths) {
-    config.compilerOptions.paths = {};
+  if (!config2.compilerOptions.paths) {
+    config2.compilerOptions.paths = {};
   }
   if (removePrefixes) {
-    for (const key of Object.keys(config.compilerOptions.paths)) {
+    for (const key of Object.keys(config2.compilerOptions.paths)) {
       if (removePrefixes.some((prefix) => key.startsWith(prefix))) {
-        delete config.compilerOptions.paths[key];
+        delete config2.compilerOptions.paths[key];
       }
     }
   }
   for (const [key, value] of Object.entries(paths)) {
-    config.compilerOptions.paths[key] = value;
+    config2.compilerOptions.paths[key] = value;
   }
   const ES_TARGETS = ["es3", "es5", "es6", "es2015", "es2016", "es2017", "es2018", "es2019", "es2020", "es2021"];
-  const currentTarget = (config.compilerOptions.target ?? "").toLowerCase();
+  const currentTarget = (config2.compilerOptions.target ?? "").toLowerCase();
   if (!currentTarget || ES_TARGETS.includes(currentTarget)) {
-    config.compilerOptions.target = "ES2022";
+    config2.compilerOptions.target = "ES2022";
   }
-  if (!config.compilerOptions.moduleResolution) {
-    config.compilerOptions.moduleResolution = "bundler";
+  if (!config2.compilerOptions.moduleResolution) {
+    config2.compilerOptions.moduleResolution = "bundler";
   }
-  if (!config.compilerOptions.module) {
-    config.compilerOptions.module = "ESNext";
+  if (!config2.compilerOptions.module) {
+    config2.compilerOptions.module = "ESNext";
   }
-  if (config.compilerOptions.skipLibCheck === void 0) {
-    config.compilerOptions.skipLibCheck = true;
+  if (config2.compilerOptions.skipLibCheck === void 0) {
+    config2.compilerOptions.skipLibCheck = true;
   }
-  return JSON.stringify(config, null, 2) + "\n";
+  return JSON.stringify(config2, null, 2) + "\n";
 }
 async function patchProjectTsconfig(projectDir, paths, removePrefixes) {
   const tsconfigPath = join4(projectDir, "tsconfig.json");
@@ -581,8 +599,8 @@ async function handleEnvVars(cwd, envVars) {
     const lines = [];
     if (exampleContent && !exampleContent.endsWith("\n")) lines.push("");
     for (const key of missingFromExample) {
-      const config = envVars[key];
-      lines.push(`# ${config.description}${config.url ? ` (${config.url})` : ""}`);
+      const config2 = envVars[key];
+      lines.push(`# ${config2.description}${config2.url ? ` (${config2.url})` : ""}`);
       lines.push(`${key}=`);
     }
     await writeFile5(examplePath, exampleContent + lines.join("\n") + "\n");
@@ -594,9 +612,9 @@ async function handleEnvVars(cwd, envVars) {
     `${missingFromEnv.length} environment variable(s) needed:`
   );
   for (const key of missingFromEnv) {
-    const config = envVars[key];
-    const req = config.required !== false ? pc2.red("*") : "";
-    p.log.message(`  ${pc2.yellow(key)}${req}: ${config.description}${config.url ? pc2.dim(` -> ${config.url}`) : ""}`);
+    const config2 = envVars[key];
+    const req = config2.required !== false ? pc2.red("*") : "";
+    p.log.message(`  ${pc2.yellow(key)}${req}: ${config2.description}${config2.url ? pc2.dim(` -> ${config2.url}`) : ""}`);
   }
   const shouldPrompt = await p.confirm({
     message: "Would you like to enter values now?",
@@ -608,8 +626,8 @@ async function handleEnvVars(cwd, envVars) {
   }
   const newEntries = [];
   for (const key of missingFromEnv) {
-    const config = envVars[key];
-    const isSecret = config.secret !== false;
+    const config2 = envVars[key];
+    const isSecret = config2.secret !== false;
     let value;
     if (isSecret) {
       value = await p.password({
@@ -618,7 +636,7 @@ async function handleEnvVars(cwd, envVars) {
     } else {
       value = await p.text({
         message: `${key}:`,
-        placeholder: config.description
+        placeholder: config2.description
       });
     }
     if (p.isCancel(value)) {
@@ -867,18 +885,18 @@ import { relative as relative2 } from "path";
 async function addCommand(components, opts) {
   p2.intro(pc3.bgCyan(pc3.black(" kitn add ")));
   const cwd = process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) {
+  const config2 = await readConfig(cwd);
+  if (!config2) {
     p2.log.error("No kitn.json found. Run `kitn init` first.");
     process.exit(1);
   }
   const lock = await readLock(cwd);
   if (components.length === 0) {
-    const fetcher2 = new RegistryFetcher(config.registries);
+    const fetcher2 = new RegistryFetcher(config2.registries);
     const s2 = p2.spinner();
     s2.start("Fetching registry...");
     const allItems = [];
-    for (const namespace of Object.keys(config.registries)) {
+    for (const namespace of Object.keys(config2.registries)) {
       try {
         const index = await fetcher2.fetchIndex(namespace);
         for (const item of index.items) {
@@ -957,18 +975,18 @@ async function addCommand(components, opts) {
   }
   const resolvedComponents = components.map((c) => {
     if (c === "routes") {
-      return resolveRoutesAlias(config);
+      return resolveRoutesAlias(config2);
     }
     return c;
   });
   const refs = resolvedComponents.map(parseComponentRef);
-  const fetcher = new RegistryFetcher(config.registries);
+  const fetcher = new RegistryFetcher(config2.registries);
   const s = p2.spinner();
   s.start("Resolving dependencies...");
   const preResolvedTypes = /* @__PURE__ */ new Map();
   let expandedNames = [...resolvedComponents];
   try {
-    const namespacesToFetch = Object.keys(config.registries);
+    const namespacesToFetch = Object.keys(config2.registries);
     const allIndexItems = [];
     for (const namespace of namespacesToFetch) {
       try {
@@ -1110,7 +1128,7 @@ async function addCommand(components, opts) {
     }
   }
   if (slotReplacements.size > 0) {
-    const baseDir2 = config.aliases.base ?? "src/ai";
+    const baseDir2 = config2.aliases.base ?? "src/ai";
     for (const [oldKey] of slotReplacements) {
       const oldEntry = lock[oldKey];
       if (!oldEntry) continue;
@@ -1122,9 +1140,9 @@ async function addCommand(components, opts) {
       }
       const barrelPath2 = join7(cwd, baseDir2, "index.ts");
       const barrelEligibleDirs = /* @__PURE__ */ new Set([
-        config.aliases.agents,
-        config.aliases.tools,
-        config.aliases.skills
+        config2.aliases.agents,
+        config2.aliases.tools,
+        config2.aliases.skills
       ]);
       if (existsSync(barrelPath2)) {
         let barrelContent = await readFile6(barrelPath2, "utf-8");
@@ -1188,7 +1206,7 @@ async function addCommand(components, opts) {
       }
     }
     if (item.type === "kitn:package") {
-      const baseDir2 = config.aliases.base ?? "src/ai";
+      const baseDir2 = config2.aliases.base ?? "src/ai";
       for (const file of item.files) {
         const targetPath = join7(cwd, baseDir2, file.path);
         const relativePath = join7(baseDir2, file.path);
@@ -1258,10 +1276,10 @@ async function addCommand(components, opts) {
           }
         })();
         const fileName = file.path.split("/").pop();
-        const installPath = getInstallPath(config, item.type, fileName, ns);
+        const installPath = getInstallPath(config2, item.type, fileName, ns);
         const targetPath = join7(cwd, installPath);
         const relativePath = installPath;
-        const content = rewriteKitnImports(file.content, item.type, fileName, config.aliases);
+        const content = rewriteKitnImports(file.content, item.type, fileName, config2.aliases);
         const status = await checkFileStatus(targetPath, content);
         switch (status) {
           case "new" /* New */:
@@ -1298,7 +1316,7 @@ async function addCommand(components, opts) {
       }
       const allContent = item.files.map((f) => {
         const fn = f.path.split("/").pop();
-        return rewriteKitnImports(f.content, item.type, fn, config.aliases);
+        return rewriteKitnImports(f.content, item.type, fn, config2.aliases);
       }).join("\n");
       const installedKey = ns === "@kitn" ? item.name : `${ns}/${item.name}`;
       lock[installedKey] = {
@@ -1309,7 +1327,7 @@ async function addCommand(components, opts) {
         installedAt: (/* @__PURE__ */ new Date()).toISOString(),
         files: item.files.map((f) => {
           const fileName = f.path.split("/").pop();
-          return getInstallPath(config, item.type, fileName, ns);
+          return getInstallPath(config2, item.type, fileName, ns);
         }),
         hash: contentHash(allContent),
         registryDependencies: item.registryDependencies
@@ -1317,7 +1335,7 @@ async function addCommand(components, opts) {
     }
   }
   const BARREL_ELIGIBLE = /* @__PURE__ */ new Set(["kitn:agent", "kitn:tool", "kitn:skill", "kitn:cron"]);
-  const baseDir = config.aliases.base ?? "src/ai";
+  const baseDir = config2.aliases.base ?? "src/ai";
   const barrelPath = join7(cwd, baseDir, "index.ts");
   const barrelDir = join7(cwd, baseDir);
   const barrelImports = [];
@@ -1326,7 +1344,7 @@ async function addCommand(components, opts) {
     const ref = refs.find((r) => r.name === item.name) ?? { namespace: "@kitn", name: item.name, version: void 0 };
     for (const file of item.files) {
       const fileName = file.path.split("/").pop();
-      const installPath = getInstallPath(config, item.type, fileName, ref.namespace);
+      const installPath = getInstallPath(config2, item.type, fileName, ref.namespace);
       const filePath = join7(cwd, installPath);
       const importPath = "./" + relative2(barrelDir, filePath).replace(/\\/g, "/");
       barrelImports.push(importPath);
@@ -1357,7 +1375,7 @@ async function addCommand(components, opts) {
       );
     }
   }
-  await writeConfig(cwd, config);
+  await writeConfig(cwd, config2);
   await writeLock(cwd, lock);
   if (totalDeps > 0) {
     const pm = await detectPackageManager(cwd);
@@ -1394,7 +1412,7 @@ async function addCommand(components, opts) {
   const resolvedNames = new Set(resolved.map((r) => r.name));
   const projectInstalled = new Set(Object.keys(lock));
   const hints = [];
-  const adapterName = resolveRoutesAlias(config);
+  const adapterName = resolveRoutesAlias(config2);
   if (resolvedNames.has("core") && !resolvedNames.has(adapterName) && !projectInstalled.has(adapterName)) {
     hints.push(`Run ${pc3.cyan(`kitn add routes`)} to install the HTTP adapter.`);
   }
@@ -1470,10 +1488,10 @@ ${content}`;
   }
   return content;
 }
-async function generateRulesFiles(cwd, config, selectedToolIds) {
-  const rulesConfig = await fetchRulesConfig(config.registries);
-  const template = await fetchRulesTemplate(config.registries);
-  const rendered = renderTemplate(template, config.aliases);
+async function generateRulesFiles(cwd, config2, selectedToolIds) {
+  const rulesConfig = await fetchRulesConfig(config2.registries);
+  const template = await fetchRulesTemplate(config2.registries);
+  const rendered = renderTemplate(template, config2.aliases);
   const toolsToWrite = selectedToolIds ? rulesConfig.tools.filter((t) => selectedToolIds.includes(t.id)) : rulesConfig.tools;
   const written = [];
   for (const tool of toolsToWrite) {
@@ -1568,8 +1586,20 @@ __export(init_exports, {
 });
 import * as p3 from "@clack/prompts";
 import pc4 from "picocolors";
-import { mkdir as mkdir5, writeFile as writeFile8 } from "fs/promises";
+import { mkdir as mkdir5, readFile as readFile7, writeFile as writeFile8 } from "fs/promises";
 import { join as join9 } from "path";
+async function detectFramework(cwd) {
+  try {
+    const pkg = JSON.parse(await readFile7(join9(cwd, "package.json"), "utf-8"));
+    const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+    if (deps["elysia"]) return "elysia";
+    if (deps["@hono/zod-openapi"]) return "hono-openapi";
+    if (deps["hono"]) return "hono";
+    return null;
+  } catch {
+    return null;
+  }
+}
 function getPluginTemplate(framework) {
   const adapterName = framework === "hono-openapi" ? "hono-openapi" : framework;
   return `import { createAIPlugin } from "@kitn/adapters/${adapterName}";
@@ -1637,12 +1667,41 @@ async function initCommand(opts = {}) {
   }
   const validFrameworks = ["hono", "hono-openapi", "elysia"];
   let framework;
+  const detected = await detectFramework(cwd);
   if (opts.framework) {
     if (!validFrameworks.includes(opts.framework)) {
       p3.log.error(`Invalid framework: ${opts.framework}. Must be one of: ${validFrameworks.join(", ")}`);
       process.exit(1);
     }
     framework = opts.framework;
+  } else if (detected) {
+    framework = detected;
+    p3.log.info(`Detected ${pc4.bold(detected)} from package.json`);
+    if (!opts.yes) {
+      const confirm6 = await p3.confirm({
+        message: `Use ${detected}?`,
+        initialValue: true
+      });
+      if (p3.isCancel(confirm6)) {
+        p3.cancel("Init cancelled.");
+        process.exit(0);
+      }
+      if (!confirm6) {
+        const selected = await p3.select({
+          message: "Which HTTP framework do you use?",
+          options: [
+            { value: "hono", label: "Hono" },
+            { value: "hono-openapi", label: "Hono + OpenAPI", hint: "zod-openapi routes with /doc endpoint" },
+            { value: "elysia", label: "Elysia", hint: "Bun-native framework" }
+          ]
+        });
+        if (p3.isCancel(selected)) {
+          p3.cancel("Init cancelled.");
+          process.exit(0);
+        }
+        framework = selected;
+      }
+    }
   } else if (opts.yes) {
     framework = "hono";
   } else {
@@ -1677,7 +1736,7 @@ async function initCommand(opts = {}) {
     }
     baseDir = base;
   }
-  const config = {
+  const config2 = {
     runtime,
     framework,
     aliases: {
@@ -1689,7 +1748,7 @@ async function initCommand(opts = {}) {
     },
     registries: {
       "@kitn": {
-        url: "https://kitn-ai.github.io/kitn/r/{type}/{name}.json",
+        url: DEFAULT_REGISTRY_URL,
         homepage: "https://kitn.ai",
         description: "Official kitn AI agent components"
       }
@@ -1697,7 +1756,7 @@ async function initCommand(opts = {}) {
   };
   const s = p3.spinner();
   s.start("Writing kitn.json");
-  await writeConfig(cwd, config);
+  await writeConfig(cwd, config2);
   s.stop("Created kitn.json");
   await patchProjectTsconfig(
     cwd,
@@ -1715,7 +1774,7 @@ async function initCommand(opts = {}) {
   await writeFile8(pluginPath, getPluginTemplate(framework));
   p3.log.success(`Created ${pc4.bold(baseDir + "/plugin.ts")} \u2014 configure your AI provider there`);
   try {
-    const rulesConfig = await fetchRulesConfig(config.registries);
+    const rulesConfig = await fetchRulesConfig(config2.registries);
     let selectedToolIds;
     if (opts.yes) {
       selectedToolIds = rulesConfig.tools.map((t) => t.id);
@@ -1736,9 +1795,7 @@ async function initCommand(opts = {}) {
       }
     }
     if (selectedToolIds.length > 0) {
-      const updatedConfig = { ...config, aiTools: selectedToolIds };
-      await writeConfig(cwd, updatedConfig);
-      const written = await generateRulesFiles(cwd, updatedConfig, selectedToolIds);
+      const written = await generateRulesFiles(cwd, config2, selectedToolIds);
       for (const filePath of written) {
         p3.log.success(`Created ${pc4.bold(filePath)}`);
       }
@@ -1786,8 +1843,8 @@ import * as p4 from "@clack/prompts";
 import pc5 from "picocolors";
 async function listCommand(typeFilter, opts) {
   const cwd = process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) {
+  const config2 = await readConfig(cwd);
+  if (!config2) {
     p4.log.error("No kitn.json found. Run `kitn init` first.");
     process.exit(1);
   }
@@ -1797,9 +1854,9 @@ async function listCommand(typeFilter, opts) {
     p4.log.error(`Unknown type ${pc5.bold(rawType)}. Valid types: agent, tool, skill, storage, package`);
     process.exit(1);
   }
-  const fetcher = new RegistryFetcher(config.registries);
-  const namespacesToFetch = opts.registry ? [opts.registry] : Object.keys(config.registries);
-  if (opts.registry && !config.registries[opts.registry]) {
+  const fetcher = new RegistryFetcher(config2.registries);
+  const namespacesToFetch = opts.registry ? [opts.registry] : Object.keys(config2.registries);
+  if (opts.registry && !config2.registries[opts.registry]) {
     p4.log.error(`Registry ${pc5.bold(opts.registry)} is not configured. Run ${pc5.bold("kitn registry list")} to see configured registries.`);
     process.exit(1);
   }
@@ -1912,12 +1969,12 @@ import * as p5 from "@clack/prompts";
 import { join as join10 } from "path";
 async function diffCommand(componentName) {
   const cwd = process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) {
+  const config2 = await readConfig(cwd);
+  if (!config2) {
     p5.log.error("No kitn.json found. Run `kitn init` first.");
     process.exit(1);
   }
-  const input = componentName === "routes" ? resolveRoutesAlias(config) : componentName;
+  const input = componentName === "routes" ? resolveRoutesAlias(config2) : componentName;
   const ref = parseComponentRef(input);
   const lock = await readLock(cwd);
   const installedKey = ref.namespace === "@kitn" ? ref.name : `${ref.namespace}/${ref.name}`;
@@ -1927,7 +1984,7 @@ async function diffCommand(componentName) {
     process.exit(1);
   }
   const namespace = installed.registry ?? ref.namespace;
-  const fetcher = new RegistryFetcher(config.registries);
+  const fetcher = new RegistryFetcher(config2.registries);
   const index = await fetcher.fetchIndex(namespace);
   const indexItem = index.items.find((i) => i.name === ref.name);
   if (!indexItem) {
@@ -1939,7 +1996,7 @@ async function diffCommand(componentName) {
   let hasDiff = false;
   for (const file of registryItem.files) {
     if (indexItem.type === "kitn:package") {
-      const baseDir = config.aliases.base ?? "src/ai";
+      const baseDir = config2.aliases.base ?? "src/ai";
       const localPath = join10(cwd, baseDir, file.path);
       const relativePath = join10(baseDir, file.path);
       const localContent = await readExistingFile(localPath);
@@ -1965,7 +2022,7 @@ async function diffCommand(componentName) {
             return "storage";
         }
       })();
-      const localPath = join10(cwd, config.aliases[aliasKey], fileName);
+      const localPath = join10(cwd, config2.aliases[aliasKey], fileName);
       const localContent = await readExistingFile(localPath);
       if (localContent === null) {
         p5.log.warn(`${fileName}: file missing locally`);
@@ -2000,9 +2057,9 @@ __export(remove_exports, {
 import * as p6 from "@clack/prompts";
 import pc6 from "picocolors";
 import { join as join11, relative as relative3, dirname as dirname5 } from "path";
-import { unlink as unlink3, readFile as readFile7, writeFile as writeFile9 } from "fs/promises";
+import { unlink as unlink3, readFile as readFile8, writeFile as writeFile9 } from "fs/promises";
 import { existsSync as existsSync2 } from "fs";
-async function removeSingleComponent(installedKey, lock, config, cwd) {
+async function removeSingleComponent(installedKey, lock, config2, cwd) {
   const entry = lock[installedKey];
   if (!entry) return;
   const deleted = [];
@@ -2014,16 +2071,16 @@ async function removeSingleComponent(installedKey, lock, config, cwd) {
       p6.log.warn(`Could not delete ${filePath} (may have been moved or renamed)`);
     }
   }
-  const baseDir = config.aliases.base ?? "src/ai";
+  const baseDir = config2.aliases.base ?? "src/ai";
   const barrelPath = join11(cwd, baseDir, "index.ts");
   const barrelDir = join11(cwd, baseDir);
   const barrelEligibleDirs = /* @__PURE__ */ new Set([
-    config.aliases.agents,
-    config.aliases.tools,
-    config.aliases.skills
+    config2.aliases.agents,
+    config2.aliases.tools,
+    config2.aliases.skills
   ]);
   if (existsSync2(barrelPath) && deleted.length > 0) {
-    let barrelContent = await readFile7(barrelPath, "utf-8");
+    let barrelContent = await readFile8(barrelPath, "utf-8");
     let barrelChanged = false;
     for (const filePath of deleted) {
       const fileDir = dirname5(filePath);
@@ -2046,7 +2103,7 @@ async function removeSingleComponent(installedKey, lock, config, cwd) {
 ` + deleted.map((f) => `  ${pc6.red("-")} ${f}`).join("\n"));
   }
 }
-async function offerOrphanRemoval(removedDeps, lock, config, cwd) {
+async function offerOrphanRemoval(removedDeps, lock, config2, cwd) {
   if (removedDeps.size === 0) return;
   const remaining = Object.entries(lock);
   const neededDeps = /* @__PURE__ */ new Set();
@@ -2073,13 +2130,13 @@ async function offerOrphanRemoval(removedDeps, lock, config, cwd) {
   });
   if (p6.isCancel(selected)) return;
   for (const key of selected) {
-    await removeSingleComponent(key, lock, config, cwd);
+    await removeSingleComponent(key, lock, config2, cwd);
   }
 }
 async function removeCommand(componentName) {
   const cwd = process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) {
+  const config2 = await readConfig(cwd);
+  if (!config2) {
     p6.log.error("No kitn.json found. Run `kitn init` first.");
     process.exit(1);
   }
@@ -2117,14 +2174,14 @@ async function removeCommand(componentName) {
       }
     }
     for (const key of selectedKeys) {
-      await removeSingleComponent(key, lock, config, cwd);
+      await removeSingleComponent(key, lock, config2, cwd);
     }
-    await offerOrphanRemoval(allRemovedDeps, lock, config, cwd);
+    await offerOrphanRemoval(allRemovedDeps, lock, config2, cwd);
     await writeLock(cwd, lock);
     p6.outro(pc6.green("Done!"));
     return;
   }
-  const input = componentName === "routes" ? resolveRoutesAlias(config) : componentName;
+  const input = componentName === "routes" ? resolveRoutesAlias(config2) : componentName;
   const ref = parseComponentRef(input);
   const installedKey = ref.namespace === "@kitn" ? ref.name : `${ref.namespace}/${ref.name}`;
   const entry = lock[installedKey];
@@ -2141,8 +2198,8 @@ async function removeCommand(componentName) {
     process.exit(0);
   }
   const removedDeps = new Set(entry.registryDependencies ?? []);
-  await removeSingleComponent(installedKey, lock, config, cwd);
-  await offerOrphanRemoval(removedDeps, lock, config, cwd);
+  await removeSingleComponent(installedKey, lock, config2, cwd);
+  await offerOrphanRemoval(removedDeps, lock, config2, cwd);
   await writeLock(cwd, lock);
 }
 var init_remove = __esm({
@@ -2163,8 +2220,8 @@ import * as p7 from "@clack/prompts";
 async function updateCommand(components) {
   if (components.length === 0) {
     const cwd = process.cwd();
-    const config = await readConfig(cwd);
-    if (!config) {
+    const config2 = await readConfig(cwd);
+    if (!config2) {
       p7.log.error("No kitn.json found. Run `kitn init` first.");
       process.exit(1);
     }
@@ -2208,7 +2265,7 @@ import * as p8 from "@clack/prompts";
 import pc7 from "picocolors";
 import { join as join12, relative as relative4 } from "path";
 import { existsSync as existsSync3 } from "fs";
-import { readFile as readFile8, writeFile as writeFile10, mkdir as mkdir6 } from "fs/promises";
+import { readFile as readFile9, writeFile as writeFile10, mkdir as mkdir6 } from "fs/promises";
 function generateAgentSource(name) {
   const camel = toCamelCase(name);
   return `import { registerAgent } from "@kitn/core";
@@ -2306,8 +2363,8 @@ async function createComponentInProject(type, name, opts) {
     );
   }
   const cwd = opts?.cwd ?? process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) {
+  const config2 = await readConfig(cwd);
+  if (!config2) {
     throw new Error(
       `No kitn.json found in ${cwd}. Run ${pc7.bold("kitn init")} first.`
     );
@@ -2315,7 +2372,7 @@ async function createComponentInProject(type, name, opts) {
   const validType = type;
   const kitnType = typeToKitnType[validType];
   const fileName = validType === "skill" ? `${name}.md` : `${name}.ts`;
-  const filePath = join12(cwd, getInstallPath(config, kitnType, fileName));
+  const filePath = join12(cwd, getInstallPath(config2, kitnType, fileName));
   const dummyContent = "";
   const status = await checkFileStatus(filePath, dummyContent);
   if (status !== "new" /* New */) {
@@ -2342,11 +2399,11 @@ async function createComponentInProject(type, name, opts) {
   await writeComponentFile(filePath, source);
   let barrelUpdated = false;
   if (BARREL_TYPES.includes(validType)) {
-    const baseDir = config.aliases.base ?? "src/ai";
+    const baseDir = config2.aliases.base ?? "src/ai";
     const barrelPath = join12(cwd, baseDir, "index.ts");
     let barrelContent;
     if (existsSync3(barrelPath)) {
-      barrelContent = await readFile8(barrelPath, "utf-8");
+      barrelContent = await readFile9(barrelPath, "utf-8");
     } else {
       barrelContent = createBarrelFile();
       await mkdir6(join12(cwd, baseDir), { recursive: true });
@@ -2398,7 +2455,7 @@ var init_create = __esm({
 });
 
 // src/utils/component-resolver.ts
-import { readdir, readFile as readFile9 } from "fs/promises";
+import { readdir, readFile as readFile10 } from "fs/promises";
 import { join as join13, relative as relative5 } from "path";
 function stripSuffix(name, suffix) {
   if (name.endsWith(`-${suffix}`)) {
@@ -2406,21 +2463,21 @@ function stripSuffix(name, suffix) {
   }
   return name;
 }
-function toolsDir(config, cwd) {
-  const baseAlias = config.aliases.base ?? "src/ai";
-  const tools = config.aliases.tools ?? join13(baseAlias, "tools");
+function toolsDir(config2, cwd) {
+  const baseAlias = config2.aliases.base ?? "src/ai";
+  const tools = config2.aliases.tools ?? join13(baseAlias, "tools");
   return join13(cwd, tools);
 }
-function agentsDir(config, cwd) {
-  const baseAlias = config.aliases.base ?? "src/ai";
-  const agents = config.aliases.agents ?? join13(baseAlias, "agents");
+function agentsDir(config2, cwd) {
+  const baseAlias = config2.aliases.base ?? "src/ai";
+  const agents = config2.aliases.agents ?? join13(baseAlias, "agents");
   return join13(cwd, agents);
 }
 async function findFile(dir, candidates) {
   for (const name of candidates) {
     const filePath = join13(dir, `${name}.ts`);
     try {
-      await readFile9(filePath);
+      await readFile10(filePath);
       return filePath;
     } catch {
     }
@@ -2442,20 +2499,20 @@ function computeImportPath(fromDir, toFile) {
   }
   return rel.replace(/\.ts$/, ".js");
 }
-async function resolveToolByName(name, config, cwd) {
-  const tDir = toolsDir(config, cwd);
-  const aDir = agentsDir(config, cwd);
+async function resolveToolByName(name, config2, cwd) {
+  const tDir = toolsDir(config2, cwd);
+  const aDir = agentsDir(config2, cwd);
   const lock = await readLock(cwd);
   for (const [componentName, entry] of Object.entries(lock)) {
     if (componentName === name || componentName === `${name}-tool`) {
       const toolFile = entry.files.find((f) => {
-        const toolsAlias = config.aliases.tools ?? join13(config.aliases.base ?? "src/ai", "tools");
+        const toolsAlias = config2.aliases.tools ?? join13(config2.aliases.base ?? "src/ai", "tools");
         return f.startsWith(toolsAlias);
       });
       if (toolFile) {
         const filePath2 = join13(cwd, toolFile);
         try {
-          const source2 = await readFile9(filePath2, "utf-8");
+          const source2 = await readFile10(filePath2, "utf-8");
           const exportName2 = parseExportName(source2);
           if (exportName2) {
             return {
@@ -2473,7 +2530,7 @@ async function resolveToolByName(name, config, cwd) {
   const uniqueCandidates = [...new Set(candidates)];
   const filePath = await findFile(tDir, uniqueCandidates);
   if (!filePath) return null;
-  const source = await readFile9(filePath, "utf-8");
+  const source = await readFile10(filePath, "utf-8");
   const exportName = parseExportName(source);
   if (!exportName) return null;
   return {
@@ -2482,19 +2539,19 @@ async function resolveToolByName(name, config, cwd) {
     importPath: computeImportPath(aDir, filePath)
   };
 }
-async function resolveAgentByName(name, config, cwd) {
-  const aDir = agentsDir(config, cwd);
+async function resolveAgentByName(name, config2, cwd) {
+  const aDir = agentsDir(config2, cwd);
   const lock = await readLock(cwd);
   for (const [componentName, entry] of Object.entries(lock)) {
     if (componentName === name || componentName === `${name}-agent`) {
       const agentFile = entry.files.find((f) => {
-        const agentsAlias = config.aliases.agents ?? join13(config.aliases.base ?? "src/ai", "agents");
+        const agentsAlias = config2.aliases.agents ?? join13(config2.aliases.base ?? "src/ai", "agents");
         return f.startsWith(agentsAlias);
       });
       if (agentFile) {
         const filePath2 = join13(cwd, agentFile);
         try {
-          const source2 = await readFile9(filePath2, "utf-8");
+          const source2 = await readFile10(filePath2, "utf-8");
           const agentName2 = parseAgentName(source2);
           return {
             filePath: filePath2,
@@ -2509,7 +2566,7 @@ async function resolveAgentByName(name, config, cwd) {
   const uniqueCandidates = [...new Set(candidates)];
   const filePath = await findFile(aDir, uniqueCandidates);
   if (!filePath) return null;
-  const source = await readFile9(filePath, "utf-8");
+  const source = await readFile10(filePath, "utf-8");
   const agentName = parseAgentName(source);
   const fallbackName = filePath.split("/").pop().replace(/\.ts$/, "");
   return {
@@ -2517,12 +2574,12 @@ async function resolveAgentByName(name, config, cwd) {
     name: agentName ?? fallbackName
   };
 }
-async function listTools(config, cwd) {
-  const dir = toolsDir(config, cwd);
+async function listTools(config2, cwd) {
+  const dir = toolsDir(config2, cwd);
   return listComponentsInDir(dir);
 }
-async function listAgents(config, cwd) {
-  const dir = agentsDir(config, cwd);
+async function listAgents(config2, cwd) {
+  const dir = agentsDir(config2, cwd);
   return listComponentsInDir(dir);
 }
 async function listComponentsInDir(dir) {
@@ -2797,13 +2854,13 @@ __export(link_exports, {
 });
 import * as p9 from "@clack/prompts";
 import pc8 from "picocolors";
-import { readFile as readFile10, writeFile as writeFile11 } from "fs/promises";
+import { readFile as readFile11, writeFile as writeFile11 } from "fs/promises";
 import { basename } from "path";
 async function linkCommand(type, name, opts) {
   p9.intro(pc8.bgCyan(pc8.black(" kitn link ")));
   const cwd = process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) {
+  const config2 = await readConfig(cwd);
+  if (!config2) {
     p9.log.error("No kitn.json found. Run `kitn init` first.");
     process.exit(1);
   }
@@ -2815,7 +2872,7 @@ async function linkCommand(type, name, opts) {
   }
   let toolName = name;
   if (!toolName) {
-    const tools = await listTools(config, cwd);
+    const tools = await listTools(config2, cwd);
     if (tools.length === 0) {
       p9.log.error("No tools found in your project.");
       process.exit(1);
@@ -2833,7 +2890,7 @@ async function linkCommand(type, name, opts) {
     }
     toolName = selected;
   }
-  const tool = await resolveToolByName(toolName, config, cwd);
+  const tool = await resolveToolByName(toolName, config2, cwd);
   if (!tool) {
     p9.log.error(
       `Tool "${toolName}" not found. Check that the file exists in your tools directory.`
@@ -2842,7 +2899,7 @@ async function linkCommand(type, name, opts) {
   }
   let agentName = opts?.to;
   if (!agentName) {
-    const agents = await listAgents(config, cwd);
+    const agents = await listAgents(config2, cwd);
     if (agents.length === 0) {
       p9.log.error("No agents found in your project.");
       process.exit(1);
@@ -2860,14 +2917,14 @@ async function linkCommand(type, name, opts) {
     }
     agentName = selected;
   }
-  const agent = await resolveAgentByName(agentName, config, cwd);
+  const agent = await resolveAgentByName(agentName, config2, cwd);
   if (!agent) {
     p9.log.error(
       `Agent "${agentName}" not found. Check that the file exists in your agents directory.`
     );
     process.exit(1);
   }
-  const agentContent = await readFile10(agent.filePath, "utf-8");
+  const agentContent = await readFile11(agent.filePath, "utf-8");
   const toolRef = {
     exportName: tool.exportName,
     importPath: tool.importPath
@@ -2913,13 +2970,13 @@ __export(unlink_exports, {
 });
 import * as p10 from "@clack/prompts";
 import pc9 from "picocolors";
-import { readFile as readFile11, writeFile as writeFile12 } from "fs/promises";
+import { readFile as readFile12, writeFile as writeFile12 } from "fs/promises";
 import { basename as basename2 } from "path";
 async function unlinkCommand(type, name, opts) {
   p10.intro(pc9.bgCyan(pc9.black(" kitn unlink ")));
   const cwd = process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) {
+  const config2 = await readConfig(cwd);
+  if (!config2) {
     p10.log.error("No kitn.json found. Run `kitn init` first.");
     process.exit(1);
   }
@@ -2931,7 +2988,7 @@ async function unlinkCommand(type, name, opts) {
   }
   let toolName = name;
   if (!toolName) {
-    const tools = await listTools(config, cwd);
+    const tools = await listTools(config2, cwd);
     if (tools.length === 0) {
       p10.log.error("No tools found in your project.");
       process.exit(1);
@@ -2949,7 +3006,7 @@ async function unlinkCommand(type, name, opts) {
     }
     toolName = selected;
   }
-  const tool = await resolveToolByName(toolName, config, cwd);
+  const tool = await resolveToolByName(toolName, config2, cwd);
   if (!tool) {
     p10.log.error(
       `Tool "${toolName}" not found. Check that the file exists in your tools directory.`
@@ -2958,7 +3015,7 @@ async function unlinkCommand(type, name, opts) {
   }
   let agentName = opts?.from;
   if (!agentName) {
-    const agents = await listAgents(config, cwd);
+    const agents = await listAgents(config2, cwd);
     if (agents.length === 0) {
       p10.log.error("No agents found in your project.");
       process.exit(1);
@@ -2976,14 +3033,14 @@ async function unlinkCommand(type, name, opts) {
     }
     agentName = selected;
   }
-  const agent = await resolveAgentByName(agentName, config, cwd);
+  const agent = await resolveAgentByName(agentName, config2, cwd);
   if (!agent) {
     p10.log.error(
       `Agent "${agentName}" not found. Check that the file exists in your agents directory.`
     );
     process.exit(1);
   }
-  const agentContent = await readFile11(agent.filePath, "utf-8");
+  const agentContent = await readFile12(agent.filePath, "utf-8");
   const toolRef = {
     exportName: tool.exportName,
     importPath: tool.importPath
@@ -3031,13 +3088,13 @@ import * as p11 from "@clack/prompts";
 import pc10 from "picocolors";
 async function infoCommand(component) {
   const cwd = process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) {
+  const config2 = await readConfig(cwd);
+  if (!config2) {
     p11.log.error("No kitn.json found. Run `kitn init` first.");
     process.exit(1);
   }
   const ref = parseComponentRef(component);
-  const fetcher = new RegistryFetcher(config.registries);
+  const fetcher = new RegistryFetcher(config2.registries);
   const s = p11.spinner();
   s.start("Fetching component info...");
   let index;
@@ -3200,40 +3257,33 @@ import pc12 from "picocolors";
 async function rulesCommand() {
   p13.intro(pc12.bgCyan(pc12.black(" kitn rules ")));
   const cwd = process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) {
-    p13.log.error(`No kitn.json found. Run ${pc12.bold("kitn init")} first.`);
-    process.exit(1);
+  const config2 = await readConfig(cwd);
+  const registries = config2?.registries ?? DEFAULT_REGISTRIES;
+  const aliases = config2?.aliases ?? DEFAULT_ALIASES;
+  const rulesConfig = await fetchRulesConfig(registries);
+  const selected = await p13.multiselect({
+    message: "Which AI coding tools do you use?",
+    options: rulesConfig.tools.map((t) => ({
+      value: t.id,
+      label: t.name,
+      hint: t.description
+    })),
+    required: false
+  });
+  if (p13.isCancel(selected)) {
+    p13.cancel("Cancelled.");
+    process.exit(0);
   }
-  let selectedIds = config.aiTools;
-  if (!selectedIds || selectedIds.length === 0) {
-    const rulesConfig = await fetchRulesConfig(config.registries);
-    const selected = await p13.multiselect({
-      message: "Which AI coding tools do you use?",
-      options: rulesConfig.tools.map((t) => ({
-        value: t.id,
-        label: t.name,
-        hint: t.description
-      })),
-      required: false
-    });
-    if (p13.isCancel(selected)) {
-      p13.cancel("Cancelled.");
-      process.exit(0);
-    }
-    selectedIds = selected;
-    if (selectedIds.length === 0) {
-      p13.log.warn("No tools selected. Nothing to generate.");
-      p13.outro("Done.");
-      return;
-    }
-    const updatedConfig = { ...config, aiTools: selectedIds };
-    await writeConfig(cwd, updatedConfig);
-    p13.log.info(`Saved tool selections to ${pc12.bold("kitn.json")}`);
+  const selectedIds = selected;
+  if (selectedIds.length === 0) {
+    p13.log.warn("No tools selected. Nothing to generate.");
+    p13.outro("Done.");
+    return;
   }
   const s = p13.spinner();
   s.start("Generating rules files");
-  const written = await generateRulesFiles(cwd, config, selectedIds);
+  const effectiveConfig = { registries, aliases };
+  const written = await generateRulesFiles(cwd, effectiveConfig, selectedIds);
   s.stop("Rules files generated");
   for (const filePath of written) {
     p13.log.success(`${pc12.green("+")} ${filePath}`);
@@ -3248,6 +3298,284 @@ var init_rules = __esm({
   }
 });
 
+// src/commands/config.ts
+var config_exports = {};
+__export(config_exports, {
+  configGetCommand: () => configGetCommand,
+  configListCommand: () => configListCommand,
+  configSetCommand: () => configSetCommand,
+  readUserConfig: () => readUserConfig
+});
+import * as p14 from "@clack/prompts";
+import pc13 from "picocolors";
+import { readFile as readFile13, writeFile as writeFile13, mkdir as mkdir7 } from "fs/promises";
+import { join as join14 } from "path";
+import { homedir as homedir2 } from "os";
+import { existsSync as existsSync4 } from "fs";
+async function readUserConfig() {
+  try {
+    const raw = await readFile13(CONFIG_FILE2, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+async function writeUserConfig(config2) {
+  if (!existsSync4(CONFIG_DIR)) {
+    await mkdir7(CONFIG_DIR, { recursive: true });
+  }
+  await writeFile13(CONFIG_FILE2, JSON.stringify(config2, null, 2) + "\n");
+}
+async function configSetCommand(key, value) {
+  if (!VALID_KEYS.includes(key)) {
+    p14.log.error(`Unknown config key: ${pc13.red(key)}`);
+    p14.log.info(`Valid keys: ${VALID_KEYS.join(", ")}`);
+    process.exit(1);
+  }
+  const config2 = await readUserConfig();
+  config2[key] = value;
+  await writeUserConfig(config2);
+  const displayValue = key.includes("key") ? value.slice(0, 8) + "..." : value;
+  p14.log.success(`Set ${pc13.cyan(key)} = ${pc13.green(displayValue)}`);
+}
+async function configGetCommand(key) {
+  const config2 = await readUserConfig();
+  const value = config2[key];
+  if (value === void 0) {
+    p14.log.warn(`${pc13.cyan(key)} is not set`);
+  } else {
+    const displayValue = key.includes("key") ? value.slice(0, 8) + "..." : value;
+    p14.log.info(`${pc13.cyan(key)} = ${pc13.green(displayValue)}`);
+  }
+}
+async function configListCommand() {
+  const config2 = await readUserConfig();
+  const entries = Object.entries(config2);
+  if (entries.length === 0) {
+    p14.log.info("No user configuration set.");
+    p14.log.info(`Run ${pc13.cyan("kitn config set <key> <value>")} to configure.`);
+    return;
+  }
+  for (const [key, value] of entries) {
+    const displayValue = key.includes("key") ? value.slice(0, 8) + "..." : value;
+    p14.log.info(`${pc13.cyan(key)} = ${pc13.green(displayValue)}`);
+  }
+}
+var CONFIG_DIR, CONFIG_FILE2, VALID_KEYS;
+var init_config2 = __esm({
+  "src/commands/config.ts"() {
+    "use strict";
+    CONFIG_DIR = join14(homedir2(), ".kitn");
+    CONFIG_FILE2 = join14(CONFIG_DIR, "config.json");
+    VALID_KEYS = ["chat-url", "api-key"];
+  }
+});
+
+// src/commands/chat.ts
+var chat_exports = {};
+__export(chat_exports, {
+  buildRequestPayload: () => buildRequestPayload,
+  chatCommand: () => chatCommand,
+  formatPlan: () => formatPlan,
+  resolveServiceUrl: () => resolveServiceUrl
+});
+import * as p15 from "@clack/prompts";
+import pc14 from "picocolors";
+async function resolveServiceUrl(urlOverride, chatServiceConfig) {
+  if (urlOverride) return urlOverride;
+  if (process.env.KITN_CHAT_URL) return process.env.KITN_CHAT_URL;
+  const userConfig = await readUserConfig();
+  if (userConfig["chat-url"]) return userConfig["chat-url"];
+  if (chatServiceConfig?.url) return chatServiceConfig.url;
+  return DEFAULT_SERVICE_URL;
+}
+function buildRequestPayload(message, metadata) {
+  return { message, metadata };
+}
+function formatPlan(plan) {
+  const lines = [plan.summary, ""];
+  for (let i = 0; i < plan.steps.length; i++) {
+    const step = plan.steps[i];
+    const num = `${i + 1}.`;
+    const label = formatStepLabel(step);
+    lines.push(`${num} ${label} - ${step.reason}`);
+  }
+  return lines.join("\n");
+}
+function formatStepLabel(step) {
+  switch (step.action) {
+    case "add":
+      return `Add ${pc14.cyan(step.component)}`;
+    case "remove":
+      return `Remove ${pc14.red(step.component)}`;
+    case "create":
+      return `Create ${pc14.green(`${step.type}/${step.name}`)}`;
+    case "link":
+      return `Link ${pc14.cyan(step.toolName)} \u2192 ${pc14.cyan(step.agentName)}`;
+    case "unlink":
+      return `Unlink ${pc14.red(step.toolName)} from ${pc14.cyan(step.agentName)}`;
+  }
+}
+async function chatCommand(message, opts) {
+  const cwd = process.cwd();
+  const config2 = await readConfig(cwd);
+  if (!config2) {
+    p15.log.error("No kitn.json found. Run `kitn init` first.");
+    process.exit(1);
+  }
+  if (!message) {
+    p15.log.error('Please provide a message. Usage: kitn chat "add a weather tool"');
+    process.exit(1);
+  }
+  p15.intro(pc14.bold("kitn assistant"));
+  const s = p15.spinner();
+  s.start("Gathering project context...");
+  let registryIndex;
+  let installed;
+  try {
+    const fetcher = new RegistryFetcher(config2.registries);
+    const indices = [];
+    for (const namespace of Object.keys(config2.registries)) {
+      try {
+        const index = await fetcher.fetchIndex(namespace);
+        indices.push(index);
+      } catch {
+      }
+    }
+    registryIndex = indices;
+    const lock = await readLock(cwd);
+    installed = Object.keys(lock);
+  } catch {
+    s.stop(pc14.red("Failed to gather context"));
+    p15.log.error("Could not read project context. Check your kitn.json and network connection.");
+    process.exit(1);
+  }
+  s.stop("Context gathered");
+  s.start("Thinking...");
+  const serviceUrl = await resolveServiceUrl(opts?.url, config2.chatService);
+  const payload = buildRequestPayload(message, { registryIndex, installed });
+  let response;
+  try {
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (process.env.KITN_API_KEY) {
+      headers["Authorization"] = `Bearer ${process.env.KITN_API_KEY}`;
+    }
+    response = await fetch(`${serviceUrl}/api/chat`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(payload)
+    });
+  } catch (err) {
+    s.stop(pc14.red("Connection failed"));
+    p15.log.error(`Could not reach chat service at ${serviceUrl}. ${err.message ?? ""}`);
+    process.exit(1);
+  }
+  if (!response.ok) {
+    s.stop(pc14.red("Request failed"));
+    p15.log.error(`Chat service returned ${response.status}: ${response.statusText}`);
+    process.exit(1);
+  }
+  let data;
+  try {
+    data = await response.json();
+  } catch {
+    s.stop(pc14.red("Invalid response"));
+    p15.log.error("Chat service returned an invalid response.");
+    process.exit(1);
+  }
+  s.stop("Done");
+  if (data.rejected) {
+    p15.log.warn(data.text ?? "Request was rejected by the assistant.");
+    p15.outro("Try rephrasing your request.");
+    return;
+  }
+  if (!data.plan) {
+    p15.log.info(data.text ?? "No actionable plan returned.");
+    p15.outro("Nothing to do.");
+    return;
+  }
+  p15.log.message(formatPlan(data.plan));
+  const steps = data.plan.steps;
+  const action = await p15.select({
+    message: "How would you like to proceed?",
+    options: [
+      { value: "all", label: "Yes, run all steps" },
+      { value: "select", label: "Select which steps to run" },
+      { value: "cancel", label: "Cancel" }
+    ]
+  });
+  if (p15.isCancel(action) || action === "cancel") {
+    p15.cancel("Cancelled.");
+    return;
+  }
+  let selectedSteps;
+  if (action === "select") {
+    const choices = await p15.multiselect({
+      message: "Select steps to run:",
+      options: steps.map((step, i) => ({
+        value: i,
+        label: `${formatStepLabel(step)} - ${step.reason}`
+      }))
+    });
+    if (p15.isCancel(choices)) {
+      p15.cancel("Cancelled.");
+      return;
+    }
+    selectedSteps = choices.map((i) => steps[i]);
+  } else {
+    selectedSteps = steps;
+  }
+  for (const step of selectedSteps) {
+    s.start(`Running: ${formatStepLabel(step)}...`);
+    try {
+      switch (step.action) {
+        case "add": {
+          const { addCommand: addCommand2 } = await Promise.resolve().then(() => (init_add(), add_exports));
+          await addCommand2([step.component], { yes: true });
+          break;
+        }
+        case "create": {
+          const { createCommand: createCommand2 } = await Promise.resolve().then(() => (init_create(), create_exports));
+          await createCommand2(step.type, step.name);
+          break;
+        }
+        case "link": {
+          const { linkCommand: linkCommand2 } = await Promise.resolve().then(() => (init_link(), link_exports));
+          await linkCommand2("tool", step.toolName, { to: step.agentName });
+          break;
+        }
+        case "remove": {
+          const { removeCommand: removeCommand2 } = await Promise.resolve().then(() => (init_remove(), remove_exports));
+          await removeCommand2(step.component);
+          break;
+        }
+        case "unlink": {
+          const { unlinkCommand: unlinkCommand2 } = await Promise.resolve().then(() => (init_unlink(), unlink_exports));
+          await unlinkCommand2("tool", step.toolName, { from: step.agentName });
+          break;
+        }
+      }
+      s.stop(pc14.green(`Done: ${formatStepLabel(step)}`));
+    } catch (err) {
+      s.stop(pc14.red(`Failed: ${formatStepLabel(step)}`));
+      p15.log.error(err.message ?? "Unknown error");
+    }
+  }
+  p15.outro(pc14.green("All done! Run your dev server to test the new components."));
+}
+var DEFAULT_SERVICE_URL;
+var init_chat = __esm({
+  "src/commands/chat.ts"() {
+    "use strict";
+    init_config();
+    init_fetcher();
+    init_config2();
+    DEFAULT_SERVICE_URL = "https://chat.kitn.dev";
+  }
+});
+
 // src/commands/registry.ts
 var registry_exports = {};
 __export(registry_exports, {
@@ -3255,12 +3583,12 @@ __export(registry_exports, {
   registryListCommand: () => registryListCommand,
   registryRemoveCommand: () => registryRemoveCommand
 });
-import * as p14 from "@clack/prompts";
-import pc13 from "picocolors";
+import * as p16 from "@clack/prompts";
+import pc15 from "picocolors";
 async function registryAddCommand(namespace, url, opts = {}) {
   const cwd = opts.cwd ?? process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) throw new Error("No kitn.json found. Run `kitn init` first.");
+  const config2 = await readConfig(cwd);
+  if (!config2) throw new Error("No kitn.json found. Run `kitn init` first.");
   if (!namespace.startsWith("@")) {
     throw new Error("Namespace must start with @ (e.g. @myteam)");
   }
@@ -3270,28 +3598,28 @@ async function registryAddCommand(namespace, url, opts = {}) {
   if (!url.includes("{name}")) {
     throw new Error("URL template must include {name} placeholder");
   }
-  if (config.registries[namespace] && !opts.overwrite) {
+  if (config2.registries[namespace] && !opts.overwrite) {
     throw new Error(`Registry '${namespace}' is already configured. Use --overwrite to replace.`);
   }
   if (opts.homepage || opts.description) {
     const entry = { url };
     if (opts.homepage) entry.homepage = opts.homepage;
     if (opts.description) entry.description = opts.description;
-    config.registries[namespace] = entry;
+    config2.registries[namespace] = entry;
   } else {
-    config.registries[namespace] = url;
+    config2.registries[namespace] = url;
   }
-  await writeConfig(cwd, config);
-  p14.log.success(`Added registry ${pc13.bold(namespace)}`);
-  p14.log.message(pc13.dim(`  ${url}`));
-  if (opts.homepage) p14.log.message(pc13.dim(`  Homepage: ${opts.homepage}`));
-  if (opts.description) p14.log.message(pc13.dim(`  ${opts.description}`));
+  await writeConfig(cwd, config2);
+  p16.log.success(`Added registry ${pc15.bold(namespace)}`);
+  p16.log.message(pc15.dim(`  ${url}`));
+  if (opts.homepage) p16.log.message(pc15.dim(`  Homepage: ${opts.homepage}`));
+  if (opts.description) p16.log.message(pc15.dim(`  ${opts.description}`));
 }
 async function registryRemoveCommand(namespace, opts = {}) {
   const cwd = opts.cwd ?? process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) throw new Error("No kitn.json found. Run `kitn init` first.");
-  if (!config.registries[namespace]) {
+  const config2 = await readConfig(cwd);
+  if (!config2) throw new Error("No kitn.json found. Run `kitn init` first.");
+  if (!config2.registries[namespace]) {
     throw new Error(`Registry '${namespace}' is not configured.`);
   }
   if (namespace === "@kitn" && !opts.force) {
@@ -3304,35 +3632,35 @@ async function registryRemoveCommand(namespace, opts = {}) {
       affectedComponents.push(name);
     }
   }
-  delete config.registries[namespace];
-  await writeConfig(cwd, config);
-  p14.log.success(`Removed registry ${pc13.bold(namespace)}`);
+  delete config2.registries[namespace];
+  await writeConfig(cwd, config2);
+  p16.log.success(`Removed registry ${pc15.bold(namespace)}`);
   if (affectedComponents.length > 0) {
-    p14.log.warn(`${affectedComponents.length} installed component(s) referenced this registry:
-` + affectedComponents.map((name) => `  ${pc13.yellow("!")} ${name}`).join("\n"));
+    p16.log.warn(`${affectedComponents.length} installed component(s) referenced this registry:
+` + affectedComponents.map((name) => `  ${pc15.yellow("!")} ${name}`).join("\n"));
   }
   return { affectedComponents };
 }
 async function registryListCommand(opts = {}) {
   const cwd = opts.cwd ?? process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) throw new Error("No kitn.json found. Run `kitn init` first.");
-  const entries = Object.entries(config.registries).map(([namespace, value]) => {
+  const config2 = await readConfig(cwd);
+  if (!config2) throw new Error("No kitn.json found. Run `kitn init` first.");
+  const entries = Object.entries(config2.registries).map(([namespace, value]) => {
     const url = getRegistryUrl(value);
     const homepage = typeof value === "object" ? value.homepage : void 0;
     const description = typeof value === "object" ? value.description : void 0;
     return { namespace, url, homepage, description };
   });
   if (entries.length === 0) {
-    p14.log.message(pc13.dim("  No registries configured."));
+    p16.log.message(pc15.dim("  No registries configured."));
   } else {
     const lines = [];
     for (const { namespace, url, homepage, description } of entries) {
-      lines.push(`  ${pc13.bold(namespace.padEnd(16))} ${pc13.dim(url)}`);
+      lines.push(`  ${pc15.bold(namespace.padEnd(16))} ${pc15.dim(url)}`);
       if (description) lines.push(`  ${" ".repeat(16)} ${description}`);
-      if (homepage) lines.push(`  ${" ".repeat(16)} ${pc13.dim(homepage)}`);
+      if (homepage) lines.push(`  ${" ".repeat(16)} ${pc15.dim(homepage)}`);
     }
-    p14.log.message(lines.join("\n"));
+    p16.log.message(lines.join("\n"));
   }
   return entries;
 }
@@ -3346,7 +3674,7 @@ var init_registry = __esm({
 // src/index.ts
 init_update_check();
 import { Command } from "commander";
-var VERSION = true ? "0.1.31" : "0.0.0-dev";
+var VERSION = true ? "0.1.33" : "0.0.0-dev";
 var printUpdateNotice = startUpdateCheck(VERSION);
 var program = new Command().name("kitn").description("Install AI agent components from the kitn registry").version(VERSION);
 program.command("init").description("Initialize kitn in your project").option("-r, --runtime <runtime>", "runtime to use (bun, node, deno)").option("-f, --framework <framework>", "HTTP framework (hono, hono-openapi, elysia)").option("-b, --base <path>", "base directory for components (default: src/ai)").option("-y, --yes", "accept all defaults without prompting").action(async (opts) => {
@@ -3397,6 +3725,10 @@ program.command("rules").description("Regenerate AI coding tool rules files").ac
   const { rulesCommand: rulesCommand2 } = await Promise.resolve().then(() => (init_rules(), rules_exports));
   await rulesCommand2();
 });
+program.command("chat").description("AI-powered scaffolding assistant \u2014 describe what you need in plain English").argument("<message>", 'what you want to build (e.g. "I want a weather agent")').option("-u, --url <url>", "chat service URL (overrides config and default)").action(async (message, opts) => {
+  const { chatCommand: chatCommand2 } = await Promise.resolve().then(() => (init_chat(), chat_exports));
+  await chatCommand2(message, opts);
+});
 var registry = program.command("registry").description("Manage component registries");
 registry.command("add").description("Add a component registry").argument("<namespace>", "registry namespace (e.g. @myteam)").argument("<url>", "URL template with {type} and {name} placeholders").option("-o, --overwrite", "overwrite if namespace already exists").option("--homepage <url>", "registry homepage URL").option("--description <text>", "short description of the registry").action(async (namespace, url, opts) => {
   const { registryAddCommand: registryAddCommand2 } = await Promise.resolve().then(() => (init_registry(), registry_exports));
@@ -3410,6 +3742,19 @@ registry.command("list").description("List all configured registries").action(as
   const { registryListCommand: registryListCommand2 } = await Promise.resolve().then(() => (init_registry(), registry_exports));
   await registryListCommand2();
 });
+var config = program.command("config").description("Manage user-level configuration");
+config.command("set").description("Set a config value").argument("<key>", "config key (chat-url, api-key)").argument("<value>", "config value").action(async (key, value) => {
+  const { configSetCommand: configSetCommand2 } = await Promise.resolve().then(() => (init_config2(), config_exports));
+  await configSetCommand2(key, value);
+});
+config.command("get").description("Get a config value").argument("<key>", "config key").action(async (key) => {
+  const { configGetCommand: configGetCommand2 } = await Promise.resolve().then(() => (init_config2(), config_exports));
+  await configGetCommand2(key);
+});
+config.command("list").description("List all config values").action(async () => {
+  const { configListCommand: configListCommand2 } = await Promise.resolve().then(() => (init_config2(), config_exports));
+  await configListCommand2();
+});
 await program.parseAsync();
 var ranCommand = program.args[0];
 if (ranCommand !== "check") {