@ainetwork/adk 0.0.1

package/dist/cjs/models/openai.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const openai_1 = require("openai");
+const types_js_1 = require("../intent/modules/common/types.js");
+const BaseSession_js_1 = require("../session/BaseSession.js");
+const BaseModel_js_1 = require("./BaseModel.js");
+class AzureOpenAI extends BaseModel_js_1.BaseModel {
+    constructor(baseUrl, apiKey, apiVersion, modelName) {
+        super();
+        this.client = new openai_1.AzureOpenAI({
+            baseURL: baseUrl,
+            apiKey: apiKey,
+            apiVersion: apiVersion,
+        });
+        this.modelName = modelName;
+    }
+    getMessageRole(role) {
+        switch (role) {
+            case BaseSession_js_1.ChatRole.USER:
+                return "user";
+            case BaseSession_js_1.ChatRole.MODEL:
+            case BaseSession_js_1.ChatRole.SYSTEM:
+                return "system";
+            default:
+                return "system"; /*FIXME*/
+        }
+    }
+    generateMessages(sessionHistory, query, systemPrompt) {
+        const messages = !systemPrompt
+            ? []
+            : [{ role: "system", content: systemPrompt.trim() }];
+        const sessionContent = Object.keys(sessionHistory).map((messageId) => {
+            const message = sessionHistory[messageId];
+            return {
+                role: this.getMessageRole(message.role),
+                content: message.content.parts[0],
+            };
+        });
+        const userContent = { role: "user", content: query };
+        return messages.concat(sessionContent).concat(userContent);
+    }
+    expandMessages(messages, message) {
+        messages.push({
+            role: "user",
+            content: message,
+        });
+    }
+    async fetch(messages) {
+        const response = await this.client.chat.completions.create({
+            model: this.modelName,
+            messages,
+        });
+        return {
+            content: response.choices[0].message.content || undefined,
+        };
+    }
+    async fetchWithContextMessage(messages, functions) {
+        if (functions.length > 0) {
+            const response = await this.client.chat.completions.create({
+                model: this.modelName,
+                messages,
+                tools: functions,
+                tool_choice: "auto",
+            });
+            const { content, tool_calls } = response.choices[0].message;
+            const toolCalls = tool_calls?.map((value) => {
+                return {
+                    name: value.function.name,
+                    // FIXME: value.function.arguments could not be a valid JSON
+                    arguments: JSON.parse(value.function.arguments),
+                };
+            });
+            return {
+                content: content || undefined,
+                toolCalls,
+            };
+        }
+        return await this.fetch(messages);
+    }
+    convertToolsToFunctions(tools) {
+        const functions = [];
+        for (const tool of tools) {
+            if (!tool.enabled) {
+                continue;
+            }
+            if (tool.protocol === types_js_1.PROTOCOL_TYPE.MCP) {
+                const { mcpTool, id } = tool;
+                functions.push({
+                    type: "function",
+                    function: {
+                        name: id,
+                        description: mcpTool.description,
+                        parameters: mcpTool.inputSchema,
+                    },
+                });
+            }
+            else {
+                // PROTOCOL_TYPE.A2A
+                const { id, card } = tool;
+                functions.push({
+                    type: "function",
+                    function: {
+                        name: id,
+                        description: card.description,
+                    },
+                });
+            }
+        }
+        return functions;
+    }
+}
+exports.default = AzureOpenAI;
+//# sourceMappingURL=openai.js.map

package/dist/cjs/models/openai.js.map

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

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

