graphiti/core/edges.py

from abc import ABC, abstractmethod
from pydantic import BaseModel, Field
from datetime import datetime
from neo4j import AsyncDriver
from uuid import uuid4
import logging

from core.nodes import Node

logger = logging.getLogger(__name__)


class Edge(BaseModel, ABC):
    uuid: str = Field(default_factory=lambda: str(uuid4()))
    source_node: Node
    target_node: Node
    created_at: datetime

    @abstractmethod
    async def save(self, driver: AsyncDriver): ...


class EpisodicEdge(Edge):
    async def save(self, driver: AsyncDriver):
        if self.uuid is None:
            uuid = uuid4()
            logger.info(f"Created uuid: {uuid} for episodic edge")
            self.uuid = str(uuid)

        result = await driver.execute_query(
            """
        MATCH (episode:Episodic {uuid: $episode_uuid}) 
        MATCH (node:Entity {uuid: $entity_uuid}) 
        MERGE (episode)-[r:MENTIONS {uuid: $uuid}]->(node)
        SET r = {uuid: $uuid, created_at: $created_at}
        RETURN r.uuid AS uuid""",
            episode_uuid=self.source_node.uuid,
            entity_uuid=self.target_node.uuid,
            uuid=self.uuid,
            created_at=self.created_at,
        )

        logger.info(f"Saved edge to neo4j: {self.uuid}")

        return result


# TODO: Neo4j doesn't support variables for edge types and labels.
#  Right now we have all edge nodes as type RELATES_TO


class EntityEdge(Edge):
    name: str = Field(description="name of the edge, relation name")
    fact: str = Field(
        description="fact representing the edge and nodes that it connects"
    )
    fact_embedding: list[float] | None = Field(
        default=None, description="embedding of the fact"
    )
    episodes: list[str] | None = Field(
        default=None, description="list of episode ids that reference these entity edges"
    )
    expired_at: datetime | None = Field(
        default=None, description="datetime of when the node was invalidated"
    )
    valid_at: datetime | None = Field(
        default=None, description="datetime of when the fact became true"
    )
    invalid_at: datetime | None = Field(
        default=None, description="datetime of when the fact stopped being true"
    )

    def generate_embedding(self, embedder, model="text-embedding-3-large"):
        text = self.fact.replace("\n", " ")
        embedding = embedder.create(input=[text], model=model).data[0].embedding
        self.fact_embedding = embedding

        return embedding

    async def save(self, driver: AsyncDriver):
        result = await driver.execute_query(

            """
        MATCH (source:Entity {uuid: $source_uuid}) 
        MATCH (target:Entity {uuid: $target_uuid}) 
        MERGE (source)-[r:RELATES_TO {uuid: $uuid}]->(target)
        SET r = {uuid: $uuid, name: $name, fact: $fact, fact_embedding: $fact_embedding, 
        episodes: $episodes, created_at: $created_at, expired_at: $expired_at, 
        valid_at: $valid_at, invalid_at: $invalid_at}
        RETURN r.uuid AS uuid""",
            source_uuid=self.source_node.uuid,
            target_uuid=self.target_node.uuid,
            uuid=self.uuid,
            name=self.name,
            fact=self.fact,
            fact_embedding=self.fact_embedding,
            episodes=self.episodes,
            created_at=self.created_at,
            expired_at=self.expired_at,
            valid_at=self.valid_at,
            invalid_at=self.invalid_at,
        )

        logger.info(f"Saved Node to neo4j: {self.uuid}")

        return result