@yun-zero/claw-memory 0.1.0

package/dist/tools/memory.js

@@ -0,0 +1,114 @@
+import { v4 as uuidv4 } from 'uuid';
+import * as path from 'path';
+import * as fs from 'fs';
+import { homedir } from 'os';
+export function registerMemoryTools(tools, db, dataDir) {
+    // 解析 dataDir 中的 ~
+    const resolvedDataDir = dataDir.replace(/^~/, homedir());
+    // memory_save tool
+    tools.register({
+        name: 'memory_save',
+        description: 'Save conversation to memory with metadata',
+        schema: {
+            type: 'object',
+            properties: {
+                content: { type: 'string', description: 'Conversation content' },
+                metadata: {
+                    type: 'object',
+                    properties: {
+                        tags: { type: 'array', items: { type: 'string' } },
+                        keywords: { type: 'array', items: { type: 'string' } },
+                        importance: { type: 'number', minimum: 0, maximum: 1 }
+                    }
+                }
+            },
+            required: ['content']
+        },
+        handler: async (params) => {
+            const { content, metadata = {} } = params;
+            const memoryId = uuidv4();
+            const memoriesDir = path.join(resolvedDataDir, 'memories');
+            if (!fs.existsSync(memoriesDir)) {
+                fs.mkdirSync(memoriesDir, { recursive: true });
+            }
+            const contentPath = path.join(memoriesDir, `${memoryId}.md`);
+            fs.writeFileSync(contentPath, content, 'utf-8');
+            db.prepare(`
+        INSERT INTO memories (id, content_path, summary, importance, created_at)
+        VALUES (?, ?, ?, ?, datetime('now'))
+      `).run(memoryId, contentPath, metadata.summary || content.substring(0, 200), metadata.importance || 0.5);
+            return { success: true, memory_id: memoryId };
+        }
+    });
+    // memory_search tool
+    tools.register({
+        name: 'memory_search',
+        description: 'Search memories by query',
+        schema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string' },
+                limit: { type: 'number', default: 10 }
+            },
+            required: ['query']
+        },
+        handler: async (params) => {
+            const { query, limit = 10 } = params;
+            const memories = db.prepare(`
+        SELECT id, summary, importance, created_at
+        FROM memories
+        WHERE summary LIKE ?
+        ORDER BY importance DESC
+        LIMIT ?
+      `).all(`%${query}%`, limit);
+            return { memories };
+        }
+    });
+    // memory_summary tool
+    tools.register({
+        name: 'memory_summary',
+        description: 'Get memory summary for time period',
+        schema: {
+            type: 'object',
+            properties: {
+                period: { type: 'string', enum: ['day', 'week', 'month'] },
+                date: { type: 'string' }
+            },
+            required: ['period']
+        },
+        handler: async (params) => {
+            const { period } = params;
+            const today = new Date();
+            let startDate;
+            switch (period) {
+                case 'day':
+                    startDate = today;
+                    break;
+                case 'week':
+                    startDate = new Date(today);
+                    startDate.setDate(today.getDate() - today.getDay());
+                    break;
+                case 'month':
+                    startDate = new Date(today.getFullYear(), today.getMonth(), 1);
+                    break;
+                default:
+                    startDate = today;
+            }
+            const startDateStr = startDate.toISOString().split('T')[0];
+            const memories = db.prepare(`
+        SELECT summary, importance, created_at
+        FROM memories
+        WHERE date(created_at) >= date(?)
+        ORDER BY importance DESC
+        LIMIT 20
+      `).all(startDateStr);
+            const count = Array.isArray(memories) ? memories.length : 0;
+            return {
+                period,
+                count,
+                memories: Array.isArray(memories) ? memories.slice(0, 10) : []
+            };
+        }
+    });
+}
+//# sourceMappingURL=memory.js.map

package/dist/tools/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/tools/memory.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Claw-Memory Type Definitions
+ * Lightweight AI memory system for OpenClaw and Claude Code
+ */
+export interface IntegratedSummary {
+    active_areas: string[];
+    key_topics: string[];
+    recent_summary: string;
+}
+export interface Memory {
+    id: string;
+    contentPath: string;
+    summary: string | null;
+    integratedSummary: IntegratedSummary | null;
+    createdAt: Date;
+    updatedAt: Date;
+    tokenCount: number;
+    importance: number;
+    accessCount: number;
+    lastAccessedAt: Date | null;
+    isArchived: boolean;
+    isDuplicate: boolean;
+    duplicateOf: string | null;
+}
+export interface Entity {
+    id: string;
+    name: string;
+    type: 'keyword' | 'tag' | 'subject' | 'person' | 'project';
+    parentId: string | null;
+    level: number;
+    embedding: Buffer | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: Date;
+}
+export interface MemoryEntity {
+    memoryId: string;
+    entityId: string;
+    relevance: number;
+    source: 'auto' | 'manual';
+    createdAt: Date;
+}
+export interface EntityRelation {
+    id: string;
+    sourceId: string;
+    targetId: string;
+    relationType: 'related' | 'parent' | 'similar' | 'co_occur';
+    weight: number;
+    evidenceCount: number;
+    createdAt: Date;
+}
+export interface TimeBucket {
+    date: string;
+    memoryCount: number;
+    summary: string | null;
+    summaryGeneratedAt: Date | null;
+    keyTopics: string[] | null;
+    createdAt: Date;
+}
+export interface SaveMemoryInput {
+    content: string;
+    metadata: {
+        tags?: string[];
+        subjects?: string[];
+        keywords?: string[];
+        importance?: number;
+        summary?: string;
+    };
+    userId?: string;
+}
+export interface SearchMemoryInput {
+    query: string;
+    timeRange?: 'today' | 'week' | 'month' | 'year' | 'all';
+    tags?: string[];
+    limit?: number;
+    maxTokens?: number;
+}
+export interface GetContextInput {
+    query: string;
+    maxTokens?: number;
+}
+export interface GetSummaryInput {
+    period: 'day' | 'week' | 'month';
+    date?: string;
+}
+export interface WeeklyReport {
+    period: {
+        start: string;
+        end: string;
+    };
+    basic: {
+        totalMemories: number;
+        totalTokens: number;
+        avgImportance: number;
+    };
+    tags: {
+        topTags: {
+            name: string;
+            count: number;
+        }[];
+        tagDistribution: Record<string, number>;
+    };
+    topics: {
+        keywords: {
+            word: string;
+            count: number;
+        }[];
+        keyTopics: string[];
+    };
+    importance: {
+        highPriority: Pick<Memory, 'id' | 'summary' | 'importance'>[];
+        mediumPriority: Pick<Memory, 'id' | 'summary' | 'importance'>[];
+        lowPriority: Pick<Memory, 'id' | 'summary' | 'importance'>[];
+    };
+    access: {
+        mostAccessed: Pick<Memory, 'id' | 'summary' | 'accessCount'>[];
+        recentlyCreated: Pick<Memory, 'id' | 'summary' | 'createdAt'>[];
+        recentlyAccessed: Pick<Memory, 'id' | 'summary' | 'lastAccessedAt'>[];
+    };
+    entities: {
+        relatedGroups: {
+            entity: string;
+            related: string[];
+        }[];
+        coOccurringTags: [string, string][];
+    };
+    summary: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Claw-Memory Type Definitions
+ * Lightweight AI memory system for OpenClaw and Claude Code
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}