@yesvara/svara 0.1.2 → 0.2.0

package/CONTRIBUTING.md

@@ -1,6 +1,6 @@
 # Contributing to SvaraJS
 
-Thanks for your interest in contributing! We welcome all contributions—bug reports, feature requests, documentation improvements, and pull requests.
+Thanks for your interest in contributing! We welcome all contributions such as bug reports, feature requests, documentation improvements, and pull requests.
 
 ## Code of Conduct
 

package/README.md

@@ -3,7 +3,7 @@
 
 <!-- # @yesvara/svara -->
 
-**Build AI agents in 15 lines. Ship to production.**
+**Build AI agents in less than 9 lines. Ship to production.**
 
 A batteries-included Node.js framework for building agentic AI backends.  
 Multi-channel, RAG-ready, and designed for developers who value simplicity.
@@ -22,18 +22,16 @@ Multi-channel, RAG-ready, and designed for developers who value simplicity.
 Most AI frameworks make you think about infrastructure. SvaraJS makes you think about your agent.
 
 ```ts
-import { SvaraApp, SvaraAgent } from '@yesvara/svara';
-
-const app = new SvaraApp();
+import { SvaraApp, SvaraAgent, createTool } from '@yesvara/svara';
 
 const agent = new SvaraAgent({
   name: 'Support Bot',
   model: 'gpt-4o-mini',       // provider auto-detected
-  knowledge: './docs',         // PDF, MD, TXT — just point to a folder
+  knowledge: './docs',         // PDF, MD, TXT, just point to a folder
+  tools: [tool_1, tool_2, tool_3], // Agent choose the right tool for answer
 });
 
-app.route('/chat', agent.handler());
-app.listen(3000);
+const app = new SvaraApp().route('/chat', agent.handler()).listen(3000);
 // Done. Your agent handles 1000 conversations.
 ```
 
@@ -44,7 +42,7 @@ That's it. No pipeline setup. No embedding boilerplate. No webhook configuration
 
 ## Features
 
-| | |
+|||
 |---|---|
 | **Zero-config LLM** | Pass a model name, provider is auto-detected |
 | **Instant RAG** | Point to a folder, documents are indexed automatically |
@@ -359,7 +357,7 @@ agent
     verifyToken: process.env.WA_VERIFY_TOKEN,
   });
 
-await agent.start();
+await agent.start(); // Start all channels
 ```
 
 ### Events
@@ -416,12 +414,15 @@ console.log(reply); // "It's currently 14:32 UTC..."
 const agent = new SvaraAgent({
   name: 'Support Bot',
   model: 'gpt-4o-mini',
-  knowledge: './docs',
+  knowledge: './docs',  // Auto-loaded on first request
   systemPrompt: 'You are a customer support agent. Answer using the documentation.',
   memory: { window: 20 },
 });
 
-await agent.start(); // indexes documents
+const app = new SvaraApp({ cors: true });
+app.route('/chat', agent.handler());
+app.listen(3000);
+// Knowledge indexes automatically on first request
 ```
 
 ### Multi-channel (Web + Telegram + WhatsApp)
@@ -462,21 +463,105 @@ app.listen(3000);
 
 ---
 
