@mce-bt/microagents-memory 0.1.0

package/dist/knowledge-graph.js

@@ -0,0 +1,513 @@
+import pg from 'pg';
+const { Pool } = pg;
+/**
+ * Knowledge Graph — Postgres-backed entity-relation graph with temporal validity.
+ *
+ * Combines the MCP memory server's entity-relation-observation model with
+ * Graphiti's temporal validity windows, all implemented in PostgreSQL.
+ *
+ * Entities have names, types, observations (atomic facts), and optional embeddings
+ * for semantic search. Relations connect entities with typed, directed edges that
+ * carry validity windows (valid_from / valid_until) for temporal reasoning.
+ */
+export class KnowledgeGraph {
+    pool = null;
+    config;
+    agentId = '';
+    embeddingDimensions;
+    constructor(config) {
+        this.config = config;
+        this.embeddingDimensions = config.embeddingDimensions ?? 1536;
+    }
+    async start(agentId) {
+        this.agentId = agentId;
+        this.pool = new Pool({ connectionString: this.config.connectionString });
+        await this.ensureSchema();
+    }
+    async stop() {
+        if (this.pool) {
+            await this.pool.end();
+            this.pool = null;
+        }
+    }
+    // ─── Schema ───
+    async ensureSchema() {
+        if (!this.pool)
+            return;
+        await this.pool.query('CREATE EXTENSION IF NOT EXISTS vector');
+        await this.pool.query(`
+      CREATE TABLE IF NOT EXISTS kg_entities (
+        id TEXT PRIMARY KEY,
+        agent_id TEXT NOT NULL,
+        name TEXT NOT NULL,
+        entity_type TEXT NOT NULL DEFAULT 'general',
+        observations TEXT[] DEFAULT '{}',
+        embedding vector(${this.embeddingDimensions}),
+        metadata JSONB DEFAULT '{}',
+        created_at TIMESTAMPTZ DEFAULT NOW(),
+        updated_at TIMESTAMPTZ DEFAULT NOW()
+      );
+
+      CREATE UNIQUE INDEX IF NOT EXISTS idx_kg_entity_name_agent
+        ON kg_entities(agent_id, name);
+      CREATE INDEX IF NOT EXISTS idx_kg_entity_type
+        ON kg_entities(agent_id, entity_type);
+      CREATE INDEX IF NOT EXISTS idx_kg_entity_observations
+        ON kg_entities USING GIN(observations);
+    `);
+        await this.pool.query(`
+      CREATE TABLE IF NOT EXISTS kg_relations (
+        id TEXT PRIMARY KEY,
+        agent_id TEXT NOT NULL,
+        from_entity TEXT NOT NULL,
+        to_entity TEXT NOT NULL,
+        relation_type TEXT NOT NULL,
+        weight REAL DEFAULT 1.0,
+        valid_from TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+        valid_until TIMESTAMPTZ,
+        metadata JSONB DEFAULT '{}',
+        created_at TIMESTAMPTZ DEFAULT NOW(),
+        CONSTRAINT fk_from_entity FOREIGN KEY (from_entity)
+          REFERENCES kg_entities(id) ON DELETE CASCADE,
+        CONSTRAINT fk_to_entity FOREIGN KEY (to_entity)
+          REFERENCES kg_entities(id) ON DELETE CASCADE
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_kg_rel_from ON kg_relations(from_entity);
+      CREATE INDEX IF NOT EXISTS idx_kg_rel_to ON kg_relations(to_entity);
+      CREATE INDEX IF NOT EXISTS idx_kg_rel_type ON kg_relations(relation_type);
+      CREATE INDEX IF NOT EXISTS idx_kg_rel_valid
+        ON kg_relations(valid_from, valid_until);
+    `);
+        // Vector index (may fail if not enough data)
+        try {
+            await this.pool.query(`
+        CREATE INDEX IF NOT EXISTS idx_kg_entity_embedding
+        ON kg_entities USING ivfflat (embedding vector_cosine_ops)
+        WITH (lists = 100)
+      `);
+        }
+        catch {
+            // IVFFlat needs data to build; will be created later
+        }
+    }
+    // ─── Entity CRUD ───
+    /**
+     * Create or update an entity. If an entity with the same name already exists
+     * for this agent, merges new observations (deduplicates) and updates metadata.
+     */
+    async upsertEntity(input) {
+        if (!this.pool)
+            throw new Error('KnowledgeGraph not started');
+        const existing = await this.getEntityByName(input.name);
+        if (existing) {
+            // Merge observations (deduplicate)
+            const newObs = (input.observations ?? []).filter((o) => !existing.observations.includes(o));
+            const mergedObs = [...existing.observations, ...newObs];
+            const mergedMeta = { ...existing.metadata, ...(input.metadata ?? {}) };
+            const embeddingStr = input.embedding
+                ? `[${input.embedding.join(',')}]`
+                : null;
+            if (embeddingStr) {
+                await this.pool.query(`UPDATE kg_entities
+           SET observations = $1, metadata = $2, entity_type = $3,
+               embedding = $4::vector, updated_at = NOW()
+           WHERE id = $5`, [mergedObs, JSON.stringify(mergedMeta), input.entityType, embeddingStr, existing.id]);
+            }
+            else {
+                await this.pool.query(`UPDATE kg_entities
+           SET observations = $1, metadata = $2, entity_type = $3, updated_at = NOW()
+           WHERE id = $4`, [mergedObs, JSON.stringify(mergedMeta), input.entityType, existing.id]);
+            }
+            return {
+                ...existing,
+                observations: mergedObs,
+                metadata: mergedMeta,
+                entityType: input.entityType,
+                updatedAt: new Date(),
+            };
+        }
+        // Create new
+        const id = `ent-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        const embeddingStr = input.embedding
+            ? `[${input.embedding.join(',')}]`
+            : null;
+        await this.pool.query(`INSERT INTO kg_entities (id, agent_id, name, entity_type, observations, embedding, metadata)
+       VALUES ($1, $2, $3, $4, $5, $6::vector, $7)`, [
+            id,
+            this.agentId,
+            input.name,
+            input.entityType,
+            input.observations ?? [],
+            embeddingStr,
+            JSON.stringify(input.metadata ?? {}),
+        ]);
+        return {
+            id,
+            agentId: this.agentId,
+            name: input.name,
+            entityType: input.entityType,
+            observations: input.observations ?? [],
+            metadata: input.metadata ?? {},
+            createdAt: new Date(),
+            updatedAt: new Date(),
+        };
+    }
+    /**
+     * Get an entity by name (scoped to this agent).
+     */
+    async getEntityByName(name) {
+        if (!this.pool)
+            throw new Error('KnowledgeGraph not started');
+        const result = await this.pool.query('SELECT * FROM kg_entities WHERE agent_id = $1 AND name = $2', [this.agentId, name]);
+        if (result.rows.length === 0)
+            return null;
+        return this.rowToEntity(result.rows[0]);
+    }
+    /**
+     * Get an entity by ID.
+     */
+    async getEntityById(id) {
+        if (!this.pool)
+            throw new Error('KnowledgeGraph not started');
+        const result = await this.pool.query('SELECT * FROM kg_entities WHERE id = $1', [id]);
+        if (result.rows.length === 0)
+            return null;
+        return this.rowToEntity(result.rows[0]);
+    }
+    /**
+     * Add observations to an existing entity. Deduplicates automatically.
+     */
+    async addObservations(entityName, observations) {
+        if (!this.pool)
+            throw new Error('KnowledgeGraph not started');
+        const entity = await this.getEntityByName(entityName);
+        if (!entity)
+            throw new Error(`Entity "${entityName}" not found`);
+        const newObs = observations.filter((o) => !entity.observations.includes(o));
+        if (newObs.length === 0)
+            return [];
+        const merged = [...entity.observations, ...newObs];
+        await this.pool.query('UPDATE kg_entities SET observations = $1, updated_at = NOW() WHERE id = $2', [merged, entity.id]);
+        return newObs;
+    }
+    /**
+     * Remove specific observations from an entity.
+     */
+    async removeObservations(entityName, observations) {
+        if (!this.pool)
+            throw new Error('KnowledgeGraph not started');
+        const entity = await this.getEntityByName(entityName);
+        if (!entity)
+            return;
+        const filtered = entity.observations.filter((o) => !observations.includes(o));
+        await this.pool.query('UPDATE kg_entities SET observations = $1, updated_at = NOW() WHERE id = $2', [filtered, entity.id]);
+    }
+    /**
+     * Delete an entity and all its relations (cascading).
+     */
+    async deleteEntity(name) {
+        if (!this.pool)
+            throw new Error('KnowledgeGraph not started');
+        await this.pool.query('DELETE FROM kg_entities WHERE agent_id = $1 AND name = $2', [this.agentId, name]);
+    }
+    // ─── Relation CRUD ───
+    /**
+     * Create a relation between two entities. Skips if an identical active relation exists.
+     * If a contradicting relation exists (same from/to/type but different validity),
+     * the old one is invalidated (valid_until set to now).
+     */
+    async createRelation(input) {
+        if (!this.pool)
+            throw new Error('KnowledgeGraph not started');
+        // Resolve entity IDs from names
+        const fromEntity = await this.getEntityByName(input.from);
+        const toEntity = await this.getEntityByName(input.to);
+        if (!fromEntity || !toEntity) {
+            throw new Error(`Cannot create relation: entity "${!fromEntity ? input.from : input.to}" not found`);
+        }
+        // Check for existing active relation of same type
+        const existing = await this.pool.query(`SELECT id FROM kg_relations
+       WHERE from_entity = $1 AND to_entity = $2
+         AND relation_type = $3 AND valid_until IS NULL`, [fromEntity.id, toEntity.id, input.relationType]);
+        if (existing.rows.length > 0) {
+            // Identical active relation exists — skip
+            return null;
+        }
+        const id = `rel-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        const validFrom = input.validFrom ?? new Date();
+        await this.pool.query(`INSERT INTO kg_relations (id, agent_id, from_entity, to_entity, relation_type, weight, valid_from, metadata)
+       VALUES ($1, $2, $3, $4, $5, $6, $7, $8)`, [
+            id,
+            this.agentId,
+            fromEntity.id,
+            toEntity.id,
+            input.relationType,
+            input.weight ?? 1.0,
+            validFrom,
+            JSON.stringify(input.metadata ?? {}),
+        ]);
+        return {
+            id,
+            agentId: this.agentId,
+            fromEntity: fromEntity.id,
+            toEntity: toEntity.id,
+            relationType: input.relationType,
+            weight: input.weight ?? 1.0,
+            validFrom,
+            validUntil: null,
+            metadata: input.metadata ?? {},
+            createdAt: new Date(),
+        };
+    }
+    /**
+     * Invalidate a relation by setting valid_until to now.
+     * Preserves history — the relation is never deleted.
+     */
+    async invalidateRelation(id) {
+        if (!this.pool)
+            throw new Error('KnowledgeGraph not started');
+        await this.pool.query('UPDATE kg_relations SET valid_until = NOW() WHERE id = $1', [id]);
+    }
+    /**
+     * Delete a relation permanently (use invalidate for temporal preservation).
+     */
+    async deleteRelation(input) {
+        if (!this.pool)
+            throw new Error('KnowledgeGraph not started');
+        const fromEntity = await this.getEntityByName(input.from);
+        const toEntity = await this.getEntityByName(input.to);
+        if (!fromEntity || !toEntity)
+            return;
+        await this.pool.query(`DELETE FROM kg_relations
+       WHERE from_entity = $1 AND to_entity = $2 AND relation_type = $3`, [fromEntity.id, toEntity.id, input.relationType]);
+    }
+    /**
+     * Get all active relations for an entity (as source or target).
+     * Only returns relations where valid_until IS NULL (currently active).
+     */
+    async getEntityRelations(entityName, options = {}) {
+        if (!this.pool)
+            throw new Error('KnowledgeGraph not started');
+        const entity = await this.getEntityByName(entityName);
+        if (!entity)
+            return [];
+        const validClause = options.includeExpired
+            ? ''
+            : 'AND r.valid_until IS NULL';
+        const result = await this.pool.query(`SELECT r.*,
+              fe.name as from_name,
+              te.name as to_name
+       FROM kg_relations r
+       JOIN kg_entities fe ON r.from_entity = fe.id
+       JOIN kg_entities te ON r.to_entity = te.id
+       WHERE (r.from_entity = $1 OR r.to_entity = $1)
+         ${validClause}
+       ORDER BY r.valid_from DESC`, [entity.id]);
+        return result.rows.map((row) => ({
+            ...this.rowToRelation(row),
+            fromName: row.from_name,
+            toName: row.to_name,
+        }));
+    }
+    // ─── Search ───
+    /**
+     * Search entities by text query (matches name, type, and observations).
+     */
+    async searchEntities(options = {}) {
+        if (!this.pool)
+            throw new Error('KnowledgeGraph not started');
+        const conditions = ['agent_id = $1'];
+        const params = [this.agentId];
+        let idx = 2;
+        if (options.entityType) {
+            conditions.push(`entity_type = $${idx}`);
+            params.push(options.entityType);
+            idx++;
+        }
+        if (options.query) {
+            const q = options.query.toLowerCase();
+            conditions.push(`(LOWER(name) LIKE $${idx}
+          OR LOWER(entity_type) LIKE $${idx}
+          OR EXISTS (SELECT 1 FROM unnest(observations) obs WHERE LOWER(obs) LIKE $${idx}))`);
+            params.push(`%${q}%`);
+            idx++;
+        }
+        const limit = options.limit ?? 20;
+        const result = await this.pool.query(`SELECT * FROM kg_entities WHERE ${conditions.join(' AND ')}
+       ORDER BY updated_at DESC LIMIT $${idx}`, [...params, limit]);
+        return result.rows.map(this.rowToEntity);
+    }
+    /**
+     * Semantic search entities by embedding similarity.
+     */
+    async searchEntitiesByEmbedding(queryEmbedding, options = {}) {
+        if (!this.pool)
+            throw new Error('KnowledgeGraph not started');
+        const conditions = ['agent_id = $1', 'embedding IS NOT NULL'];
+        const params = [this.agentId];
+        let idx = 2;
+        if (options.entityType) {
+            conditions.push(`entity_type = $${idx}`);
+            params.push(options.entityType);
+            idx++;
+        }
+        const embeddingStr = `[${queryEmbedding.join(',')}]`;
+        const limit = options.limit ?? 10;
+        const threshold = options.threshold ?? 0.7;
+        const result = await this.pool.query(`SELECT *,
+              1 - (embedding <=> $${idx}::vector) as similarity
+       FROM kg_entities
+       WHERE ${conditions.join(' AND ')}
+         AND 1 - (embedding <=> $${idx}::vector) >= $${idx + 1}
+       ORDER BY embedding <=> $${idx}::vector
+       LIMIT $${idx + 2}`, [...params, embeddingStr, threshold, limit]);
+        return result.rows.map((row) => ({
+            ...this.rowToEntity(row),
+            similarity: parseFloat(row.similarity),
+        }));
+    }
+    /**
+     * Open specific entities by name and return them with their relations.
+     * Similar to MCP memory server's open_nodes.
+     */
+    async openEntities(names) {
+        if (!this.pool)
+            throw new Error('KnowledgeGraph not started');
+        if (names.length === 0)
+            return { entities: [], relations: [] };
+        // Get entities
+        const entityResult = await this.pool.query(`SELECT * FROM kg_entities
+       WHERE agent_id = $1 AND name = ANY($2)`, [this.agentId, names]);
+        const entities = entityResult.rows.map(this.rowToEntity);
+        const entityIds = entities.map((e) => e.id);
+        if (entityIds.length === 0)
+            return { entities: [], relations: [] };
+        // Get active relations where at least one endpoint is in the set
+        const relResult = await this.pool.query(`SELECT * FROM kg_relations
+       WHERE (from_entity = ANY($1) OR to_entity = ANY($1))
+         AND valid_until IS NULL
+       ORDER BY valid_from DESC`, [entityIds]);
+        const relations = relResult.rows.map(this.rowToRelation);
+        return { entities, relations };
+    }
+    /**
+     * Read the full graph for this agent (active relations only).
+     */
+    async readGraph(options = {}) {
+        if (!this.pool)
+            throw new Error('KnowledgeGraph not started');
+        const entityResult = await this.pool.query('SELECT * FROM kg_entities WHERE agent_id = $1 ORDER BY name', [this.agentId]);
+        const validClause = options.includeExpired
+            ? ''
+            : 'AND valid_until IS NULL';
+        const relResult = await this.pool.query(`SELECT * FROM kg_relations WHERE agent_id = $1 ${validClause} ORDER BY valid_from DESC`, [this.agentId]);
+        return {
+            entities: entityResult.rows.map(this.rowToEntity),
+            relations: relResult.rows.map(this.rowToRelation),
+        };
+    }
+    // ─── Temporal Queries ───
+    /**
+     * Get the state of relations at a specific point in time.
+     */
+    async getRelationsAt(date, options = {}) {
+        if (!this.pool)
+            throw new Error('KnowledgeGraph not started');
+        const conditions = [
+            'agent_id = $1',
+            'valid_from <= $2',
+            '(valid_until IS NULL OR valid_until > $2)',
+        ];
+        const params = [this.agentId, date];
+        let idx = 3;
+        if (options.entityName) {
+            const entity = await this.getEntityByName(options.entityName);
+            if (!entity)
+                return [];
+            conditions.push(`(from_entity = $${idx} OR to_entity = $${idx})`);
+            params.push(entity.id);
+            idx++;
+        }
+        const result = await this.pool.query(`SELECT * FROM kg_relations WHERE ${conditions.join(' AND ')} ORDER BY valid_from DESC`, params);
+        return result.rows.map(this.rowToRelation);
+    }
+    /**
+     * Get the history of changes to a specific relation type between two entities.
+     */
+    async getRelationHistory(from, to, relationType) {
+        if (!this.pool)
+            throw new Error('KnowledgeGraph not started');
+        const fromEntity = await this.getEntityByName(from);
+        const toEntity = await this.getEntityByName(to);
+        if (!fromEntity || !toEntity)
+            return [];
+        const result = await this.pool.query(`SELECT * FROM kg_relations
+       WHERE from_entity = $1 AND to_entity = $2 AND relation_type = $3
+       ORDER BY valid_from DESC`, [fromEntity.id, toEntity.id, relationType]);
+        return result.rows.map(this.rowToRelation);
+    }
+    // ─── Contradiction Detection ───
+    /**
+     * Update a relation: invalidates the existing one and creates a new one.
+     * This preserves temporal history (Graphiti pattern).
+     */
+    async supersedRelation(input) {
+        if (!this.pool)
+            throw new Error('KnowledgeGraph not started');
+        const fromEntity = await this.getEntityByName(input.from);
+        const toEntity = await this.getEntityByName(input.to);
+        if (!fromEntity || !toEntity)
+            return null;
+        // Invalidate existing active relation
+        await this.pool.query(`UPDATE kg_relations SET valid_until = NOW()
+       WHERE from_entity = $1 AND to_entity = $2
+         AND relation_type = $3 AND valid_until IS NULL`, [fromEntity.id, toEntity.id, input.relationType]);
+        // Create the new one
+        return this.createRelation(input);
+    }
+    // ─── Aggregation ───
+    /**
+     * Get entity counts grouped by type.
+     */
+    async getEntityTypeCounts() {
+        if (!this.pool)
+            throw new Error('KnowledgeGraph not started');
+        const result = await this.pool.query(`SELECT entity_type, COUNT(*)::int as count
+       FROM kg_entities WHERE agent_id = $1
+       GROUP BY entity_type ORDER BY count DESC`, [this.agentId]);
+        const counts = {};
+        for (const row of result.rows) {
+            counts[row.entity_type] = row.count;
+        }
+        return counts;
+    }
+    // ─── Row Mappers ───
+    rowToEntity(row) {
+        return {
+            id: row.id,
+            agentId: row.agent_id,
+            name: row.name,
+            entityType: row.entity_type,
+            observations: (row.observations ?? []),
+            metadata: (row.metadata ?? {}),
+            createdAt: new Date(row.created_at),
+            updatedAt: new Date(row.updated_at),
+        };
+    }
+    rowToRelation(row) {
+        return {
+            id: row.id,
+            agentId: row.agent_id,
+            fromEntity: row.from_entity,
+            toEntity: row.to_entity,
+            relationType: row.relation_type,
+            weight: row.weight,
+            validFrom: new Date(row.valid_from),
+            validUntil: row.valid_until ? new Date(row.valid_until) : null,
+            metadata: (row.metadata ?? {}),
+            createdAt: new Date(row.created_at),
+        };
+    }
+}
+//# sourceMappingURL=knowledge-graph.js.map