@@ -0,0 +1,71 @@
+import { type Message } from "@a2a-js/sdk";
+import { A2ATool } from "./a2a.tool.js";
+/**
+ * Module for managing Agent-to-Agent (A2A) protocol connections.
+ *
+ * This module handles connections to other A2A-compatible agents, manages
+ * conversation sessions, and provides an interface for inter-agent communication.
+ * Supports multi-turn conversations with task and context tracking.
+ *
+ * @example
+ * ```typescript
+ * const a2aModule = new A2AModule();
+ * await a2aModule.addA2APeerServer("https://api.example.com/agent");
+ *
+ * const tools = await a2aModule.getTools();
+ * const message = a2aModule.getMessagePayload("Hello", "session-123");
+ * const response = await a2aModule.useTool(tools[0], message, "session-123");
+ * ```
+ */
+export declare class A2AModule {
+    /** Map of A2A server URLs to their corresponding tool instances */
+    private a2aPeerServers;
+    /** Map of session IDs to their A2A session state */
+    private a2aSessions;
+    /**
+     * Registers a new A2A peer server URL for connection.
+     *
+     * @param url - The URL of the A2A-compatible agent to connect to
+     */
+    addA2APeerServer(url: string): Promise<void>;
+    /**
+     * Retrieves tools from all registered A2A peer servers.
+     *
+     * Attempts to connect to each registered server, fetch their agent cards,
+     * and create tool instances. Disables tools for unreachable servers.
+     *
+     * @returns Promise resolving to array of available A2A tools
+     */
+    getTools(): Promise<A2ATool[]>;
+    /**
+     * Gets or creates an A2A session for the given session ID.
+     *
+     * @param sessionId - The session identifier
+     * @returns A2ASession object with task and context IDs
+     */
+    private getA2ASessionWithId;
+    /**
+     * Constructs a message payload for A2A communication.
+     *
+     * Includes session context (task ID and context ID) if available
+     * for maintaining conversation continuity.
+     *
+     * @param query - The message content to send
+     * @param sessionId - The session identifier
+     * @returns Formatted Message object for A2A protocol
+     */
+    getMessagePayload(query: string, sessionId: string): Message;
+    /**
+     * Executes an A2A tool by sending a message to the remote agent.
+     *
+     * Handles streaming responses, maintains session state, and extracts
+     * text content from various event types in the response stream.
+     *
+     * @param tool - The A2ATool instance to use
+     * @param messagePayload - The message to send to the agent
+     * @param sessionId - The session identifier for context tracking
+     * @returns Promise resolving to array of text responses from the agent
+     */
+    useTool(tool: A2ATool, messagePayload: Message, sessionId: string): Promise<string[]>;
+}
+//# sourceMappingURL=a2a.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"a2a.module.d.ts","sourceRoot":"","sources":["../../../../src/modules/a2a/a2a.module.ts"],"names":[],"mappings":"AACA,OAAO,EAGN,KAAK,OAAO,EAKZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAYxC;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,SAAS;IACrB,mEAAmE;IACnE,OAAO,CAAC,cAAc,CAA0C;IAChE,oDAAoD;IACpD,OAAO,CAAC,WAAW,CAAsC;IAEzD;;;;OAIG;IACU,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;;;;;;OAOG;IACU,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAyB3C;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB,CAUzB;IAEF;;;;;;;;;OASG;IACI,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IA2BnE;;;;;;;;;;OAUG;IACU,OAAO,CACnB,IAAI,EAAE,OAAO,EACb,cAAc,EAAE,OAAO,EACvB,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC;CA2DpB"}

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

