obol-ai 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## 0.3.2
+- update changelog
+- add list_pending_events tool to dispatch and humor passes to prevent duplicates
+
+## 0.3.1
+- update changelog
+- add curiosity humor pass with puns, inside jokes, and link support
+
 ## 0.3.0
 - add tests for memory-self and analysis helpers
 - fix proactivity and memory bugs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "obol-ai",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "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/curiosity-dispatch.js

@@ -36,6 +36,17 @@ async function runCuriosityDispatch(client, selfMemory, users) {
         required: ['user_id'],
       },
     },
+    {
+      name: 'list_pending_events',
+      description: 'List already-scheduled pending events for a user — check this before scheduling to avoid duplicates',
+      input_schema: {
+        type: 'object',
+        properties: {
+          user_id: { type: 'string', description: 'The user ID to list events for' },
+        },
+        required: ['user_id'],
+      },
+    },
     {
       name: 'schedule_insight',
       description: 'Schedule a curiosity insight to be shared with a user at a future time',
@@ -112,6 +123,15 @@ async function handleTool(name, input, selfMemory, userMap) {
     return parts.length ? parts.join('\n\n') : 'No context available';
   }
 
+  if (name === 'list_pending_events') {
+    const user = userMap.get(String(input.user_id));
+    if (!user) return 'User not found';
+    if (!user.scheduler) return 'No scheduler';
+    const events = await user.scheduler.list({ status: 'pending', limit: 20 });
+    if (!events.length) return 'No pending events';
+    return events.map(e => `[${e.due_at}] ${e.title}${e.description ? `: ${e.description}` : ''}`).join('\n');
+  }
+
   if (name === 'schedule_insight') {
     const user = userMap.get(String(input.user_id));
     if (!user) return 'User not found';

package/src/curiosity-humor.js

@@ -0,0 +1,157 @@
+const HUMOR_MODEL = 'claude-sonnet-4-6';
+const MAX_ITERATIONS = 8;
+const SHAREABLE_CATEGORIES = new Set(['research', 'interest', 'self']);
+
+function resolveDelay(delay) {
+  const units = { h: 3600000, d: 86400000, w: 604800000 };
+  const match = delay.match(/^(\d+)([hdw])$/);
+  if (!match) return new Date(Date.now() + 86400000).toISOString();
+  return new Date(Date.now() + parseInt(match[1]) * units[match[2]]).toISOString();
+}
+
+async function runCuriosityHumor(client, selfMemory, users) {
+  if (!users.length) return;
+
+  const userMap = new Map(users.map(u => [String(u.userId), u]));
+
+  const tools = [
+    { type: 'web_search_20250305', name: 'web_search' },
+    {
+      name: 'list_curiosity_findings',
+      description: 'List recent findings from your curiosity cycle — things you researched, interests you developed, or reflections you had',
+      input_schema: {
+        type: 'object',
+        properties: {
+          limit: { type: 'number', description: 'Max number of findings to return (default 20)' },
+        },
+      },
+    },
+    {
+      name: 'get_user_context',
+      description: 'Get behavioral patterns and profile for a specific user — needed to craft inside jokes',
+      input_schema: {
+        type: 'object',
+        properties: {
+          user_id: { type: 'string', description: 'The user ID to get context for' },
+        },
+        required: ['user_id'],
+      },
+    },
+    {
+      name: 'list_pending_events',
+      description: 'List already-scheduled pending events for a user — check this before scheduling to avoid duplicates',
+      input_schema: {
+        type: 'object',
+        properties: {
+          user_id: { type: 'string', description: 'The user ID to list events for' },
+        },
+        required: ['user_id'],
+      },
+    },
+    {
+      name: 'schedule_humor',
+      description: 'Schedule a humorous moment to be delivered to a user at a future time',
+      input_schema: {
+        type: 'object',
+        properties: {
+          user_id: { type: 'string', description: 'The user ID to share with' },
+          hint: { type: 'string', description: 'The pun, funny connection, or inside joke — just the content itself. Can include a URL if a news article or link is part of what makes it funny.' },
+          delay: { type: 'string', description: 'When to drop it — e.g. "2h", "1d", "3d", "1w"' },
+        },
+        required: ['user_id', 'hint', 'delay'],
+      },
+    },
+  ];
+
+  const userList = users.map(u => `- user_id: ${u.userId}`).join('\n');
+  const system = `You just finished a curiosity cycle. Now look at what you found and see if anything is funny — a pun you can make, a weird connection, something that'd land as an inside joke with a specific person based on who they are and what you know about them.\n\nUsers:\n${userList}\n\nBe picky. Only schedule something if it's actually clever. Forced humor is worse than none.`;
+
+  const messages = [{ role: 'user', content: 'Take a look at what you found and see if anything is worth a laugh.' }];
+
+  for (let i = 0; i < MAX_ITERATIONS; i++) {
+    const response = await client.messages.create({
+      model: HUMOR_MODEL,
+      max_tokens: 2000,
+      tools,
+      system,
+      messages,
+    });
+
+    messages.push({ role: 'assistant', content: response.content });
+
+    if (response.stop_reason === 'end_turn') break;
+    if (response.stop_reason !== 'tool_use') break;
+
+    const toolResults = [];
+
+    for (const block of response.content) {
+      if (block.type !== 'tool_use') continue;
+
+      try {
+        const result = await handleTool(block.name, block.input, selfMemory, userMap);
+        toolResults.push({ type: 'tool_result', tool_use_id: block.id, content: result });
+      } catch (e) {
+        toolResults.push({ type: 'tool_result', tool_use_id: block.id, content: `Error: ${e.message}` });
+      }
+    }
+
+    if (toolResults.length > 0) {
+      messages.push({ role: 'user', content: toolResults });
+    }
+  }
+
+  console.log('[curiosity-humor] Humor pass complete');
+}
+
+async function handleTool(name, input, selfMemory, userMap) {
+  if (name === 'list_curiosity_findings') {
+    const limit = input.limit || 20;
+    const findings = await selfMemory.recent({ limit });
+    const shareable = findings.filter(f => SHAREABLE_CATEGORIES.has(f.category));
+    if (!shareable.length) return 'No findings yet';
+    return shareable.map(f => `[${f.category}] ${f.content}`).join('\n');
+  }
+
+  if (name === 'get_user_context') {
+    const user = userMap.get(String(input.user_id));
+    if (!user) return 'User not found';
+    const parts = [];
+    if (user.userProfile) parts.push(`User profile:\n${user.userProfile}`);
+    if (user.patterns) parts.push(`Patterns:\n${user.patterns}`);
+    if (user.events?.length) {
+      parts.push(`Upcoming events:\n${user.events.map(e => `- ${e.title}${e.description ? `: ${e.description}` : ''}`).join('\n')}`);
+    }
+    return parts.length ? parts.join('\n\n') : 'No context available';
+  }
+
+  if (name === 'list_pending_events') {
+    const user = userMap.get(String(input.user_id));
+    if (!user) return 'User not found';
+    if (!user.scheduler) return 'No scheduler';
+    const events = await user.scheduler.list({ status: 'pending', limit: 20 });
+    if (!events.length) return 'No pending events';
+    return events.map(e => `[${e.due_at}] ${e.title}${e.description ? `: ${e.description}` : ''}`).join('\n');
+  }
+
+  if (name === 'schedule_humor') {
+    const user = userMap.get(String(input.user_id));
+    if (!user) return 'User not found';
+    if (!user.scheduler) return 'User has no scheduler';
+
+    const dueAt = resolveDelay(input.delay);
+    const instructions = `You spotted something funny during your own explorations: "${input.hint}". If the moment is right, drop it casually — a pun you just thought of, a funny connection, an inside reference. Don't explain it. Don't say it's a joke. Just let it land.`;
+
+    try {
+      await user.scheduler.add(user.chatId, 'Curiosity humor', dueAt, user.timezone, input.hint, null, null, null, instructions);
+      console.log(`[curiosity-humor] Scheduled humor for user ${input.user_id} at ${dueAt}`);
+      return 'Scheduled';
+    } catch (e) {
+      console.error(`[curiosity-humor] Failed to schedule humor for user ${input.user_id}:`, e.message);
+      return `Failed to schedule: ${e.message}`;
+    }
+  }
+
+  return 'Unknown tool';
+}
+
+module.exports = { runCuriosityHumor, resolveDelay, handleTool };

package/src/heartbeat.js

@@ -6,6 +6,7 @@ const { ensureUserDir } = require('./config');
 const { runAnalysis } = require('./analysis');
 const { runCuriosity } = require('./curiosity');
 const { runCuriosityDispatch } = require('./curiosity-dispatch');
+const { runCuriosityHumor } = require('./curiosity-humor');
 const { createSelfMemory } = require('./memory-self');
 
 
@@ -127,6 +128,7 @@ async function runCuriosityOnce(config, allowedUsers) {
       } catch { return null; }
     }));
     await runCuriosityDispatch(client, selfMemory, userDispatchData.filter(Boolean));
+    await runCuriosityHumor(client, selfMemory, userDispatchData.filter(Boolean));
   } catch (e) {
     console.error('[curiosity] Failed:', e.message);
   } finally {