package/dist/knowledge-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-graph.js","sourceRoot":"","sources":["../src/knowledge-graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AAgDpB;;;;;;;;;GASG;AACH,MAAM,OAAO,cAAc;IACjB,IAAI,GAAmB,IAAI,CAAC;IAC5B,MAAM,CAAW;IACjB,OAAO,GAAW,EAAE,CAAC;IACrB,mBAAmB,CAAS;IAEpC,YAAY,MAAgB;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAAC,mBAAmB,IAAI,IAAI,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAAe;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACzE,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC;IACH,CAAC;IAED,iBAAiB;IAET,KAAK,CAAC,YAAY;QACxB,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO;QAEvB,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAE/D,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;;;;;;;2BAOC,IAAI,CAAC,mBAAmB;;;;;;;;;;;;KAY9C,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;KAuBrB,CAAC,CAAC;QAEH,6CAA6C;QAC7C,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;;;;OAIrB,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,qDAAqD;QACvD,CAAC;IACH,CAAC;IAED,sBAAsB;IAEtB;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,KAMlB;QACC,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAE9D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAExD,IAAI,QAAQ,EAAE,CAAC;YACb,mCAAmC;YACnC,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,MAAM,CAC9C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAC1C,CAAC;YACF,MAAM,SAAS,GAAG,CAAC,GAAG,QAAQ,CAAC,YAAY,EAAE,GAAG,MAAM,CAAC,CAAC;YACxD,MAAM,UAAU,GAAG,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;YAEvE,MAAM,YAAY,GAAG,KAAK,CAAC,SAAS;gBAClC,CAAC,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG;gBAClC,CAAC,CAAC,IAAI,CAAC;YAET,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CACnB;;;yBAGe,EACf,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,UAAU,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,CAAC,CACrF,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CACnB;;yBAEe,EACf,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC,CACvE,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,GAAG,QAAQ;gBACX,YAAY,EAAE,SAAS;gBACvB,QAAQ,EAAE,UAAU;gBACpB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,SAAS,EAAE,IAAI,IAAI,EAAE;aACtB,CAAC;QACJ,CAAC;QAED,aAAa;QACb,MAAM,EAAE,GAAG,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACzE,MAAM,YAAY,GAAG,KAAK,CAAC,SAAS;YAClC,CAAC,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG;YAClC,CAAC,CAAC,IAAI,CAAC;QAET,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CACnB;mDAC6C,EAC7C;YACE,EAAE;YACF,IAAI,CAAC,OAAO;YACZ,KAAK,CAAC,IAAI;YACV,KAAK,CAAC,UAAU;YAChB,KAAK,CAAC,YAAY,IAAI,EAAE;YACxB,YAAY;YACZ,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;SACrC,CACF,CAAC;QAEF,OAAO;YACL,EAAE;YACF,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,EAAE;YACtC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;YAC9B,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,IAAY;QAChC,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAE9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAClC,6DAA6D,EAC7D,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CACrB,CAAC;QAEF,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1C,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,EAAU;QAC5B,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAE9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAClC,yCAAyC,EACzC,CAAC,EAAE,CAAC,CACL,CAAC;QAEF,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1C,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,UAAkB,EAAE,YAAsB;QAC9D,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAE9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,WAAW,UAAU,aAAa,CAAC,CAAC;QAEjE,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEnC,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,YAAY,EAAE,GAAG,MAAM,CAAC,CAAC;QACnD,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CACnB,4EAA4E,EAC5E,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CACpB,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,UAAkB,EAAE,YAAsB;QACjE,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAE9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9E,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CACnB,4EAA4E,EAC5E,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,IAAY;QAC7B,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAE9D,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CACnB,2DAA2D,EAC3D,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CACrB,CAAC;IACJ,CAAC;IAED,wBAAwB;IAExB;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAAC,KAOpB;QACC,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAE9D,gCAAgC;QAChC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,UAAU,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,mCAAmC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,aAAa,CACpF,CAAC;QACJ,CAAC;QAED,kDAAkD;QAClD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CACpC;;wDAEkD,EAClD,CAAC,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,YAAY,CAAC,CACjD,CAAC;QAEF,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,0CAA0C;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,EAAE,GAAG,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACzE,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC;QAEhD,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CACnB;+CACyC,EACzC;YACE,EAAE;YACF,IAAI,CAAC,OAAO;YACZ,UAAU,CAAC,EAAE;YACb,QAAQ,CAAC,EAAE;YACX,KAAK,CAAC,YAAY;YAClB,KAAK,CAAC,MAAM,IAAI,GAAG;YACnB,SAAS;YACT,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;SACrC,CACF,CAAC;QAEF,OAAO;YACL,EAAE;YACF,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,UAAU,CAAC,EAAE;YACzB,QAAQ,EAAE,QAAQ,CAAC,EAAE;YACrB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,GAAG;YAC3B,SAAS;YACT,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;YAC9B,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,kBAAkB,CAAC,EAAU;QACjC,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAE9D,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CACnB,2DAA2D,EAC3D,CAAC,EAAE,CAAC,CACL,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,KAIpB;QACC,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAE9D,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,UAAU,IAAI,CAAC,QAAQ;YAAE,OAAO;QAErC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CACnB;wEACkE,EAClE,CAAC,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,YAAY,CAAC,CACjD,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,kBAAkB,CACtB,UAAkB,EAClB,UAAwC,EAAE;QAE1C,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAE9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QAEvB,MAAM,WAAW,GAAG,OAAO,CAAC,cAAc;YACxC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,2BAA2B,CAAC;QAEhC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAClC;;;;;;;WAOK,WAAW;kCACY,EAC5B,CAAC,MAAM,CAAC,EAAE,CAAC,CACZ,CAAC;QAEF,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC/B,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;YAC1B,QAAQ,EAAE,GAAG,CAAC,SAAmB;YACjC,MAAM,EAAE,GAAG,CAAC,OAAiB;SAC9B,CAAC,CAAC,CAAC;IACN,CAAC;IAED,iBAAiB;IAEjB;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,UAAiC,EAAE;QACtD,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAE9D,MAAM,UAAU,GAAa,CAAC,eAAe,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,GAAG,GAAG,CAAC,CAAC;QAEZ,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,UAAU,CAAC,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAChC,GAAG,EAAE,CAAC;QACR,CAAC;QAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YACtC,UAAU,CAAC,IAAI,CACb,sBAAsB,GAAG;wCACO,GAAG;qFAC0C,GAAG,IAAI,CACrF,CAAC;YACF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtB,GAAG,EAAE,CAAC;QACR,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QAElC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAClC,mCAAmC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;yCACxB,GAAG,EAAE,EACxC,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,CACnB,CAAC;QAEF,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,yBAAyB,CAC7B,cAAwB,EACxB,UAII,EAAE;QAEN,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAE9D,MAAM,UAAU,GAAa,CAAC,eAAe,EAAE,uBAAuB,CAAC,CAAC;QACxE,MAAM,MAAM,GAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,GAAG,GAAG,CAAC,CAAC;QAEZ,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,UAAU,CAAC,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAChC,GAAG,EAAE,CAAC;QACR,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;QACrD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,GAAG,CAAC;QAE3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAClC;oCAC8B,GAAG;;eAExB,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;mCACJ,GAAG,iBAAiB,GAAG,GAAG,CAAC;iCAC7B,GAAG;gBACpB,GAAG,GAAG,CAAC,EAAE,EACnB,CAAC,GAAG,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,CAAC,CAC5C,CAAC;QAEF,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC/B,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;YACxB,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,UAAoB,CAAC;SACjD,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,KAAe;QAChC,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC9D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QAE/D,eAAe;QACf,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CACxC;8CACwC,EACxC,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CACtB,CAAC;QAEF,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACzD,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAE5C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QAEnE,iEAAiE;QACjE,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CACrC;;;gCAG0B,EAC1B,CAAC,SAAS,CAAC,CACZ,CAAC;QAEF,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAEzD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,UAAwC,EAAE;QACxD,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAE9D,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CACxC,6DAA6D,EAC7D,CAAC,IAAI,CAAC,OAAO,CAAC,CACf,CAAC;QAEF,MAAM,WAAW,GAAG,OAAO,CAAC,cAAc;YACxC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,yBAAyB,CAAC;QAE9B,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CACrC,kDAAkD,WAAW,2BAA2B,EACxF,CAAC,IAAI,CAAC,OAAO,CAAC,CACf,CAAC;QAEF,OAAO;YACL,QAAQ,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC;YACjD,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC;SAClD,CAAC;IACJ,CAAC;IAED,2BAA2B;IAE3B;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,IAAU,EACV,UAAmC,EAAE;QAErC,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAE9D,MAAM,UAAU,GAAa;YAC3B,eAAe;YACf,kBAAkB;YAClB,2CAA2C;SAC5C,CAAC;QACF,MAAM,MAAM,GAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC/C,IAAI,GAAG,GAAG,CAAC,CAAC;QAEZ,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC9D,IAAI,CAAC,MAAM;gBAAE,OAAO,EAAE,CAAC;YACvB,UAAU,CAAC,IAAI,CAAC,mBAAmB,GAAG,oBAAoB,GAAG,GAAG,CAAC,CAAC;YAClE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACvB,GAAG,EAAE,CAAC;QACR,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAClC,oCAAoC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,2BAA2B,EACvF,MAAM,CACP,CAAC;QAEF,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,IAAY,EAAE,EAAU,EAAE,YAAoB;QACrE,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAE9D,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAC;QAExC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAClC;;gCAE0B,EAC1B,CAAC,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC,CAC3C,CAAC;QAEF,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC7C,CAAC;IAED,kCAAkC;IAElC;;;OAGG;IACH,KAAK,CAAC,gBAAgB,CAAC,KAMtB;QACC,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAE9D,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,UAAU,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAE1C,sCAAsC;QACtC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CACnB;;wDAEkD,EAClD,CAAC,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,YAAY,CAAC,CACjD,CAAC;QAEF,qBAAqB;QACrB,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,sBAAsB;IAEtB;;OAEG;IACH,KAAK,CAAC,mBAAmB;QACvB,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAE9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAClC;;gDAE0C,EAC1C,CAAC,IAAI,CAAC,OAAO,CAAC,CACf,CAAC;QAEF,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,CAAC,WAAqB,CAAC,GAAG,GAAG,CAAC,KAAe,CAAC;QAC1D,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,sBAAsB;IAEd,WAAW,CAAC,GAA4B;QAC9C,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,EAAY;YACpB,OAAO,EAAE,GAAG,CAAC,QAAkB;YAC/B,IAAI,EAAE,GAAG,CAAC,IAAc;YACxB,UAAU,EAAE,GAAG,CAAC,WAAqB;YACrC,YAAY,EAAE,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAa;YAClD,QAAQ,EAAE,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAA4B;YACzD,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,UAAoB,CAAC;YAC7C,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,UAAoB,CAAC;SAC9C,CAAC;IACJ,CAAC;IAEO,aAAa,CAAC,GAA4B;QAChD,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,EAAY;YACpB,OAAO,EAAE,GAAG,CAAC,QAAkB;YAC/B,UAAU,EAAE,GAAG,CAAC,WAAqB;YACrC,QAAQ,EAAE,GAAG,CAAC,SAAmB;YACjC,YAAY,EAAE,GAAG,CAAC,aAAuB;YACzC,MAAM,EAAE,GAAG,CAAC,MAAgB;YAC5B,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,UAAoB,CAAC;YAC7C,UAAU,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,WAAqB,CAAC,CAAC,CAAC,CAAC,IAAI;YACxE,QAAQ,EAAE,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAA4B;YACzD,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,UAAoB,CAAC;SAC9C,CAAC;IACJ,CAAC;CACF"}

