@ainetwork/adk 0.0.1

package/dist/cjs/modules/fol/fol.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fol.module.js","sourceRoot":"","sources":["../../../../src/modules/fol/fol.module.ts"],"names":[],"mappings":";;;AAEA,iDAA4C;AAG5C,MAAa,SAAS;IAIrB,YAAY,KAAkC,EAAE,QAAkB;QACjE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,IAAY;QAC7C,IAAI,CAAC;YACJ,gBAAgB;YAChB,MAAM,aAAa,GAAG,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI;gBACpE,SAAS,EAAE,EAAE;gBACb,UAAU,EAAE,EAAE;gBACd,KAAK,EAAE,EAAE;aACT,CAAC;YAEF,6BAA6B;YAC7B,MAAM,oBAAoB,GAAG,aAAa,CAAC,SAAS;iBAClD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;iBACzC,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,MAAM,qBAAqB,GAAG,aAAa,CAAC,UAAU;iBACpD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;iBACzC,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,MAAM,gBAAgB,GAAG,aAAa,CAAC,KAAK;iBAC1C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;iBACzC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEb,sBAAsB;YACtB,MAAM,MAAM,GAAG;;;WAGP,IAAI;;gBAEC,oBAAoB;iBACnB,qBAAqB;YAC1B,gBAAgB;;;;;;;;;;;;;;;;;;;;qBAoBP,CAAC;YAEnB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;YACpE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAElD,mBAAO,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAE5B,8CAA8C;YAC9C,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;YAE5C,kBAAkB;YAClB,MAAM,SAAS,GAAG,YAAY,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;YACrD,IAAI,CAAC,SAAS,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAChD,CAAC;YAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YAE5C,+BAA+B;YAC/B,MAAM,SAAS,GAAG,CACjB,QAAiD,EACjD,QAAiD,EAChD,EAAE;gBACH,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;gBACzC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE;oBAC1C,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;gBAC/B,CAAC,CAAC,CAAC;gBACH,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE;oBAC1C,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;gBAC/B,CAAC,CAAC,CAAC;gBACH,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;oBACjE,IAAI;oBACJ,WAAW;iBACX,CAAC,CAAC,CAAC;YACL,CAAC,CAAC;YAEF,MAAM,YAAY,GAAU;gBAC3B,SAAS,EAAE,SAAS,CACnB,aAAa,CAAC,SAAS,EACvB,UAAU,CAAC,SAAS,IAAI,EAAE,CAC1B;gBACD,UAAU,EAAE,SAAS,CACpB,aAAa,CAAC,UAAU,EACxB,UAAU,CAAC,UAAU,IAAI,EAAE,CAC3B;gBACD,KAAK,EAAE,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC;aAC7D,CAAC;YAEF,YAAY;YACZ,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YAEpD,mBAAO,CAAC,GAAG,CAAC,IAAI,CAAC,6BAA6B,MAAM,GAAG,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,mBAAO,CAAC,GAAG,CAAC,KAAK,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7D,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,MAAc;QACjC,IAAI,CAAC;YACJ,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,mBAAO,CAAC,GAAG,CAAC,KAAK,CAAC,iCAAiC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAChE,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY;QACjB,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;YACnD,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,mBAAO,CAAC,GAAG,CAAC,KAAK,CAAC,+BAA+B,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC9D,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QAChB,IAAI,CAAC;YACJ,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,mBAAO,CAAC,GAAG,CAAC,KAAK,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7D,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,MAAc,EAAE,KAAa;QAC7C,IAAI,CAAC;YACJ,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACZ,OAAO,WAAW,MAAM,oBAAoB,CAAC;YAC9C,CAAC;YAED,0BAA0B;YAC1B,MAAM,YAAY,GAAG,KAAK,CAAC,SAAS;iBAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;iBACzC,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,MAAM,aAAa,GAAG,KAAK,CAAC,UAAU;iBACpC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;iBACzC,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK;iBAC1B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;iBACzC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEb,6BAA6B;YAC7B,MAAM,MAAM,GAAG;;;aAGL,YAAY;cACX,aAAa;SAClB,QAAQ;;MAEX,KAAK;;;8BAGmB,CAAC;YAE5B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;YACpE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAElD,8CAA8C;YAC9C,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;YAE5C,OAAO,YAAY,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,mBAAO,CAAC,GAAG,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5D,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;CACD;AAzMD,8BAyMC"}