@@ -0,0 +1,195 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A2AModule = void 0;
+const node_crypto_1 = require("node:crypto");
+const sdk_1 = require("@a2a-js/sdk");
+const logger_js_1 = require("../../utils/logger.js");
+const a2a_tool_js_1 = require("./a2a.tool.js");
+/**
+ * Module for managing Agent-to-Agent (A2A) protocol connections.
+ *
+ * This module handles connections to other A2A-compatible agents, manages
+ * conversation sessions, and provides an interface for inter-agent communication.
+ * Supports multi-turn conversations with task and context tracking.
+ *
+ * @example
+ * ```typescript
+ * const a2aModule = new A2AModule();
+ * await a2aModule.addA2APeerServer("https://api.example.com/agent");
+ *
+ * const tools = await a2aModule.getTools();
+ * const message = a2aModule.getMessagePayload("Hello", "session-123");
+ * const response = await a2aModule.useTool(tools[0], message, "session-123");
+ * ```
+ */
+class A2AModule {
+    constructor() {
+        /** Map of A2A server URLs to their corresponding tool instances */
+        this.a2aPeerServers = new Map();
+        /** Map of session IDs to their A2A session state */
+        this.a2aSessions = new Map();
+        /**
+         * Gets or creates an A2A session for the given session ID.
+         *
+         * @param sessionId - The session identifier
+         * @returns A2ASession object with task and context IDs
+         */
+        this.getA2ASessionWithId = (sessionId) => {
+            const a2aSession = this.a2aSessions.get(sessionId) ?? {
+                taskId: undefined,
+                contextId: undefined,
+            };
+            if (!this.a2aSessions.has(sessionId)) {
+                this.a2aSessions.set(sessionId, a2aSession);
+            }
+            return a2aSession;
+        };
+    }
+    /**
+     * Registers a new A2A peer server URL for connection.
+     *
+     * @param url - The URL of the A2A-compatible agent to connect to
+     */
+    async addA2APeerServer(url) {
+        this.a2aPeerServers.set(url, null);
+    }
+    /**
+     * Retrieves tools from all registered A2A peer servers.
+     *
+     * Attempts to connect to each registered server, fetch their agent cards,
+     * and create tool instances. Disables tools for unreachable servers.
+     *
+     * @returns Promise resolving to array of available A2A tools
+     */
+    async getTools() {
+        const tools = [];
+        for (const url of [...this.a2aPeerServers.keys()]) {
+            const tool = this.a2aPeerServers.get(url);
+            if (!tool || !tool.enabled) {
+                try {
+                    const client = new sdk_1.A2AClient(url);
+                    const card = await client.getAgentCard();
+                    const toolName = card.name.replaceAll(" ", "-");
+                    const a2aTool = new a2a_tool_js_1.A2ATool(toolName, client, card);
+                    tools.push(a2aTool);
+                }
+                catch (_error) {
+                    // Agent not responded
+                    if (tool) {
+                        tool.disable();
+                    }
+                }
+            }
+            else {
+                tools.push(tool);
+            }
+        }
+        return tools;
+    }
+    /**
+     * Constructs a message payload for A2A communication.
+     *
+     * Includes session context (task ID and context ID) if available
+     * for maintaining conversation continuity.
+     *
+     * @param query - The message content to send
+     * @param sessionId - The session identifier
+     * @returns Formatted Message object for A2A protocol
+     */
+    getMessagePayload(query, sessionId) {
+        const messagePayload = {
+            messageId: (0, node_crypto_1.randomUUID)(),
+            kind: "message",
+            role: "user", // FIXME: it could be 'agent'
+            metadata: {
+                sessionId,
+            },
+            parts: [
+                {
+                    kind: "text",
+                    text: query,
+                },
+            ],
+        };
+        const a2aSession = this.getA2ASessionWithId(sessionId);
+        if (a2aSession.taskId) {
+            messagePayload.taskId = a2aSession.taskId;
+        }
+        if (a2aSession.contextId) {
+            messagePayload.contextId = a2aSession.contextId;
+        }
+        return messagePayload;
+    }
+    /**
+     * Executes an A2A tool by sending a message to the remote agent.
+     *
+     * Handles streaming responses, maintains session state, and extracts
+     * text content from various event types in the response stream.
+     *
+     * @param tool - The A2ATool instance to use
+     * @param messagePayload - The message to send to the agent
+     * @param sessionId - The session identifier for context tracking
+     * @returns Promise resolving to array of text responses from the agent
+     */
+    async useTool(tool, messagePayload, sessionId) {
+        const finalText = [];
+        const client = tool.client;
+        const params = {
+            message: messagePayload,
+        };
+        const a2aSession = this.getA2ASessionWithId(sessionId);
+        try {
+            const stream = client.sendMessageStream(params);
+            for await (const event of stream) {
+                if (event.kind === "status-update") {
+                    const typedEvent = event;
+                    if (typedEvent.final &&
+                        typedEvent.status.state !== "input-required") {
+                        a2aSession.taskId = undefined;
+                    }
+                    // TODO: handle 'file', 'data' parts
+                    const texts = typedEvent.status.message?.parts
+                        .filter((part) => part.kind === "text")
+                        .map((part) => part.text)
+                        .join("\n");
+                    if (texts) {
+                        finalText.push(texts);
+                    }
+                }
+                else if (event.kind === "message") {
+                    // FIXME: handling text in 'message'?
+                    const msg = event;
+                    if (msg.taskId && msg.taskId !== a2aSession.taskId) {
+                        a2aSession.taskId = msg.taskId;
+                    }
+                    if (msg.contextId && msg.contextId !== a2aSession.contextId) {
+                        a2aSession.contextId = msg.contextId;
+                    }
+                }
+                else if (event.kind === "task") {
+                    // FIXME: handling text in 'task'?
+                    const task = event;
+                    if (task.id !== a2aSession.taskId) {
+                        a2aSession.taskId = task.id;
+                    }
+                    if (task.contextId && task.contextId !== a2aSession.contextId) {
+                        a2aSession.contextId = task.contextId;
+                    }
+                }
+                else {
+                    logger_js_1.loggers.a2a.warn("Received unknown event structure from stream:", {
+                        event,
+                    });
+                }
+            }
+        }
+        catch (error) {
+            logger_js_1.loggers.a2a.error("Error communicating with agent:", { error });
+            tool.disable();
+            // TODO: add failed & disabled text for next inference?
+        }
+        return finalText;
+    }
+}
+exports.A2AModule = A2AModule;
+//# sourceMappingURL=a2a.module.js.map

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

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

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

