obol-ai 0.3.35 → 0.3.37

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## 0.3.37
+- changelog
+- fix media group race condition — buffer before download
+
+## 0.3.36
+- save media assets instantly in date-based folders
+- fix agentic event raw JSON output and update_event wiping instructions
+
 ## 0.3.35
 - add order param to memory, self-memory, and events queries
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "obol-ai",
-  "version": "0.3.35",
+  "version": "0.3.37",
   "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/claude/tools/scheduler.js

@@ -59,7 +59,8 @@ Always search memory first for the user's timezone/location.`,
         event_id: { type: 'string', description: 'UUID of the event to update' },
         title: { type: 'string' },
         description: { type: 'string' },
-        instructions: { type: 'string', description: 'LLM instructions to execute when the event fires. Set to empty string to clear.' },
+        instructions: { type: 'string', description: 'New LLM instructions to execute when the event fires. Only provide if the user wants to change them.' },
+        clear_instructions: { type: 'boolean', description: 'Set to true to remove instructions and convert an agentic event to a plain reminder.' },
         timezone: { type: 'string' },
         cron_expr: { type: 'string' },
         max_runs: { type: 'number' },
@@ -146,7 +147,8 @@ const handlers = {
     const fields = {};
     if (rest.title !== undefined) fields.title = rest.title;
     if (rest.description !== undefined) fields.description = rest.description;
-    if (typeof rest.instructions === 'string') fields.instructions = rest.instructions || null;
+    if (rest.clear_instructions === true) fields.instructions = null;
+    else if (typeof rest.instructions === 'string' && rest.instructions.length > 0) fields.instructions = rest.instructions;
     if (rest.timezone !== undefined) fields.timezone = rest.timezone;
     if (rest.cron_expr !== undefined) fields.cron_expr = rest.cron_expr;
     if (rest.max_runs !== undefined) fields.max_runs = rest.max_runs;

package/src/runtime/heartbeat.js

@@ -363,6 +363,10 @@ async function runAgenticEvent(bot, config, event) {
   if (tenant.personality?.soul) systemParts.push(tenant.personality.soul);
   if (tenant.personality?.user) systemParts.push(`About this user:\n${tenant.personality.user}`);
   if (context) systemParts.push(`Current context:\n${context}`);
+  systemParts.push(
+    'You are executing a scheduled task. Respond ONLY with a clean, natural-language message for the user. ' +
+    'Do NOT output JSON, code blocks, tool calls, or structured data. Write as a direct Telegram message.'
+  );
 
   const response = await tenant.claude.client.messages.create({
     model: 'claude-sonnet-4-6',

package/src/telegram/constants.js

@@ -9,7 +9,7 @@ const TEXT_BUFFER_GAP_MS = 1500;
 const TEXT_BUFFER_MAX_PARTS = 12;
 const TEXT_BUFFER_MAX_CHARS = 50000;
 const TEXT_BUFFER_THRESHOLD = 4000;
-const MEDIA_GROUP_DELAY_MS = 500;
+const MEDIA_GROUP_DELAY_MS = 5000;
 const MAX_MEDIA_SIZE = 50 * 1024 * 1024;
 const TERM_SEP = '━'.repeat(TERM_WIDTH);
 

package/src/telegram/handlers/media.js

@@ -1,5 +1,6 @@
 const path = require('path');
 const { getTenant } = require('../../tenant');
+const { ensureUserDir, getUserTimezone } = require('../../config');
 const { buildStatusHtml, formatToolCall, formatTokenStats } = require('../../status');
 const media = require('../../media');
 const { sendHtml, startTyping, splitMessage } = require('../utils');
@@ -15,6 +16,29 @@ async function downloadMediaItem(ctx, fileInfo, telegramToken) {
   return { buffer, filename, fileInfo, caption: ctx.message.caption || '' };
 }
 
+async function downloadAndProcess(ctx, entries, deps, token) {
+  const userId = ctx.from.id;
+  const userDir = ensureUserDir(userId);
+  const tz = getUserTimezone(deps.config, userId);
+  const today = new Date().toLocaleDateString('en-CA', { timeZone: tz });
+  const assetsDir = path.join(userDir, 'assets', today);
+
+  const items = (await Promise.all(
+    entries.map(({ ctx: entryCtx, fileInfo }) =>
+      downloadMediaItem(entryCtx, fileInfo, token).then(item => {
+        if (item) item.savedPath = media.saveFile(item.buffer, assetsDir, item.filename);
+        return item;
+      }).catch(e => {
+        console.error('Media download error:', e.message);
+        return null;
+      })
+    )
+  )).filter(Boolean);
+
+  if (items.length === 0) return;
+  await processMediaItems(ctx, items, deps);
+}
+
 async function processMediaItems(ctx, items, { config, allowedUsers, bot, createAsk }) {
   if (!ctx.from) return;
   const userId = ctx.from.id;
@@ -23,13 +47,12 @@ async function processMediaItems(ctx, items, { config, allowedUsers, bot, create
 
   try {
     const tenant = await getTenant(userId, config);
-    const assetsDir = path.join(tenant.userDir, 'assets');
     const imageBlocks = [];
     const nonImageParts = [];
     const caption = items.map(i => i.caption).filter(Boolean).join('\n') || '';
 
     for (const item of items) {
-      const savedPath = media.saveFile(item.buffer, assetsDir, item.filename);
+      const savedPath = item.savedPath;
 
       if (tenant.memory && !media.isImage(item.fileInfo)) {
         const memContent = media.buildMemoryContent(item.fileInfo, item.filename, savedPath, item.caption);
@@ -57,6 +80,9 @@ async function processMediaItems(ctx, items, { config, allowedUsers, bot, create
       }
     }
 
+    const fileList = items.map(i => `- ${i.savedPath}`).join('\n');
+    const fileRef = `Files saved:\n${fileList}`;
+
     let prompt, chatImages;
     if (imageBlocks.length > 0) {
       prompt = caption || `The user sent ${imageBlocks.length} image(s). Describe what you see and respond naturally.`;
@@ -65,6 +91,7 @@ async function processMediaItems(ctx, items, { config, allowedUsers, bot, create
     } else {
       prompt = nonImageParts.join('\n');
     }
+    prompt = fileRef + '\n\n' + prompt;
 
     const mediaChatCtx = createChatContext(ctx, tenant, config, { allowedUsers, bot, createAsk });
     if (chatImages) mediaChatCtx.images = chatImages;
@@ -150,32 +177,26 @@ function registerMediaHandler(bot, telegramConfig, deps) {
       return;
     }
 
-    const item = await downloadMediaItem(ctx, fileInfo, telegramConfig.token).catch(e => {
-      console.error('Media download error:', e.message);
-      return null;
-    });
-    if (!item) return;
-
     const groupId = ctx.message.media_group_id;
     if (groupId) {
       const existing = mediaGroups.get(groupId);
       if (existing) {
         clearTimeout(existing.timer);
-        existing.items.push(item);
-        existing.ctx = ctx;
+        existing.entries.push({ ctx, fileInfo });
+        existing.latestCtx = ctx;
         existing.timer = setTimeout(() => {
           mediaGroups.delete(groupId);
-          processMediaItems(existing.ctx, existing.items, deps).catch(e =>
+          downloadAndProcess(existing.latestCtx, existing.entries, deps, telegramConfig.token).catch(e =>
             console.error('Media group error:', e.message)
           );
         }, MEDIA_GROUP_DELAY_MS);
       } else {
         const group = {
-          items: [item],
-          ctx,
+          entries: [{ ctx, fileInfo }],
+          latestCtx: ctx,
           timer: setTimeout(() => {
             mediaGroups.delete(groupId);
-            processMediaItems(ctx, [item], deps).catch(e =>
+            downloadAndProcess(ctx, [{ ctx, fileInfo }], deps, telegramConfig.token).catch(e =>
               console.error('Media group error:', e.message)
             );
           }, MEDIA_GROUP_DELAY_MS),
@@ -185,6 +206,18 @@ function registerMediaHandler(bot, telegramConfig, deps) {
       return;
     }
 
+    const item = await downloadMediaItem(ctx, fileInfo, telegramConfig.token).catch(e => {
+      console.error('Media download error:', e.message);
+      return null;
+    });
+    if (!item) return;
+
+    const userDir = ensureUserDir(userId);
+    const tz = getUserTimezone(deps.config, userId);
+    const today = new Date().toLocaleDateString('en-CA', { timeZone: tz });
+    const assetsDir = path.join(userDir, 'assets', today);
+    item.savedPath = media.saveFile(item.buffer, assetsDir, item.filename);
+
     await processMediaItems(ctx, [item], deps);
   }