kongbrain 0.1.0 → 0.1.2

package/README.md

@@ -4,8 +4,9 @@
 
 ![KongBrain](KongClaw.png)
 
+[![npm](https://img.shields.io/npm/v/kongbrain?style=for-the-badge&logo=npm&color=cb3837)](https://www.npmjs.com/package/kongbrain)
 [![GitHub Stars](https://img.shields.io/github/stars/42U/kongbrain?style=for-the-badge&logo=github&color=gold)](https://github.com/42U/kongbrain)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue?style=for-the-badge&logo=opensourceinitiative)](https://opensource.org/licenses/MIT)
+[![License: MIT](https://img.shields.io/github/license/42U/kongbrain?style=for-the-badge&logo=opensourceinitiative&color=blue)](https://opensource.org/licenses/MIT)
 [![Node.js](https://img.shields.io/badge/Node.js-20+-339933?style=for-the-badge&logo=node.js&logoColor=white)](https://nodejs.org)
 [![SurrealDB](https://img.shields.io/badge/SurrealDB-3.0-ff00a0?style=for-the-badge&logo=surrealdb&logoColor=white)](https://surrealdb.com)
 [![OpenClaw](https://img.shields.io/badge/OpenClaw-Plugin-ff6b35?style=for-the-badge)](https://github.com/openclaw/openclaw)
@@ -270,7 +271,7 @@ Triggers at session end when metrics indicate problems:
 | Steering candidates | any detected |
 | Context waste | > 0.5% of context window |
 
-Opus generates a 2-4 sentence reflection: root cause, error pattern, what to do differently. Stored with importance 7.0, deduped at 0.85 cosine similarity.
+The LLM generates a 2-4 sentence reflection: root cause, error pattern, what to do differently. Stored with importance 7.0, deduped at 0.85 cosine similarity.
 
 </details>
 
@@ -297,7 +298,7 @@ Context Injection ─ Vector search -> graph expand -> 6-signal scoring -> budge
     |                  Scores: similarity, recency, importance, access, neighbor, utility
     |                  Budget: 21% of context window reserved for retrieval
     v
-Agent Loop ──────── Claude (Opus/Sonnet/Haiku) + tool execution
+Agent Loop ──────── LLM + tool execution
     |                  Planning gate: announces plan before touching tools
     |                  Smart truncation: preserves tail of large tool outputs
     v
@@ -307,7 +308,7 @@ Turn Storage ────── Every message embedded + stored + linked via gra
 Quality Eval ────── Measures retrieval utilization (text overlap, trigrams, unigrams)
     |                  Tracks tool success, context waste, feeds ACAN training
     v
-Memory Daemon ───── Worker thread extracts 9 knowledge types via Sonnet:
+Memory Daemon ───── Worker thread extracts 9 knowledge types via LLM:
     |                  causal chains, monologues, concepts, corrections,
     |                  preferences, artifacts, decisions, skills, resolved memories
     v
@@ -323,7 +324,7 @@ At session start, a wake-up briefing is synthesized from the handoff, recent mon
 <details>
 <summary><strong>Memory Daemon</strong>: background knowledge extraction</summary>
 
-A worker thread running throughout the session. Batches turns every ~12K tokens, calls Sonnet to extract:
+A worker thread running throughout the session. Batches turns every ~12K tokens, calls the configured LLM to extract:
 
 - **Causal chains**: trigger/outcome sequences with success/confidence
 - **Monologue traces**: thinking blocks that reveal problem-solving approach

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kongbrain",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Graph-backed persistent memory engine for OpenClaw. Replaces the default context window with SurrealDB + vector embeddings that learn across sessions.",
   "type": "module",
   "license": "MIT",

package/src/context-engine.ts

@@ -53,7 +53,7 @@ export class KongBrainContextEngine implements ContextEngine {
   readonly info: ContextEngineInfo = {
     id: "kongbrain",
     name: "KongBrain",
-    version: "0.1.0",
+    version: "0.1.2",
     ownsCompaction: true,
   };
 
@@ -227,10 +227,9 @@ export class KongBrainContextEngine implements ContextEngine {
 
     try {
       const role = (msg as any).role as string;
-      console.log(`[kongbrain:ingest] role=${role} sessionId=${params.sessionId}`);
       if (role === "user" || role === "assistant") {
         const text = extractMessageText(msg);
-        if (!text) { console.log("[kongbrain:ingest] empty text, skipping"); return { ingested: false }; }
+        if (!text) return { ingested: false };
 
         const worthEmbedding = hasSemantic(text);
         let embedding: number[] | null = null;
@@ -248,7 +247,6 @@ export class KongBrainContextEngine implements ContextEngine {
           embedding,
         });
 
-        console.log(`[kongbrain:ingest] turnId=${turnId} role=${role} textLen=${text.length}`);
         if (turnId) {
           await store.relate(turnId, "part_of", session.sessionId)
             .catch(e => swallow.warn("ingest:relate", e));

package/src/index.ts

@@ -92,7 +92,7 @@ async function runSessionCleanup(
     .catch(e => { swallow.warn("cleanup:soulGraduation", e); return null; });
   endOps.push(graduationPromise);
 
-  // The session-end Opus call is critical and needs the full 45s.
+  // The session-end LLM call is critical and needs the full 45s.
   await Promise.race([
     Promise.allSettled(endOps),
     new Promise(resolve => setTimeout(resolve, 45_000)),
@@ -291,6 +291,11 @@ export default definePluginEntry({
         logger.warn(`Embeddings init failed — running in degraded mode: ${e}`);
       }
 
+      // Seed identity chunks (idempotent, requires embeddings ready)
+      seedIdentity(store, embeddings)
+        .then(n => { if (n > 0) logger.info(`Seeded ${n} identity chunks`); })
+        .catch(e => swallow.warn("factory:seedIdentity", e));
+
       return new KongBrainContextEngine(globalState!);
     });
 
@@ -338,10 +343,6 @@ export default definePluginEntry({
         swallow.warn("index:startDaemon", e);
       }
 
-      // Seed identity chunks (idempotent — skips if already seeded)
-      seedIdentity(store, embeddings)
-        .catch(e => swallow.warn("index:seedIdentity", e));
-
       // Check for workspace .md files from the default context engine
       if (globalState!.workspaceDir) {
         hasMigratableFiles(globalState!.workspaceDir)
@@ -362,26 +363,18 @@ export default definePluginEntry({
 
       // Synthesize wakeup briefing (background, non-blocking)
       // The briefing is stored and later injected via assemble()'s systemPromptAddition
-      console.log("[kongbrain:wakeup] starting synthesis...");
       synthesizeWakeup(store, globalState!.complete, session.sessionId)
         .then(briefing => {
-          console.log(`[kongbrain:wakeup] result: ${briefing ? briefing.length + " chars" : "null (no prior state)"}`);
-          if (briefing) {
-            (session as any)._wakeupBriefing = briefing;
-          }
+          if (briefing) (session as any)._wakeupBriefing = briefing;
         })
-        .catch(e => { console.error("[kongbrain:wakeup] FAILED:", e); swallow.warn("index:wakeup", e); });
+        .catch(e => swallow.warn("index:wakeup", e));
 
       // Startup cognition (background)
-      console.log("[kongbrain:cognition] starting synthesis...");
       synthesizeStartupCognition(store, globalState!.complete)
         .then(cognition => {
-          console.log(`[kongbrain:cognition] result: ${cognition ? JSON.stringify(cognition).slice(0, 200) : "null"}`);
-          if (cognition) {
-            (session as any)._startupCognition = cognition;
-          }
+          if (cognition) (session as any)._startupCognition = cognition;
         })
-        .catch(e => { console.error("[kongbrain:cognition] FAILED:", e); swallow.warn("index:startupCognition", e); });
+        .catch(e => swallow.warn("index:startupCognition", e));
     });
 
     api.on("session_end", async (event) => {
@@ -398,7 +391,7 @@ export default definePluginEntry({
     });
 
     // OpenClaw's session_end is fire-and-forget and doesn't fire on CLI exit.
-    // Register a process exit handler to ensure the critical Opus extraction
+    // Register a process exit handler to ensure the critical extraction
     // completes even when the user exits with Ctrl+D or /exit.
     // Clean up previous listeners first (register() can be called multiple times).
     if (registeredExitHandler) {

package/src/memory-daemon.ts

@@ -185,8 +185,11 @@ async function processExtraction(msg: DaemonMessage & { type: "turn_batch" }): P
     const systemPrompt = buildSystemPrompt(thinking.length > 0, retrievedMemories.length > 0, priorState);
 
     const { completeSimple, getModel } = await import("@mariozechner/pi-ai");
-    const provider = config.llmProvider ?? "anthropic";
-    const modelId = config.llmModel ?? "claude-opus-4-6";
+    const provider = config.llmProvider;
+    const modelId = config.llmModel;
+    if (!provider || !modelId) {
+      throw new Error("Memory daemon requires llmProvider and llmModel from host config");
+    }
     // getModel is heavily typed for known providers; cast needed for runtime-configured values
     const model = (getModel as any)(provider, modelId);
 

package/src/reflection.ts

@@ -3,7 +3,7 @@
  *
  * At session end, reviews own performance: tool failures, runaway detections,
  * low retrieval utilization, wasted tokens. If problems exceeded thresholds,
- * generates a structured reflection via Opus, stored as high-importance memory.
+ * generates a structured reflection via the configured LLM, stored as high-importance memory.
  * Retrieved when similar situations arise in future sessions.
  *
  * Ported from kongbrain — takes SurrealStore/EmbeddingService as params.