create_memento_relationship
Link two mementos with typed relationships like SOLVES, CAUSES, or ADDRESSES to map connections between problems, solutions, causes, and effects in a knowledge base.
Instructions
Link two mementos with a typed relationship.
Common types: SOLVES (solution→problem), CAUSES (cause→effect), ADDRESSES (fix→error), REQUIRES (dependent→dependency), RELATED_TO (general)
EXAMPLES:
create_memento_relationship(from_memory_id="sol-1", to_memory_id="prob-1", relationship_type="SOLVES")
create_memento_relationship(from_memory_id="err-1", to_memory_id="fix-1", relationship_type="CAUSES", context="Config error caused timeout")
Optional: strength (0-1), confidence (0-1), context (description)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from_memory_id | Yes | ID of the source memory | |
| to_memory_id | Yes | ID of the target memory | |
| relationship_type | Yes | Type of relationship to create | |
| strength | No | Strength of the relationship (0.0-1.0) | |
| confidence | No | Confidence in the relationship (0.0-1.0) | |
| context | No | Context or description of the relationship |
Implementation Reference
- The handler function `handle_create_memento_relationship` that executes the logic for the "create_memento_relationship" MCP tool. It validates inputs, extracts context, and calls the database to create the relationship.
async def handle_create_memento_relationship( memory_db: SQLiteMemoryDatabase, arguments: Dict[str, Any] ) -> CallToolResult: """Handle create_relationship tool call. Args: memory_db: Database instance for memory operations arguments: Tool arguments from MCP call containing: - from_memory_id: ID of source memory - to_memory_id: ID of target memory - relationship_type: Type of relationship (SOLVES, CAUSES, etc.) - strength: Optional relationship strength (0.0-1.0, default: 0.5) - confidence: Optional confidence score (0.0-1.0, default: 0.8) - context: Optional natural language description Returns: CallToolResult with relationship ID on success or error message on failure """ # Validate input arguments validate_relationship_input(arguments) # Get user-provided context (natural language) user_context = arguments.get("context") # Auto-extract structure if context provided structured_context = None if user_context: from ..utils.context_extractor import extract_context_structure structure = extract_context_structure(user_context) structured_context = json.dumps(structure) # Serialize to JSON string properties = RelationshipProperties( strength=arguments.get("strength", 0.5), confidence=arguments.get("confidence", 0.8), context=structured_context, # Store JSON string ) relationship_id = await memory_db.create_relationship( from_memory_id=arguments["from_memory_id"], to_memory_id=arguments["to_memory_id"], relationship_type=RelationshipType(arguments["relationship_type"]), properties=properties, ) return CallToolResult( content=[ TextContent( type="text", text=f"Relationship created successfully: {relationship_id}", ) ] )