@ainetwork/adk 0.0.1

package/dist/esm/intent/analyzer.d.ts

@@ -0,0 +1,24 @@
+import type { IBaseModel } from "../models/BaseModel.js";
+import type { SessionObject } from "../session/BaseSession.js";
+import type { A2AModule } from "./modules/a2a/index.js";
+import type { FOLClient } from "./modules/fol/index.js";
+import type { MCPModule } from "./modules/mcp/index.js";
+export declare class IntentAnalyzer {
+    private model;
+    private a2a?;
+    private mcp?;
+    private fol?;
+    private basePrompt?;
+    constructor(model: IBaseModel);
+    addMCPModule(mcp: MCPModule): void;
+    addA2AModule(a2a: A2AModule): void;
+    addFOLModule(fol: FOLClient): void;
+    addBasePrompt(prompt: string): void;
+    handleQuery(query: string): Promise<any>;
+    handleQueryWithSession(query: string, sessionId: string, sessionHistory: SessionObject): Promise<any>;
+    generate(query: string, sessionId: string, sessionHistory: SessionObject): Promise<{
+        process: string;
+        response: string;
+    }>;
+}
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/esm/intent/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../../src/intent/analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAIxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGxD,qBAAa,cAAc;IAC1B,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,GAAG,CAAC,CAAY;IACxB,OAAO,CAAC,GAAG,CAAC,CAAY;IACxB,OAAO,CAAC,GAAG,CAAC,CAAY;IACxB,OAAO,CAAC,UAAU,CAAC,CAAS;gBAEhB,KAAK,EAAE,UAAU;IAItB,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI;IAIlC,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI;IAIlC,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI;IAIlC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI7B,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAaxC,sBAAsB,CAClC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,aAAa,GAC3B,OAAO,CAAC,GAAG,CAAC;IAeF,QAAQ,CACpB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,aAAa;;;;CAyI9B"}

package/dist/esm/intent/analyzer.js

