@p-sw/brainbox 0.2.2 → 0.2.3-beta.0

package/README.md

@@ -22,6 +22,9 @@ Then she runs on a Discord or Telegram account. She greets you. She replies when
 
 ### Getting started
 
+
+> **Requires [Bun](https://bun.sh).** Channel message history uses `bun:sqlite`, so run BrainBox with Bun (`bun install`, `bun run …`, or install the CLI under Bun). Node alone is not enough.
+
 **1. Install**
 
 ```

package/dist/index.js

@@ -4,7 +4,7 @@
 import { Command } from "commander";
 import { readFileSync as readFileSync2 } from "fs";
 import { fileURLToPath as fileURLToPath2 } from "url";
-import { dirname as dirname3, join as join6 } from "path";
+import { dirname as dirname3, join as join7 } from "path";
 
 // src/utils/logger.ts
 import chalk from "chalk";
@@ -2733,6 +2733,42 @@ var baseSystemPromptSchema = {
 import { BadRequestResponseError } from "@openrouter/sdk/models/errors";
 
 // src/brain/messageHistory.ts
+import { Database } from "bun:sqlite";
+import { mkdirSync as mkdirSync3 } from "fs";
+import { join as join4 } from "path";
+var db = null;
+function getDb() {
+  if (db)
+    return db;
+  mkdirSync3(brainboxRoot, { recursive: true });
+  db = new Database(join4(brainboxRoot, "message-history.sqlite"));
+  db.run(`
+    CREATE TABLE IF NOT EXISTS messages (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      brain_id TEXT NOT NULL,
+      sender TEXT NOT NULL,
+      time INTEGER NOT NULL,
+      content TEXT NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_messages_brain_time
+      ON messages(brain_id, time);
+  `);
+  return db;
+}
+function appendMessageHistory(brainId, entry) {
+  getDb().prepare(`INSERT INTO messages (brain_id, sender, time, content)
+       VALUES (?, ?, ?, ?)`).run(brainId, entry.sender, entry.time.getTime(), entry.content);
+}
+function getMessageHistory(brainId, start, end) {
+  const rows = getDb().prepare(`SELECT sender, time, content FROM messages
+       WHERE brain_id = ? AND time >= ? AND time <= ?
+       ORDER BY time ASC, id ASC`).all(brainId, start.getTime(), end.getTime());
+  return rows.map((row) => ({
+    sender: row.sender,
+    time: new Date(row.time),
+    content: row.content
+  }));
+}
 function formatTime(time) {
   const pad = (n) => n.toString().padStart(2, "0");
   return `${time.getFullYear()}-${pad(time.getMonth() + 1)}-${pad(time.getDate())} ${pad(time.getHours())}:${pad(time.getMinutes())}:${pad(time.getSeconds())}`;
@@ -2762,8 +2798,8 @@ var log6 = logger.child("memory");
 class Memory {
   db;
   space;
-  constructor(db, space) {
-    this.db = db;
+  constructor(db2, space) {
+    this.db = db2;
     this.space = space;
     log6.debug(`Memory constructed for space=${space.name}`);
   }
@@ -2843,8 +2879,8 @@ class Brain {
   brainbase;
   availabilityCache = new Map;
   memory;
-  constructor(db, space, brainbase, memory) {
-    this.db = db;
+  constructor(db2, space, brainbase, memory) {
+    this.db = db2;
     this.space = space;
     this.brainbase = brainbase;
     this.memory = memory ?? new Memory(this.db, this.space);
@@ -3382,7 +3418,7 @@ ${blocks.join(`
       const baseSystemPrompt = `${generated.baseSystemPrompt}
 
 ${personaSystemFixed}`;
-      const db = new Supermemory({ apiKey: config.supermemoryApiKey });
+      const db2 = new Supermemory({ apiKey: config.supermemoryApiKey });
       const brainId = randomUUID();
       const space = {
         name: `brain:${brainId}`,
@@ -3399,7 +3435,7 @@ ${personaSystemFixed}`;
         startConversationTimeThreshold: generated.startConversationTimeThreshold,
         activated: false
       };
-      const memory = new Memory(db, space);
+      const memory = new Memory(db2, space);
       await memory.add({
         customId: "persona",
         content: description,
@@ -3408,7 +3444,7 @@ ${personaSystemFixed}`;
       log7.debug(`Brain.create: persona description stored`);
       await brainManager.saveBrain(brainId, brainbase);
       log7.debug(`Brain.create: brainbase saved (id=${brainId})`);
-      return { brainId, brain: new Brain(db, space, brainbase, memory) };
+      return { brainId, brain: new Brain(db2, space, brainbase, memory) };
     } catch (error) {
       let reason = error instanceof Error ? `${error.message} (${error.name})` : String(error);
       if (error instanceof BadRequestResponseError) {
@@ -3425,8 +3461,8 @@ ${personaSystemFixed}`;
       log7.debug(`Brain.delete: no brainbase found`);
       return false;
     }
-    const db = new Supermemory({ apiKey: config.supermemoryApiKey });
-    const memory = new Memory(db, { name: brainbase.spaceName });
+    const db2 = new Supermemory({ apiKey: config.supermemoryApiKey });
+    const memory = new Memory(db2, { name: brainbase.spaceName });
     try {
       await memory.clear();
     } catch (error) {
@@ -3444,10 +3480,10 @@ ${personaSystemFixed}`;
       log7.debug(`Brain.load: not loadable (missing or not ready)`);
       return null;
     }
-    const db = new Supermemory({ apiKey: config.supermemoryApiKey });
+    const db2 = new Supermemory({ apiKey: config.supermemoryApiKey });
     const space = { name: brainbase.spaceName };
     log7.debug(`Brain.load: ready (channel=${brainbase.channel})`);
-    return new Brain(db, space, brainbase);
+    return new Brain(db2, space, brainbase);
   }
 }
 function formatDatetime(now) {
@@ -3545,7 +3581,9 @@ var VIEW_THINGS = [
   "monthly-schedule",
   "sending-queue",
   "deferred-queue",
-  "today-availability"
+  "today-availability",
+  "persona",
+  "base-system-prompt"
 ];
 
 class BaseChannel {
@@ -3585,7 +3623,7 @@ class BaseChannel {
         return;
       }
     }
-    const history = await this.getMessageHistoryBetween(new Date(Date.now() - 24 * 60 * 60 * 1000), new Date);
+    const history = this.getMessageHistory(new Date(Date.now() - 24 * 60 * 60 * 1000), new Date);
     await this.brain.sleepMemory(new Date, history);
   }
   async regenerateSchedules() {
@@ -3613,11 +3651,11 @@ class BaseChannel {
     if (count >= countThreshold)
       return;
     const nowMs = now.getTime();
-    const history = await this.getMessageHistoryBetween(new Date(nowMs - 24 * 60 * 60 * 1000), now);
+    const history = this.getMessageHistory(new Date(nowMs - 24 * 60 * 60 * 1000), now);
     try {
       const replies = await this.brain.sendMessage(history, [], {
         initiate: true,
-        send: this.send.bind(this)
+        send: this.sendAndRecord.bind(this)
       });
       if (replies.length === 0)
         return;
@@ -3709,7 +3747,12 @@ class BaseChannel {
         twoDaysAgo.setDate(now.getDate() - 2);
         this.isSending = true;
         try {
-          await this.brain.sendMessage(await this.getMessageHistoryBetween(twoDaysAgo, now), newUserMessages, { send: this.send.bind(this) });
+          const history = this.getMessageHistory(twoDaysAgo, now);
+          for (const m of newUserMessages)
+            this.saveMessageHistory(m);
+          await this.brain.sendMessage(history, newUserMessages, {
+            send: this.sendAndRecord.bind(this)
+          });
         } catch (e) {
           logger.error(`Error while sending message: ${e}`);
           logger.debug(`onMessage: sendMessage threw — ${e instanceof Error ? e.stack : String(e)}`);
@@ -3888,6 +3931,12 @@ class BaseChannel {
         }));
       case "today-availability":
         return await this.brain.getTodayScheduledAvailability(now);
+      case "persona": {
+        const stored = await this.brain.memory.get("persona");
+        return stored?.content ?? null;
+      }
+      case "base-system-prompt":
+        return this.brain.brainbase.baseSystemPrompt;
     }
   }
   static async shutdownAll() {
@@ -3972,10 +4021,23 @@ class BaseChannel {
       displayName: channel.brain.brainbase.displayName
     };
   }
+  getMessageHistory(start, end) {
+    return getMessageHistory(this.brain.brainbase.brainId, start, end);
+  }
+  saveMessageHistory(entry) {
+    appendMessageHistory(this.brain.brainbase.brainId, entry);
+  }
+  async sendAndRecord(text) {
+    await this.send(text);
+    this.saveMessageHistory({
+      sender: "persona",
+      time: new Date,
+      content: text
+    });
+  }
 }
 
 // src/channel/discord.ts
-var HISTORY_CAP = 1000;
 var AVAILABILITY_STATUS_MAP = {
   online: "online",
   "do-not-disturb": "dnd",
@@ -3985,7 +4047,6 @@ var AVAILABILITY_STATUS_MAP = {
 class DiscordChannel extends BaseChannel {
   client;
   targetChannel;
-  history = [];
   constructor(brain) {
     super(brain);
   }
@@ -4037,14 +4098,12 @@ class DiscordChannel extends BaseChannel {
         this.onPairing(inbound);
         return;
       }
-      const entry = {
+      logger.debug(`MessageCreate: dispatching (channel=${msg.channelId})`);
+      this.onMessage({
         sender: "user",
         time: msg.createdAt,
         content
-      };
-      this.pushHistory(entry);
-      logger.debug(`MessageCreate: stored in history, dispatching (channel=${msg.channelId})`);
-      this.onMessage(entry);
+      });
     });
     logger.debug(`DiscordChannel.init: logging in`);
     await this.client.login(this.brain.brainbase.discord.token);
@@ -4104,14 +4163,6 @@ class DiscordChannel extends BaseChannel {
     logger.debug(`setAvailability: ${status} → ${mapped}`);
     this.client.user.setStatus(mapped);
   }
-  async getMessageHistoryBetween(start, end) {
-    return this.history.filter((m) => m.time >= start && m.time <= end);
-  }
-  pushHistory(entry) {
-    this.history.push(entry);
-    if (this.history.length > HISTORY_CAP)
-      this.history.shift();
-  }
   async resolveSendChannel() {
     if (this.targetChannel) {
       logger.debug(`resolveSendChannel: cache hit`);
@@ -4160,12 +4211,9 @@ class DiscordChannel extends BaseChannel {
 
 // src/channel/telegram.ts
 import { Bot } from "gramio";
-var HISTORY_CAP2 = 1000;
-
 class TelegramChannel extends BaseChannel {
   bot;
   chatId;
-  history = [];
   constructor(brain) {
     super(brain);
   }
@@ -4207,14 +4255,12 @@ class TelegramChannel extends BaseChannel {
         return;
       }
       this.chatId = ctx.chat.id;
-      const entry = {
+      logger.debug(`Telegram message: dispatching (chat=${ctx.chat.id})`);
+      this.onMessage({
         sender: "user",
         time: inbound.time,
         content: text
-      };
-      this.pushHistory(entry);
-      logger.debug(`Telegram message: stored in history, dispatching (chat=${ctx.chat.id})`);
-      this.onMessage(entry);
+      });
     });
     logger.debug(`TelegramChannel.init: starting bot`);
     await this.bot.start();
@@ -4254,14 +4300,6 @@ class TelegramChannel extends BaseChannel {
   async setAvailability(_status) {
     logger.debug(`setAvailability: ${_status} (no-op, Telegram has no bot presence)`);
   }
-  async getMessageHistoryBetween(start, end) {
-    return this.history.filter((m) => m.time >= start && m.time <= end);
-  }
-  pushHistory(entry) {
-    this.history.push(entry);
-    if (this.history.length > HISTORY_CAP2)
-      this.history.shift();
-  }
   async teardownClient() {
     if (!this.bot) {
       logger.debug(`teardownClient: no bot, nothing to stop`);
@@ -4275,8 +4313,8 @@ class TelegramChannel extends BaseChannel {
 
 // src/utils/daemonClient.ts
 import { connect } from "node:net";
-import { join as join4 } from "node:path";
-var DAEMON_SOCKET_PATH = join4(config.brainboxRoot, "daemon.sock");
+import { join as join5 } from "node:path";
+var DAEMON_SOCKET_PATH = join5(config.brainboxRoot, "daemon.sock");
 async function sendToDaemon(payload) {
   logger.debug(`sendToDaemon: command="${payload.command}" args=${JSON.stringify(payload.args) ?? "null"}`);
   let reply;
@@ -4338,7 +4376,7 @@ function exchangeOnce(payload) {
 // src/commands/daemon.ts
 import { createServer } from "node:net";
 import { chmodSync, unlinkSync } from "node:fs";
-import { join as join5 } from "node:path";
+import { join as join6 } from "node:path";
 
 // src/commands/daemon/commands.ts
 var log8 = logger.child("daemon-cmd");
@@ -4490,9 +4528,9 @@ async function startChannels() {
   return started;
 }
 async function daemon() {
-  const logDir = join5(config.brainboxRoot, "logs");
+  const logDir = join6(config.brainboxRoot, "logs");
   logger.configure({ logDir });
-  configureLlmLog(config.debug ? join5(logDir, "llm") : undefined);
+  configureLlmLog(config.debug ? join6(logDir, "llm") : undefined);
   logger.debug(`daemon: boot (debug=${config.debug}, logDir=${logDir}, llmLog=${config.debug})`);
   const started = await startChannels();
   if (started === 0) {
@@ -6114,7 +6152,7 @@ logger.configure({ level: config.debug ? "debug" : "info" });
 logger.debug(`brainbox starting (debug=${config.debug}, root=${config.brainboxRoot})`);
 function getVersion() {
   try {
-    const pkgPath = join6(__dirname3, "..", "package.json");
+    const pkgPath = join7(__dirname3, "..", "package.json");
     const pkg = JSON.parse(readFileSync2(pkgPath, "utf-8"));
     return pkg.version ?? "0.0.0";
   } catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@p-sw/brainbox",
-  "version": "0.2.2",
+  "version": "0.2.3-beta.0",
   "module": "dist/index.js",
   "main": "dist/index.js",
   "type": "module",
@@ -14,6 +14,7 @@
     "prepack": "bun run build"
   },
   "devDependencies": {
+    "@types/bun": "^1.3.14",
     "@types/node": "^25.9.1"
   },
   "peerDependencies": {