@basicmemory/openclaw-basic-memory 0.1.0-alpha.12 → 0.1.0-alpha.14

package/bm-client.ts

@@ -196,7 +196,7 @@ function isRecoverableConnectionError(err: unknown): boolean {
   )
 }
 
-function isNoteNotFoundError(err: unknown): boolean {
+function _isNoteNotFoundError(err: unknown): boolean {
   const msg = getErrorMessage(err).toLowerCase()
   return (
     msg.includes("entity not found") ||
@@ -659,11 +659,12 @@ export class BmClient {
       identifier,
       operation,
       content,
-      find_text: options.find_text,
-      section: options.section,
-      expected_replacements: options.expected_replacements,
       output_format: "json",
     }
+    if (options.find_text) args.find_text = options.find_text
+    if (options.section) args.section = options.section
+    if (options.expected_replacements != null)
+      args.expected_replacements = options.expected_replacements
     if (project) args.project = project
 
     const payload = await this.callTool("edit_note", args)
@@ -829,10 +830,6 @@ export class BmClient {
     return payload as unknown as MetadataSearchResult
   }
 
-  private isNoteNotFoundError(err: unknown): boolean {
-    return isNoteNotFoundError(err)
-  }
-
   async indexConversation(
     userMessage: string,
     assistantResponse: string,
@@ -854,22 +851,33 @@ export class BmClient {
       "---",
     ].join("\n")
 
+    // Try append first — if it fails for ANY reason, fall through to create
     try {
       await this.editNote(title, "append", entry)
       log.debug(`appended conversation to: ${title}`)
+      return
     } catch (err) {
-      if (!this.isNoteNotFoundError(err)) {
-        log.error("conversation append failed", err)
-        return
-      }
+      log.debug(`append failed, will create: ${getErrorMessage(err)}`)
+    }
 
-      const content = [`# Conversations ${dateStr}`, "", entry].join("\n")
-      try {
-        await this.writeNote(title, content, "conversations")
-        log.debug(`created conversation note: ${title}`)
-      } catch (createErr) {
-        log.error("conversation index failed", createErr)
-      }
+    // Create the note with frontmatter and first entry
+    const content = [
+      "---",
+      `title: Conversations ${dateStr}`,
+      "type: Conversation",
+      `date: "${dateStr}"`,
+      "---",
+      "",
+      `# Conversations ${dateStr}`,
+      "",
+      entry,
+    ].join("\n")
+
+    try {
+      await this.writeNote(title, content, "conversations")
+      log.debug(`created conversation note: ${title}`)
+    } catch (err) {
+      log.error("conversation index failed", err)
     }
   }
 

package/config.ts

@@ -6,11 +6,6 @@ export type CloudConfig = {
   api_key: string
 }
 
-export type DashboardConfig = {
-  enabled: boolean
-  port: number
-}
-
 export type BasicMemoryConfig = {
   project: string
   bmPath: string
@@ -23,7 +18,6 @@ export type BasicMemoryConfig = {
   recallPrompt: string
   debug: boolean
   cloud?: CloudConfig
-  dashboard: DashboardConfig
 }
 
 const ALLOWED_KEYS = [
@@ -43,7 +37,6 @@ const ALLOWED_KEYS = [
   "recall_prompt",
   "debug",
   "cloud",
-  "dashboard",
 ]
 
 function assertAllowedKeys(
@@ -113,22 +106,6 @@ export function parseConfig(raw: unknown): BasicMemoryConfig {
     }
   }
 
-  let dashboard: DashboardConfig = { enabled: false, port: 3838 }
-  if (
-    cfg.dashboard &&
-    typeof cfg.dashboard === "object" &&
-    !Array.isArray(cfg.dashboard)
-  ) {
-    const d = cfg.dashboard as Record<string, unknown>
-    dashboard = {
-      enabled: typeof d.enabled === "boolean" ? d.enabled : false,
-      port:
-        typeof d.port === "number" && d.port > 0 && d.port < 65536
-          ? d.port
-          : 3838,
-    }
-  }
-
   return {
     project:
       typeof cfg.project === "string" && cfg.project.length > 0
@@ -167,7 +144,6 @@ export function parseConfig(raw: unknown): BasicMemoryConfig {
           : "Check for active tasks and recent activity. Summarize anything relevant to the current session.",
     debug: typeof cfg.debug === "boolean" ? cfg.debug : false,
     cloud,
-    dashboard,
   }
 }
 

package/index.ts

@@ -1,5 +1,5 @@
 import { execSync } from "node:child_process"
-import type { Server } from "node:http"
+
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk"
 import { BmClient } from "./bm-client.ts"
 import { registerCli } from "./commands/cli.ts"
@@ -10,10 +10,11 @@ import {
   parseConfig,
   resolveProjectPath,
 } from "./config.ts"
-import { createDashboardServer } from "./dashboard/server.ts"
+
 import { buildCaptureHandler } from "./hooks/capture.ts"
 import { buildRecallHandler } from "./hooks/recall.ts"
 import { initLogger, log } from "./logger.ts"
+import { CONVERSATION_SCHEMA_CONTENT } from "./schema/conversation-schema.ts"
 import { TASK_SCHEMA_CONTENT } from "./schema/task-schema.ts"
 import { registerContextTool } from "./tools/build-context.ts"
 import { registerDeleteTool } from "./tools/delete-note.ts"
@@ -83,8 +84,6 @@ export default {
     registerCli(api, client, cfg)
 
     // --- Service lifecycle ---
-    let dashboardServer: Server | undefined
-
     api.registerService({
       id: "openclaw-basic-memory",
       start: async (ctx: { config?: unknown; workspaceDir?: string }) => {
@@ -105,7 +104,9 @@ export default {
               'uv tool install "basic-memory @ git+https://github.com/basicmachines-co/basic-memory.git@main" --force',
               { encoding: "utf-8", timeout: 120_000, stdio: "pipe" },
             )
-            log.info(`basic-memory installed: ${result.trim().split("\n").pop()}`)
+            log.info(
+              `basic-memory installed: ${result.trim().split("\n").pop()}`,
+            )
             // Verify it worked
             try {
               execSync(`command -v ${bmBin}`, { stdio: "ignore" })
@@ -115,7 +116,7 @@ export default {
                 "bm installed but not found on PATH. You may need to add uv's bin directory to your PATH (typically ~/.local/bin).",
               )
             }
-          } catch (uvErr) {
+          } catch (_uvErr) {
             log.error(
               "Cannot auto-install basic-memory: uv not found. " +
                 "Install uv first (brew install uv, or curl -LsSf https://astral.sh/uv/install.sh | sh), " +
@@ -132,45 +133,30 @@ export default {
         await client.ensureProject(projectPath)
         log.debug(`project "${cfg.project}" at ${projectPath}`)
 
-        // Seed Task schema if not already present
-        try {
-          await client.readNote("schema/Task")
-          log.debug("Task schema already exists, skipping seed")
-        } catch {
+        // Seed schemas if not already present
+        for (const [name, content] of [
+          ["Task", TASK_SCHEMA_CONTENT],
+          ["Conversation", CONVERSATION_SCHEMA_CONTENT],
+        ] as const) {
           try {
-            await client.writeNote("Task", TASK_SCHEMA_CONTENT, "schema")
-            log.debug("seeded Task schema note")
-          } catch (err) {
-            log.debug("Task schema seed failed (non-fatal)", err)
+            await client.readNote(`schema/${name}`)
+            log.debug(`${name} schema already exists, skipping seed`)
+          } catch {
+            try {
+              await client.writeNote(name, content, "schema")
+              log.debug(`seeded ${name} schema note`)
+            } catch (err) {
+              log.debug(`${name} schema seed failed (non-fatal)`, err)
+            }
           }
         }
 
         setWorkspaceDir(workspace)
 
-        // Start dashboard if enabled
-        if (cfg.dashboard.enabled) {
-          dashboardServer = createDashboardServer({
-            port: cfg.dashboard.port,
-            client,
-          })
-          dashboardServer.listen(cfg.dashboard.port, () => {
-            log.info(
-              `dashboard running at http://localhost:${cfg.dashboard.port}`,
-            )
-          })
-        }
-
         log.info("connected — BM MCP stdio session running")
       },
       stop: async () => {
         log.info("stopping BM MCP session...")
-        if (dashboardServer) {
-          await new Promise<void>((resolve) =>
-            dashboardServer?.close(() => resolve()),
-          )
-          dashboardServer = undefined
-          log.info("dashboard stopped")
-        }
         await client.stop()
         log.info("stopped")
       },

package/openclaw.plugin.json

@@ -56,11 +56,6 @@
       "label": "Cloud Backend",
       "help": "Optional cloud backend config (url + api_key). If present, uses cloud instead of local BM.",
       "advanced": true
-    },
-    "dashboard": {
-      "label": "Dashboard",
-      "help": "Web dashboard for visualizing the knowledge graph (enabled, port)",
-      "advanced": true
     }
   },
   "configSchema": {
@@ -81,13 +76,6 @@
           "url": { "type": "string" },
           "api_key": { "type": "string" }
         }
-      },
-      "dashboard": {
-        "type": "object",
-        "properties": {
-          "enabled": { "type": "boolean" },
-          "port": { "type": "number", "minimum": 1, "maximum": 65535 }
-        }
       }
     },
     "required": []

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@basicmemory/openclaw-basic-memory",
-  "version": "0.1.0-alpha.12",
+  "version": "0.1.0-alpha.14",
   "type": "module",
   "description": "Basic Memory plugin for OpenClaw — local-first knowledge graph for agent memory",
   "license": "MIT",
@@ -33,8 +33,7 @@
     "tools/write-note.ts",
     "types/openclaw.d.ts",
     "schema/task-schema.ts",
-    "dashboard/server.ts",
-    "dashboard/index.html",
+    "schema/conversation-schema.ts",
     "skills/",
     "scripts/setup-bm.sh",
     "openclaw.plugin.json",

package/schema/conversation-schema.ts

@@ -0,0 +1,33 @@
+/**
+ * Canonical Conversation schema note content, seeded into new projects on first startup.
+ * If the schema already exists (user may have customized it), seeding is skipped.
+ */
+export const CONVERSATION_SCHEMA_CONTENT = `---
+title: Conversation
+type: schema
+entity: Conversation
+version: 1
+schema:
+  date: "string, ISO date YYYY-MM-DD"
+  session_id?: "string, unique session identifier"
+  channel?: "string, where the conversation happened (webchat, telegram, discord, etc)"
+  participants?: "array, who was in the conversation"
+  topic?: "string, brief description of main topic"
+  summary?: "string, one-paragraph summary of key points"
+  key_decisions?: "array, decisions made during conversation"
+  action_items?: "array, things to do as a result"
+settings:
+  validation: warn
+---
+
+# Conversation
+
+A record of a conversation session between the agent and user(s).
+
+## Observations
+- [convention] Conversation files live in memory/conversations/ with format conversations-YYYY-MM-DD.md
+- [convention] Messages are appended as the conversation progresses
+- [convention] Summary and key_decisions populated at session end or by memory-reflect
+- [convention] Skip routine greetings, heartbeat acks, and tool call details
+- [convention] Focus on decisions, actions taken, and key context needed for continuity
+`

package/dashboard/index.html

@@ -1,182 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>Memory Dashboard</title>
-<style>
-* { margin: 0; padding: 0; box-sizing: border-box; }
-body { background: #0a0a0a; color: #e0e0e0; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; }
-code, .mono { font-family: 'SF Mono', 'Fira Code', 'Consolas', monospace; }
-
-/* Stats Bar */
-.stats-bar {
-  display: flex; gap: 24px; padding: 16px 24px;
-  background: #111; border-bottom: 1px solid #222;
-}
-.stat { text-align: center; }
-.stat-value { font-size: 28px; font-weight: 700; }
-.stat-label { font-size: 12px; color: #888; text-transform: uppercase; letter-spacing: 0.5px; }
-.stat-active .stat-value { color: #3b82f6; }
-.stat-done .stat-value { color: #22c55e; }
-.stat-explore .stat-value { color: #a855f7; }
-.stat-total .stat-value { color: #e0e0e0; }
-
-/* Layout */
-.main { display: flex; height: calc(100vh - 70px); }
-.kanban-area { flex: 1; overflow-x: auto; padding: 16px; }
-.sidebar { width: 320px; border-left: 1px solid #222; padding: 16px; overflow-y: auto; flex-shrink: 0; }
-
-/* Kanban */
-.kanban { display: flex; gap: 12px; height: 100%; }
-.column { flex: 1; min-width: 220px; background: #111; border-radius: 8px; display: flex; flex-direction: column; }
-.column-header { padding: 12px; font-weight: 600; font-size: 13px; text-transform: uppercase; letter-spacing: 0.5px; border-bottom: 2px solid; }
-.col-active .column-header { border-color: #3b82f6; color: #3b82f6; }
-.col-blocked .column-header { border-color: #ef4444; color: #ef4444; }
-.col-done .column-header { border-color: #22c55e; color: #22c55e; }
-.col-abandoned .column-header { border-color: #6b7280; color: #6b7280; }
-.column-body { padding: 8px; overflow-y: auto; flex: 1; }
-
-/* Cards */
-.card {
-  background: #1a1a1a; border: 1px solid #333; border-radius: 6px;
-  padding: 10px; margin-bottom: 8px; cursor: pointer; transition: border-color 0.15s;
-}
-.card:hover { border-color: #555; }
-.card-title { font-size: 13px; font-weight: 600; margin-bottom: 6px; word-break: break-word; }
-.card-meta { font-size: 11px; color: #888; font-family: 'SF Mono', monospace; }
-.card-meta span { margin-right: 10px; }
-.card-detail { display: none; margin-top: 8px; font-size: 12px; color: #aaa; border-top: 1px solid #333; padding-top: 8px; }
-.card.expanded .card-detail { display: block; }
-
-/* Sidebar */
-.sidebar h2 { font-size: 14px; text-transform: uppercase; letter-spacing: 0.5px; color: #888; margin-bottom: 12px; }
-.activity-item {
-  padding: 8px 0; border-bottom: 1px solid #1a1a1a; font-size: 13px;
-}
-.activity-title { font-weight: 500; }
-.activity-time { font-size: 11px; color: #666; font-family: 'SF Mono', monospace; }
-
-/* Refresh indicator */
-.refresh { position: fixed; top: 8px; right: 8px; font-size: 11px; color: #444; }
-
-@media (max-width: 900px) {
-  .main { flex-direction: column; }
-  .sidebar { width: 100%; border-left: none; border-top: 1px solid #222; max-height: 300px; }
-  .kanban { flex-wrap: wrap; }
-  .column { min-width: 180px; }
-}
-</style>
-</head>
-<body>
-
-<div class="stats-bar" id="stats-bar">
-  <div class="stat stat-total"><div class="stat-value" id="stat-total">-</div><div class="stat-label">Total Notes</div></div>
-  <div class="stat stat-active"><div class="stat-value" id="stat-active">-</div><div class="stat-label">Active Tasks</div></div>
-  <div class="stat stat-done"><div class="stat-value" id="stat-done">-</div><div class="stat-label">Completed</div></div>
-  <div class="stat stat-explore"><div class="stat-value" id="stat-explore">-</div><div class="stat-label">Explorations</div></div>
-</div>
-
-<div class="main">
-  <div class="kanban-area">
-    <div class="kanban">
-      <div class="column col-active"><div class="column-header">Active <span class="col-count"></span></div><div class="column-body" id="col-active"></div></div>
-      <div class="column col-blocked"><div class="column-header">Blocked <span class="col-count"></span></div><div class="column-body" id="col-blocked"></div></div>
-      <div class="column col-done"><div class="column-header">Done <span class="col-count"></span></div><div class="column-body" id="col-done"></div></div>
-      <div class="column col-abandoned"><div class="column-header">Abandoned <span class="col-count"></span></div><div class="column-body" id="col-abandoned"></div></div>
-    </div>
-  </div>
-  <div class="sidebar">
-    <h2>Activity Feed</h2>
-    <div id="activity-feed"></div>
-  </div>
-</div>
-
-<div class="refresh" id="refresh">⏳</div>
-
-<script>
-const API = '';
-
-function makeCard(task) {
-  const fm = task.frontmatter || {};
-  const status = (fm.status || 'active').toLowerCase();
-  const step = fm.current_step || '?';
-  const total = fm.total_steps || '?';
-  const assigned = fm.assigned_to || '';
-  const div = document.createElement('div');
-  div.className = 'card';
-  div.innerHTML = `
-    <div class="card-title">${esc(task.title)}</div>
-    <div class="card-meta">
-      ${assigned ? `<span>👤 ${esc(assigned)}</span>` : ''}
-      <span>📊 ${esc(String(step))}/${esc(String(total))}</span>
-    </div>
-    <div class="card-detail mono">${esc(task.content || '').slice(0, 300)}</div>
-  `;
-  div.onclick = () => div.classList.toggle('expanded');
-  return { el: div, status };
-}
-
-function esc(s) { const d = document.createElement('div'); d.textContent = s; return d.innerHTML; }
-
-async function fetchJson(url) {
-  try { const r = await fetch(url); return r.ok ? r.json() : null; } catch { return null; }
-}
-
-async function refresh() {
-  document.getElementById('refresh').textContent = '🔄';
-
-  const [tasks, activity, stats] = await Promise.all([
-    fetchJson(`${API}/api/tasks`),
-    fetchJson(`${API}/api/activity`),
-    fetchJson(`${API}/api/stats`),
-  ]);
-
-  // Stats
-  if (stats) {
-    document.getElementById('stat-total').textContent = stats.totalNotes;
-    document.getElementById('stat-active').textContent = stats.activeTasks;
-    document.getElementById('stat-done').textContent = stats.completedTasks;
-    document.getElementById('stat-explore').textContent = stats.explorations;
-  }
-
-  // Kanban
-  const cols = { active: [], blocked: [], done: [], abandoned: [] };
-  if (tasks) {
-    for (const t of tasks) {
-      const { el, status } = makeCard(t);
-      const bucket = cols[status] ? status : 'active';
-      cols[bucket].push(el);
-    }
-  }
-  for (const [key, items] of Object.entries(cols)) {
-    const container = document.getElementById(`col-${key}`);
-    container.innerHTML = '';
-    for (const el of items) container.appendChild(el);
-    container.parentElement.querySelector('.col-count').textContent = `(${items.length})`;
-  }
-
-  // Activity
-  const feed = document.getElementById('activity-feed');
-  feed.innerHTML = '';
-  if (activity?.length) {
-    for (const a of activity.slice(0, 30)) {
-      const div = document.createElement('div');
-      div.className = 'activity-item';
-      const time = a.created_at ? new Date(a.created_at).toLocaleTimeString() : '';
-      div.innerHTML = `<div class="activity-title">${esc(a.title)}</div><div class="activity-time">${time}</div>`;
-      feed.appendChild(div);
-    }
-  } else {
-    feed.innerHTML = '<div style="color:#555">No recent activity</div>';
-  }
-
-  document.getElementById('refresh').textContent = '✓';
-  setTimeout(() => { document.getElementById('refresh').textContent = ''; }, 2000);
-}
-
-refresh();
-setInterval(refresh, 30000);
-</script>
-</body>
-</html>

package/dashboard/server.ts

@@ -1,146 +0,0 @@
-import { readFileSync } from "node:fs"
-import {
-  createServer,
-  type IncomingMessage,
-  type Server,
-  type ServerResponse,
-} from "node:http"
-import { join } from "node:path"
-import type { BmClient, SearchResult } from "../bm-client.ts"
-
-export interface DashboardServerOptions {
-  port: number
-  client: BmClient
-}
-
-export function createDashboardServer(options: DashboardServerOptions): Server {
-  const { client, port } = options
-
-  const indexHtml = readFileSync(
-    join(import.meta.dirname ?? __dirname, "index.html"),
-    "utf-8",
-  )
-
-  const server = createServer(
-    async (req: IncomingMessage, res: ServerResponse) => {
-      const url = new URL(req.url ?? "/", `http://localhost:${port}`)
-      const path = url.pathname
-
-      try {
-        if (path === "/" && req.method === "GET") {
-          res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" })
-          res.end(indexHtml)
-          return
-        }
-
-        if (path === "/api/tasks" && req.method === "GET") {
-          const results = await client.search("type:Task", 50, undefined, {
-            filters: { type: "Task" },
-          })
-          const tasks = await enrichWithFrontmatter(client, results)
-          json(res, tasks)
-          return
-        }
-
-        if (path === "/api/activity" && req.method === "GET") {
-          const results = await client.recentActivity("24h")
-          json(res, results)
-          return
-        }
-
-        if (path === "/api/explorations" && req.method === "GET") {
-          const results = await client.search(
-            "type:Exploration",
-            50,
-            undefined,
-            {
-              filters: { type: "Exploration" },
-            },
-          )
-          json(res, results)
-          return
-        }
-
-        if (path === "/api/notes/daily" && req.method === "GET") {
-          const today = new Date().toISOString().split("T")[0]
-          const results = await client.search(today, 5)
-          const daily = results.filter((r) => r.title.includes(today))
-          json(res, daily)
-          return
-        }
-
-        if (path === "/api/stats" && req.method === "GET") {
-          const [allNotes, tasks, explorations] = await Promise.all([
-            client.recentActivity("720h").catch(() => []),
-            client
-              .search("type:Task", 100, undefined, {
-                filters: { type: "Task" },
-              })
-              .catch(() => []),
-            client
-              .search("type:Exploration", 100, undefined, {
-                filters: { type: "Exploration" },
-              })
-              .catch(() => []),
-          ])
-
-          const tasksWithFm = await enrichWithFrontmatter(client, tasks)
-          const active = tasksWithFm.filter(
-            (t) => t.frontmatter?.status === "active",
-          ).length
-          const completed = tasksWithFm.filter(
-            (t) =>
-              t.frontmatter?.status === "done" ||
-              t.frontmatter?.status === "completed",
-          ).length
-
-          json(res, {
-            totalNotes: allNotes.length,
-            activeTasks: active,
-            completedTasks: completed,
-            explorations: explorations.length,
-          })
-          return
-        }
-
-        res.writeHead(404, { "Content-Type": "application/json" })
-        res.end(JSON.stringify({ error: "not found" }))
-      } catch (err: unknown) {
-        const message = err instanceof Error ? err.message : String(err)
-        res.writeHead(500, { "Content-Type": "application/json" })
-        res.end(JSON.stringify({ error: message }))
-      }
-    },
-  )
-
-  return server
-}
-
-function json(res: ServerResponse, data: unknown): void {
-  res.writeHead(200, {
-    "Content-Type": "application/json",
-    "Access-Control-Allow-Origin": "*",
-  })
-  res.end(JSON.stringify(data))
-}
-
-async function enrichWithFrontmatter(
-  client: BmClient,
-  results: SearchResult[],
-): Promise<
-  Array<SearchResult & { frontmatter?: Record<string, unknown> | null }>
-> {
-  const enriched = await Promise.all(
-    results.map(async (r) => {
-      try {
-        const note = await client.readNote(r.permalink, {
-          includeFrontmatter: true,
-        })
-        return { ...r, frontmatter: note.frontmatter ?? null }
-      } catch {
-        return { ...r, frontmatter: null }
-      }
-    }),
-  )
-  return enriched
-}