@voltx/cli 0.3.3 → 0.3.5

package/dist/chunk-G2INQCCJ.mjs

@@ -0,0 +1,907 @@
+import {
+  printWelcomeBanner
+} from "./chunk-IV352HZA.mjs";
+
+// src/create.ts
+import * as fs from "fs";
+import * as path from "path";
+var VV = {
+  "@voltx/core": "^0.3.1",
+  "@voltx/server": "^0.3.1",
+  "@voltx/cli": "^0.3.5",
+  "@voltx/ai": "^0.3.0",
+  "@voltx/agents": "^0.3.1",
+  "@voltx/memory": "^0.3.0",
+  "@voltx/db": "^0.3.0",
+  "@voltx/rag": "^0.3.1",
+  "@voltx/auth": "^0.3.0"
+};
+function v(pkg) {
+  return VV[pkg] ?? "^0.3.0";
+}
+var TEMPLATE_DEPS = {
+  blank: { "@voltx/core": v("@voltx/core"), "@voltx/server": v("@voltx/server") },
+  chatbot: { "@voltx/core": v("@voltx/core"), "@voltx/ai": v("@voltx/ai"), "@voltx/server": v("@voltx/server"), "@voltx/memory": v("@voltx/memory") },
+  "rag-app": { "@voltx/core": v("@voltx/core"), "@voltx/ai": v("@voltx/ai"), "@voltx/server": v("@voltx/server"), "@voltx/rag": v("@voltx/rag"), "@voltx/db": v("@voltx/db") },
+  "agent-app": { "@voltx/core": v("@voltx/core"), "@voltx/ai": v("@voltx/ai"), "@voltx/server": v("@voltx/server"), "@voltx/agents": v("@voltx/agents"), "@voltx/memory": v("@voltx/memory") }
+};
+async function createProject(options) {
+  const { name, template = "blank", auth = "none", shadcn = false } = options;
+  const targetDir = path.resolve(process.cwd(), name);
+  if (fs.existsSync(targetDir)) {
+    console.error(`[voltx] Directory "${name}" already exists.`);
+    process.exit(1);
+  }
+  fs.mkdirSync(targetDir, { recursive: true });
+  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("@voltx/cli") };
+  if (auth === "better-auth") {
+    deps["@voltx/auth"] = v("@voltx/auth");
+    deps["better-auth"] = "^1.5.0";
+  } else if (auth === "jwt") {
+    deps["@voltx/auth"] = v("@voltx/auth");
+    deps["jose"] = "^6.0.0";
+  }
+  const devDeps = { typescript: "^5.7.0", tsx: "^4.21.0", tsup: "^8.0.0", "@types/node": "^22.0.0" };
+  deps["hono"] = "^4.7.0";
+  deps["@hono/node-server"] = "^1.14.0";
+  deps["react"] = "^19.0.0";
+  deps["react-dom"] = "^19.0.0";
+  deps["tailwindcss"] = "^4.0.0";
+  devDeps["vite"] = "^6.0.0";
+  devDeps["@hono/vite-dev-server"] = "^0.7.0";
+  devDeps["@vitejs/plugin-react"] = "^4.3.0";
+  devDeps["@tailwindcss/vite"] = "^4.0.0";
+  devDeps["@types/react"] = "^19.0.0";
+  devDeps["@types/react-dom"] = "^19.0.0";
+  if (shadcn) {
+    deps["class-variance-authority"] = "^0.7.0";
+    deps["clsx"] = "^2.1.0";
+    deps["tailwind-merge"] = "^3.0.0";
+    deps["lucide-react"] = "^0.468.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: deps,
+    devDependencies: devDeps
+  }, null, 2));
+  let config = `import { defineConfig } from "@voltx/core";
+
+export default defineConfig({
+  name: "${name}",
+  port: 3000,
+  ai: {
+    provider: "${provider}",
+    model: "${model}",
+  },`;
+  if (hasDb) config += `
+  db: {
+    url: process.env.DATABASE_URL,
+  },`;
+  if (auth !== "none") config += `
+  auth: {
+    provider: "${auth}",
+  },`;
+  config += `
+  server: {
+    routesDir: "api",
+    staticDir: "public",
+    cors: true,
+  },
+});
+`;
+  fs.writeFileSync(path.join(targetDir, "voltx.config.ts"), config);
+  fs.mkdirSync(path.join(targetDir, "api"), { recursive: true });
+  fs.mkdirSync(path.join(targetDir, "public"), { recursive: true });
+  fs.mkdirSync(path.join(targetDir, "src"), { recursive: true });
+  fs.mkdirSync(path.join(targetDir, "src", "components"), { recursive: true });
+  fs.mkdirSync(path.join(targetDir, "src", "hooks"), { recursive: true });
+  fs.mkdirSync(path.join(targetDir, "src", "lib"), { recursive: true });
+  fs.writeFileSync(path.join(targetDir, "public", "favicon.svg"), generateFaviconSVG());
+  fs.writeFileSync(path.join(targetDir, "public", "robots.txt"), generateRobotsTxt());
+  fs.writeFileSync(path.join(targetDir, "public", "site.webmanifest"), generateWebManifest(name));
+  const tsconfig = {
+    compilerOptions: {
+      target: "ES2022",
+      module: "ESNext",
+      moduleResolution: "bundler",
+      strict: true,
+      esModuleInterop: true,
+      skipLibCheck: true,
+      outDir: "dist",
+      baseUrl: ".",
+      paths: { "@/*": ["./src/*"] },
+      jsx: "react-jsx"
+    },
+    include: ["src", "api", "server.ts", "voltx.config.ts"]
+  };
+  if (template === "agent-app") tsconfig.include.push("agents", "tools");
+  fs.writeFileSync(path.join(targetDir, "tsconfig.json"), JSON.stringify(tsconfig, null, 2));
+  fs.writeFileSync(path.join(targetDir, "server.ts"), generateServerEntry(name, template));
+  fs.writeFileSync(path.join(targetDir, "vite.config.ts"), generateViteConfigFile("server.ts"));
+  fs.writeFileSync(path.join(targetDir, "src", "entry-client.tsx"), generateEntryClient());
+  fs.writeFileSync(path.join(targetDir, "src", "entry-server.tsx"), generateEntryServer());
+  fs.writeFileSync(path.join(targetDir, "src", "layout.tsx"), generateLayoutComponent(name));
+  fs.writeFileSync(path.join(targetDir, "src", "globals.css"), generateGlobalCSS(shadcn));
+  if (shadcn) {
+    fs.writeFileSync(path.join(targetDir, "src", "lib", "utils.ts"), generateCnUtil());
+    fs.writeFileSync(path.join(targetDir, "components.json"), generateComponentsJson());
+  }
+  fs.writeFileSync(path.join(targetDir, "src", "app.tsx"), generateAppComponent(name, template));
+  fs.writeFileSync(
+    path.join(targetDir, "api", "index.ts"),
+    `// GET /api \u2014 Health check
+import type { Context } from "@voltx/server";
+
+export function GET(c: Context) {
+  return c.json({ name: "${name}", status: "ok" });
+}
+`
+  );
+  if (template === "chatbot" || template === "agent-app") {
+    fs.writeFileSync(
+      path.join(targetDir, "api", "chat.ts"),
+      `// POST /api/chat \u2014 Streaming chat with conversation memory
+import type { Context } from "@voltx/server";
+import { streamText } from "@voltx/ai";
+import { createMemory } from "@voltx/memory";
+
+const memory = createMemory({ maxMessages: 50 });
+
+export async function POST(c: Context) {
+  const { messages, conversationId = "default" } = await c.req.json();
+
+  const lastMessage = messages[messages.length - 1];
+  if (lastMessage?.role === "user") {
+    await memory.add(conversationId, { role: "user", content: lastMessage.content });
+  }
+
+  const history = await memory.get(conversationId);
+
+  const result = await streamText({
+    model: "${provider}:${model}",
+    system: "You are a helpful AI assistant.",
+    messages: history.map((m) => ({ role: m.role, content: m.content })),
+  });
+
+  result.text.then(async (text) => {
+    await memory.add(conversationId, { role: "assistant", content: text });
+  });
+
+  return result.toSSEResponse();
+}
+`
+    );
+  }
+  if (template === "agent-app") {
+    fs.mkdirSync(path.join(targetDir, "agents"), { recursive: true });
+    fs.mkdirSync(path.join(targetDir, "tools"), { recursive: true });
+    fs.writeFileSync(path.join(targetDir, "tools", "calculator.ts"), `// Calculator tool \u2014 evaluates math expressions (no API key needed)
+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, "tools", "datetime.ts"), `// Date & time tool \u2014 returns current date, time, timezone (no API key needed)
+import type { Tool } from "@voltx/agents";
+
+export const datetimeTool: Tool = {
+  name: "datetime",
+  description: "Get the current date, time, day of week, and timezone.",
+  parameters: {
+    type: "object",
+    properties: { timezone: { type: "string", description: "Optional IANA timezone. Defaults to server timezone." } },
+  },
+  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, "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, "api", "agent.ts"),
+      `// 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) {
+  const { input } = await c.req.json();
+  if (!input) return c.json({ error: "Missing 'input' field" }, 400);
+  const result = await assistant.run(input);
+  return c.json({ content: result.content, steps: result.steps });
+}
+`
+    );
+  }
+  if (template === "rag-app") {
+    const embedModel = "openai:text-embedding-3-small";
+    fs.mkdirSync(path.join(targetDir, "api", "rag"), { recursive: true });
+    fs.writeFileSync(
+      path.join(targetDir, "api", "rag", "query.ts"),
+      `// POST /api/rag/query \u2014 Query documents with RAG
+import type { Context } from "@voltx/server";
+import { streamText } from "@voltx/ai";
+import { createRAGPipeline, createEmbedder } from "@voltx/rag";
+import { createVectorStore } from "@voltx/db";
+
+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 based on context. If not relevant, say so.\\n\\nContext:\\n\${context}\`,
+    messages: [{ role: "user", content: question }],
+  });
+  return result.toSSEResponse();
+}
+`
+    );
+    fs.writeFileSync(
+      path.join(targetDir, "api", "rag", "ingest.ts"),
+      `// POST /api/rag/ingest \u2014 Ingest documents into the vector store
+import type { Context } from "@voltx/server";
+import { createRAGPipeline, createEmbedder } from "@voltx/rag";
+import { createVectorStore } from "@voltx/db";
+
+const vectorStore = createVectorStore();
+const embedder = createEmbedder({ model: "${embedModel}" });
+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);
+  const result = await rag.ingest(text, idPrefix ?? "doc");
+  return c.json({ status: "ok", chunks: result.chunks, ids: result.ids });
+}
+`
+    );
+  }
+  if (auth === "better-auth") {
+    fs.mkdirSync(path.join(targetDir, "api", "auth"), { recursive: true });
+    fs.writeFileSync(
+      path.join(targetDir, "api", "auth", "[...path].ts"),
+      `// ALL /api/auth/* \u2014 Better Auth handler
+import type { Context } from "@voltx/server";
+import { auth } from "../../src/lib/auth";
+import { createAuthHandler } from "@voltx/auth";
+
+const handler = createAuthHandler(auth);
+
+export const GET = (c: Context) => handler(c);
+export const POST = (c: Context) => handler(c);
+`
+    );
+    fs.writeFileSync(
+      path.join(targetDir, "src", "lib", "auth.ts"),
+      `import { createAuth, createAuthMiddleware } from "@voltx/auth";
+
+export const auth = createAuth("better-auth", {
+  database: process.env.DATABASE_URL!,
+  emailAndPassword: true,
+});
+
+export const authMiddleware = createAuthMiddleware({
+  provider: auth,
+  publicPaths: ["/api/auth", "/api/health", "/"],
+});
+`
+    );
+  } else if (auth === "jwt") {
+    fs.writeFileSync(
+      path.join(targetDir, "src", "lib", "auth.ts"),
+      `import { createAuth, createAuthMiddleware } from "@voltx/auth";
+
+export const jwt = createAuth("jwt", {
+  secret: process.env.JWT_SECRET!,
+  expiresIn: "7d",
+});
+
+export const authMiddleware = createAuthMiddleware({
+  provider: jwt,
+  publicPaths: ["/api/auth", "/api/health", "/"],
+});
+`
+    );
+    fs.writeFileSync(
+      path.join(targetDir, "api", "auth.ts"),
+      `import type { Context } from "@voltx/server";
+import { jwt } from "../src/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);
+  const token = await jwt.sign({ sub: email, email });
+  return c.json({ token });
+}
+`
+    );
+  }
+  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 \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";
+  } else {
+    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\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.env.local\n.env.*.local\nvite.config.voltx.ts\n");
+  printWelcomeBanner(name);
+}
+function generateServerEntry(projectName, template) {
+  const imports = [];
+  const mounts = [];
+  imports.push('import { GET as healthGET } from "./api/index";');
+  mounts.push('app.get("/api", healthGET);');
+  if (template === "chatbot" || template === "agent-app") {
+    imports.push('import { POST as chatPOST } from "./api/chat";');
+    mounts.push('app.post("/api/chat", chatPOST);');
+  }
+  if (template === "agent-app") {
+    imports.push('import { POST as agentPOST } from "./api/agent";');
+    mounts.push('app.post("/api/agent", agentPOST);');
+  }
+  if (template === "rag-app") {
+    imports.push('import { POST as ragQueryPOST } from "./api/rag/query";');
+    imports.push('import { POST as ragIngestPOST } from "./api/rag/ingest";');
+    mounts.push('app.post("/api/rag/query", ragQueryPOST);');
+    mounts.push('app.post("/api/rag/ingest", ragIngestPOST);');
+  }
+  return `import { Hono } from "hono";
+import { serve } from "@hono/node-server";
+import { serveStatic } from "@hono/node-server/serve-static";
+import { registerSSR } from "@voltx/server";
+import { loadEnv } from "@voltx/core";
+${imports.join("\n")}
+
+loadEnv(process.env.NODE_ENV ?? "development");
+
+const isProd = process.env.NODE_ENV === "production";
+const app = new Hono();
+
+// \u2500\u2500 API Routes \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+${mounts.join("\n")}
+
+// \u2500\u2500 Static assets (production) \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\u2500\u2500
+if (isProd) {
+  app.use("/assets/*", serveStatic({ root: "./dist/client/" }));
+  app.use("/favicon.svg", serveStatic({ root: "./public/" }));
+  app.use("/robots.txt", serveStatic({ root: "./public/" }));
+  app.use("/site.webmanifest", serveStatic({ root: "./public/" }));
+}
+
+// \u2500\u2500 SSR catch-all \u2014 renders React on the server \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
+registerSSR(app, null, {
+  title: "${projectName}",
+  entryServer: "src/entry-server.tsx",
+  entryClient: "src/entry-client.tsx",
+});
+
+export default app;
+
+if (isProd) {
+  const port = Number(process.env.PORT) || 3000;
+  serve({ fetch: app.fetch, port }, (info) => {
+    console.log(\`\\n  \u26A1 ${projectName} running at http://localhost:\${info.port}\\n\`);
+  });
+}
+`;
+}
+function generateViteConfigFile(entry) {
+  return `import { defineConfig } from "vite";
+import devServer from "@hono/vite-dev-server";
+import react from "@vitejs/plugin-react";
+import tailwindcss from "@tailwindcss/vite";
+
+export default defineConfig({
+  resolve: {
+    alias: {
+      "@": "/src",
+    },
+  },
+  plugins: [
+    react(),
+    tailwindcss(),
+    devServer({
+      entry: "${entry}",
+      exclude: [
+        /.*\\.tsx?($|\\?)/,
+        /.*\\.(s?css|less)($|\\?)/,
+        /.*\\.(svg|png|jpg|jpeg|gif|webp|ico)($|\\?)/,
+        /^\\/@.+$/,
+        /^\\/favicon\\.svg$/,
+        /^\\/node_modules\\/.*/,
+        /^\\/src\\/.*/,
+      ],
+      injectClientScript: false,
+    }),
+  ],
+});
+`;
+}
+function generateEntryClient() {
+  return `import React from "react";
+import { hydrateRoot } from "react-dom/client";
+import Layout from "./layout";
+import App from "./app";
+import "./globals.css";
+
+hydrateRoot(
+  document.getElementById("root")!,
+  <React.StrictMode>
+    <Layout>
+      <App />
+    </Layout>
+  </React.StrictMode>
+);
+`;
+}
+function generateEntryServer() {
+  return `import React from "react";
+import { renderToReadableStream } from "react-dom/server";
+import Layout from "./layout";
+import App from "./app";
+
+export async function render(_url: string): Promise<ReadableStream> {
+  const stream = await renderToReadableStream(
+    <React.StrictMode>
+      <Layout>
+        <App />
+      </Layout>
+    </React.StrictMode>,
+    {
+      onError(error: unknown) {
+        console.error("[voltx] SSR render error:", error);
+      },
+    }
+  );
+  return stream;
+}
+`;
+}
+function generateLayoutComponent(projectName) {
+  return `import React from "react";
+
+export default function Layout({ children }: { children: React.ReactNode }) {
+  return (
+    <div style={{ minHeight: "100vh", fontFamily: "system-ui, -apple-system, sans-serif", background: "#0a0a0a", color: "#ededed" }}>
+      <header style={{ borderBottom: "1px solid #1a1a1a", padding: "0.75rem 1.5rem", display: "flex", alignItems: "center", justifyContent: "space-between" }}>
+        <div style={{ display: "flex", alignItems: "center", gap: "0.5rem" }}>
+          <span style={{ fontSize: "1.25rem" }}>\u26A1</span>
+          <span style={{ fontWeight: 600 }}>${projectName}</span>
+        </div>
+        <a href="https://github.com/codewithshail/voltx" target="_blank" rel="noopener noreferrer" style={{ color: "#666", fontSize: "0.85rem", textDecoration: "none" }}>
+          Built with VoltX
+        </a>
+      </header>
+      <main>{children}</main>
+    </div>
+  );
+}
+`;
+}
+function generateGlobalCSS(useShadcn = false) {
+  if (useShadcn) {
+    return `@import "tailwindcss";
+
+@theme inline {
+  --radius-sm: 0.25rem;
+  --radius-md: 0.375rem;
+  --radius-lg: 0.5rem;
+  --radius-xl: 0.75rem;
+  --color-background: hsl(var(--background));
+  --color-foreground: hsl(var(--foreground));
+  --color-card: hsl(var(--card));
+  --color-card-foreground: hsl(var(--card-foreground));
+  --color-popover: hsl(var(--popover));
+  --color-popover-foreground: hsl(var(--popover-foreground));
+  --color-primary: hsl(var(--primary));
+  --color-primary-foreground: hsl(var(--primary-foreground));
+  --color-secondary: hsl(var(--secondary));
+  --color-secondary-foreground: hsl(var(--secondary-foreground));
+  --color-muted: hsl(var(--muted));
+  --color-muted-foreground: hsl(var(--muted-foreground));
+  --color-accent: hsl(var(--accent));
+  --color-accent-foreground: hsl(var(--accent-foreground));
+  --color-destructive: hsl(var(--destructive));
+  --color-border: hsl(var(--border));
+  --color-input: hsl(var(--input));
+  --color-ring: hsl(var(--ring));
+  --color-chart-1: hsl(var(--chart-1));
+  --color-chart-2: hsl(var(--chart-2));
+  --color-chart-3: hsl(var(--chart-3));
+  --color-chart-4: hsl(var(--chart-4));
+  --color-chart-5: hsl(var(--chart-5));
+  --color-sidebar: hsl(var(--sidebar));
+  --color-sidebar-foreground: hsl(var(--sidebar-foreground));
+  --color-sidebar-primary: hsl(var(--sidebar-primary));
+  --color-sidebar-primary-foreground: hsl(var(--sidebar-primary-foreground));
+  --color-sidebar-accent: hsl(var(--sidebar-accent));
+  --color-sidebar-accent-foreground: hsl(var(--sidebar-accent-foreground));
+  --color-sidebar-border: hsl(var(--sidebar-border));
+  --color-sidebar-ring: hsl(var(--sidebar-ring));
+}
+
+:root {
+  --background: 0 0% 4%;
+  --foreground: 0 0% 93%;
+  --card: 0 0% 6%;
+  --card-foreground: 0 0% 93%;
+  --popover: 0 0% 6%;
+  --popover-foreground: 0 0% 93%;
+  --primary: 0 0% 93%;
+  --primary-foreground: 0 0% 6%;
+  --secondary: 0 0% 12%;
+  --secondary-foreground: 0 0% 93%;
+  --muted: 0 0% 12%;
+  --muted-foreground: 0 0% 55%;
+  --accent: 0 0% 12%;
+  --accent-foreground: 0 0% 93%;
+  --destructive: 0 62% 50%;
+  --border: 0 0% 14%;
+  --input: 0 0% 14%;
+  --ring: 0 0% 83%;
+  --chart-1: 220 70% 50%;
+  --chart-2: 160 60% 45%;
+  --chart-3: 30 80% 55%;
+  --chart-4: 280 65% 60%;
+  --chart-5: 340 75% 55%;
+  --sidebar: 0 0% 5%;
+  --sidebar-foreground: 0 0% 93%;
+  --sidebar-primary: 0 0% 93%;
+  --sidebar-primary-foreground: 0 0% 6%;
+  --sidebar-accent: 0 0% 12%;
+  --sidebar-accent-foreground: 0 0% 93%;
+  --sidebar-border: 0 0% 14%;
+  --sidebar-ring: 0 0% 83%;
+}
+
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+  border-color: var(--color-border);
+}
+
+html,
+body {
+  height: 100%;
+  background: var(--color-background);
+  color: var(--color-foreground);
+  font-family: system-ui, -apple-system, sans-serif;
+  -webkit-font-smoothing: antialiased;
+}
+
+#root {
+  height: 100%;
+}
+`;
+  }
+  return `@import "tailwindcss";
+
+@theme {
+  --color-background: #0a0a0a;
+  --color-foreground: #ededed;
+  --color-muted: #888888;
+  --color-border: #222222;
+  --color-primary: #2563eb;
+  --color-accent: #a78bfa;
+  --font-sans: system-ui, -apple-system, sans-serif;
+}
+
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+
+html,
+body {
+  height: 100%;
+  background: var(--color-background);
+  color: var(--color-foreground);
+  font-family: var(--font-sans);
+  -webkit-font-smoothing: antialiased;
+}
+
+#root {
+  height: 100%;
+}
+
+a {
+  color: inherit;
+  text-decoration: none;
+}
+
+a:hover {
+  text-decoration: underline;
+}
+`;
+}
+function generateCnUtil() {
+  return `import { type ClassValue, clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}
+`;
+}
+function generateComponentsJson() {
+  return JSON.stringify({
+    "$schema": "https://ui.shadcn.com/schema.json",
+    style: "new-york",
+    rsc: false,
+    tsx: true,
+    tailwind: {
+      config: "",
+      css: "src/globals.css",
+      baseColor: "neutral",
+      cssVariables: true
+    },
+    aliases: {
+      components: "@/components",
+      utils: "@/lib/utils",
+      ui: "@/components/ui",
+      lib: "@/lib",
+      hooks: "@/hooks"
+    }
+  }, null, 2) + "\n";
+}
+function generateAppComponent(projectName, template) {
+  if (template === "blank") {
+    return `import React, { useState, useEffect } from "react";
+
+export default function App() {
+  const [status, setStatus] = useState<string>("checking...");
+
+  useEffect(() => {
+    fetch("/api")
+      .then((res) => res.json())
+      .then((data) => setStatus(data.status || "ok"))
+      .catch(() => setStatus("error"));
+  }, []);
+
+  return (
+    <div style={{ display: "flex", flexDirection: "column", alignItems: "center", justifyContent: "center", minHeight: "calc(100vh - 60px)", padding: "2rem" }}>
+      <div style={{ textAlign: "center", maxWidth: "600px" }}>
+        <div style={{ fontSize: "4rem", marginBottom: "1rem" }}>\u26A1</div>
+        <h1 style={{ fontSize: "2.5rem", fontWeight: 700, margin: "0 0 0.5rem" }}>${projectName}</h1>
+        <p style={{ color: "#888", fontSize: "1.1rem", margin: "0 0 2rem" }}>Built with VoltX</p>
+        <div style={{ display: "flex", gap: "1rem", justifyContent: "center", marginBottom: "2rem" }}>
+          <div style={{ padding: "1rem 1.5rem", borderRadius: "0.75rem", background: "#111", border: "1px solid #222" }}>
+            <div style={{ fontSize: "0.75rem", color: "#666", marginBottom: "0.25rem" }}>Server</div>
+            <div style={{ color: status === "ok" ? "#4ade80" : "#f87171" }}>{status}</div>
+          </div>
+          <div style={{ padding: "1rem 1.5rem", borderRadius: "0.75rem", background: "#111", border: "1px solid #222" }}>
+            <div style={{ fontSize: "0.75rem", color: "#666", marginBottom: "0.25rem" }}>Frontend</div>
+            <div style={{ color: "#4ade80" }}>React + Vite</div>
+          </div>
+        </div>
+        <div style={{ background: "#111", border: "1px solid #222", borderRadius: "0.75rem", padding: "1.5rem", textAlign: "left", fontSize: "0.9rem" }}>
+          <p style={{ color: "#888", margin: "0 0 1rem" }}>Get started:</p>
+          <code style={{ display: "block", color: "#a78bfa", marginBottom: "0.5rem" }}>src/app.tsx</code>
+          <p style={{ color: "#666", margin: "0 0 0.75rem", fontSize: "0.85rem" }}>Edit this file to build your UI</p>
+          <code style={{ display: "block", color: "#a78bfa", marginBottom: "0.5rem" }}>api/</code>
+          <p style={{ color: "#666", margin: 0, fontSize: "0.85rem" }}>Add API routes here (file-based routing)</p>
+        </div>
+      </div>
+    </div>
+  );
+}
+`;
+  }
+  const apiEndpoint = template === "agent-app" ? "/api/agent" : template === "rag-app" ? "/api/rag/query" : "/api/chat";
+  const isAgent = template === "agent-app";
+  const isRag = template === "rag-app";
+  return `import React, { useState, useRef, useEffect, useCallback } from "react";
+
+interface Message {
+  id: string;
+  role: "user" | "assistant";
+  content: string;
+}
+
+export default function App() {
+  const [messages, setMessages] = useState<Message[]>([]);
+  const [input, setInput] = useState("");
+  const [isLoading, setIsLoading] = useState(false);
+  const messagesEndRef = useRef<HTMLDivElement>(null);
+
+  useEffect(() => {
+    messagesEndRef.current?.scrollIntoView({ behavior: "smooth" });
+  }, [messages]);
+
+  const sendMessage = useCallback(async () => {
+    const text = input.trim();
+    if (!text || isLoading) return;
+
+    const userMsg: Message = { id: crypto.randomUUID(), role: "user", content: text };
+    setMessages((prev) => [...prev, userMsg]);
+    setInput("");
+    setIsLoading(true);
+
+    const assistantMsg: Message = { id: crypto.randomUUID(), role: "assistant", content: "" };
+    setMessages((prev) => [...prev, assistantMsg]);
+
+    try {${isAgent ? `
+      const res = await fetch("${apiEndpoint}", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ input: text }),
+      });
+      const data = await res.json();
+      setMessages((prev) =>
+        prev.map((m) => m.id === assistantMsg.id ? { ...m, content: data.content || "No response" } : m)
+      );` : `
+      const res = await fetch("${apiEndpoint}", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({${isRag ? ` question: text ` : ` messages: [...messages, { role: "user", content: text }] `}}),
+      });
+
+      if (!res.body) throw new Error("No response body");
+
+      const reader = res.body.getReader();
+      const decoder = new TextDecoder();
+      let buffer = "";
+      let fullContent = "";
+
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\\n");
+        buffer = lines.pop() ?? "";
+
+        for (const line of lines) {
+          if (!line.startsWith("data: ")) continue;
+          const data = line.slice(6);
+          if (data === "[DONE]") break;
+          try {
+            const parsed = JSON.parse(data);
+            const chunk = parsed.textDelta ?? parsed.content ?? parsed.choices?.[0]?.delta?.content ?? "";
+            if (chunk) {
+              fullContent += chunk;
+              setMessages((prev) =>
+                prev.map((m) => m.id === assistantMsg.id ? { ...m, content: fullContent } : m)
+              );
+            }
+          } catch {}
+        }
+      }`}
+    } catch (err) {
+      setMessages((prev) =>
+        prev.map((m) => m.id === assistantMsg.id ? { ...m, content: "Error: " + (err instanceof Error ? err.message : String(err)) } : m)
+      );
+    } finally {
+      setIsLoading(false);
+    }
+  }, [input, isLoading, messages]);
+
+  return (
+    <div style={{ height: "calc(100vh - 60px)", display: "flex", flexDirection: "column" }}>
+      <main style={{ flex: 1, overflow: "auto", padding: "1rem 1.5rem" }}>
+        {messages.length === 0 && (
+          <div style={{ textAlign: "center", marginTop: "4rem", color: "#555" }}>
+            <p style={{ fontSize: "1.5rem" }}>\u26A1</p>
+            <p>Start a conversation</p>
+          </div>
+        )}
+        {messages.map((msg) => (
+          <div key={msg.id} style={{ marginBottom: "1rem", display: "flex", justifyContent: msg.role === "user" ? "flex-end" : "flex-start" }}>
+            <div style={{
+              maxWidth: "70%", padding: "0.75rem 1rem", borderRadius: "0.75rem",
+              background: msg.role === "user" ? "#2563eb" : "#1a1a1a",
+              border: msg.role === "assistant" ? "1px solid #333" : "none",
+              whiteSpace: "pre-wrap", lineHeight: 1.5,
+            }}>
+              {msg.content || (isLoading && msg.role === "assistant" ? "..." : "")}
+            </div>
+          </div>
+        ))}
+        <div ref={messagesEndRef} />
+      </main>
+      <footer style={{ padding: "1rem 1.5rem", borderTop: "1px solid #222" }}>
+        <form onSubmit={(e) => { e.preventDefault(); sendMessage(); }} style={{ display: "flex", gap: "0.5rem" }}>
+          <input value={input} onChange={(e) => setInput(e.target.value)} placeholder="Type a message..." disabled={isLoading}
+            style={{ flex: 1, padding: "0.75rem 1rem", borderRadius: "0.5rem", border: "1px solid #333", background: "#111", color: "#e5e5e5", outline: "none", fontSize: "0.95rem" }} />
+          <button type="submit" disabled={isLoading || !input.trim()}
+            style={{ padding: "0.75rem 1.5rem", borderRadius: "0.5rem", border: "none", background: isLoading || !input.trim() ? "#333" : "#2563eb", color: "#fff", cursor: isLoading ? "wait" : "pointer", fontSize: "0.95rem" }}>
+            {isLoading ? "..." : "Send"}
+          </button>
+        </form>
+      </footer>
+    </div>
+  );
+}
+`;
+}
+function generateFaviconSVG() {
+  return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32">
+  <rect width="32" height="32" rx="6" fill="#0a0a0a"/>
+  <path d="M18.5 4L8 18h7l-1.5 10L24 14h-7l1.5-10z" fill="#facc15" stroke="#facc15" stroke-width="0.5" stroke-linejoin="round"/>
+</svg>
+`;
+}
+function generateRobotsTxt() {
+  return `# https://www.robotstxt.org/robotstxt.html
+User-agent: *
+Allow: /
+
+Sitemap: /sitemap.xml
+`;
+}
+function generateWebManifest(projectName) {
+  return JSON.stringify({
+    name: projectName,
+    short_name: projectName,
+    icons: [
+      { src: "/favicon.svg", sizes: "any", type: "image/svg+xml" }
+    ],
+    theme_color: "#0a0a0a",
+    background_color: "#0a0a0a",
+    display: "standalone"
+  }, null, 2) + "\n";
+}
+
+export {
+  createProject
+};