@easynet/agent-memory 0.0.2 → 1.0.0

package/dist/src/create-agent-memory.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * Create AgentMemory from YAML or default config.
+ * Returned memory.memorize supports content+type and url (local/remote PDF, txt, HTML, images).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAgentMemory = createAgentMemory;
+const config_js_1 = require("./core/config.js");
+const agent_memory_js_1 = require("./core/agent-memory.js");
+const observability_js_1 = require("./core/observability.js");
+const router_js_1 = require("./core/router.js");
+const policy_js_1 = require("./core/policy.js");
+const privacy_js_1 = require("./core/privacy.js");
+const in_memory_store_js_1 = require("./providers/in-memory-store.js");
+const sqlite_store_js_1 = require("./providers/sqlite-store.js");
+const rag_provider_js_1 = require("./providers/rag-provider.js");
+const mem0_provider_js_1 = require("./providers/mem0-provider.js");
+const url_ingest_js_1 = require("./ingest/url-ingest.js");
+const node_path_1 = require("node:path");
+const promises_1 = require("node:fs/promises");
+const DEFAULT_CONFIG_PATH = "config/agent-memory.yaml";
+/**
+ * Create AgentMemory from YAML or default config.
+ *
+ * @example
+ * const memory = await createAgentMemory();
+ * @example
+ * const memory = await createAgentMemory({ configPath: "./config/memory.yaml" });
+ * @example
+ * const mem0 = new Memory({ ... });
+ * const memory = await createAgentMemory({ configPath: "config/agent-memory.yaml", overrides: { mem0 } });
+ */
+async function createAgentMemory(options = {}) {
+    const opts = typeof options === "string" ? { configPath: options } : options;
+    let config;
+    /** When config is loaded from a file, dir of that file so relative dbPath is resolved against it. */
+    let configFileDir;
+    if (opts.config) {
+        config = opts.config;
+    }
+    else {
+        const configPath = opts.configPath ?? DEFAULT_CONFIG_PATH;
+        const resolved = configPath.startsWith("/") || configPath.match(/^[A-Za-z]:/) ? configPath : (0, node_path_1.join)(process.cwd(), configPath);
+        configFileDir = (0, node_path_1.dirname)(resolved);
+        config = await (0, config_js_1.loadConfigFromYaml)(resolved);
+    }
+    const providerMap = new Map();
+    for (const p of config.providers) {
+        if (p.type === "in_memory") {
+            providerMap.set(p.id, new in_memory_store_js_1.InMemoryStoreProvider());
+        }
+        else if (p.type === "sqlite") {
+            const providerOpts = (p.options ?? {});
+            let dbPath = providerOpts.dbPath ?? "./data/agent-memory.db";
+            if (configFileDir && !(0, node_path_1.isAbsolute)(dbPath) && dbPath !== ":memory:") {
+                dbPath = (0, node_path_1.join)(configFileDir, dbPath);
+            }
+            if (dbPath !== ":memory:") {
+                await (0, promises_1.mkdir)((0, node_path_1.dirname)(dbPath), { recursive: true });
+            }
+            providerMap.set(p.id, new sqlite_store_js_1.SqliteStoreProvider({ dbPath, embed: providerOpts.embed }));
+        }
+        else if (p.type === "rag") {
+            providerMap.set(p.id, new rag_provider_js_1.RAGProvider());
+        }
+        else if (p.type === "mem0") {
+            let mem0 = opts.overrides?.mem0;
+            if (!mem0 && config.mem0) {
+                try {
+                    const { Memory } = (await import("mem0ai/oss"));
+                    mem0 = new Memory(config.mem0);
+                }
+                catch (e) {
+                    throw new Error(`Provider type 'mem0' with config.mem0 requires the 'mem0ai' package. Install: pnpm add mem0ai. ${e?.message ?? ""}`);
+                }
+            }
+            if (!mem0) {
+                throw new Error("Provider type 'mem0' requires config.mem0 in YAML or overrides.mem0 (Memory instance from mem0ai/oss). Install: pnpm add mem0ai");
+            }
+            providerMap.set(p.id, new mem0_provider_js_1.Mem0Provider({ memory: mem0 }));
+        }
+        else {
+            throw new Error(`Unknown provider type: ${p.type}`);
+        }
+    }
+    const router = new router_js_1.MemoryRouter({
+        providers: providerMap,
+        defaultProviderId: config.router.defaultProvider,
+        rules: config.router.rules ?? [],
+    });
+    const policy = config.policy
+        ? new policy_js_1.PolicyEngine({
+            allowedWriteTypes: config.policy.allowedWriteTypes,
+            maxItemsPerType: config.policy.maxItemsPerType,
+            budgetPerType: config.policy.budgetPerType,
+        })
+        : undefined;
+    const traceRecorder = config.observability?.trace ? new observability_js_1.InMemoryTraceRecorder() : undefined;
+    const privacyGuard = new privacy_js_1.PrivacyGuard({
+        forbiddenMetadataKeys: config.privacy?.forbiddenMetadataKeys,
+        redactSecrets: config.privacy?.redactSecrets,
+    });
+    const core = new agent_memory_js_1.AgentMemory({
+        router,
+        policy,
+        traceRecorder,
+        privacyGuard,
+        classifyMemory: opts.classifyMemory,
+    });
+    const { captionFn } = opts;
+    const memorizeExtended = async (req) => {
+        if (req.url != null) {
+            const { firstItem } = await (0, url_ingest_js_1.ingestUrlToMemory)(core, {
+                url: req.url,
+                namespace: req.namespace,
+                type: "knowledge",
+                chunkSize: 800,
+                metadata: req.metadata,
+                captionFn,
+            });
+            if (firstItem)
+                return firstItem;
+            return {
+                id: "ingest-url-0",
+                type: req.type ?? "knowledge",
+                namespace: req.namespace,
+                scope: "global",
+                content: "(0 chunks)",
+                metadata: { created_at: new Date().toISOString(), updated_at: new Date().toISOString() },
+            };
+        }
+        if (req.content != null) {
+            return core.memorize(req);
+        }
+        throw new Error("memorize requires url or content");
+    };
+    const result = {
+        memorize: memorizeExtended,
+        write: (req) => memorizeExtended(req),
+        recall: (req) => core.recall(req),
+        retrieveForPrompt: (req) => core.retrieveForPrompt(req),
+        deleteByNamespace: (ns) => core.deleteByNamespace(ns),
+        getByKey: (ns, key) => core.getByKey(ns, key),
+        deleteByKey: (ns, key) => core.deleteByKey(ns, key),
+    };
+    return result;
+}
+//# sourceMappingURL=create-agent-memory.js.map

