obol-ai 0.2.17 → 0.2.18

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## 0.2.18
+- remove evolution progress bar from status UI
+- bidirectional bridge with reply button + memory_remove tool
+- update background tasks section in readme
+- add status UI screenshot to readme
+- update readme with stop controls, commands, and model escalation
+
 ## 0.2.17
 - add force stop button to instantly abort mid-tool execution
 - replace web_fetch with native web_search tool

package/README.md

@@ -22,7 +22,7 @@ obol start -d   # runs as background daemon (auto-installs pm2)
 
 🧠 **Living memory** — Vector memory with semantic search. Haiku routes queries and rewrites them for better embedding hits. Free local embeddings.
 
-🤖 **Smart routing** — Haiku decides per-message: does it need memory? Sonnet or Opus? No wasted API calls
+🤖 **Smart routing** — Haiku decides per-message: does it need memory? Sonnet or Opus? Auto-escalates to Sonnet when tool use is needed. No wasted API calls
 
 💰 **Prompt caching** — Static system prompt and conversation history prefix are cached via Anthropic's prompt caching, cutting ~85% of repeated input token costs across turns
 
@@ -59,9 +59,9 @@ User message
     ↓             ↓
 Memory recall   Model selection
     ↓             ↓
-Multi-query     Sonnet (default)
-ranked recall   or Opus (complex)
-    ↓             ↓
+Multi-query     Haiku → Sonnet (auto-
+ranked recall   escalates on tool use)
+    ↓             or Opus (complex)
     └──────┬──────┘
            ↓
    Claude (tool use loop)
@@ -199,21 +199,32 @@ Month 6: evolution/ has 180+ archived souls
 
 ### Background Tasks
 
-Heavy work runs in the background. The main conversation stays responsive.
+Heavy work runs in the background with its own live status UI. The main conversation stays responsive — you can keep chatting while tasks run.
 
 ```
 You: "research the best coworking spaces in Barcelona"
-OBOL: "On it 🪙"
-
-[30s] ⏳ Found 15 spaces, filtering by reviews...
-[60s] ⏳ Narrowed to top 7, checking prices...
+OBOL: spawns BG #1 with live status
 
 You: "what time is it?"
 OBOL: "11:42 PM CET"
 
-[90s] ✅ Done! Here are the top 5 coworking spaces: ...
+✅ BG #1 done (1m 32s)
+Here are the top 5 coworking spaces: ...
 ```
 
+### Live Status & Stop Controls
+
+![Status UI](docs/obol-status.png)
+
+Every request shows a live status message with elapsed time, model routing info, and what tools are being used. Two inline buttons let you cancel:
+
+| Button | Behavior |
+|--------|----------|
+| **■ Stop** | Cancels after the current API call finishes |
+| **■ Force Stop** | Instantly aborts mid-tool — races the handler and returns immediately |
+
+The `/stop` command also works as a text alternative.
+
 ## Multi-User Architecture
 
 One Telegram bot token, one Node.js process, full per-user isolation.
@@ -275,29 +286,39 @@ Each new user starts fresh. Their bot evolves independently from every other use
 
 ### Bridge (couples / roommates / teams)
 
-When two users share the same OBOL instance, their agents can talk to each other.
+When two users share the same OBOL instance, their agents can talk to each other — bidirectionally.
 
 ```
 User A: "what does Jo want for dinner tonight?"
 Agent A: → bridge_ask → Agent B (one-shot, no tools, no history)
 Agent B: "Jo mentioned craving Thai food earlier today"
 Agent A: "Jo's been wanting Thai — maybe suggest pad see ew?"
+
+Jo gets: "🪙 Your partner's agent asked: 'what does Jo want for dinner?'
+          Your agent answered: 'Jo mentioned craving Thai food earlier today'"
 ```
 
 ```
 User A: "remind Jo I'll be home late"
 Agent A: → bridge_tell → stores in Agent B's memory + Telegram notification
-Jo gets: "🪙 Message from your partner's agent: I'll be home late"
+
+Jo gets: "🪙 Message from your partner's agent:
+          'I'll be home late'"
+          [↩ Reply]
+
+Jo taps Reply → Jo's agent reads recent bridge context, composes a reply
+             → sends back via bridge_tell
+A gets: "🪙 Message from your partner's agent: 'Got it, I'll start dinner around 7'"
 ```
 
 Two tools:
 
 | Tool | Direction | What happens |
 |------|-----------|--------------|
