Enhanced Knowledge Graph Memory Server

/** * Application Constants * * Centralized configuration constants for file paths, extensions, and default values. * * @module utils/constants */ /** * File extensions used by the memory system. */ export const FILE_EXTENSIONS = { /** JSONL format for line-delimited JSON storage */ JSONL: '.jsonl', /** Legacy JSON format (backward compatibility) */ JSON: '.json', } as const; /** * File name suffixes for auxiliary data files. * These suffixes are appended to the base memory file name. */ export const FILE_SUFFIXES = { /** Suffix for saved searches file */ SAVED_SEARCHES: '-saved-searches', /** Suffix for tag aliases file */ TAG_ALIASES: '-tag-aliases', } as const; /** * Default file names used by the memory system. */ export const DEFAULT_FILE_NAMES = { /** Default memory file name */ MEMORY: 'memory', /** Legacy memory file name (for backward compatibility) */ MEMORY_LEGACY: 'memory', } as const; /** * Environment variable names used for configuration. */ export const ENV_VARS = { /** Environment variable for custom memory file path */ MEMORY_FILE_PATH: 'MEMORY_FILE_PATH', } as const; /** * Default base directory relative to the compiled code. */ export const DEFAULT_BASE_DIR = '../'; /** * Log message prefixes for consistent logging. */ export const LOG_PREFIXES = { /** Informational message prefix */ INFO: '[INFO]', /** Error message prefix */ ERROR: '[ERROR]', /** Warning message prefix */ WARN: '[WARN]', } as const; /** * Similarity scoring weights for duplicate detection. * These weights determine the relative importance of each factor * when calculating entity similarity for duplicate detection. * Total weights must sum to 1.0 (100%). */ export const SIMILARITY_WEIGHTS = { /** Name similarity weight (40%) - Uses Levenshtein distance */ NAME: 0.4, /** Entity type match weight (20%) - Exact match required */ TYPE: 0.2, /** Observation overlap weight (30%) - Uses Jaccard similarity */ OBSERVATIONS: 0.3, /** Tag overlap weight (10%) - Uses Jaccard similarity */ TAGS: 0.1, } as const; /** * Default threshold for duplicate detection (80% similarity required). */ export const DEFAULT_DUPLICATE_THRESHOLD = 0.8; /** * Search result limits to prevent resource exhaustion. */ export const SEARCH_LIMITS = { /** Default number of results to return */ DEFAULT: 50, /** Maximum number of results allowed */ MAX: 200, /** Minimum number of results (must be at least 1) */ MIN: 1, } as const; /** * Entity importance range validation constants. * Importance is used to prioritize entities (0 = lowest, 10 = highest). */ export const IMPORTANCE_RANGE = { /** Minimum importance value */ MIN: 0, /** Maximum importance value */ MAX: 10, } as const; /** * Graph size limits to prevent resource exhaustion and ensure performance. * These limits help maintain system stability and responsiveness. */ export const GRAPH_LIMITS = { /** Maximum number of entities in the graph */ MAX_ENTITIES: 100000, /** Maximum number of relations in the graph */ MAX_RELATIONS: 1000000, /** Maximum graph file size in megabytes */ MAX_FILE_SIZE_MB: 500, /** Maximum observations per entity */ MAX_OBSERVATIONS_PER_ENTITY: 1000, /** Maximum tags per entity */ MAX_TAGS_PER_ENTITY: 100, } as const; /** * Query complexity limits to prevent expensive query operations. * These limits protect against denial-of-service through complex queries. */ export const QUERY_LIMITS = { /** Maximum nesting depth for boolean queries */ MAX_DEPTH: 10, /** Maximum number of terms in a single query */ MAX_TERMS: 50, /** Maximum number of boolean operators (AND/OR/NOT) */ MAX_OPERATORS: 20, /** Maximum query string length */ MAX_QUERY_LENGTH: 5000, } as const;