@tonycasey/lisa 1.2.0 → 2.0.0

package/dist/lib/infrastructure/dal/repositories/neo4j/Neo4jMemoryRepository.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Neo4j Memory Repository
+ *
+ * Read-only memory repository using direct Neo4j Cypher queries.
+ * Optimized for date-ordered listing and aggregations.
+ */
+import type { IReadOnlyMemoryRepository, IQueryOptions, IMemoryQueryResult } from '../../../../domain/interfaces/dal';
+import { Neo4jConnectionManager } from '../../connections/Neo4jConnectionManager';
+/**
+ * Neo4j Memory Repository implementation.
+ * Read-only: writes go through MCP for proper Graphiti ingestion.
+ */
+export declare class Neo4jMemoryRepository implements IReadOnlyMemoryRepository {
+    private readonly connection;
+    constructor(connection: Neo4jConnectionManager);
+    /**
+     * Find facts by group IDs with optional filtering and sorting.
+     */
+    findByGroupIds(groupIds: readonly string[], options?: IQueryOptions): Promise<IMemoryQueryResult>;
+    /**
+     * Semantic search is NOT supported by Neo4j direct.
+     * Throws an error - use MCP repository for semantic search.
+     */
+    search(_groupIds: readonly string[], _query: string, _options?: Omit<IQueryOptions, 'query'>): Promise<IMemoryQueryResult>;
+    /**
+     * Find facts by tags.
+     * Note: Tag filtering depends on how Graphiti stores tags in Neo4j.
+     */
+    findByTags(groupIds: readonly string[], tags: readonly string[], options?: Omit<IQueryOptions, 'tags'>): Promise<IMemoryQueryResult>;
+    /**
+     * Neo4j does not support semantic search.
+     */
+    supportsSemanticSearch(): boolean;
+    /**
+     * Neo4j excels at date-ordered queries.
+     */
+    supportsDateOrdering(): boolean;
+    /**
+     * Neo4j direct is read-only (writes go through MCP).
+     */
+    supportsWrite(): boolean;
+    /**
+     * Convert Neo4j record to IMemoryItem.
+     */
+    private toMemoryItem;
+}
+//# sourceMappingURL=Neo4jMemoryRepository.d.ts.map

package/dist/lib/infrastructure/dal/repositories/neo4j/Neo4jMemoryRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Neo4jMemoryRepository.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/infrastructure/dal/repositories/neo4j/Neo4jMemoryRepository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,yBAAyB,EACzB,aAAa,EACb,kBAAkB,EACnB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAgBlF;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,yBAAyB;IACzD,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,sBAAsB;IAE/D;;OAEG;IACG,cAAc,CAClB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,kBAAkB,CAAC;IAmD9B;;;OAGG;IACG,MAAM,CACV,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,GACtC,OAAO,CAAC,kBAAkB,CAAC;IAM9B;;;OAGG;IACG,UAAU,CACd,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GACpC,OAAO,CAAC,kBAAkB,CAAC;IAgD9B;;OAEG;IACH,sBAAsB,IAAI,OAAO;IAIjC;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,OAAO,CAAC,YAAY;CAQrB"}

package/dist/lib/infrastructure/dal/repositories/neo4j/Neo4jMemoryRepository.js

