obol-ai 0.3.10 → 0.3.12

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## 0.3.12
+- add patterns_view, patterns_delete, knowledge_remove, memory_stats tools
+
+## 0.3.11
+- add model stats toggle to /tools menu
+- per-user timezone support for all engagement cycles
+
 ## 0.3.10
 - add CLI commands for evolve and curiosity, verbose logging
 - fix pattern analysis: enforce factual observations, use incrementObservation

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "obol-ai",
-  "version": "0.3.10",
+  "version": "0.3.12",
   "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/chat.js

@@ -8,7 +8,7 @@ const { buildTools, buildRunnableTools, addToolCache } = require('./tool-registr
 const { withCacheBreakpoints, sanitizeMessages, stripToolBlocks } = require('./cache');
 const { getMaxToolIterations } = require('./constants');
 
-function createClaude(anthropicConfig, { personality, memory, selfMemory, userDir = OBOL_DIR, bridgeEnabled, botName }) {
+function createClaude(anthropicConfig, { personality, memory, selfMemory, patterns, userDir = OBOL_DIR, bridgeEnabled, botName }) {
   let client = createAnthropicClient(anthropicConfig);
 
   let baseSystemPrompt = buildSystemPrompt(personality, userDir, { bridgeEnabled, botName });
@@ -18,7 +18,7 @@ function createClaude(anthropicConfig, { personality, memory, selfMemory, userDi
   const chatAbortControllers = new Map();
   const chatForceControllers = new Map();
 
-  const tools = buildTools(memory, { bridgeEnabled, selfMemory });
+  const tools = buildTools(memory, { bridgeEnabled, selfMemory, patterns });
 
   function acquireChatLock(chatId) {
     if (!chatLocks.has(chatId)) chatLocks.set(chatId, { promise: Promise.resolve(), busy: false });
@@ -105,6 +105,7 @@ function createClaude(anthropicConfig, { personality, memory, selfMemory, userDi
     context._forceSignal = forceController.signal;
     context.claude = { chat, clearHistory, client };
     context.selfMemory = selfMemory;
+    context.patterns = patterns;
     const runnableTools = buildRunnableTools(tools, memory, context, vlog);
     let activeModel = model;
 

package/src/claude/constants.js

@@ -29,6 +29,12 @@ const OPTIONAL_TOOLS = {
     tools: ['mermaid_chart'],
     config: {},
   },
+  model_stats: {
+    label: 'Model Stats',
+    tools: [],
+    config: {},
+    defaultEnabled: true,
+  },
 };
 
 const BLOCKED_EXEC_PATTERNS = [

package/src/claude/tool-registry.js

@@ -15,6 +15,7 @@ const historyTool = require('./tools/history');
 const agentTool = require('./tools/agent');
 const sttTool = require('./tools/stt');
 const mermaidTool = require('./tools/mermaid');
+const patternsTool = require('./tools/patterns');
 
 const TOOL_MODULES = [
   execTool,
@@ -54,6 +55,10 @@ const INPUT_SUMMARIES = {
   create_pdf: (i) => i.filename || 'document',
   text_to_speech: (i) => i.text?.substring(0, 60),
   tts_voices: (i) => i.language || 'all',
+  memory_stats: () => 'stats',
+  knowledge_remove: (i) => i.ids?.join(', '),
+  patterns_view: (i) => i.dimension || 'all',
+  patterns_delete: (i) => i.key,
   chat_history: (i) => `${i.date}${i.role ? ` [${i.role}]` : ''}`,
 };
 
@@ -77,6 +82,10 @@ function buildTools(memory, opts = {}) {
     tools.push(...knowledgeTool.definitions);
   }
 
+  if (opts.patterns) {
+    tools.push(...patternsTool.definitions);
+  }
+
   if (opts.bridgeEnabled) {
     tools.push(...bridgeTool.getDefinitions());
   }
@@ -91,6 +100,7 @@ function buildHandlerMap() {
   }
   Object.assign(map, memoryTool.handlers);
   Object.assign(map, knowledgeTool.handlers);
+  Object.assign(map, patternsTool.handlers);
   Object.assign(map, bridgeTool.handlers);
   return map;
 }
@@ -103,7 +113,8 @@ function buildRunnableTools(tools, memory, context, vlog) {
   if (toolPrefs) {
     for (const [featureKey, feature] of Object.entries(OPTIONAL_TOOLS)) {
       const pref = toolPrefs.get(featureKey);
-      if (!pref || !pref.enabled) {
+      const enabled = pref ? pref.enabled : (feature.defaultEnabled || false);
+      if (!enabled) {
         for (const t of feature.tools) disabledTools.add(t);
       }
     }

package/src/claude/tools/knowledge.js

@@ -49,6 +49,17 @@ const definitions = [
       required: ['content'],
     },
   },
+  {
+    name: 'knowledge_remove',
+    description: 'Remove one or more entries from your own knowledge/self-memory by ID. Use knowledge_search first to find IDs.',
+    input_schema: {
+      type: 'object',
+      properties: {
+        ids: { type: 'array', items: { type: 'string' }, description: 'IDs to remove' },
+      },
+      required: ['ids'],
+    },
+  },
 ];
 
 function formatEntry(m) {
@@ -100,6 +111,13 @@ const handlers = {
     });
     return `Interest stored: ${result.id}`;
   },
+
+  async knowledge_remove(input, _memory, context) {
+    const selfMemory = context.selfMemory;
+    if (!selfMemory) return 'Self memory not available.';
+    await Promise.all(input.ids.map(id => selfMemory.forget(id)));
+    return `Removed ${input.ids.length} entr${input.ids.length !== 1 ? 'ies' : 'y'}`;
+  },
 };
 
 const requiresSelfMemory = true;

package/src/claude/tools/memory.js

@@ -53,6 +53,11 @@ const definitions = [
       },
     },
   },
+  {
+    name: 'memory_stats',
+    description: 'Show memory statistics — total count and breakdown by category.',
+    input_schema: { type: 'object', properties: {} },
+  },
 ];
 
 function formatMemory(m) {
@@ -96,6 +101,11 @@ const handlers = {
     });
     return JSON.stringify(results.map(formatMemory));
   },
+
+  async memory_stats(_input, memory) {
+    const { total, breakdown } = await memory.stats();
+    return `Total memories: ${total}\n\nBy category:\n${breakdown}`;
+  },
 };
 
 const requiresMemory = true;

package/src/claude/tools/patterns.js

@@ -0,0 +1,52 @@
+const definitions = [
+  {
+    name: 'patterns_view',
+    description: 'View behavioral patterns learned about the user. Shows timing, mood, humor, engagement, communication, and topic patterns.',
+    input_schema: {
+      type: 'object',
+      properties: {
+        dimension: { type: 'string', enum: ['timing', 'mood', 'humor', 'engagement', 'communication', 'topics'], description: 'Filter by dimension (omit for all)' },
+      },
+    },
+  },
+  {
+    name: 'patterns_delete',
+    description: 'Delete a behavioral pattern by its key. Use patterns_view first to see available keys.',
+    input_schema: {
+      type: 'object',
+      properties: {
+        key: { type: 'string', description: 'Pattern key to delete (e.g. "timing.active_hours", "mood.stress_signals")' },
+      },
+      required: ['key'],
+    },
+  },
+];
+
+function formatPattern(p) {
+  const obs = p.observation_count ? ` (${p.observation_count} observations)` : '';
+  const conf = p.confidence != null ? ` [confidence: ${p.confidence}]` : '';
+  return `[${p.dimension}] ${p.key}: ${p.summary}${conf}${obs}`;
+}
+
+const handlers = {
+  async patterns_view(_input, _memory, context) {
+    if (!context.patterns) return 'Patterns not available (Supabase not configured).';
+    const patterns = _input.dimension
+      ? await context.patterns.getByDimension(_input.dimension)
+      : await context.patterns.getAll();
+    if (!patterns.length) return _input.dimension ? `No ${_input.dimension} patterns found.` : 'No patterns learned yet.';
+    return patterns.map(formatPattern).join('\n');
+  },
+
+  async patterns_delete(input, _memory, context) {
+    if (!context.patterns) return 'Patterns not available (Supabase not configured).';
+    const existing = await context.patterns.get(input.key);
+    if (!existing) return `Pattern not found: ${input.key}`;
+    await context.patterns.remove(input.key);
+    return `Deleted pattern: ${input.key}`;
+  },
+};
+
+const requiresPatterns = true;
+
+module.exports = { definitions, handlers, requiresPatterns };

package/src/cli/config.js

@@ -1,12 +1,18 @@
 const inquirer = require('inquirer');
 const fs = require('fs');
 const path = require('path');
-const { loadConfig, saveConfig, CONFIG_FILE, USERS_DIR } = require('../config');
+const { loadConfig, saveConfig, CONFIG_FILE, USERS_DIR, isValidTimezone } = require('../config');
 const { getNestedValue, setNestedValue, formatValue, updatePassSecret } = require('./config-utils');
 const { manageUsers } = require('./manage-users');
 const { runOAuthFlow } = require('./oauth');
 
 const SECTIONS = [
+  {
+    name: 'General',
+    fields: [
+      { key: 'timezone', label: 'Timezone (IANA)', secret: false, validate: (v) => isValidTimezone(v.trim()) ? true : 'Invalid IANA timezone (e.g. Europe/Brussels, America/New_York)' },
+    ],
+  },
   {
     name: 'Anthropic',
     fields: [
@@ -210,6 +216,7 @@ async function config() {
       } else {
         opts.default = currentVal != null ? String(currentVal) : '';
       }
+      if (field.validate) opts.validate = field.validate;
       const { newVal } = await inquirer.prompt([opts]);
 
       if (isPassRef) {

package/src/cli/init.js

@@ -1,7 +1,7 @@
 const inquirer = require('inquirer');
 const fs = require('fs');
 const path = require('path');
-const { getConfigDir, saveConfig, loadConfig, CONFIG_FILE, ensureUserDir } = require('../config');
+const { getConfigDir, saveConfig, loadConfig, CONFIG_FILE, ensureUserDir, isValidTimezone } = require('../config');
 const { validateAnthropic, validateTelegram, validateSupabase } = require('../auth/validators');
 const { setupAnthropicOAuth } = require('./oauth');
 const { setupSupabaseNew, setupSupabaseExisting } = require('./supabase-setup');
@@ -64,7 +64,7 @@ async function init(opts = {}) {
 
   const config = {};
   let step = 0;
-  const totalSteps = 5;
+  const totalSteps = 6;
   const stepLabel = (name) => `─── Step ${++step}/${totalSteps}: ${name} ───`;
 
   // Step 1: Anthropic
@@ -178,7 +178,20 @@ async function init(opts = {}) {
   config.owner = { name: ownerName };
   config.bot = { name: botName };
 
-  // Step 5: Access control
+  // Step 5: Timezone
+  console.log('\n' + stepLabel('Timezone') + '\n');
+  const detectedTz = Intl.DateTimeFormat().resolvedOptions().timeZone;
+  console.log(`  Your system timezone: ${detectedTz}\n`);
+  const { timezone } = await inquirer.prompt([{
+    type: 'input',
+    name: 'timezone',
+    message: 'Timezone (IANA):',
+    default: detectedTz,
+    validate: (v) => isValidTimezone(v.trim()) ? true : 'Invalid IANA timezone (e.g. Europe/Brussels, America/New_York)',
+  }]);
+  config.timezone = timezone.trim();
+
+  // Step 6: Access control
   console.log('\n' + stepLabel('Access control') + '\n');
   console.log('  Each allowed user gets their own isolated brain — separate');
   console.log('  personality, memory, evolution cycle, and workspace.');
@@ -190,14 +203,23 @@ async function init(opts = {}) {
     console.log('  Since you have multiple users, name each one:\n');
     config.users = {};
     for (const userId of config.telegram.allowedUsers) {
-      const { userName } = await inquirer.prompt([{
-        type: 'input',
-        name: 'userName',
-        message: `Name for user ${userId}:`,
-        default: config.owner.name,
-        validate: (v) => v.length > 0,
-      }]);
-      config.users[String(userId)] = { name: userName };
+      const { userName, userTz } = await inquirer.prompt([
+        {
+          type: 'input',
+          name: 'userName',
+          message: `Name for user ${userId}:`,
+          default: config.owner.name,
+          validate: (v) => v.length > 0,
+        },
+        {
+          type: 'input',
+          name: 'userTz',
+          message: `Timezone for user ${userId}:`,
+          default: config.timezone,
+          validate: (v) => isValidTimezone(v.trim()) ? true : 'Invalid IANA timezone',
+        },
+      ]);
+      config.users[String(userId)] = { name: userName, timezone: userTz.trim() };
     }
 
     const { bridgeEnabled } = await inquirer.prompt([{

package/src/cli/manage-users.js

@@ -1,6 +1,6 @@
 const inquirer = require('inquirer');
 const fs = require('fs');
-const { ensureUserDir, getUserDir } = require('../config');
+const { ensureUserDir, getUserDir, isValidTimezone } = require('../config');
 const { detectTelegramUserId } = require('./init-utils');
 const { setNestedValue } = require('./config-utils');
 
@@ -28,7 +28,10 @@ async function manageUsers(cfg, saveConfig) {
     } else {
       for (const id of currentUsers) {
         const hasDir = fs.existsSync(getUserDir(id));
-        console.log(`    ${id}${hasDir ? ' ✅' : ' (no workspace yet)'}`);
+        const name = cfg.users?.[String(id)]?.name;
+        const tz = cfg.users?.[String(id)]?.timezone;
+        const label = [name, tz].filter(Boolean).join(' — ');
+        console.log(`    ${id}${label ? ` (${label})` : ''}${hasDir ? ' ✅' : ' (no workspace yet)'}`);
       }
     }
     console.log('');
@@ -41,6 +44,7 @@ async function manageUsers(cfg, saveConfig) {
         { name: 'Add user (detect from bot messages)', value: 'detect' },
         { name: 'Add user (enter ID manually)', value: 'manual' },
         ...(currentUsers.length > 0 ? [{ name: 'Rename user', value: 'rename' }] : []),
+        ...(currentUsers.length > 0 ? [{ name: 'Set user timezone', value: 'timezone' }] : []),
         ...(currentUsers.length > 0 ? [{ name: 'Remove user', value: 'remove' }] : []),
         new inquirer.Separator(),
         { name: 'Back', value: 'back' },
@@ -140,6 +144,36 @@ async function manageUsers(cfg, saveConfig) {
       }
     }
 
+    if (action === 'timezone') {
+      const { tzId } = await inquirer.prompt([{
+        type: 'list',
+        name: 'tzId',
+        message: 'Set timezone for which user?',
+        choices: [
+          ...currentUsers.map(id => {
+            const name = cfg.users?.[String(id)]?.name;
+            const tz = cfg.users?.[String(id)]?.timezone || cfg.timezone || 'UTC';
+            return { name: `${id}${name ? ` — ${name}` : ''} (${tz})`, value: id };
+          }),
+          new inquirer.Separator(),
+          { name: 'Cancel', value: null },
+        ],
+      }]);
+      if (tzId !== null) {
+        const currentTz = cfg.users?.[String(tzId)]?.timezone || cfg.timezone || '';
+        const { newTz } = await inquirer.prompt([{
+          type: 'input',
+          name: 'newTz',
+          message: `Timezone for user ${tzId} (IANA):`,
+          default: currentTz,
+          validate: (v) => isValidTimezone(v.trim()) ? true : 'Invalid IANA timezone (e.g. Europe/Brussels, America/New_York)',
+        }]);
+        if (!cfg.users) cfg.users = {};
+        if (!cfg.users[String(tzId)]) cfg.users[String(tzId)] = {};
+        cfg.users[String(tzId)].timezone = newTz.trim();
+      }
+    }
+
     if (action === 'remove') {
       const { removeId } = await inquirer.prompt([{
         type: 'list',

package/src/config.js

@@ -164,6 +164,18 @@ function ensureUserDir(userId) {
   return dir;
 }
 
+/** @param {object} config @param {number|string} userId @returns {string} */
+function getUserTimezone(config, userId) {
+  return config.users?.[String(userId)]?.timezone || config.timezone || 'UTC';
+}
+
+function isValidTimezone(tz) {
+  try {
+    Intl.DateTimeFormat(undefined, { timeZone: tz });
+    return true;
+  } catch { return false; }
+}
+
 function listUsers() {
   if (!fs.existsSync(USERS_DIR)) return [];
   return fs.readdirSync(USERS_DIR).filter(f =>
@@ -184,4 +196,6 @@ module.exports = {
   getUserDir,
   ensureUserDir,
   listUsers,
+  getUserTimezone,
+  isValidTimezone,
 };

package/src/curiosity/impulse.js

@@ -1,6 +1,7 @@
 const Anthropic = require('@anthropic-ai/sdk');
 const { createSelfMemory } = require('../memory/self');
 const { getTenant } = require('../tenant');
+const { getUserTimezone } = require('../config');
 
 const IMPULSE_MODEL = 'claude-haiku-4-5-20251001';
 const COOLDOWN_MS = 24 * 60 * 60 * 1000;
@@ -109,7 +110,7 @@ async function maybeImpulse(bot, config, tenant, chatId, lastUserMsg, lastAssist
   const { text: context, hasSubstance } = await gatherContext(tenant, config.supabase, {
     lastUserMsg,
     lastAssistantMsg,
-    timezone: config.timezone,
+    timezone: getUserTimezone(config, tenant.userId),
   });
   if (!hasSubstance) return;
 
@@ -130,7 +131,7 @@ async function maybePeriodicImpulse(bot, config, userId) {
 
   const { text: context, hasSubstance } = await gatherContext(tenant, config.supabase, {
     periodic: true,
-    timezone: config.timezone,
+    timezone: getUserTimezone(config, userId),
   });
   if (!hasSubstance) return;
 

package/src/runtime/heartbeat.js

@@ -2,7 +2,7 @@ const cron = require('node-cron');
 const { createScheduler } = require('./scheduler');
 const { getTenant } = require('../tenant');
 const { shouldEvolveNow, evolve } = require('../evolve');
-const { ensureUserDir } = require('../config');
+const { ensureUserDir, getUserTimezone } = require('../config');
 const { runAnalysis } = require('../analysis');
 const { runCuriosity } = require('../curiosity');
 const { runCuriosityDispatch } = require('../curiosity/dispatch');
@@ -34,7 +34,7 @@ function getLocalHour(timezone) {
 async function runEvolutionForUser(bot, config, userId) {
   if (_evolutionRunning.has(userId)) return;
 
-  const timezone = config.timezone || 'UTC';
+  const timezone = getUserTimezone(config, userId);
   const userDir = ensureUserDir(userId);
 
   if (!shouldEvolveNow(userDir, timezone)) return;
@@ -127,7 +127,7 @@ async function runCuriosityOnce(config, allowedUsers) {
           ? await tenant.scheduler.list({ status: 'pending', limit: 5 }).catch(() => [])
           : [];
         const userProfile = tenant.personality?.user || null;
-        return { userId, chatId: userId, timezone: config.timezone || 'UTC', patterns, events, scheduler: tenant.scheduler, userProfile };
+        return { userId, chatId: userId, timezone: getUserTimezone(config, userId), patterns, events, scheduler: tenant.scheduler, userProfile };
       } catch { return null; }
     }));
     await runCuriosityDispatch(client, selfMemory, userDispatchData.filter(Boolean));
@@ -140,7 +140,7 @@ async function runCuriosityOnce(config, allowedUsers) {
 }
 
 async function runAnalysisForUser(bot, config, userId) {
-  const timezone = config.timezone || 'UTC';
+  const timezone = getUserTimezone(config, userId);
   try {
     const tenant = await getTenant(userId, config);
     if (!tenant.messageLog || !tenant.scheduler || !tenant.patterns) return;
@@ -203,34 +203,32 @@ function setupHeartbeat(bot, config) {
   const allowedUsers = config?.telegram?.allowedUsers || [];
   if (allowedUsers.length > 0) {
     cron.schedule('* * * * *', async () => {
-      const timezone = config.timezone || 'UTC';
-      const { hour, minute } = getLocalHour(timezone);
-      if (hour !== 3 || minute !== 0) return;
-
       for (const userId of allowedUsers) {
+        const tz = getUserTimezone(config, userId);
+        const { hour, minute } = getLocalHour(tz);
+        if (hour !== 3 || minute !== 0) continue;
         runEvolutionForUser(bot, config, userId).catch(e =>
           console.error(`[evolution] Unhandled error for user ${userId}:`, e.message)
         );
       }
     });
-    console.log(`  ✅ Evolution cron running (daily 3am ${config.timezone || 'UTC'})`);
+    console.log('  ✅ Evolution cron running (daily 3am per-user timezone)');
 
     cron.schedule('* * * * *', async () => {
-      const timezone = config.timezone || 'UTC';
-      const { hour, minute } = getLocalHour(timezone);
-      if (!ANALYSIS_HOURS.has(hour) || minute !== 0) return;
-
       for (const userId of allowedUsers) {
+        const tz = getUserTimezone(config, userId);
+        const { hour, minute } = getLocalHour(tz);
+        if (!ANALYSIS_HOURS.has(hour) || minute !== 0) continue;
         runAnalysisForUser(bot, config, userId).catch(e =>
           console.error(`[analysis] Unhandled error for user ${userId}:`, e.message)
         );
       }
     });
-    console.log(`  ✅ Analysis cron running (every 3h ${config.timezone || 'UTC'})`);
+    console.log('  ✅ Analysis cron running (every 3h per-user timezone)');
 
     cron.schedule('* * * * *', async () => {
-      const timezone = config.timezone || 'UTC';
-      const { hour, minute } = getLocalHour(timezone);
+      const tz = config.timezone || 'UTC';
+      const { hour, minute } = getLocalHour(tz);
       if (!CURIOSITY_HOURS.has(hour) || minute !== 0) return;
 
       runCuriosityOnce(config, allowedUsers).catch(e =>
@@ -240,17 +238,16 @@ function setupHeartbeat(bot, config) {
     console.log(`  ✅ Curiosity cron running (every 6h ${config.timezone || 'UTC'})`);
 
     cron.schedule('* * * * *', async () => {
-      const timezone = config.timezone || 'UTC';
-      const { hour, minute } = getLocalHour(timezone);
-      if (!IMPULSE_HOURS.has(hour) || minute !== 0) return;
-
       for (const userId of allowedUsers) {
+        const tz = getUserTimezone(config, userId);
+        const { hour, minute } = getLocalHour(tz);
+        if (!IMPULSE_HOURS.has(hour) || minute !== 0) continue;
         maybePeriodicImpulse(bot, config, userId).catch(e =>
           console.error(`[impulse] Periodic error for user ${userId}:`, e.message)
         );
       }
     });
-    console.log(`  ✅ Impulse cron running (every 6h ${config.timezone || 'UTC'})`);
+    console.log('  ✅ Impulse cron running (every 6h per-user timezone)');
   }
 
   console.log('  ✅ Heartbeat running (every 1min)');
@@ -301,7 +298,7 @@ async function buildProactiveContext(tenant, timezone, query) {
 
 async function runAgenticEvent(bot, config, event) {
   const tenant = await getTenant(event.user_id, config);
-  const timezone = event.timezone || config.timezone || 'UTC';
+  const timezone = event.timezone || getUserTimezone(config, event.user_id);
 
   const query = event.description || event.instructions;
   const context = await buildProactiveContext(tenant, timezone, query).catch(() => '');

package/src/telegram/commands/tools.js

@@ -4,11 +4,14 @@ const { OPTIONAL_TOOLS } = require('../../claude');
 const { clearVoiceFlow, sendVoiceLanguagePicker } = require('../voice');
 const { TERM_SEP } = require('../constants');
 
+function isEnabled(pref, feature) {
+  return pref ? pref.enabled : (feature.defaultEnabled || false);
+}
+
 function buildToolsMessage(toolPrefs) {
   const lines = [`◈ TOOLS`, TERM_SEP, ``];
   for (const [key, feature] of Object.entries(OPTIONAL_TOOLS)) {
-    const pref = toolPrefs.get(key);
-    const enabled = pref?.enabled || false;
+    const enabled = isEnabled(toolPrefs.get(key), feature);
     lines.push(`  ${enabled ? '◉' : '○'} ${feature.label}`);
   }
   lines.push(``, TERM_SEP);
@@ -20,8 +23,7 @@ function buildToolsKeyboard(toolPrefs) {
   const entries = Object.entries(OPTIONAL_TOOLS);
   for (let i = 0; i < entries.length; i++) {
     const [key, feature] = entries[i];
-    const pref = toolPrefs.get(key);
-    const enabled = pref?.enabled || false;
+    const enabled = isEnabled(toolPrefs.get(key), feature);
     keyboard.text(`${enabled ? '◉' : '○'} ${feature.label}`, `tool:${key}`);
     if ((i + 1) % 2 === 0 && i < entries.length - 1) keyboard.row();
   }
@@ -49,10 +51,10 @@ async function handleToolCallback(ctx, featureKey, answer, { getTenant: gt, conf
   const tenant = await gt(ctx.from.id, cfg);
   if (!tenant.toolPrefsApi) return answer({ text: 'Not available' });
 
-  const newEnabled = await tenant.toolPrefsApi.toggle(featureKey);
+  const feature = OPTIONAL_TOOLS[featureKey];
+  const newEnabled = await tenant.toolPrefsApi.toggle(featureKey, feature.defaultEnabled);
   await tenant.reloadToolPrefs();
 
-  const feature = OPTIONAL_TOOLS[featureKey];
   await answer({ text: `${feature.label}: ${newEnabled ? 'ON' : 'OFF'}` });
 
   const text = buildToolsMessage(tenant.toolPrefs);

package/src/telegram/handlers/media.js

@@ -124,7 +124,9 @@ async function processMediaItems(ctx, items, { config, allowedUsers, bot, create
       await sendHtml(ctx, response).catch(() => {});
     }
 
-    if (usage && model) {
+    const statsPref = tenant.toolPrefs?.get('model_stats');
+    const showStats = statsPref ? statsPref.enabled : true;
+    if (showStats && usage && model) {
       const tag = model.includes('opus') ? 'opus' : model.includes('haiku') ? 'haiku' : 'sonnet';
       const tokIn = usage.input_tokens >= 1000 ? `${(usage.input_tokens/1000).toFixed(1)}k` : usage.input_tokens;
       const tokOut = usage.output_tokens >= 1000 ? `${(usage.output_tokens/1000).toFixed(1)}k` : usage.output_tokens;

package/src/telegram/handlers/special.js

@@ -120,7 +120,9 @@ async function processSpecial(ctx, prompt, deps) {
       await sendHtml(ctx, response).catch(() => {});
     }
 
-    if (usage && model) {
+    const statsPref = tenant.toolPrefs?.get('model_stats');
+    const showStats = statsPref ? statsPref.enabled : true;
+    if (showStats && usage && model) {
       const tag = model.includes('opus') ? 'opus' : model.includes('haiku') ? 'haiku' : 'sonnet';
       const tokIn = usage.input_tokens >= 1000 ? `${(usage.input_tokens / 1000).toFixed(1)}k` : usage.input_tokens;
       const tokOut = usage.output_tokens >= 1000 ? `${(usage.output_tokens / 1000).toFixed(1)}k` : usage.output_tokens;

package/src/telegram/handlers/text.js

@@ -230,7 +230,9 @@ async function processTextMessage(ctx, fullMessage, { config, allowedUsers, bot,
       sendTtsVoiceSummary(ctx, tenant, response).catch(e => console.error('[tts] Auto-summary failed:', e.message));
     }
 
-    if (usage && model) {
+    const statsPref = tenant.toolPrefs?.get('model_stats');
+    const showStats = statsPref ? statsPref.enabled : true;
+    if (showStats && usage && model) {
       const tag = model.includes('opus') ? 'opus' : model.includes('haiku') ? 'haiku' : 'sonnet';
       const tokIn = usage.input_tokens >= 1000 ? `${(usage.input_tokens/1000).toFixed(1)}k` : usage.input_tokens;
       const tokOut = usage.output_tokens >= 1000 ? `${(usage.output_tokens/1000).toFixed(1)}k` : usage.output_tokens;

package/src/tenant.js

@@ -38,7 +38,7 @@ async function createTenant(userId, config) {
   const selfMemory = config.supabase ? await createSelfMemory(config.supabase, userId) : null;
   const patterns = config.supabase ? await createPatterns(config.supabase, userId) : null;
   const bridgeEnabled = isBridgeEnabled(config) && (config.telegram?.allowedUsers?.length || 0) >= 2;
-  const claude = createClaude(config.anthropic, { personality, memory, selfMemory, userDir, bridgeEnabled, botName: config.bot?.name });
+  const claude = createClaude(config.anthropic, { personality, memory, selfMemory, patterns, userDir, bridgeEnabled, botName: config.bot?.name });
   const scheduler = config.supabase ? createScheduler(config.supabase, userId) : null;
   const messageLog = config.supabase ? createMessageLog(config.supabase, memory, config.anthropic, userId, userDir) : null;
   const toolPrefsApi = config.supabase ? createToolPrefs(config.supabase, userId) : null;

package/src/toolprefs.js

@@ -39,10 +39,11 @@ function createToolPrefs(supabaseConfig, userId) {
     return data[0];
   }
 
-  async function toggle(toolName) {
+  async function toggle(toolName, defaultEnabled = false) {
     const all = await getAll();
     const current = all.get(toolName);
-    const newEnabled = !(current?.enabled);
+    const currentEnabled = current ? current.enabled : defaultEnabled;
+    const newEnabled = !currentEnabled;
     await set(toolName, newEnabled, current?.config || {});
     return newEnabled;
   }