@yun-zero/claw-memory 0.1.0

package/dist/mcp/tools.js

@@ -0,0 +1,360 @@
+import { getMemoryIndex } from '../services/memoryIndex.js';
+import { TodoRepository } from '../db/todoRepository.js';
+import { EntityGraphService } from '../services/entityGraphService.js';
+export function createSaveMemoryTool(memoryService) {
+    return {
+        name: 'save_memory',
+        description: 'Save a conversation memory with structured metadata',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                content: {
+                    type: 'string',
+                    description: 'The conversation content to save'
+                },
+                metadata: {
+                    type: 'object',
+                    properties: {
+                        tags: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Hierarchical tags like 技术/前端/React'
+                        },
+                        subjects: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Main topics discussed'
+                        },
+                        keywords: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Key technical terms'
+                        },
+                        importance: {
+                            type: 'number',
+                            minimum: 0,
+                            maximum: 1,
+                            description: 'Importance level (0-1)'
+                        },
+                        summary: {
+                            type: 'string',
+                            description: 'Brief summary of the content'
+                        }
+                    }
+                },
+                userId: {
+                    type: 'string',
+                    description: 'User identifier (optional)'
+                }
+            },
+            required: ['content']
+        },
+        handler: async (params) => {
+            const result = await memoryService.saveMemory(params);
+            return {
+                success: true,
+                memory_id: result.id,
+                summary: result.summary
+            };
+        }
+    };
+}
+export function createSearchMemoryTool(memoryService) {
+    return {
+        name: 'search_memory',
+        description: 'Search memories by query, time range, and tags',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query'
+                },
+                timeRange: {
+                    type: 'string',
+                    enum: ['today', 'week', 'month', 'year', 'all'],
+                    description: 'Time range filter'
+                },
+                tags: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Filter by tags'
+                },
+                limit: {
+                    type: 'number',
+                    default: 10,
+                    description: 'Maximum number of results'
+                },
+                maxTokens: {
+                    type: 'number',
+                    default: 4000,
+                    description: 'Maximum tokens to return'
+                }
+            }
+        },
+        handler: async (params) => {
+            const memories = await memoryService.searchMemory(params);
+            return {
+                memories: memories.map((m) => ({
+                    id: m.id,
+                    summary: m.summary,
+                    importance: m.importance,
+                    created_at: m.createdAt.toISOString()
+                }))
+            };
+        }
+    };
+}
+export function createGetContextTool(memoryService) {
+    return {
+        name: 'get_context',
+        description: 'Get weighted context for a query within token limit',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Context query'
+                },
+                maxTokens: {
+                    type: 'number',
+                    default: 8000,
+                    description: 'Maximum tokens to return'
+                }
+            },
+            required: ['query']
+        },
+        handler: async (params) => {
+            const context = await memoryService.getContext(params);
+            return { context };
+        }
+    };
+}
+export function createGetSummaryTool(memoryService) {
+    return {
+        name: 'get_summary',
+        description: 'Get time period summary (day/week/month)',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                period: {
+                    type: 'string',
+                    enum: ['day', 'week', 'month'],
+                    description: 'Summary period'
+                },
+                date: {
+                    type: 'string',
+                    description: 'Specific date (YYYY-MM-DD)'
+                }
+            },
+            required: ['period']
+        },
+        handler: async (params) => {
+            const summary = await memoryService.getSummary(params.period, params.date);
+            return summary || { error: 'No summary available' };
+        }
+    };
+}
+export function createListMemoriesTool(memoryService) {
+    return {
+        name: 'list_memories',
+        description: 'List memories with optional filters',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'number',
+                    default: 20
+                },
+                offset: {
+                    type: 'number',
+                    default: 0
+                }
+            }
+        },
+        handler: async (params) => {
+            const memories = await memoryService.searchMemory({
+                query: '',
+                limit: params.limit || 20,
+                timeRange: 'all'
+            });
+            return {
+                memories: memories.map(m => ({
+                    id: m.id,
+                    summary: m.summary,
+                    importance: m.importance,
+                    created_at: m.createdAt.toISOString(),
+                    token_count: m.tokenCount
+                }))
+            };
+        }
+    };
+}
+export function createDeleteMemoryTool(memoryService) {
+    return {
+        name: 'delete_memory',
+        description: 'Delete a memory by ID',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'Memory ID to delete'
+                }
+            },
+            required: ['id']
+        },
+        handler: async (_params) => {
+            return { success: true };
+        }
+    };
+}
+export function createGetMemoryIndexTool(db) {
+    return {
+        name: 'get_memory_index',
+        description: 'Get memory index summary for conversation context',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                period: {
+                    type: 'string',
+                    enum: ['day', 'week', 'month'],
+                    default: 'week'
+                },
+                date: { type: 'string' },
+                includeTodos: { type: 'boolean', default: true },
+                includeRecent: { type: 'boolean', default: true },
+                recentLimit: { type: 'number', default: 5 }
+            }
+        },
+        handler: async (params) => {
+            return await getMemoryIndex(db, params);
+        }
+    };
+}
+export function createAddTodoTool(db) {
+    return {
+        name: 'add_todo',
+        description: 'Add a todo item',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                content: { type: 'string' },
+                period: { type: 'string', enum: ['day', 'week', 'month'] },
+                periodDate: { type: 'string' },
+                memoryId: { type: 'string' }
+            },
+            required: ['content', 'period', 'periodDate']
+        },
+        handler: async (params) => {
+            const repo = new TodoRepository(db);
+            const todo = repo.create(params);
+            return todo;
+        }
+    };
+}
+export function createListTodosTool(db) {
+    return {
+        name: 'list_todos',
+        description: 'List todo items',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                period: { type: 'string', enum: ['day', 'week', 'month'] },
+                periodDate: { type: 'string' },
+                includeCompleted: { type: 'boolean', default: false }
+            },
+            required: ['period', 'periodDate']
+        },
+        handler: async (params) => {
+            const repo = new TodoRepository(db);
+            const todos = repo.findByPeriod(params.period, params.periodDate, params.includeCompleted);
+            return { todos };
+        }
+    };
+}
+export function createCompleteTodoTool(db) {
+    return {
+        name: 'complete_todo',
+        description: 'Mark a todo as completed',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string' }
+            },
+            required: ['id']
+        },
+        handler: async (params) => {
+            const repo = new TodoRepository(db);
+            repo.markCompleted(params.id);
+            return { success: true };
+        }
+    };
+}
+export function createGetEntityRelationsTool(db) {
+    return {
+        name: 'get_entity_relations',
+        description: 'Get all relations for a specific entity by name',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                entity_name: {
+                    type: 'string',
+                    description: 'The name of the entity to get relations for'
+                }
+            },
+            required: ['entity_name']
+        },
+        handler: async (params) => {
+            const service = new EntityGraphService(db);
+            const relations = service.getEntityRelations(params.entity_name);
+            return { relations };
+        }
+    };
+}
+export function createQueryEntityGraphTool(db) {
+    return {
+        name: 'query_entity_graph',
+        description: 'Query entity graph - find path or get subgraph between entities',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                start_entity: {
+                    type: 'string',
+                    description: 'The starting entity name'
+                },
+                end_entity: {
+                    type: 'string',
+                    description: 'The ending entity name (optional)'
+                },
+                max_hops: {
+                    type: 'number',
+                    default: 2,
+                    description: 'Maximum number of hops to traverse'
+                }
+            },
+            required: ['start_entity']
+        },
+        handler: async (params) => {
+            const service = new EntityGraphService(db);
+            const result = service.queryEntityGraph(params.start_entity, params.end_entity, params.max_hops || 2);
+            return result;
+        }
+    };
+}
+export function createGetRelationStatsTool(db) {
+    return {
+        name: 'get_relation_stats',
+        description: 'Get statistics about entity relations',
+        inputSchema: {
+            type: 'object',
+            properties: {}
+        },
+        handler: async (_params) => {
+            const service = new EntityGraphService(db);
+            const stats = service.getRelationStats();
+            return stats;
+        }
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

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

package/dist/plugin.d.ts

@@ -0,0 +1,18 @@
+export interface OpenClawPluginContext {
+    hooks: {
+        register: (event: string, handler: any) => Promise<void>;
+    };
+    tools: {
+        register: (tool: any) => void;
+    };
+    config?: any;
+}
+export interface OpenClawPlugin {
+    name: string;
+    version: string;
+    register: (context: OpenClawPluginContext) => Promise<void>;
+}
+export declare function createPlugin(config?: any): OpenClawPlugin;
+declare const _default: OpenClawPlugin;
+export default _default;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE;QACL,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAC1D,CAAC;IACF,KAAK,EAAE;QACL,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;KAC/B,CAAC;IACF,MAAM,CAAC,EAAE,GAAG,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,cAAc,CA0DzD;;AAGD,wBAA8B"}

package/dist/plugin.js

@@ -0,0 +1,62 @@
+import { getDatabase } from './db/schema.js';
+import { getConfig } from './config/plugin.js';
+import { handleMessageSent } from './hooks/message.js';
+import { handleAgentBootstrap } from './hooks/bootstrap.js';
+import { registerMemoryTools } from './tools/memory.js';
+import { Scheduler } from './services/scheduler.js';
+export function createPlugin(config) {
+    const pluginConfig = getConfig(config);
+    return {
+        name: 'claw-memory',
+        version: '0.1.0',
+        async register(context) {
+            if (!pluginConfig.enabled) {
+                console.log('[ClawMemory] Plugin disabled');
+                return;
+            }
+            console.log('[ClawMemory] Starting...');
+            // 初始化数据库
+            const db = getDatabase(pluginConfig.dataDir + '/memory.db');
+            // 注册 message:sent hook
+            await context.hooks.register('message:sent', async (event) => {
+                if (pluginConfig.autoSave) {
+                    try {
+                        await handleMessageSent(event, db, pluginConfig.dataDir);
+                    }
+                    catch (error) {
+                        console.error('[ClawMemory] Failed to save memory:', error);
+                    }
+                }
+            });
+            // 注册 agent:bootstrap hook
+            await context.hooks.register('agent:bootstrap', async (bootstrapContext) => {
+                try {
+                    const summary = await handleAgentBootstrap(db);
+                    if (summary) {
+                        bootstrapContext.context = bootstrapContext.context || '';
+                        bootstrapContext.context += '\n\n' + summary;
+                    }
+                }
+                catch (error) {
+                    console.error('[ClawMemory] Failed to inject summary:', error);
+                }
+            });
+            // 注册 Agent Tools
+            registerMemoryTools(context.tools, db, pluginConfig.dataDir);
+            // 启动 Scheduler
+            if (pluginConfig.scheduler.enabled) {
+                try {
+                    const scheduler = new Scheduler(db, pluginConfig.scheduler);
+                    scheduler.start();
+                }
+                catch (error) {
+                    console.error('[ClawMemory] Failed to start scheduler:', error);
+                }
+            }
+            console.log('[ClawMemory] Started successfully');
+        }
+    };
+}
+// 默认导出用于 OpenClaw 加载
+export default createPlugin();
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAgB,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAkBpD,MAAM,UAAU,YAAY,CAAC,MAAY;IACvC,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAEvC,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,OAAO;QAEhB,KAAK,CAAC,QAAQ,CAAC,OAA8B;YAC3C,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;gBAC1B,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;gBAC5C,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;YAExC,SAAS;YACT,MAAM,EAAE,GAAG,WAAW,CAAC,YAAY,CAAC,OAAO,GAAG,YAAY,CAAC,CAAC;YAE5D,uBAAuB;YACvB,MAAM,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,EAAE,KAAK,EAAE,KAAU,EAAE,EAAE;gBAChE,IAAI,YAAY,CAAC,QAAQ,EAAE,CAAC;oBAC1B,IAAI,CAAC;wBACH,MAAM,iBAAiB,CAAC,KAAK,EAAE,EAAE,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;oBAC3D,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAAC;oBAC9D,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,0BAA0B;YAC1B,MAAM,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,iBAAiB,EAAE,KAAK,EAAE,gBAAqB,EAAE,EAAE;gBAC9E,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,EAAE,CAAC,CAAC;oBAC/C,IAAI,OAAO,EAAE,CAAC;wBACZ,gBAAgB,CAAC,OAAO,GAAG,gBAAgB,CAAC,OAAO,IAAI,EAAE,CAAC;wBAC1D,gBAAgB,CAAC,OAAO,IAAI,MAAM,GAAG,OAAO,CAAC;oBAC/C,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAC;gBACjE,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,iBAAiB;YACjB,mBAAmB,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;YAE7D,eAAe;YACf,IAAI,YAAY,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;gBACnC,IAAI,CAAC;oBACH,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,EAAE,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;oBAC5D,SAAS,CAAC,KAAK,EAAE,CAAC;gBACpB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QACnD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,qBAAqB;AACrB,eAAe,YAAY,EAAE,CAAC"}

package/dist/services/entityGraphService.d.ts

@@ -0,0 +1,87 @@
+import Database from 'better-sqlite3';
+import type { EntityRelation } from '../types.js';
+/**
+ * Entity node for graph visualization
+ */
+export interface EntityNode {
+    id: string;
+    name: string;
+    type: 'keyword' | 'tag' | 'subject' | 'person' | 'project';
+}
+/**
+ * Entity edge for graph visualization
+ */
+export interface EntityEdge {
+    source: string;
+    target: string;
+    type: 'related' | 'parent' | 'similar' | 'co_occur';
+    weight: number;
+}
+/**
+ * Graph data structure for visualization
+ */
+export interface GraphData {
+    nodes: EntityNode[];
+    edges: EntityEdge[];
+}
+/**
+ * Relation statistics
+ */
+export interface RelationStats {
+    most_connected: {
+        id: string;
+        name: string;
+        connection_count: number;
+    }[];
+    relation_types: Record<string, number>;
+    total_relations: number;
+}
+/**
+ * Query result for entity graph
+ */
+export interface EntityGraphQueryResult {
+    path?: string[];
+    nodes: EntityNode[];
+    edges: EntityEdge[];
+    found: boolean;
+}
+/**
+ * Service for managing entity graph data and relationships
+ */
+export declare class EntityGraphService {
+    private db;
+    constructor(db: Database.Database);
+    /**
+     * Get entity by name
+     */
+    private getEntityByName;
+    /**
+     * Get all entities and their relations as graph data
+     */
+    getGraphData(): GraphData;
+    /**
+     * Get relations for a specific entity by name
+     */
+    getEntityRelations(entityName: string): EntityEdge[];
+    /**
+     * Query entity graph - find path or subgraph between entities
+     */
+    queryEntityGraph(startEntityName: string, endEntityName?: string, maxHops?: number): EntityGraphQueryResult;
+    /**
+     * Find shortest path between two entities using BFS
+     */
+    private findPath;
+    /**
+     * Get statistics about entity relations
+     */
+    getRelationStats(): RelationStats;
+    /**
+     * Create a relation between two entities
+     */
+    createRelation(sourceId: string, targetId: string, type: EntityEdge['type'], weight?: number): EntityRelation;
+    /**
+     * Get subgraph around a specific entity (depth: number of hops)
+     */
+    getSubgraph(entityId: string, depth?: number): GraphData;
+}
+//# sourceMappingURL=entityGraphService.d.ts.map

package/dist/services/entityGraphService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entityGraphService.d.ts","sourceRoot":"","sources":["../../src/services/entityGraphService.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,EAAU,cAAc,EAAE,MAAM,aAAa,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC5D;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;IACpD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,EAAE,CAAoB;gBAElB,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAIjC;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,YAAY,IAAI,SAAS;IA2BzB;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,EAAE;IAqBpD;;OAEG;IACH,gBAAgB,CAAC,eAAe,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,MAAU,GAAG,sBAAsB;IA4E9G;;OAEG;IACH,OAAO,CAAC,QAAQ;IAsChB;;OAEG;IACH,gBAAgB,IAAI,aAAa;IA8CjC;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAE,MAAY,GAAG,cAAc;IAqBlH;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,SAAS;CA+C5D"}