@@ -0,0 +1,144 @@
+"use strict";
+/**
+ * Neo4j Memory Repository
+ *
+ * Read-only memory repository using direct Neo4j Cypher queries.
+ * Optimized for date-ordered listing and aggregations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Neo4jMemoryRepository = void 0;
+const dal_1 = require("../../../../domain/interfaces/dal");
+/**
+ * Neo4j Memory Repository implementation.
+ * Read-only: writes go through MCP for proper Graphiti ingestion.
+ */
+class Neo4jMemoryRepository {
+    constructor(connection) {
+        this.connection = connection;
+    }
+    /**
+     * Find facts by group IDs with optional filtering and sorting.
+     */
+    async findByGroupIds(groupIds, options) {
+        const opts = (0, dal_1.applyQueryDefaults)(options);
+        const { limit, offset, sort, includeExpired, since, until } = opts;
+        // Build Cypher query
+        const groupList = groupIds.map((g) => `"${g}"`).join(', ');
+        const sortField = `r.${sort?.field || 'created_at'}`;
+        const sortOrder = sort?.order === 'asc' ? 'ASC' : 'DESC';
+        // Build WHERE clauses
+        const whereClauses = [
+            `r.group_id IN [${groupList}]`,
+            `r.fact IS NOT NULL`,
+        ];
+        if (!includeExpired) {
+            whereClauses.push(`r.expired_at IS NULL`);
+        }
+        if (since) {
+            whereClauses.push(`r.created_at >= datetime("${since.toISOString()}")`);
+        }
+        if (until) {
+            whereClauses.push(`r.created_at <= datetime("${until.toISOString()}")`);
+        }
+        const whereClause = whereClauses.join(' AND ');
+        const cypher = `
+      MATCH (s:Entity)-[r]->(t:Entity)
+      WHERE ${whereClause}
+      RETURN r.uuid AS uuid, r.group_id AS group_id, r.name AS name,
+             r.fact AS fact, r.created_at AS created_at,
+             r.valid_at AS valid_at, r.invalid_at AS invalid_at,
+             r.expired_at AS expired_at
+      ORDER BY ${sortField} ${sortOrder}
+      SKIP ${offset}
+      LIMIT ${limit}
+    `;
+        const records = await this.connection.query(cypher);
+        const items = records.map(this.toMemoryItem);
+        return {
+            items,
+            source: 'neo4j',
+            hasMore: items.length === limit,
+        };
+    }
+    /**
+     * Semantic search is NOT supported by Neo4j direct.
+     * Throws an error - use MCP repository for semantic search.
+     */
+    async search(_groupIds, _query, _options) {
+        throw new Error('Neo4j repository does not support semantic search. Use MCP repository instead.');
+    }
+    /**
+     * Find facts by tags.
+     * Note: Tag filtering depends on how Graphiti stores tags in Neo4j.
+     */
+    async findByTags(groupIds, tags, options) {
+        const opts = (0, dal_1.applyQueryDefaults)(options);
+        const { limit, offset, sort, includeExpired } = opts;
+        const groupList = groupIds.map((g) => `"${g}"`).join(', ');
+        const tagList = tags.map((t) => `"${t}"`).join(', ');
+        const sortField = `r.${sort?.field || 'created_at'}`;
+        const sortOrder = sort?.order === 'asc' ? 'ASC' : 'DESC';
+        const whereClauses = [
+            `r.group_id IN [${groupList}]`,
+            `r.fact IS NOT NULL`,
+        ];
+        if (!includeExpired) {
+            whereClauses.push(`r.expired_at IS NULL`);
+        }
+        // Add tag filter - Graphiti may store tags differently
+        // This assumes tags are stored in an array property
+        if (tags.length > 0) {
+            whereClauses.push(`ANY(tag IN [${tagList}] WHERE tag IN r.tags)`);
+        }
+        const whereClause = whereClauses.join(' AND ');
+        const cypher = `
+      MATCH (s:Entity)-[r]->(t:Entity)
+      WHERE ${whereClause}
+      RETURN r.uuid AS uuid, r.group_id AS group_id, r.name AS name,
+             r.fact AS fact, r.created_at AS created_at,
+             r.valid_at AS valid_at, r.invalid_at AS invalid_at,
+             r.expired_at AS expired_at
+      ORDER BY ${sortField} ${sortOrder}
+      SKIP ${offset}
+      LIMIT ${limit}
+    `;
+        const records = await this.connection.query(cypher);
+        const items = records.map(this.toMemoryItem);
+        return {
+            items,
+            source: 'neo4j',
+            hasMore: items.length === limit,
+        };
+    }
+    /**
+     * Neo4j does not support semantic search.
+     */
+    supportsSemanticSearch() {
+        return false;
+    }
+    /**
+     * Neo4j excels at date-ordered queries.
+     */
+    supportsDateOrdering() {
+        return true;
+    }
+    /**
+     * Neo4j direct is read-only (writes go through MCP).
+     */
+    supportsWrite() {
+        return false;
+    }
+    /**
+     * Convert Neo4j record to IMemoryItem.
+     */
+    toMemoryItem(record) {
+        return {
+            uuid: record.uuid,
+            name: record.name,
+            fact: record.fact,
+            created_at: record.created_at,
+        };
+    }
+}
+exports.Neo4jMemoryRepository = Neo4jMemoryRepository;
+//# sourceMappingURL=Neo4jMemoryRepository.js.map