@@ -0,0 +1,150 @@
+import { loggers } from "../utils/logger.js";
+import { PROTOCOL_TYPE } from "./modules/common/types.js";
+export class IntentAnalyzer {
+    constructor(model) {
+        this.model = model;
+    }
+    addMCPModule(mcp) {
+        this.mcp = mcp;
+    }
+    addA2AModule(a2a) {
+        this.a2a = a2a;
+    }
+    addFOLModule(fol) {
+        this.fol = fol;
+    }
+    addBasePrompt(prompt) {
+        this.basePrompt = prompt;
+    }
+    async handleQuery(query) {
+        // 1. intent triggering
+        // TODO: Extract the user's intent using query, context, and FOL
+        const intent = query; // FIXME
+        // 2. intent fulfillment
+        // Using the extracted intent, generate a response.
+        const response = (await this.generate(intent, "", {})).response;
+        return {
+            content: response,
+        };
+    }
+    async handleQueryWithSession(query, sessionId, sessionHistory) {
+        // 1. intent triggering
+        // TODO: Extract the user's intent using query, context, and FOL
+        const intent = query; // FIXME
+        // 2. intent fulfillment
+        // Using the extracted intent, generate a response.
+        const response = (await this.generate(intent, sessionId, sessionHistory))
+            .response;
+        return {
+            content: response,
+        };
+    }
+    async generate(query, sessionId, sessionHistory) {
+        // FIXME(yoojin): Need general system prompt for MCP tool search
+        const systemMessage = `
+Today is ${new Date().toLocaleDateString()}.
+
+${this.basePrompt}
+
+You are a highly sophisticated automated agent that can answer user queries by utilizing various tools and resources.
+
+There is a selection of tools that let you perform actions or retrieve helpful context to answer the user's question.
+You can call tools repeatedly to take actions or gather as much context as needed until you have completed the task fully.
+
+Don't give up unless you are sure the request cannot be fulfilled with the tools you have.
+It's YOUR RESPONSIBILITY to make sure that you have done all you can to collect necessary context.
+
+If you are not sure about content or context pertaining to the user's request, use your tools to read data and gather the relevant information: do NOT guess or make up an answer.
+Be THOROUGH when gathering information. Make sure you have the FULL picture before replying. Use additional tool calls or clarifying questions as needed.
+
+Don't try to answer the user's question directly.
+First break down the user's request into smaller concepts and think about the kinds of tools and queries you need to grasp each concept.
+
+tool에는 MCP_Tool, A2A_Tool 두 가지 <tool_type> 이 존재한다.
+tool type은 tool 결과 메세지의 처음에 [Bot Called <tool_type> with args <tool_args>] 이 포함됨을 통해 알 수 있다.
+tool 실행 후에는 반드시 최종 응답 메시지를 작성해야한다.
+
+각 <tool_type> 에 대한 사용 지침은 아래를 참고한다.
+
+<MCP_Tool>
+    tools 를 통해 MCP tool 을 사용한다.
+    MCP tool 의 이름은 다음과 같이 구성되어있다. 
+      {MCP_NAME}_{TOOL_NAME}
+      예를 들어, "notionApi" mcp의 tool 이름은 아래와 같다.
+        notionApi_API-post-search
+
+    각 MCP_NAME 마다 <{MCP_NAME}> 아래에서 별도의 규칙을 지정할 수 있다.
+</MCP_Tool>
+
+<A2A_Tool>
+    A2A_Tool은 나와 다른 정보를 가진 Agent에게 query를 보내고 답변을 받는 tool이다. 어떤 Agent 를 통해 답변 받았는지 반드시 표기해야한다.
+    A2A_Tool을 통한 결과는 요청한 Agent에서 충분이 숙고한 후 생성한 텍스트로, 해당 내용에 대해서는 더 이상 발전시킬 수 없는 완성된 결과물이다.
+    이에 대해 같은 질문으로 내용을 보충하거나 새로운 tool을 사용하지 않아도 된다.
+
+    [A2A Call by <AGENT_NAME>] 으로 시작하는 텍스트가 요청으로 들어온 경우 다른 Agent에서 A2A_Tool 로써 요청한 query이다.
+    이 경우 다른 A2A_Tool 을 사용하지 않고 MCP_Tool 만 사용하여 답변을 생성해야한다.
+</A2A_Tool>
+`;
+        const messages = this.model.generateMessages(sessionHistory, query, systemMessage.trim());
+        const tools = [];
+        if (this.mcp) {
+            tools.push(...this.mcp.getTools());
+        }
+        if (this.a2a) {
+            tools.push(...(await this.a2a.getTools()));
+        }
+        const functions = this.model.convertToolsToFunctions(tools);
+        const processList = [];
+        let finalMessage = "";
+        let didCallTool = false;
+        while (true) {
+            const response = await this.model.fetchWithContextMessage(messages, functions);
+            didCallTool = false;
+            loggers.intent.debug("messages", { messages });
+            const { content, toolCalls } = response;
+            loggers.intent.debug("content", { content });
+            loggers.intent.debug("tool_calls", { ...toolCalls });
+            if (toolCalls) {
+                const messagePayload = this.a2a?.getMessagePayload(query, sessionId);
+                for (const toolCall of toolCalls) {
+                    const toolName = toolCall.name;
+                    didCallTool = true;
+                    const selectedTool = tools.filter((tool) => tool.id === toolName)[0];
+                    let toolResult = "";
+                    if (this.mcp && selectedTool.protocol === PROTOCOL_TYPE.MCP) {
+                        const toolArgs = toolCall.arguments;
+                        loggers.intent.debug("MCP tool call", { toolName, toolArgs });
+                        const result = await this.mcp.useTool(selectedTool, toolArgs);
+                        toolResult =
+                            `[Bot Called MCP Tool ${toolName} with args ${JSON.stringify(toolArgs)}]\n` +
+                                JSON.stringify(result.content, null, 2);
+                    }
+                    else if (this.a2a && selectedTool.protocol === PROTOCOL_TYPE.A2A) {
+                        const result = await this.a2a.useTool(selectedTool, messagePayload, sessionId);
+                        toolResult = `[Bot Called A2A Tool ${toolName}]\n${result.join("\n")}`;
+                    }
+                    else {
+                        // Unrecognized tool type. It cannot be happened...
+                        loggers.intent.warn(`Unrecognized tool type: ${selectedTool.protocol}`);
+                        continue;
+                    }
+                    loggers.intent.debug("toolResult", { toolResult });
+                    processList.push(toolResult);
+                    this.model.expandMessages(messages, toolResult);
+                }
+            }
+            else if (content) {
+                processList.push(content);
+                finalMessage = content;
+            }
+            if (!didCallTool)
+                break;
+        }
+        const botResponse = {
+            process: processList.join("\n"),
+            response: finalMessage,
+        };
+        return botResponse;
+    }
+}
+//# sourceMappingURL=analyzer.js.map