+## Adding Knowledge & Tools at Runtime
+
+### Adding knowledge (dynamic indexing)
+
+After the agent is created, add more documents **without restarting**:
+
+```ts
+const agent = new SvaraAgent({
+  name: 'Support Bot',
+  model: 'gpt-4o-mini',
+  knowledge: './docs',  // Initial knowledge
+});
+
+// ── Later (no restart needed) ──────────────────────
+// Add a single document
+await agent.addKnowledge('./policies/new-policy-2024.pdf');
+
+// Add multiple documents
+await agent.addKnowledge(['./faq.md', './terms.txt', './pricing.pdf']);
+
+// Agent immediately has the new knowledge
+```
+
+**Real-world example** — admin endpoint to upload documents:
+
+```ts
+const app = new SvaraApp({ cors: true });
+app.route('/chat', agent.handler());
+
+// Admin: dynamically add knowledge
+app.post('/admin/add-knowledge', async (req, res) => {
+  const { path } = req.body;
+  try {
+    await agent.addKnowledge(path);
+    res.json({ status: 'Knowledge added', path });
+  } catch (err) {
+    res.status(400).json({ error: (err as Error).message });
+  }
+});
+
+app.listen(3000);
+```
+
+### Adding tools (dynamic function calling)
+
+Add tools at runtime with `addTool()`:
+
+```ts
+import { SvaraAgent, createTool } from '@yesvara/svara';
+
+const agent = new SvaraAgent({
+  name: 'Assistant',
+  model: 'gpt-4o-mini',
+  tools: [initialTool],  // Start with one tool
+});
+
+// ── Later ────────────────────────────────────────
+// Add more tools dynamically
+const newTool = createTool({
+  name: 'send_email',
+  description: 'Send an email to a user',
+  parameters: {
+    to: { type: 'string', description: 'Email address', required: true },
+    subject: { type: 'string', description: 'Email subject', required: true },
+    body: { type: 'string', description: 'Email body', required: true },
+  },
+  async run({ to, subject, body }) {
+    // Call your email service
+    return { status: 'sent', to, subject };
+  },
+});
+
+agent.addTool(newTool);
+
+// Agent can now use send_email tool
+```
+
+**Chainable tool registration** (multiple tools):
+
+```ts
+agent
+  .addTool(emailTool)
+  .addTool(databaseTool)
+  .addTool(slackTool)
+  .addTool(webhookTool);
+```
+
+---
+
 ## CLI
 
+### Create a new project
+
 ```bash
-# Scaffold a new project
 svara new my-app
-
-# Start dev server with hot-reload
-svara dev
-
-# Build for production
-svara build
 ```
 
+Output:
 ```
-$ svara new my-app
 ✨ Creating SvaraJS project: my-app
 
   ✓ package.json
@@ -494,6 +579,89 @@ $ svara new my-app
   npm run dev
 ```
 
+Options:
+- `--template <name>` — Use a specific template (default: `basic`)
+  - `basic` — Simple agent with HTTP endpoint
+  - `rag` — RAG-powered agent with document loader
+  - `multi-channel` — Web + Telegram + WhatsApp setup
+  - `tools` — Agent with tool calling examples
+
+### Start development server
+
+```bash
+svara dev
+```
+
+Features:
+- Hot-reload on file changes
+- Auto-restart agent on code updates
+- Debug logging enabled
+- Serves on `http://localhost:3000` (configurable)
+
+Options:
+- `--port <number>` — Custom port (default: `3000`)
+- `--watch <glob>` — Watch additional paths (default: `src/**`)
+- `--env <file>` — Load custom .env file
+
+### Build for production
+
+```bash
+svara build
+```
+
+Outputs:
+- `dist/` — Compiled JavaScript
+- `dist/index.js` — Entry point (ready for Node or Docker)
+- Source maps and type declarations included
+
+Options:
+- `--minify` — Minify output
+- `--sourcemaps` — Include source maps (default: true)
+- `--outdir <path>` — Custom output directory (default: `dist/`)
+
+### Running built projects
+
+```bash
+# After building
+node dist/index.js
+
+# Or with env file
+NODE_ENV=production OPENAI_API_KEY=sk-... node dist/index.js
+```
+
+### Database management
+
+```bash
+# Initialize database (auto-creates tables)
+svara db init
+
+# Show database schema
+svara db schema
+
+# Export users and conversation history
+svara db export --format json
+svara db export --format csv --table svara_messages
+
+# Query database directly
+svara db query "SELECT COUNT(*) FROM svara_users"
+
+# Reset database (⚠️ deletes all data)
+svara db reset
+
+# Backup database
+svara db backup --output backup-2026-01-15.db
+
+# Restore from backup
+svara db restore --input backup-2026-01-15.db
+```
+
+Options:
+- `--db <path>` — Custom database path (default: `./data/svara.db`)
+- `--format <type>` — Export format: `json`, `csv`, `sql` (default: `json`)
+- `--table <name>` — Specific table to export
+- `--output <path>` — Output file path
+- `--force` — Skip confirmation prompts (use with `reset` carefully!)
+
 ---
 
 ## Built-in Database

