@stevederico/dotbot 0.22.0 → 0.24.0

package/CHANGELOG.md

@@ -1,3 +1,18 @@
+0.24
+
+  Add --system flag for custom prompts
+  Add tools command
+  Add stats command
+  Add memory command
+  Add jobs command
+  Add tasks command
+  Add sessions command
+  Add events command
+
+0.23
+
+  Fix no-args launches interactive
+
 0.22
 
   Simplify CLI, no args for interactive

package/README.md

@@ -3,7 +3,7 @@
   <h1 align="center" style="border-bottom: none; margin-bottom: 0;">dotbot</h1>
   <h3 align="center" style="margin-top: 0; font-weight: normal;">
     The ultra-lean AI agent.<br>
-    11k lines. 47 tools. 0 dependencies.
+    11k lines. 53 tools. 0 dependencies.
   </h3>
   <p align="center">
     <a href="https://opensource.org/licenses/mit">
@@ -13,7 +13,7 @@
       <img src="https://img.shields.io/github/stars/stevederico/dotbot?style=social" alt="GitHub stars">
     </a>
     <a href="https://github.com/stevederico/dotbot">
-      <img src="https://img.shields.io/badge/version-0.20-green" alt="version">
+      <img src="https://img.shields.io/badge/version-0.24-green" alt="version">
     </a>
     <img src="https://img.shields.io/badge/LOC-11k-orange" alt="Lines of Code">
   </p>
@@ -28,7 +28,7 @@
 | | dotbot | nanobot | OpenClaw |
 |---|:---:|:---:|:---:|
 | **Lines of Code** | **11k** | 22k | 1M+ |
-| **Tools** | **47** | ~10 | ~50 |
+| **Tools** | **53** | ~10 | ~50 |
 | **Dependencies** | Minimal | Heavy | Heavy |
 
 Everything you need for AI agents. Nothing you don't. No bloated abstractions. No dependency hell. Just a clean, focused agent that works.
@@ -42,8 +42,9 @@ A **streaming AI agent** with tool execution, autonomous tasks, and scheduled jo
 **As a CLI:**
 ```bash
 dotbot "What's the weather in San Francisco?"
-dotbot repl
+dotbot                  # Interactive mode
 dotbot serve --port 3000
+dotbot tools            # List all 53 tools
 ```
 
 **As a library:**
@@ -67,11 +68,16 @@ export XAI_API_KEY=xai-...
 # Chat
 dotbot "Summarize the top 3 AI news stories today"
 
-# Interactive REPL
-dotbot repl
+# Interactive mode
+dotbot
 
 # Start HTTP server
 dotbot serve --port 3000
+
+# Inspect data
+dotbot tools
+dotbot stats
+dotbot memory
 ```
 
 ### Library Usage
@@ -116,7 +122,7 @@ for await (const event of agent.chat({
 - **Abort support** via AbortSignal
 - **Automatic retries** with provider failover
 
-### 🔧 **47 Built-in Tools**
+### 🔧 **53 Built-in Tools**
 - **Memory** — save, search, update, delete long-term memory
 - **Web** — search, fetch, browser automation with Playwright
 - **Files** — read, write, list, delete, move files
@@ -148,18 +154,29 @@ for await (const event of agent.chat({
 ## CLI Reference
 
 ```
-dotbot v0.19 — AI agent CLI
+dotbot v0.24 — AI agent CLI
 
 Usage:
-  dotbot "message"            Send a message (default)
-  dotbot repl                 Interactive chat session
+  dotbot "message"            One-shot query
+  dotbot                      Interactive chat
   dotbot serve [--port N]     Start HTTP server (default: 3000)
 
+Commands:
+  tools                       List all available tools
+  stats                       Show database statistics
+  memory [list|search <q>]    Manage saved memories
+  jobs                        List scheduled jobs
+  tasks                       List active tasks
+  sessions                    List chat sessions
+  events [--summary]          View audit log
+
 Options:
   --provider, -p   AI provider: xai, anthropic, openai, ollama (default: xai)
   --model, -m      Model name (default: grok-4-1-fast-reasoning)
+  --system, -s     Custom system prompt (prepended to default)
   --db             SQLite database path (default: ./dotbot.db)
   --port           Server port for 'serve' command
+  --verbose        Show initialization logs
   --help, -h       Show help
   --version, -v    Show version
 