package/dist/lib/infrastructure/dal/repositories/neo4j/Neo4jMemoryRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Neo4jMemoryRepository.js","sourceRoot":"","sources":["../../../../../../src/lib/infrastructure/dal/repositories/neo4j/Neo4jMemoryRepository.ts"],"names":[],"mappings":"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"}

package/dist/lib/infrastructure/dal/repositories/neo4j/Neo4jTaskRepository.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Neo4j Task Repository
+ *
+ * Read-only task repository using direct Neo4j Cypher queries.
+ * Optimized for task aggregations and status queries.
+ */
+import type { ITask, ITaskCounts } from '../../../../domain/interfaces/types/ITask';
+import type { IReadOnlyTaskRepository, IQueryOptions, ITaskQueryResult } from '../../../../domain/interfaces/dal';
+import { Neo4jConnectionManager } from '../../connections/Neo4jConnectionManager';
+/**
+ * Neo4j Task Repository implementation.
+ * Read-only: writes go through MCP.
+ */
+export declare class Neo4jTaskRepository implements IReadOnlyTaskRepository {
+    private readonly connection;
+    constructor(connection: Neo4jConnectionManager);
+    /**
+     * Find tasks by group IDs.
+     */
+    findByGroupIds(groupIds: readonly string[], options?: IQueryOptions): Promise<ITaskQueryResult>;
+    /**
+     * Find a task by its key.
+     */
+    findByKey(groupId: string, taskKey: string): Promise<ITask | null>;
+    /**
+     * Find tasks by status.
+     */
+    findByStatus(groupIds: readonly string[], status: ITask['status'], options?: Omit<IQueryOptions, 'tags'>): Promise<ITaskQueryResult>;
+    /**
+     * Get task counts by status using Cypher aggregation.
+     */
+    getCounts(groupIds: readonly string[]): Promise<ITaskCounts>;
+    /**
+     * Neo4j direct is read-only.
+     */
+    supportsWrite(): boolean;
+    /**
+     * Neo4j excels at aggregations.
+     */
+    supportsAggregation(): boolean;
+    /**
+     * Convert Neo4j record to ITask.
+     */
+    private toTask;
+}
+//# sourceMappingURL=Neo4jTaskRepository.d.ts.map

package/dist/lib/infrastructure/dal/repositories/neo4j/Neo4jTaskRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Neo4jTaskRepository.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/infrastructure/dal/repositories/neo4j/Neo4jTaskRepository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,KAAK,EACV,uBAAuB,EACvB,aAAa,EACb,gBAAgB,EACjB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAalF;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,uBAAuB;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,sBAAsB;IAE/D;;OAEG;IACG,cAAc,CAClB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,gBAAgB,CAAC;IAiC5B;;OAEG;IACG,SAAS,CACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAqBxB;;OAEG;IACG,YAAY,CAChB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,EACvB,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GACpC,OAAO,CAAC,gBAAgB,CAAC;IAiC5B;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAkClE;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAI9B;;OAEG;IACH,OAAO,CAAC,MAAM;CASf"}

package/dist/lib/infrastructure/dal/repositories/neo4j/Neo4jTaskRepository.js