package/dist/cli/index.js

@@ -97,7 +97,7 @@ function generatePackageJson(name) {
       start: "node dist/index.js"
     },
     dependencies: {
-      svarajs: "latest",
+      "@yesvara/svara": "^0.1.3",
       dotenv: "^16.4.5"
     },
     devDependencies: {
@@ -144,55 +144,53 @@ function generateIndexFile(name, provider, channels) {
     anthropic: "claude-opus-4-6",
     ollama: "llama3"
   };
-  const channelSetup = channels.map((ch) => {
-    if (ch === "web") return `agent.use('web', { port: 3000, cors: true });`;
-    if (ch === "telegram") return `agent.use('telegram', { token: process.env.TELEGRAM_BOT_TOKEN! });`;
-    if (ch === "whatsapp") return [
-      `agent.use('whatsapp', {`,
-      `  token: process.env.WA_ACCESS_TOKEN!,`,
-      `  phoneId: process.env.WA_PHONE_ID!,`,
-      `  verifyToken: process.env.WA_VERIFY_TOKEN!,`,
-      `});`
-    ].join("\n");
+  const channelSetup = channels.includes("web") ? `const app = new SvaraApp({ cors: true });
+app.route('/chat', agent.handler());
+app.listen(3000);` : channels.length > 0 ? `agent
+  ${channels.map((ch) => {
+    if (ch === "telegram") return `.connectChannel('telegram', { token: process.env.TELEGRAM_BOT_TOKEN! })`;
+    if (ch === "whatsapp")
+      return `.connectChannel('whatsapp', {
+    token: process.env.WA_ACCESS_TOKEN!,
+    phoneId: process.env.WA_PHONE_ID!,
+    verifyToken: process.env.WA_VERIFY_TOKEN!,
+  })`;
     return "";
-  }).filter(Boolean).join("\n");
+  }).filter(Boolean).join("\n  ")};
+await agent.start();` : "";
   return `import 'dotenv/config';
-import { svara } from 'svarajs';
+import { SvaraApp, SvaraAgent, createTool } from '@yesvara/svara';
 
 /**
  * ${name} \u2014 powered by SvaraJS
  */
-const agent = svara({
-  llm: {
-    provider: '${provider}',
-    model: '${modelMap[provider] ?? "gpt-4o"}',
-  },
-  systemPrompt: \`You are a helpful AI assistant called ${name}.
-Be concise, friendly, and always try your best to help.\`,
-  memory: {
-    type: 'conversation',
-    maxMessages: 20,
-  },
-  verbose: true,
-});
 
-// \u2500\u2500 Tools \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-agent.tool('get_time', {
+// Define tools
+const timeTool = createTool({
+  name: 'get_time',
   description: 'Get the current date and time',
   parameters: {},
-  execute: async () => ({
-    datetime: new Date().toISOString(),
-    timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
-  }),
+  async run() {
+    return {
+      datetime: new Date().toISOString(),
+      timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+    };
+  },
+});
+
+// Create agent
+const agent = new SvaraAgent({
+  name: '${name}',
+  model: '${modelMap[provider] ?? "gpt-4o"}',
+  systemPrompt: 'You are a helpful AI assistant. Be concise and friendly.',
+  tools: [timeTool],
+  knowledge: './docs', // Add your documents here for RAG
 });
 
-// \u2500\u2500 Channels \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\u2500\u2500\u2500\u2500\u2500
+// Setup channels
 ${channelSetup}
 
-// \u2500\u2500 Start \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-agent.start().then(() => {
-  console.log('\u{1F680} ${name} is running!');
-});
+console.log('\u2728 ${name} is running!');
 `;
 }
 function generateGitignore() {

package/dist/cli/index.mjs

@@ -9,7 +9,7 @@ var pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
 var program = new Command();
 program.name("svara").description(pkg.description).version(pkg.version, "-v, --version");
 program.command("new <name>").description("Create a new SvaraJS project").option("--provider <provider>", "LLM provider (openai|anthropic|ollama)", "openai").option("--channel <channels...>", "Channels to include", ["web"]).option("--no-install", "Skip npm install").action(async (name, opts) => {
-  const { newProject } = await import("../new-7K4NIDZO.mjs");
+  const { newProject } = await import("../new-ULRP6IUQ.mjs");
   await newProject({
     name,
     provider: opts.provider,

package/dist/index.d.mts

@@ -446,6 +446,7 @@ declare class SvaraAgent extends EventEmitter {
     private retriever;
     private knowledgePaths;
     private isStarted;
+    private isKnowledgeInitialized;
     private db;
     constructor(config: AgentConfig);
     /**

package/dist/index.d.ts

@@ -446,6 +446,7 @@ declare class SvaraAgent extends EventEmitter {
     private retriever;
     private knowledgePaths;
     private isStarted;
+    private isKnowledgeInitialized;
     private db;
     constructor(config: AgentConfig);
     /**

package/dist/index.js

@@ -1701,6 +1701,7 @@ var SvaraAgent = class extends import_events.default {
   // Store VectorRetriever for retrieveChunks access
   knowledgePaths = [];
   isStarted = false;
+  isKnowledgeInitialized = false;
   db;
   constructor(config) {
     super();
@@ -1809,6 +1810,15 @@ var SvaraAgent = class extends import_events.default {
    */
   handler() {
     return async (req, res) => {
+      if (this.knowledgePaths.length > 0 && !this.isKnowledgeInitialized) {
+        try {
+          await this.initKnowledge(this.knowledgePaths);
+          this.isKnowledgeInitialized = true;
+        } catch (err) {
+          const error = err;
+          this.log("error", `Failed to initialize knowledge: ${error.message}`);
+        }
+      }
       const { message, sessionId, userId } = req.body;
       if (!message?.trim()) {
         res.status(400).json({

package/dist/index.mjs

@@ -891,6 +891,7 @@ var SvaraAgent = class extends EventEmitter {
   // Store VectorRetriever for retrieveChunks access
   knowledgePaths = [];
   isStarted = false;
+  isKnowledgeInitialized = false;
   db;
   constructor(config) {
     super();
@@ -999,6 +1000,15 @@ var SvaraAgent = class extends EventEmitter {
    */
   handler() {
     return async (req, res) => {
+      if (this.knowledgePaths.length > 0 && !this.isKnowledgeInitialized) {
+        try {
+          await this.initKnowledge(this.knowledgePaths);
+          this.isKnowledgeInitialized = true;
+        } catch (err) {
+          const error = err;
+          this.log("error", `Failed to initialize knowledge: ${error.message}`);
+        }
+      }
       const { message, sessionId, userId } = req.body;
       if (!message?.trim()) {
         res.status(400).json({

package/dist/{new-7K4NIDZO.mjs → new-ULRP6IUQ.mjs}

@@ -66,7 +66,7 @@ function generatePackageJson(name) {
       start: "node dist/index.js"
     },
     dependencies: {
-      svarajs: "latest",
+      "@yesvara/svara": "^0.1.3",
       dotenv: "^16.4.5"
     },
     devDependencies: {
@@ -113,55 +113,53 @@ function generateIndexFile(name, provider, channels) {
     anthropic: "claude-opus-4-6",
     ollama: "llama3"
   };
-  const channelSetup = channels.map((ch) => {
-    if (ch === "web") return `agent.use('web', { port: 3000, cors: true });`;
-    if (ch === "telegram") return `agent.use('telegram', { token: process.env.TELEGRAM_BOT_TOKEN! });`;
-    if (ch === "whatsapp") return [
-      `agent.use('whatsapp', {`,
-      `  token: process.env.WA_ACCESS_TOKEN!,`,
-      `  phoneId: process.env.WA_PHONE_ID!,`,
-      `  verifyToken: process.env.WA_VERIFY_TOKEN!,`,
-      `});`
-    ].join("\n");
+  const channelSetup = channels.includes("web") ? `const app = new SvaraApp({ cors: true });
+app.route('/chat', agent.handler());
+app.listen(3000);` : channels.length > 0 ? `agent
+  ${channels.map((ch) => {
+    if (ch === "telegram") return `.connectChannel('telegram', { token: process.env.TELEGRAM_BOT_TOKEN! })`;
+    if (ch === "whatsapp")
+      return `.connectChannel('whatsapp', {
+    token: process.env.WA_ACCESS_TOKEN!,
+    phoneId: process.env.WA_PHONE_ID!,
+    verifyToken: process.env.WA_VERIFY_TOKEN!,
+  })`;
     return "";
-  }).filter(Boolean).join("\n");
+  }).filter(Boolean).join("\n  ")};
+await agent.start();` : "";
   return `import 'dotenv/config';
-import { svara } from 'svarajs';
+import { SvaraApp, SvaraAgent, createTool } from '@yesvara/svara';
 
 /**
  * ${name} \u2014 powered by SvaraJS
  */
-const agent = svara({
-  llm: {
-    provider: '${provider}',
-    model: '${modelMap[provider] ?? "gpt-4o"}',
-  },
-  systemPrompt: \`You are a helpful AI assistant called ${name}.
-Be concise, friendly, and always try your best to help.\`,
-  memory: {
-    type: 'conversation',
-    maxMessages: 20,
-  },
-  verbose: true,
-});
 
-// \u2500\u2500 Tools \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-agent.tool('get_time', {
+// Define tools
+const timeTool = createTool({
+  name: 'get_time',
   description: 'Get the current date and time',
   parameters: {},
-  execute: async () => ({
-    datetime: new Date().toISOString(),
-    timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
-  }),
+  async run() {
+    return {
+      datetime: new Date().toISOString(),
+      timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+    };
+  },
 });
 
-// \u2500\u2500 Channels \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\u2500\u2500\u2500\u2500\u2500
+// Create agent
+const agent = new SvaraAgent({
+  name: '${name}',
+  model: '${modelMap[provider] ?? "gpt-4o"}',
+  systemPrompt: 'You are a helpful AI assistant. Be concise and friendly.',
+  tools: [timeTool],
+  knowledge: './docs', // Add your documents here for RAG
+});
+
+// Setup channels
 ${channelSetup}
 
-// \u2500\u2500 Start \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-agent.start().then(() => {
-  console.log('\u{1F680} ${name} is running!');
-});
+console.log('\u2728 ${name} is running!');
 `;
 }
 function generateGitignore() {

package/examples/03-rag-knowledge/index.ts

@@ -31,11 +31,9 @@ Always be friendly and professional.`,
   memory: { window: 20 },
 });
 
-// You can also add knowledge dynamically (hot reload, no restart needed)
-// await agent.addKnowledge('./new-policy-2024.pdf');
-
 const app = new SvaraApp({ cors: true });
 app.route('/chat', agent.handler());
 
-await agent.start(); // indexes documents
 app.listen(3000);
+console.log('✓ Agent running on http://localhost:3000');
+console.log('  Knowledge base auto-loads on first request');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yesvara/svara",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Build AI agents in 15 lines of code. Multi-channel, RAG-ready, production-grade.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/cli/commands/new.ts

@@ -86,7 +86,7 @@ function generatePackageJson(name: string): string {
       start: 'node dist/index.js',
     },
     dependencies: {
-      svarajs: 'latest',
+      '@yesvara/svara': '^0.1.3',
       dotenv: '^16.4.5',
     },
     devDependencies: {
@@ -147,59 +147,53 @@ function generateIndexFile(
     ollama: 'llama3',
   };
 
-  const channelSetup = channels
-    .map((ch) => {
-      if (ch === 'web') return `agent.use('web', { port: 3000, cors: true });`;
-      if (ch === 'telegram') return `agent.use('telegram', { token: process.env.TELEGRAM_BOT_TOKEN! });`;
-      if (ch === 'whatsapp') return [
-        `agent.use('whatsapp', {`,
-        `  token: process.env.WA_ACCESS_TOKEN!,`,
-        `  phoneId: process.env.WA_PHONE_ID!,`,
-        `  verifyToken: process.env.WA_VERIFY_TOKEN!,`,
-        `});`,
-      ].join('\n');
-      return '';
-    })
-    .filter(Boolean)
-    .join('\n');
+  const channelSetup = channels.includes('web')
+    ? `const app = new SvaraApp({ cors: true });\napp.route('/chat', agent.handler());\napp.listen(3000);`
+    : channels.length > 0
+      ? `agent\n  ${channels
+          .map((ch) => {
+            if (ch === 'telegram') return `.connectChannel('telegram', { token: process.env.TELEGRAM_BOT_TOKEN! })`;
+            if (ch === 'whatsapp')
+              return `.connectChannel('whatsapp', {\n    token: process.env.WA_ACCESS_TOKEN!,\n    phoneId: process.env.WA_PHONE_ID!,\n    verifyToken: process.env.WA_VERIFY_TOKEN!,\n  })`;
+            return '';
+          })
+          .filter(Boolean)
+          .join('\n  ')};\nawait agent.start();`
+      : '';
 
   return `import 'dotenv/config';
-import { svara } from 'svarajs';
+import { SvaraApp, SvaraAgent, createTool } from '@yesvara/svara';
 
 /**
  * ${name} — powered by SvaraJS
  */
-const agent = svara({
-  llm: {
-    provider: '${provider}',
-    model: '${modelMap[provider] ?? 'gpt-4o'}',
-  },
-  systemPrompt: \`You are a helpful AI assistant called ${name}.
-Be concise, friendly, and always try your best to help.\`,
-  memory: {
-    type: 'conversation',
-    maxMessages: 20,
-  },
-  verbose: true,
-});
 
-// ── Tools ──────────────────────────────────────────────────────────────────
-agent.tool('get_time', {
+// Define tools
+const timeTool = createTool({
+  name: 'get_time',
   description: 'Get the current date and time',
   parameters: {},
-  execute: async () => ({
-    datetime: new Date().toISOString(),
-    timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
-  }),
+  async run() {
+    return {
+      datetime: new Date().toISOString(),
+      timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+    };
+  },
 });
 
-// ── Channels ────────────────────────────────────────────────────────────────
+// Create agent
+const agent = new SvaraAgent({
+  name: '${name}',
+  model: '${modelMap[provider] ?? 'gpt-4o'}',
+  systemPrompt: 'You are a helpful AI assistant. Be concise and friendly.',
+  tools: [timeTool],
+  knowledge: './docs', // Add your documents here for RAG
+});
+
+// Setup channels
 ${channelSetup}
 
-// ── Start ────────────────────────────────────────────────────────────────────
-agent.start().then(() => {
-  console.log('🚀 ${name} is running!');
-});
+console.log('✨ ${name} is running!');
 `;
 }
 

package/src/core/agent.ts

@@ -173,6 +173,7 @@ export class SvaraAgent extends EventEmitter {
   private retriever: any = null; // Store VectorRetriever for retrieveChunks access
   private knowledgePaths: string[] = [];
   private isStarted = false;
+  private isKnowledgeInitialized = false;
   private db: SvaraDB;
 
   constructor(config: AgentConfig) {
@@ -303,6 +304,17 @@ export class SvaraAgent extends EventEmitter {
    */
   handler(): RequestHandler {
     return async (req, res) => {
+      // Auto-initialize knowledge on first request (lazy loading)
+      if (this.knowledgePaths.length > 0 && !this.isKnowledgeInitialized) {
+        try {
+          await this.initKnowledge(this.knowledgePaths);
+          this.isKnowledgeInitialized = true;
+        } catch (err) {
+          const error = err as Error;
+          this.log('error', `Failed to initialize knowledge: ${error.message}`);
+        }
+      }
+
       const { message, sessionId, userId } = req.body as {
         message?: string;
         sessionId?: string;

package/test-rag.ts

@@ -1,20 +0,0 @@
-import 'dotenv/config';
-import { SvaraApp, SvaraAgent } from './src/index.js';
-
-async function main() {
-  const app = new SvaraApp({ cors: true });
-  
-  const agent = new SvaraAgent({
-    name: 'TestAgent',
-    model: 'gpt-4o-mini',
-    knowledge: '/Users/920078/Documents/svara/contoh_folder_knowledge/**/*',
-    verbose: true,
-  });
-  
-  await agent.start();
-  app.route('/chat', agent.handler());
-  app.listen(3000);
-  console.log('✓ Test server on port 3000');
-}
-
-main().catch(console.error);