Class Neo4jKnowledgeGraph

Interface for the Knowledge Graph system

Implements

IKnowledgeGraph

Constructors

constructor

new Neo4jKnowledgeGraph(config): Neo4jKnowledgeGraph
Parameters
- config: Neo4jKnowledgeGraphConfig
Returns Neo4jKnowledgeGraph
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:102

Methods

initialize

initialize(): Promise<void>
Initialize the knowledge graph

Returns Promise<void>
Implementation of IKnowledgeGraph.initialize
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:108

upsertEntity

upsertEntity(entity): Promise<KnowledgeEntity>
Add or update an entity
Parameters
- entity: Omit<KnowledgeEntity, "updatedAt" | "createdAt" | "id"> & {
  id?: string;
  }
Returns Promise<KnowledgeEntity>
Implementation of IKnowledgeGraph.upsertEntity
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:144

getEntity

getEntity(id): Promise<undefined | KnowledgeEntity>
Get entity by ID
Parameters
- id: string
Returns Promise<undefined | KnowledgeEntity>
Implementation of IKnowledgeGraph.getEntity
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:194

queryEntities

queryEntities(options?): Promise<KnowledgeEntity[]>
Query entities
Parameters
- Optional options: KnowledgeQueryOptions
Returns Promise<KnowledgeEntity[]>
Implementation of IKnowledgeGraph.queryEntities
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:203

deleteEntity

deleteEntity(id): Promise<boolean>
Delete an entity and its relations
Parameters
- id: string
Returns Promise<boolean>
Implementation of IKnowledgeGraph.deleteEntity
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:247

upsertRelation

upsertRelation(relation): Promise<KnowledgeRelation>
Add or update a relation
Parameters
- relation: Omit<KnowledgeRelation, "createdAt" | "id"> & {
  id?: string;
  }
Returns Promise<KnowledgeRelation>
Implementation of IKnowledgeGraph.upsertRelation
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:259

getRelations

getRelations(entityId, options?): Promise<KnowledgeRelation[]>
Get relations for an entity
Parameters
- entityId: string
- Optional options: {
  direction?: "both" | "outgoing" | "incoming";
  types?: RelationType[];
  }
  - Optional direction?: "both" | "outgoing" | "incoming"
  - Optional types?: RelationType[]
Returns Promise<KnowledgeRelation[]>
Implementation of IKnowledgeGraph.getRelations
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:315

deleteRelation

deleteRelation(id): Promise<boolean>
Delete a relation
Parameters
- id: string
Returns Promise<boolean>
Implementation of IKnowledgeGraph.deleteRelation
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:351

recordMemory

recordMemory(memory): Promise<EpisodicMemory>
Record an episodic memory. A memory trace's copy (a context that names the trace, memoryTraceId) carries the trace id (traceId, indexed) and replaces the copy recorded for the trace before.
Parameters
- memory: Omit<EpisodicMemory, "createdAt" | "id" | "accessCount" | "lastAccessedAt">
Returns Promise<EpisodicMemory>
Implementation of IKnowledgeGraph.recordMemory
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:367

getMemory

getMemory(id): Promise<undefined | EpisodicMemory>
Get memory by ID
Parameters
- id: string
Returns Promise<undefined | EpisodicMemory>
Implementation of IKnowledgeGraph.getMemory
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:438

deleteMemories

deleteMemories(filter): Promise<number>
Delete the episodic memories that copy the filter's traces or scopes. A trace's copies are read through their trace id (traceId, indexed); the first delete by trace id of this graph first gives the copies an older release recorded their trace id (backfillCopyTraceIds). While that pass fails, a delete by trace id also reads the copies that carry no trace id by the text their stored context JSON must hold ("memoryTraceId":"<id>") and matches them exactly in code. A scope's copies are read by the text their stored context JSON must hold (CONTAINS) and matched exactly in code, so a malformed context_json is skipped rather than failing the delete.
Parameters
- filter: MemoryCopyFilter
Returns Promise<number>
Implementation of IKnowledgeGraph.deleteMemories
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:464

queryMemories

queryMemories(options?): Promise<EpisodicMemory[]>
Query episodic memories
Parameters
- Optional options: {
      types?: ("error" | "success" | "discovery" | "conversation" | "task" | "interaction")[];
      participants?: string[];
      minImportance?: number;
      timeRange?: {
          from?: string;
          to?: string;
      };
      limit?: number;
  }
  - Optional types?: ("error" | "success" | "discovery" | "conversation" | "task" | "interaction")[]
  - Optional participants?: string[]
  - Optional minImportance?: number
  - Optional timeRange?: {
    from?: string;
    to?: string;
    }
    - Optional from?: string
    - Optional to?: string
  - Optional limit?: number
Returns Promise<EpisodicMemory[]>
Implementation of IKnowledgeGraph.queryMemories
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:555

recallMemories

recallMemories(query, topK?): Promise<EpisodicMemory[]>
Recall relevant memories (updates access count)
Parameters
- query: string
- Optional topK: number
Returns Promise<EpisodicMemory[]>
Implementation of IKnowledgeGraph.recallMemories
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:598

traverse

traverse(startEntityId, options?): Promise<TraversalResult>
Traverse the graph from a starting entity
Parameters
- startEntityId: string
- Optional options: TraversalOptions
Returns Promise<TraversalResult>
Implementation of IKnowledgeGraph.traverse
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:624

findPath

