create_memory_relationship
Link two memories in an AI system by establishing causal, temporal, semantic, emotional, strategic, or consolidation relationships to enable memory continuity and contextual understanding.
Instructions
Create a relationship between two memories
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from_memory_id | Yes | UUID of the source memory | |
| to_memory_id | Yes | UUID of the target memory | |
| relationship_type | Yes | Type of relationship | |
| properties | No | Additional properties for the relationship |
Implementation Reference
- src/memory-manager.js:609-626 (handler)Core handler function that executes the tool logic: inserts a new memory relationship record into the memoryRelationships table using Drizzle ORM.async createMemoryRelationship(fromMemoryId, toMemoryId, relationshipType, properties = {}) { try { const [relationship] = await this.db .insert(schema.memoryRelationships) .values({ fromMemoryId, toMemoryId, relationshipType, properties }) .returning(); return relationship; } catch (error) { console.warn('Memory relationships table not available:', error.message); return null; } }
- mcp.js:601-608 (handler)MCP CallToolRequest dispatch handler that extracts arguments and calls the core memoryManager.createMemoryRelationship function, returning JSON result.case "create_memory_relationship": const relationship = await memoryManager.createMemoryRelationship( args.from_memory_id, args.to_memory_id, args.relationship_type, args.properties || {} ); return { content: [{ type: "text", text: JSON.stringify(relationship, null, 2) }] };
- mcp.js:221-247 (schema)Input schema definition for the tool, used in MCP ListToolsRequestHandler to describe parameters and validation.name: "create_memory_relationship", description: "Create a relationship between two memories", inputSchema: { type: "object", properties: { from_memory_id: { type: "string", description: "UUID of the source memory" }, to_memory_id: { type: "string", description: "UUID of the target memory" }, relationship_type: { type: "string", enum: ["causal", "temporal", "semantic", "emotional", "strategic", "consolidation"], description: "Type of relationship" }, properties: { type: "object", description: "Additional properties for the relationship", default: {} } }, required: ["from_memory_id", "to_memory_id", "relationship_type"] } },
- src/tools/memory-tools.js:195-221 (schema)Input schema definition in memoryTools export array (reference or source schema matching the one used in mcp.js).name: "create_memory_relationship", description: "Create a relationship between two memories", inputSchema: { type: "object", properties: { from_memory_id: { type: "string", description: "UUID of the source memory" }, to_memory_id: { type: "string", description: "UUID of the target memory" }, relationship_type: { type: "string", enum: ["causal", "temporal", "semantic", "emotional", "strategic", "consolidation"], description: "Type of relationship" }, properties: { type: "object", description: "Additional properties for the relationship", default: {} } }, required: ["from_memory_id", "to_memory_id", "relationship_type"] } },