@agentskit/cli 0.6.0 → 0.7.1

package/dist/bin.cjs

@@ -1,44 +1,46 @@
 #!/usr/bin/env node
 'use strict';
 
-var React3 = require('react');
-var ink = require('ink');
 var commander = require('commander');
-var fs = require('fs');
-var os = require('os');
-var path3 = require('path');
+var React2 = require('react');
+var ink = require('ink');
 var promises = require('fs/promises');
+var os = require('os');
+var path = require('path');
 var ink$1 = require('@agentskit/ink');
 var adapters = require('@agentskit/adapters');
+var crypto = require('crypto');
+var fs = require('fs');
 var tools = require('@agentskit/tools');
 var skills = require('@agentskit/skills');
 var memory = require('@agentskit/memory');
-var crypto = require('crypto');
+var child_process = require('child_process');
 var jsxRuntime = require('react/jsx-runtime');
+var url = require('url');
+var runtime = require('@agentskit/runtime');
 var prompts = require('@inquirer/prompts');
 var kleur = require('kleur');
-var runtime = require('@agentskit/runtime');
-var child_process = require('child_process');
 var chokidar = require('chokidar');
+var rag = require('@agentskit/rag');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
-var React3__default = /*#__PURE__*/_interopDefault(React3);
-var path3__default = /*#__PURE__*/_interopDefault(path3);
+var React2__default = /*#__PURE__*/_interopDefault(React2);
+var path__default = /*#__PURE__*/_interopDefault(path);
 var kleur__default = /*#__PURE__*/_interopDefault(kleur);
 var chokidar__default = /*#__PURE__*/_interopDefault(chokidar);
 