package/dist/esm/intent/analyzer.js.map

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

package/dist/esm/intent/modules/a2a/index.d.ts

@@ -0,0 +1,12 @@
+import { type Message } from "@a2a-js/sdk";
+import { A2ATool } from "./tool.js";
+export declare class A2AModule {
+    private a2aServers;
+    private a2aSessions;
+    addA2AServer(url: string): Promise<void>;
+    getTools(): Promise<A2ATool[]>;
+    private getA2ASessionWithId;
+    getMessagePayload(query: string, sessionId: string): Message;
+    useTool(tool: A2ATool, messagePayload: Message, sessionId: string): Promise<string[]>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/intent/modules/a2a/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/intent/modules/a2a/index.ts"],"names":[],"mappings":"AACA,OAAO,EAGN,KAAK,OAAO,EAKZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,qBAAa,SAAS;IACrB,OAAO,CAAC,UAAU,CAA0C;IAC5D,OAAO,CAAC,WAAW,CAAsC;IAE5C,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAyB3C,OAAO,CAAC,mBAAmB,CAUzB;IAEK,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IA2BtD,OAAO,CACnB,IAAI,EAAE,OAAO,EACb,cAAc,EAAE,OAAO,EACvB,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC;CA2DpB"}

package/dist/esm/intent/modules/a2a/index.js

@@ -0,0 +1,132 @@
+import { randomUUID } from "node:crypto";
+import { A2AClient, } from "@a2a-js/sdk";
+import { loggers } from "../../../utils/logger.js";
+import { A2ATool } from "./tool.js";
+export class A2AModule {
+    constructor() {
+        this.a2aServers = new Map();
+        this.a2aSessions = new Map(); // Map from session ID to A2A 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;
+        };
+    }
+    async addA2AServer(url) {
+        this.a2aServers.set(url, null);
+    }
+    async getTools() {
+        const tools = [];
+        for (const url of [...this.a2aServers.keys()]) {
+            const tool = this.a2aServers.get(url);
+            if (!tool || !tool.enabled) {
+                try {
+                    const client = new A2AClient(url);
+                    const card = await client.getAgentCard();
+                    const toolName = card.name.replaceAll(" ", "-");
+                    const a2aTool = new A2ATool(toolName, client, card);
+                    tools.push(a2aTool);
+                }
+                catch (_error) {
+                    // Agent not responded
+                    if (tool) {
+                        tool.disable();
+                    }
+                }
+            }
+            else {
+                tools.push(tool);
+            }
+        }
+        return tools;
+    }
+    getMessagePayload(query, sessionId) {
+        const messagePayload = {
+            messageId: 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;
+    }
+    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 {
+                    loggers.a2a.warn("Received unknown event structure from stream:", {
+                        event,
+                    });
+                }
+            }
+        }
+        catch (error) {
+            loggers.a2a.error("Error communicating with agent:", { error });
+            tool.disable();
+            // TODO: add failed & disabled text for next inference?
+        }
+        return finalText;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/intent/modules/a2a/index.js.map

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

package/dist/esm/intent/modules/a2a/tool.d.ts

