@voltx/cli 0.3.2 → 0.3.4

package/dist/index.js

@@ -148,6 +148,13 @@ function printWelcomeBanner(projectName) {
 }
 
 // src/create.ts
+var V = "^0.3.0";
+var TEMPLATE_DEPS = {
+  blank: { "@voltx/core": V, "@voltx/server": V },
+  chatbot: { "@voltx/core": V, "@voltx/ai": V, "@voltx/server": V, "@voltx/memory": V },
+  "rag-app": { "@voltx/core": V, "@voltx/ai": V, "@voltx/server": V, "@voltx/rag": V, "@voltx/db": V },
+  "agent-app": { "@voltx/core": V, "@voltx/ai": V, "@voltx/server": V, "@voltx/agents": V, "@voltx/memory": V }
+};
 async function createProject(options) {
   const { name, template = "blank", auth = "none" } = options;
   const targetDir = path.resolve(process.cwd(), name);
@@ -156,62 +163,26 @@ async function createProject(options) {
     process.exit(1);
   }
   fs.mkdirSync(targetDir, { recursive: true });
-  const templateDeps = {
-    blank: {
-      "@voltx/core": "^0.3.0",
-      "@voltx/server": "^0.3.0"
-    },
-    chatbot: {
-      "@voltx/core": "^0.3.0",
-      "@voltx/ai": "^0.3.0",
-      "@voltx/server": "^0.3.0",
-      "@voltx/memory": "^0.3.0"
-    },
-    "rag-app": {
-      "@voltx/core": "^0.3.0",
-      "@voltx/ai": "^0.3.0",
-      "@voltx/server": "^0.3.0",
-      "@voltx/rag": "^0.3.0",
-      "@voltx/db": "^0.3.0"
-    },
-    "agent-app": {
-      "@voltx/core": "^0.3.0",
-      "@voltx/ai": "^0.3.0",
-      "@voltx/server": "^0.3.0",
-      "@voltx/agents": "^0.3.0",
-      "@voltx/memory": "^0.3.0"
-    }
-  };
-  const packageJson = {
+  const provider = template === "rag-app" ? "openai" : "cerebras";
+  const model = template === "rag-app" ? "gpt-4o" : "llama3.1-8b";
+  const hasDb = template === "rag-app" || template === "agent-app" || auth === "better-auth";
+  const deps = { ...TEMPLATE_DEPS[template] ?? TEMPLATE_DEPS["blank"], "@voltx/cli": V };
+  if (auth === "better-auth") {
+    deps["@voltx/auth"] = V;
+    deps["better-auth"] = "^1.5.0";
+  } else if (auth === "jwt") {
+    deps["@voltx/auth"] = V;
+    deps["jose"] = "^6.0.0";
+  }
+  fs.writeFileSync(path.join(targetDir, "package.json"), JSON.stringify({
     name,
     version: "0.1.0",
     private: true,
-    scripts: {
-      dev: "voltx dev",
-      build: "voltx build",
-      start: "voltx start"
-    },
-    dependencies: {
-      ...templateDeps[template] ?? templateDeps["blank"],
-      "@voltx/cli": "^0.3.0",
-      ...auth === "better-auth" ? { "@voltx/auth": "^0.3.0", "better-auth": "^1.5.0" } : {},
-      ...auth === "jwt" ? { "@voltx/auth": "^0.3.0", "jose": "^6.0.0" } : {}
-    },
-    devDependencies: {
-      typescript: "^5.7.0",
-      tsx: "^4.21.0",
-      tsup: "^8.0.0",
-      "@types/node": "^22.0.0"
-    }
-  };
-  fs.writeFileSync(
-    path.join(targetDir, "package.json"),
-    JSON.stringify(packageJson, null, 2)
-  );
-  const hasDb = template === "rag-app" || template === "agent-app" || auth === "better-auth";
-  const provider = template === "rag-app" ? "openai" : "cerebras";
-  const model = template === "rag-app" ? "gpt-4o" : "llama-4-scout-17b-16e";
-  let configContent = `import { defineConfig } from "@voltx/core";
+    scripts: { dev: "voltx dev", build: "voltx build", start: "voltx start" },
+    dependencies: deps,
+    devDependencies: { typescript: "^5.7.0", tsx: "^4.21.0", tsup: "^8.0.0", "@types/node": "^22.0.0" }
+  }, null, 2));
+  let config = `import { defineConfig } from "@voltx/core";
 
 export default defineConfig({
   name: "${name}",
@@ -220,19 +191,15 @@ export default defineConfig({
     provider: "${provider}",
     model: "${model}",
   },`;
-  if (hasDb) {
-    configContent += `
+  if (hasDb) config += `
   db: {
     url: process.env.DATABASE_URL,
   },`;
-  }
-  if (auth !== "none") {
-    configContent += `
+  if (auth !== "none") config += `
   auth: {
     provider: "${auth}",
   },`;
-  }
-  configContent += `
+  config += `
   server: {
     routesDir: "src/routes",
     staticDir: "public",
@@ -240,9 +207,13 @@ export default defineConfig({
   },
 });
 `;
-  fs.writeFileSync(path.join(targetDir, "voltx.config.ts"), configContent);
+  fs.writeFileSync(path.join(targetDir, "voltx.config.ts"), config);
   fs.mkdirSync(path.join(targetDir, "src", "routes", "api"), { recursive: true });
   fs.mkdirSync(path.join(targetDir, "public"), { recursive: true });
+  fs.writeFileSync(path.join(targetDir, "tsconfig.json"), JSON.stringify({
+    compilerOptions: { target: "ES2022", module: "ESNext", moduleResolution: "bundler", strict: true, esModuleInterop: true, skipLibCheck: true, outDir: "dist" },
+    include: ["src", "voltx.config.ts"]
+  }, null, 2));
   fs.writeFileSync(
     path.join(targetDir, "src", "index.ts"),
     `import { createApp } from "@voltx/core";
@@ -270,19 +241,16 @@ import type { Context } from "@voltx/server";
 import { streamText } from "@voltx/ai";
 import { createMemory } from "@voltx/memory";
 
-// In-memory for dev; swap to createMemory("postgres", { url }) for production
 const memory = createMemory({ maxMessages: 50 });
 
 export async function POST(c: Context) {
   const { messages, conversationId = "default" } = await c.req.json();
 
-  // Store the latest user message
   const lastMessage = messages[messages.length - 1];
   if (lastMessage?.role === "user") {
     await memory.add(conversationId, { role: "user", content: lastMessage.content });
   }
 
-  // Get conversation history from memory
   const history = await memory.get(conversationId);
 
   const result = await streamText({
@@ -291,7 +259,6 @@ export async function POST(c: Context) {
     messages: history.map((m) => ({ role: m.role, content: m.content })),
   });
 
-  // Store assistant response after stream completes
   result.text.then(async (text) => {
     await memory.add(conversationId, { role: "assistant", content: text });
   });
@@ -304,41 +271,69 @@ export async function POST(c: Context) {
   if (template === "agent-app") {
     fs.mkdirSync(path.join(targetDir, "src", "agents"), { recursive: true });
     fs.mkdirSync(path.join(targetDir, "src", "tools"), { recursive: true });
-    fs.writeFileSync(
-      path.join(targetDir, "src", "agents", "assistant.ts"),
-      `import { createAgent } from "@voltx/agents";
-import { searchTool } from "../tools/search";
+    fs.writeFileSync(path.join(targetDir, "src", "tools", "calculator.ts"), `// Calculator tool \u2014 evaluates math expressions (no API key needed)
+import type { Tool } from "@voltx/agents";
 
-export const assistant = createAgent({
-  name: "assistant",
-  model: "${provider}:${model}",
-  instructions: "You are a helpful AI assistant. Use your tools when needed.",
-  tools: [searchTool],
-  maxIterations: 5,
-});
-`
-    );
-    fs.writeFileSync(
-      path.join(targetDir, "src", "tools", "search.ts"),
-      `import type { Tool } from "@voltx/agents";
+export const calculatorTool: Tool = {
+  name: "calculator",
+  description: "Evaluate a math expression. Supports +, -, *, /, %, parentheses, and Math functions.",
+  parameters: {
+    type: "object",
+    properties: { expression: { type: "string", description: "The math expression to evaluate" } },
+    required: ["expression"],
+  },
+  async execute(args: { expression: string }) {
+    try {
+      const safe = args.expression.replace(/[^0-9+\\-*/.()%\\s,]|(?<!Math)\\.[a-z]/gi, (match) => {
+        if (args.expression.includes("Math.")) return match;
+        throw new Error("Invalid character: " + match);
+      });
+      const result = new Function("return " + safe)();
+      return \`\${args.expression} = \${result}\`;
+    } catch (err) {
+      return \`Error: \${err instanceof Error ? err.message : String(err)}\`;
+    }
+  },
+};
+`);
+    fs.writeFileSync(path.join(targetDir, "src", "tools", "datetime.ts"), `// Date & time tool \u2014 returns current date, time, timezone (no API key needed)
+import type { Tool } from "@voltx/agents";
 
-export const searchTool: Tool = {
-  name: "search",
-  description: "Search for information on a topic.",
+export const datetimeTool: Tool = {
+  name: "datetime",
+  description: "Get the current date, time, day of week, and timezone.",
   parameters: {
     type: "object",
-    properties: { query: { type: "string", description: "The search query" } },
-    required: ["query"],
+    properties: { timezone: { type: "string", description: "Optional IANA timezone. Defaults to server timezone." } },
   },
-  async execute(args: { query: string }) {
-    return \`Search results for "\${args.query}": Placeholder \u2014 connect a real search API.\`;
+  async execute(args: { timezone?: string }) {
+    const now = new Date();
+    const tz = args.timezone || Intl.DateTimeFormat().resolvedOptions().timeZone;
+    const formatted = now.toLocaleString("en-US", {
+      timeZone: tz, weekday: "long", year: "numeric", month: "long", day: "numeric",
+      hour: "2-digit", minute: "2-digit", second: "2-digit", hour12: true,
+    });
+    return \`Current date/time (\${tz}): \${formatted}\`;
   },
 };
-`
-    );
+`);
+    fs.writeFileSync(path.join(targetDir, "src", "agents", "assistant.ts"), `// AI Agent \u2014 autonomous assistant with tools
+import { createAgent } from "@voltx/agents";
+import { calculatorTool } from "../tools/calculator";
+import { datetimeTool } from "../tools/datetime";
+
+export const assistant = createAgent({
+  name: "assistant",
+  model: "${provider}:${model}",
+  instructions: "You are a helpful AI assistant with access to tools: Calculator, Date & Time. Use them when needed to answer questions accurately.",
+  tools: [calculatorTool, datetimeTool],
+  maxIterations: 5,
+});
+`);
     fs.writeFileSync(
       path.join(targetDir, "src", "routes", "api", "agent.ts"),
-      `import type { Context } from "@voltx/server";
+      `// POST /api/agent \u2014 Run the AI agent
+import type { Context } from "@voltx/server";
 import { assistant } from "../../agents/assistant";
 
 export async function POST(c: Context) {
@@ -361,21 +356,18 @@ import { streamText } from "@voltx/ai";
 import { createRAGPipeline, createEmbedder } from "@voltx/rag";
 import { createVectorStore } from "@voltx/db";
 
-const vectorStore = createVectorStore(); // swap to "pinecone" or "pgvector" for production
+const vectorStore = createVectorStore();
 const embedder = createEmbedder({ model: "${embedModel}" });
 const rag = createRAGPipeline({ embedder, vectorStore });
 
 export async function POST(c: Context) {
   const { question } = await c.req.json();
-
   const context = await rag.getContext(question, { topK: 5 });
-
   const result = await streamText({
     model: "${provider}:${model}",
-    system: \`Answer the user's question based on the following context. If the context doesn't contain relevant information, say so.\\n\\nContext:\\n\${context}\`,
+    system: \`Answer based on context. If not relevant, say so.\\n\\nContext:\\n\${context}\`,
     messages: [{ role: "user", content: question }],
   });
-
   return result.toSSEResponse();
 }
 `
@@ -393,11 +385,7 @@ const rag = createRAGPipeline({ embedder, vectorStore });
 
 export async function POST(c: Context) {
   const { text, idPrefix } = await c.req.json();
-
-  if (!text || typeof text !== "string") {
-    return c.json({ error: "Missing 'text' field" }, 400);
-  }
-
+  if (!text || typeof text !== "string") return c.json({ error: "Missing 'text' field" }, 400);
   const result = await rag.ingest(text, idPrefix ?? "doc");
   return c.json({ status: "ok", chunks: result.chunks, ids: result.ids });
 }
@@ -422,8 +410,7 @@ export const POST = (c: Context) => handler(c);
     fs.mkdirSync(path.join(targetDir, "src", "lib"), { recursive: true });
     fs.writeFileSync(
       path.join(targetDir, "src", "lib", "auth.ts"),
-      `// Auth configuration \u2014 Better Auth with DB-backed sessions
-import { createAuth, createAuthMiddleware } from "@voltx/auth";
+      `import { createAuth, createAuthMiddleware } from "@voltx/auth";
 
 export const auth = createAuth("better-auth", {
   database: process.env.DATABASE_URL!,
@@ -440,8 +427,7 @@ export const authMiddleware = createAuthMiddleware({
     fs.mkdirSync(path.join(targetDir, "src", "lib"), { recursive: true });
     fs.writeFileSync(
       path.join(targetDir, "src", "lib", "auth.ts"),
-      `// Auth configuration \u2014 JWT (stateless)
-import { createAuth, createAuthMiddleware } from "@voltx/auth";
+      `import { createAuth, createAuthMiddleware } from "@voltx/auth";
 
 export const jwt = createAuth("jwt", {
   secret: process.env.JWT_SECRET!,
@@ -456,17 +442,12 @@ export const authMiddleware = createAuthMiddleware({
     );
     fs.writeFileSync(
       path.join(targetDir, "src", "routes", "api", "auth.ts"),
-      `// POST /api/auth/login \u2014 Example JWT login route
-import type { Context } from "@voltx/server";
+      `import type { Context } from "@voltx/server";
 import { jwt } from "../../lib/auth";
 
 export async function POST(c: Context) {
   const { email, password } = await c.req.json();
-
-  if (!email || !password) {
-    return c.json({ error: "Email and password are required" }, 400);
-  }
-
+  if (!email || !password) return c.json({ error: "Email and password are required" }, 400);
   const token = await jwt.sign({ sub: email, email });
   return c.json({ token });
 }
@@ -476,55 +457,166 @@ export async function POST(c: Context) {
   let envContent = "";
   if (template === "rag-app") {
     envContent += "# \u2500\u2500\u2500 LLM Provider \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nOPENAI_API_KEY=sk-...\n\n";
-    envContent += "# \u2500\u2500\u2500 Database (Neon Postgres) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nDATABASE_URL=postgresql://user:pass@ep-xxx.us-east-2.aws.neon.tech/dbname?sslmode=require\n\n";
-    envContent += "# \u2500\u2500\u2500 Vector Database (Pinecone) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nPINECONE_API_KEY=pc-...\nPINECONE_INDEX=voltx-embeddings\n\n";
+    envContent += "# \u2500\u2500\u2500 Database \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nDATABASE_URL=\n\n";
   } else if (template === "chatbot" || template === "agent-app") {
     envContent += "# \u2500\u2500\u2500 LLM Provider \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nCEREBRAS_API_KEY=csk-...\n\n";
     if (template === "agent-app") {
-      envContent += "# \u2500\u2500\u2500 Database (Neon Postgres \u2014 optional) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nDATABASE_URL=\n\n";
+      envContent += "# \u2500\u2500\u2500 Database (optional) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nDATABASE_URL=\n\n";
+      envContent += "# \u2500\u2500\u2500 Tool API Keys (add keys for tools you use) \u2500\u2500\n";
+      envContent += "# TAVILY_API_KEY=tvly-...       (Web Search \u2014 https://tavily.com)\n";
+      envContent += "# SERPER_API_KEY=               (Google Search \u2014 https://serper.dev)\n";
+      envContent += "# OPENWEATHER_API_KEY=          (Weather \u2014 https://openweathermap.org/api)\n";
+      envContent += "# NEWS_API_KEY=                 (News \u2014 https://newsapi.org)\n\n";
     }
   } else {
-    envContent += "# \u2500\u2500\u2500 LLM Provider (add your key) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n# OPENAI_API_KEY=sk-...\n# CEREBRAS_API_KEY=csk-...\n\n";
+    envContent += "# \u2500\u2500\u2500 LLM Provider \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n# OPENAI_API_KEY=sk-...\n# CEREBRAS_API_KEY=csk-...\n\n";
   }
   if (auth === "better-auth") {
-    envContent += "# \u2500\u2500\u2500 Auth (Better Auth) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nBETTER_AUTH_SECRET=your-secret-key-min-32-chars-here\nBETTER_AUTH_URL=http://localhost:3000\n";
-    if (template !== "rag-app" && template !== "agent-app") {
-      envContent += "DATABASE_URL=postgresql://user:pass@ep-xxx.us-east-2.aws.neon.tech/dbname?sslmode=require\n";
-    }
-    envContent += "# GITHUB_CLIENT_ID=\n# GITHUB_CLIENT_SECRET=\n\n";
+    envContent += "# \u2500\u2500\u2500 Auth (Better Auth) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nBETTER_AUTH_SECRET=your-secret-key-min-32-chars-here\nBETTER_AUTH_URL=http://localhost:3000\n\n";
   } else if (auth === "jwt") {
     envContent += "# \u2500\u2500\u2500 Auth (JWT) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nJWT_SECRET=your-jwt-secret-key\n\n";
   }
   envContent += "# \u2500\u2500\u2500 App \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nPORT=3000\nNODE_ENV=development\n";
   fs.writeFileSync(path.join(targetDir, ".env.example"), envContent);
-  fs.writeFileSync(
-    path.join(targetDir, ".gitignore"),
-    "node_modules\ndist\n.env\n"
-  );
-  fs.writeFileSync(
-    path.join(targetDir, "tsconfig.json"),
-    JSON.stringify(
-      {
-        compilerOptions: {
-          target: "ES2022",
-          module: "ESNext",
-          moduleResolution: "bundler",
-          strict: true,
-          esModuleInterop: true,
-          skipLibCheck: true,
-          outDir: "dist",
-          rootDir: "src"
-        },
-        include: ["src"]
-      },
-      null,
-      2
-    )
-  );
+  if (template !== "blank") {
+    fs.writeFileSync(path.join(targetDir, "public", "index.html"), generateFrontendHTML(name, template));
+  }
+  fs.writeFileSync(path.join(targetDir, ".gitignore"), "node_modules\ndist\n.env\n");
   printWelcomeBanner(name);
 }
-var isDirectRun = typeof require !== "undefined" && require.main === module && process.argv[1]?.includes("create");
-if (isDirectRun) {
+function generateFrontendHTML(projectName, template) {
+  const badge = template === "chatbot" ? "Chatbot" : template === "rag-app" ? "RAG App" : "Agent App";
+  const accentClass = template === "rag-app" ? "emerald" : template === "agent-app" ? "purple" : "blue";
+  const shell = (body) => `<!DOCTYPE html>
+<html lang="en" class="h-full">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>${projectName}</title>
+  <script src="https://cdn.tailwindcss.com/3.4.17"></script>
+  <style>
+    @import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap');
+    body { font-family: 'Inter', system-ui, sans-serif; }
+    .msg-enter { animation: msgIn 0.25s ease-out; }
+    @keyframes msgIn { from { opacity: 0; transform: translateY(8px); } to { opacity: 1; transform: translateY(0); } }
+    .typing-dot { animation: blink 1.4s infinite both; }
+    .typing-dot:nth-child(2) { animation-delay: 0.2s; }
+    .typing-dot:nth-child(3) { animation-delay: 0.4s; }
+    @keyframes blink { 0%, 80%, 100% { opacity: 0.2; } 40% { opacity: 1; } }
+    ::-webkit-scrollbar { width: 6px; }
+    ::-webkit-scrollbar-track { background: transparent; }
+    ::-webkit-scrollbar-thumb { background: #334155; border-radius: 3px; }
+  </style>
+</head>
+<body class="h-full bg-gray-950 text-gray-100">
+  <div id="app" class="h-full flex flex-col">
+    <header class="flex-shrink-0 border-b border-gray-800 bg-gray-950/80 backdrop-blur-sm px-4 py-3">
+      <div class="max-w-4xl mx-auto flex items-center justify-between">
+        <div class="flex items-center gap-3">
+          <div class="w-8 h-8 rounded-lg bg-gradient-to-br from-blue-500 to-purple-600 flex items-center justify-center text-sm font-bold">V</div>
+          <h1 class="text-lg font-semibold text-white">${projectName}</h1>
+          <span class="text-xs px-2 py-0.5 rounded-full bg-gray-800 text-gray-400">${badge}</span>
+        </div>
+        <a href="https://github.com/codewithshail/voltx" target="_blank" class="text-gray-500 hover:text-gray-300 transition-colors text-sm">Built with VoltX</a>
+      </div>
+    </header>
+    <main class="flex-1 overflow-hidden"><div class="h-full max-w-4xl mx-auto">
+${body}
+    </div></main>
+  </div>
+</body>
+</html>`;
+  if (template === "chatbot") return shell(chatbotBody());
+  if (template === "rag-app") return shell(ragAppBody());
+  if (template === "agent-app") return shell(agentAppBody());
+  return "";
+}
+function chatbotBody() {
+  return `      <div class="h-full flex flex-col">
+        <div id="messages" class="flex-1 overflow-y-auto px-4 py-6 space-y-4">
+          <div class="text-center py-12">
+            <div class="w-16 h-16 mx-auto mb-4 rounded-2xl bg-gradient-to-br from-blue-500/20 to-purple-600/20 border border-blue-500/20 flex items-center justify-center">
+              <svg class="w-8 h-8 text-blue-400" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5" d="M8 12h.01M12 12h.01M16 12h.01M21 12c0 4.418-4.03 8-9 8a9.863 9.863 0 01-4.255-.949L3 20l1.395-3.72C3.512 15.042 3 13.574 3 12c0-4.418 4.03-8 9-8s9 3.582 9 8z"/></svg>
+            </div>
+            <h2 class="text-xl font-semibold text-white mb-2">Start a conversation</h2>
+            <p class="text-gray-500 text-sm">Type a message below to chat with your AI assistant.</p>
+          </div>
+        </div>
+        <div class="flex-shrink-0 border-t border-gray-800 px-4 py-4">
+          <form id="chatForm" class="flex gap-3">
+            <input id="chatInput" type="text" placeholder="Type your message..." autocomplete="off" class="flex-1 bg-gray-900 border border-gray-700 rounded-xl px-4 py-3 text-sm text-white placeholder-gray-500 focus:outline-none focus:border-blue-500 focus:ring-1 focus:ring-blue-500 transition-colors" />
+            <button type="submit" id="sendBtn" class="px-5 py-3 bg-blue-600 hover:bg-blue-500 disabled:bg-gray-700 disabled:text-gray-500 text-white text-sm font-medium rounded-xl transition-colors">Send</button>
+          </form>
+        </div>
+      </div>
+      <script>
+        const messages=[], messagesEl=document.getElementById("messages"), form=document.getElementById("chatForm"), input=document.getElementById("chatInput"), sendBtn=document.getElementById("sendBtn");
+        function addMsg(role,content){const d=document.createElement("div");d.className="msg-enter flex "+(role==="user"?"justify-end":"justify-start");const b=document.createElement("div");b.className=role==="user"?"max-w-[75%] px-4 py-2.5 rounded-2xl rounded-br-md bg-blue-600 text-white text-sm leading-relaxed":"max-w-[75%] px-4 py-2.5 rounded-2xl rounded-bl-md bg-gray-800 text-gray-200 text-sm leading-relaxed";b.textContent=content;d.appendChild(b);const w=messagesEl.querySelector(".text-center.py-12");if(w)w.remove();messagesEl.appendChild(d);messagesEl.scrollTop=messagesEl.scrollHeight;return b}
+        form.addEventListener("submit",async e=>{e.preventDefault();const text=input.value.trim();if(!text)return;messages.push({role:"user",content:text});addMsg("user",text);input.value="";sendBtn.disabled=true;try{const res=await fetch("/api/chat",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({messages,conversationId:"default"})});if(!res.ok){addMsg("assistant","Error: "+res.status);sendBtn.disabled=false;return}const bubble=addMsg("assistant","");const reader=res.body.getReader();const dec=new TextDecoder();let full="";while(true){const{done,value}=await reader.read();if(done)break;const chunk=dec.decode(value,{stream:true});for(const line of chunk.split("\\n")){if(line.startsWith("data: ")){const d=line.slice(6);if(d==="[DONE]")continue;try{const p=JSON.parse(d);const t=p.textDelta||p.choices?.[0]?.delta?.content||p.content||p.text||"";full+=t;bubble.textContent=full;messagesEl.scrollTop=messagesEl.scrollHeight}catch{}}}}messages.push({role:"assistant",content:full})}catch(err){addMsg("assistant","Error: "+err.message)}sendBtn.disabled=false;input.focus()});
+        input.focus();
+      </script>`;
+}
+function ragAppBody() {
+  return `      <div class="h-full flex flex-col md:flex-row">
+        <div class="md:w-80 flex-shrink-0 border-b md:border-b-0 md:border-r border-gray-800 flex flex-col">
+          <div class="px-4 py-3 border-b border-gray-800"><h2 class="text-sm font-semibold text-white flex items-center gap-2"><svg class="w-4 h-4 text-emerald-400" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M7 16a4 4 0 01-.88-7.903A5 5 0 1115.9 6L16 6a5 5 0 011 9.9M15 13l-3-3m0 0l-3 3m3-3v12"/></svg>Ingest Documents</h2></div>
+          <div class="flex-1 p-4 flex flex-col gap-3">
+            <textarea id="ingestText" rows="6" placeholder="Paste text to ingest..." class="w-full bg-gray-900 border border-gray-700 rounded-lg px-3 py-2 text-sm text-white placeholder-gray-500 focus:outline-none focus:border-emerald-500 resize-none"></textarea>
+            <button id="ingestBtn" onclick="ingestDoc()" class="w-full py-2.5 bg-emerald-600 hover:bg-emerald-500 disabled:bg-gray-700 disabled:text-gray-500 text-white text-sm font-medium rounded-lg transition-colors">Ingest</button>
+            <div id="ingestStatus" class="text-xs text-gray-500 hidden"></div>
+            <div class="mt-auto pt-3 border-t border-gray-800"><p class="text-xs text-gray-600">Documents are chunked, embedded, and stored for retrieval.</p></div>
+          </div>
+        </div>
+        <div class="flex-1 flex flex-col min-w-0">
+          <div id="ragMessages" class="flex-1 overflow-y-auto px-4 py-6 space-y-4">
+            <div class="text-center py-12">
+              <div class="w-16 h-16 mx-auto mb-4 rounded-2xl bg-gradient-to-br from-emerald-500/20 to-blue-600/20 border border-emerald-500/20 flex items-center justify-center"><svg class="w-8 h-8 text-emerald-400" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5" d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z"/></svg></div>
+              <h2 class="text-xl font-semibold text-white mb-2">Ask your documents</h2>
+              <p class="text-gray-500 text-sm">Ingest documents on the left, then ask questions here.</p>
+            </div>
+          </div>
+          <div class="flex-shrink-0 border-t border-gray-800 px-4 py-4">
+            <form id="ragForm" class="flex gap-3">
+              <input id="ragInput" type="text" placeholder="Ask about your documents..." autocomplete="off" class="flex-1 bg-gray-900 border border-gray-700 rounded-xl px-4 py-3 text-sm text-white placeholder-gray-500 focus:outline-none focus:border-emerald-500 focus:ring-1 focus:ring-emerald-500 transition-colors" />
+              <button type="submit" id="ragSendBtn" class="px-5 py-3 bg-emerald-600 hover:bg-emerald-500 disabled:bg-gray-700 disabled:text-gray-500 text-white text-sm font-medium rounded-xl transition-colors">Ask</button>
+            </form>
+          </div>
+        </div>
+      </div>
+      <script>
+        const ragEl=document.getElementById("ragMessages");
+        function addRagMsg(role,c){const d=document.createElement("div");d.className="msg-enter flex "+(role==="user"?"justify-end":"justify-start");const b=document.createElement("div");b.className=role==="user"?"max-w-[75%] px-4 py-2.5 rounded-2xl rounded-br-md bg-emerald-600 text-white text-sm leading-relaxed":"max-w-[75%] px-4 py-2.5 rounded-2xl rounded-bl-md bg-gray-800 text-gray-200 text-sm leading-relaxed";b.textContent=c;d.appendChild(b);const w=ragEl.querySelector(".text-center.py-12");if(w)w.remove();ragEl.appendChild(d);ragEl.scrollTop=ragEl.scrollHeight;return b}
+        async function ingestDoc(){const text=document.getElementById("ingestText").value.trim();if(!text)return;const btn=document.getElementById("ingestBtn"),st=document.getElementById("ingestStatus");btn.disabled=true;btn.textContent="Ingesting...";st.className="text-xs text-yellow-400";st.textContent="Processing...";st.classList.remove("hidden");try{const res=await fetch("/api/rag/ingest",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({text})});const data=await res.json();if(res.ok){st.className="text-xs text-emerald-400";st.textContent="Ingested "+(data.chunks||0)+" chunks.";document.getElementById("ingestText").value=""}else{st.className="text-xs text-red-400";st.textContent="Error: "+(data.error||res.statusText)}}catch(e){st.className="text-xs text-red-400";st.textContent="Error: "+e.message}btn.disabled=false;btn.textContent="Ingest"}
+        document.getElementById("ragForm").addEventListener("submit",async e=>{e.preventDefault();const input=document.getElementById("ragInput"),text=input.value.trim();if(!text)return;addRagMsg("user",text);input.value="";document.getElementById("ragSendBtn").disabled=true;try{const res=await fetch("/api/rag/query",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({question:text})});if(!res.ok){addRagMsg("assistant","Error: "+res.status);document.getElementById("ragSendBtn").disabled=false;return}const bubble=addRagMsg("assistant","");const reader=res.body.getReader();const dec=new TextDecoder();let full="";while(true){const{done,value}=await reader.read();if(done)break;const chunk=dec.decode(value,{stream:true});for(const line of chunk.split("\\n")){if(line.startsWith("data: ")){const d=line.slice(6);if(d==="[DONE]")continue;try{const p=JSON.parse(d);const t=p.textDelta||p.choices?.[0]?.delta?.content||p.content||p.text||"";full+=t;bubble.textContent=full;ragEl.scrollTop=ragEl.scrollHeight}catch{}}}};}catch(err){addRagMsg("assistant","Error: "+err.message)}document.getElementById("ragSendBtn").disabled=false;document.getElementById("ragInput").focus()});
+        document.getElementById("ragInput").focus();
+      </script>`;
+}
+function agentAppBody() {
+  return `      <div class="h-full flex flex-col">
+        <div id="agentMessages" class="flex-1 overflow-y-auto px-4 py-6 space-y-4">
+          <div class="text-center py-12">
+            <div class="w-16 h-16 mx-auto mb-4 rounded-2xl bg-gradient-to-br from-purple-500/20 to-orange-500/20 border border-purple-500/20 flex items-center justify-center"><svg class="w-8 h-8 text-purple-400" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5" d="M9.75 17L9 20l-1 1h8l-1-1-.75-3M3 13h18M5 17h14a2 2 0 002-2V5a2 2 0 00-2-2H5a2 2 0 00-2 2v10a2 2 0 002 2z"/></svg></div>
+            <h2 class="text-xl font-semibold text-white mb-2">AI Agent</h2>
+            <p class="text-gray-500 text-sm">Your agent can use tools to answer questions accurately.</p>
+          </div>
+        </div>
+        <div class="flex-shrink-0 border-t border-gray-800 px-4 py-4">
+          <form id="agentForm" class="flex gap-3">
+            <input id="agentInput" type="text" placeholder="Ask the agent anything..." autocomplete="off" class="flex-1 bg-gray-900 border border-gray-700 rounded-xl px-4 py-3 text-sm text-white placeholder-gray-500 focus:outline-none focus:border-purple-500 focus:ring-1 focus:ring-purple-500 transition-colors" />
+            <button type="submit" id="agentSendBtn" class="px-5 py-3 bg-purple-600 hover:bg-purple-500 disabled:bg-gray-700 disabled:text-gray-500 text-white text-sm font-medium rounded-xl transition-colors">Run</button>
+          </form>
+        </div>
+      </div>
+      <script>
+        const agentEl=document.getElementById("agentMessages");
+        function addAgentMsg(role,c,isStep){const d=document.createElement("div");d.className="msg-enter flex "+(role==="user"?"justify-end":"justify-start");const b=document.createElement("div");if(isStep){b.className="max-w-[85%] px-3 py-2 rounded-lg bg-gray-900 border border-gray-700 text-xs text-gray-400 font-mono"}else{b.className=role==="user"?"max-w-[75%] px-4 py-2.5 rounded-2xl rounded-br-md bg-purple-600 text-white text-sm leading-relaxed":"max-w-[75%] px-4 py-2.5 rounded-2xl rounded-bl-md bg-gray-800 text-gray-200 text-sm leading-relaxed whitespace-pre-wrap"}b.textContent=c;d.appendChild(b);const w=agentEl.querySelector(".text-center.py-12");if(w)w.remove();agentEl.appendChild(d);agentEl.scrollTop=agentEl.scrollHeight;return b}
+        function addThinking(){const d=document.createElement("div");d.id="thinking";d.className="msg-enter flex justify-start";d.innerHTML='<div class="px-4 py-2.5 rounded-2xl rounded-bl-md bg-gray-800 flex items-center gap-2 text-sm text-gray-400"><svg class="w-4 h-4 animate-spin" fill="none" viewBox="0 0 24 24"><circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4"></circle><path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4z"></path></svg>Agent is thinking...</div>';agentEl.appendChild(d);agentEl.scrollTop=agentEl.scrollHeight}
+        function removeThinking(){const t=document.getElementById("thinking");if(t)t.remove()}
+        document.getElementById("agentForm").addEventListener("submit",async e=>{e.preventDefault();const input=document.getElementById("agentInput"),text=input.value.trim();if(!text)return;addAgentMsg("user",text);input.value="";document.getElementById("agentSendBtn").disabled=true;addThinking();try{const res=await fetch("/api/agent",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({input:text})});removeThinking();if(!res.ok){const err=await res.json().catch(()=>({}));addAgentMsg("assistant","Error: "+(err.error||res.statusText));document.getElementById("agentSendBtn").disabled=false;return}const data=await res.json();if(data.steps&&data.steps.length>0){for(const s of data.steps){const name=s.tool||s.name||"tool";const inp=typeof s.input==="string"?s.input:JSON.stringify(s.input||{});const out=typeof s.output==="string"?s.output:JSON.stringify(s.output||{});addAgentMsg("assistant","\u{1F527} "+name+"("+inp+")\\n\u2192 "+out.slice(0,300),true)}}addAgentMsg("assistant",data.content||"No response.")}catch(err){removeThinking();addAgentMsg("assistant","Error: "+err.message)}document.getElementById("agentSendBtn").disabled=false;input.focus()});
+        document.getElementById("agentInput").focus();
+      </script>`;
+}
+if (typeof require !== "undefined" && require.main === module && process.argv[1]?.includes("create")) {
   const projectName = process.argv[2];
   if (!projectName) {
     console.log("Usage: create-voltx-app <project-name> [--template chatbot] [--auth jwt]");
@@ -934,7 +1026,7 @@ import { createAgent } from "@voltx/agents";
 
 export const ${toCamelCase(name)} = createAgent({
   name: "${name}",
-  model: "cerebras:llama-4-scout-17b-16e",
+  model: "cerebras:llama3.1-8b",
   instructions: "You are a helpful AI assistant named ${name}.",
   tools: [
     // Add tools here:
@@ -1017,7 +1109,7 @@ function toCamelCase(str) {
 }
 
 // src/index.ts
-var CLI_VERSION = "0.3.2";
+var CLI_VERSION = "0.3.5";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CLI_VERSION,

package/dist/index.mjs

@@ -3,13 +3,13 @@ import {
 } from "./chunk-ZB2F3WTS.mjs";
 import {
   createProject
-} from "./chunk-KFHPTRKZ.mjs";
+} from "./chunk-P5FSO2UH.mjs";
 import {
   runDev
 } from "./chunk-QND74HUW.mjs";
 import {
   runGenerate
-} from "./chunk-AONHLE42.mjs";
+} from "./chunk-HAFJKS2O.mjs";
 import {
   runStart
 } from "./chunk-BXHQORLN.mjs";
@@ -17,7 +17,7 @@ import "./chunk-IV352HZA.mjs";
 import "./chunk-Y6FXYEAI.mjs";
 
 // src/index.ts
-var CLI_VERSION = "0.3.2";
+var CLI_VERSION = "0.3.5";
 export {
   CLI_VERSION,
   createProject,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltx/cli",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "VoltX CLI — dev server, build, start, generate, and scaffolding",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",