@sesamespace/hivemind 0.5.14 → 0.5.16

package/README.md

@@ -67,6 +67,36 @@ cd packages/memory && cargo build --release && cd ../..
 | L3 | Semantic Memory | Promoted knowledge (high-access patterns) |
 | L4 | External Memory | Git, files, APIs (on-demand) |
 
+## Dashboard
+
+Local web UI for debugging memory and LLM request formation.
+
+```
+http://localhost:9485
+```
+
+- **Request Inspector:** View every LLM call with full prompt breakdown (identity files, L3 knowledge, L2 episodes with scores, L1 history, config snapshot, token estimates)
+- **Memory Browser:** Search L2 episodes, view/delete L3 entries per context
+- **Context Overview:** List contexts with episode counts
+
+Bound to localhost only, no auth required. Starts automatically with the agent.
+
+## Agent Introspection Commands
+
+Use `hm:` prefix in DMs (not group chats — may collide with other agents' platforms):
+
+| Command | Description |
+|---------|-------------|
+| `hm:status` | Agent health, memory daemon, model, active context |
+| `hm:config` | Full configuration details |
+| `hm:contexts` | All contexts with L1/L2 info |
+| `hm:memory stats` | Episode counts and L3 entries per context |
+| `hm:memory search <query>` | Search L2 memories with similarity scores |
+| `hm:memory l3 [context]` | View promoted L3 knowledge entries |
+| `hm:help` | List all available commands |
+
+These bypass the LLM — deterministic, direct daemon queries.
+
 ## CLI Commands
 
 | Command | Description |

package/dist/{chunk-TRXLCIB4.js → chunk-4QICI4U6.js}

@@ -1,6 +1,6 @@
 import {
   FleetManager
-} from "./chunk-AGFKYYWT.js";
+} from "./chunk-ZDL7HL6V.js";
 
 // packages/cli/src/commands/fleet.ts
 function formatUptime(seconds) {
@@ -183,4 +183,4 @@ Commands:
 export {
   runFleetCommand
 };
-//# sourceMappingURL=chunk-TRXLCIB4.js.map
+//# sourceMappingURL=chunk-4QICI4U6.js.map

package/dist/{chunk-YMQR5I6C.js → chunk-7DZAH77W.js}

@@ -1,10 +1,10 @@
 import {
   Watchdog
-} from "./chunk-AGFKYYWT.js";
+} from "./chunk-ZDL7HL6V.js";
 import {
   defaultSentinelConfig,
   loadConfig
-} from "./chunk-QAOBO4W4.js";
+} from "./chunk-BQCSFDSS.js";
 
 // packages/cli/src/commands/watchdog.ts
 import { resolve } from "path";
@@ -76,4 +76,4 @@ Options:
 export {
   runWatchdogCommand
 };
-//# sourceMappingURL=chunk-YMQR5I6C.js.map
+//# sourceMappingURL=chunk-7DZAH77W.js.map

package/dist/{chunk-QAOBO4W4.js → chunk-BQCSFDSS.js}

@@ -546,6 +546,7 @@ ${charter}
 Messages are prefixed with [sender_handle]: or [sender_handle in group chat]: to tell you who's talking.
 In group chats, multiple people (humans and agents) may be present. Address them by name when relevant.
 Don't repeat or quote these prefixes in your responses \u2014 just respond naturally.