package/dist/ltm.d.ts

@@ -0,0 +1,82 @@
+export interface LTMConfig {
+    connectionString: string;
+    /** Embedding dimensions (default: 1536 for OpenAI text-embedding-3-small) */
+    embeddingDimensions?: number;
+}
+export interface KnowledgeFact {
+    id: string;
+    agentId: string;
+    content: string;
+    category: string;
+    tags: string[];
+    embedding?: number[];
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Long-Term Memory (LTM) — PostgreSQL + pgvector knowledge store.
+ *
+ * Stores persistent semantic knowledge with embeddings for RAG retrieval.
+ * Where durable learning lives. Categorized, tagged, searchable.
+ */
+export declare class LongTermMemory {
+    private pool;
+    private config;
+    private agentId;
+    private embeddingDimensions;
+    constructor(config: LTMConfig);
+    start(agentId: string): Promise<void>;
+    stop(): Promise<void>;
+    private ensureSchema;
+    /**
+     * Store a knowledge fact with optional embedding.
+     */
+    store(fact: {
+        content: string;
+        category?: string;
+        tags?: string[];
+        embedding?: number[];
+        metadata?: Record<string, unknown>;
+    }): Promise<string>;
+    /**
+     * Semantic similarity search using embedding vector.
+     */
+    search(queryEmbedding: number[], options?: {
+        category?: string;
+        tags?: string[];
+        agentId?: string;
+        limit?: number;
+        threshold?: number;
+    }): Promise<(KnowledgeFact & {
+        similarity: number;
+    })[]>;
+    /**
+     * Full-text search (keyword-based, no embedding needed).
+     */
+    searchByText(query: string, options?: {
+        category?: string;
+        tags?: string[];
+        limit?: number;
+    }): Promise<KnowledgeFact[]>;
+    /**
+     * Get a fact by ID.
+     */
+    getById(id: string): Promise<KnowledgeFact | null>;
+    /**
+     * Update a fact's content and optionally its embedding.
+     */
+    update(id: string, updates: {
+        content?: string;
+        category?: string;
+        tags?: string[];
+        embedding?: number[];
+        metadata?: Record<string, unknown>;
+    }): Promise<void>;
+    /**
+     * Delete a fact.
+     */
+    forget(id: string): Promise<void>;
+    private rowToFact;
+}
+//# sourceMappingURL=ltm.d.ts.map

package/dist/ltm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ltm.d.ts","sourceRoot":"","sources":["../src/ltm.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAwB;IACpC,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,mBAAmB,CAAS;gBAExB,MAAM,EAAE,SAAS;IAKvB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAOb,YAAY;IAqC1B;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,MAAM,CAAC;IAyBnB;;OAEG;IACG,MAAM,CACV,cAAc,EAAE,MAAM,EAAE,EACxB,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;KACf,GACL,OAAO,CAAC,CAAC,aAAa,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IA6CtD;;OAEG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KACX,GACL,OAAO,CAAC,aAAa,EAAE,CAAC;IAsC3B;;OAEG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAYxD;;OAEG;IACG,MAAM,CACV,EAAE,EAAE,MAAM,EACV,OAAO,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GACA,OAAO,CAAC,IAAI,CAAC;IAwChB;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvC,OAAO,CAAC,SAAS;CAYlB"}