-async function loadJsonConfig(path4) {
+async function loadJsonConfig(path5) {
   try {
-    const raw = await promises.readFile(path4, "utf8");
+    const raw = await promises.readFile(path5, "utf8");
     return JSON.parse(raw);
   } catch {
     return void 0;
   }
 }
-async function loadTsConfig(path4) {
+async function loadTsConfig(path5) {
   try {
-    const mod = await import(path4);
+    const mod = await import(path5);
     return mod.default ?? mod;
   } catch {
     return void 0;
@@ -46,7 +48,7 @@ async function loadTsConfig(path4) {
 }
 async function loadPackageJsonConfig(dir) {
   try {
-    const raw = await promises.readFile(path3.join(dir, "package.json"), "utf8");
+    const raw = await promises.readFile(path.join(dir, "package.json"), "utf8");
     const pkg = JSON.parse(raw);
     if (pkg.agentskit && typeof pkg.agentskit === "object") {
       return pkg.agentskit;
@@ -70,20 +72,20 @@ function mergeConfigs(base, override) {
   };
 }
 async function loadLocalConfig(cwd) {
-  const tsConfig = await loadTsConfig(path3.join(cwd, ".agentskit.config.ts"));
+  const tsConfig = await loadTsConfig(path.join(cwd, ".agentskit.config.ts"));
   if (tsConfig) return tsConfig;
-  const jsonConfig = await loadJsonConfig(path3.join(cwd, ".agentskit.config.json"));
+  const jsonConfig = await loadJsonConfig(path.join(cwd, ".agentskit.config.json"));
   if (jsonConfig) return jsonConfig;
   return await loadPackageJsonConfig(cwd);
 }
 async function loadGlobalConfig(home) {
-  const globalDir = path3.join(os.homedir(), ".agentskit");
-  const tsConfig = await loadTsConfig(path3.join(globalDir, "config.ts"));
+  const globalDir = path.join(os.homedir(), ".agentskit");
+  const tsConfig = await loadTsConfig(path.join(globalDir, "config.ts"));
   if (tsConfig) return tsConfig;
-  return await loadJsonConfig(path3.join(globalDir, "config.json"));
+  return await loadJsonConfig(path.join(globalDir, "config.json"));
 }
 async function loadConfig(options) {
-  const cwd = path3.resolve(process.cwd());
+  const cwd = path.resolve(process.cwd());
   const global = await loadGlobalConfig();
   const local = await loadLocalConfig(cwd);
   return mergeConfigs(global, local);
@@ -147,7 +149,7 @@ function createDemoAdapter(provider, model) {
           ].join(" ");
           for (const chunk of reply.match(/.{1,18}/g) ?? []) {
             if (cancelled) return;
-            await new Promise((resolve2) => setTimeout(resolve2, 35));
+            await new Promise((resolve4) => setTimeout(resolve4, 35));
             yield { type: "text", content: chunk };
           }
           yield { type: "done" };
@@ -198,87 +200,13 @@ function resolveChatProvider(options) {
     summary: `${entry.label} live adapter`
   };
 }
-var skillRegistry = {
-  researcher: skills.researcher,
-  coder: skills.coder,
-  planner: skills.planner,
-  critic: skills.critic,
-  summarizer: skills.summarizer
-};
-function instantiate(kind) {
-  switch (kind) {
-    case "web_search":
-      return [tools.webSearch()];
-    case "fetch_url":
-      return [tools.fetchUrl()];
-    case "filesystem":
-      return tools.filesystem({ basePath: process.cwd() });
-    case "shell":
-      return [tools.shell({ timeout: 3e4 })];
-  }
-}
-function gateTool(tool) {
-  if (tool.requiresConfirmation === false) return tool;
-  return { ...tool, requiresConfirmation: true };
-}
-function resolveTools(toolNames) {
-  if (!toolNames) {
-    return [...instantiate("web_search"), ...instantiate("fetch_url")].map(gateTool);
-  }
-  const tools = [];
-  for (const name of toolNames.split(",").map((s) => s.trim()).filter(Boolean)) {
-    switch (name) {
-      case "web_search":
-      case "fetch_url":
-      case "filesystem":
-      case "shell":
-        tools.push(...instantiate(name));
-        break;
-      default:
-        process.stderr.write(`Unknown tool: ${name}
-`);
-    }
-  }
-  return tools;
-}
-function resolveSkill(skillName) {
-  if (!skillName) return void 0;
-  const skill = skillRegistry[skillName.trim()];
-  if (!skill) {
-    process.stderr.write(`Unknown skill: ${skillName}
-`);
-    return void 0;
-  }
-  return skill;
-}
-function resolveSkills(skillNames) {
-  if (!skillNames) return void 0;
-  const names = skillNames.split(",").map((s) => s.trim());
-  const resolved = names.map((n) => skillRegistry[n]).filter(Boolean);
-  if (resolved.length === 0) {
-    process.stderr.write(`No valid skills found in: ${skillNames}
-`);
-    return void 0;
-  }
-  if (resolved.length === 1) return resolved[0];
-  return skills.composeSkills(...resolved);
-}
-function resolveMemory(backend, memoryPath) {
-  switch (backend) {
-    case "sqlite":
-      return memory.sqliteChatMemory({ path: memoryPath.replace(/\.json$/, ".db") });
-    case "file":
-    default:
-      return memory.fileChatMemory(memoryPath);
-  }
-}
-var ROOT = path3.join(os.homedir(), ".agentskit", "sessions");
+var ROOT = path.join(os.homedir(), ".agentskit", "sessions");
 var META_SUFFIX = ".meta.json";
 function cwdHash(cwd = process.cwd()) {
   return crypto.createHash("sha256").update(cwd).digest("hex").slice(0, 12);
 }
 function dirFor(cwd = process.cwd()) {
-  return path3.join(ROOT, cwdHash(cwd));
+  return path.join(ROOT, cwdHash(cwd));
 }
 function ensureDir(dir) {
   if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
@@ -290,16 +218,16 @@ function generateSessionId() {
 }
 function sessionFilePath(id, cwd = process.cwd()) {
   ensureDir(dirFor(cwd));
-  return path3.join(dirFor(cwd), `${id}.json`);
+  return path.join(dirFor(cwd), `${id}.json`);
 }
 function metaPath(id, cwd = process.cwd()) {
-  return path3.join(dirFor(cwd), `${id}${META_SUFFIX}`);
+  return path.join(dirFor(cwd), `${id}${META_SUFFIX}`);
 }
 function readMeta(id, cwd = process.cwd()) {
-  const path4 = metaPath(id, cwd);
-  if (!fs.existsSync(path4)) return null;
+  const path5 = metaPath(id, cwd);
+  if (!fs.existsSync(path5)) return null;
   try {
-    return JSON.parse(fs.readFileSync(path4, "utf8"));
+    return JSON.parse(fs.readFileSync(path5, "utf8"));
   } catch {
     return null;
   }
@@ -323,7 +251,7 @@ function listSessions(cwd = process.cwd()) {
     if (!entry.endsWith(".json") || entry.endsWith(META_SUFFIX)) continue;
     const id = entry.replace(/\.json$/, "");
     const meta = readMeta(id, cwd);
-    const file = path3.join(dir, entry);
+    const file = path.join(dir, entry);
     if (meta) {
       records.push({ metadata: meta, file });
     } else {
@@ -349,11 +277,41 @@ function findLatestSession(cwd = process.cwd()) {
   return all[0] ?? null;
 }
 function findSession(id, cwd = process.cwd()) {
-  const exact = listSessions(cwd).find((s) => s.metadata.id === id);
+  const all = listSessions(cwd);
+  const exact = all.find((s) => s.metadata.id === id || s.metadata.label === id);
   if (exact) return exact;
-  const prefix = listSessions(cwd).find((s) => s.metadata.id.startsWith(id));
+  const prefix = all.find((s) => s.metadata.id.startsWith(id));
   return prefix ?? null;
 }
+function renameSession(id, label, cwd = process.cwd()) {
+  const record = findSession(id, cwd);
+  if (!record) throw new Error(`No session matching "${id}".`);
+  const next = { ...record.metadata, label, updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
+  writeSessionMeta(next, cwd);
+  return next;
+}
+function forkSession(id, cwd = process.cwd()) {
+  const record = findSession(id, cwd);
+  if (!record) throw new Error(`No session matching "${id}".`);
+  const newId = generateSessionId();
+  const newFile = sessionFilePath(newId, cwd);
+  if (fs.existsSync(record.file)) {
+    fs.writeFileSync(newFile, fs.readFileSync(record.file, "utf8"));
+  }
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  writeSessionMeta(
+    {
+      ...record.metadata,
+      id: newId,
+      createdAt: now,
+      updatedAt: now,
+      forkedFrom: record.metadata.id,
+      label: void 0
+    },
+    cwd
+  );
+  return { id: newId, file: newFile, isNew: true };
+}
 function resolveSession(input2) {
   const cwd = input2.cwd ?? process.cwd();
   if (input2.explicitPath) {
@@ -379,6 +337,40 @@ function resolveSession(input2) {
   return { id, file: sessionFilePath(id, cwd), isNew: true };
 }
 
+// src/extensibility/telemetry/pricing.ts
+var builtinPricing = {
+  "gpt-4o": { inputPerM: 2.5, outputPerM: 10 },
+  "gpt-4o-mini": { inputPerM: 0.15, outputPerM: 0.6 },
+  "gpt-4.1": { inputPerM: 2, outputPerM: 8 },
+  "gpt-4.1-mini": { inputPerM: 0.4, outputPerM: 1.6 },
+  "claude-opus-4": { inputPerM: 15, outputPerM: 75 },
+  "claude-sonnet-4": { inputPerM: 3, outputPerM: 15 },
+  "claude-haiku-4": { inputPerM: 0.8, outputPerM: 4 },
+  "gemini-2.5-pro": { inputPerM: 1.25, outputPerM: 10 },
+  "gemini-2.5-flash": { inputPerM: 0.3, outputPerM: 2.5 }
+};
+var customPricing = {};
+function getPricing(model) {
+  if (!model) return void 0;
+  if (customPricing[model]) return customPricing[model];
+  if (builtinPricing[model]) return builtinPricing[model];
+  const short = model.includes("/") ? model.split("/").pop() : model;
+  return customPricing[short] ?? builtinPricing[short];
+}
+function computeCost(model, usage) {
+  if (!model) return void 0;
+  const pricing = getPricing(model);
+  if (!pricing) return void 0;
+  const inputUsd = usage.promptTokens / 1e6 * pricing.inputPerM;
+  const outputUsd = usage.completionTokens / 1e6 * pricing.outputPerM;
+  return {
+    model,
+    inputUsd,
+    outputUsd,
+    totalUsd: inputUsd + outputUsd
+  };
+}
+
 // src/slash-commands.ts
 function parseSlashCommand(input2) {
   if (!input2.startsWith("/")) return null;
@@ -501,6 +493,89 @@ ${lines.join("\n")}`, "info");
       ctx.feedback("History cleared.", "success");
     }
   },
+  {
+    name: "usage",
+    description: "Show the cumulative token usage for this session.",
+    run(ctx) {
+      const usage = ctx.chat.usage;
+      if (!usage || usage.totalTokens === 0) {
+        ctx.feedback("No usage reported yet for this session.", "info");
+        return;
+      }
+      ctx.feedback(
+        `Tokens \u2014 prompt=${usage.promptTokens}  completion=${usage.completionTokens}  total=${usage.totalTokens}`,
+        "info"
+      );
+    }
+  },
+  {
+    name: "cost",
+    description: "Estimate the cost so far for the current model.",
+    run(ctx) {
+      const usage = ctx.chat.usage;
+      const model = ctx.runtime.model;
+      if (!usage || usage.totalTokens === 0) {
+        ctx.feedback("No usage reported yet for this session.", "info");
+        return;
+      }
+      const cost = computeCost(model, usage);
+      if (!cost) {
+        ctx.feedback(
+          `No pricing registered for model "${model ?? "unset"}". Register with registerPricing() or provide a known model name.`,
+          "warn"
+        );
+        return;
+      }
+      ctx.feedback(
+        `$${cost.totalUsd.toFixed(4)} total (in=$${cost.inputUsd.toFixed(4)}  out=$${cost.outputUsd.toFixed(4)}  model=${cost.model})`,
+        "info"
+      );
+    }
+  },
+  {
+    name: "rename",
+    description: "Attach a human-readable label to the current session.",
+    usage: "/rename <label>",
+    run(ctx, args) {
+      const label = args.trim();
+      const sessionId = ctx.runtime.sessionId;
+      if (!sessionId || sessionId === "custom") {
+        ctx.feedback("Rename is only available for managed sessions.", "warn");
+        return;
+      }
+      if (!label) {
+        ctx.feedback("Usage: /rename <label>", "warn");
+        return;
+      }
+      try {
+        renameSession(sessionId, label);
+        ctx.feedback(`Session labeled "${label}".`, "success");
+      } catch (err) {
+        ctx.feedback(`/rename failed: ${err instanceof Error ? err.message : String(err)}`, "error");
+      }
+    }
+  },
+  {
+    name: "fork",
+    description: "Branch a copy of the current session. Does not switch to it.",
+    run(ctx) {
+      const sessionId = ctx.runtime.sessionId;
+      if (!sessionId || sessionId === "custom") {
+        ctx.feedback("Fork is only available for managed sessions.", "warn");
+        return;
+      }
+      try {
+        const result = forkSession(sessionId);
+        ctx.feedback(
+          `Forked into ${result.id}. Resume with:
+  agentskit chat --resume ${result.id}`,
+          "success"
+        );
+      } catch (err) {
+        ctx.feedback(`/fork failed: ${err instanceof Error ? err.message : String(err)}`, "error");
+      }
+    }
+  },
   {
     name: "exit",
     aliases: ["quit", "q"],
@@ -510,57 +585,160 @@ ${lines.join("\n")}`, "info");
     }
   }
 ];
-function groupIntoTurns(messages) {
-  const turns = [];
-  let current = [];
-  for (const message of messages) {
-    if (message.role === "user") {
-      if (current.length > 0) turns.push(current);
-      current = [message];
-    } else if (message.role === "system") {
-      if (current.length > 0) turns.push(current);
-      turns.push([message]);
-      current = [];
-    } else {
-      current.push(message);
+var skillRegistry = {
+  researcher: skills.researcher,
+  coder: skills.coder,
+  planner: skills.planner,
+  critic: skills.critic,
+  summarizer: skills.summarizer
+};
+function instantiate(kind) {
+  switch (kind) {
+    case "web_search":
+      return [tools.webSearch()];
+    case "fetch_url":
+      return [tools.fetchUrl()];
+    case "filesystem":
+      return tools.filesystem({ basePath: process.cwd() });
+    case "shell":
+      return [tools.shell({ timeout: 3e4 })];
+  }
+}
+function gateTool(tool) {
+  if (tool.requiresConfirmation === false) return tool;
+  return { ...tool, requiresConfirmation: true };
+}
+function resolveTools(toolNames) {
+  if (!toolNames) {
+    return [...instantiate("web_search"), ...instantiate("fetch_url")].map(gateTool);
+  }
+  const tools = [];
+  for (const name of toolNames.split(",").map((s) => s.trim()).filter(Boolean)) {
+    switch (name) {
+      case "web_search":
+      case "fetch_url":
+      case "filesystem":
+      case "shell":
+        tools.push(...instantiate(name));
+        break;
+      default:
+        process.stderr.write(`Unknown tool: ${name}
+`);
     }
   }
-  if (current.length > 0) turns.push(current);
-  return turns;
+  return tools;
 }
-function ChatApp(options) {
-  const [provider, setProvider] = React3.useState(options.provider);
-  const [model, setModel] = React3.useState(options.model);
-  const [apiKey, setApiKey] = React3.useState(options.apiKey);
-  const [baseUrl, setBaseUrl] = React3.useState(options.baseUrl);
-  const [toolsFlag, setToolsFlag] = React3.useState(options.tools);
-  const [skillFlag, setSkillFlag] = React3.useState(options.skill);
-  const runtime = React3.useMemo(
+function resolveSkill(skillName) {
+  if (!skillName) return void 0;
+  const skill = skillRegistry[skillName.trim()];
+  if (!skill) {
+    process.stderr.write(`Unknown skill: ${skillName}
+`);
+    return void 0;
+  }
+  return skill;
+}
+function resolveSkills(skillNames) {
+  if (!skillNames) return void 0;
+  const names = skillNames.split(",").map((s) => s.trim());
+  const resolved = names.map((n) => skillRegistry[n]).filter(Boolean);
+  if (resolved.length === 0) {
+    process.stderr.write(`No valid skills found in: ${skillNames}
+`);
+    return void 0;
+  }
+  if (resolved.length === 1) return resolved[0];
+  return skills.composeSkills(...resolved);
+}
+function resolveMemory(backend, memoryPath) {
+  switch (backend) {
+    case "sqlite":
+      return memory.sqliteChatMemory({ path: memoryPath.replace(/\.json$/, ".db") });
+    case "file":
+    default:
+      return memory.fileChatMemory(memoryPath);
+  }
+}
+
+// src/extensibility/permissions/policy.ts
+function evaluatePolicy(policy, toolName) {
+  if (policy.mode === "bypassPermissions") return "allow";
+  if (policy.mode === "plan") return "ask";
+  for (const rule of policy.rules) {
+    if (matchesRule(rule, toolName)) return rule.action;
+  }
+  if (policy.mode === "acceptEdits" && /^(fs_write|edit|write_file)/.test(toolName)) {
+    return "allow";
+  }
+  return "ask";
+}
+function matchesRule(rule, toolName) {
+  if (rule.tool instanceof RegExp) return rule.tool.test(toolName);
+  const str = rule.tool;
+  if (str.startsWith("re:")) return new RegExp(str.slice(3)).test(toolName);
+  return str === toolName;
+}
+function applyPolicyToTool(policy, tool) {
+  const action = evaluatePolicy(policy, tool.name);
+  if (action === "deny") return null;
+  if (action === "allow") return { ...tool, requiresConfirmation: false };
+  return { ...tool, requiresConfirmation: true };
+}
+function applyPolicyToTools(policy, tools) {
+  const out = [];
+  for (const tool of tools) {
+    const gated = applyPolicyToTool(policy, tool);
+    if (gated) out.push(gated);
+  }
+  return out;
+}
+
+// src/runtime/use-runtime.ts
+function useRuntime(options) {
+  const [provider, setProvider] = React2.useState(options.provider);
+  const [model, setModel] = React2.useState(options.model);
+  const [apiKey, setApiKey] = React2.useState(options.apiKey);
+  const [baseUrl, setBaseUrl] = React2.useState(options.baseUrl);
+  const [toolsFlag, setToolsFlag] = React2.useState(options.tools);
+  const [skillFlag, setSkillFlag] = React2.useState(options.skill);
+  const runtime = React2.useMemo(
     () => resolveChatProvider({ provider, model, apiKey, baseUrl }),
     [provider, model, apiKey, baseUrl]
   );
-  const memory = React3.useMemo(
+  const memory = React2.useMemo(
     () => resolveMemory(options.memoryBackend, options.memoryPath ?? ".agentskit-history.json"),
     [options.memoryPath, options.memoryBackend]
   );
-  const tools = React3.useMemo(() => resolveTools(toolsFlag), [toolsFlag]);
-  const skills = React3.useMemo(() => {
+  const tools = React2.useMemo(() => {
+    const resolved = resolveTools(toolsFlag);
+    if (!options.permissionPolicy) return resolved;
+    return applyPolicyToTools(options.permissionPolicy, resolved);
+  }, [toolsFlag, options.permissionPolicy]);
+  const skills = React2.useMemo(() => {
     if (!skillFlag) return void 0;
     const names = skillFlag.split(",").map((s) => s.trim());
     const resolved = names.map((n) => skillRegistry[n]).filter(Boolean);
     if (resolved.length === 0) return void 0;
     return resolved;
   }, [skillFlag]);
-  const chat = ink$1.useChat({
-    adapter: runtime.adapter,
+  return {
+    runtime,
     memory,
-    systemPrompt: options.system,
-    tools: tools.length > 0 ? tools : void 0,
-    skills
-  });
-  const [sessionAllowed, setSessionAllowed] = React3.useState(/* @__PURE__ */ new Set());
-  const autoApprovedRef = React3.useRef(/* @__PURE__ */ new Set());
-  React3.useEffect(() => {
+    tools,
+    skills,
+    state: { provider, model, apiKey, baseUrl, toolsFlag, skillFlag },
+    setProvider,
+    setModel,
+    setApiKey,
+    setBaseUrl,
+    setToolsFlag,
+    setSkillFlag
+  };
+}
+function useToolPermissions(chat) {
+  const [sessionAllowed, setSessionAllowed] = React2.useState(/* @__PURE__ */ new Set());
+  const autoApprovedRef = React2.useRef(/* @__PURE__ */ new Set());
+  React2.useEffect(() => {
     if (sessionAllowed.size === 0) return;
     for (const message of chat.messages) {
       for (const call of message.toolCalls ?? []) {
@@ -581,10 +759,21 @@ function ChatApp(options) {
     autoApprovedRef.current.add(toolCallId);
     void chat.approve(toolCallId);
   };
-  const sessionCreatedAtRef = React3.useRef(void 0);
-  const messageCount = chat.messages.length;
-  const firstUserContent = chat.messages.find((m) => m.role === "user")?.content ?? "";
-  React3.useEffect(() => {
+  const awaitingConfirmation = React2.useMemo(
+    () => chat.messages.some(
+      (message) => message.toolCalls?.some(
+        (call) => call.status === "requires_confirmation" && !sessionAllowed.has(call.name)
+      )
+    ),
+    [chat.messages, sessionAllowed]
+  );
+  return { sessionAllowed, handleApproveAlways, awaitingConfirmation };
+}
+function useSessionMeta(options) {
+  const sessionCreatedAtRef = React2.useRef(void 0);
+  const messageCount = options.messages.length;
+  const firstUserContent = options.messages.find((m) => m.role === "user")?.content ?? "";
+  React2.useEffect(() => {
     const sessionId = options.sessionId;
     if (!sessionId || sessionId === "custom") return;
     if (!sessionCreatedAtRef.current) {
@@ -597,24 +786,211 @@ function ChatApp(options) {
         createdAt: sessionCreatedAtRef.current,
         updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
         messageCount,
-        preview: derivePreview(chat.messages),
-        provider: runtime.provider,
-        model: runtime.model
+        preview: derivePreview(options.messages),
+        provider: options.provider,
+        model: options.model
       });
     } catch {
     }
-  }, [options.sessionId, messageCount, firstUserContent, runtime.provider, runtime.model]);
-  const turns = React3.useMemo(() => groupIntoTurns(chat.messages), [chat.messages]);
-  const toolNames = toolsFlag ? toolsFlag.split(",").map((s) => s.trim()).filter(Boolean) : [];
-  const [feedback, setFeedback] = React3.useState(null);
-  const slashCommands = React3.useMemo(
-    () => [...builtinSlashCommands, ...options.slashCommands ?? []],
-    [options.slashCommands]
-  );
-  const slashRegistry = React3.useMemo(() => createSlashRegistry(slashCommands), [slashCommands]);
-  const handleSubmitInput = async (raw) => {
+  }, [options.sessionId, messageCount, firstUserContent, options.provider, options.model]);
+}
+
+// src/extensibility/hooks/runner.ts
+var HookDispatcher = class {
+  constructor(handlers = [], onError = (_h, err) => process.stderr.write(
+    `[agentskit] hook error: ${err instanceof Error ? err.message : String(err)}
+`
+  )) {
+    this.onError = onError;
+    this.handlers = /* @__PURE__ */ new Map();
+    for (const handler of handlers) this.register(handler);
+  }
+  register(handler) {
+    const list = this.handlers.get(handler.event) ?? [];
+    list.push(handler);
+    this.handlers.set(handler.event, list);
+  }
+  async dispatch(event, payload) {
+    const list = this.handlers.get(event) ?? [];
+    let current = { ...payload, event };
+    for (const handler of list) {
+      if (!this.matches(handler, current)) continue;
+      let result;
+      try {
+        result = await handler.run(current);
+      } catch (err) {
+        this.onError(handler, err);
+        continue;
+      }
+      if (result.decision === "block") {
+        return { payload: current, blocked: true, reason: result.reason };
+      }
+      if (result.decision === "modify") {
+        current = { ...result.payload, event };
+      }
+    }
+    return { payload: current, blocked: false };
+  }
+  matches(handler, payload) {
+    if (!handler.matcher) return true;
+    if (typeof handler.matcher === "function") return handler.matcher(payload);
+    return handler.matcher.test(String(payload.tool ?? payload.prompt ?? ""));
+  }
+};
+function configHooksToHandlers(config) {
+  if (!config) return [];
+  const handlers = [];
+  for (const [event, entries] of Object.entries(config)) {
+    for (const entry of entries) {
+      handlers.push({
+        event,
+        matcher: entry.matcher ? new RegExp(entry.matcher) : void 0,
+        run: (payload) => runShellHook(entry, payload)
+      });
+    }
+  }
+  return handlers;
+}
+function runShellHook(entry, payload) {
+  return new Promise((resolvePromise) => {
+    const timeoutMs = entry.timeout ?? 5e3;
+    const child = child_process.spawn("sh", ["-c", entry.run], {
+      stdio: ["pipe", "pipe", "inherit"]
+    });
+    let stdout = "";
+    child.stdout.on("data", (chunk) => {
+      stdout += chunk.toString();
+    });
+    const timer = setTimeout(() => {
+      child.kill("SIGTERM");
+    }, timeoutMs);
+    child.on("close", (code) => {
+      clearTimeout(timer);
+      if (code !== 0) {
+        resolvePromise({
+          decision: "block",
+          reason: `shell hook exited with code ${code}`
+        });
+        return;
+      }
+      const trimmed = stdout.trim();
+      if (!trimmed) {
+        resolvePromise({ decision: "continue" });
+        return;
+      }
+      try {
+        const parsed = JSON.parse(trimmed);
+        resolvePromise(parsed);
+      } catch {
+        resolvePromise({ decision: "continue" });
+      }
+    });
+    child.on("error", (err) => {
+      clearTimeout(timer);
+      resolvePromise({ decision: "block", reason: err.message });
+    });
+    try {
+      child.stdin.write(JSON.stringify(payload));
+      child.stdin.end();
+    } catch {
+    }
+  });
+}
+function groupIntoTurns(messages) {
+  const turns = [];
+  let current = [];
+  for (const message of messages) {
+    if (message.role === "user") {
+      if (current.length > 0) turns.push(current);
+      current = [message];
+    } else if (message.role === "system") {
+      if (current.length > 0) turns.push(current);
+      turns.push([message]);
+      current = [];
+    } else {
+      current.push(message);
+    }
+  }
+  if (current.length > 0) turns.push(current);
+  return turns;
+}
+function ChatApp(options) {
+  const {
+    runtime,
+    memory,
+    tools,
+    skills,
+    state: { baseUrl, toolsFlag, skillFlag },
+    setProvider,
+    setModel,
+    setApiKey,
+    setBaseUrl,
+    setToolsFlag,
+    setSkillFlag
+  } = useRuntime(options);
+  const mergedTools = React2.useMemo(() => {
+    const extra = options.extraTools ?? [];
+    return [...tools, ...extra];
+  }, [tools, options.extraTools]);
+  const mergedSkills = React2.useMemo(() => {
+    const extra = options.extraSkills ?? [];
+    if (!skills && extra.length === 0) return void 0;
+    return [...skills ?? [], ...extra];
+  }, [skills, options.extraSkills]);
+  const chat = ink$1.useChat({
+    adapter: runtime.adapter,
+    memory,
+    systemPrompt: options.system,
+    tools: mergedTools.length > 0 ? mergedTools : void 0,
+    skills: mergedSkills
+  });
+  const { sessionAllowed, handleApproveAlways, awaitingConfirmation } = useToolPermissions(chat);
+  useSessionMeta({
+    sessionId: options.sessionId,
+    messages: chat.messages,
+    provider: runtime.provider,
+    model: runtime.model
+  });
+  const turns = React2.useMemo(() => groupIntoTurns(chat.messages), [chat.messages]);
+  const toolNames = toolsFlag ? toolsFlag.split(",").map((s) => s.trim()).filter(Boolean) : [];
+  const [feedback, setFeedback] = React2.useState(null);
+  const hookDispatcher = React2.useMemo(
+    () => new HookDispatcher(options.hookHandlers ?? []),
+    [options.hookHandlers]
+  );
+  React2.useEffect(() => {
+    void hookDispatcher.dispatch("SessionStart", {
+      event: "SessionStart",
+      sessionId: options.sessionId,
+      provider: runtime.provider,
+      model: runtime.model
+    });
+    return () => {
+      void hookDispatcher.dispatch("SessionEnd", {
+        event: "SessionEnd",
+        sessionId: options.sessionId
+      });
+    };
+  }, [hookDispatcher]);
+  const slashCommands = React2.useMemo(
+    () => [...builtinSlashCommands, ...options.slashCommands ?? []],
+    [options.slashCommands]
+  );
+  const slashRegistry = React2.useMemo(() => createSlashRegistry(slashCommands), [slashCommands]);
+  const handleSubmitInput = async (raw) => {
     const parsed = parseSlashCommand(raw);
     if (!parsed) {
+      const hookResult = await hookDispatcher.dispatch("UserPromptSubmit", {
+        event: "UserPromptSubmit",
+        prompt: raw
+      });
+      if (hookResult.blocked) {
+        setFeedback({
+          message: `Prompt blocked: ${hookResult.reason ?? "hook refused"}`,
+          kind: "warn"
+        });
+        return true;
+      }
       setFeedback(null);
       return false;
     }
@@ -634,7 +1010,8 @@ function ChatApp(options) {
         mode: runtime.mode,
         baseUrl,
         tools: toolsFlag,
-        skill: skillFlag
+        skill: skillFlag,
+        sessionId: options.sessionId
       },
       setProvider,
       setModel,
@@ -653,14 +1030,6 @@ function ChatApp(options) {
     }
     return true;
   };
-  const awaitingConfirmation = React3.useMemo(
-    () => chat.messages.some(
-      (message) => message.toolCalls?.some(
-        (call) => call.status === "requires_confirmation" && !sessionAllowed.has(call.name)
-      )
-    ),
-    [chat.messages, sessionAllowed]
-  );
   return /* @__PURE__ */ jsxRuntime.jsxs(ink.Box, { flexDirection: "column", gap: 1, children: [
     /* @__PURE__ */ jsxRuntime.jsx(
       ink$1.StatusHeader,
@@ -751,605 +1120,363 @@ function renderChatHeader(options) {
   if (options.memoryBackend) parts.push(`memory=${options.memoryBackend}`);
   return parts.join(" ");
 }
-var PROVIDER_IMPORT = {
-  openai: "openai",
-  anthropic: "anthropic",
-  gemini: "gemini",
-  ollama: "ollama"
-};
-var PROVIDER_DEFAULT_MODEL = {
-  openai: "gpt-4o-mini",
-  anthropic: "claude-sonnet-4-6",
-  gemini: "gemini-2.5-flash",
-  ollama: "llama3.1",
-  demo: "demo"
-};
-var PROVIDER_ENV_KEY = {
-  openai: "OPENAI_API_KEY",
-  anthropic: "ANTHROPIC_API_KEY",
-  gemini: "GEMINI_API_KEY",
-  ollama: null,
-  demo: null
-};
-function adapterCall(provider, prefix = "process.env") {
-  const model = PROVIDER_DEFAULT_MODEL[provider];
-  if (provider === "demo") return `demoAdapter()`;
-  if (provider === "ollama") return `ollama({ model: '${model}' })`;
-  const envKey = PROVIDER_ENV_KEY[provider];
-  return `${PROVIDER_IMPORT[provider]}({ apiKey: ${prefix}.${envKey} ?? '', model: '${model}' })`;
-}
-function viteAdapterCall(provider) {
-  if (provider === "demo") return `demoAdapter()`;
-  if (provider === "ollama") return `ollama({ model: '${PROVIDER_DEFAULT_MODEL[provider]}' })`;
-  const envKey = PROVIDER_ENV_KEY[provider];
-  return `${PROVIDER_IMPORT[provider]}({ apiKey: import.meta.env.VITE_${envKey} ?? '', model: '${PROVIDER_DEFAULT_MODEL[provider]}' })`;
-}
-function adapterImport(provider) {
-  if (provider === "demo") return "";
-  return `import { ${PROVIDER_IMPORT[provider]} } from '@agentskit/adapters'
-`;
-}
-function toolImports(tools) {
-  if (tools.length === 0) return "";
-  return `import { ${tools.map((t) => t === "web_search" ? "webSearch" : t).join(", ")} } from '@agentskit/tools'
-`;
+
+// src/commands/shared.ts
+function mergeWithConfig(options, config) {
+  if (!config) return options;
+  const d = config.defaults ?? {};
+  const resolvedApiKey = options.apiKey ?? (d.apiKeyEnv ? process.env[d.apiKeyEnv] : void 0) ?? d.apiKey;
+  return {
+    ...options,
+    provider: options.provider !== "demo" ? options.provider : d.provider ?? options.provider,
+    model: options.model ?? d.model,
+    apiKey: resolvedApiKey,
+    baseUrl: options.baseUrl ?? d.baseUrl,
+    tools: options.tools ?? d.tools,
+    skill: options.skill ?? d.skill,
+    system: options.system ?? d.system,
+    memoryBackend: options.memoryBackend ?? d.memoryBackend
+  };
 }
-function toolList(tools) {
-  if (tools.length === 0) return "[]";
-  const calls = tools.map((t) => {
-    if (t === "web_search") return "webSearch()";
-    if (t === "filesystem") return `...filesystem({ basePath: './workspace' })`;
-    if (t === "shell") return `shell({ allowedCommands: ['ls', 'cat'] })`;
-    return "";
-  });
-  return `[${calls.join(", ")}]`;
+async function loadPlugins(options = {}) {
+  const {
+    specs = [],
+    pluginDirs = [],
+    cwd = process.cwd(),
+    autoDiscoverUserDir = true,
+    onError = (spec, err) => process.stderr.write(
+      `[agentskit] plugin "${spec}" failed to load: ${err instanceof Error ? err.message : String(err)}
+`
+    ),
+    log = () => {
+    }
+  } = options;
+  const resolvedSpecs = [...specs];
+  const discoveryDirs = [...pluginDirs];
+  if (autoDiscoverUserDir) discoveryDirs.push(path.join(os.homedir(), ".agentskit", "plugins"));
+  for (const dir of discoveryDirs) {
+    const discovered = await discoverPluginsInDir(dir);
+    resolvedSpecs.push(...discovered);
+  }
+  const plugins = [];
+  for (const spec of resolvedSpecs) {
+    try {
+      const plugin = await loadPluginFromSpec(spec, cwd, log);
+      if (plugin) plugins.push(plugin);
+    } catch (err) {
+      onError(spec, err);
+    }
+  }
+  return mergePluginsIntoBundle(plugins);
 }
-function memoryImport(memory) {
-  if (memory === "file") return `import { fileChatMemory } from '@agentskit/memory'
-`;
-  if (memory === "sqlite") return `import { sqliteChatMemory } from '@agentskit/memory'
-`;
-  return "";
+async function discoverPluginsInDir(dir) {
+  try {
+    const entries = await promises.readdir(dir);
+    const absolutes = entries.filter((name) => /\.(m?js|ts)$/i.test(name)).map((name) => path.join(dir, name));
+    const validated = [];
+    for (const p of absolutes) {
+      try {
+        const s = await promises.stat(p);
+        if (s.isFile()) validated.push(p);
+      } catch {
+      }
+    }
+    return validated;
+  } catch {
+    return [];
+  }
 }
-function memoryCall(memory) {
-  if (memory === "file") return `fileChatMemory('./.agentskit-history.json')`;
-  if (memory === "sqlite") return `sqliteChatMemory({ path: './.agentskit-history.db' })`;
-  return "undefined";
+async function loadPluginFromSpec(spec, cwd, log) {
+  const isPath = spec.startsWith("./") || spec.startsWith("../") || path.isAbsolute(spec);
+  const importTarget = isPath ? url.pathToFileURL(path.resolve(cwd, spec)).href : spec;
+  const mod = await import(importTarget);
+  const exported = mod.default ?? mod.plugin ?? mod;
+  const sourcePath = isPath ? path.resolve(cwd, spec) : void 0;
+  const ctx = {
+    cwd,
+    sourcePath,
+    log: (msg) => log(`[${spec}] ${msg}`)
+  };
+  if (typeof exported === "function") {
+    const factory = exported;
+    return await factory(ctx);
+  }
+  if (exported && typeof exported === "object" && "name" in exported) {
+    const plugin = exported;
+    if (plugin.init) await plugin.init(ctx);
+    return plugin;
+  }
+  throw new Error(
+    "Module did not export a Plugin \u2014 expected default export to be a Plugin object or a PluginFactory function."
+  );
 }
-function demoAdapterSnippet() {
-  return `function demoAdapter() {
-  return {
-    createSource: () => ({
-      stream: async function* () {
-        yield { type: 'text' as const, content: 'Hello from your AgentsKit starter. ' }
-        yield { type: 'text' as const, content: 'Configure a real adapter to talk to a model.' }
-        yield { type: 'done' as const }
-      },
-      abort: () => {},
-    }),
+function mergePluginsIntoBundle(plugins) {
+  const bundle = {
+    plugins,
+    slashCommands: [],
+    tools: [],
+    skills: [],
+    providers: {},
+    hooks: [],
+    mcpServers: []
+  };
+  for (const plugin of plugins) {
+    if (plugin.slashCommands) bundle.slashCommands.push(...plugin.slashCommands);
+    if (plugin.tools) bundle.tools.push(...plugin.tools);
+    if (plugin.skills) bundle.skills.push(...plugin.skills);
+    if (plugin.hooks) bundle.hooks.push(...plugin.hooks);
+    if (plugin.mcpServers) bundle.mcpServers.push(...plugin.mcpServers);
+    if (plugin.providers) {
+      for (const [name, factory] of Object.entries(plugin.providers)) {
+        bundle.providers[name] = factory;
+      }
+    }
   }
+  return bundle;
 }
+var McpClient = class {
+  constructor(spec, onError = (err) => process.stderr.write(
+    `[agentskit] mcp[${spec.name}] error: ${err instanceof Error ? err.message : String(err)}
+`
+  )) {
+    this.spec = spec;
+    this.onError = onError;
+    this.buffer = "";
+    this.nextId = 1;
+    this.pending = /* @__PURE__ */ new Map();
+    this.disposed = false;
+  }
+  async start() {
+    if (this.child) return;
+    const child = child_process.spawn(this.spec.command, this.spec.args ?? [], {
+      env: { ...process.env, ...this.spec.env ?? {} },
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    this.child = child;
+    child.stdout.on("data", (chunk) => this.onStdout(chunk.toString()));
+    child.stderr.on("data", (chunk) => {
+      process.stderr.write(`[mcp ${this.spec.name}] ${chunk}`);
+    });
+    child.on("error", (err) => this.onError(err));
+    child.on("close", () => {
+      this.disposed = true;
+      for (const pending of this.pending.values()) {
+        pending({ jsonrpc: "2.0", id: 0, error: { code: -1, message: "server closed" } });
+      }
+      this.pending.clear();
+    });
+    await this.request("initialize", {
+      protocolVersion: "2024-11-05",
+      capabilities: {},
+      clientInfo: { name: "agentskit", version: "0" }
+    });
+  }
+  async listTools() {
+    const res = await this.request("tools/list", {});
+    const tools = res.tools ?? [];
+    return tools;
+  }
+  async callTool(name, args) {
+    return await this.request("tools/call", { name, arguments: args });
+  }
+  dispose() {
+    if (this.disposed) return;
+    this.disposed = true;
+    this.child?.kill("SIGTERM");
+  }
+  request(method, params) {
+    return new Promise((resolvePromise, rejectPromise) => {
+      if (!this.child || this.disposed) {
+        rejectPromise(new Error(`mcp server ${this.spec.name} not running`));
+        return;
+      }
+      const id = this.nextId++;
+      const timeoutMs = this.spec.timeout ?? 1e4;
+      const timer = setTimeout(() => {
+        this.pending.delete(id);
+        rejectPromise(new Error(`mcp ${this.spec.name}.${method} timed out`));
+      }, timeoutMs);
+      this.pending.set(id, (res) => {
+        clearTimeout(timer);
+        if (res.error) {
+          rejectPromise(new Error(`mcp ${method} failed: ${res.error.message}`));
+          return;
+        }
+        resolvePromise(res.result);
+      });
+      const message = JSON.stringify({ jsonrpc: "2.0", id, method, params }) + "\n";
+      this.child.stdin.write(message);
+    });
+  }
+  onStdout(chunk) {
+    this.buffer += chunk;
+    let newlineIndex = this.buffer.indexOf("\n");
+    while (newlineIndex !== -1) {
+      const line = this.buffer.slice(0, newlineIndex).trim();
+      this.buffer = this.buffer.slice(newlineIndex + 1);
+      if (line) {
+        try {
+          const parsed = JSON.parse(line);
+          const pending = this.pending.get(Number(parsed.id));
+          if (pending) {
+            this.pending.delete(Number(parsed.id));
+            pending(parsed);
+          }
+        } catch (err) {
+          this.onError(err);
+        }
+      }
+      newlineIndex = this.buffer.indexOf("\n");
+    }
+  }
+};
 
-`;
+// src/extensibility/mcp/bridge.ts
+async function bridgeMcpServers(specs) {
+  const clients = [];
+  const tools = [];
+  for (const spec of specs) {
+    const client = new McpClient(spec);
+    try {
+      await client.start();
+      const mcpTools = await client.listTools();
+      for (const mcpTool of mcpTools) {
+        tools.push(mcpToolToDefinition(spec.name, client, mcpTool));
+      }
+      clients.push(client);
+    } catch (err) {
+      process.stderr.write(
+        `[agentskit] mcp server "${spec.name}" failed: ${err instanceof Error ? err.message : String(err)}
+`
+      );
+      client.dispose();
+    }
+  }
+  return { clients, tools };
 }
-function reactStarter(ctx) {
-  const deps = {
-    "@agentskit/react": "^0.4.0",
-    react: "^19.0.0",
-    "react-dom": "^19.0.0"
-  };
-  if (ctx.provider !== "demo") deps["@agentskit/adapters"] = "^0.4.0";
-  if (ctx.tools.length > 0) deps["@agentskit/tools"] = "^0.4.0";
-  if (ctx.memory !== "none") deps["@agentskit/memory"] = "^0.4.0";
-  const includesDemo = ctx.provider === "demo";
-  const adapter = ctx.provider === "demo" ? viteAdapterCall(ctx.provider) : viteAdapterCall(ctx.provider);
-  const envKey = PROVIDER_ENV_KEY[ctx.provider];
-  const envContent = envKey ? `VITE_${envKey}=
-` : "# No API key required for the local provider\n";
+function mcpToolToDefinition(serverName, client, tool) {
   return {
-    "package.json": JSON.stringify(
-      {
-        name: path3__default.default.basename(ctx.template === "react" ? "agentskit-react-app" : "agentskit-app"),
-        private: true,
-        type: "module",
-        scripts: {
-          dev: "vite",
-          build: "vite build",
-          preview: "vite preview"
-        },
-        dependencies: deps,
-        devDependencies: {
-          "@types/react": "^19.0.0",
-          "@types/react-dom": "^19.0.0",
-          "@vitejs/plugin-react": "^5.0.0",
-          typescript: "^5.5.0",
-          vite: "^7.0.0"
-        }
-      },
-      null,
-      2
-    ) + "\n",
-    "index.html": `<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>AgentsKit React Starter</title>
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
-  </body>
-</html>
-`,
-    "vite.config.ts": `import { defineConfig } from 'vite'
-import react from '@vitejs/plugin-react'
-
-export default defineConfig({ plugins: [react()] })
-`,
-    "tsconfig.json": JSON.stringify(
-      {
-        compilerOptions: {
-          target: "ES2022",
-          lib: ["ES2022", "DOM"],
-          module: "ESNext",
-          moduleResolution: "bundler",
-          jsx: "react-jsx",
-          strict: true,
-          noEmit: true,
-          skipLibCheck: true
-        },
-        include: ["src"]
-      },
-      null,
-      2
-    ) + "\n",
-    "src/main.tsx": `import React from 'react'
-import ReactDOM from 'react-dom/client'
-import App from './App'
-
-ReactDOM.createRoot(document.getElementById('root')!).render(
-  <React.StrictMode>
-    <App />
-  </React.StrictMode>,
-)
-`,
-    "src/App.tsx": `import { ChatContainer, InputBar, Message, useChat } from '@agentskit/react'
-${adapterImport(ctx.provider)}${toolImports(ctx.tools)}${memoryImport(ctx.memory)}import '@agentskit/react/theme'
-
-${includesDemo ? demoAdapterSnippet() : ""}export default function App() {
-  const chat = useChat({
-    adapter: ${adapter},${ctx.tools.length > 0 ? `
-    tools: ${toolList(ctx.tools)},` : ""}${ctx.memory !== "none" ? `
-    memory: ${memoryCall(ctx.memory)},` : ""}
-  })
-
-  return (
-    <ChatContainer>
-      {chat.messages.map(message => (
-        <Message key={message.id} message={message} />
-      ))}
-      <InputBar chat={chat} />
-    </ChatContainer>
-  )
-}
-`,
-    ".env.example": envContent,
-    ".gitignore": `node_modules
-dist
-.env
-.env.local
-.agentskit-history.*
-`,
-    "README.md": readmeFor(ctx)
-  };
-}
-function inkStarter(ctx) {
-  const deps = {
-    "@agentskit/ink": "^0.4.0",
-    ink: "^7.0.0",
-    react: "^19.0.0"
-  };
-  if (ctx.provider !== "demo") deps["@agentskit/adapters"] = "^0.4.0";
-  if (ctx.tools.length > 0) deps["@agentskit/tools"] = "^0.4.0";
-  if (ctx.memory !== "none") deps["@agentskit/memory"] = "^0.4.0";
-  return {
-    "package.json": JSON.stringify(
-      {
-        name: "agentskit-ink-app",
-        private: true,
-        type: "module",
-        scripts: {
-          dev: "tsx src/index.tsx",
-          start: "tsx src/index.tsx"
-        },
-        dependencies: deps,
-        devDependencies: {
-          "@types/react": "^19.0.0",
-          "@types/react-dom": "^19.0.0",
-          tsx: "^4.20.0",
-          typescript: "^5.5.0"
-        }
-      },
-      null,
-      2
-    ) + "\n",
-    "tsconfig.json": JSON.stringify(
-      {
-        compilerOptions: {
-          target: "ES2022",
-          module: "ESNext",
-          moduleResolution: "bundler",
-          jsx: "react-jsx",
-          strict: true,
-          noEmit: true,
-          skipLibCheck: true
-        },
-        include: ["src"]
-      },
-      null,
-      2
-    ) + "\n",
-    "src/index.tsx": `import React from 'react'
-import { render } from 'ink'
-import { ChatContainer, InputBar, Message, useChat } from '@agentskit/ink'
-${adapterImport(ctx.provider)}${toolImports(ctx.tools)}${memoryImport(ctx.memory)}
-${ctx.provider === "demo" ? demoAdapterSnippet() : ""}function App() {
-  const chat = useChat({
-    adapter: ${adapterCall(ctx.provider)},${ctx.tools.length > 0 ? `
-    tools: ${toolList(ctx.tools)},` : ""}${ctx.memory !== "none" ? `
-    memory: ${memoryCall(ctx.memory)},` : ""}
-  })
-
-  return (
-    <ChatContainer>
-      {chat.messages.map(message => (
-        <Message key={message.id} message={message} />
-      ))}
-      <InputBar chat={chat} />
-    </ChatContainer>
-  )
-}
-
-render(<App />)
-`,
-    ".env.example": PROVIDER_ENV_KEY[ctx.provider] ? `${PROVIDER_ENV_KEY[ctx.provider]}=
-` : "# No API key required for the local provider\n",
-    ".gitignore": `node_modules
-.env
-.env.local
-.agentskit-history.*
-`,
-    "README.md": readmeFor(ctx)
-  };
-}
-function runtimeStarter(ctx) {
-  const deps = {
-    "@agentskit/runtime": "^0.4.0"
-  };
-  if (ctx.provider !== "demo") deps["@agentskit/adapters"] = "^0.4.0";
-  if (ctx.tools.length > 0) deps["@agentskit/tools"] = "^0.4.0";
-  if (ctx.memory !== "none") deps["@agentskit/memory"] = "^0.4.0";
-  return {
-    "package.json": JSON.stringify(
-      {
-        name: "agentskit-runtime-app",
-        private: true,
-        type: "module",
-        scripts: {
-          start: "tsx src/index.ts",
-          dev: "tsx src/index.ts"
-        },
-        dependencies: deps,
-        devDependencies: {
-          tsx: "^4.20.0",
-          typescript: "^5.5.0"
-        }
-      },
-      null,
-      2
-    ) + "\n",
-    "tsconfig.json": JSON.stringify(
-      {
-        compilerOptions: {
-          target: "ES2022",
-          module: "ESNext",
-          moduleResolution: "bundler",
-          strict: true,
-          noEmit: true,
-          skipLibCheck: true
-        },
-        include: ["src"]
-      },
-      null,
-      2
-    ) + "\n",
-    "src/index.ts": `import { createRuntime } from '@agentskit/runtime'
-${adapterImport(ctx.provider)}${toolImports(ctx.tools)}${memoryImport(ctx.memory)}
-${ctx.provider === "demo" ? demoAdapterSnippet() : ""}const runtime = createRuntime({
-  adapter: ${adapterCall(ctx.provider)},${ctx.tools.length > 0 ? `
-  tools: ${toolList(ctx.tools)},` : ""}${ctx.memory !== "none" ? `
-  memory: ${memoryCall(ctx.memory)},` : ""}
-  maxSteps: 10,
-})
-
-const task = process.argv.slice(2).join(' ') || 'Say hello and tell me one fact about TypeScript.'
-const result = await runtime.run(task)
-
-console.log(result.content)
-console.log(\`\\n\u2014 \${result.steps} steps \xB7 \${result.toolCalls.length} tool calls \xB7 \${result.durationMs}ms\`)
-`,
-    ".env.example": PROVIDER_ENV_KEY[ctx.provider] ? `${PROVIDER_ENV_KEY[ctx.provider]}=
-` : "# No API key required for the local provider\n",
-    ".gitignore": `node_modules
-.env
-.env.local
-.agentskit-history.*
-`,
-    "README.md": readmeFor(ctx)
-  };
-}
-function multiAgentStarter(ctx) {
-  const deps = {
-    "@agentskit/runtime": "^0.4.0",
-    "@agentskit/skills": "^0.4.0"
-  };
-  if (ctx.provider !== "demo") deps["@agentskit/adapters"] = "^0.4.0";
-  if (ctx.tools.length === 0) ctx.tools = ["web_search"];
-  deps["@agentskit/tools"] = "^0.4.0";
-  return {
-    "package.json": JSON.stringify(
-      {
-        name: "agentskit-multi-agent",
-        private: true,
-        type: "module",
-        scripts: {
-          start: "tsx src/index.ts",
-          dev: "tsx src/index.ts"
-        },
-        dependencies: deps,
-        devDependencies: {
-          tsx: "^4.20.0",
-          typescript: "^5.5.0"
-        }
-      },
-      null,
-      2
-    ) + "\n",
-    "tsconfig.json": JSON.stringify(
-      {
-        compilerOptions: {
-          target: "ES2022",
-          module: "ESNext",
-          moduleResolution: "bundler",
-          strict: true,
-          noEmit: true,
-          skipLibCheck: true
-        },
-        include: ["src"]
-      },
-      null,
-      2
-    ) + "\n",
-    "src/index.ts": `import { createRuntime } from '@agentskit/runtime'
-import { planner, researcher } from '@agentskit/skills'
-${adapterImport(ctx.provider)}${toolImports(ctx.tools)}
-${ctx.provider === "demo" ? demoAdapterSnippet() : ""}const runtime = createRuntime({
-  adapter: ${adapterCall(ctx.provider)},
-  maxSteps: 10,
-  maxDelegationDepth: 2,
-})
-
-const task = process.argv.slice(2).join(' ') || 'Research the current state of WebGPU and summarize.'
-
-const result = await runtime.run(task, {
-  skill: planner,
-  delegates: {
-    researcher: {
-      skill: researcher,
-      tools: ${toolList(ctx.tools)},
-      maxSteps: 5,
-    },
-  },
-})
-
-console.log(result.content)
-console.log(\`\\n\u2014 \${result.steps} steps \xB7 \${result.toolCalls.length} tool calls\`)
-`,
-    ".env.example": PROVIDER_ENV_KEY[ctx.provider] ? `${PROVIDER_ENV_KEY[ctx.provider]}=
-` : "# No API key required for the local provider\n",
-    ".gitignore": `node_modules
-.env
-.env.local
-`,
-    "README.md": readmeFor(ctx)
+    name: `${serverName}__${tool.name}`,
+    description: tool.description ?? `MCP tool ${tool.name} from ${serverName}`,
+    schema: tool.inputSchema ?? { type: "object", properties: {} },
+    execute: async (args) => {
+      return await client.callTool(tool.name, args);
+    }
   };
 }
-function readmeFor(ctx) {
-  const installCmd = ctx.pm === "npm" ? "npm install" : `${ctx.pm} install`;
-  const runCmd = ctx.pm === "npm" ? "npm run dev" : `${ctx.pm} dev`;
-  const envKey = PROVIDER_ENV_KEY[ctx.provider];
-  return `# AgentsKit ${ctx.template} starter
-
-Generated by \`agentskit init\`.
-
-## Stack
-
-- **Template**: \`${ctx.template}\`
-- **Provider**: \`${ctx.provider}\`${ctx.tools.length ? `
-- **Tools**: ${ctx.tools.map((t) => `\`${t}\``).join(", ")}` : ""}${ctx.memory !== "none" ? `
-- **Memory**: \`${ctx.memory}\`` : ""}
-
-## Run
-
-\`\`\`bash
-${installCmd}
-${envKey ? `cp .env.example .env
-# add ${envKey}=...` : "# No API key required"}
-${runCmd}
-\`\`\`
-
-## Next steps
-
-- Open the AgentsKit docs at https://www.agentskit.io/docs
-- Add a custom skill: https://www.agentskit.io/docs/concepts/skill
-- Wire up RAG: https://www.agentskit.io/docs/recipes/rag-chat
-
-## License
-
-ISC
-`;
-}
-var TEMPLATE_FN = {
-  react: reactStarter,
-  ink: inkStarter,
-  runtime: runtimeStarter,
-  "multi-agent": multiAgentStarter
-};
-async function writeStarterProject(options) {
-  const ctx = {
-    template: options.template,
-    provider: options.provider ?? "demo",
-    tools: options.tools ?? [],
-    memory: options.memory ?? "none",
-    pm: options.packageManager ?? "pnpm"
-  };
-  const files = TEMPLATE_FN[ctx.template](ctx);
-  await promises.mkdir(options.targetDir, { recursive: true });
-  await Promise.all(
-    Object.entries(files).map(async ([relativePath, content]) => {
-      const absolutePath = path3__default.default.join(options.targetDir, relativePath);
-      await promises.mkdir(path3__default.default.dirname(absolutePath), { recursive: true });
-      await promises.writeFile(absolutePath, content, "utf8");
-    })
-  );
+function disposeMcpClients(clients) {
+  for (const client of clients) client.dispose();
 }
-async function runInteractiveInit(defaults = {}) {
-  process.stdout.write(`
-${kleur__default.default.bold().green("\u25B2")} ${kleur__default.default.bold("agentskit init")}
-`);
-  process.stdout.write(kleur__default.default.dim("   Generate a starter project \u2014 answer five questions.\n\n"));
-  try {
-    const targetDir = await prompts.input({
-      message: "Project directory:",
-      default: defaults.dir ?? "agentskit-app",
-      validate: (value) => {
-        if (!value.trim()) return "A directory name is required.";
-        const abs = path3__default.default.resolve(process.cwd(), value);
-        if (fs.existsSync(abs)) return `${value} already exists. Pick a different name.`;
-        return true;
+
+// src/commands/chat.ts
+function registerChatCommand(program) {
+  program.command("chat").description("Start a terminal chat session.").option("--provider <provider>", "Provider to use", "demo").option("--model <model>", "Model name").option("--api-key <key>", "API key for the selected provider").option("--base-url <url>", "Override provider base URL").option("--system <prompt>", "System prompt").option("--memory <path>", "Explicit memory file path (overrides session management)").option("--tools <tools>", "Comma-separated tools: web_search,fetch_url,filesystem,shell").option("--skill <skills>", "Comma-separated skills: researcher,coder,planner,critic,summarizer").option("--memory-backend <backend>", "Memory backend: file (default), sqlite").option("--new", "Start a fresh chat session (ignore previous conversations in this directory)").option("--resume [id]", "Resume a prior session by id; omit id to resume the latest").option("--list-sessions", "List saved sessions for this directory and exit").option("--no-config", "Skip loading .agentskit.config.json").option(
+    "--plugin-dir <dir>",
+    "Extra directory to auto-discover plugin modules from (repeatable)",
+    (value, prev = []) => [...prev, value],
+    []
+  ).option(
+    "--mode <mode>",
+    "Permission mode: default | plan | acceptEdits | bypassPermissions"
+  ).action(async (options) => {
+    if (options.listSessions) {
+      const sessions = listSessions();
+      if (sessions.length === 0) {
+        process.stdout.write("No saved sessions for this directory.\n");
+        return;
       }
-    });
-    const template = await prompts.select({
-      message: "Template:",
-      default: defaults.template ?? "react",
-      choices: [
-        { name: "React chat (Vite + browser)", value: "react", description: "Streaming UI with @agentskit/react" },
-        { name: "Ink chat (terminal UI)", value: "ink", description: "Same chat but in your terminal" },
-        { name: "Runtime (headless agent, no UI)", value: "runtime", description: "Autonomous task \u2192 result" },
-        { name: "Multi-agent (planner + delegates)", value: "multi-agent", description: "Supervisor pattern, ready to extend" }
-      ]
-    });
-    const provider = await prompts.select({
-      message: "LLM provider:",
-      default: "demo",
-      choices: [
-        { name: "Demo (no API key \u2014 deterministic stub)", value: "demo" },
-        { name: "OpenAI", value: "openai" },
-        { name: "Anthropic", value: "anthropic" },
-        { name: "Gemini", value: "gemini" },
-        { name: "Ollama (local, no key)", value: "ollama" }
-      ]
-    });
-    let tools = [];
-    if (template !== "react") {
-      tools = await prompts.checkbox({
-        message: "Tools (space to toggle, enter to confirm):",
-        choices: [
-          { name: "web_search", value: "web_search" },
-          { name: "filesystem", value: "filesystem" },
-          { name: "shell", value: "shell" }
-        ]
-      });
+      for (const s of sessions) {
+        const { id, updatedAt, messageCount, preview, model, label, forkedFrom } = s.metadata;
+        const display = label ? `${label} (${id})` : id;
+        const forkNote = forkedFrom ? `  \u2190 fork ${forkedFrom}` : "";
+        process.stdout.write(
+          `${display}  ${updatedAt}  msgs=${messageCount}${model ? `  model=${model}` : ""}${forkNote}
+    ${preview}
+`
+        );
+      }
+      return;
     }
-    const memory = await prompts.select({
-      message: "Memory backend:",
-      default: "none",
-      choices: [
-        { name: "None (stateless)", value: "none" },
-        { name: "File (JSON on disk)", value: "file" },
-        { name: "SQLite (better-sqlite3)", value: "sqlite" }
-      ]
-    });
-    const packageManager = await prompts.select({
-      message: "Package manager:",
-      default: "pnpm",
-      choices: [
-        { name: "pnpm", value: "pnpm" },
-        { name: "npm", value: "npm" },
-        { name: "yarn", value: "yarn" },
-        { name: "bun", value: "bun" }
-      ]
+    const config = options.config !== false ? await loadConfig() : void 0;
+    const merged = mergeWithConfig(options, config);
+    const session = resolveSession({
+      explicitPath: options.memory,
+      forceNew: Boolean(options.new),
+      resumeId: options.resume
     });
-    process.stdout.write("\n" + kleur__default.default.dim("  Summary:\n"));
-    process.stdout.write(kleur__default.default.dim(`    dir       ${targetDir}
-`));
-    process.stdout.write(kleur__default.default.dim(`    template  ${template}
-`));
-    process.stdout.write(kleur__default.default.dim(`    provider  ${provider}
-`));
-    if (tools.length) process.stdout.write(kleur__default.default.dim(`    tools     ${tools.join(", ")}
-`));
-    process.stdout.write(kleur__default.default.dim(`    memory    ${memory}
-`));
-    process.stdout.write(kleur__default.default.dim(`    pm        ${packageManager}
-
-`));
-    const proceed = await prompts.confirm({ message: "Generate?", default: true });
-    if (!proceed) {
-      process.stdout.write(kleur__default.default.yellow("Cancelled.\n"));
-      return { cancelled: true, options: { targetDir, template, provider, tools, memory, packageManager } };
+    if (!session.isNew && !options.memory) {
+      process.stdout.write(
+        `Resuming session ${session.id}. Start fresh with --new or list with --list-sessions.
+`
+      );
     }
-    return {
-      cancelled: false,
-      options: {
-        targetDir: path3__default.default.resolve(process.cwd(), targetDir),
-        template,
-        provider,
-        tools,
-        memory,
-        packageManager
-      }
+    const pluginBundle = await loadPlugins({
+      specs: config?.plugins ?? [],
+      pluginDirs: options.pluginDir ?? []
+    });
+    const configHooks = configHooksToHandlers(config?.hooks);
+    const hookHandlers = [...configHooks, ...pluginBundle.hooks];
+    const configMcpSpecs = Object.entries(config?.mcp?.servers ?? {}).map(([name, spec]) => ({
+      name,
+      command: spec.command,
+      args: spec.args,
+      env: spec.env,
+      timeout: spec.timeout
+    }));
+    const allMcpSpecs = [...configMcpSpecs, ...pluginBundle.mcpServers];
+    const { clients: mcpClients, tools: mcpTools } = await bridgeMcpServers(allMcpSpecs);
+    const policyMode = options.mode ?? config?.permissions?.mode ?? "default";
+    const permissionPolicy = {
+      mode: policyMode,
+      rules: (config?.permissions?.rules ?? []).map((r) => ({
+        tool: r.tool,
+        action: r.action,
+        scope: r.scope
+      }))
     };
-  } catch (err) {
-    if (err.name === "ExitPromptError") {
-      process.stdout.write(kleur__default.default.yellow("\nCancelled.\n"));
-      return { cancelled: true, options: { targetDir: "", template: "react" } };
-    }
-    throw err;
-  }
-}
-function printNextSteps(options) {
-  const dir = path3__default.default.relative(process.cwd(), options.targetDir) || ".";
-  const pm = options.packageManager ?? "pnpm";
-  const installCmd = pm === "npm" ? "npm install" : `${pm} install`;
-  const runCmd = pm === "npm" ? "npm run dev" : `${pm} dev`;
-  process.stdout.write("\n" + kleur__default.default.green("\u2713 Created starter at ") + kleur__default.default.bold(dir) + "\n\n");
-  process.stdout.write(kleur__default.default.bold("Next steps:\n\n"));
-  process.stdout.write(`  ${kleur__default.default.cyan("cd")} ${dir}
-`);
-  process.stdout.write(`  ${kleur__default.default.cyan(installCmd)}
+    const chatOptions = {
+      apiKey: merged.apiKey ?? options.apiKey,
+      baseUrl: merged.baseUrl ?? options.baseUrl,
+      provider: merged.provider,
+      model: merged.model,
+      system: merged.system ?? options.system,
+      memoryPath: session.file,
+      sessionId: session.id,
+      tools: merged.tools ?? options.tools,
+      skill: merged.skill ?? options.skill,
+      memoryBackend: merged.memoryBackend ?? options.memoryBackend,
+      agentsKitConfig: config,
+      slashCommands: pluginBundle.slashCommands,
+      extraTools: [...pluginBundle.tools, ...mcpTools],
+      extraSkills: pluginBundle.skills,
+      hookHandlers,
+      permissionPolicy
+    };
+    process.stdout.write(`${renderChatHeader(chatOptions)}
 `);
-  if (options.provider && options.provider !== "demo" && options.provider !== "ollama") {
-    process.stdout.write(
-      `  ${kleur__default.default.cyan("cp")} .env.example .env  ${kleur__default.default.dim("# add your API key")}
+    const instance = ink.render(React2__default.default.createElement(ChatApp, chatOptions));
+    try {
+      await instance.waitUntilExit();
+    } finally {
+      disposeMcpClients(mcpClients);
+    }
+    if (options.memory) {
+      process.stdout.write(
+        `
+Session saved to ${session.file}. Resume with --memory ${session.file}
 `
-    );
-  }
-  process.stdout.write(`  ${kleur__default.default.cyan(runCmd)}
-
-`);
-  process.stdout.write(kleur__default.default.dim("  Docs: https://www.agentskit.io/docs\n\n"));
+      );
+    } else {
+      process.stdout.write(
+        `
+Session saved. Resume with:
+  agentskit chat --resume ${session.id}
+Or start fresh with:
+  agentskit chat --new
+`
+      );
+    }
+  });
 }
 function formatEvent(event) {
   switch (event.type) {
@@ -1408,13 +1535,13 @@ async function runAgent(task, options) {
   process.stdout.write(result.content + "\n");
 }
 function RunApp({ task, options }) {
-  const [status, setStatus] = React3.useState("running");
-  const [currentStep, setCurrentStep] = React3.useState(0);
-  const [toolCalls, setToolCalls] = React3.useState([]);
-  const [result, setResult] = React3.useState("");
-  const [error, setError] = React3.useState("");
-  const [durationMs, setDurationMs] = React3.useState(0);
-  React3.useEffect(() => {
+  const [status, setStatus] = React2.useState("running");
+  const [currentStep, setCurrentStep] = React2.useState(0);
+  const [toolCalls, setToolCalls] = React2.useState([]);
+  const [result, setResult] = React2.useState("");
+  const [error, setError] = React2.useState("");
+  const [durationMs, setDurationMs] = React2.useState(0);
+  React2.useEffect(() => {
     async function execute() {
       if (options.skill && options.skills) {
         setError("--skill and --skills are mutually exclusive.");
@@ -1505,555 +1632,640 @@ function RunApp({ task, options }) {
     ] })
   ] });
 }
-var PROVIDER_ENV_KEYS = {
+
+// src/commands/run.ts
+function registerRunCommand(program) {
+  program.command("run [task]").description("Execute an agent task and output the result.").option("--task <task>", "Task string (alternative to positional argument)").option("--provider <provider>", "Provider to use", "demo").option("--model <model>", "Model name").option("--api-key <key>", "API key for the selected provider").option("--base-url <url>", "Override provider base URL").option("--skill <skill>", "Single skill to use").option("--skills <skills>", "Comma-separated skills (composed together)").option("--tools <tools>", "Comma-separated tools: web_search,filesystem,shell").option("--memory <path>", "Path for memory persistence").option("--memory-backend <backend>", "Memory backend: file (default), sqlite").option("--system-prompt <prompt>", "System prompt").option("--max-steps <steps>", "Maximum agent steps", "10").option("--verbose", "Stream agent steps to stderr").option("--pretty", "Use rich Ink-based output").option("--no-config", "Skip loading .agentskit.config.json").action(async (positionalTask, options) => {
+    const task = options.task ?? positionalTask;
+    if (!task) {
+      process.stderr.write("Error: task is required. Pass as argument or use --task.\n");
+      process.exit(1);
+    }
+    const config = options.config !== false ? await loadConfig() : void 0;
+    const merged = mergeWithConfig(options, config);
+    if (options.pretty) {
+      ink.render(React2__default.default.createElement(RunApp, { task, options }));
+    } else {
+      try {
+        await runAgent(task, { ...options, provider: merged.provider, model: merged.model });
+      } catch (err) {
+        process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
+`);
+        process.exit(1);
+      }
+    }
+  });
+}
+var PROVIDER_IMPORT = {
+  openai: "openai",
+  anthropic: "anthropic",
+  gemini: "gemini",
+  ollama: "ollama"
+};
+var PROVIDER_DEFAULT_MODEL = {
+  openai: "gpt-4o-mini",
+  anthropic: "claude-sonnet-4-6",
+  gemini: "gemini-2.5-flash",
+  ollama: "llama3.1",
+  demo: "demo"
+};
+var PROVIDER_ENV_KEY = {
   openai: "OPENAI_API_KEY",
   anthropic: "ANTHROPIC_API_KEY",
   gemini: "GEMINI_API_KEY",
-  deepseek: "DEEPSEEK_API_KEY",
-  grok: "XAI_API_KEY",
-  kimi: "KIMI_API_KEY"
-};
-var PROVIDER_REACH_URLS = {
-  openai: "https://api.openai.com/v1/models",
-  anthropic: "https://api.anthropic.com/v1/messages",
-  gemini: "https://generativelanguage.googleapis.com/v1beta/models",
-  ollama: "http://localhost:11434/api/tags"
+  ollama: null,
+  demo: null
 };
-async function checkNodeVersion() {
-  const major = Number(process.versions.node.split(".")[0]);
-  if (Number.isNaN(major)) {
-    return { status: "fail", name: "Node version", detail: "Could not parse process.versions.node" };
-  }
-  if (major < 22) {
-    return {
-      status: "fail",
-      name: "Node version",
-      detail: `Node ${process.versions.node} (need 22+)`,
-      fix: "Install Node 22 LTS or newer (https://nodejs.org)"
-    };
-  }
-  if (major === 25) {
-    return {
-      status: "warn",
-      name: "Node version",
-      detail: `Node ${process.versions.node} \u2014 Docusaurus apps may break here`,
-      fix: "Use Node 22 LTS for the legacy docs app, or stay on 25 for everything else"
-    };
-  }
-  return { status: "pass", name: "Node version", detail: `Node ${process.versions.node}` };
+function adapterCall(provider, prefix = "process.env") {
+  const model = PROVIDER_DEFAULT_MODEL[provider];
+  if (provider === "demo") return `demoAdapter()`;
+  if (provider === "ollama") return `ollama({ model: '${model}' })`;
+  const envKey = PROVIDER_ENV_KEY[provider];
+  return `${PROVIDER_IMPORT[provider]}({ apiKey: ${prefix}.${envKey} ?? '', model: '${model}' })`;
 }
-async function checkPnpm() {
-  const cwd = process.cwd();
-  const hasPnpm = fs.existsSync(path3.join(cwd, "pnpm-lock.yaml")) || fs.existsSync(path3.join(cwd, "pnpm-workspace.yaml"));
-  if (hasPnpm) {
-    return { status: "pass", name: "Package manager", detail: "pnpm detected (lockfile)" };
-  }
-  if (fs.existsSync(path3.join(cwd, "package-lock.json"))) {
-    return { status: "warn", name: "Package manager", detail: "npm detected \u2014 pnpm recommended for monorepo workflows" };
-  }
-  if (fs.existsSync(path3.join(cwd, "yarn.lock"))) {
-    return { status: "pass", name: "Package manager", detail: "yarn detected" };
-  }
-  if (fs.existsSync(path3.join(cwd, "bun.lock")) || fs.existsSync(path3.join(cwd, "bun.lockb"))) {
-    return { status: "pass", name: "Package manager", detail: "bun detected" };
-  }
-  return {
-    status: "skip",
-    name: "Package manager",
-    detail: "No lockfile found in cwd"
-  };
+function viteAdapterCall(provider) {
+  if (provider === "demo") return `demoAdapter()`;
+  if (provider === "ollama") return `ollama({ model: '${PROVIDER_DEFAULT_MODEL[provider]}' })`;
+  const envKey = PROVIDER_ENV_KEY[provider];
+  return `${PROVIDER_IMPORT[provider]}({ apiKey: import.meta.env.VITE_${envKey} ?? '', model: '${PROVIDER_DEFAULT_MODEL[provider]}' })`;
 }
-async function checkPackageJson() {
-  const path4 = path3.join(process.cwd(), "package.json");
-  if (!fs.existsSync(path4)) {
-    return {
-      status: "warn",
-      name: "package.json",
-      detail: "No package.json in cwd",
-      fix: "Run from a project directory (or use `agentskit init` to create one)"
-    };
-  }
-  try {
-    const pkg = JSON.parse(await promises.readFile(path4, "utf8"));
-    const deps = {
-      ...pkg.dependencies ?? {},
-      ...pkg.devDependencies ?? {}
-    };
-    const akDeps = Object.entries(deps).filter(([name]) => name.startsWith("@agentskit/"));
-    if (akDeps.length === 0) {
-      return { status: "skip", name: "AgentsKit packages", detail: "No @agentskit/* deps found in package.json" };
-    }
-    return {
-      status: "pass",
-      name: "AgentsKit packages",
-      detail: `${akDeps.length} installed: ${akDeps.map(([n]) => n.replace("@agentskit/", "")).join(", ")}`
-    };
-  } catch (err) {
-    return {
-      status: "fail",
-      name: "package.json",
-      detail: `Could not parse: ${err.message}`
-    };
-  }
+function adapterImport(provider) {
+  if (provider === "demo") return "";
+  return `import { ${PROVIDER_IMPORT[provider]} } from '@agentskit/adapters'
+`;
 }
-async function checkProviderEnv(provider) {
-  const envKey = PROVIDER_ENV_KEYS[provider];
-  if (!envKey) {
-    return { status: "skip", name: `${provider} API key`, detail: "No env-key requirement for this provider" };
-  }
-  const value = process.env[envKey];
-  if (!value) {
-    return {
-      status: "skip",
-      name: `${provider} API key`,
-      detail: `${envKey} not set`,
-      fix: `export ${envKey}=... (only needed if you use ${provider})`
-    };
-  }
-  if (value.length < 16) {
-    return {
-      status: "warn",
-      name: `${provider} API key`,
-      detail: `${envKey} looks too short (${value.length} chars)`,
-      fix: "Verify the key is complete and not truncated"
-    };
-  }
-  return { status: "pass", name: `${provider} API key`, detail: `${envKey} set (${value.length} chars)` };
+function toolImports(tools) {
+  if (tools.length === 0) return "";
+  return `import { ${tools.map((t) => t === "web_search" ? "webSearch" : t).join(", ")} } from '@agentskit/tools'
+`;
 }
-async function checkProviderReachable(provider, fetchImpl = fetch, timeoutMs = 4e3) {
-  const url = PROVIDER_REACH_URLS[provider];
-  if (!url) {
-    return { status: "skip", name: `${provider} reachable`, detail: "No reachability check configured" };
-  }
-  const envKey = PROVIDER_ENV_KEYS[provider];
-  if (envKey && !process.env[envKey]) {
-    return { status: "skip", name: `${provider} reachable`, detail: "Skipped \u2014 no API key configured" };
-  }
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), timeoutMs);
-  try {
-    const res = await fetchImpl(url, {
-      method: "GET",
-      signal: controller.signal
-    });
-    if (res.status >= 200 && res.status < 400) {
-      return { status: "pass", name: `${provider} reachable`, detail: `${url} \u2192 ${res.status} OK` };
-    }
-    if (res.status === 401 || res.status === 403 || res.status === 405) {
-      return { status: "pass", name: `${provider} reachable`, detail: `${url} \u2192 ${res.status} (host reachable)` };
-    }
-    return {
-      status: "warn",
-      name: `${provider} reachable`,
-      detail: `${url} \u2192 HTTP ${res.status}`,
-      fix: "Host reachable but returned unexpected status \u2014 check provider docs"
-    };
-  } catch (err) {
-    const reason = err.name === "AbortError" ? `timeout after ${timeoutMs}ms` : err.message;
-    return {
-      status: "fail",
-      name: `${provider} reachable`,
-      detail: `${url} \u2192 ${reason}`,
-      fix: provider === "ollama" ? "Start Ollama: `ollama serve` (or install from https://ollama.com)" : "Check network / firewall / VPN settings"
-    };
-  } finally {
-    clearTimeout(timer);
-  }
+function toolList(tools) {
+  if (tools.length === 0) return "[]";
+  const calls = tools.map((t) => {
+    if (t === "web_search") return "webSearch()";
+    if (t === "filesystem") return `...filesystem({ basePath: './workspace' })`;
+    if (t === "shell") return `shell({ allowedCommands: ['ls', 'cat'] })`;
+    return "";
+  });
+  return `[${calls.join(", ")}]`;
 }
-async function checkConfig() {
-  try {
-    const config = await loadConfig();
-    if (!config) {
-      return { status: "skip", name: "AgentsKit config", detail: "No .agentskit.config or package.json#agentskit found" };
-    }
-    return {
-      status: "pass",
-      name: "AgentsKit config",
-      detail: `loaded \u2014 defaults: ${JSON.stringify(config.defaults ?? {})}`
-    };
-  } catch (err) {
-    return {
-      status: "warn",
-      name: "AgentsKit config",
-      detail: `Could not load: ${err.message}`
-    };
-  }
+function memoryImport(memory) {
+  if (memory === "file") return `import { fileChatMemory } from '@agentskit/memory'
+`;
+  if (memory === "sqlite") return `import { sqliteChatMemory } from '@agentskit/memory'
+`;
+  return "";
 }
-async function runDoctor(options = {}) {
-  const providers2 = options.providers ?? ["openai", "anthropic", "gemini", "ollama"];
-  const fetchImpl = options.fetchImpl ?? fetch;
-  const checks = [
-    checkNodeVersion(),
-    checkPnpm(),
-    checkPackageJson(),
-    checkConfig()
-  ];
-  for (const provider of providers2) {
-    checks.push(checkProviderEnv(provider));
-    if (!options.noNetwork) {
-      checks.push(checkProviderReachable(provider, fetchImpl));
-    }
-  }
-  const results = await Promise.all(checks);
+function memoryCall(memory) {
+  if (memory === "file") return `fileChatMemory('./.agentskit-history.json')`;
+  if (memory === "sqlite") return `sqliteChatMemory({ path: './.agentskit-history.db' })`;
+  return "undefined";
+}
+function demoAdapterSnippet() {
+  return `function demoAdapter() {
   return {
-    results,
-    pass: results.filter((r) => r.status === "pass").length,
-    warn: results.filter((r) => r.status === "warn").length,
-    fail: results.filter((r) => r.status === "fail").length,
-    skip: results.filter((r) => r.status === "skip").length
-  };
+    createSource: () => ({
+      stream: async function* () {
+        yield { type: 'text' as const, content: 'Hello from your AgentsKit starter. ' }
+        yield { type: 'text' as const, content: 'Configure a real adapter to talk to a model.' }
+        yield { type: 'done' as const }
+      },
+      abort: () => {},
+    }),
+  }
+}
+
+`;
 }
-var ICON = {
-  pass: "\u2714",
-  warn: "\u26A0",
-  fail: "\u2718",
-  skip: "\u25CB"
-};
-function renderReport(report, opts = {}) {
-  const color = opts.color ?? true;
-  const c = (code, text) => color ? `\x1B[${code}m${text}\x1B[0m` : text;
-  const colorFor = {
-    pass: (t) => c("32", t),
-    // green
-    warn: (t) => c("33", t),
-    // yellow
-    fail: (t) => c("31", t),
-    // red
-    skip: (t) => c("90", t)
-    // dim
-  };
-  const lines = [];
-  lines.push("");
-  lines.push(`  ${c("1;36", "\u26A1 AgentsKit Doctor")}`);
-  lines.push(`  ${c("90", "\u2500".repeat(50))}`);
-  lines.push("");
-  const groups = {
-    "Environment": [],
-    "Providers": [],
-    "Network": []
+function reactStarter(ctx) {
+  const deps = {
+    "@agentskit/react": "^0.4.0",
+    react: "^19.0.0",
+    "react-dom": "^19.0.0"
   };
-  for (const r of report.results) {
-    if (r.name.includes("reachable")) {
-      groups["Network"].push(r);
-    } else if (r.name.includes("API key")) {
-      groups["Providers"].push(r);
-    } else {
-      groups["Environment"].push(r);
-    }
-  }
-  for (const [group, results] of Object.entries(groups)) {
-    if (results.length === 0) continue;
-    lines.push(`  ${c("1", group)}`);
-    for (const r of results) {
-      const icon = colorFor[r.status](ICON[r.status]);
-      const name = r.name.padEnd(28);
-      const detail = r.detail ? c("90", r.detail) : "";
-      lines.push(`    ${icon}  ${name} ${detail}`);
-      if (r.fix && r.status !== "pass") {
-        lines.push(`       ${c("90", "\u21B3 " + r.fix)}`);
-      }
-    }
-    lines.push("");
-  }
-  lines.push(`  ${c("90", "\u2500".repeat(50))}`);
-  const parts = [];
-  if (report.pass > 0) parts.push(colorFor.pass(`${report.pass} passed`));
-  if (report.warn > 0) parts.push(colorFor.warn(`${report.warn} warnings`));
-  if (report.fail > 0) parts.push(colorFor.fail(`${report.fail} failed`));
-  if (report.skip > 0) parts.push(colorFor.skip(`${report.skip} skipped`));
-  lines.push(`  ${parts.join("  \xB7  ")}`);
-  if (report.fail === 0) {
-    lines.push(`  ${c("32", "\u2714 Ready to build agents.")}`);
-  } else {
-    lines.push(`  ${c("31", "\u2718 Fix the issues above before continuing.")}`);
-  }
-  lines.push("");
-  return lines.join("\n");
+  if (ctx.provider !== "demo") deps["@agentskit/adapters"] = "^0.4.0";
+  if (ctx.tools.length > 0) deps["@agentskit/tools"] = "^0.4.0";
+  if (ctx.memory !== "none") deps["@agentskit/memory"] = "^0.4.0";
+  const includesDemo = ctx.provider === "demo";
+  const adapter = ctx.provider === "demo" ? viteAdapterCall(ctx.provider) : viteAdapterCall(ctx.provider);
+  const envKey = PROVIDER_ENV_KEY[ctx.provider];
+  const envContent = envKey ? `VITE_${envKey}=
+` : "# No API key required for the local provider\n";
+  return {
+    "package.json": JSON.stringify(
+      {
+        name: path__default.default.basename(ctx.template === "react" ? "agentskit-react-app" : "agentskit-app"),
+        private: true,
+        type: "module",
+        scripts: {
+          dev: "vite",
+          build: "vite build",
+          preview: "vite preview"
+        },
+        dependencies: deps,
+        devDependencies: {
+          "@types/react": "^19.0.0",
+          "@types/react-dom": "^19.0.0",
+          "@vitejs/plugin-react": "^5.0.0",
+          typescript: "^5.5.0",
+          vite: "^7.0.0"
+        }
+      },
+      null,
+      2
+    ) + "\n",
+    "index.html": `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>AgentsKit React Starter</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
+`,
+    "vite.config.ts": `import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+export default defineConfig({ plugins: [react()] })
+`,
+    "tsconfig.json": JSON.stringify(
+      {
+        compilerOptions: {
+          target: "ES2022",
+          lib: ["ES2022", "DOM"],
+          module: "ESNext",
+          moduleResolution: "bundler",
+          jsx: "react-jsx",
+          strict: true,
+          noEmit: true,
+          skipLibCheck: true
+        },
+        include: ["src"]
+      },
+      null,
+      2
+    ) + "\n",
+    "src/main.tsx": `import React from 'react'
+import ReactDOM from 'react-dom/client'
+import App from './App'
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>,
+)
+`,
+    "src/App.tsx": `import { ChatContainer, InputBar, Message, useChat } from '@agentskit/react'
+${adapterImport(ctx.provider)}${toolImports(ctx.tools)}${memoryImport(ctx.memory)}import '@agentskit/react/theme'
+
+${includesDemo ? demoAdapterSnippet() : ""}export default function App() {
+  const chat = useChat({
+    adapter: ${adapter},${ctx.tools.length > 0 ? `
+    tools: ${toolList(ctx.tools)},` : ""}${ctx.memory !== "none" ? `
+    memory: ${memoryCall(ctx.memory)},` : ""}
+  })
+
+  return (
+    <ChatContainer>
+      {chat.messages.map(message => (
+        <Message key={message.id} message={message} />
+      ))}
+      <InputBar chat={chat} />
+    </ChatContainer>
+  )
 }
-var DEFAULT_WATCH = [
-  "**/*.ts",
-  "**/*.tsx",
-  "**/*.mjs",
-  "**/*.json",
-  ".agentskit.config.*"
-];
-var DEFAULT_IGNORE = [
-  "**/node_modules/**",
-  "**/dist/**",
-  "**/build/**",
-  "**/.next/**",
-  "**/.turbo/**",
-  "**/.git/**",
-  "**/coverage/**",
-  "**/*.test.ts",
-  "**/*.spec.ts"
-];
-function startDev(options) {
-  const entry = path3.resolve(process.cwd(), options.entry);
-  if (!fs.existsSync(entry)) {
-    throw new Error(`Entry file not found: ${entry}`);
-  }
-  const stdout = options.stdout ?? process.stdout;
-  const stderr = options.stderr ?? process.stderr;
-  const debounceMs = options.debounceMs ?? 200;
-  const isTs = entry.endsWith(".ts") || entry.endsWith(".tsx");
-  const cmd = isTs ? "tsx" : "node";
-  const baseArgs = [entry, ...options.scriptArgs ?? []];
-  const spawnFn = options.spawn ?? ((c, a) => child_process.spawn(c, a, {
-    stdio: ["inherit", "pipe", "pipe"],
-    env: { ...process.env, FORCE_COLOR: "1" }
-  }));
-  const watchPaths = options.watch ?? DEFAULT_WATCH;
-  const ignorePaths = [...DEFAULT_IGNORE, ...options.ignore ?? []];
-  const watcherFactory = options.watcher ?? ((paths, opts) => chokidar__default.default.watch(paths, { ignored: opts.ignored, ignoreInitial: true }));
-  const watcher = watcherFactory(watchPaths, { ignored: ignorePaths });
-  let child;
-  let restartCount = 0;
-  let restartTimer;
-  let stopped = false;
-  let resolveDone;
-  const done = new Promise((r) => {
-    resolveDone = r;
-  });
-  const banner = (msg, color = "green") => {
-    const time = (/* @__PURE__ */ new Date()).toTimeString().slice(0, 8);
-    stdout.write(kleur__default.default[color](`[agentskit dev ${time}] `) + msg + "\n");
+`,
+    ".env.example": envContent,
+    ".gitignore": `node_modules
+dist
+.env
+.env.local
+.agentskit-history.*
+`,
+    "README.md": readmeFor(ctx)
   };
-  const startChild = () => {
-    restartCount++;
-    banner(`\u25B8 starting ${kleur__default.default.bold(path3.basename(entry))} (restart #${restartCount - 1})`, "cyan");
-    const c = spawnFn(cmd, baseArgs);
-    child = c;
-    c.stdout?.on("data", (d) => stdout.write(d));
-    c.stderr?.on("data", (d) => stderr.write(d));
-    c.on("exit", (code, signal) => {
-      if (stopped) return;
-      if (signal === "SIGTERM" || signal === "SIGINT") return;
-      if (code === 0) {
-        banner(`\u2713 exited cleanly \u2014 waiting for changes`, "green");
-      } else {
-        banner(`\u2717 exited with code ${code} \u2014 waiting for changes`, "red");
-      }
-    });
+}
+function inkStarter(ctx) {
+  const deps = {
+    "@agentskit/ink": "^0.4.0",
+    ink: "^7.0.0",
+    react: "^19.0.0"
   };
-  const restart = (path4) => {
-    if (restartTimer) clearTimeout(restartTimer);
-    restartTimer = setTimeout(() => {
-      restartTimer = void 0;
-      banner(`\u21BB change detected \u2014 ${path4}`, "yellow");
-      if (child && !child.killed && child.exitCode === null) {
-        child.kill("SIGTERM");
-      }
-      setTimeout(startChild, 80);
-    }, debounceMs);
+  if (ctx.provider !== "demo") deps["@agentskit/adapters"] = "^0.4.0";
+  if (ctx.tools.length > 0) deps["@agentskit/tools"] = "^0.4.0";
+  if (ctx.memory !== "none") deps["@agentskit/memory"] = "^0.4.0";
+  return {
+    "package.json": JSON.stringify(
+      {
+        name: "agentskit-ink-app",
+        private: true,
+        type: "module",
+        scripts: {
+          dev: "tsx src/index.tsx",
+          start: "tsx src/index.tsx"
+        },
+        dependencies: deps,
+        devDependencies: {
+          "@types/react": "^19.0.0",
+          "@types/react-dom": "^19.0.0",
+          tsx: "^4.20.0",
+          typescript: "^5.5.0"
+        }
+      },
+      null,
+      2
+    ) + "\n",
+    "tsconfig.json": JSON.stringify(
+      {
+        compilerOptions: {
+          target: "ES2022",
+          module: "ESNext",
+          moduleResolution: "bundler",
+          jsx: "react-jsx",
+          strict: true,
+          noEmit: true,
+          skipLibCheck: true
+        },
+        include: ["src"]
+      },
+      null,
+      2
+    ) + "\n",
+    "src/index.tsx": `import React from 'react'
+import { render } from 'ink'
+import { ChatContainer, InputBar, Message, useChat } from '@agentskit/ink'
+${adapterImport(ctx.provider)}${toolImports(ctx.tools)}${memoryImport(ctx.memory)}
+${ctx.provider === "demo" ? demoAdapterSnippet() : ""}function App() {
+  const chat = useChat({
+    adapter: ${adapterCall(ctx.provider)},${ctx.tools.length > 0 ? `
+    tools: ${toolList(ctx.tools)},` : ""}${ctx.memory !== "none" ? `
+    memory: ${memoryCall(ctx.memory)},` : ""}
+  })
+
+  return (
+    <ChatContainer>
+      {chat.messages.map(message => (
+        <Message key={message.id} message={message} />
+      ))}
+      <InputBar chat={chat} />
+    </ChatContainer>
+  )
+}
+
+render(<App />)
+`,
+    ".env.example": PROVIDER_ENV_KEY[ctx.provider] ? `${PROVIDER_ENV_KEY[ctx.provider]}=
+` : "# No API key required for the local provider\n",
+    ".gitignore": `node_modules
+.env
+.env.local
+.agentskit-history.*
+`,
+    "README.md": readmeFor(ctx)
   };
-  watcher.on("change", restart);
-  watcher.on("add", restart);
-  watcher.on("unlink", restart);
-  startChild();
-  const stop = async () => {
-    if (stopped) return;
-    stopped = true;
-    if (restartTimer) clearTimeout(restartTimer);
-    if (child && !child.killed && child.exitCode === null) {
-      child.kill("SIGTERM");
-    }
-    await watcher.close();
-    banner(`stopped`, "cyan");
-    resolveDone();
+}
+function runtimeStarter(ctx) {
+  const deps = {
+    "@agentskit/runtime": "^0.4.0"
   };
-  if (process.stdin.isTTY && process.stdin.setRawMode) {
-    process.stdin.setRawMode(true);
-    process.stdin.resume();
-    process.stdin.on("data", (data) => {
-      const key = data.toString();
-      if (key === "r") restart("manual");
-      if (key === "q" || key === "") void stop();
-    });
-  }
+  if (ctx.provider !== "demo") deps["@agentskit/adapters"] = "^0.4.0";
+  if (ctx.tools.length > 0) deps["@agentskit/tools"] = "^0.4.0";
+  if (ctx.memory !== "none") deps["@agentskit/memory"] = "^0.4.0";
   return {
-    done,
-    stop,
-    restarts: () => restartCount
+    "package.json": JSON.stringify(
+      {
+        name: "agentskit-runtime-app",
+        private: true,
+        type: "module",
+        scripts: {
+          start: "tsx src/index.ts",
+          dev: "tsx src/index.ts"
+        },
+        dependencies: deps,
+        devDependencies: {
+          tsx: "^4.20.0",
+          typescript: "^5.5.0"
+        }
+      },
+      null,
+      2
+    ) + "\n",
+    "tsconfig.json": JSON.stringify(
+      {
+        compilerOptions: {
+          target: "ES2022",
+          module: "ESNext",
+          moduleResolution: "bundler",
+          strict: true,
+          noEmit: true,
+          skipLibCheck: true
+        },
+        include: ["src"]
+      },
+      null,
+      2
+    ) + "\n",
+    "src/index.ts": `import { createRuntime } from '@agentskit/runtime'
+${adapterImport(ctx.provider)}${toolImports(ctx.tools)}${memoryImport(ctx.memory)}
+${ctx.provider === "demo" ? demoAdapterSnippet() : ""}const runtime = createRuntime({
+  adapter: ${adapterCall(ctx.provider)},${ctx.tools.length > 0 ? `
+  tools: ${toolList(ctx.tools)},` : ""}${ctx.memory !== "none" ? `
+  memory: ${memoryCall(ctx.memory)},` : ""}
+  maxSteps: 10,
+})
+
+const task = process.argv.slice(2).join(' ') || 'Say hello and tell me one fact about TypeScript.'
+const result = await runtime.run(task)
+
+console.log(result.content)
+console.log(\`\\n\u2014 \${result.steps} steps \xB7 \${result.toolCalls.length} tool calls \xB7 \${result.durationMs}ms\`)
+`,
+    ".env.example": PROVIDER_ENV_KEY[ctx.provider] ? `${PROVIDER_ENV_KEY[ctx.provider]}=
+` : "# No API key required for the local provider\n",
+    ".gitignore": `node_modules
+.env
+.env.local
+.agentskit-history.*
+`,
+    "README.md": readmeFor(ctx)
   };
 }
-async function startTunnel(options) {
-  const stdout = options.stdout ?? process.stdout;
-  const open = options.open ?? (async (opts) => {
-    const lt = (await import('localtunnel')).default;
-    return await lt(opts);
-  });
-  const banner = (msg, color = "green") => {
-    const time = (/* @__PURE__ */ new Date()).toTimeString().slice(0, 8);
-    stdout.write(kleur__default.default[color](`[agentskit tunnel ${time}] `) + msg + "\n");
+function multiAgentStarter(ctx) {
+  const deps = {
+    "@agentskit/runtime": "^0.4.0",
+    "@agentskit/skills": "^0.4.0"
   };
-  banner(`opening tunnel to ${options.host ?? "localhost"}:${options.port}...`, "cyan");
-  const tunnel = await open({
-    port: options.port,
-    subdomain: options.subdomain,
-    local_host: options.host
-  });
-  let requests = 0;
-  let stopped = false;
-  let resolveDone;
-  const done = new Promise((r) => {
-    resolveDone = r;
-  });
-  tunnel.on("request", () => {
-    requests++;
-  });
-  tunnel.on("close", () => {
-    if (stopped) return;
-    banner(`tunnel closed by remote`, "yellow");
-    resolveDone();
-  });
-  tunnel.on("error", (...args) => {
-    const err = args[0];
-    banner(`error: ${err?.message ?? "unknown"}`, "red");
-  });
-  banner(`\u2713 ready`, "green");
-  stdout.write("\n");
-  stdout.write(`  ${kleur__default.default.bold("Public URL:")}  ${kleur__default.default.cyan(tunnel.url)}
-`);
-  stdout.write(`  ${kleur__default.default.bold("Local:")}       http://${options.host ?? "localhost"}:${options.port}
-`);
-  stdout.write("\n");
-  stdout.write(kleur__default.default.dim(`  Forward webhooks here, then ${kleur__default.default.bold("Ctrl+C")} to stop.
+  if (ctx.provider !== "demo") deps["@agentskit/adapters"] = "^0.4.0";
+  if (ctx.tools.length === 0) ctx.tools = ["web_search"];
+  deps["@agentskit/tools"] = "^0.4.0";
+  return {
+    "package.json": JSON.stringify(
+      {
+        name: "agentskit-multi-agent",
+        private: true,
+        type: "module",
+        scripts: {
+          start: "tsx src/index.ts",
+          dev: "tsx src/index.ts"
+        },
+        dependencies: deps,
+        devDependencies: {
+          tsx: "^4.20.0",
+          typescript: "^5.5.0"
+        }
+      },
+      null,
+      2
+    ) + "\n",
+    "tsconfig.json": JSON.stringify(
+      {
+        compilerOptions: {
+          target: "ES2022",
+          module: "ESNext",
+          moduleResolution: "bundler",
+          strict: true,
+          noEmit: true,
+          skipLibCheck: true
+        },
+        include: ["src"]
+      },
+      null,
+      2
+    ) + "\n",
+    "src/index.ts": `import { createRuntime } from '@agentskit/runtime'
+import { planner, researcher } from '@agentskit/skills'
+${adapterImport(ctx.provider)}${toolImports(ctx.tools)}
+${ctx.provider === "demo" ? demoAdapterSnippet() : ""}const runtime = createRuntime({
+  adapter: ${adapterCall(ctx.provider)},
+  maxSteps: 10,
+  maxDelegationDepth: 2,
+})
+
+const task = process.argv.slice(2).join(' ') || 'Research the current state of WebGPU and summarize.'
+
+const result = await runtime.run(task, {
+  skill: planner,
+  delegates: {
+    researcher: {
+      skill: researcher,
+      tools: ${toolList(ctx.tools)},
+      maxSteps: 5,
+    },
+  },
+})
 
-`));
-  options.onReady?.(tunnel.url);
-  const stop = async () => {
-    if (stopped) return;
-    stopped = true;
-    tunnel.close();
-    banner(`stopped \u2014 proxied ${requests} request${requests === 1 ? "" : "s"}`, "cyan");
-    resolveDone();
-  };
-  if (process.stdin.isTTY) {
-    process.on("SIGINT", () => {
-      void stop();
-    });
-  }
-  return {
-    url: tunnel.url,
-    done,
-    stop,
-    requests: () => requests
+console.log(result.content)
+console.log(\`\\n\u2014 \${result.steps} steps \xB7 \${result.toolCalls.length} tool calls\`)
+`,
+    ".env.example": PROVIDER_ENV_KEY[ctx.provider] ? `${PROVIDER_ENV_KEY[ctx.provider]}=
+` : "# No API key required for the local provider\n",
+    ".gitignore": `node_modules
+.env
+.env.local
+`,
+    "README.md": readmeFor(ctx)
   };
 }
+function readmeFor(ctx) {
+  const installCmd = ctx.pm === "npm" ? "npm install" : `${ctx.pm} install`;
+  const runCmd = ctx.pm === "npm" ? "npm run dev" : `${ctx.pm} dev`;
+  const envKey = PROVIDER_ENV_KEY[ctx.provider];
+  return `# AgentsKit ${ctx.template} starter
 
-// src/commands.ts
-function mergeWithConfig(options, config) {
-  if (!config) return options;
-  const d = config.defaults ?? {};
-  const resolvedApiKey = options.apiKey ?? (d.apiKeyEnv ? process.env[d.apiKeyEnv] : void 0) ?? d.apiKey;
-  return {
-    ...options,
-    // Config defaults — only apply if CLI flag wasn't set
-    provider: options.provider !== "demo" ? options.provider : d.provider ?? options.provider,
-    model: options.model ?? d.model,
-    apiKey: resolvedApiKey,
-    baseUrl: options.baseUrl ?? d.baseUrl,
-    tools: options.tools ?? d.tools,
-    skill: options.skill ?? d.skill,
-    system: options.system ?? d.system,
-    memoryBackend: options.memoryBackend ?? d.memoryBackend
+Generated by \`agentskit init\`.
+
+## Stack
+
+- **Template**: \`${ctx.template}\`
+- **Provider**: \`${ctx.provider}\`${ctx.tools.length ? `
+- **Tools**: ${ctx.tools.map((t) => `\`${t}\``).join(", ")}` : ""}${ctx.memory !== "none" ? `
+- **Memory**: \`${ctx.memory}\`` : ""}
+
+## Run
+
+\`\`\`bash
+${installCmd}
+${envKey ? `cp .env.example .env
+# add ${envKey}=...` : "# No API key required"}
+${runCmd}
+\`\`\`
+
+## Next steps
+
+- Open the AgentsKit docs at https://www.agentskit.io/docs
+- Add a custom skill: https://www.agentskit.io/docs/concepts/skill
+- Wire up RAG: https://www.agentskit.io/docs/recipes/rag-chat
+
+## License
+
+ISC
+`;
+}
+var TEMPLATE_FN = {
+  react: reactStarter,
+  ink: inkStarter,
+  runtime: runtimeStarter,
+  "multi-agent": multiAgentStarter
+};
+async function writeStarterProject(options) {
+  const ctx = {
+    template: options.template,
+    provider: options.provider ?? "demo",
+    tools: options.tools ?? [],
+    memory: options.memory ?? "none",
+    pm: options.packageManager ?? "pnpm"
   };
+  const files = TEMPLATE_FN[ctx.template](ctx);
+  await promises.mkdir(options.targetDir, { recursive: true });
+  await Promise.all(
+    Object.entries(files).map(async ([relativePath, content]) => {
+      const absolutePath = path__default.default.join(options.targetDir, relativePath);
+      await promises.mkdir(path__default.default.dirname(absolutePath), { recursive: true });
+      await promises.writeFile(absolutePath, content, "utf8");
+    })
+  );
 }
-function createCli() {
-  const program = new commander.Command();
-  program.name("agentskit").description("AgentsKit CLI for chat demos and project bootstrapping.");
-  program.command("chat").description("Start a terminal chat session.").option("--provider <provider>", "Provider to use", "demo").option("--model <model>", "Model name").option("--api-key <key>", "API key for the selected provider").option("--base-url <url>", "Override provider base URL").option("--system <prompt>", "System prompt").option("--memory <path>", "Explicit memory file path (overrides session management)").option("--tools <tools>", "Comma-separated tools: web_search,fetch_url,filesystem,shell").option("--skill <skills>", "Comma-separated skills: researcher,coder,planner,critic,summarizer").option("--memory-backend <backend>", "Memory backend: file (default), sqlite").option("--new", "Start a fresh chat session (ignore previous conversations in this directory)").option("--resume [id]", "Resume a prior session by id; omit id to resume the latest").option("--list-sessions", "List saved sessions for this directory and exit").option("--no-config", "Skip loading .agentskit.config.json").action(async (options) => {
-    if (options.listSessions) {
-      const sessions = listSessions();
-      if (sessions.length === 0) {
-        process.stdout.write("No saved sessions for this directory.\n");
-        return;
-      }
-      for (const s of sessions) {
-        const { id, updatedAt, messageCount, preview, model } = s.metadata;
-        process.stdout.write(
-          `${id}  ${updatedAt}  msgs=${messageCount}${model ? `  model=${model}` : ""}
-    ${preview}
-`
-        );
+async function runInteractiveInit(defaults = {}) {
+  process.stdout.write(`
+${kleur__default.default.bold().green("\u25B2")} ${kleur__default.default.bold("agentskit init")}
+`);
+  process.stdout.write(kleur__default.default.dim("   Generate a starter project \u2014 answer five questions.\n\n"));
+  try {
+    const targetDir = await prompts.input({
+      message: "Project directory:",
+      default: defaults.dir ?? "agentskit-app",
+      validate: (value) => {
+        if (!value.trim()) return "A directory name is required.";
+        const abs = path__default.default.resolve(process.cwd(), value);
+        if (fs.existsSync(abs)) return `${value} already exists. Pick a different name.`;
+        return true;
       }
-      return;
-    }
-    const config = options.config !== false ? await loadConfig() : void 0;
-    const merged = mergeWithConfig(options, config);
-    const session = resolveSession({
-      explicitPath: options.memory,
-      forceNew: Boolean(options.new),
-      resumeId: options.resume
     });
-    if (!session.isNew && !options.memory) {
-      process.stdout.write(
-        `Resuming session ${session.id}. Start fresh with --new or list with --list-sessions.
-`
-      );
-    }
-    const chatOptions = {
-      apiKey: merged.apiKey ?? options.apiKey,
-      baseUrl: merged.baseUrl ?? options.baseUrl,
-      provider: merged.provider,
-      model: merged.model,
-      system: merged.system ?? options.system,
-      memoryPath: session.file,
-      sessionId: session.id,
-      tools: merged.tools ?? options.tools,
-      skill: merged.skill ?? options.skill,
-      memoryBackend: merged.memoryBackend ?? options.memoryBackend,
-      agentsKitConfig: config
-    };
-    process.stdout.write(`${renderChatHeader(chatOptions)}
-`);
-    const instance = ink.render(React3__default.default.createElement(ChatApp, chatOptions));
-    await instance.waitUntilExit();
-    if (options.memory) {
-      process.stdout.write(
-        `
-Session saved to ${session.file}. Resume with --memory ${session.file}
-`
-      );
-    } else {
-      process.stdout.write(
-        `
-Session saved. Resume with:
-  agentskit chat --resume ${session.id}
-Or start fresh with:
-  agentskit chat --new
-`
-      );
+    const template = await prompts.select({
+      message: "Template:",
+      default: defaults.template ?? "react",
+      choices: [
+        { name: "React chat (Vite + browser)", value: "react", description: "Streaming UI with @agentskit/react" },
+        { name: "Ink chat (terminal UI)", value: "ink", description: "Same chat but in your terminal" },
+        { name: "Runtime (headless agent, no UI)", value: "runtime", description: "Autonomous task \u2192 result" },
+        { name: "Multi-agent (planner + delegates)", value: "multi-agent", description: "Supervisor pattern, ready to extend" }
+      ]
+    });
+    const provider = await prompts.select({
+      message: "LLM provider:",
+      default: "demo",
+      choices: [
+        { name: "Demo (no API key \u2014 deterministic stub)", value: "demo" },
+        { name: "OpenAI", value: "openai" },
+        { name: "Anthropic", value: "anthropic" },
+        { name: "Gemini", value: "gemini" },
+        { name: "Ollama (local, no key)", value: "ollama" }
+      ]
+    });
+    let tools = [];
+    if (template !== "react") {
+      tools = await prompts.checkbox({
+        message: "Tools (space to toggle, enter to confirm):",
+        choices: [
+          { name: "web_search", value: "web_search" },
+          { name: "filesystem", value: "filesystem" },
+          { name: "shell", value: "shell" }
+        ]
+      });
     }
-  });
-  program.command("run [task]").description("Execute an agent task and output the result.").option("--task <task>", "Task string (alternative to positional argument)").option("--provider <provider>", "Provider to use", "demo").option("--model <model>", "Model name").option("--api-key <key>", "API key for the selected provider").option("--base-url <url>", "Override provider base URL").option("--skill <skill>", "Single skill to use").option("--skills <skills>", "Comma-separated skills (composed together)").option("--tools <tools>", "Comma-separated tools: web_search,filesystem,shell").option("--memory <path>", "Path for memory persistence").option("--memory-backend <backend>", "Memory backend: file (default), sqlite").option("--system-prompt <prompt>", "System prompt").option("--max-steps <steps>", "Maximum agent steps", "10").option("--verbose", "Stream agent steps to stderr").option("--pretty", "Use rich Ink-based output").option("--no-config", "Skip loading .agentskit.config.json").action(async (positionalTask, options) => {
-    const task = options.task ?? positionalTask;
-    if (!task) {
-      process.stderr.write("Error: task is required. Pass as argument or use --task.\n");
-      process.exit(1);
+    const memory = await prompts.select({
+      message: "Memory backend:",
+      default: "none",
+      choices: [
+        { name: "None (stateless)", value: "none" },
+        { name: "File (JSON on disk)", value: "file" },
+        { name: "SQLite (better-sqlite3)", value: "sqlite" }
+      ]
+    });
+    const packageManager = await prompts.select({
+      message: "Package manager:",
+      default: "pnpm",
+      choices: [
+        { name: "pnpm", value: "pnpm" },
+        { name: "npm", value: "npm" },
+        { name: "yarn", value: "yarn" },
+        { name: "bun", value: "bun" }
+      ]
+    });
+    process.stdout.write("\n" + kleur__default.default.dim("  Summary:\n"));
+    process.stdout.write(kleur__default.default.dim(`    dir       ${targetDir}
+`));
+    process.stdout.write(kleur__default.default.dim(`    template  ${template}
+`));
+    process.stdout.write(kleur__default.default.dim(`    provider  ${provider}
+`));
+    if (tools.length) process.stdout.write(kleur__default.default.dim(`    tools     ${tools.join(", ")}
+`));
+    process.stdout.write(kleur__default.default.dim(`    memory    ${memory}
+`));
+    process.stdout.write(kleur__default.default.dim(`    pm        ${packageManager}
+
+`));
+    const proceed = await prompts.confirm({ message: "Generate?", default: true });
+    if (!proceed) {
+      process.stdout.write(kleur__default.default.yellow("Cancelled.\n"));
+      return { cancelled: true, options: { targetDir, template, provider, tools, memory, packageManager } };
     }
-    const config = options.config !== false ? await loadConfig() : void 0;
-    const merged = mergeWithConfig(options, config);
-    if (options.pretty) {
-      ink.render(React3__default.default.createElement(RunApp, { task, options }));
-    } else {
-      try {
-        await runAgent(task, { ...options, provider: merged.provider, model: merged.model });
-      } catch (err) {
-        process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
-`);
-        process.exit(1);
+    return {
+      cancelled: false,
+      options: {
+        targetDir: path__default.default.resolve(process.cwd(), targetDir),
+        template,
+        provider,
+        tools,
+        memory,
+        packageManager
       }
+    };
+  } catch (err) {
+    if (err.name === "ExitPromptError") {
+      process.stdout.write(kleur__default.default.yellow("\nCancelled.\n"));
+      return { cancelled: true, options: { targetDir: "", template: "react" } };
     }
-  });
+    throw err;
+  }
+}
+function printNextSteps(options) {
+  const dir = path__default.default.relative(process.cwd(), options.targetDir) || ".";
+  const pm = options.packageManager ?? "pnpm";
+  const installCmd = pm === "npm" ? "npm install" : `${pm} install`;
+  const runCmd = pm === "npm" ? "npm run dev" : `${pm} dev`;
+  process.stdout.write("\n" + kleur__default.default.green("\u2713 Created starter at ") + kleur__default.default.bold(dir) + "\n\n");
+  process.stdout.write(kleur__default.default.bold("Next steps:\n\n"));
+  process.stdout.write(`  ${kleur__default.default.cyan("cd")} ${dir}
+`);
+  process.stdout.write(`  ${kleur__default.default.cyan(installCmd)}
+`);
+  if (options.provider && options.provider !== "demo" && options.provider !== "ollama") {
+    process.stdout.write(
+      `  ${kleur__default.default.cyan("cp")} .env.example .env  ${kleur__default.default.dim("# add your API key")}
+`
+    );
+  }
+  process.stdout.write(`  ${kleur__default.default.cyan(runCmd)}
+
+`);
+  process.stdout.write(kleur__default.default.dim("  Docs: https://www.agentskit.io/docs\n\n"));
+}
+
+// src/commands/init.ts
+function registerInitCommand(program) {
   program.command("init").description("Generate a starter project. Run with no flags for interactive mode.").option("--template <template>", "Starter template (react|ink|runtime|multi-agent)").option("--dir <directory>", "Target directory", "agentskit-app").option("--provider <provider>", "LLM provider (openai|anthropic|gemini|ollama|demo)").option("--tools <tools>", "Comma-separated tools (web_search,filesystem,shell)").option("--memory <backend>", "Memory backend (none|file|sqlite)").option("--pm <packageManager>", "Package manager (pnpm|npm|yarn|bun)").option("-y, --yes", "Skip interactive prompts; use flag values + defaults").action(async (rawOptions) => {
     const isCi = !process.stdout.isTTY || rawOptions.yes || rawOptions.template;
     let resolved;
     if (isCi) {
       const template = rawOptions.template ?? "react";
       resolved = {
-        targetDir: path3__default.default.resolve(process.cwd(), rawOptions.dir),
+        targetDir: path__default.default.resolve(process.cwd(), rawOptions.dir),
         template,
         provider: rawOptions.provider ?? "demo",
         tools: rawOptions.tools ? rawOptions.tools.split(",").map((t) => t.trim()) : [],
@@ -2073,13 +2285,282 @@ Or start fresh with:
     await writeStarterProject(resolved);
     if (isCi) {
       process.stdout.write(
-        `Created ${resolved.template} starter in ${path3__default.default.relative(process.cwd(), resolved.targetDir) || "."}
+        `Created ${resolved.template} starter in ${path__default.default.relative(process.cwd(), resolved.targetDir) || "."}
 `
       );
     } else {
-      printNextSteps(resolved);
+      printNextSteps(resolved);
+    }
+  });
+}
+var PROVIDER_ENV_KEYS = {
+  openai: "OPENAI_API_KEY",
+  anthropic: "ANTHROPIC_API_KEY",
+  gemini: "GEMINI_API_KEY",
+  deepseek: "DEEPSEEK_API_KEY",
+  grok: "XAI_API_KEY",
+  kimi: "KIMI_API_KEY"
+};
+var PROVIDER_REACH_URLS = {
+  openai: "https://api.openai.com/v1/models",
+  anthropic: "https://api.anthropic.com/v1/messages",
+  gemini: "https://generativelanguage.googleapis.com/v1beta/models",
+  ollama: "http://localhost:11434/api/tags"
+};
+async function checkNodeVersion() {
+  const major = Number(process.versions.node.split(".")[0]);
+  if (Number.isNaN(major)) {
+    return { status: "fail", name: "Node version", detail: "Could not parse process.versions.node" };
+  }
+  if (major < 22) {
+    return {
+      status: "fail",
+      name: "Node version",
+      detail: `Node ${process.versions.node} (need 22+)`,
+      fix: "Install Node 22 LTS or newer (https://nodejs.org)"
+    };
+  }
+  if (major === 25) {
+    return {
+      status: "warn",
+      name: "Node version",
+      detail: `Node ${process.versions.node} \u2014 Docusaurus apps may break here`,
+      fix: "Use Node 22 LTS for the legacy docs app, or stay on 25 for everything else"
+    };
+  }
+  return { status: "pass", name: "Node version", detail: `Node ${process.versions.node}` };
+}
+async function checkPnpm() {
+  const cwd = process.cwd();
+  const hasPnpm = fs.existsSync(path.join(cwd, "pnpm-lock.yaml")) || fs.existsSync(path.join(cwd, "pnpm-workspace.yaml"));
+  if (hasPnpm) {
+    return { status: "pass", name: "Package manager", detail: "pnpm detected (lockfile)" };
+  }
+  if (fs.existsSync(path.join(cwd, "package-lock.json"))) {
+    return { status: "warn", name: "Package manager", detail: "npm detected \u2014 pnpm recommended for monorepo workflows" };
+  }
+  if (fs.existsSync(path.join(cwd, "yarn.lock"))) {
+    return { status: "pass", name: "Package manager", detail: "yarn detected" };
+  }
+  if (fs.existsSync(path.join(cwd, "bun.lock")) || fs.existsSync(path.join(cwd, "bun.lockb"))) {
+    return { status: "pass", name: "Package manager", detail: "bun detected" };
+  }
+  return {
+    status: "skip",
+    name: "Package manager",
+    detail: "No lockfile found in cwd"
+  };
+}
+async function checkPackageJson() {
+  const path5 = path.join(process.cwd(), "package.json");
+  if (!fs.existsSync(path5)) {
+    return {
+      status: "warn",
+      name: "package.json",
+      detail: "No package.json in cwd",
+      fix: "Run from a project directory (or use `agentskit init` to create one)"
+    };
+  }
+  try {
+    const pkg = JSON.parse(await promises.readFile(path5, "utf8"));
+    const deps = {
+      ...pkg.dependencies ?? {},
+      ...pkg.devDependencies ?? {}
+    };
+    const akDeps = Object.entries(deps).filter(([name]) => name.startsWith("@agentskit/"));
+    if (akDeps.length === 0) {
+      return { status: "skip", name: "AgentsKit packages", detail: "No @agentskit/* deps found in package.json" };
+    }
+    return {
+      status: "pass",
+      name: "AgentsKit packages",
+      detail: `${akDeps.length} installed: ${akDeps.map(([n]) => n.replace("@agentskit/", "")).join(", ")}`
+    };
+  } catch (err) {
+    return {
+      status: "fail",
+      name: "package.json",
+      detail: `Could not parse: ${err.message}`
+    };
+  }
+}
+async function checkProviderEnv(provider) {
+  const envKey = PROVIDER_ENV_KEYS[provider];
+  if (!envKey) {
+    return { status: "skip", name: `${provider} API key`, detail: "No env-key requirement for this provider" };
+  }
+  const value = process.env[envKey];
+  if (!value) {
+    return {
+      status: "skip",
+      name: `${provider} API key`,
+      detail: `${envKey} not set`,
+      fix: `export ${envKey}=... (only needed if you use ${provider})`
+    };
+  }
+  if (value.length < 16) {
+    return {
+      status: "warn",
+      name: `${provider} API key`,
+      detail: `${envKey} looks too short (${value.length} chars)`,
+      fix: "Verify the key is complete and not truncated"
+    };
+  }
+  return { status: "pass", name: `${provider} API key`, detail: `${envKey} set (${value.length} chars)` };
+}
+async function checkProviderReachable(provider, fetchImpl = fetch, timeoutMs = 4e3) {
+  const url = PROVIDER_REACH_URLS[provider];
+  if (!url) {
+    return { status: "skip", name: `${provider} reachable`, detail: "No reachability check configured" };
+  }
+  const envKey = PROVIDER_ENV_KEYS[provider];
+  if (envKey && !process.env[envKey]) {
+    return { status: "skip", name: `${provider} reachable`, detail: "Skipped \u2014 no API key configured" };
+  }
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const res = await fetchImpl(url, {
+      method: "GET",
+      signal: controller.signal
+    });
+    if (res.status >= 200 && res.status < 400) {
+      return { status: "pass", name: `${provider} reachable`, detail: `${url} \u2192 ${res.status} OK` };
+    }
+    if (res.status === 401 || res.status === 403 || res.status === 405) {
+      return { status: "pass", name: `${provider} reachable`, detail: `${url} \u2192 ${res.status} (host reachable)` };
+    }
+    return {
+      status: "warn",
+      name: `${provider} reachable`,
+      detail: `${url} \u2192 HTTP ${res.status}`,
+      fix: "Host reachable but returned unexpected status \u2014 check provider docs"
+    };
+  } catch (err) {
+    const reason = err.name === "AbortError" ? `timeout after ${timeoutMs}ms` : err.message;
+    return {
+      status: "fail",
+      name: `${provider} reachable`,
+      detail: `${url} \u2192 ${reason}`,
+      fix: provider === "ollama" ? "Start Ollama: `ollama serve` (or install from https://ollama.com)" : "Check network / firewall / VPN settings"
+    };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function checkConfig() {
+  try {
+    const config = await loadConfig();
+    if (!config) {
+      return { status: "skip", name: "AgentsKit config", detail: "No .agentskit.config or package.json#agentskit found" };
+    }
+    return {
+      status: "pass",
+      name: "AgentsKit config",
+      detail: `loaded \u2014 defaults: ${JSON.stringify(config.defaults ?? {})}`
+    };
+  } catch (err) {
+    return {
+      status: "warn",
+      name: "AgentsKit config",
+      detail: `Could not load: ${err.message}`
+    };
+  }
+}
+async function runDoctor(options = {}) {
+  const providers2 = options.providers ?? ["openai", "anthropic", "gemini", "ollama"];
+  const fetchImpl = options.fetchImpl ?? fetch;
+  const checks = [
+    checkNodeVersion(),
+    checkPnpm(),
+    checkPackageJson(),
+    checkConfig()
+  ];
+  for (const provider of providers2) {
+    checks.push(checkProviderEnv(provider));
+    if (!options.noNetwork) {
+      checks.push(checkProviderReachable(provider, fetchImpl));
+    }
+  }
+  const results = await Promise.all(checks);
+  return {
+    results,
+    pass: results.filter((r) => r.status === "pass").length,
+    warn: results.filter((r) => r.status === "warn").length,
+    fail: results.filter((r) => r.status === "fail").length,
+    skip: results.filter((r) => r.status === "skip").length
+  };
+}
+var ICON = {
+  pass: "\u2714",
+  warn: "\u26A0",
+  fail: "\u2718",
+  skip: "\u25CB"
+};
+function renderReport(report, opts = {}) {
+  const color = opts.color ?? true;
+  const c = (code, text) => color ? `\x1B[${code}m${text}\x1B[0m` : text;
+  const colorFor = {
+    pass: (t) => c("32", t),
+    // green
+    warn: (t) => c("33", t),
+    // yellow
+    fail: (t) => c("31", t),
+    // red
+    skip: (t) => c("90", t)
+    // dim
+  };
+  const lines = [];
+  lines.push("");
+  lines.push(`  ${c("1;36", "\u26A1 AgentsKit Doctor")}`);
+  lines.push(`  ${c("90", "\u2500".repeat(50))}`);
+  lines.push("");
+  const groups = {
+    "Environment": [],
+    "Providers": [],
+    "Network": []
+  };
+  for (const r of report.results) {
+    if (r.name.includes("reachable")) {
+      groups["Network"].push(r);
+    } else if (r.name.includes("API key")) {
+      groups["Providers"].push(r);
+    } else {
+      groups["Environment"].push(r);
     }
-  });
+  }
+  for (const [group, results] of Object.entries(groups)) {
+    if (results.length === 0) continue;
+    lines.push(`  ${c("1", group)}`);
+    for (const r of results) {
+      const icon = colorFor[r.status](ICON[r.status]);
+      const name = r.name.padEnd(28);
+      const detail = r.detail ? c("90", r.detail) : "";
+      lines.push(`    ${icon}  ${name} ${detail}`);
+      if (r.fix && r.status !== "pass") {
+        lines.push(`       ${c("90", "\u21B3 " + r.fix)}`);
+      }
+    }
+    lines.push("");
+  }
+  lines.push(`  ${c("90", "\u2500".repeat(50))}`);
+  const parts = [];
+  if (report.pass > 0) parts.push(colorFor.pass(`${report.pass} passed`));
+  if (report.warn > 0) parts.push(colorFor.warn(`${report.warn} warnings`));
+  if (report.fail > 0) parts.push(colorFor.fail(`${report.fail} failed`));
+  if (report.skip > 0) parts.push(colorFor.skip(`${report.skip} skipped`));
+  lines.push(`  ${parts.join("  \xB7  ")}`);
+  if (report.fail === 0) {
+    lines.push(`  ${c("32", "\u2714 Ready to build agents.")}`);
+  } else {
+    lines.push(`  ${c("31", "\u2718 Fix the issues above before continuing.")}`);
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+
+// src/commands/doctor.ts
+function registerDoctorCommand(program) {
   program.command("doctor").description("Diagnose your AgentsKit environment.").option("--no-network", "Skip provider reachability checks").option(
     "--providers <providers>",
     "Comma-separated providers to check (default: openai,anthropic,gemini,ollama)"
@@ -2096,6 +2577,117 @@ Or start fresh with:
     }
     if (report.fail > 0) process.exit(1);
   });
+}
+var DEFAULT_WATCH = [
+  "**/*.ts",
+  "**/*.tsx",
+  "**/*.mjs",
+  "**/*.json",
+  ".agentskit.config.*"
+];
+var DEFAULT_IGNORE = [
+  "**/node_modules/**",
+  "**/dist/**",
+  "**/build/**",
+  "**/.next/**",
+  "**/.turbo/**",
+  "**/.git/**",
+  "**/coverage/**",
+  "**/*.test.ts",
+  "**/*.spec.ts"
+];
+function startDev(options) {
+  const entry = path.resolve(process.cwd(), options.entry);
+  if (!fs.existsSync(entry)) {
+    throw new Error(`Entry file not found: ${entry}`);
+  }
+  const stdout = options.stdout ?? process.stdout;
+  const stderr = options.stderr ?? process.stderr;
+  const debounceMs = options.debounceMs ?? 200;
+  const isTs = entry.endsWith(".ts") || entry.endsWith(".tsx");
+  const cmd = isTs ? "tsx" : "node";
+  const baseArgs = [entry, ...options.scriptArgs ?? []];
+  const spawnFn = options.spawn ?? ((c, a) => child_process.spawn(c, a, {
+    stdio: ["inherit", "pipe", "pipe"],
+    env: { ...process.env, FORCE_COLOR: "1" }
+  }));
+  const watchPaths = options.watch ?? DEFAULT_WATCH;
+  const ignorePaths = [...DEFAULT_IGNORE, ...options.ignore ?? []];
+  const watcherFactory = options.watcher ?? ((paths, opts) => chokidar__default.default.watch(paths, { ignored: opts.ignored, ignoreInitial: true }));
+  const watcher = watcherFactory(watchPaths, { ignored: ignorePaths });
+  let child;
+  let restartCount = 0;
+  let restartTimer;
+  let stopped = false;
+  let resolveDone;
+  const done = new Promise((r) => {
+    resolveDone = r;
+  });
+  const banner = (msg, color = "green") => {
+    const time = (/* @__PURE__ */ new Date()).toTimeString().slice(0, 8);
+    stdout.write(kleur__default.default[color](`[agentskit dev ${time}] `) + msg + "\n");
+  };
+  const startChild = () => {
+    restartCount++;
+    banner(`\u25B8 starting ${kleur__default.default.bold(path.basename(entry))} (restart #${restartCount - 1})`, "cyan");
+    const c = spawnFn(cmd, baseArgs);
+    child = c;
+    c.stdout?.on("data", (d) => stdout.write(d));
+    c.stderr?.on("data", (d) => stderr.write(d));
+    c.on("exit", (code, signal) => {
+      if (stopped) return;
+      if (signal === "SIGTERM" || signal === "SIGINT") return;
+      if (code === 0) {
+        banner(`\u2713 exited cleanly \u2014 waiting for changes`, "green");
+      } else {
+        banner(`\u2717 exited with code ${code} \u2014 waiting for changes`, "red");
+      }
+    });
+  };
+  const restart = (path5) => {
+    if (restartTimer) clearTimeout(restartTimer);
+    restartTimer = setTimeout(() => {
+      restartTimer = void 0;
+      banner(`\u21BB change detected \u2014 ${path5}`, "yellow");
+      if (child && !child.killed && child.exitCode === null) {
+        child.kill("SIGTERM");
+      }
+      setTimeout(startChild, 80);
+    }, debounceMs);
+  };
+  watcher.on("change", restart);
+  watcher.on("add", restart);
+  watcher.on("unlink", restart);
+  startChild();
+  const stop = async () => {
+    if (stopped) return;
+    stopped = true;
+    if (restartTimer) clearTimeout(restartTimer);
+    if (child && !child.killed && child.exitCode === null) {
+      child.kill("SIGTERM");
+    }
+    await watcher.close();
+    banner(`stopped`, "cyan");
+    resolveDone();
+  };
+  if (process.stdin.isTTY && process.stdin.setRawMode) {
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.on("data", (data) => {
+      const key = data.toString();
+      if (key === "r") restart("manual");
+      if (key === "q" || key === "") void stop();
+    });
+  }
+  return {
+    done,
+    stop,
+    restarts: () => restartCount
+  };
+}
+
+// src/commands/dev.ts
+function registerDevCommand(program) {
   program.command("dev [entry]").description("Run an entry file with hot-reload on file changes.").option("--watch <globs>", "Comma-separated glob patterns to watch").option("--ignore <globs>", "Comma-separated glob patterns to ignore").option("--debounce <ms>", "Debounce window before restart", "200").action(async (positional, options) => {
     const entry = positional ?? "src/index.ts";
     const watch = options.watch ? options.watch.split(",").map((s) => s.trim()).filter(Boolean) : void 0;
@@ -2114,9 +2706,15 @@ Or start fresh with:
       process.exit(1);
     }
   });
-  program.command("config").description("Show or scaffold the AgentsKit config.").argument("[action]", 'Action: "init" to create a template, "show" to print the merged config.', "show").option("--global", "Write/read the global config at ~/.agentskit/config.json (default)").option("--local", "Write/read a project-level .agentskit.config.json in the current directory").option("--force", "Overwrite an existing config file").action(async (action, options) => {
+}
+function registerConfigCommand(program) {
+  program.command("config").description("Show or scaffold the AgentsKit config.").argument(
+    "[action]",
+    'Action: "init" to create a template, "show" to print the merged config.',
+    "show"
+  ).option("--global", "Write/read the global config at ~/.agentskit/config.json (default)").option("--local", "Write/read a project-level .agentskit.config.json in the current directory").option("--force", "Overwrite an existing config file").action(async (action, options) => {
     const isLocal = Boolean(options.local);
-    const targetPath = isLocal ? path3__default.default.join(process.cwd(), ".agentskit.config.json") : path3__default.default.join(os.homedir(), ".agentskit", "config.json");
+    const targetPath = isLocal ? path__default.default.join(process.cwd(), ".agentskit.config.json") : path__default.default.join(os.homedir(), ".agentskit", "config.json");
     if (action === "show") {
       const config = await loadConfig();
       process.stdout.write(JSON.stringify(config ?? {}, null, 2) + "\n");
@@ -2128,8 +2726,10 @@ Or start fresh with:
       process.exit(2);
     }
     if (fs.existsSync(targetPath) && !options.force) {
-      process.stderr.write(`Config already exists at ${targetPath}. Re-run with --force to overwrite.
-`);
+      process.stderr.write(
+        `Config already exists at ${targetPath}. Re-run with --force to overwrite.
+`
+      );
       process.exit(1);
     }
     const template = {
@@ -2141,7 +2741,7 @@ Or start fresh with:
         tools: "web_search,fetch_url"
       }
     };
-    fs.mkdirSync(path3__default.default.dirname(targetPath), { recursive: true });
+    fs.mkdirSync(path__default.default.dirname(targetPath), { recursive: true });
     fs.writeFileSync(targetPath, JSON.stringify(template, null, 2) + "\n");
     process.stdout.write(
       `Wrote ${targetPath}
@@ -2151,6 +2751,74 @@ Edit it to taste, then run:
 `
     );
   });
+}
+async function startTunnel(options) {
+  const stdout = options.stdout ?? process.stdout;
+  const open = options.open ?? (async (opts) => {
+    const lt = (await import('localtunnel')).default;
+    return await lt(opts);
+  });
+  const banner = (msg, color = "green") => {
+    const time = (/* @__PURE__ */ new Date()).toTimeString().slice(0, 8);
+    stdout.write(kleur__default.default[color](`[agentskit tunnel ${time}] `) + msg + "\n");
+  };
+  banner(`opening tunnel to ${options.host ?? "localhost"}:${options.port}...`, "cyan");
+  const tunnel = await open({
+    port: options.port,
+    subdomain: options.subdomain,
+    local_host: options.host
+  });
+  let requests = 0;
+  let stopped = false;
+  let resolveDone;
+  const done = new Promise((r) => {
+    resolveDone = r;
+  });
+  tunnel.on("request", () => {
+    requests++;
+  });
+  tunnel.on("close", () => {
+    if (stopped) return;
+    banner(`tunnel closed by remote`, "yellow");
+    resolveDone();
+  });
+  tunnel.on("error", (...args) => {
+    const err = args[0];
+    banner(`error: ${err?.message ?? "unknown"}`, "red");
+  });
+  banner(`\u2713 ready`, "green");
+  stdout.write("\n");
+  stdout.write(`  ${kleur__default.default.bold("Public URL:")}  ${kleur__default.default.cyan(tunnel.url)}
+`);
+  stdout.write(`  ${kleur__default.default.bold("Local:")}       http://${options.host ?? "localhost"}:${options.port}
+`);
+  stdout.write("\n");
+  stdout.write(kleur__default.default.dim(`  Forward webhooks here, then ${kleur__default.default.bold("Ctrl+C")} to stop.
+
+`));
+  options.onReady?.(tunnel.url);
+  const stop = async () => {
+    if (stopped) return;
+    stopped = true;
+    tunnel.close();
+    banner(`stopped \u2014 proxied ${requests} request${requests === 1 ? "" : "s"}`, "cyan");
+    resolveDone();
+  };
+  if (process.stdin.isTTY) {
+    process.on("SIGINT", () => {
+      void stop();
+    });
+  }
+  return {
+    url: tunnel.url,
+    done,
+    stop,
+    requests: () => requests
+  };
+}
+
+// src/commands/tunnel.ts
+function registerTunnelCommand(program) {
   program.command("tunnel <port>").description("Open a public URL pointing to a local port (great for webhooks).").option("--subdomain <name>", "Hint for a stable subdomain (provider may decline)").option("--host <host>", "Local hostname", "localhost").action(async (port, options) => {
     const portNum = Number(port);
     if (Number.isNaN(portNum) || portNum < 1 || portNum > 65535) {
@@ -2171,6 +2839,130 @@ Edit it to taste, then run:
       process.exit(1);
     }
   });
+}
+
+// src/extensibility/rag/embedders.ts
+function createOpenAiEmbedder(config) {
+  const model = config.model ?? "text-embedding-3-small";
+  const baseUrl = (config.baseUrl ?? "https://api.openai.com").replace(/\/$/, "");
+  return async (text) => {
+    const res = await fetch(`${baseUrl}/v1/embeddings`, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        authorization: `Bearer ${config.apiKey}`
+      },
+      body: JSON.stringify({ model, input: text })
+    });
+    if (!res.ok) {
+      const body = await res.text().catch(() => "");
+      throw new Error(`embedder ${model} HTTP ${res.status}: ${body}`);
+    }
+    const json = await res.json();
+    const first = json.data?.[0]?.embedding;
+    if (!first) throw new Error(`embedder ${model}: response missing data[0].embedding`);
+    return first;
+  };
+}
+function resolveEmbedder(config) {
+  const embedder = config.embedder;
+  const provider = embedder?.provider ?? "openai";
+  if (provider !== "openai") {
+    throw new Error(`Unsupported RAG embedder provider: ${provider}. Only "openai" is built-in.`);
+  }
+  const apiKey = embedder?.apiKey ?? process.env.OPENAI_API_KEY ?? process.env.OPENROUTER_API_KEY;
+  if (!apiKey) {
+    throw new Error("RAG embedder needs an API key (config.rag.embedder.apiKey or OPENAI_API_KEY env).");
+  }
+  return createOpenAiEmbedder({
+    apiKey,
+    model: embedder?.model,
+    baseUrl: embedder?.baseUrl
+  });
+}
+function buildRagFromConfig(options) {
+  const cwd = options.cwd ?? process.cwd();
+  const dir = path.resolve(cwd, options.config.dir ?? "./.agentskit-rag");
+  const store = memory.fileVectorMemory({ path: `${dir}/store.json` });
+  const embed = options.embedder ?? resolveEmbedder(options.config);
+  return rag.createRAG({
+    embed,
+    store,
+    chunkSize: options.config.chunkSize,
+    topK: options.config.topK
+  });
+}
+async function indexSources(rag, config, cwd) {
+  const root = process.cwd();
+  const sources = config.sources ?? [];
+  const absolutePaths = [];
+  for (const pattern of sources) {
+    for await (const match of promises.glob(pattern, { cwd: root })) {
+      absolutePaths.push(path.resolve(root, match));
+    }
+  }
+  const documents = await Promise.all(
+    absolutePaths.map(async (path5) => ({
+      id: path5,
+      content: await promises.readFile(path5, "utf8"),
+      source: path5
+    }))
+  );
+  if (documents.length > 0) await rag.ingest(documents);
+  return { documentCount: documents.length, sources: absolutePaths };
+}
+
+// src/commands/rag.ts
+function registerRagCommand(program) {
+  const rag = program.command("rag").description("Retrieval-augmented generation utilities.");
+  rag.command("index").description("Index files referenced by config.rag.sources into the vector store.").option(
+    "--source <glob>",
+    "Glob to index (overrides config.rag.sources; repeatable)",
+    (value, prev = []) => [...prev, value],
+    []
+  ).action(async (options) => {
+    const config = await loadConfig();
+    const rawConfig = config?.rag;
+    const overrideSources = options.source;
+    const ragConfig = {
+      ...rawConfig ?? {},
+      sources: overrideSources.length > 0 ? overrideSources : rawConfig?.sources ?? []
+    };
+    if (!ragConfig.sources || ragConfig.sources.length === 0) {
+      process.stderr.write("No RAG sources configured. Set config.rag.sources or pass --source <glob>.\n");
+      process.exit(1);
+    }
+    try {
+      const instance = buildRagFromConfig({ config: ragConfig });
+      const result = await indexSources(instance, ragConfig);
+      process.stdout.write(
+        `Indexed ${result.documentCount} document${result.documentCount === 1 ? "" : "s"}.
+`
+      );
+      for (const source of result.sources) {
+        process.stdout.write(`  \u2022 ${source}
+`);
+      }
+    } catch (err) {
+      process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
+`);
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/index.ts
+function createCli() {
+  const program = new commander.Command();
+  program.name("agentskit").description("AgentsKit CLI for chat demos and project bootstrapping.");
+  registerChatCommand(program);
+  registerRunCommand(program);
+  registerInitCommand(program);
+  registerDoctorCommand(program);
+  registerDevCommand(program);
+  registerConfigCommand(program);
+  registerTunnelCommand(program);
+  registerRagCommand(program);
   return program;
 }