package/dist/src/create-agent-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-agent-memory.js","sourceRoot":"","sources":["../../src/create-agent-memory.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * agent-memory: unified memory layer for LangChain / LangGraph / DeepAgents.
+ * Single package exporting core, providers, ingest, and integrations.
+ */
+export * from "./core/types.js";
+export * from "./core/policy.js";
+export * from "./core/observability.js";
+export * from "./core/privacy.js";
+export * from "./core/router.js";
+export * from "./core/agent-memory.js";
+export * from "./core/config.js";
+export { InMemoryStoreProvider } from "./providers/in-memory-store.js";
+export { SqliteStoreProvider, type SqliteStoreOptions } from "./providers/sqlite-store.js";
+export { RAGProvider, type RAGProviderOptions } from "./providers/rag-provider.js";
+export { Mem0Provider, type Mem0ProviderOptions, type Mem0MemoryLike, } from "./providers/mem0-provider.js";
+export { createAgentMemory, type CreateAgentMemoryOptions, type CreateAgentMemoryResult, type MemorizeRequestWithIngest, } from "./create-agent-memory.js";
+export { AgentMemoryStoreAdapter, type AgentMemoryStoreAdapterOptions } from "./integrations/deepagents-adapter.js";
+export { retrieveContextForLangChain, writeMemoryForLangChain, type RetrieveForLangChainOptions, type LangChainMemoryLike, } from "./integrations/langchain.js";
+export { injectMemoryIntoState, writeMemoryFromNode, type InjectMemoryIntoStateOptions, } from "./integrations/langgraph.js";
+export { ingestPdfToMemory, type IngestPdfOptions, } from "./ingest/pdf-ingest.js";
+export { ingestUrlToMemory, type IngestUrlOptions, } from "./ingest/url-ingest.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AAEjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACnF,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,GAC/B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,uBAAuB,EAAE,KAAK,8BAA8B,EAAE,MAAM,sCAAsC,CAAC;AACpH,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,GACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,4BAA4B,GAClC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,iBAAiB,EACjB,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,EACjB,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * agent-memory: unified memory layer for LangChain / LangGraph / DeepAgents.
+ * Single package exporting core, providers, ingest, and integrations.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ingestUrlToMemory = exports.ingestPdfToMemory = exports.writeMemoryFromNode = exports.injectMemoryIntoState = exports.writeMemoryForLangChain = exports.retrieveContextForLangChain = exports.AgentMemoryStoreAdapter = exports.createAgentMemory = exports.Mem0Provider = exports.RAGProvider = exports.SqliteStoreProvider = exports.InMemoryStoreProvider = void 0;
+__exportStar(require("./core/types.js"), exports);
+__exportStar(require("./core/policy.js"), exports);
+__exportStar(require("./core/observability.js"), exports);
+__exportStar(require("./core/privacy.js"), exports);
+__exportStar(require("./core/router.js"), exports);
+__exportStar(require("./core/agent-memory.js"), exports);
+__exportStar(require("./core/config.js"), exports);
+var in_memory_store_js_1 = require("./providers/in-memory-store.js");
+Object.defineProperty(exports, "InMemoryStoreProvider", { enumerable: true, get: function () { return in_memory_store_js_1.InMemoryStoreProvider; } });
+var sqlite_store_js_1 = require("./providers/sqlite-store.js");
+Object.defineProperty(exports, "SqliteStoreProvider", { enumerable: true, get: function () { return sqlite_store_js_1.SqliteStoreProvider; } });
+var rag_provider_js_1 = require("./providers/rag-provider.js");
+Object.defineProperty(exports, "RAGProvider", { enumerable: true, get: function () { return rag_provider_js_1.RAGProvider; } });
+var mem0_provider_js_1 = require("./providers/mem0-provider.js");
+Object.defineProperty(exports, "Mem0Provider", { enumerable: true, get: function () { return mem0_provider_js_1.Mem0Provider; } });
+var create_agent_memory_js_1 = require("./create-agent-memory.js");
+Object.defineProperty(exports, "createAgentMemory", { enumerable: true, get: function () { return create_agent_memory_js_1.createAgentMemory; } });
+var deepagents_adapter_js_1 = require("./integrations/deepagents-adapter.js");
+Object.defineProperty(exports, "AgentMemoryStoreAdapter", { enumerable: true, get: function () { return deepagents_adapter_js_1.AgentMemoryStoreAdapter; } });
+var langchain_js_1 = require("./integrations/langchain.js");
+Object.defineProperty(exports, "retrieveContextForLangChain", { enumerable: true, get: function () { return langchain_js_1.retrieveContextForLangChain; } });
+Object.defineProperty(exports, "writeMemoryForLangChain", { enumerable: true, get: function () { return langchain_js_1.writeMemoryForLangChain; } });
+var langgraph_js_1 = require("./integrations/langgraph.js");
+Object.defineProperty(exports, "injectMemoryIntoState", { enumerable: true, get: function () { return langgraph_js_1.injectMemoryIntoState; } });
+Object.defineProperty(exports, "writeMemoryFromNode", { enumerable: true, get: function () { return langgraph_js_1.writeMemoryFromNode; } });
+var pdf_ingest_js_1 = require("./ingest/pdf-ingest.js");
+Object.defineProperty(exports, "ingestPdfToMemory", { enumerable: true, get: function () { return pdf_ingest_js_1.ingestPdfToMemory; } });
+var url_ingest_js_1 = require("./ingest/url-ingest.js");
+Object.defineProperty(exports, "ingestUrlToMemory", { enumerable: true, get: function () { return url_ingest_js_1.ingestUrlToMemory; } });
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,kDAAgC;AAChC,mDAAiC;AACjC,0DAAwC;AACxC,oDAAkC;AAClC,mDAAiC;AACjC,yDAAuC;AACvC,mDAAiC;AAEjC,qEAAuE;AAA9D,2HAAA,qBAAqB,OAAA;AAC9B,+DAA2F;AAAlF,sHAAA,mBAAmB,OAAA;AAC5B,+DAAmF;AAA1E,8GAAA,WAAW,OAAA;AACpB,iEAIsC;AAHpC,gHAAA,YAAY,OAAA;AAId,mEAKkC;AAJhC,2HAAA,iBAAiB,OAAA;AAMnB,8EAAoH;AAA3G,gIAAA,uBAAuB,OAAA;AAChC,4DAKqC;AAJnC,2HAAA,2BAA2B,OAAA;AAC3B,uHAAA,uBAAuB,OAAA;AAIzB,4DAIqC;AAHnC,qHAAA,qBAAqB,OAAA;AACrB,mHAAA,mBAAmB,OAAA;AAGrB,wDAGgC;AAF9B,kHAAA,iBAAiB,OAAA;AAGnB,wDAGgC;AAF9B,kHAAA,iBAAiB,OAAA"}