@@ -0,0 +1,160 @@
+"use strict";
+/**
+ * Neo4j Task Repository
+ *
+ * Read-only task repository using direct Neo4j Cypher queries.
+ * Optimized for task aggregations and status queries.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Neo4jTaskRepository = void 0;
+const dal_1 = require("../../../../domain/interfaces/dal");
+/**
+ * Neo4j Task Repository implementation.
+ * Read-only: writes go through MCP.
+ */
+class Neo4jTaskRepository {
+    constructor(connection) {
+        this.connection = connection;
+    }
+    /**
+     * Find tasks by group IDs.
+     */
+    async findByGroupIds(groupIds, options) {
+        const opts = (0, dal_1.applyQueryDefaults)(options);
+        const { limit, offset, sort } = opts;
+        const groupList = groupIds.map((g) => `"${g}"`).join(', ');
+        const sortField = sort?.field === 'created_at' ? 'n.created_at' : 'n.title';
+        const sortOrder = sort?.order === 'asc' ? 'ASC' : 'DESC';
+        // Query for Task nodes in Graphiti's schema
+        const cypher = `
+      MATCH (n:Entity)
+      WHERE n.group_id IN [${groupList}]
+        AND n.name STARTS WITH 'Task:'
+      RETURN n.uuid AS key, 
+             n.status AS status,
+             n.name AS title,
+             n.blocked AS blocked,
+             n.created_at AS created_at
+      ORDER BY ${sortField} ${sortOrder}
+      SKIP ${offset}
+      LIMIT ${limit}
+    `;
+        const records = await this.connection.query(cypher);
+        const items = records.map(this.toTask);
+        return {
+            items,
+            source: 'neo4j',
+            hasMore: items.length === limit,
+        };
+    }
+    /**
+     * Find a task by its key.
+     */
+    async findByKey(groupId, taskKey) {
+        const cypher = `
+      MATCH (n:Entity)
+      WHERE n.group_id = $groupId
+        AND n.uuid = $taskKey
+      RETURN n.uuid AS key,
+             n.status AS status,
+             n.name AS title,
+             n.blocked AS blocked,
+             n.created_at AS created_at
+      LIMIT 1
+    `;
+        const records = await this.connection.query(cypher, {
+            groupId,
+            taskKey,
+        });
+        return records.length > 0 ? this.toTask(records[0]) : null;
+    }
+    /**
+     * Find tasks by status.
+     */
+    async findByStatus(groupIds, status, options) {
+        const opts = (0, dal_1.applyQueryDefaults)(options);
+        const { limit, offset, sort } = opts;
+        const groupList = groupIds.map((g) => `"${g}"`).join(', ');
+        const sortField = sort?.field === 'created_at' ? 'n.created_at' : 'n.title';
+        const sortOrder = sort?.order === 'asc' ? 'ASC' : 'DESC';
+        const cypher = `
+      MATCH (n:Entity)
+      WHERE n.group_id IN [${groupList}]
+        AND n.name STARTS WITH 'Task:'
+        AND n.status = $status
+      RETURN n.uuid AS key,
+             n.status AS status,
+             n.name AS title,
+             n.blocked AS blocked,
+             n.created_at AS created_at
+      ORDER BY ${sortField} ${sortOrder}
+      SKIP ${offset}
+      LIMIT ${limit}
+    `;
+        const records = await this.connection.query(cypher, { status });
+        const items = records.map(this.toTask);
+        return {
+            items,
+            source: 'neo4j',
+            hasMore: items.length === limit,
+        };
+    }
+    /**
+     * Get task counts by status using Cypher aggregation.
+     */
+    async getCounts(groupIds) {
+        const groupList = groupIds.map((g) => `"${g}"`).join(', ');
+        const cypher = `
+      MATCH (n:Entity)
+      WHERE n.group_id IN [${groupList}]
+        AND n.name STARTS WITH 'Task:'
+      RETURN n.status AS status, count(n) AS count
+    `;
+        const records = await this.connection.query(cypher);
+        // Use mutable object then cast to readonly
+        const mutableCounts = {
+            ready: 0,
+            'in-progress': 0,
+            blocked: 0,
+            done: 0,
+            closed: 0,
+            unknown: 0,
+        };
+        for (const record of records) {
+            const status = record.status;
+            if (status in mutableCounts) {
+                mutableCounts[status] = record.count;
+            }
+            else {
+                mutableCounts.unknown += record.count;
+            }
+        }
+        return mutableCounts;
+    }
+    /**
+     * Neo4j direct is read-only.
+     */
+    supportsWrite() {
+        return false;
+    }
+    /**
+     * Neo4j excels at aggregations.
+     */
+    supportsAggregation() {
+        return true;
+    }
+    /**
+     * Convert Neo4j record to ITask.
+     */
+    toTask(record) {
+        return {
+            key: record.key,
+            status: record.status || 'unknown',
+            title: record.title?.replace(/^Task:\s*/, '') || '',
+            blocked: record.blocked || [],
+            created_at: record.created_at,
+        };
+    }
+}
+exports.Neo4jTaskRepository = Neo4jTaskRepository;
+//# sourceMappingURL=Neo4jTaskRepository.js.map

package/dist/lib/infrastructure/dal/repositories/neo4j/Neo4jTaskRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Neo4jTaskRepository.js","sourceRoot":"","sources":["../../../../../../src/lib/infrastructure/dal/repositories/neo4j/Neo4jTaskRepository.ts"],"names":[],"mappings":"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"}