+Keep responses concise \u2014 especially in group chats. A few sentences is usually enough. Don't write essays.
 If you decide not to respond to a group message, reply with exactly: __SKIP__
 `;
   let contextInfo = "";
@@ -750,7 +751,7 @@ var Agent = class {
     let stripped = message.replace(/^\[.+?\s+in\s+group\s+chat\]:\s*/, "");
     stripped = stripped.replace(/^\[.+?\]:\s*/, "");
     const cmdText = stripped;
-    if (/^\/status\b/i.test(cmdText)) {
+    if (/^hm[:\s]status\b/i.test(cmdText)) {
       const memoryOk = await this.memory.healthCheck();
       const contexts = this.contextManager.listContexts();
       let contextStats = "";
@@ -778,7 +779,7 @@ var Agent = class {
       ].join("\n");
       return { content: response, model: "system", context: activeCtx };
     }
-    if (/^\/memory\s+stats\b/i.test(cmdText)) {
+    if (/^hm[:\s]memory\s+stats\b/i.test(cmdText)) {
       try {
         const contexts = await this.memory.listContexts();
         let totalEpisodes = 0;
@@ -810,7 +811,7 @@ var Agent = class {
         return { content: `Memory stats failed: ${err.message}`, model: "system", context: activeCtx };
       }
     }
-    const memSearchMatch = cmdText.match(/^\/memory\s+search\s+(.+)/i);
+    const memSearchMatch = cmdText.match(/^hm[:\s]memory\s+search\s+(.+)/i);
     if (memSearchMatch) {
       const query = memSearchMatch[1].trim();
       try {
@@ -831,7 +832,7 @@ var Agent = class {
         return { content: `Memory search failed: ${err.message}`, model: "system", context: activeCtx };
       }
     }
-    const l3Match = cmdText.match(/^\/memory\s+l3(?:\s+(\S+))?/i);
+    const l3Match = cmdText.match(/^hm[:\s]memory\s+l3(?:\s+(\S+))?/i);
     if (l3Match) {
       const targetCtx = l3Match[1] || activeCtx;
       try {
@@ -852,7 +853,7 @@ var Agent = class {
         return { content: `L3 query failed: ${err.message}`, model: "system", context: activeCtx };
       }
     }
-    if (/^\/config\b/i.test(cmdText)) {
+    if (/^hm[:\s]config\b/i.test(cmdText)) {
       const response = [
         `## Configuration`,
         ``,
@@ -878,7 +879,7 @@ var Agent = class {
       ].join("\n");
       return { content: response, model: "system", context: activeCtx };
     }
