openclaw-mem 1.0.4 → 1.3.0

package/docs/locales/README_VI.md

@@ -1,35 +0,0 @@
-# OpenClaw-Mem 🧠
-
-> Cung cấp bộ nhớ dài hạn liên tục cho tác nhân AI OpenClaw của bạn
-
-[![npm version](https://img.shields.io/npm/v/openclaw-mem.svg)](https://www.npmjs.com/package/openclaw-mem)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-[English](../../README.md) | [中文](../../README_CN.md) | Tiếng Việt
-
-OpenClaw-Mem tự động ghi lại các cuộc hội thoại của bạn và làm cho chúng có thể tìm kiếm được, cho phép trợ lý AI của bạn nhớ những gì bạn đã thảo luận giữa các phiên.
-
-## ✨ Tính năng
-
-- **🔄 Tự động ghi nhớ** - Các cuộc hội thoại được lưu tự động
-- **🔍 Tìm kiếm toàn văn** - Tìm kiếm trong toàn bộ lịch sử hội thoại
-- **📊 Tiết lộ dần dần** - Sử dụng token hiệu quả với ngữ cảnh phân lớp
-- **🎯 Phát hiện chủ đề** - Tự động lập chỉ mục các cuộc thảo luận theo chủ đề
-- **💾 Lưu trữ cục bộ** - Tất cả dữ liệu nằm trên máy của bạn (SQLite)
-- **⚡ Không cần cấu hình** - Hoạt động ngay lập tức
-
-## 🚀 Bắt đầu nhanh
-
-```bash
-# Cài đặt và thiết lập (một lệnh!)
-npx openclaw-mem init
-
-# Khởi động lại cổng OpenClaw
-openclaw gateway restart
-```
-
-Vậy là xong! Bắt đầu trò chuyện và các cuộc hội thoại của bạn sẽ được ghi nhớ.
-
-## 📄 Giấy phép
-
-Giấy phép MIT - xem [LICENSE](../../LICENSE) để biết chi tiết

package/docs/logo.svg

@@ -1,32 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 60">
-  <defs>
-    <linearGradient id="brainGrad" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" style="stop-color:#667eea"/>
-      <stop offset="100%" style="stop-color:#764ba2"/>
-    </linearGradient>
-    <linearGradient id="textGrad" x1="0%" y1="0%" x2="100%" y2="0%">
-      <stop offset="0%" style="stop-color:#667eea"/>
-      <stop offset="50%" style="stop-color:#764ba2"/>
-      <stop offset="100%" style="stop-color:#f093fb"/>
-    </linearGradient>
-  </defs>
-
-  <!-- Brain icon -->
-  <g transform="translate(5, 8)">
-    <!-- Brain outline -->
-    <path d="M22 8c-4 0-7 3-7 7 0 1.5.5 3 1.5 4-2 1-3.5 3-3.5 5.5 0 3.5 3 6.5 6.5 6.5h1c0 2 1.5 4 4 4s4-2 4-4h1c3.5 0 6.5-3 6.5-6.5 0-2.5-1.5-4.5-3.5-5.5 1-1 1.5-2.5 1.5-4 0-4-3-7-7-7h-4z"
-          fill="url(#brainGrad)" opacity="0.9"/>
-    <!-- Brain details -->
-    <path d="M20 15c0 0 2 2 4 0M24 15c0 0 2 2 4 0M18 22h8M22 18v8"
-          stroke="#fff" stroke-width="1.5" fill="none" stroke-linecap="round" opacity="0.6"/>
-    <!-- Neural connections -->
-    <circle cx="19" cy="12" r="1.5" fill="#fff" opacity="0.8"/>
-    <circle cx="25" cy="12" r="1.5" fill="#fff" opacity="0.8"/>
-    <circle cx="22" cy="28" r="1.5" fill="#fff" opacity="0.8"/>
-  </g>
-
-  <!-- Text -->
-  <text x="52" y="38" font-family="'SF Pro Display', -apple-system, BlinkMacSystemFont, sans-serif" font-size="26" font-weight="600" fill="url(#textGrad)">
-    openclaw-mem
-  </text>
-</svg>

package/lib/context-builder.js

@@ -1,415 +0,0 @@
-/**
- * OpenClaw-Mem Context Builder
- * Generates context to inject into new sessions using progressive disclosure
- */
-
-import database from './database.js';
-
-// Token estimation (4 chars ≈ 1 token)
-const CHARS_PER_TOKEN = 4;
-
-function estimateTokens(text) {
-  if (!text) return 0;
-  return Math.ceil(String(text).length / CHARS_PER_TOKEN);
-}
-
-// Type emoji mapping
-const TYPE_EMOJI = {
-  'Edit': '📝',
-  'Write': '✏️',
-  'Read': '📖',
-  'Bash': '💻',
-  'Grep': '🔍',
-  'Glob': '📁',
-  'WebFetch': '🌐',
-  'WebSearch': '🔎',
-  'Task': '🤖',
-  'default': '🔵'
-};
-
-function getTypeEmoji(toolName) {
-  return TYPE_EMOJI[toolName] || TYPE_EMOJI.default;
-}
-
-// Format timestamp
-function formatTime(timestamp) {
-  if (!timestamp) return '';
-  const date = new Date(timestamp);
-  return date.toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit' });
-}
-
-function formatDate(timestamp) {
-  if (!timestamp) return '';
-  const date = new Date(timestamp);
-  return date.toISOString().split('T')[0];
-}
-
-// Filter out low-value observations (like recall test queries)
-function filterHighValueObservations(observations) {
-  const lowValuePatterns = [
-    '请查看 SESSION-MEMORY',
-    'SESSION-MEMORY.md 里没有',
-    '请查看 SESSION-MEMORY.md，告诉我',
-    '记忆检索当前不可用',
-    '/memory search',
-    '/memory get',
-    '之前没有记录到',
-    '没有任何关于'
-  ];
-
-  return observations.filter(obs => {
-    const summary = obs.summary || '';
-    // Always filter out observations matching low-value patterns
-    const isLowValue = lowValuePatterns.some(pattern => summary.includes(pattern));
-    if (isLowValue) return false;
-
-    // Keep observations that have actual content (not just metadata)
-    return true;
-  });
-}
-
-// Group observations by date
-function groupByDate(observations) {
-  const groups = {};
-  for (const obs of observations) {
-    const date = formatDate(obs.timestamp);
-    if (!groups[date]) {
-      groups[date] = [];
-    }
-    groups[date].push(obs);
-  }
-  return groups;
-}
-
-// Build index table (Layer 1 - compact)
-function buildIndexTable(observations) {
-  if (!observations || observations.length === 0) {
-    return '*(No recent observations)*';
-  }
-
-  const grouped = groupByDate(observations);
-  const lines = [];
-
-  for (const [date, obs] of Object.entries(grouped)) {
-    lines.push(`### ${date}`);
-    lines.push('');
-    lines.push('| ID | Time | T | Summary | Tokens |');
-    lines.push('|----|------|---|---------|--------|');
-
-    for (const o of obs) {
-      const id = `#${o.id}`;
-      const time = formatTime(o.timestamp);
-      const emoji = getTypeEmoji(o.tool_name);
-      const summary = o.summary || `${o.tool_name} operation`;
-      const truncSummary = summary.length > 50 ? summary.slice(0, 47) + '...' : summary;
-      const tokens = `~${o.tokens_read || estimateTokens(summary)}`;
-
-      lines.push(`| ${id} | ${time} | ${emoji} | ${truncSummary} | ${tokens} |`);
-    }
-    lines.push('');
-  }
-
-  return lines.join('\n');
-}
-
-// Build full details (Layer 3 - expensive)
-function buildFullDetails(observations, limit = 5) {
-  if (!observations || observations.length === 0) {
-    return '';
-  }
-
-  const toShow = observations.slice(0, limit);
-  const lines = [];
-
-  for (const o of toShow) {
-    lines.push(`#### #${o.id} - ${o.tool_name}`);
-    lines.push('');
-
-    if (o.summary) {
-      lines.push(`**Summary**: ${o.summary}`);
-      lines.push('');
-    }
-
-    // Show key facts from tool input
-    const input = o.tool_input || {};
-    const facts = [];
-
-    if (input.file_path) facts.push(`- File: \`${input.file_path}\``);
-    if (input.command) facts.push(`- Command: \`${input.command.slice(0, 100)}\``);
-    if (input.pattern) facts.push(`- Pattern: \`${input.pattern}\``);
-    if (input.query) facts.push(`- Query: ${input.query.slice(0, 100)}`);
-    if (input.url) facts.push(`- URL: ${input.url}`);
-
-    if (facts.length > 0) {
-      lines.push('**Details**:');
-      lines.push(...facts);
-      lines.push('');
-    }
-
-    lines.push('---');
-    lines.push('');
-  }
-
-  return lines.join('\n');
-}
-
-// Build token economics summary
-function buildTokenEconomics(observations) {
-  let totalDiscovery = 0;
-  let totalRead = 0;
-
-  for (const o of observations) {
-    totalDiscovery += o.tokens_discovery || 0;
-    totalRead += o.tokens_read || estimateTokens(o.summary || '');
-  }
-
-  const savings = totalDiscovery - totalRead;
-  const savingsPercent = totalDiscovery > 0 ? Math.round((savings / totalDiscovery) * 100) : 0;
-
-  if (totalDiscovery === 0) {
-    return `**Observations**: ${observations.length} | **Read cost**: ~${totalRead} tokens`;
-  }
-
-  return `**Discovery**: ${totalDiscovery} tokens | **Read**: ${totalRead} tokens | **Saved**: ${savings} (${savingsPercent}%)`;
-}
-
-// Build retrieval instructions
-function buildRetrievalInstructions() {
-  return `
----
-
-**Need more context?** Use these commands:
-- Search: \`/memory search <query>\`
-- Get details: \`/memory get <id>\`
-- Timeline: \`/memory timeline <id>\`
-`;
-}
-
-/**
- * Build topic summaries from user's actual recorded concepts
- * Dynamically extracts topics from what the user has discussed
- */
-function buildTopicSummaries() {
-  // Get all recent observations to extract actual concepts
-  const recentObs = database.getRecentObservations(null, 100);
-
-  // Extract and count concepts from user's actual data
-  const conceptCounts = {};
-  for (const obs of recentObs) {
-    if (obs.concepts) {
-      const concepts = obs.concepts.split(',').map(c => c.trim()).filter(c => c.length > 1);
-      for (const concept of concepts) {
-        // Skip generic tool names
-        if (['edit', 'bash', 'read', 'grep', 'write', 'glob'].includes(concept.toLowerCase())) continue;
-        conceptCounts[concept] = (conceptCounts[concept] || 0) + 1;
-      }
-    }
-  }
-
-  // Get top concepts (mentioned at least twice)
-  const topConcepts = Object.entries(conceptCounts)
-    .filter(([_, count]) => count >= 2)
-    .sort((a, b) => b[1] - a[1])
-    .slice(0, 10)
-    .map(([concept, _]) => concept);
-
-  if (topConcepts.length === 0) return '';
-
-  const sections = [];
-  const seenIds = new Set();
-
-  // Search for each top concept
-  for (const concept of topConcepts.slice(0, 5)) {
-    try {
-      const results = database.searchObservations(concept, 3);
-      const newResults = results.filter(r => !seenIds.has(r.id));
-
-      if (newResults.length > 0) {
-        sections.push(`### ${concept}`);
-        sections.push('');
-        for (const r of newResults.slice(0, 2)) {
-          seenIds.add(r.id);
-          const summary = r.summary || '';
-          if (summary.length > 20) {
-            sections.push(`- **#${r.id}**: ${summary.slice(0, 150)}${summary.length > 150 ? '...' : ''}`);
-          }
-        }
-        sections.push('');
-      }
-    } catch (e) {
-      // Search might fail, continue
-    }
-  }
-
-  if (sections.length > 0) {
-    return '## 历史话题讨论\n\n基于您的实际对话自动提取的主题：\n\n' + sections.join('\n');
-  }
-  return '';
-}
-
-/**
- * Build complete context for session injection
- */
-export function buildContext(projectPath, options = {}) {
-  const {
-    observationLimit = 50,
-    fullDetailCount = 5,
-    showTokenEconomics = true,
-    showRetrievalInstructions = true
-  } = options;
-
-  // Fetch recent observations and filter out low-value ones
-  const rawObservations = database.getRecentObservations(projectPath, observationLimit * 3); // Fetch more to compensate for filtering
-  const observations = filterHighValueObservations(rawObservations).slice(0, observationLimit);
-
-  if (observations.length === 0) {
-    return null; // No context to inject
-  }
-
-  // Fetch recent summaries
-  const summaries = database.getRecentSummaries(projectPath, 3);
-
-  // Build context parts
-  const parts = [];
-
-  // Header
-  parts.push('<openclaw-mem-context>');
-  parts.push('# Recent Activity');
-  parts.push('');
-
-  // Token economics
-  if (showTokenEconomics) {
-    parts.push(buildTokenEconomics(observations));
-    parts.push('');
-  }
-
-  // Topic summaries (from historical search)
-  const topicSummaries = buildTopicSummaries();
-  if (topicSummaries) {
-    parts.push(topicSummaries);
-    parts.push('');
-  }
-
-  // Index table (all observations, compact)
-  parts.push('## Index');
-  parts.push('');
-  parts.push(buildIndexTable(observations));
-
-  // Full details (top N)
-  if (fullDetailCount > 0) {
-    const details = buildFullDetails(observations, fullDetailCount);
-    if (details) {
-      parts.push('## Recent Details');
-      parts.push('');
-      parts.push(details);
-    }
-  }
-
-  // Session summaries
-  if (summaries.length > 0) {
-    parts.push('## Previous Sessions');
-    parts.push('');
-    for (const s of summaries) {
-      if (s.request) parts.push(`- **Goal**: ${s.request}`);
-      if (s.completed) parts.push(`- **Completed**: ${s.completed}`);
-      if (s.next_steps) parts.push(`- **Next**: ${s.next_steps}`);
-      parts.push('');
-    }
-  }
-
-  // Retrieval instructions
-  if (showRetrievalInstructions) {
-    parts.push(buildRetrievalInstructions());
-  }
-
-  parts.push('</openclaw-mem-context>');
-
-  return parts.join('\n');
-}
-
-/**
- * Search observations and return formatted results
- */
-export function searchContext(query, limit = 20) {
-  const results = database.searchObservations(query, limit);
-
-  if (results.length === 0) {
-    return `No observations found for query: "${query}"`;
-  }
-
-  const lines = [
-    `## Search Results for "${query}"`,
-    '',
-    '| ID | Tool | Summary | Date |',
-    '|----|------|---------|------|'
-  ];
-
-  for (const r of results) {
-    const summary = r.summary_highlight || r.summary || `${r.tool_name} operation`;
-    const truncSummary = summary.length > 60 ? summary.slice(0, 57) + '...' : summary;
-    const date = formatDate(r.timestamp);
-    lines.push(`| #${r.id} | ${r.tool_name} | ${truncSummary} | ${date} |`);
-  }
-
-  lines.push('');
-  lines.push(`*${results.length} results. Use \`/memory get <id>\` for full details.*`);
-
-  return lines.join('\n');
-}
-
-/**
- * Get full observation details by IDs
- */
-export function getObservationDetails(ids) {
-  const observations = database.getObservations(ids);
-
-  if (observations.length === 0) {
-    return `No observations found for IDs: ${ids.join(', ')}`;
-  }
-
-  return buildFullDetails(observations, observations.length);
-}
-
-/**
- * Get timeline around an observation
- */
-export function getTimeline(anchorId, depthBefore = 3, depthAfter = 2) {
-  const anchor = database.getObservation(anchorId);
-  if (!anchor) {
-    return `Observation #${anchorId} not found`;
-  }
-
-  // Get surrounding observations from same session
-  const allObs = database.getRecentObservations(null, 100);
-  const anchorIdx = allObs.findIndex(o => o.id === anchorId);
-
-  if (anchorIdx === -1) {
-    return buildFullDetails([anchor], 1);
-  }
-
-  const startIdx = Math.max(0, anchorIdx - depthAfter); // Note: list is DESC, so after = before in time
-  const endIdx = Math.min(allObs.length, anchorIdx + depthBefore + 1);
-  const timeline = allObs.slice(startIdx, endIdx).reverse();
-
-  const lines = [
-    `## Timeline around #${anchorId}`,
-    ''
-  ];
-
-  for (const o of timeline) {
-    const marker = o.id === anchorId ? '**→**' : '  ';
-    const time = formatTime(o.timestamp);
-    const emoji = getTypeEmoji(o.tool_name);
-    const summary = o.summary || `${o.tool_name} operation`;
-    lines.push(`${marker} ${time} ${emoji} #${o.id}: ${summary}`);
-  }
-
-  return lines.join('\n');
-}
-
-export default {
-  buildContext,
-  searchContext,
-  getObservationDetails,
-  getTimeline
-};