@framers/agentos 0.1.0

package/dist/core/knowledge/IKnowledgeGraph.d.ts

@@ -0,0 +1,351 @@
+/**
+ * @file IKnowledgeGraph.ts
+ * @description Knowledge Graph interface for storing and querying
+ * entities, relationships, episodic memories, and semantic knowledge.
+ *
+ * @module AgentOS/Knowledge
+ * @version 1.0.0
+ */
+/**
+ * Unique identifier for entities and relations
+ */
+export type EntityId = string;
+export type RelationId = string;
+/**
+ * Represents an entity (node) in the knowledge graph
+ */
+export interface KnowledgeEntity {
+    /** Unique entity ID */
+    id: EntityId;
+    /** Entity type (person, concept, event, location, etc.) */
+    type: EntityType;
+    /** Human-readable label */
+    label: string;
+    /** Entity properties/attributes */
+    properties: Record<string, unknown>;
+    /** Vector embedding for similarity search */
+    embedding?: number[];
+    /** Confidence score (0-1) */
+    confidence: number;
+    /** Source of this knowledge */
+    source: KnowledgeSource;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Last updated timestamp */
+    updatedAt: string;
+    /** Associated GMI or user ID */
+    ownerId?: string;
+    /** Tags for categorization */
+    tags?: string[];
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Entity types in the knowledge graph
+ */
+export type EntityType = 'person' | 'organization' | 'location' | 'event' | 'concept' | 'fact' | 'skill' | 'preference' | 'memory' | 'goal' | 'task' | 'document' | 'code' | 'custom';
+/**
+ * Source of knowledge
+ */
+export interface KnowledgeSource {
+    /** Source type */
+    type: 'user_input' | 'conversation' | 'rag_ingest' | 'web_search' | 'inference' | 'system';
+    /** Source reference (conversation ID, document ID, URL, etc.) */
+    reference?: string;
+    /** Timestamp of extraction */
+    timestamp: string;
+    /** Extraction method */
+    method?: string;
+}
+/**
+ * Represents a relationship (edge) between entities
+ */
+export interface KnowledgeRelation {
+    /** Unique relation ID */
+    id: RelationId;
+    /** Source entity ID */
+    sourceId: EntityId;
+    /** Target entity ID */
+    targetId: EntityId;
+    /** Relation type */
+    type: RelationType;
+    /** Relation label (e.g., "works_at", "knows", "caused_by") */
+    label: string;
+    /** Relation properties */
+    properties?: Record<string, unknown>;
+    /** Relation strength/weight (0-1) */
+    weight: number;
+    /** Is this relation bidirectional? */
+    bidirectional: boolean;
+    /** Confidence score */
+    confidence: number;
+    /** Source of this relation */
+    source: KnowledgeSource;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Temporal validity (when was this relation true?) */
+    validFrom?: string;
+    validTo?: string;
+}
+/**
+ * Relation types
+ */
+export type RelationType = 'is_a' | 'part_of' | 'related_to' | 'causes' | 'precedes' | 'located_in' | 'created_by' | 'used_for' | 'has_property' | 'knows' | 'prefers' | 'learned' | 'similar_to' | 'opposite_of' | 'custom';
+/**
+ * Represents an episodic memory (specific experience/event)
+ */
+export interface EpisodicMemory {
+    /** Unique memory ID */
+    id: string;
+    /** Memory type */
+    type: 'conversation' | 'task' | 'discovery' | 'error' | 'success' | 'interaction';
+    /** Summary of the episode */
+    summary: string;
+    /** Detailed description */
+    description?: string;
+    /** Participants (user IDs, GMI IDs) */
+    participants: string[];
+    /** Emotional valence (-1 to 1, negative to positive) */
+    valence?: number;
+    /** Importance score (0-1) */
+    importance: number;
+    /** Associated entity IDs */
+    entityIds: EntityId[];
+    /** Vector embedding */
+    embedding?: number[];
+    /** When did this happen? */
+    occurredAt: string;
+    /** Duration in milliseconds */
+    durationMs?: number;
+    /** Outcome/result */
+    outcome?: 'success' | 'failure' | 'partial' | 'unknown';
+    /** Lessons learned */
+    insights?: string[];
+    /** Raw context data */
+    context?: Record<string, unknown>;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Access count (for decay/reinforcement) */
+    accessCount: number;
+    /** Last accessed timestamp */
+    lastAccessedAt: string;
+}
+/**
+ * Options for querying the knowledge graph
+ */
+export interface KnowledgeQueryOptions {
+    /** Filter by entity types */
+    entityTypes?: EntityType[];
+    /** Filter by relation types */
+    relationTypes?: RelationType[];
+    /** Filter by owner */
+    ownerId?: string;
+    /** Filter by tags */
+    tags?: string[];
+    /** Minimum confidence threshold */
+    minConfidence?: number;
+    /** Include embeddings in results */
+    includeEmbeddings?: boolean;
+    /** Maximum results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+    /** Time range filter */
+    timeRange?: {
+        from?: string;
+        to?: string;
+    };
+}
+/**
+ * Options for graph traversal
+ */
+export interface TraversalOptions {
+    /** Maximum depth to traverse */
+    maxDepth?: number;
+    /** Relation types to follow */
+    relationTypes?: RelationType[];
+    /** Direction of traversal */
+    direction?: 'outgoing' | 'incoming' | 'both';
+    /** Minimum relation weight */
+    minWeight?: number;
+    /** Maximum nodes to visit */
+    maxNodes?: number;
+}
+/**
+ * Result of a graph traversal
+ */
+export interface TraversalResult {
+    /** Starting entity */
+    root: KnowledgeEntity;
+    /** Discovered entities by depth level */
+    levels: Array<{
+        depth: number;
+        entities: KnowledgeEntity[];
+        relations: KnowledgeRelation[];
+    }>;
+    /** Total entities found */
+    totalEntities: number;
+    /** Total relations traversed */
+    totalRelations: number;
+}
+/**
+ * Semantic search options
+ */
+export interface SemanticSearchOptions {
+    /** Query text */
+    query: string;
+    /** Search scope */
+    scope?: 'entities' | 'memories' | 'all';
+    /** Entity types to search */
+    entityTypes?: EntityType[];
+    /** Maximum results */
+    topK?: number;
+    /** Minimum similarity threshold (0-1) */
+    minSimilarity?: number;
+    /** Owner filter */
+    ownerId?: string;
+}
+/**
+ * Semantic search result
+ */
+export interface SemanticSearchResult {
+    /** Matched entity or memory */
+    item: KnowledgeEntity | EpisodicMemory;
+    /** Item type */
+    type: 'entity' | 'memory';
+    /** Similarity score (0-1) */
+    similarity: number;
+    /** Related entities */
+    relatedEntities?: KnowledgeEntity[];
+}
+/**
+ * Statistics about the knowledge graph
+ */
+export interface KnowledgeGraphStats {
+    totalEntities: number;
+    totalRelations: number;
+    totalMemories: number;
+    entitiesByType: Record<EntityType, number>;
+    relationsByType: Record<RelationType, number>;
+    avgConfidence: number;
+    oldestEntry: string;
+    newestEntry: string;
+}
+/**
+ * Interface for the Knowledge Graph system
+ */
+export interface IKnowledgeGraph {
+    /**
+     * Initialize the knowledge graph
+     */
+    initialize(): Promise<void>;
+    /**
+     * Add or update an entity
+     */
+    upsertEntity(entity: Omit<KnowledgeEntity, 'id' | 'createdAt' | 'updatedAt'> & {
+        id?: EntityId;
+    }): Promise<KnowledgeEntity>;
+    /**
+     * Get entity by ID
+     */
+    getEntity(id: EntityId): Promise<KnowledgeEntity | undefined>;
+    /**
+     * Query entities
+     */
+    queryEntities(options?: KnowledgeQueryOptions): Promise<KnowledgeEntity[]>;
+    /**
+     * Delete an entity and its relations
+     */
+    deleteEntity(id: EntityId): Promise<boolean>;
+    /**
+     * Add or update a relation
+     */
+    upsertRelation(relation: Omit<KnowledgeRelation, 'id' | 'createdAt'> & {
+        id?: RelationId;
+    }): Promise<KnowledgeRelation>;
+    /**
+     * Get relations for an entity
+     */
+    getRelations(entityId: EntityId, options?: {
+        direction?: 'outgoing' | 'incoming' | 'both';
+        types?: RelationType[];
+    }): Promise<KnowledgeRelation[]>;
+    /**
+     * Delete a relation
+     */
+    deleteRelation(id: RelationId): Promise<boolean>;
+    /**
+     * Record an episodic memory
+     */
+    recordMemory(memory: Omit<EpisodicMemory, 'id' | 'createdAt' | 'accessCount' | 'lastAccessedAt'>): Promise<EpisodicMemory>;
+    /**
+     * Get memory by ID
+     */
+    getMemory(id: string): Promise<EpisodicMemory | undefined>;
+    /**
+     * Query episodic memories
+     */
+    queryMemories(options?: {
+        types?: EpisodicMemory['type'][];
+        participants?: string[];
+        minImportance?: number;
+        timeRange?: {
+            from?: string;
+            to?: string;
+        };
+        limit?: number;
+    }): Promise<EpisodicMemory[]>;
+    /**
+     * Recall relevant memories (updates access count)
+     */
+    recallMemories(query: string, topK?: number): Promise<EpisodicMemory[]>;
+    /**
+     * Traverse the graph from a starting entity
+     */
+    traverse(startEntityId: EntityId, options?: TraversalOptions): Promise<TraversalResult>;
+    /**
+     * Find shortest path between two entities
+     */
+    findPath(sourceId: EntityId, targetId: EntityId, maxDepth?: number): Promise<Array<{
+        entity: KnowledgeEntity;
+        relation?: KnowledgeRelation;
+    }> | null>;
+    /**
+     * Get neighborhood of an entity
+     */
+    getNeighborhood(entityId: EntityId, depth?: number): Promise<{
+        entities: KnowledgeEntity[];
+        relations: KnowledgeRelation[];
+    }>;
+    /**
+     * Semantic search across entities and memories
+     */
+    semanticSearch(options: SemanticSearchOptions): Promise<SemanticSearchResult[]>;
+    /**
+     * Extract entities and relations from text
+     */
+    extractFromText(text: string, options?: {
+        extractRelations?: boolean;
+        entityTypes?: EntityType[];
+    }): Promise<{
+        entities: KnowledgeEntity[];
+        relations: KnowledgeRelation[];
+    }>;
+    /**
+     * Merge duplicate entities
+     */
+    mergeEntities(entityIds: EntityId[], primaryId: EntityId): Promise<KnowledgeEntity>;
+    /**
+     * Decay old memories (reduce importance over time)
+     */
+    decayMemories(decayFactor?: number): Promise<number>;
+    /**
+     * Get knowledge graph statistics
+     */
+    getStats(): Promise<KnowledgeGraphStats>;
+    /**
+     * Clear all knowledge
+     */
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=IKnowledgeGraph.d.ts.map

package/dist/core/knowledge/IKnowledgeGraph.d.ts.map

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

package/dist/core/knowledge/IKnowledgeGraph.js

@@ -0,0 +1,10 @@
+/**
+ * @file IKnowledgeGraph.ts
+ * @description Knowledge Graph interface for storing and querying
+ * entities, relationships, episodic memories, and semantic knowledge.
+ *
+ * @module AgentOS/Knowledge
+ * @version 1.0.0
+ */
+export {};
+//# sourceMappingURL=IKnowledgeGraph.js.map

package/dist/core/knowledge/IKnowledgeGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IKnowledgeGraph.js","sourceRoot":"","sources":["../../../src/core/knowledge/IKnowledgeGraph.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/core/knowledge/KnowledgeGraph.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @file KnowledgeGraph.ts
+ * @description In-memory implementation of the Knowledge Graph.
+ * Provides entity-relationship storage, episodic memory, and semantic search.
+ *
+ * @module AgentOS/Knowledge
+ * @version 1.0.0
+ */
+import type { IKnowledgeGraph, KnowledgeEntity, KnowledgeRelation, EpisodicMemory, EntityId, RelationId, EntityType, RelationType, KnowledgeQueryOptions, TraversalOptions, TraversalResult, SemanticSearchOptions, SemanticSearchResult, KnowledgeGraphStats } from './IKnowledgeGraph';
+import type { ILogger } from '../../logging/ILogger';
+import type { IEmbeddingManager } from '../../rag/IEmbeddingManager';
+/**
+ * Configuration for KnowledgeGraph
+ */
+export interface KnowledgeGraphConfig {
+    /** Embedding manager for semantic search */
+    embeddingManager?: IEmbeddingManager;
+    /** Logger instance */
+    logger?: ILogger;
+    /** Memory decay rate per day (0-1) */
+    memoryDecayRate?: number;
+    /** Minimum importance to retain memories */
+    minImportanceThreshold?: number;
+}
+/**
+ * In-memory Knowledge Graph implementation
+ */
+export declare class KnowledgeGraph implements IKnowledgeGraph {
+    private readonly entities;
+    private readonly relations;
+    private readonly memories;
+    private readonly entityByType;
+    private readonly relationsBySource;
+    private readonly relationsByTarget;
+    private readonly entitiesByOwner;
+    private readonly embeddingManager?;
+    private readonly logger?;
+    private readonly memoryDecayRate;
+    private readonly minImportanceThreshold;
+    constructor(config?: KnowledgeGraphConfig);
+    initialize(): Promise<void>;
+    upsertEntity(entityInput: Omit<KnowledgeEntity, 'id' | 'createdAt' | 'updatedAt'> & {
+        id?: EntityId;
+    }): Promise<KnowledgeEntity>;
+    getEntity(id: EntityId): Promise<KnowledgeEntity | undefined>;
+    queryEntities(options?: KnowledgeQueryOptions): Promise<KnowledgeEntity[]>;
+    deleteEntity(id: EntityId): Promise<boolean>;
+    upsertRelation(relationInput: Omit<KnowledgeRelation, 'id' | 'createdAt'> & {
+        id?: RelationId;
+    }): Promise<KnowledgeRelation>;
+    getRelations(entityId: EntityId, options?: {
+        direction?: 'outgoing' | 'incoming' | 'both';
+        types?: RelationType[];
+    }): Promise<KnowledgeRelation[]>;
+    deleteRelation(id: RelationId): Promise<boolean>;
+    recordMemory(memoryInput: Omit<EpisodicMemory, 'id' | 'createdAt' | 'accessCount' | 'lastAccessedAt'>): Promise<EpisodicMemory>;
+    getMemory(id: string): Promise<EpisodicMemory | undefined>;
+    queryMemories(options?: {
+        types?: EpisodicMemory['type'][];
+        participants?: string[];
+        minImportance?: number;
+        timeRange?: {
+            from?: string;
+            to?: string;
+        };
+        limit?: number;
+    }): Promise<EpisodicMemory[]>;
+    recallMemories(query: string, topK?: number): Promise<EpisodicMemory[]>;
+    traverse(startEntityId: EntityId, options?: TraversalOptions): Promise<TraversalResult>;
+    findPath(sourceId: EntityId, targetId: EntityId, maxDepth?: number): Promise<Array<{
+        entity: KnowledgeEntity;
+        relation?: KnowledgeRelation;
+    }> | null>;
+    getNeighborhood(entityId: EntityId, depth?: number): Promise<{
+        entities: KnowledgeEntity[];
+        relations: KnowledgeRelation[];
+    }>;
+    semanticSearch(options: SemanticSearchOptions): Promise<SemanticSearchResult[]>;
+    private textBasedSearch;
+    extractFromText(text: string, options?: {
+        extractRelations?: boolean;
+        entityTypes?: EntityType[];
+    }): Promise<{
+        entities: KnowledgeEntity[];
+        relations: KnowledgeRelation[];
+    }>;
+    mergeEntities(entityIds: EntityId[], primaryId: EntityId): Promise<KnowledgeEntity>;
+    decayMemories(decayFactor?: number): Promise<number>;
+    getStats(): Promise<KnowledgeGraphStats>;
+    clear(): Promise<void>;
+    private cosineSimilarity;
+}
+//# sourceMappingURL=KnowledgeGraph.d.ts.map

package/dist/core/knowledge/KnowledgeGraph.d.ts.map

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