@@ -0,0 +1,13 @@
+import type { A2AClient, AgentCard } from "@a2a-js/sdk";
+import { type IA2ATool, TOOL_PROTOCOL_TYPE } from "../../types/tool.js";
+export declare class A2ATool implements IA2ATool {
+    id: string;
+    protocol: TOOL_PROTOCOL_TYPE;
+    enabled: boolean;
+    client: A2AClient;
+    card: AgentCard;
+    constructor(name: string, client: A2AClient, card: AgentCard);
+    enable(): void;
+    disable(): void;
+}
+//# sourceMappingURL=a2a.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"a2a.tool.d.ts","sourceRoot":"","sources":["../../../../src/modules/a2a/a2a.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,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,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;gBAEX,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS;IAQrD,MAAM,IAAI,IAAI;IAId,OAAO,IAAI,IAAI;CAGtB"}

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

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A2ATool = void 0;
+const tool_js_1 = require("../../types/tool.js");
+class A2ATool {
+    constructor(name, client, card) {
+        this.id = name;
+        this.protocol = tool_js_1.TOOL_PROTOCOL_TYPE.A2A;
+        this.enabled = true;
+        this.client = client;
+        this.card = card;
+    }
+    enable() {
+        this.enabled = true;
+    }
+    disable() {
+        this.enabled = false;
+    }
+}
+exports.A2ATool = A2ATool;
+//# sourceMappingURL=a2a.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"a2a.tool.js","sourceRoot":"","sources":["../../../../src/modules/a2a/a2a.tool.ts"],"names":[],"mappings":";;;AACA,6CAAoE;AAEpE,MAAa,OAAO;IAOnB,YAAY,IAAY,EAAE,MAAiB,EAAE,IAAe;QAC3D,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;QACf,IAAI,CAAC,QAAQ,GAAG,4BAAkB,CAAC,GAAG,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,CAAC;IAEM,MAAM;QACZ,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACrB,CAAC;IAEM,OAAO;QACb,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACtB,CAAC;CACD;AAtBD,0BAsBC"}

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