package/dist/cjs/modules/fol/store/base.d.ts

@@ -0,0 +1,9 @@
+import type { Facts } from "../../../types/fol.js";
+export declare abstract class FOLStore {
+    abstract saveFacts(intent: string, facts: Facts): Promise<void>;
+    abstract retrieveFacts(intent: string): Promise<Facts | null>;
+    abstract getAllFacts(): Promise<{
+        [intent: string]: Facts;
+    }>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/cjs/modules/fol/store/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../../src/modules/fol/store/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,8BAAsB,QAAQ;IAC7B,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAC/D,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAC7D,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC;QAAE,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAA;KAAE,CAAC;CAC5D"}

package/dist/cjs/modules/fol/store/base.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FOLStore = void 0;
+class FOLStore {
+}
+exports.FOLStore = FOLStore;
+//# sourceMappingURL=base.js.map

package/dist/cjs/modules/fol/store/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/modules/fol/store/base.ts"],"names":[],"mappings":";;;AAEA,MAAsB,QAAQ;CAI7B;AAJD,4BAIC"}

package/dist/cjs/modules/fol/store/index.d.ts

@@ -0,0 +1,3 @@
+export { FOLStore } from "./base.js";
+export { FOLLocalStore } from "./local.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/modules/fol/store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/fol/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/cjs/modules/fol/store/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FOLLocalStore = exports.FOLStore = void 0;
+var base_js_1 = require("./base.js");
+Object.defineProperty(exports, "FOLStore", { enumerable: true, get: function () { return base_js_1.FOLStore; } });
+var local_js_1 = require("./local.js");
+Object.defineProperty(exports, "FOLLocalStore", { enumerable: true, get: function () { return local_js_1.FOLLocalStore; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/modules/fol/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/modules/fol/store/index.ts"],"names":[],"mappings":";;;AAAA,qCAAqC;AAA5B,mGAAA,QAAQ,OAAA;AACjB,uCAA2C;AAAlC,yGAAA,aAAa,OAAA"}

package/dist/cjs/modules/fol/store/local.d.ts

@@ -0,0 +1,25 @@
+import type { Facts } from "../../../types/fol.js";
+import { FOLStore } from "./base.js";
+export declare class FOLLocalStore extends FOLStore {
+    private storePath;
+    private constantsFile;
+    private predicatesFile;
+    private factsFile;
+    private intentFile;
+    constructor(storePath: string);
+    private ensureDirectoryExists;
+    private loadConstants;
+    private loadPredicates;
+    private loadAllFacts;
+    private loadIntentMapping;
+    private saveConstants;
+    private savePredicates;
+    private saveAllFacts;
+    private saveIntentMapping;
+    saveFacts(intent: string, facts: Facts): Promise<void>;
+    retrieveFacts(intent: string): Promise<Facts | null>;
+    getAllFacts(): Promise<{
+        [intent: string]: Facts;
+    }>;
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/cjs/modules/fol/store/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../../../src/modules/fol/store/local.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,qBAAa,aAAc,SAAQ,QAAQ;IAC1C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;gBAEf,SAAS,EAAE,MAAM;IAU7B,OAAO,CAAC,qBAAqB;YAMf,aAAa;YAoBb,cAAc;YAoBd,YAAY;YAoBZ,iBAAiB;YAajB,aAAa;YAgBb,cAAc;YAgBd,YAAY;YAgBZ,iBAAiB;IAUzB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAoEtD,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IA2BpD,WAAW,IAAI,OAAO,CAAC;QAAE,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAA;KAAE,CAAC;CA2BzD"}

package/dist/cjs/modules/fol/store/local.js

@@ -0,0 +1,221 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FOLLocalStore = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const logger_js_1 = require("../../../utils/logger.js");
+const base_js_1 = require("./base.js");
+class FOLLocalStore extends base_js_1.FOLStore {
+    constructor(storePath) {
+        super();
+        this.storePath = storePath;
+        this.constantsFile = node_path_1.default.join(storePath, "constants.json");
+        this.predicatesFile = node_path_1.default.join(storePath, "predicates.json");
+        this.factsFile = node_path_1.default.join(storePath, "facts.json");
+        this.intentFile = node_path_1.default.join(storePath, "intent.json");
+        this.ensureDirectoryExists();
+    }
+    ensureDirectoryExists() {
+        if (!node_fs_1.default.existsSync(this.storePath)) {
+            node_fs_1.default.mkdirSync(this.storePath, { recursive: true });
+        }
+    }
+    async loadConstants() {
+        if (!node_fs_1.default.existsSync(this.constantsFile)) {
+            return [];
+        }
+        try {
+            const content = await node_fs_1.default.promises.readFile(this.constantsFile, "utf8");
+            const data = JSON.parse(content);
+            // {name: description} 형태를 배열로 변환
+            return Object.entries(data).map(([name, description]) => ({
+                name,
+                description: description,
+            }));
+        }
+        catch (error) {
+            logger_js_1.loggers.fol.error("Failed to load constants.json:", { error });
+            return [];
+        }
+    }
+    async loadPredicates() {
+        if (!node_fs_1.default.existsSync(this.predicatesFile)) {
+            return [];
+        }
+        try {
+            const content = await node_fs_1.default.promises.readFile(this.predicatesFile, "utf8");
+            const data = JSON.parse(content);
+            // {name: description} 형태를 배열로 변환
+            return Object.entries(data).map(([name, description]) => ({
+                name,
+                description: description,
+            }));
+        }
+        catch (error) {
+            logger_js_1.loggers.fol.error("Failed to load predicates.json:", { error });
+            return [];
+        }
+    }
+    async loadAllFacts() {
+        if (!node_fs_1.default.existsSync(this.factsFile)) {
+            return [];
+        }
+        try {
+            const content = await node_fs_1.default.promises.readFile(this.factsFile, "utf8");
+            const data = JSON.parse(content);
+            // {name: description} 형태를 배열로 변환
+            return Object.entries(data).map(([name, description]) => ({
+                name,
+                description: description,
+            }));
+        }
+        catch (error) {
+            logger_js_1.loggers.fol.error("Failed to load facts.json:", { error });
+            return [];
+        }
+    }
+    async loadIntentMapping() {
+        if (!node_fs_1.default.existsSync(this.intentFile)) {
+            return {};
+        }
+        try {
+            const content = await node_fs_1.default.promises.readFile(this.intentFile, "utf8");
+            return JSON.parse(content);
+        }
+        catch (error) {
+            logger_js_1.loggers.fol.error("Failed to load intent.json:", { error });
+            return {};
+        }
+    }
+    async saveConstants(constants) {
+        // 배열을 {name: description} 형태로 변환
+        const data = {};
+        constants.forEach(({ name, description }) => {
+            data[name] = description;
+        });
+        await node_fs_1.default.promises.writeFile(this.constantsFile, JSON.stringify(data, null, 2), "utf8");
+    }
+    async savePredicates(predicates) {
+        // 배열을 {name: description} 형태로 변환
+        const data = {};
+        predicates.forEach(({ name, description }) => {
+            data[name] = description;
+        });
+        await node_fs_1.default.promises.writeFile(this.predicatesFile, JSON.stringify(data, null, 2), "utf8");
+    }
+    async saveAllFacts(facts) {
+        // 배열을 {name: description} 형태로 변환
+        const data = {};
+        facts.forEach(({ name, description }) => {
+            data[name] = description;
+        });
+        await node_fs_1.default.promises.writeFile(this.factsFile, JSON.stringify(data, null, 2), "utf8");
+    }
+    async saveIntentMapping(intentMapping) {
+        await node_fs_1.default.promises.writeFile(this.intentFile, JSON.stringify(intentMapping, null, 2), "utf8");
+    }
+    async saveFacts(intent, facts) {
+        try {
+            // Constants와 Predicates는 전역으로 저장 (기존 데이터와 병합)
+            const existingConstants = await this.loadConstants();
+            const existingPredicates = await this.loadPredicates();
+            const existingFacts = await this.loadAllFacts();
+            // 중복 제거하여 병합 (name 기준)
+            const constantsMap = new Map();
+            existingConstants.forEach(({ name, description }) => {
+                constantsMap.set(name, description);
+            });
+            facts.constants.forEach(({ name, description }) => {
+                constantsMap.set(name, description);
+            });
+            const predicatesMap = new Map();
+            existingPredicates.forEach(({ name, description }) => {
+                predicatesMap.set(name, description);
+            });
+            facts.predicates.forEach(({ name, description }) => {
+                predicatesMap.set(name, description);
+            });
+            const factsMap = new Map();
+            existingFacts.forEach(({ name, description }) => {
+                factsMap.set(name, description);
+            });
+            facts.facts.forEach(({ name, description }) => {
+                factsMap.set(name, description);
+            });
+            // Map을 배열로 변환
+            const mergedConstants = Array.from(constantsMap.entries()).map(([name, description]) => ({
+                name,
+                description,
+            }));
+            const mergedPredicates = Array.from(predicatesMap.entries()).map(([name, description]) => ({
+                name,
+                description,
+            }));
+            const mergedFacts = Array.from(factsMap.entries()).map(([name, description]) => ({
+                name,
+                description,
+            }));
+            await this.saveConstants(mergedConstants);
+            await this.savePredicates(mergedPredicates);
+            await this.saveAllFacts(mergedFacts);
+            // Intent mapping 저장
+            const intentMapping = await this.loadIntentMapping();
+            intentMapping[intent] = facts.facts.map((fact) => fact.name);
+            await this.saveIntentMapping(intentMapping);
+            logger_js_1.loggers.fol.info(`FOL data updated (intent: ${intent})`);
+        }
+        catch (error) {
+            logger_js_1.loggers.fol.error("saveFacts execution error:", { error });
+            throw error;
+        }
+    }
+    async retrieveFacts(intent) {
+        try {
+            const constants = await this.loadConstants();
+            const predicates = await this.loadPredicates();
+            const allFacts = await this.loadAllFacts();
+            const intentMapping = await this.loadIntentMapping();
+            const intentFactNames = intentMapping[intent] || [];
+            // intent에 해당하는 facts만 필터링
+            const intentFacts = allFacts.filter((fact) => intentFactNames.includes(fact.name));
+            return {
+                constants,
+                predicates,
+                facts: intentFacts,
+            };
+        }
+        catch (error) {
+            logger_js_1.loggers.fol.error(`Failed to retrieve FOL (intent: ${intent}):`, {
+                error,
+            });
+            return null;
+        }
+    }
+    async getAllFacts() {
+        const result = {};
+        try {
+            const constants = await this.loadConstants();
+            const predicates = await this.loadPredicates();
+            const allFacts = await this.loadAllFacts();
+            const intentMapping = await this.loadIntentMapping();
+            for (const [intent, factNames] of Object.entries(intentMapping)) {
+                const intentFacts = allFacts.filter((fact) => factNames.includes(fact.name));
+                result[intent] = {
+                    constants,
+                    predicates,
+                    facts: intentFacts,
+                };
+            }
+            return result;
+        }
+        catch (error) {
+            logger_js_1.loggers.fol.error("Failed to getAllFacts:", { error });
+            return {};
+        }
+    }
+}
+exports.FOLLocalStore = FOLLocalStore;
+//# sourceMappingURL=local.js.map

package/dist/cjs/modules/fol/store/local.js.map

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

package/dist/cjs/modules/index.d.ts

@@ -0,0 +1,6 @@
+export { A2AModule } from "./a2a/a2a.module.js";
+export { FOLModule } from "./fol/fol.module.js";
+export { MCPModule } from "./mcp/mcp.module.js";
+export { MemoryModule } from "./memory/memory.module.js";
+export { ModelModule } from "./models/model.module.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/modules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/cjs/modules/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelModule = exports.MemoryModule = exports.MCPModule = exports.FOLModule = exports.A2AModule = void 0;
+var a2a_module_js_1 = require("./a2a/a2a.module.js");
+Object.defineProperty(exports, "A2AModule", { enumerable: true, get: function () { return a2a_module_js_1.A2AModule; } });
+var fol_module_js_1 = require("./fol/fol.module.js");
+Object.defineProperty(exports, "FOLModule", { enumerable: true, get: function () { return fol_module_js_1.FOLModule; } });
+var mcp_module_js_1 = require("./mcp/mcp.module.js");
+Object.defineProperty(exports, "MCPModule", { enumerable: true, get: function () { return mcp_module_js_1.MCPModule; } });
+var memory_module_js_1 = require("./memory/memory.module.js");
+Object.defineProperty(exports, "MemoryModule", { enumerable: true, get: function () { return memory_module_js_1.MemoryModule; } });
+var model_module_js_1 = require("./models/model.module.js");
+Object.defineProperty(exports, "ModelModule", { enumerable: true, get: function () { return model_module_js_1.ModelModule; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/modules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/index.ts"],"names":[],"mappings":";;;AAAA,qDAAgD;AAAvC,0GAAA,SAAS,OAAA;AAClB,qDAAgD;AAAvC,0GAAA,SAAS,OAAA;AAClB,qDAAgD;AAAvC,0GAAA,SAAS,OAAA;AAClB,8DAAyD;AAAhD,gHAAA,YAAY,OAAA;AACrB,4DAAuD;AAA9C,8GAAA,WAAW,OAAA"}

package/dist/cjs/modules/mcp/mcp.module.d.ts

@@ -0,0 +1,65 @@
+import type { MCPConfig } from "../../types/mcp.js";
+import { MCPTool } from "./mcp.tool.js";
+/**
+ * Module for managing Model Context Protocol (MCP) server connections.
+ *
+ * This module handles the lifecycle of MCP client connections, discovers
+ * available tools from connected servers, and provides an interface for
+ * executing those tools. Multiple MCP servers can be connected simultaneously.
+ *
+ * @example
+ * ```typescript
+ * const mcpModule = new MCPModule();
+ * await mcpModule.addMCPConfig({
+ *   "filesystem": {
+ *     command: "npx",
+ *     args: ["@modelcontextprotocol/server-filesystem", "/path/to/files"]
+ *   }
+ * });
+ *
+ * const tools = mcpModule.getTools();
+ * const result = await mcpModule.useTool(tools[0], { path: "/example.txt" });
+ * ```
+ */
+export declare class MCPModule {
+    /** Map of MCP server names to their client instances */
+    private mcpMap;
+    /** Map of MCP server names to their transport instances */
+    private transportMap;
+    /** Array of all discovered tools from connected MCP servers */
+    private tools;
+    /**
+     * Connects to MCP servers based on the provided configuration.
+     *
+     * For each server in the config, establishes a connection, discovers
+     * available tools, and adds them to the module's tool collection.
+     * Skips servers that are already connected.
+     *
+     * @param mcpConfig - Configuration object mapping server names to connection details
+     * @throws Error if connection to any MCP server fails
+     */
+    addMCPConfig(mcpConfig: MCPConfig): Promise<void>;
+    /**
+     * Returns all available tools from connected MCP servers.
+     *
+     * @returns Array of MCPTool instances representing available tools
+     */
+    getTools(): MCPTool[];
+    /**
+     * Executes a tool on its corresponding MCP server.
+     *
+     * @param tool - The MCPTool instance to execute
+     * @param _args - Arguments to pass to the tool
+     * @returns Promise resolving to the tool's execution result
+     * @throws Error if the MCP server for the tool is not found
+     */
+    useTool(tool: MCPTool, _args?: any): Promise<any>;
+    /**
+     * Closes all MCP client connections.
+     *
+     * Should be called when shutting down the application to ensure
+     * all MCP connections are properly closed.
+     */
+    cleanup(): Promise<void>;
+}
+//# sourceMappingURL=mcp.module.d.ts.map

package/dist/cjs/modules/mcp/mcp.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.module.d.ts","sourceRoot":"","sources":["../../../../src/modules/mcp/mcp.module.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,SAAS;IACrB,wDAAwD;IACxD,OAAO,CAAC,MAAM,CAAkC;IAChD,2DAA2D;IAC3D,OAAO,CAAC,YAAY,CAAgD;IACpE,+DAA+D;IAC/D,OAAO,CAAC,KAAK,CAAiB;IAE9B;;;;;;;;;OASG;IACG,YAAY,CAAC,SAAS,EAAE,SAAS;IA4BvC;;;;OAIG;IACH,QAAQ;IAIR;;;;;;;OAOG;IACG,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAqBvD;;;;;OAKG;IACG,OAAO;CAKb"}

package/dist/cjs/modules/mcp/mcp.module.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPModule = void 0;
+const index_js_1 = require("@modelcontextprotocol/sdk/client/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/client/stdio.js");
+const logger_js_1 = require("../../utils/logger.js");
+const mcp_tool_js_1 = require("./mcp.tool.js");
+/**
+ * Module for managing Model Context Protocol (MCP) server connections.
+ *
+ * This module handles the lifecycle of MCP client connections, discovers
+ * available tools from connected servers, and provides an interface for
+ * executing those tools. Multiple MCP servers can be connected simultaneously.
+ *
+ * @example
+ * ```typescript
+ * const mcpModule = new MCPModule();
+ * await mcpModule.addMCPConfig({
+ *   "filesystem": {
+ *     command: "npx",
+ *     args: ["@modelcontextprotocol/server-filesystem", "/path/to/files"]
+ *   }
+ * });
+ *
+ * const tools = mcpModule.getTools();
+ * const result = await mcpModule.useTool(tools[0], { path: "/example.txt" });
+ * ```
+ */
+class MCPModule {
+    constructor() {
+        /** Map of MCP server names to their client instances */
+        this.mcpMap = new Map();
+        /** Map of MCP server names to their transport instances */
+        this.transportMap = new Map();
+        /** Array of all discovered tools from connected MCP servers */
+        this.tools = [];
+    }
+    /**
+     * Connects to MCP servers based on the provided configuration.
+     *
+     * For each server in the config, establishes a connection, discovers
+     * available tools, and adds them to the module's tool collection.
+     * Skips servers that are already connected.
+     *
+     * @param mcpConfig - Configuration object mapping server names to connection details
+     * @throws Error if connection to any MCP server fails
+     */
+    async addMCPConfig(mcpConfig) {
+        try {
+            for (const [name, conf] of Object.entries(mcpConfig)) {
+                // FIXME(yoojin): Need strict duplication check.
+                if (this.mcpMap.get(name) && this.transportMap.get(name))
+                    continue; // Duplicated mcp: skip
+                const transport = new stdio_js_1.StdioClientTransport(conf);
+                this.transportMap.set(name, transport);
+                const mcp = new index_js_1.Client({ name: "mcp-client-cli", version: "1.0.0" });
+                await mcp.connect(transport);
+                this.mcpMap.set(name, mcp);
+                const toolsResult = await mcp.listTools();
+                this.tools.push(...toolsResult.tools.map((tool) => {
+                    return new mcp_tool_js_1.MCPTool(name, tool);
+                }));
+            }
+            logger_js_1.loggers.mcp.info("Connected to MCP server with tools:", {
+                tools: this.tools.map((tool) => tool.id),
+            });
+        }
+        catch (error) {
+            logger_js_1.loggers.mcp.error("Failed to connect to MCP server:", { error });
+            throw error;
+        }
+    }
+    /**
+     * Returns all available tools from connected MCP servers.
+     *
+     * @returns Array of MCPTool instances representing available tools
+     */
+    getTools() {
+        return this.tools;
+    }
+    /**
+     * Executes a tool on its corresponding MCP server.
+     *
+     * @param tool - The MCPTool instance to execute
+     * @param _args - Arguments to pass to the tool
+     * @returns Promise resolving to the tool's execution result
+     * @throws Error if the MCP server for the tool is not found
+     */
+    async useTool(tool, _args) {
+        const { serverName, mcpTool } = tool;
+        const toolName = mcpTool.name;
+        const mcp = this.mcpMap.get(serverName);
+        if (!mcp) {
+            throw new Error(`Invalid MCP Tool ${serverName}-${mcpTool.name}`);
+        }
+        const result = await mcp.callTool({
+            name: toolName,
+            arguments: _args,
+        });
+        const toolResult = `[Bot Called Tool ${toolName} with args ${JSON.stringify(_args)}]\n` +
+            JSON.stringify(result.content, null, 2);
+        logger_js_1.loggers.mcp.debug("MCP useTool result:", toolResult);
+        return result;
+    }
+    /**
+     * Closes all MCP client connections.
+     *
+     * Should be called when shutting down the application to ensure
+     * all MCP connections are properly closed.
+     */
+    async cleanup() {
+        this.mcpMap.forEach((mcp) => {
+            mcp.close();
+        });
+    }
+}
+exports.MCPModule = MCPModule;
+//# sourceMappingURL=mcp.module.js.map

package/dist/cjs/modules/mcp/mcp.module.js.map

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

package/dist/cjs/modules/mcp/mcp.tool.d.ts

@@ -0,0 +1,13 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { type IMCPTool, TOOL_PROTOCOL_TYPE } from "../../types/tool.js";
+export declare class MCPTool implements IMCPTool {
+    id: string;
+    protocol: TOOL_PROTOCOL_TYPE;
+    enabled: boolean;
+    mcpTool: Tool;
+    serverName: string;
+    constructor(serverName: string, tool: Tool);
+    enable(): void;
+    disable(): void;
+}
+//# sourceMappingURL=mcp.tool.d.ts.map

package/dist/cjs/modules/mcp/mcp.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.tool.d.ts","sourceRoot":"","sources":["../../../../src/modules/mcp/mcp.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,EAAE,KAAK,QAAQ,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEpE,qBAAa,OAAQ,YAAW,QAAQ;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,IAAI,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;gBAEd,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;IASnC,MAAM,IAAI,IAAI;IAId,OAAO,IAAI,IAAI;CAGtB"}

package/dist/cjs/modules/mcp/mcp.tool.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPTool = void 0;
+const tool_js_1 = require("../../types/tool.js");
+class MCPTool {
+    constructor(serverName, tool) {
+        this.id = `${serverName}_${tool.name}`;
+        this.protocol = tool_js_1.TOOL_PROTOCOL_TYPE.MCP;
+        this.enabled = true;
+        // NOTE(yoojin): MCP Server name. ex) notionApi
+        this.serverName = serverName;
+        this.mcpTool = tool;
+    }
+    enable() {
+        this.enabled = true;
+    }
+    disable() {
+        this.enabled = false;
+    }
+}
+exports.MCPTool = MCPTool;
+//# sourceMappingURL=mcp.tool.js.map

package/dist/cjs/modules/mcp/mcp.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.tool.js","sourceRoot":"","sources":["../../../../src/modules/mcp/mcp.tool.ts"],"names":[],"mappings":";;;AACA,6CAAoE;AAEpE,MAAa,OAAO;IAOnB,YAAY,UAAkB,EAAE,IAAU;QACzC,IAAI,CAAC,EAAE,GAAG,GAAG,UAAU,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,QAAQ,GAAG,4BAAkB,CAAC,GAAG,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,+CAA+C;QAC/C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACrB,CAAC;IAEM,MAAM;QACZ,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACrB,CAAC;IAEM,OAAO;QACb,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACtB,CAAC;CACD;AAvBD,0BAuBC"}

package/dist/cjs/modules/memory/inmemory.d.ts

@@ -0,0 +1,14 @@
+/*******************************************
+ * WARNING: FOR TESTING PURPOSES ONLY      *
+ * DO NOT USE IN PRODUCTION                *
+ *******************************************/
+import type { ChatObject, SessionObject } from "../../types/memory.js";
+import { BaseMemory } from "./memory.module.js";
+export declare class InMemoryMemory extends BaseMemory {
+    sessionHistory: Map<string, SessionObject>;
+    constructor();
+    getSessionHistory(sessionId: string): Promise<SessionObject>;
+    updateSessionHistory(sessionId: string, chat: ChatObject): Promise<void>;
+    storeQueryAndIntent(query: string, intent: string, sessionId: string): Promise<void>;
+}
+//# sourceMappingURL=inmemory.d.ts.map

package/dist/cjs/modules/memory/inmemory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inmemory.d.ts","sourceRoot":"","sources":["../../../../src/modules/memory/inmemory.ts"],"names":[],"mappings":"AAAA;;;6CAG6C;AAG7C,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,qBAAa,cAAe,SAAQ,UAAU;IACtC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;;IAOrC,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI5D,oBAAoB,CAChC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,UAAU,GACd,OAAO,CAAC,IAAI,CAAC;IAOH,mBAAmB,CAC/B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM;CAElB"}