@@ -0,0 +1,8 @@
+import type { A2AClient, AgentCard } from "@a2a-js/sdk";
+import { AgentTool } from "../common/tool.js";
+export declare class A2ATool extends AgentTool {
+    client: A2AClient;
+    card: AgentCard;
+    constructor(name: string, client: A2AClient, card: AgentCard);
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/esm/intent/modules/a2a/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../../../src/intent/modules/a2a/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,qBAAa,OAAQ,SAAQ,SAAS;IAC9B,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;gBAEX,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS;CAK5D"}

package/dist/esm/intent/modules/a2a/tool.js

@@ -0,0 +1,10 @@
+import { AgentTool } from "../common/tool.js";
+import { PROTOCOL_TYPE } from "../common/types.js";
+export class A2ATool extends AgentTool {
+    constructor(name, client, card) {
+        super(name, PROTOCOL_TYPE.A2A);
+        this.client = client;
+        this.card = card;
+    }
+}
+//# sourceMappingURL=tool.js.map

package/dist/esm/intent/modules/a2a/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../../../src/intent/modules/a2a/tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,OAAO,OAAQ,SAAQ,SAAS;IAIrC,YAAY,IAAY,EAAE,MAAiB,EAAE,IAAe;QAC3D,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,CAAC;CACD"}

package/dist/esm/intent/modules/common/tool.d.ts

@@ -0,0 +1,10 @@
+import type { PROTOCOL_TYPE } from "./types.js";
+export declare class AgentTool {
+    id: string;
+    protocol: PROTOCOL_TYPE;
+    enabled: boolean;
+    constructor(id: string, protocol: PROTOCOL_TYPE);
+    enable(): void;
+    disable(): void;
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/esm/intent/modules/common/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../../../src/intent/modules/common/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,qBAAa,SAAS;IACd,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;gBAEZ,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa;IAMxC,MAAM,IAAI,IAAI;IAId,OAAO,IAAI,IAAI;CAGtB"}

package/dist/esm/intent/modules/common/tool.js

@@ -0,0 +1,14 @@
+export class AgentTool {
+    constructor(id, protocol) {
+        this.id = id;
+        this.protocol = protocol;
+        this.enabled = true;
+    }
+    enable() {
+        this.enabled = true;
+    }
+    disable() {
+        this.enabled = false;
+    }
+}
+//# sourceMappingURL=tool.js.map

package/dist/esm/intent/modules/common/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../../../src/intent/modules/common/tool.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,SAAS;IAKrB,YAAY,EAAU,EAAE,QAAuB;QAC9C,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,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"}

package/dist/esm/intent/modules/common/types.d.ts

@@ -0,0 +1,5 @@
+export declare enum PROTOCOL_TYPE {
+    A2A = "A2A",
+    MCP = "MCP"
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/intent/modules/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/intent/modules/common/types.ts"],"names":[],"mappings":"AAAA,oBAAY,aAAa;IACxB,GAAG,QAAQ;IACX,GAAG,QAAQ;CACX"}

package/dist/esm/intent/modules/common/types.js

@@ -0,0 +1,6 @@
+export var PROTOCOL_TYPE;
+(function (PROTOCOL_TYPE) {
+    PROTOCOL_TYPE["A2A"] = "A2A";
+    PROTOCOL_TYPE["MCP"] = "MCP";
+})(PROTOCOL_TYPE || (PROTOCOL_TYPE = {}));
+//# sourceMappingURL=types.js.map

package/dist/esm/intent/modules/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/intent/modules/common/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IACxB,4BAAW,CAAA;IACX,4BAAW,CAAA;AACZ,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB"}

package/dist/esm/intent/modules/fol/client/folClient.d.ts

@@ -0,0 +1,31 @@
+import type { BaseModel } from "../../../../modules/models/model.module.js";
+import type { FOLStore } from "../store/index.js";
+import type { Facts } from "../types/index.js";
+export declare class FOLClient {
+    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=folClient.d.ts.map

package/dist/esm/intent/modules/fol/client/folClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folClient.d.ts","sourceRoot":"","sources":["../../../../../../src/intent/modules/fol/client/folClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAElE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAI/C,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/esm/intent/modules/fol/client/folClient.js

@@ -0,0 +1,178 @@
+import dotenv from "dotenv";
+import { loggers } from "../../../../utils/logger.js";
+dotenv.config();
+export class FOLClient {
+    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);
+            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);
+            loggers.fol.info(`FOL data updated (intent: ${intent})`);
+        }
+        catch (error) {
+            loggers.fol.error("updateFacts execution error:", { error });
+            throw error;
+        }
+    }
+    /**
+     * 특정 intent에 대한 Facts 조회
+     */
+    async retrieveFacts(intent) {
+        try {
+            return await this.folStore.retrieveFacts(intent);
+        }
+        catch (error) {
+            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) {
+            loggers.fol.error("getFactsList execution error:", { error });
+            throw error;
+        }
+    }
+    /**
+     * Intent별 Facts 맵 조회
+     */
+    async getFactsMap() {
+        try {
+            return await this.folStore.getAllFacts();
+        }
+        catch (error) {
+            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) {
+            loggers.fol.error("queryFacts execution error:", { error });
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=folClient.js.map