-| `bridge_ask` | A → B → A | Query the partner's agent. One-shot Sonnet call with partner's personality + memories. No tools, no history, no recursion risk. |
-| `bridge_tell` | A → B | Send a message to the partner. Stored in their memory (importance 0.6) + Telegram notification. Their agent picks it up as context in future conversations. |
+| `bridge_ask` | A → B → A | Query the partner's agent. One-shot Haiku call with partner's personality + memories. No tools, no history, no recursion risk. Partner is notified with both the question and your agent's answer. |
+| `bridge_tell` | A → B (↩ B → A) | Send a message to the partner. Stored in their memory (importance 0.6) + Telegram notification with a Reply button. Tapping Reply has their agent compose a contextual response and send it back — no typing needed. |
 
-The partner always gets notified when their agent is contacted. Privacy rules apply — the responding agent gives summaries, never raw data or secrets.
+The partner always gets notified when their agent is contacted. Privacy rules apply — the responding agent gives summaries, never raw data or secrets. Rate-limited to 20 bridge calls per user per hour.
 
 Enable during `obol init` (auto-prompted when 2+ users are added) or toggle later with `obol config` → Bridge.
 
@@ -471,6 +492,7 @@ Or edit `~/.obol/config.json` directly:
 /memory     — Search or view memory stats
 /recent     — Last 10 memories
 /today      — Today's memories
+/events     — Show upcoming scheduled events
 /tasks      — Running background tasks
 /status     — Bot status, uptime, evolution progress, traits
 /backup     — Trigger GitHub backup
@@ -478,6 +500,11 @@ Or edit `~/.obol/config.json` directly:
 /traits     — View or adjust personality traits (0-100)
 /secret     — Manage per-user encrypted secrets
 /evolution  — Evolution progress
+/verbose    — Toggle verbose mode on/off
+/toolimit   — View or set max tool iterations per message
+/tools      — Toggle optional tools on/off
+/stop       — Stop the current request
+/upgrade    — Check for updates and upgrade
 /help       — Show available commands
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "obol-ai",
-  "version": "0.2.17",
+  "version": "0.2.18",
   "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/bridge.js

