@voltx/cli 0.3.2 → 0.3.4

package/dist/chunk-FN7KZJ6H.mjs

@@ -0,0 +1,363 @@
+import {
+  printWelcomeBanner
+} from "./chunk-IV352HZA.mjs";
+import {
+  __require
+} from "./chunk-Y6FXYEAI.mjs";
+
+// src/create.ts
+import * as fs from "fs";
+import * as path from "path";
+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);
+  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 };
+  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: 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}",
+  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: "src/routes",
+    staticDir: "public",
+    cors: true,
+  },
+});
+`;
+  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";
+import config from "../voltx.config";
+
+const app = createApp(config);
+app.start();
+`
+  );
+  fs.writeFileSync(
+    path.join(targetDir, "src", "routes", "index.ts"),
+    `// GET / \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, "src", "routes", "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, "src", "agents"), { recursive: true });
+    fs.mkdirSync(path.join(targetDir, "src", "tools"), { recursive: true });
+    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 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 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, "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"),
+      `// 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, "src", "routes", "api", "rag"), { recursive: true });
+    fs.writeFileSync(
+      path.join(targetDir, "src", "routes", "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, "src", "routes", "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, "src", "routes", "api", "auth"), { recursive: true });
+    fs.writeFileSync(
+      path.join(targetDir, "src", "routes", "api", "auth", "[...path].ts"),
+      `// ALL /api/auth/* \u2014 Better Auth handler
+import type { Context } from "@voltx/server";
+import { auth } from "../../../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.mkdirSync(path.join(targetDir, "src", "lib"), { recursive: true });
+    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.mkdirSync(path.join(targetDir, "src", "lib"), { recursive: true });
+    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, "src", "routes", "api", "auth.ts"),
+      `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);
+  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";
+    if (template === "agent-app") {
+      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 \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");
+  printWelcomeBanner(name);
+}
+var isDirectRun = typeof __require !== "undefined" && __require.main === module && process.argv[1]?.includes("create");
+if (isDirectRun) {
+  const projectName = process.argv[2];
+  if (!projectName) {
+    console.log("Usage: create-voltx-app <project-name> [--template chatbot] [--auth jwt]");
+    process.exit(1);
+  }
+  const templateFlag = process.argv.indexOf("--template");
+  const template = templateFlag !== -1 ? process.argv[templateFlag + 1] : "blank";
+  const authFlag = process.argv.indexOf("--auth");
+  const auth = authFlag !== -1 ? process.argv[authFlag + 1] : "none";
+  createProject({ name: projectName, template, auth }).catch((err) => {
+    console.error("[voltx] Error:", err);
+    process.exit(1);
+  });
+}
+
+export {
+  createProject
+};

package/dist/chunk-HAFJKS2O.mjs

@@ -0,0 +1,141 @@
+// src/generate.ts
+import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { join, dirname } from "path";
+async function runGenerate(options) {
+  const cwd = process.cwd();
+  const { type, name } = options;
+  switch (type) {
+    case "route":
+      generateRoute(cwd, name, options.method);
+      break;
+    case "agent":
+      generateAgent(cwd, name);
+      break;
+    case "tool":
+      generateTool(cwd, name);
+      break;
+    case "job":
+      generateJob(cwd, name);
+      break;
+    default:
+      console.error(`[voltx] Unknown generator type: ${type}`);
+      console.error("[voltx] Available: route, agent, tool, job");
+      process.exit(1);
+  }
+}
+function generateRoute(cwd, name, method = "POST") {
+  const routePath = name.startsWith("/") ? name.slice(1) : name;
+  const filePath = join(cwd, "src", "routes", `${routePath}.ts`);
+  if (existsSync(filePath)) {
+    console.error(`[voltx] Route already exists: src/routes/${routePath}.ts`);
+    process.exit(1);
+  }
+  const upperMethod = method.toUpperCase();
+  const urlPath = "/" + routePath;
+  const content = `// ${upperMethod} ${urlPath}
+import type { Context } from "@voltx/server";
+
+export async function ${upperMethod}(c: Context) {
+  return c.json({ message: "Hello from ${urlPath}" });
+}
+`;
+  writeFileSafe(filePath, content);
+  console.log(`  \u2713 Created route: src/routes/${routePath}.ts`);
+  console.log(`    ${upperMethod} ${urlPath}`);
+}
+function generateAgent(cwd, name) {
+  const filePath = join(cwd, "src", "agents", `${name}.ts`);
+  if (existsSync(filePath)) {
+    console.error(`[voltx] Agent already exists: src/agents/${name}.ts`);
+    process.exit(1);
+  }
+  const content = `// Agent: ${name}
+import { createAgent } from "@voltx/agents";
+
+export const ${toCamelCase(name)} = createAgent({
+  name: "${name}",
+  model: "cerebras:llama3.1-8b",
+  instructions: "You are a helpful AI assistant named ${name}.",
+  tools: [
+    // Add tools here:
+    // {
+    //   name: "example",
+    //   description: "An example tool",
+    //   parameters: { type: "object", properties: { input: { type: "string" } }, required: ["input"] },
+    //   execute: async (params) => \`Processed: \${params.input}\`,
+    // },
+  ],
+});
+`;
+  writeFileSafe(filePath, content);
+  console.log(`  \u2713 Created agent: src/agents/${name}.ts`);
+}
+function generateTool(cwd, name) {
+  const filePath = join(cwd, "src", "tools", `${name}.ts`);
+  if (existsSync(filePath)) {
+    console.error(`[voltx] Tool already exists: src/tools/${name}.ts`);
+    process.exit(1);
+  }
+  const content = `// Tool: ${name}
+
+export const ${toCamelCase(name)}Tool = {
+  name: "${name}",
+  description: "TODO: Describe what this tool does",
+  parameters: {
+    type: "object" as const,
+    properties: {
+      input: { type: "string", description: "The input to process" },
+    },
+    required: ["input"],
+  },
+  execute: async (params: { input: string }): Promise<string> => {
+    // TODO: Implement tool logic
+    return \`${name} result for: \${params.input}\`;
+  },
+};
+`;
+  writeFileSafe(filePath, content);
+  console.log(`  \u2713 Created tool: src/tools/${name}.ts`);
+}
+function generateJob(cwd, name) {
+  const filePath = join(cwd, "src", "jobs", `${name}.ts`);
+  if (existsSync(filePath)) {
+    console.error(`[voltx] Job already exists: src/jobs/${name}.ts`);
+    process.exit(1);
+  }
+  const content = `// Job: ${name}
+// Runs on a schedule or triggered via ctx.jobs.enqueue("${name}", data)
+
+export const config = {
+  // Cron schedule (uncomment to enable):
+  // schedule: "0 */6 * * *",  // every 6 hours
+  //
+  // Or make it a queue job (triggered on-demand):
+  queue: true,
+  retries: 3,
+  timeout: "5m",
+};
+
+export async function run(ctx: any, data?: Record<string, unknown>) {
+  console.log("[job:${name}] Running...", data);
+
+  // TODO: Implement job logic
+
+  console.log("[job:${name}] Done.");
+}
+`;
+  writeFileSafe(filePath, content);
+  console.log(`  \u2713 Created job: src/jobs/${name}.ts`);
+}
+function writeFileSafe(filePath, content) {
+  const dir = dirname(filePath);
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(filePath, content, "utf-8");
+}
+function toCamelCase(str) {
+  return str.replace(/[-_](.)/g, (_, c) => c.toUpperCase()).replace(/^(.)/, (_, c) => c.toLowerCase());
+}
+
+export {
+  runGenerate
+};