-    if (/^\/contexts\b/i.test(cmdText)) {
+    if (/^hm[:\s]contexts\b/i.test(cmdText)) {
       const localContexts = this.contextManager.listContexts();
       let daemonInfo = "";
       try {
@@ -905,17 +906,18 @@ var Agent = class {
       ].join("\n");
       return { content: response, model: "system", context: activeCtx };
     }
-    if (/^\/help\b/i.test(cmdText)) {
+    if (/^hm[:\s]help\b/i.test(cmdText)) {
       const response = [
         `## Available Commands`,
         ``,
         `### Introspection`,
-        `- \`/status\` \u2014 Agent health, memory status, config summary`,
-        `- \`/config\` \u2014 Full configuration details`,
-        `- \`/contexts\` \u2014 List all contexts with L1/L2 info`,
-        `- \`/memory stats\` \u2014 Episode counts, L3 entries per context`,
-        `- \`/memory search <query>\` \u2014 Search L2 memories with scores`,
-        `- \`/memory l3 [context]\` \u2014 Show L3 knowledge entries`,
+        `- \`hm:status\` \u2014 Agent health, memory status, config summary`,
+        `- \`hm:config\` \u2014 Full configuration details`,
+        `- \`hm:contexts\` \u2014 List all contexts with L1/L2 info`,
+        `- \`hm:memory stats\` \u2014 Episode counts, L3 entries per context`,
+        `- \`hm:memory search <query>\` \u2014 Search L2 memories with scores`,
+        `- \`hm:memory l3 [context]\` \u2014 Show L3 knowledge entries`,
+        `- \`hm:help\` \u2014 This help message`,
         ``,
         `### Context Management`,
         `- \`switch to <name>\` \u2014 Switch active context`,
@@ -1997,58 +1999,42 @@ var HEALTH_PORT = 9484;
 var HEALTH_PATH = "/health";
 
 // packages/runtime/src/request-logger.ts
-import Database from "better-sqlite3";
 import { randomUUID } from "crypto";
-import { mkdirSync, existsSync as existsSync3 } from "fs";
+import { mkdirSync, existsSync as existsSync3, appendFileSync, readFileSync as readFileSync4, writeFileSync } from "fs";
 import { dirname as dirname3 } from "path";
 var RequestLogger = class {
-  db;
+  logPath;
+  maxAgeDays = 7;
   constructor(dbPath) {
-    const dir = dirname3(dbPath);
+    this.logPath = dbPath.replace(/\.db$/, ".jsonl");
+    if (this.logPath === dbPath) this.logPath = dbPath + ".jsonl";
+    const dir = dirname3(this.logPath);
     if (!existsSync3(dir)) mkdirSync(dir, { recursive: true });
-    this.db = new Database(dbPath);
-    this.db.pragma("journal_mode = WAL");
-    this.db.pragma("synchronous = NORMAL");
-    this.init();
     this.prune();
   }
-  init() {
-    this.db.exec(`
-      CREATE TABLE IF NOT EXISTS request_logs (
-        id TEXT PRIMARY KEY,
-        timestamp TEXT NOT NULL,
-        context TEXT NOT NULL,
-        context_switched INTEGER NOT NULL DEFAULT 0,
-        routing_reason TEXT NOT NULL DEFAULT '',
-        channel_id TEXT NOT NULL DEFAULT '',
-        channel_kind TEXT NOT NULL DEFAULT '',
-        sender_handle TEXT NOT NULL DEFAULT '',
-        raw_message TEXT NOT NULL,
-        system_prompt_components TEXT NOT NULL,
-        conversation_history TEXT NOT NULL,
-        user_message TEXT NOT NULL,
-        response_content TEXT NOT NULL,
-        response_model TEXT NOT NULL,
-        response_latency_ms INTEGER NOT NULL,
-        response_skipped INTEGER NOT NULL DEFAULT 0,
-        config_snapshot TEXT NOT NULL,
-        token_est_system INTEGER NOT NULL DEFAULT 0,
-        token_est_history INTEGER NOT NULL DEFAULT 0,
-        token_est_user INTEGER NOT NULL DEFAULT 0,
-        token_est_total INTEGER NOT NULL DEFAULT 0
-      )
-    `);
-    this.db.exec(`
-      CREATE INDEX IF NOT EXISTS idx_request_logs_timestamp ON request_logs(timestamp DESC);
-      CREATE INDEX IF NOT EXISTS idx_request_logs_context ON request_logs(context);
-      CREATE INDEX IF NOT EXISTS idx_request_logs_sender ON request_logs(sender_handle);
-    `);
-  }
   prune() {
-    const cutoff = new Date(Date.now() - 7 * 24 * 60 * 60 * 1e3).toISOString();
-    const result = this.db.prepare("DELETE FROM request_logs WHERE timestamp < ?").run(cutoff);
-    if (result.changes > 0) {
-      console.log(`[dashboard] Pruned ${result.changes} old request logs`);
+    if (!existsSync3(this.logPath)) return;
+    const cutoff = new Date(Date.now() - this.maxAgeDays * 24 * 60 * 60 * 1e3).toISOString();
+    try {
+      const lines = readFileSync4(this.logPath, "utf-8").split("\n").filter(Boolean);
+      const kept = [];
+      let pruned = 0;
+      for (const line of lines) {
+        try {
+          const entry = JSON.parse(line);
+          if (entry.timestamp >= cutoff) {
+            kept.push(line);
+          } else {
+            pruned++;
+          }
+        } catch {
+        }
+      }
+      if (pruned > 0) {
+        writeFileSync(this.logPath, kept.join("\n") + (kept.length > 0 ? "\n" : ""));
+        console.log(`[dashboard] Pruned ${pruned} old request logs`);
+      }
+    } catch {
     }
   }
   log(entry) {
@@ -2059,78 +2045,73 @@ var RequestLogger = class {
       entry.conversationHistory.reduce((sum, m) => sum + m.content.length, 0) / 4
     );
     const userTokens = Math.ceil(entry.userMessage.length / 4);
-    this.db.prepare(
-      `INSERT INTO request_logs (
-          id, timestamp, context, context_switched, routing_reason,
-          channel_id, channel_kind, sender_handle, raw_message,
-          system_prompt_components, conversation_history, user_message,
-          response_content, response_model, response_latency_ms, response_skipped,
-          config_snapshot,
-          token_est_system, token_est_history, token_est_user, token_est_total
-        ) VALUES (
-          ?, ?, ?, ?, ?,
-          ?, ?, ?, ?,
-          ?, ?, ?,
-          ?, ?, ?, ?,
-          ?,
-          ?, ?, ?, ?
-        )`
-    ).run(
+    const record = {
       id,
       timestamp,
-      entry.context,
-      entry.contextSwitched ? 1 : 0,
-      entry.routingReason,
-      entry.channelId ?? "",
-      entry.channelKind ?? "",
-      entry.senderHandle ?? "",
-      entry.rawMessage,
-      JSON.stringify(entry.systemPromptComponents),
-      JSON.stringify(entry.conversationHistory),
-      entry.userMessage,
-      entry.response.content,
-      entry.response.model,
-      entry.response.latencyMs,
-      entry.response.skipped ? 1 : 0,
-      JSON.stringify(entry.config),
-      sysTokens,
-      histTokens,
-      userTokens,
-      sysTokens + histTokens + userTokens
-    );
+      context: entry.context,
+      context_switched: entry.contextSwitched,
+      routing_reason: entry.routingReason,
+      channel_id: entry.channelId ?? "",
+      channel_kind: entry.channelKind ?? "",
+      sender_handle: entry.senderHandle ?? "",
+      raw_message: entry.rawMessage,
+      system_prompt_components: JSON.stringify(entry.systemPromptComponents),
+      conversation_history: JSON.stringify(entry.conversationHistory),
+      user_message: entry.userMessage,
+      response_content: entry.response.content,
+      response_model: entry.response.model,
+      response_latency_ms: entry.response.latencyMs,
+      response_skipped: entry.response.skipped,
+      config_snapshot: JSON.stringify(entry.config),
+      token_est_system: sysTokens,
+      token_est_history: histTokens,
+      token_est_user: userTokens,
+      token_est_total: sysTokens + histTokens + userTokens
+    };
+    appendFileSync(this.logPath, JSON.stringify(record) + "\n");
     return id;
   }
   getRequests(opts = {}) {
     const limit = opts.limit ?? 50;
     const offset = opts.offset ?? 0;
-    const conditions = [];
-    const params = [];
+    let entries = this.readAll();
     if (opts.context) {
-      conditions.push("context = ?");
-      params.push(opts.context);
+      entries = entries.filter((e) => e.context === opts.context);
     }
     if (opts.sender) {
-      conditions.push("sender_handle = ?");
-      params.push(opts.sender);
-    }
-    const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-    const total = this.db.prepare(`SELECT COUNT(*) as count FROM request_logs ${where}`).get(...params).count;
-    const requests = this.db.prepare(
-      `SELECT * FROM request_logs ${where} ORDER BY timestamp DESC LIMIT ? OFFSET ?`
-    ).all(...params, limit, offset);
+      entries = entries.filter((e) => e.sender_handle === opts.sender);
+    }
+    entries.sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+    const total = entries.length;
+    const requests = entries.slice(offset, offset + limit);
     return { requests, total };
   }
   getRequest(id) {
-    return this.db.prepare("SELECT * FROM request_logs WHERE id = ?").get(id);
+    return this.readAll().find((e) => e.id === id);
   }
   close() {
-    this.db.close();
+  }
+  readAll() {
+    if (!existsSync3(this.logPath)) return [];
+    try {
+      const lines = readFileSync4(this.logPath, "utf-8").split("\n").filter(Boolean);
+      const entries = [];
+      for (const line of lines) {
+        try {
+          entries.push(JSON.parse(line));
+        } catch {
+        }
+      }
+      return entries;
+    } catch {
+      return [];
+    }
   }
 };
 
 // packages/runtime/src/dashboard.ts
 import { createServer } from "http";
-import { readFileSync as readFileSync4 } from "fs";
+import { readFileSync as readFileSync5 } from "fs";
 import { resolve as resolve4, dirname as dirname4 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 var __dirname = dirname4(fileURLToPath2(import.meta.url));
@@ -2140,7 +2121,7 @@ function getSpaHtml() {
   if (!spaHtml) {
     for (const dir of [__dirname, resolve4(__dirname, "../src")]) {
       try {
-        spaHtml = readFileSync4(resolve4(dir, "dashboard.html"), "utf-8");
+        spaHtml = readFileSync5(resolve4(dir, "dashboard.html"), "utf-8");
         break;
       } catch {
       }
@@ -2262,13 +2243,13 @@ function startDashboardServer(requestLogger, memoryConfig) {
 }
 
 // packages/runtime/src/pipeline.ts
-import { readFileSync as readFileSync5, writeFileSync, unlinkSync } from "fs";
+import { readFileSync as readFileSync6, writeFileSync as writeFileSync2, unlinkSync } from "fs";
 import { resolve as resolve5, dirname as dirname5 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 var PACKAGE_VERSION = "unknown";
 try {
   const __dirname2 = dirname5(fileURLToPath3(import.meta.url));
-  const pkg = JSON.parse(readFileSync5(resolve5(__dirname2, "../package.json"), "utf-8"));
+  const pkg = JSON.parse(readFileSync6(resolve5(__dirname2, "../package.json"), "utf-8"));
   PACKAGE_VERSION = pkg.version ?? "unknown";
 } catch {
 }
@@ -2299,7 +2280,7 @@ function startHealthServer(port) {
   return server;
 }
 function writePidFile(path) {
-  writeFileSync(path, String(process.pid));
+  writeFileSync2(path, String(process.pid));
   console.log(`[hivemind] PID file written: ${path}`);
 }
 function cleanupPidFile(path) {
@@ -2361,8 +2342,41 @@ async function startSesameLoop(config, agent) {
   };
   process.on("SIGTERM", () => shutdown("SIGTERM"));
   process.on("SIGINT", () => shutdown("SIGINT"));
+  const processedIds = /* @__PURE__ */ new Set();
+  const MAX_SEEN = 500;
+  let processing = false;
+  const messageQueue = [];
+  async function processQueue() {
+    if (processing || messageQueue.length === 0) return;
+    processing = true;
+    while (messageQueue.length > 0) {
+      const msg = messageQueue.shift();
+      await handleMessage(msg);
+    }
+    processing = false;
+  }
   sesame.onMessage(async (msg) => {
     if (shuttingDown) return;
+    if (processedIds.has(msg.id)) {
+      console.log(`[sesame] Skipping duplicate message ${msg.id}`);
+      return;
+    }
+    processedIds.add(msg.id);
+    if (processedIds.size > MAX_SEEN) {
+      const iter = processedIds.values();
+      for (let i = 0; i < 100; i++) iter.next();
+      const keep = /* @__PURE__ */ new Set();
+      for (const id of processedIds) {
+        if (keep.size >= MAX_SEEN - 100) break;
+        keep.add(id);
+      }
+      processedIds.clear();
+      for (const id of keep) processedIds.add(id);
+    }
+    messageQueue.push(msg);
+    processQueue();
+  });
+  async function handleMessage(msg) {
     console.log(`[sesame] ${msg.author.handle} (${msg.channelKind}): ${msg.content}`);
     sesame.startTyping(msg.channelId);
     sesame.updatePresence("thinking", { detail: `Replying to ${msg.author.handle}`, emoji: "\u{1F4AD}" });
@@ -2397,7 +2411,7 @@ async function startSesameLoop(config, agent) {
       sesame.updatePresence("online", { emoji: "\u{1F7E2}" });
       console.error("[sesame] Error processing message:", err.message);
     }
-  });
+  }
   await sesame.connect();
   sesameConnected = true;
   console.log("[hivemind] Listening for Sesame messages");
@@ -2944,4 +2958,4 @@ smol-toml/dist/index.js:
    * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    *)
 */
-//# sourceMappingURL=chunk-QAOBO4W4.js.map
+//# sourceMappingURL=chunk-BQCSFDSS.js.map