findPath(sourceId, targetId, maxDepth?): Promise<null | {
entity: KnowledgeEntity;
relation?: KnowledgeRelation;
}[]>
Find shortest path between two entities
Parameters
- sourceId: string
- targetId: string
- Optional maxDepth: number
Returns Promise<null | {
entity: KnowledgeEntity;
relation?: KnowledgeRelation;
}[]>
Implementation of IKnowledgeGraph.findPath
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:702

getNeighborhood

getNeighborhood(entityId, depth?): Promise<{
entities: KnowledgeEntity[];
relations: KnowledgeRelation[];
}>
Get neighborhood of an entity
Parameters
- entityId: string
- Optional depth: number
Returns Promise<{
entities: KnowledgeEntity[];
relations: KnowledgeRelation[];
}>
Implementation of IKnowledgeGraph.getNeighborhood
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:736

semanticSearch

semanticSearch(options): Promise<SemanticSearchResult[]>
Semantic search across entities and memories
Parameters
- options: SemanticSearchOptions
Returns Promise<SemanticSearchResult[]>
Implementation of IKnowledgeGraph.semanticSearch
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:770

extractFromText

extractFromText(_text, _options?): Promise<{
entities: KnowledgeEntity[];
relations: KnowledgeRelation[];
}>
Extract entities and relations from text
Parameters
- _text: string
- Optional _options: {
  extractRelations?: boolean;
  entityTypes?: EntityType[];
  }
  - Optional extractRelations?: boolean
  - Optional entityTypes?: EntityType[]
Returns Promise<{
entities: KnowledgeEntity[];
relations: KnowledgeRelation[];
}>
Implementation of IKnowledgeGraph.extractFromText
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:835

mergeEntities

mergeEntities(entityIds, primaryId): Promise<KnowledgeEntity>
Merge duplicate entities
Parameters
- entityIds: string[]
- primaryId: string
Returns Promise<KnowledgeEntity>
Implementation of IKnowledgeGraph.mergeEntities
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:846

decayMemories

decayMemories(decayFactor?): Promise<number>
Decay old memories (reduce importance over time)
Parameters
- Optional decayFactor: number
Returns Promise<number>
Implementation of IKnowledgeGraph.decayMemories
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:894

getStats

getStats(): Promise<KnowledgeGraphStats>
Get knowledge graph statistics

Returns Promise<KnowledgeGraphStats>
Implementation of IKnowledgeGraph.getStats
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:913

clear

clear(): Promise<void>
Clear all knowledge

Returns Promise<void>
Implementation of IKnowledgeGraph.clear
- Defined in src/cognition/memory/retrieval/graph/knowledge/Neo4jKnowledgeGraph.ts:966

Class Neo4jKnowledgeGraph

Implements

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns Neo4jKnowledgeGraph

Methods

initialize

Returns Promise<void>

upsertEntity

Parameters

Returns Promise<KnowledgeEntity>

getEntity

Parameters

Returns Promise<undefined | KnowledgeEntity>

queryEntities

Parameters

Returns Promise<KnowledgeEntity[]>

deleteEntity

Parameters

Returns Promise<boolean>

upsertRelation

Parameters

Returns Promise<KnowledgeRelation>

getRelations

Parameters

Optional direction?: "both" | "outgoing" | "incoming"

Optional types?: RelationType[]

Returns Promise<KnowledgeRelation[]>

deleteRelation

Parameters

Returns Promise<boolean>

recordMemory

Parameters

Returns Promise<EpisodicMemory>

getMemory

Parameters

Returns Promise<undefined | EpisodicMemory>

deleteMemories

Parameters

Returns Promise<number>

queryMemories

Parameters

Optional types?: ("error" | "success" | "discovery" | "conversation" | "task" | "interaction")[]

Optional participants?: string[]

Optional minImportance?: number

Optional timeRange?: { from?: string; to?: string; }

Optional from?: string

Optional to?: string

Optional limit?: number

Returns Promise<EpisodicMemory[]>

recallMemories

Parameters

Returns Promise<EpisodicMemory[]>

traverse

Parameters

Returns Promise<TraversalResult>

findPath

Parameters

Returns Promise<null | { entity: KnowledgeEntity; relation?: KnowledgeRelation; }[]>

getNeighborhood

Parameters

Returns Promise<{ entities: KnowledgeEntity[]; relations: KnowledgeRelation[]; }>

semanticSearch

Parameters

Returns Promise<SemanticSearchResult[]>

extractFromText

Parameters

Optional extractRelations?: boolean

Optional entityTypes?: EntityType[]

Returns Promise<{ entities: KnowledgeEntity[]; relations: KnowledgeRelation[]; }>

mergeEntities

Parameters

Returns Promise<KnowledgeEntity>

decayMemories

Parameters

Returns Promise<number>

`Optional` direction?: "both" | "outgoing" | "incoming"

`Optional` types?: RelationType[]

`Optional` types?: ("error" | "success" | "discovery" | "conversation" | "task" | "interaction")[]

`Optional` participants?: string[]

`Optional` minImportance?: number

`Optional` timeRange?: {
from?: string;
to?: string;
}

`Optional` from?: string

`Optional` to?: string

`Optional` limit?: number

Returns Promise<null | {
entity: KnowledgeEntity;
relation?: KnowledgeRelation;
}[]>

Returns Promise<{
entities: KnowledgeEntity[];
relations: KnowledgeRelation[];
}>

`Optional` extractRelations?: boolean

`Optional` entityTypes?: EntityType[]

Returns Promise<{
entities: KnowledgeEntity[];
relations: KnowledgeRelation[];
}>