@@ -106,7 +106,8 @@ async function bridgeAsk(question, fromUserId, config, notifyFn, targetId) {
 
   if (notifyFn) {
     try {
-      await notifyFn(partnerUserId, `🪙 Your partner's agent asked about you:\n"${question}"`);
+      const preview = answer.length > 200 ? `${answer.substring(0, 200)}…` : answer;
+      await notifyFn(partnerUserId, `🪙 Your partner's agent asked: "${question}"\nYour agent answered: "${preview}"`);
     } catch (e) {
       console.error(`[bridge] Notify failed for ${partnerUserId}:`, e.message);
     }
@@ -170,7 +171,8 @@ async function bridgeTell(message, fromUserId, config, notifyFn, targetId) {
 
   if (notifyFn) {
     try {
-      await notifyFn(partnerUserId, `🪙 Message from your partner's agent:\n"${message}"`);
+      const replyMarkup = { inline_keyboard: [[{ text: '↩ Reply', callback_data: `bridge:reply:${fromUserId}` }]] };
+      await notifyFn(partnerUserId, `🪙 Message from your partner's agent:\n"${message}"`, { reply_markup: replyMarkup });
     } catch (e) {
       console.error(`[bridge] Notify failed for ${partnerUserId}:`, e.message);
     }

package/src/telegram/commands/status.js

@@ -1,8 +1,7 @@
 const path = require('path');
 const { getTenant } = require('../../tenant');
-const { loadConfig } = require('../../config');
 const { loadTraits } = require('../../personality');
-const { evolve, loadEvolutionState } = require('../../evolve');
+const { loadEvolutionState } = require('../../evolve');
 const { getMaxToolIterations } = require('../../claude');
 const { termBar, formatTraits } = require('../utils');
 const { TERM_SEP } = require('../constants');
@@ -44,16 +43,13 @@ function register(bot, config) {
     );
 
     const evoState = loadEvolutionState(tenant.userDir);
-    const cfg = loadConfig();
-    const intervalHours = cfg?.evolution?.intervalHours ?? 24;
-    const elapsed = evoState.lastEvolution ? (Date.now() - new Date(evoState.lastEvolution).getTime()) / 3600000 : Infinity;
-    const evoPct = Math.min(100, Math.round((elapsed / intervalHours) * 100));
-    const timeLeft = Math.max(0, intervalHours - elapsed);
     lines.push(
       ``, `EVOLUTION`,
-      `  ${termBar(evoPct)} ${evoPct}%`,
-      `  ${timeLeft < 1 ? 'ready' : `${timeLeft.toFixed(1)}h remaining`} ▪ ${evoState.evolutionCount || 0} completed`,
+      `  ${evoState.evolutionCount || 0} completed`,
     );
+    if (evoState.lastEvolution) {
+      lines.push(`  last ${new Date(evoState.lastEvolution).toLocaleDateString()}`);
+    }
 
     const personalityDir = path.join(tenant.userDir, 'personality');
     const traits = loadTraits(personalityDir);
@@ -68,18 +64,11 @@ function register(bot, config) {
     if (!ctx.from) return;
     const tenant = await getTenant(ctx.from.id, config);
     const state = loadEvolutionState(tenant.userDir);
-    const cfg = loadConfig();
-    const intervalHours = cfg?.evolution?.intervalHours ?? 24;
-    const elapsed = state.lastEvolution ? (Date.now() - new Date(state.lastEvolution).getTime()) / 3600000 : Infinity;
-    const pct = Math.min(100, Math.round((elapsed / intervalHours) * 100));
-    const timeLeft = Math.max(0, intervalHours - elapsed);
 
     const lines = [
       `◈ OBOL EVOLUTION CYCLE`,
       TERM_SEP,
       ``,
-      `  ${termBar(pct)} ${pct}%`,
-      `  ${timeLeft < 1 ? 'ready' : `${timeLeft.toFixed(1)}h remaining`}`,
       `  ${state.evolutionCount || 0} completed`,
     ];
     if (state.lastEvolution) {

package/src/telegram/handlers/callbacks.js

@@ -36,6 +36,66 @@ function registerCallbackHandler(bot, { config, pendingAsks, getTenant }) {
       return;
     }
 
+    if (data.startsWith('bridge:reply:')) {
+      const targetUserId = parseInt(data.split(':')[2]);
+      const reactingUserId = ctx.from.id;
+
+      const tenant = await getTenant(reactingUserId, config);
+      if (!tenant) return answer({ text: 'Could not load your agent' });
+
+      const { checkBridgeRateLimit, bridgeTell } = require('../../bridge');
+      const rateErr = checkBridgeRateLimit(reactingUserId);
+      if (rateErr) return answer({ text: rateErr });
+
+      let memoryContext = '';
+      if (tenant.memory) {
+        try {
+          const memories = await tenant.memory.search('message from partner bridge', { limit: 5, threshold: 0.3 });
+          if (memories.length > 0) {
+            memoryContext = '\n\n[Recent bridge messages]\n' + memories.map(m => `- ${m.content}`).join('\n');
+          }
+        } catch {}
+      }
+
+      const systemParts = [
+        'Compose a brief, natural reply to send back to your partner\'s agent via bridge. 1-3 sentences. Be genuine and respond to the most recent message from them.',
+      ];
+      if (tenant.personality?.soul) systemParts.push(`\n## Your Personality\n${tenant.personality.soul}`);
+      if (tenant.personality?.user) systemParts.push(`\n## About You\n${tenant.personality.user}`);
+      if (memoryContext) systemParts.push(memoryContext);
+
+      let replyText;
+      try {
+        const response = await tenant.claude.client.messages.create({
+          model: 'claude-haiku-4-5-20251001',
+          max_tokens: 256,
+          system: systemParts.join('\n'),
+          messages: [{ role: 'user', content: 'Compose your reply to send via bridge.' }],
+        });
+        replyText = response.content.filter(b => b.type === 'text').map(b => b.text).join('\n').trim();
+      } catch (e) {
+        console.error('[bridge:reply] Generation failed:', e.message);
+        return answer({ text: 'Failed to generate reply' });
+      }
+
+      if (!replyText) return answer({ text: 'Could not generate a reply' });
+
+      const notifyFn = (uid, msg, opts = {}) => ctx.api.sendMessage(uid, msg, opts);
+      try {
+        await bridgeTell(replyText, reactingUserId, config, notifyFn, targetUserId);
+      } catch (e) {
+        console.error('[bridge:reply] bridgeTell failed:', e.message);
+        return answer({ text: 'Failed to send reply' });
+      }
+
+      ctx.editMessageText(
+        ctx.callbackQuery.message.text + '\n\n✓ Reply sent',
+        { reply_markup: { inline_keyboard: [] } }
+      ).catch(() => {});
+
+      return answer({ text: 'Reply sent!' });
+    }
+
     if (!data.startsWith('ask:')) return answer();
     const parts = data.split(':');
     const askId = parseInt(parts[1]);

package/src/telegram/handlers/text.js

@@ -27,9 +27,9 @@ function createChatContext(ctx, tenant, config, { allowedUsers, bot, createAsk }
       sendHtml(ctx, `\`${msg}\``).catch(() => {});
     } : undefined,
     telegramAsk: (message, options, timeout) => createAsk(ctx, message, options, timeout),
-    _notifyFn: (targetUserId, message) => {
+    _notifyFn: (targetUserId, message, opts = {}) => {
       if (!allowedUsers.has(targetUserId)) throw new Error('Cannot notify user outside allowed list');
-      return bot.api.sendMessage(targetUserId, message);
+      return bot.api.sendMessage(targetUserId, message, opts);
     },
   };
 }