obol-ai 0.2.4 → 0.2.6

package/.claude/settings.local.json

@@ -14,7 +14,8 @@
       "Bash(git -C /Users/jovinkenroye/Sites/obol diff --stat)",
       "Bash(git -C /Users/jovinkenroye/Sites/obol add:*)",
       "Bash(git -C:*)",
-      "Bash(pass ls:*)"
+      "Bash(pass ls:*)",
+      "mcp__context7__query-docs"
     ]
   }
 }

package/README.md

@@ -556,6 +556,20 @@ obol start -d
 | **Cron** | Basic node-cron | Full scheduler |
 | **Cost** | ~$9/mo | ~$9/mo+ |
 
+### Performance
+
+| | **OBOL** | **OpenClaw** (estimated) |
+|---|---|---|
+| **Cold start** | ~400ms | ~3-8s |
+| **Per-message overhead** | ~400-650ms | ~500-1100ms |
+| **Heap usage** | ~16 MB | ~80-200 MB |
+| **RSS** | ~109 MB | ~300-600 MB |
+| **node_modules** | 354 MB / 9 deps | ~1-2 GB / 50-100+ deps |
+| **Source code** | ~5,100 lines (plain JS) | Tens of thousands (TypeScript monorepo) |
+| **Native apps** | None | Swift (macOS/iOS), Kotlin (Android) |
+
+The Claude API call dominates response time at 1-5s for both — that's ~85-90% of total latency. User-perceived speed difference is ~10-20%. Where OBOL wins is cold start (10-20x), memory footprint (5-10x), and operational simplicity. On a $5/mo VPS, that matters.
+
 Different tools, different philosophies. Pick what fits.
 
 ## License

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "obol-ai",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Self-evolving AI assistant that learns, remembers, and acts on its own. Persistent vector memory, self-rewriting personality, proactive heartbeats.",
   "main": "src/index.js",
   "bin": {

package/src/background.js

@@ -20,8 +20,9 @@ class BackgroundRunner {
    * @param {string} task - The task description
    * @param {object} ctx - Telegram context (for sending updates)
    * @param {object} memory - Memory instance
+   * @param {object} parentContext - Parent context for verbose forwarding
    */
-  spawn(claude, task, ctx, memory) {
+  spawn(claude, task, ctx, memory, parentContext) {
     let running = 0;
     for (const t of this.tasks.values()) {
       if (t.status === 'running') running++;
@@ -42,6 +43,9 @@ class BackgroundRunner {
 
     this.tasks.set(taskId, taskState);
 
+    const verbose = parentContext?.verbose || false;
+    const verboseNotify = parentContext?._verboseNotify;
+
     // Start check-in timer before running task to avoid leak if task throws immediately
     taskState.checkInTimer = setInterval(async () => {
       if (taskState.status !== 'running') {
@@ -55,13 +59,13 @@ class BackgroundRunner {
     }, CHECK_IN_INTERVAL);
 
     // Run the task
-    const promise = this._runTask(claude, task, taskState, ctx, memory);
+    const promise = this._runTask(claude, task, taskState, ctx, memory, verbose, verboseNotify);
     taskState.promise = promise;
 
     return taskId;
   }
 
-  async _runTask(claude, task, taskState, ctx, memory) {
+  async _runTask(claude, task, taskState, ctx, memory, verbose, verboseNotify) {
     try {
       // Give the background task a system instruction to report progress
       const bgPrompt = `You are working on a background task. Do the work thoroughly.
@@ -73,9 +77,12 @@ This helps track what you're doing. Complete the full task, then give the final
 
 TASK: ${task}`;
 
+      const bgNotify = verboseNotify ? (msg) => verboseNotify(`[bg#${taskState.id}] ${msg}`) : undefined;
       const result = await claude.chat(bgPrompt, {
         chatId: `bg-${taskState.id}`,
         userName: 'BackgroundTask',
+        verbose,
+        _verboseNotify: bgNotify,
       });
 
       taskState.status = 'done';

package/src/claude.js

@@ -15,18 +15,8 @@ const BLOCKED_EXEC_PATTERNS = [
   /\bmkfs\b/, /\bdd\s+if=/, /\b:()\{\s*:|:&\s*\};:/,
   /\bchmod\s+(-R\s+)?[0-7]*\s+\/[^t]/,
   />\s*\/etc\//, />\s*\/boot\//,
-  /\beval\s+/, /\bsource\s+/,
-  /\bbash\s+-c\b/, /\bsh\s+-c\b/, /\bzsh\s+-c\b/,
-  /`[^`]*`/,
-  /\$\([^)]*\)/,
-  /\bpython[23]?\s+-c\b/, /\bperl\s+-e\b/, /\bruby\s+-e\b/, /\bnode\s+-e\b/,
   /\bcurl\b.*\|\s*(ba)?sh/, /\bwget\b.*\|\s*(ba)?sh/,
-  /\benv\b.*\b(sh|bash|zsh)\b/,
-  /\bfind\b.*-exec\b/,
-  /\bprintf\b.*\|\s*(ba)?sh/,
-  /\\x[0-9a-fA-F]{2}/, /\\[0-7]{3}/,
   /\bnc\s+-e\b/, /\bncat\b.*-e\b/,
-  /\bmkfifo\b/,
   />\s*\/dev\/sd/,
 ];
 
@@ -237,7 +227,11 @@ function createClaude(anthropicConfig, { personality, memory, userDir = OBOL_DIR
 
     const verbose = context.verbose || false;
     if (verbose) context.verboseLog = [];
-    const vlog = (msg) => { if (verbose) context.verboseLog.push(msg); };
+    const vlog = (msg) => {
+      if (!verbose) return;
+      context.verboseLog.push(msg);
+      context._verboseNotify?.(msg);
+    };
 
     let memoryContext = '';
     if (memory) {
@@ -255,7 +249,7 @@ Reply with ONLY a JSON object:
 
 Memory: casual messages (greetings, jokes, simple questions) → false. References to past, people, projects, preferences → true with optimized search query.
 
-Model: Use "haiku" for: casual chat, greetings, simple factual questions, short replies, trivial tasks. Use "sonnet" for most things (general questions, quick tasks, single-step work, moderate reasoning). Use "opus" ONLY for: complex multi-step research, architecture/design decisions, long-form writing, deep analysis, debugging complex code, tasks requiring exceptional reasoning.`,
+Model: Default to "sonnet". Use "haiku" for: greetings, brief acknowledgments (thanks/ok/bye), casual chitchat, simple factual questions with short answers, quick yes/no questions, and short single-turn exchanges that don't need deep reasoning. Use "sonnet" for: code generation, data analysis, content creation, explanations, creative writing, agentic tool use, general questions, opinions, advice, and most conversational exchanges with substance. Use "opus" for: professional software engineering tasks, advanced multi-step agent work, complex reasoning, scientific or mathematical problems, tasks requiring nuanced understanding, advanced coding challenges, in-depth research, and architecture or design decisions.`,
           messages: [{ role: 'user', content: userMessage }],
         });
 
@@ -1017,7 +1011,7 @@ async function executeToolCall(toolUse, memory, context = {}) {
         const { bg, ctx: telegramCtx, claude: claudeInstance } = context;
         if (!bg || !telegramCtx) return 'Background tasks not available in this context.';
         if (!claudeInstance) return 'Background tasks not available.';
-        const taskId = bg.spawn(claudeInstance, input.task, telegramCtx, memory);
+        const taskId = bg.spawn(claudeInstance, input.task, telegramCtx, memory, context);
         if (taskId === null) return 'Too many background tasks running. Wait for one to finish.';
         return `Background task #${taskId} spawned. It will send progress updates and the final result to the chat.`;
       }

package/src/index.js

@@ -1,7 +1,7 @@
 const fs = require('fs');
 const path = require('path');
 const { loadConfig, OBOL_DIR } = require('./config');
-const { createBot } = require('./telegram');
+const { createBot, checkUpgradeNotify } = require('./telegram');
 const { setupBackup } = require('./backup');
 const { setupHeartbeat } = require('./heartbeat');
 const { migrateToMultiTenant } = require('./legacy-migrate');
@@ -43,6 +43,8 @@ async function main() {
 
   const bot = createBot(config.telegram, config);
 
+  checkUpgradeNotify(bot).catch(() => {});
+
   if (config.heartbeat !== false) {
     setupHeartbeat();
   }

package/src/messages.js

@@ -70,7 +70,7 @@ class MessageLog {
 
       const { tickExchange } = require('./evolve');
       tickExchange(this.userDir).then(result => {
-        if (result?.ready) this._evolutionReady = true;
+        if (result?.ready && !this._evolutionReady && !this._evolutionPending) this._evolutionReady = true;
       }).catch(() => {});
     }
   }

package/src/telegram.js

@@ -1,4 +1,5 @@
 const path = require('path');
+const { execSync } = require('child_process');
 const { Bot, GrammyError, HttpError, InlineKeyboard } = require('grammy');
 const { loadConfig } = require('./config');
 const { evolve, loadEvolutionState } = require('./evolve');
@@ -7,10 +8,14 @@ const { loadTraits, saveTraits, DEFAULT_TRAITS } = require('./personality');
 const media = require('./media');
 const credentials = require('./credentials');
 const { getMaxToolIterations, setMaxToolIterations } = require('./claude');
+const pkg = require('../package.json');
 
 const RATE_LIMIT_MS = 3000;
 const SPAM_THRESHOLD = 5;
 const SPAM_COOLDOWN_MS = 30000;
+const EVOLUTION_IDLE_MS = 15 * 60 * 1000;
+
+const _evolutionTimers = new Map();
 
 function startTyping(ctx) {
   ctx.replyWithChatAction('typing').catch(() => {});
@@ -79,6 +84,7 @@ function createBot(telegramConfig, config) {
     { command: 'evolution', description: 'Evolution progress' },
     { command: 'verbose', description: 'Toggle verbose mode on/off' },
     { command: 'toolimit', description: 'View or set max tool iterations per message' },
+    { command: 'upgrade', description: 'Check for updates and upgrade' },
     { command: 'help', description: 'Show available commands' },
   ]).catch(() => {});
 
@@ -374,6 +380,7 @@ Your message is deleted immediately when using /secret set to keep credentials o
 /clean — Audit workspace
 /verbose — Toggle verbose mode on/off
 /toolimit — View or set max tool iterations
+/upgrade — Check for updates and upgrade
 /help — This message`);
   });
 
@@ -384,6 +391,34 @@ Your message is deleted immediately when using /secret set to keep credentials o
     await ctx.reply(tenant.verbose ? '🔍 Verbose mode ON' : '🔇 Verbose mode OFF');
   });
 
+  bot.command('upgrade', async (ctx) => {
+    const current = pkg.version;
+    let latest;
+    try {
+      latest = execSync(`npm view ${pkg.name} version`, { encoding: 'utf-8' }).trim();
+    } catch {
+      await ctx.reply('Could not reach npm registry');
+      return;
+    }
+
+    if (current === latest) {
+      await ctx.reply(`Already on latest (${current})`);
+      return;
+    }
+
+    await ctx.reply(`Upgrading ${current} → ${latest}, back in a moment...`);
+
+    try {
+      execSync(`npm install -g ${pkg.name}@latest`, { encoding: 'utf-8', timeout: 120000 });
+      const { OBOL_DIR } = require('./config');
+      const notifyPath = path.join(OBOL_DIR, '.upgrade-notify.json');
+      fs.writeFileSync(notifyPath, JSON.stringify({ chatId: ctx.chat.id, version: latest }));
+      execSync('pm2 restart obol', { encoding: 'utf-8', timeout: 15000 });
+    } catch (e) {
+      await ctx.reply(`Upgrade failed: ${e.message.substring(0, 200)}`);
+    }
+  });
+
   bot.command('toolimit', async (ctx) => {
     if (!ctx.from) return;
     const args = ctx.message.text.split(' ').slice(1);
@@ -450,6 +485,12 @@ Your message is deleted immediately when using /secret set to keep credentials o
 
     const tenant = await getTenant(userId, config);
 
+    if (_evolutionTimers.has(userId)) {
+      clearTimeout(_evolutionTimers.get(userId));
+      _evolutionTimers.delete(userId);
+      if (tenant.messageLog) tenant.messageLog._evolutionPending = false;
+    }
+
     const stopTyping = startTyping(ctx);
 
     try {
@@ -464,6 +505,10 @@ Your message is deleted immediately when using /secret set to keep credentials o
         claude: tenant.claude,
         config,
         verbose: tenant.verbose,
+        _verboseNotify: tenant.verbose ? (msg) => {
+          const safe = msg.replace(/`/g, "'");
+          ctx.reply(`\`${safe}\``, { parse_mode: 'Markdown' }).catch(() => {});
+        } : undefined,
         telegramAsk: (message, options, timeout) => createAsk(ctx, message, options, timeout),
         _notifyFn: (targetUserId, message) => {
           if (!allowedUsers.has(targetUserId)) throw new Error('Cannot notify user outside allowed list');
@@ -474,16 +519,12 @@ Your message is deleted immediately when using /secret set to keep credentials o
 
       tenant.messageLog?.log(ctx.chat.id, 'assistant', response);
 
-      if (tenant.verbose && chatContext.verboseLog?.length) {
-        const verboseText = '```\n' + chatContext.verboseLog.join('\n') + '\n```';
-        await ctx.reply(verboseText, { parse_mode: 'Markdown' }).catch(() =>
-          ctx.reply(verboseText).catch(() => {})
-        );
-      }
 
-      if (tenant.messageLog?._evolutionReady) {
+      if (tenant.messageLog?._evolutionReady && !_evolutionTimers.has(userId)) {
         tenant.messageLog._evolutionReady = false;
-        setImmediate(async () => {
+        tenant.messageLog._evolutionPending = true;
+        const timer = setTimeout(async () => {
+          _evolutionTimers.delete(userId);
           try {
             const result = await evolve(tenant.claude.client, tenant.messageLog, tenant.memory, tenant.userDir);
             tenant.claude.reloadPersonality?.();
@@ -523,8 +564,11 @@ Your message is deleted immediately when using /secret set to keep credentials o
             );
           } catch (e) {
             console.error('Evolution failed:', e.message);
+          } finally {
+            tenant.messageLog._evolutionPending = false;
           }
-        });
+        }, EVOLUTION_IDLE_MS);
+        _evolutionTimers.set(userId, timer);
       }
 
       stopTyping();
@@ -607,6 +651,10 @@ Your message is deleted immediately when using /secret set to keep credentials o
           claude: tenant.claude,
           config,
           verbose: tenant.verbose,
+          _verboseNotify: tenant.verbose ? (msg) => {
+            const safe = msg.replace(/`/g, "'");
+            ctx.reply(`\`${safe}\``, { parse_mode: 'Markdown' }).catch(() => {});
+          } : undefined,
           images: [imageBlock],
           _notifyFn: (targetUserId, message) => {
             if (!allowedUsers.has(targetUserId)) throw new Error('Cannot notify user outside allowed list');
@@ -618,11 +666,6 @@ Your message is deleted immediately when using /secret set to keep credentials o
         tenant.messageLog?.log(ctx.chat.id, 'user', `[${fileInfo.mediaType}] ${caption || filename}`);
         tenant.messageLog?.log(ctx.chat.id, 'assistant', response);
 
-        if (tenant.verbose && mediaChatCtx.verboseLog?.length) {
-          const verboseText = '```\n' + mediaChatCtx.verboseLog.join('\n') + '\n```';
-          await ctx.reply(verboseText, { parse_mode: 'Markdown' }).catch(() => ctx.reply(verboseText).catch(() => {}));
-        }
-
         stopTyping();
         if (response.length > 4096) {
           for (const chunk of splitMessage(response, 4096)) {
@@ -642,6 +685,10 @@ Your message is deleted immediately when using /secret set to keep credentials o
           claude: tenant.claude,
           config,
           verbose: tenant.verbose,
+          _verboseNotify: tenant.verbose ? (msg) => {
+            const safe = msg.replace(/`/g, "'");
+            ctx.reply(`\`${safe}\``, { parse_mode: 'Markdown' }).catch(() => {});
+          } : undefined,
           _notifyFn: (targetUserId, message) => {
             if (!allowedUsers.has(targetUserId)) throw new Error('Cannot notify user outside allowed list');
             return bot.api.sendMessage(targetUserId, message);
@@ -652,11 +699,6 @@ Your message is deleted immediately when using /secret set to keep credentials o
         tenant.messageLog?.log(ctx.chat.id, 'user', contextMsg);
         tenant.messageLog?.log(ctx.chat.id, 'assistant', response);
 
-        if (tenant.verbose && mediaCaptionCtx.verboseLog?.length) {
-          const verboseText = '```\n' + mediaCaptionCtx.verboseLog.join('\n') + '\n```';
-          await ctx.reply(verboseText, { parse_mode: 'Markdown' }).catch(() => ctx.reply(verboseText).catch(() => {}));
-        }
-
         stopTyping();
         if (response.length > 4096) {
           for (const chunk of splitMessage(response, 4096)) {
@@ -778,4 +820,15 @@ function splitMessage(text, maxLength) {
   return chunks;
 }
 
-module.exports = { createBot };
+async function checkUpgradeNotify(bot) {
+  const { OBOL_DIR } = require('./config');
+  const notifyPath = path.join(OBOL_DIR, '.upgrade-notify.json');
+  if (!fs.existsSync(notifyPath)) return;
+  try {
+    const { chatId, version } = JSON.parse(fs.readFileSync(notifyPath, 'utf-8'));
+    fs.unlinkSync(notifyPath);
+    await bot.api.sendMessage(chatId, `🪙 Upgraded to ${version}`);
+  } catch {}
+}
+
+module.exports = { createBot, checkUpgradeNotify };