package/dist/src/ingest/pdf-ingest.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Ingest PDF from file path or URL into agent-memory.
+ * Optional: install pdf-parse to use (e.g. pnpm add pdf-parse).
+ */
+import type { AgentMemory } from "../core/agent-memory.js";
+import type { MemoryItem } from "../core/types.js";
+export interface IngestPdfOptions {
+    /** PDF file path (e.g. ./doc.pdf) or URL (e.g. https://example.com/doc.pdf). */
+    pdf: string;
+    /** Namespace for stored memories (e.g. project:docs). */
+    namespace: string;
+    /** Memory type for text chunks. Default: knowledge. */
+    type?: "knowledge";
+    /** Approximate chars per chunk. Default: 800. */
+    chunkSize?: number;
+    /** Optional metadata for all chunks (e.g. doc_id, source). */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Load a PDF from path or URL, extract text, chunk it, and store each chunk
+ * into agent-memory with the given namespace and type.
+ */
+export declare function ingestPdfToMemory(memory: AgentMemory, options: IngestPdfOptions): Promise<{
+    count: number;
+    firstItem?: MemoryItem;
+}>;
+//# sourceMappingURL=pdf-ingest.d.ts.map

package/dist/src/ingest/pdf-ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-ingest.d.ts","sourceRoot":"","sources":["../../../src/ingest/pdf-ingest.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AA0DD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,UAAU,CAAA;CAAE,CAAC,CA0BpD"}

package/dist/src/ingest/pdf-ingest.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * Ingest PDF from file path or URL into agent-memory.
+ * Optional: install pdf-parse to use (e.g. pnpm add pdf-parse).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ingestPdfToMemory = ingestPdfToMemory;
+function isUrl(s) {
+    return /^https?:\/\//i.test(s);
+}
+async function getPdfBuffer(pdf) {
+    if (isUrl(pdf)) {
+        const res = await fetch(pdf);
+        if (!res.ok)
+            throw new Error(`Failed to fetch PDF: ${res.status} ${res.statusText}`);
+        const ab = await res.arrayBuffer();
+        return Buffer.from(ab);
+    }
+    const { readFile } = await import("node:fs/promises");
+    return readFile(pdf);
+}
+function chunkText(text, chunkSize) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return [];
+    const chunks = [];
+    const paragraphs = trimmed.split(/\n\n+/);
+    let current = "";
+    for (const p of paragraphs) {
+        if (current.length + p.length + 2 <= chunkSize) {
+            current = current ? `${current}\n\n${p}` : p;
+        }
+        else {
+            if (current)
+                chunks.push(current);
+            if (p.length <= chunkSize) {
+                current = p;
+            }
+            else {
+                for (let i = 0; i < p.length; i += chunkSize) {
+                    chunks.push(p.slice(i, i + chunkSize));
+                }
+                current = "";
+            }
+        }
+    }
+    if (current)
+        chunks.push(current);
+    return chunks;
+}
+async function extractTextFromPdf(buffer) {
+    try {
+        const pdfParse = (await import("pdf-parse")).default;
+        const data = await pdfParse(buffer);
+        return typeof data?.text === "string" ? data.text : "";
+    }
+    catch (e) {
+        const err = e;
+        if (err?.code === "ERR_MODULE_NOT_FOUND" || err?.message?.includes("pdf-parse")) {
+            throw new Error("PDF ingestion requires pdf-parse. Install it: pnpm add pdf-parse");
+        }
+        throw e;
+    }
+}
+/**
+ * Load a PDF from path or URL, extract text, chunk it, and store each chunk
+ * into agent-memory with the given namespace and type.
+ */
+async function ingestPdfToMemory(memory, options) {
+    const { pdf, namespace, type = "knowledge", chunkSize = 800, metadata = {}, } = options;
+    const buffer = await getPdfBuffer(pdf);
+    const text = await extractTextFromPdf(buffer);
+    const chunks = chunkText(text, chunkSize);
+    let firstItem;
+    for (const content of chunks) {
+        if (!content.trim())
+            continue;
+        const item = await memory.memorize({
+            namespace,
+            type,
+            content,
+            metadata: { ...metadata, source: "doc" },
+        });
+        if (!firstItem)
+            firstItem = item;
+    }
+    return { count: chunks.length, firstItem };
+}
+//# sourceMappingURL=pdf-ingest.js.map