@@ -230,7 +247,7 @@ for await (const event of agent.chat({
 
 <br />
 
-## Built-in Tools (47)
+## Built-in Tools (53)
 
 | Category | Tools |
 |----------|-------|

package/bin/dotbot.js

@@ -94,9 +94,19 @@ Usage:
   dotbot                      Interactive chat
   dotbot serve [--port N]     Start HTTP server (default: ${DEFAULT_PORT})
 
+Commands:
+  tools                       List all available tools
+  stats                       Show database statistics
+  memory [list|search <q>]    Manage saved memories
+  jobs                        List scheduled jobs
+  tasks                       List active tasks
+  sessions                    List chat sessions
+  events [--summary]          View audit log
+
 Options:
   --provider, -p   AI provider: xai, anthropic, openai, ollama (default: xai)
   --model, -m      Model name (default: grok-4-1-fast-reasoning)
+  --system, -s     Custom system prompt (prepended to default)
   --db             SQLite database path (default: ${DEFAULT_DB})
   --port           Server port for 'serve' command (default: ${DEFAULT_PORT})
   --verbose        Show initialization logs
@@ -113,6 +123,9 @@ Examples:
   dotbot "What's the weather in SF?"
   dotbot
   dotbot serve --port 8080
+  dotbot tools
+  dotbot memory search "preferences"
+  dotbot --system "You are a pirate" "Hello"
 `);
 }
 
@@ -129,6 +142,8 @@ function parseCliArgs() {
         verbose: { type: 'boolean', default: false },
         provider: { type: 'string', short: 'p', default: 'xai' },
         model: { type: 'string', short: 'm', default: 'grok-4-1-fast-reasoning' },
+        system: { type: 'string', short: 's', default: '' },
+        summary: { type: 'boolean', default: false },
         db: { type: 'string', default: DEFAULT_DB },
         port: { type: 'string', default: String(DEFAULT_PORT) },
       },
@@ -179,20 +194,30 @@ async function getProviderConfig(providerId) {
  *
  * @param {string} dbPath - Path to SQLite database
  * @param {boolean} verbose - Show initialization logs
+ * @param {string} customSystemPrompt - Custom system prompt to prepend
  * @returns {Promise<Object>} Initialized stores
  */
-async function initStores(dbPath, verbose = false) {
+async function initStores(dbPath, verbose = false, customSystemPrompt = '') {
   await loadModules();
 
+  // Import defaultSystemPrompt for custom builder
+  const { defaultSystemPrompt } = await import('../storage/SQLiteAdapter.js');
+
   // Suppress init logs unless verbose
   const originalLog = console.log;
   if (!verbose) {
     console.log = () => {};
   }
 
+  // Build custom systemPromptBuilder that prepends user's text
+  const systemPromptBuilder = customSystemPrompt
+    ? (prefs) => `${customSystemPrompt}\n\n${defaultSystemPrompt(prefs)}`
+    : undefined;
+
   const sessionStore = new stores.SQLiteSessionStore();
   await sessionStore.init(dbPath, {
     prefsFetcher: async () => ({ agentName: 'Dotbot', agentPersonality: '' }),
+    ...(systemPromptBuilder && { systemPromptBuilder }),
   });
 
   const cronStore = new stores.SQLiteCronStore();
@@ -223,7 +248,7 @@ async function initStores(dbPath, verbose = false) {
  * @param {Object} options - CLI options
  */
 async function runChat(message, options) {
-  const storesObj = await initStores(options.db, options.verbose);
+  const storesObj = await initStores(options.db, options.verbose, options.system);
   const provider = await getProviderConfig(options.provider);
 
   const session = await storesObj.sessionStore.createSession('cli-user', options.model, options.provider);
@@ -282,7 +307,7 @@ async function runChat(message, options) {
  * @param {Object} options - CLI options
  */
 async function runRepl(options) {
-  const storesObj = await initStores(options.db, options.verbose);
+  const storesObj = await initStores(options.db, options.verbose, options.system);
   const provider = await getProviderConfig(options.provider);
 
   const session = await storesObj.sessionStore.createSession('cli-user', options.model, options.provider);
@@ -388,7 +413,7 @@ async function runRepl(options) {
  */
 async function runServer(options) {
   const port = parseInt(options.port, 10);
-  const storesObj = await initStores(options.db, options.verbose);
+  const storesObj = await initStores(options.db, options.verbose, options.system);
 
   const server = createServer(async (req, res) => {
     // CORS headers
@@ -482,6 +507,192 @@ async function runServer(options) {
   });
 }
 
+/**
+ * List all available tools.
+ */
+async function runTools() {
+  await loadModules();
+  console.log(`\ndotbot tools (${coreTools.length})\n`);
+
+  // Group tools by category based on name prefix
+  const categories = {};
+  for (const tool of coreTools) {
+    const prefix = tool.name.split('_')[0];
+    if (!categories[prefix]) categories[prefix] = [];
+    categories[prefix].push(tool.name);
+  }
+
+  for (const [category, tools] of Object.entries(categories).sort()) {
+    console.log(`  ${category} (${tools.length})`);
+    for (const name of tools.sort()) {
+      console.log(`    ${name}`);
+    }
+  }
+  console.log();
+}
+
+/**
+ * Show database statistics.
+ *
+ * @param {Object} options - CLI options
+ */
+async function runStats(options) {
+  const storesObj = await initStores(options.db, options.verbose, options.system);
+
+  console.log(`\ndotbot stats\n`);
+  console.log(`  Database: ${options.db}`);
+
+  // Sessions
+  const sessions = await storesObj.sessionStore.listSessions('cli-user');
+  console.log(`  Sessions: ${sessions.length}`);
+
+  // Memory
+  const memories = await storesObj.memoryStore.getAllMemories('cli-user');
+  console.log(`  Memories: ${memories.length}`);
+
+  // Jobs (need to get session IDs first)
+  const jobs = await storesObj.cronStore.listTasksBySessionIds(['default'], 'cli-user');
+  console.log(`  Jobs: ${jobs.length}`);
+
+  // Tasks
+  const tasks = await storesObj.taskStore.getTasks('cli-user');
+  console.log(`  Tasks: ${tasks.length}`);
+
+  // Triggers
+  const triggers = await storesObj.triggerStore.listTriggers('cli-user');
+  console.log(`  Triggers: ${triggers.length}`);
+
+  console.log();
+}
+
+/**
+ * Manage memories.
+ *
+ * @param {Object} options - CLI options
+ * @param {string} subcommand - list or search
+ * @param {string} query - Search query
+ */
+async function runMemory(options, subcommand, query) {
+  const storesObj = await initStores(options.db, options.verbose, options.system);
+
+  if (subcommand === 'search' && query) {
+    const results = await storesObj.memoryStore.readMemoryPattern('cli-user', `%${query}%`);
+    console.log(`\nMemory search: "${query}" (${results.length} results)\n`);
+    for (const mem of results) {
+      const val = typeof mem.value === 'string' ? mem.value : JSON.stringify(mem.value);
+      console.log(`  [${mem.key}] ${val.substring(0, 60)}${val.length > 60 ? '...' : ''}`);
+    }
+  } else {
+    const memories = await storesObj.memoryStore.getAllMemories('cli-user');
+    console.log(`\nMemories (${memories.length})\n`);
+    for (const mem of memories) {
+      const val = typeof mem.value === 'string' ? mem.value : JSON.stringify(mem.value);
+      console.log(`  [${mem.key}] ${val.substring(0, 60)}${val.length > 60 ? '...' : ''}`);
+    }
+  }
+  console.log();
+}
+
+/**
+ * List scheduled jobs.
+ *
+ * @param {Object} options - CLI options
+ */
+async function runJobs(options) {
+  const storesObj = await initStores(options.db, options.verbose, options.system);
+
+  const jobs = await storesObj.cronStore.listTasksBySessionIds(['default'], 'cli-user');
+  console.log(`\nScheduled jobs (${jobs.length})\n`);
+
+  for (const job of jobs) {
+    const status = job.enabled ? 'active' : 'paused';
+    const next = job.nextRunAt ? job.nextRunAt.toLocaleString() : 'N/A';
+    const interval = job.intervalMs ? `${Math.round(job.intervalMs / 60000)}m` : 'once';
+    console.log(`  [${job.id}] ${job.name} (${status})`);
+    console.log(`    Interval: ${interval}`);
+    console.log(`    Next: ${next}`);
+    console.log(`    Prompt: ${job.prompt.substring(0, 50)}${job.prompt.length > 50 ? '...' : ''}`);
+    console.log();
+  }
+}
+
+/**
+ * List active tasks.
+ *
+ * @param {Object} options - CLI options
+ */
+async function runTasks(options) {
+  const storesObj = await initStores(options.db, options.verbose, options.system);
+
+  const tasks = await storesObj.taskStore.getTasks('cli-user');
+  console.log(`\nTasks (${tasks.length})\n`);
+
+  for (const task of tasks) {
+    const steps = task.steps ? JSON.parse(task.steps) : [];
+    const progress = `${task.current_step || 0}/${steps.length}`;
+    console.log(`  [${task.id}] ${task.status} (${progress})`);
+    console.log(`    Description: ${task.description?.substring(0, 50) || 'N/A'}${task.description?.length > 50 ? '...' : ''}`);
+    console.log(`    Mode: ${task.mode || 'auto'}`);
+    console.log(`    Created: ${new Date(task.created_at).toLocaleString()}`);
+    console.log();
+  }
+}
+
+/**
+ * List chat sessions.
+ *
+ * @param {Object} options - CLI options
+ */
+async function runSessions(options) {
+  const storesObj = await initStores(options.db, options.verbose, options.system);
+
+  const sessions = await storesObj.sessionStore.listSessions('cli-user');
+  console.log(`\nSessions (${sessions.length})\n`);
+
+  for (const session of sessions) {
+    const updated = new Date(session.updatedAt).toLocaleString();
+    const msgCount = session.messageCount || 0;
+    console.log(`  [${session.id}]`);
+    console.log(`    Title: ${session.title || 'Untitled'}`);
+    console.log(`    Messages: ${msgCount}`);
+    console.log(`    Updated: ${updated}`);
+    console.log();
+  }
+}
+
+/**
+ * View audit log events.
+ *
+ * @param {Object} options - CLI options
+ */
+async function runEvents(options) {
+  const storesObj = await initStores(options.db, options.verbose, options.system);
+
+  if (options.summary) {
+    const summary = await storesObj.eventStore.summary({ userId: 'cli-user' });
+    console.log(`\nEvent summary\n`);
+    console.log(`  Total events: ${summary.total || 0}`);
+    if (summary.breakdown) {
+      for (const [type, count] of Object.entries(summary.breakdown)) {
+        console.log(`  ${type}: ${count}`);
+      }
+    }
+  } else {
+    const events = await storesObj.eventStore.query({ userId: 'cli-user', limit: 20 });
+    console.log(`\nRecent events (${events.length})\n`);
+
+    for (const event of events) {
+      const time = new Date(event.timestamp).toLocaleString();
+      console.log(`  [${time}] ${event.type}`);
+      if (event.data) {
+        const data = typeof event.data === 'string' ? event.data : JSON.stringify(event.data);
+        console.log(`    ${data.substring(0, 60)}${data.length > 60 ? '...' : ''}`);
+      }
+    }
+  }
+  console.log();
+}
+
 /**
  * Main entry point.
  */
@@ -493,21 +704,45 @@ async function main() {
     process.exit(0);
   }
 
-  if (args.help || args.positionals.length === 0) {
+  if (args.help) {
     printHelp();
     process.exit(0);
   }
 
   const command = args.positionals[0];
 
-  if (command === 'serve') {
-    await runServer(args);
-  } else {
-    const message = args.positionals.join(' ');
-    if (message) {
-      await runChat(message, args);
-    } else {
-      await runRepl(args);
+  switch (command) {
+    case 'serve':
+      await runServer(args);
+      break;
+    case 'tools':
+      await runTools();
+      break;
+    case 'stats':
+      await runStats(args);
+      break;
+    case 'memory':
+      await runMemory(args, args.positionals[1], args.positionals.slice(2).join(' '));
+      break;
+    case 'jobs':
+      await runJobs(args);
+      break;
+    case 'tasks':
+      await runTasks(args);
+      break;
+    case 'sessions':
+      await runSessions(args);
+      break;
+    case 'events':
+      await runEvents(args);
+      break;
+    default: {
+      const message = args.positionals.join(' ');
+      if (message) {
+        await runChat(message, args);
+      } else {
+        await runRepl(args);
+      }
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stevederico/dotbot",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "description": "AI agent CLI and library for Node.js — streaming, multi-provider, tool execution, autonomous tasks",
   "type": "module",
   "main": "index.js",