@@ -0,0 +1,31 @@
+import type { BaseModel } from "../../modules/models/model.module.js";
+import type { Facts } from "../../types/fol.js";
+import type { FOLStore } from "./store/index.js";
+export declare class FOLModule {
+    private model;
+    private folStore;
+    constructor(model: BaseModel<unknown, unknown>, folStore: FOLStore);
+    /**
+     * 자연어로 정보를 넣어주면 FOL 형식으로 바꿔서 Store에 저장하기
+     */
+    updateFacts(intent: string, text: string): Promise<void>;
+    /**
+     * 특정 intent에 대한 Facts 조회
+     */
+    retrieveFacts(intent: string): Promise<Facts | null>;
+    /**
+     * 모든 Facts 목록 조회
+     */
+    getFactsList(): Promise<Facts[]>;
+    /**
+     * Intent별 Facts 맵 조회
+     */
+    getFactsMap(): Promise<{
+        [intent: string]: Facts;
+    }>;
+    /**
+     * FOL 기반 데이터 조회 및 추론
+     */
+    queryFacts(intent: string, query: string): Promise<string>;
+}
+//# sourceMappingURL=fol.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fol.module.d.ts","sourceRoot":"","sources":["../../../../src/modules/fol/fol.module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,qBAAa,SAAS;IACrB,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,QAAQ,CAAW;gBAEf,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,QAAQ;IAKlE;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0G9D;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAS1D;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAUtC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC;QAAE,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAA;KAAE,CAAC;IASzD;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA2ChE"}

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

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FOLModule = void 0;
+const logger_js_1 = require("../../utils/logger.js");
+class FOLModule {
+    constructor(model, folStore) {
+        this.model = model;
+        this.folStore = folStore;
+    }
+    /**
+     * 자연어로 정보를 넣어주면 FOL 형식으로 바꿔서 Store에 저장하기
+     */
+    async updateFacts(intent, text) {
+        try {
+            // 기존 Facts 가져오기
+            const existingFacts = (await this.folStore.retrieveFacts(intent)) || {
+                constants: [],
+                predicates: [],
+                facts: [],
+            };
+            // 기존 데이터를 문자열로 변환 (AI 프롬프트용)
+            const existingConstantsStr = existingFacts.constants
+                .map((c) => `${c.name}: ${c.description}`)
+                .join(", ");
+            const existingPredicatesStr = existingFacts.predicates
+                .map((p) => `${p.name}: ${p.description}`)
+                .join(", ");
+            const existingFactsStr = existingFacts.facts
+                .map((f) => `${f.name}: ${f.description}`)
+                .join(", ");
+            // 자연어를 FOL로 변환하는 프롬프트
+            const prompt = `
+다음 자연어 텍스트를 First-Order Logic (FOL) 형식으로 변환해주세요.
+
+입력 텍스트: "${text}"
+
+기존 Constants: ${existingConstantsStr}
+기존 Predicates: ${existingPredicatesStr}
+기존 Facts: ${existingFactsStr}
+
+다음 JSON 형식으로 응답해주세요:
+{
+  "constants": [
+    {"name": "constant_name", "description": "상수에 대한 설명"}
+  ],
+  "predicates": [
+    {"name": "Predicate(x)", "description": "술어에 대한 설명"}
+  ],
+  "facts": [
+    {"name": "Fact(constant)", "description": "사실에 대한 설명"}
+  ]
+}
+
+FOL 규칙:
+- Constants는 소문자로 시작 (예: john, mary, book1)
+- Predicates는 대문자로 시작하고 변수 포함 (예: Person(x), Likes(x,y))
+- Facts는 구체적인 사실 (예: Person(john), Likes(mary, book1))
+- 각 항목에는 의미있는 설명을 포함해주세요
+- 기존 정보와 중복되지 않도록 주의`;
+            const messages = this.model.generateMessages({ chats: {} }, prompt);
+            const response = await this.model.fetch(messages);
+            logger_js_1.loggers.fol.debug(response);
+            // AI 응답에서 텍스트 추출 (응답이 객체인 경우 content 프로퍼티 사용)
+            const responseText = response.content || "";
+            // AI 응답에서 JSON 추출
+            const jsonMatch = responseText?.match(/\{[\s\S]*\}/);
+            if (!jsonMatch) {
+                throw new Error("AI 응답에서 유효한 JSON을 찾을 수 없습니다");
+            }
+            const newFolData = JSON.parse(jsonMatch[0]);
+            // 기존 데이터와 병합 (중복 제거 - name 기준)
+            const mergeData = (existing, newItems) => {
+                const merged = new Map();
+                existing.forEach(({ name, description }) => {
+                    merged.set(name, description);
+                });
+                newItems.forEach(({ name, description }) => {
+                    merged.set(name, description);
+                });
+                return Array.from(merged.entries()).map(([name, description]) => ({
+                    name,
+                    description,
+                }));
+            };
+            const updatedFacts = {
+                constants: mergeData(existingFacts.constants, newFolData.constants || []),
+                predicates: mergeData(existingFacts.predicates, newFolData.predicates || []),
+                facts: mergeData(existingFacts.facts, newFolData.facts || []),
+            };
+            // Store에 저장
+            await this.folStore.saveFacts(intent, updatedFacts);
+            logger_js_1.loggers.fol.info(`FOL data updated (intent: ${intent})`);
+        }
+        catch (error) {
+            logger_js_1.loggers.fol.error("updateFacts execution error:", { error });
+            throw error;
+        }
+    }
+    /**
+     * 특정 intent에 대한 Facts 조회
+     */
+    async retrieveFacts(intent) {
+        try {
+            return await this.folStore.retrieveFacts(intent);
+        }
+        catch (error) {
+            logger_js_1.loggers.fol.error("retrieveFacts execution error: ", { error });
+            throw error;
+        }
+    }
+    /**
+     * 모든 Facts 목록 조회
+     */
+    async getFactsList() {
+        try {
+            const allFacts = await this.folStore.getAllFacts();
+            return Object.values(allFacts);
+        }
+        catch (error) {
+            logger_js_1.loggers.fol.error("getFactsList execution error:", { error });
+            throw error;
+        }
+    }
+    /**
+     * Intent별 Facts 맵 조회
+     */
+    async getFactsMap() {
+        try {
+            return await this.folStore.getAllFacts();
+        }
+        catch (error) {
+            logger_js_1.loggers.fol.error("getFactsMap execution error:", { error });
+            throw error;
+        }
+    }
+    /**
+     * FOL 기반 데이터 조회 및 추론
+     */
+    async queryFacts(intent, query) {
+        try {
+            const facts = await this.retrieveFacts(intent);
+            if (!facts) {
+                return `Intent '${intent}'에 대한 Facts가 없습니다.`;
+            }
+            // 데이터를 문자열로 변환 (AI 프롬프트용)
+            const constantsStr = facts.constants
+                .map((c) => `${c.name}: ${c.description}`)
+                .join(", ");
+            const predicatesStr = facts.predicates
+                .map((p) => `${p.name}: ${p.description}`)
+                .join(", ");
+            const factsStr = facts.facts
+                .map((f) => `${f.name}: ${f.description}`)
+                .join(", ");
+            // FOL 데이터와 쿼리를 기반으로 AI 추론 수행
+            const prompt = `
+다음 First-Order Logic (FOL) 데이터를 기반으로 질문에 답해주세요.
+
+Constants: ${constantsStr}
+Predicates: ${predicatesStr}
+Facts: ${factsStr}
+
+질문: ${query}
+
+위의 FOL 데이터를 논리적으로 분석하여 질문에 대한 답변을 제공해주세요.
+각 항목은 "이름: 설명" 형태로 구성되어 있습니다.`;
+            const messages = this.model.generateMessages({ chats: {} }, prompt);
+            const response = await this.model.fetch(messages);
+            // AI 응답에서 텍스트 추출 (응답이 객체인 경우 content 프로퍼티 사용)
+            const responseText = response.content || "";
+            return responseText;
+        }
+        catch (error) {
+            logger_js_1.loggers.fol.error("queryFacts execution error:", { error });
+            throw error;
+        }
+    }
+}
+exports.FOLModule = FOLModule;
+//# sourceMappingURL=fol.module.js.map