obol-ai 0.2.5 → 0.2.7

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "obol-ai",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "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": {
@@ -22,7 +22,7 @@
   "author": "Jo Vinkenroye <jestersimpps@gmail.com>",
   "license": "MIT",
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.39.0",
+    "@anthropic-ai/sdk": "^0.78.0",
     "@supabase/supabase-js": "^2.49.1",
     "@xenova/transformers": "^2.17.2",
     "commander": "^13.1.0",

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 }],
         });
 
@@ -342,81 +336,47 @@ Model: Use "haiku" for: casual chat, greetings, simple factual questions, short
     const model = context._model || 'claude-sonnet-4-6';
     vlog(`[model] ${model} | history=${history.length} msgs`);
     const systemPrompt = baseSystemPrompt + `\nCurrent time: ${new Date().toISOString()}`;
-    let response = await client.messages.create({
+    const runnableTools = buildRunnableTools(tools, memory, context, vlog);
+
+    const runner = client.beta.messages.toolRunner({
       model,
       max_tokens: 4096,
       system: systemPrompt,
-      messages: history,
-      tools: tools.length > 0 ? tools : undefined,
+      messages: [...history],
+      tools: runnableTools.length > 0 ? runnableTools : undefined,
+      max_iterations: MAX_TOOL_ITERATIONS,
     });
 
-    let toolIterations = 0;
-    while (response.stop_reason === 'tool_use') {
-      toolIterations++;
-      if (toolIterations > MAX_TOOL_ITERATIONS) {
-        const bailoutContent = response.content;
-        history.push({ role: 'assistant', content: bailoutContent });
-        const bailoutResults = bailoutContent
-          .filter(b => b.type === 'tool_use')
-          .map(b => ({ type: 'tool_result', tool_use_id: b.id, content: '[max tool iterations reached]' }));
-        history.push({ role: 'user', content: [
-          ...bailoutResults,
-          { type: 'text', text: 'You have used too many tool calls. Please provide a final response now based on what you have so far.' },
-        ] });
-        response = await client.messages.create({
-          model,
-          max_tokens: 4096,
-          system: systemPrompt,
-          messages: history,
-        });
-        break;
-      }
-
-      const assistantContent = response.content;
-      history.push({ role: 'assistant', content: assistantContent });
-
-      const toolResults = [];
-      for (const block of assistantContent) {
-        if (block.type === 'tool_use') {
-          const inputSummary = block.name === 'exec' ? block.input.command :
-            block.name === 'write_file' ? block.input.path :
-            block.name === 'read_file' ? block.input.path :
-            block.name === 'memory_search' ? block.input.query :
-            block.name === 'memory_add' ? `[${block.input.category || 'fact'}]` :
-            block.name === 'web_fetch' ? block.input.url :
-            block.name === 'background_task' ? block.input.task?.substring(0, 60) :
-            JSON.stringify(block.input).substring(0, 80);
-          vlog(`[tool] ${block.name}: ${inputSummary}`);
-          const result = await executeToolCall(block, memory, context);
-          toolResults.push({
-            type: 'tool_result',
-            tool_use_id: block.id,
-            content: result,
-          });
-        }
+    let finalMessage;
+    for await (const message of runner) {
+      finalMessage = message;
+      if (message.usage) {
+        vlog(`[tokens] in=${message.usage.input_tokens} out=${message.usage.output_tokens}`);
       }
-
-      history.push({ role: 'user', content: toolResults });
-
-      response = await client.messages.create({
-        model,
-        max_tokens: 4096,
-        system: systemPrompt,
-        messages: history,
-        tools,
-      });
     }
 
-    const textBlocks = response.content.filter(b => b.type === 'text');
-    const replyText = textBlocks.map(b => b.text).join('\n');
-
-    if (response.usage) {
-      vlog(`[tokens] in=${response.usage.input_tokens} out=${response.usage.output_tokens}`);
+    const runnerMessages = runner.params.messages;
+    const newMessages = runnerMessages.slice(history.length);
+    for (const msg of newMessages) {
+      history.push(msg);
     }
 
-    history.push({ role: 'assistant', content: response.content });
+    if (finalMessage.stop_reason === 'tool_use') {
+      const bailoutResults = finalMessage.content
+        .filter(b => b.type === 'tool_use')
+        .map(b => ({ type: 'tool_result', tool_use_id: b.id, content: '[max tool iterations reached]' }));
+      history.push({ role: 'user', content: [
+        ...bailoutResults,
+        { type: 'text', text: 'You have used too many tool calls. Please provide a final response now based on what you have so far.' },
+      ] });
+      const bailoutResponse = await client.messages.create({
+        model, max_tokens: 4096, system: systemPrompt, messages: history,
+      });
+      history.push({ role: 'assistant', content: bailoutResponse.content });
+      return bailoutResponse.content.filter(b => b.type === 'text').map(b => b.text).join('\n');
+    }
 
-    return replyText;
+    return finalMessage.content.filter(b => b.type === 'text').map(b => b.text).join('\n');
 
     } catch (e) {
       if (e.status === 400 && e.message?.includes('tool_use')) {
@@ -908,6 +868,24 @@ function buildTools(memory, opts = {}) {
   return tools;
 }
 
+function buildRunnableTools(tools, memory, context, vlog) {
+  return tools.map(tool => ({
+    ...tool,
+    run: async (input) => {
+      const inputSummary = tool.name === 'exec' ? input.command :
+        tool.name === 'write_file' ? input.path :
+        tool.name === 'read_file' ? input.path :
+        tool.name === 'memory_search' ? input.query :
+        tool.name === 'memory_add' ? `[${input.category || 'fact'}]` :
+        tool.name === 'web_fetch' ? input.url :
+        tool.name === 'background_task' ? input.task?.substring(0, 60) :
+        JSON.stringify(input).substring(0, 80);
+      vlog(`[tool] ${tool.name}: ${inputSummary}`);
+      return await executeToolCall({ name: tool.name, input }, memory, context);
+    },
+  }));
+}
+
 function resolveUserPath(inputPath, userDir) {
   if (!userDir) throw new Error('userDir is required for path resolution');
   const resolved = path.isAbsolute(inputPath)
@@ -1017,7 +995,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/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

@@ -13,6 +13,9 @@ 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(() => {});
@@ -482,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 {
@@ -496,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');
@@ -506,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?.();
@@ -555,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();
@@ -639,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');
@@ -650,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)) {
@@ -674,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);
@@ -684,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)) {