package/dist/src/ingest/pdf-ingest.js.map

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

package/dist/src/ingest/url-ingest.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Ingest from a single URL: local path (PDF/txt/HTML/image) or remote URL.
+ * Format/media detection is for ingest pipeline only—not use-case routing; routing is config-driven.
+ * PDF requires pdf-parse; images may use captionFn for caption.
+ * Chunking is paragraph-based (semantic); we never store image binaries—only caption + URL.
+ */
+import type { AgentMemory } from "../core/agent-memory.js";
+import type { MemoryItem } from "../core/types.js";
+export interface IngestUrlOptions {
+    /** Local path (e.g. ./doc.pdf) or remote URL; format detected by content-type/extension. */
+    url: string;
+    namespace: string;
+    type?: "knowledge";
+    /** Approximate chars per chunk; paragraph-based semantic chunking. Default 800. */
+    chunkSize?: number;
+    metadata?: Record<string, unknown>;
+    /** For images: generate caption (VLM); we store caption + URL only, never the image binary. */
+    captionFn?: (buffer: Buffer) => Promise<string>;
+}
+/**
+ * Ingest from local path or remote URL; detect PDF/txt/HTML/image by format, then write as knowledge.
+ */
+export declare function ingestUrlToMemory(memory: AgentMemory, options: IngestUrlOptions): Promise<{
+    count: number;
+    firstItem?: MemoryItem;
+}>;
+//# sourceMappingURL=url-ingest.d.ts.map

package/dist/src/ingest/url-ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-ingest.d.ts","sourceRoot":"","sources":["../../../src/ingest/url-ingest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,4FAA4F;IAC5F,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,+FAA+F;IAC/F,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACjD;AAoLD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,UAAU,CAAA;CAAE,CAAC,CA2GpD"}