package/dist/lib/infrastructure/dal/repositories/neo4j/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Neo4j Repository Exports
+ */
+export { Neo4jMemoryRepository } from './Neo4jMemoryRepository';
+export { Neo4jTaskRepository } from './Neo4jTaskRepository';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/infrastructure/dal/repositories/neo4j/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/infrastructure/dal/repositories/neo4j/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/lib/infrastructure/dal/repositories/neo4j/index.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Neo4j Repository Exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Neo4jTaskRepository = exports.Neo4jMemoryRepository = void 0;
+var Neo4jMemoryRepository_1 = require("./Neo4jMemoryRepository");
+Object.defineProperty(exports, "Neo4jMemoryRepository", { enumerable: true, get: function () { return Neo4jMemoryRepository_1.Neo4jMemoryRepository; } });
+var Neo4jTaskRepository_1 = require("./Neo4jTaskRepository");
+Object.defineProperty(exports, "Neo4jTaskRepository", { enumerable: true, get: function () { return Neo4jTaskRepository_1.Neo4jTaskRepository; } });
+//# sourceMappingURL=index.js.map

package/dist/lib/infrastructure/dal/repositories/neo4j/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/lib/infrastructure/dal/repositories/neo4j/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAC9B,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA"}

package/dist/lib/infrastructure/dal/repositories/zep/ZepMemoryRepository.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Zep Cloud Memory Repository
+ *
+ * Memory repository using Zep Cloud REST API.
+ * Cloud-based alternative that doesn't require Docker.
+ */
+import type { IMemoryItem } from '../../../../domain/interfaces/types/IMemoryResult';
+import type { IMemoryRepository, IMemorySaveOptions, IQueryOptions, IMemoryQueryResult } from '../../../../domain/interfaces/dal';
+import { ZepConnectionManager } from '../../connections/ZepConnectionManager';
+/**
+ * Zep Cloud Memory Repository implementation.
+ * Uses Zep's native graph API for memory storage.
+ */
+export declare class ZepMemoryRepository implements IMemoryRepository {
+    private readonly connection;
+    constructor(connection: ZepConnectionManager);
+    /**
+     * Find facts by group IDs using Zep graph search.
+     */
+    findByGroupIds(groupIds: readonly string[], options?: IQueryOptions): Promise<IMemoryQueryResult>;
+    /**
+     * Semantic search using Zep's graph search.
+     */
+    search(groupIds: readonly string[], query: string, options?: Omit<IQueryOptions, 'query'>): Promise<IMemoryQueryResult>;
+    /**
+     * Find facts by tags.
+     * Note: Zep may not support tag filtering directly.
+     */
+    findByTags(groupIds: readonly string[], tags: readonly string[], options?: Omit<IQueryOptions, 'tags'>): Promise<IMemoryQueryResult>;
+    /**
+     * Save a fact via Zep threads API.
+     */
+    save(groupId: string, content: string, options?: IMemorySaveOptions): Promise<IMemoryItem>;
+    /**
+     * Save multiple facts in batch.
+     */
+    saveBatch(groupId: string, facts: readonly string[], options?: IMemorySaveOptions): Promise<readonly IMemoryItem[]>;
+    /**
+     * Zep supports semantic search.
+     */
+    supportsSemanticSearch(): boolean;
+    /**
+     * Zep supports date ordering (via client-side sort).
+     */
+    supportsDateOrdering(): boolean;
+    /**
+     * Zep supports write operations.
+     */
+    supportsWrite(): boolean;
+    /**
+     * Convert Zep edge to IMemoryItem.
+     */
+    private toMemoryItem;
+}
+//# sourceMappingURL=ZepMemoryRepository.d.ts.map

package/dist/lib/infrastructure/dal/repositories/zep/ZepMemoryRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZepMemoryRepository.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/infrastructure/dal/repositories/zep/ZepMemoryRepository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mDAAmD,CAAC;AACrF,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EACnB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AA0B9E;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,iBAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,oBAAoB;IAE7D;;OAEG;IACG,cAAc,CAClB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,kBAAkB,CAAC;IA8C9B;;OAEG;IACG,MAAM,CACV,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,kBAAkB,CAAC;IAI9B;;;OAGG;IACG,UAAU,CACd,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GACpC,OAAO,CAAC,kBAAkB,CAAC;IAqB9B;;OAEG;IACG,IAAI,CACR,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC;IAuCvB;;OAEG;IACG,SAAS,CACb,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC;IAWlC;;OAEG;IACH,sBAAsB,IAAI,OAAO;IAIjC;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,OAAO,CAAC,YAAY;CAQrB"}