@bimatrix-aud-platform/aud_mcp_server 1.1.81 → 1.1.83

package/dist/utils/aud-api-client.d.ts

@@ -54,6 +54,16 @@ export declare function callModuleService(schemaType: string, params: {
     Key: string;
     Value: any[];
 }[]): Promise<SchemaServiceResult>;
+/**
+ * i-AUD 서버의 @RAG_SERVING 서버 스크립트를 호출합니다.
+ * 벡터 검색(VECTOR_SEARCH)을 수행합니다.
+ * @param schemaType VECTOR_SEARCH
+ * @param params 추가 파라미터 (#QUERY#, #CATEGORY#, #API_SIDE#, #TOPICS#, #LIMIT#)
+ */
+export declare function callRagService(schemaType: string, params: {
+    Key: string;
+    Value: any[];
+}[]): Promise<SchemaServiceResult>;
 /**
  * i-AUD 서버의 @DBMS_LIST 서버 스크립트를 호출하여
  * 현재 사용자에게 권한이 있는 DB 연결 목록을 가져옵니다.
@@ -78,6 +88,7 @@ export interface BoxStyleSaveResult {
 export declare function callBoxStyleSaveService(boxStyle: Record<string, any> | Record<string, any>[]): Promise<BoxStyleSaveResult>;
 /**
  * i-AUD 서버에 보고서를 저장(Publish)합니다.
+ * 저장 전 서버 파일 변경 충돌 검사를 수행합니다.
  * VS Code Extension의 submitSaveReportPost와 동일한 역할입니다.
  */
 export declare function callSaveReportService(saveModel: Record<string, any>): Promise<any>;

package/dist/utils/aud-api-client.js

@@ -198,6 +198,49 @@ export function isAudConfigured() {
     const config = getAudConfig();
     return !!(config.serviceUrl && config.apiKey && config.userName);
 }
+/**
+ * config 검증 + DataSet.maf URL을 반환합니다.
+ */
+function ensureConfig() {
+    const config = getAudConfig();
+    if (!config.serviceUrl || !config.apiKey) {
+        throw new Error("i-AUD 서버 접속 정보를 찾을 수 없습니다.\n"
+            + "다음 중 하나를 설정해 주세요:\n"
+            + "  1) .vscode/settings.json의 aud.config (ServiceURL, ApiKey, UserName)\n"
+            + "  2) 환경변수: AUD_SERVICE_URL, AUD_API_KEY, AUD_USER_NAME");
+    }
+    const url = config.serviceUrl
+        + (config.serviceUrl.endsWith("/") ? "servlet/DataSet.maf" : "/servlet/DataSet.maf");
+    return { config, url };
+}
+/**
+ * i-AUD 서버에 PACKET을 POST로 전송하고 응답을 반환합니다.
+ * 서버 레벨 오류(retCode/retMsg)가 있으면 throw 합니다.
+ */
+async function postServiceRequest(config, url, packetStr, hashcodeSuffix) {
+    const formBody = new URLSearchParams();
+    formBody.append("ENC", "false");
+    formBody.append("OUT", "1");
+    formBody.append("hashcode", "aud.mcp." + config.userName + (hashcodeSuffix || ""));
+    formBody.append("ver", "400");
+    formBody.append("PACKET", packetStr);
+    const response = await fetch(url, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/x-www-form-urlencoded",
+            "Authorization": "Bearer " + config.apiKey,
+        },
+        body: formBody.toString(),
+    });
+    if (!response.ok) {
+        throw new Error(`i-AUD 서버 요청 실패: HTTP ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    if (data.retCode && data.retMsg) {
+        throw new Error(`i-AUD 서버 오류: [${data.retCode}] ${data.retMsg}`);
+    }
+    return data;
+}
 /**
  * PACKET JSON을 구성합니다. (VS Code Extension의 getPacketText와 동일한 구조)
  */
@@ -231,44 +274,13 @@ function buildPacket(config, scriptCode, script, params) {
  * i-AUD 서버의 @SCHEMA_SERVICE 서버 스크립트를 호출합니다.
  */
 export async function callSchemaService(schemaType, params) {
-    const config = getAudConfig();
-    if (!config.serviceUrl || !config.apiKey) {
-        throw new Error("i-AUD 서버 접속 정보를 찾을 수 없습니다.\n"
-            + "다음 중 하나를 설정해 주세요:\n"
-            + "  1) .vscode/settings.json의 aud.config (ServiceURL, ApiKey, UserName)\n"
-            + "  2) 환경변수: AUD_SERVICE_URL, AUD_API_KEY, AUD_USER_NAME");
-    }
+    const { config, url } = ensureConfig();
     const allParams = [
         { Key: "#SCHEMA_TYPE#", Value: [schemaType] },
         ...params,
     ];
-    const url = config.serviceUrl
-        + (config.serviceUrl.endsWith("/") ? "servlet/DataSet.maf" : "/servlet/DataSet.maf");
     const packetStr = buildPacket(config, "@AUD_SAVE_SERVICE@SCHEMA_SERVICE", SERVICE_SOURCE_LIST.SCHEMA_SERVICE, allParams);
-    // multipart/form-data 형식으로 전송 (VS Code Extension과 동일)
-    const formBody = new URLSearchParams();
-    formBody.append("ENC", "false");
-    formBody.append("OUT", "1");
-    formBody.append("hashcode", "aud.mcp." + config.userName + generateId("."));
-    formBody.append("ver", "400");
-    formBody.append("PACKET", packetStr);
-    const response = await fetch(url, {
-        method: "POST",
-        headers: {
-            "Content-Type": "application/x-www-form-urlencoded",
-            "Authorization": "Bearer " + config.apiKey,
-        },
-        body: formBody.toString(),
-    });
-    if (!response.ok) {
-        throw new Error(`i-AUD 서버 요청 실패: HTTP ${response.status} ${response.statusText}`);
-    }
-    const data = await response.json();
-    // 서버 레벨 오류 체크
-    if (data.retCode && data.retMsg) {
-        throw new Error(`i-AUD 서버 오류: [${data.retCode}] ${data.retMsg}`);
-    }
-    return data;
+    return await postServiceRequest(config, url, packetStr, generateId("."));
 }
 /**
  * i-AUD 서버의 @MODULE_SERVICE 서버 스크립트를 호출합니다.
@@ -277,241 +289,114 @@ export async function callSchemaService(schemaType, params) {
  * @param params 추가 파라미터
  */
 export async function callModuleService(schemaType, params) {
-    const config = getAudConfig();
-    if (!config.serviceUrl || !config.apiKey) {
-        throw new Error("i-AUD 서버 접속 정보를 찾을 수 없습니다.\n"
-            + "다음 중 하나를 설정해 주세요:\n"
-            + "  1) .vscode/settings.json의 aud.config (ServiceURL, ApiKey, UserName)\n"
-            + "  2) 환경변수: AUD_SERVICE_URL, AUD_API_KEY, AUD_USER_NAME");
-    }
+    const { config, url } = ensureConfig();
     const allParams = [
         { Key: "#SCHEMA_TYPE#", Value: [schemaType] },
         ...params,
     ];
-    const url = config.serviceUrl
-        + (config.serviceUrl.endsWith("/") ? "servlet/DataSet.maf" : "/servlet/DataSet.maf");
     const packetStr = buildPacket(config, "@AUD_SAVE_SERVICE@MODULE_SERVICE", SERVICE_SOURCE_LIST.MODULE_SERVICE, allParams);
-    // multipart/form-data 형식으로 전송 (VS Code Extension과 동일)
-    const formBody = new URLSearchParams();
-    formBody.append("ENC", "false");
-    formBody.append("OUT", "1");
-    formBody.append("hashcode", "aud.mcp." + config.userName);
-    formBody.append("ver", "400");
-    formBody.append("PACKET", packetStr);
-    const response = await fetch(url, {
-        method: "POST",
-        headers: {
-            "Content-Type": "application/x-www-form-urlencoded",
-            "Authorization": "Bearer " + config.apiKey,
-        },
-        body: formBody.toString(),
-    });
-    if (!response.ok) {
-        throw new Error(`i-AUD 서버 요청 실패: HTTP ${response.status} ${response.statusText}`);
-    }
-    const data = await response.json();
-    // 서버 레벨 오류 체크
-    if (data.retCode && data.retMsg) {
-        throw new Error(`i-AUD 서버 오류: [${data.retCode}] ${data.retMsg}`);
-    }
-    return data;
+    return await postServiceRequest(config, url, packetStr);
+}
+/**
+ * i-AUD 서버의 @RAG_SERVING 서버 스크립트를 호출합니다.
+ * 벡터 검색(VECTOR_SEARCH)을 수행합니다.
+ * @param schemaType VECTOR_SEARCH
+ * @param params 추가 파라미터 (#QUERY#, #CATEGORY#, #API_SIDE#, #TOPICS#, #LIMIT#)
+ */
+export async function callRagService(schemaType, params) {
+    const { config, url } = ensureConfig();
+    const allParams = [
+        { Key: "#SCHEMA_TYPE#", Value: [schemaType] },
+        ...params,
+    ];
+    const packetStr = buildPacket(config, "@AUD_SAVE_SERVICE@RAG_SERVING", SERVICE_SOURCE_LIST.RAG_SERVING, allParams);
+    return await postServiceRequest(config, url, packetStr);
 }
 /**
  * i-AUD 서버의 @DBMS_LIST 서버 스크립트를 호출하여
  * 현재 사용자에게 권한이 있는 DB 연결 목록을 가져옵니다.
  */
 export async function callDbmsList() {
-    const config = getAudConfig();
-    if (!config.serviceUrl || !config.apiKey) {
-        throw new Error("i-AUD 서버 접속 정보를 찾을 수 없습니다.\n"
-            + "다음 중 하나를 설정해 주세요:\n"
-            + "  1) .vscode/settings.json의 aud.config (ServiceURL, ApiKey, UserName)\n"
-            + "  2) 환경변수: AUD_SERVICE_URL, AUD_API_KEY, AUD_USER_NAME");
-    }
-    const url = config.serviceUrl
-        + (config.serviceUrl.endsWith("/") ? "servlet/DataSet.maf" : "/servlet/DataSet.maf");
+    const { config, url } = ensureConfig();
     const packetStr = buildPacket(config, "@AUD_SAVE_SERVICE@DBMS_LIST", SERVICE_SOURCE_LIST.DBMS_LIST, []);
-    const formBody = new URLSearchParams();
-    formBody.append("ENC", "false");
-    formBody.append("OUT", "1");
-    formBody.append("hashcode", "aud.mcp." + config.userName);
-    formBody.append("ver", "400");
-    formBody.append("PACKET", packetStr);
-    const response = await fetch(url, {
-        method: "POST",
-        headers: {
-            "Content-Type": "application/x-www-form-urlencoded",
-            "Authorization": "Bearer " + config.apiKey,
-        },
-        body: formBody.toString(),
-    });
-    if (!response.ok) {
-        throw new Error(`i-AUD 서버 요청 실패: HTTP ${response.status} ${response.statusText}`);
-    }
-    const data = await response.json();
-    if (data.retCode && data.retMsg) {
-        throw new Error(`i-AUD 서버 오류: [${data.retCode}] ${data.retMsg}`);
-    }
-    return data;
+    return await postServiceRequest(config, url, packetStr);
 }
 /**
  * i-AUD 서버의 @BOXSTYLE_LIST 서버 스크립트를 호출하여
  * BoxStyle 목록을 가져옵니다.
  */
 export async function callBoxStyleService() {
-    const config = getAudConfig();
-    if (!config.serviceUrl || !config.apiKey) {
-        throw new Error("i-AUD 서버 접속 정보를 찾을 수 없습니다.\n"
-            + "다음 중 하나를 설정해 주세요:\n"
-            + "  1) .vscode/settings.json의 aud.config (ServiceURL, ApiKey, UserName)\n"
-            + "  2) 환경변수: AUD_SERVICE_URL, AUD_API_KEY, AUD_USER_NAME");
-    }
-    const url = config.serviceUrl
-        + (config.serviceUrl.endsWith("/") ? "servlet/DataSet.maf" : "/servlet/DataSet.maf");
+    const { config, url } = ensureConfig();
     const packetStr = buildPacket(config, "@AUD_SAVE_SERVICE@BOXSTYLE_LIST", SERVICE_SOURCE_LIST.BOXSTYLE_LIST, []);
-    const formBody = new URLSearchParams();
-    formBody.append("ENC", "false");
-    formBody.append("OUT", "1");
-    formBody.append("hashcode", "aud.mcp." + config.userName);
-    formBody.append("ver", "400");
-    formBody.append("PACKET", packetStr);
-    const response = await fetch(url, {
-        method: "POST",
-        headers: {
-            "Content-Type": "application/x-www-form-urlencoded",
-            "Authorization": "Bearer " + config.apiKey,
-        },
-        body: formBody.toString(),
-    });
-    if (!response.ok) {
-        throw new Error(`i-AUD 서버 요청 실패: HTTP ${response.status} ${response.statusText}`);
-    }
-    const data = await response.json();
-    if (data.retCode && data.retMsg) {
-        throw new Error(`i-AUD 서버 오류: [${data.retCode}] ${data.retMsg}`);
-    }
-    return data;
+    return await postServiceRequest(config, url, packetStr);
 }
 /**
  * i-AUD 서버에 BoxStyle을 저장(생성/수정)합니다.
  * 단일 객체 또는 배열을 전달할 수 있습니다.
  */
 export async function callBoxStyleSaveService(boxStyle) {
-    const config = getAudConfig();
-    if (!config.serviceUrl || !config.apiKey) {
-        throw new Error("i-AUD 서버 접속 정보를 찾을 수 없습니다.\n"
-            + "다음 중 하나를 설정해 주세요:\n"
-            + "  1) .vscode/settings.json의 aud.config (ServiceURL, ApiKey, UserName)\n"
-            + "  2) 환경변수: AUD_SERVICE_URL, AUD_API_KEY, AUD_USER_NAME");
-    }
-    const url = config.serviceUrl
-        + (config.serviceUrl.endsWith("/") ? "servlet/DataSet.maf" : "/servlet/DataSet.maf");
+    const { config, url } = ensureConfig();
     const packetStr = buildPacket(config, "@AUD_SAVE_SERVICE@BOXSTYLE_SAVE", SERVICE_SOURCE_LIST.BOXSTYLE_SAVE, [
         { Key: "#BOXSTYLE_DATA#", Value: [JSON.stringify(boxStyle)] },
     ]);
-    const formBody = new URLSearchParams();
-    formBody.append("ENC", "false");
-    formBody.append("OUT", "1");
-    formBody.append("hashcode", "aud.mcp." + config.userName);
-    formBody.append("ver", "400");
-    formBody.append("PACKET", packetStr);
-    const response = await fetch(url, {
-        method: "POST",
-        headers: {
-            "Content-Type": "application/x-www-form-urlencoded",
-            "Authorization": "Bearer " + config.apiKey,
-        },
-        body: formBody.toString(),
-    });
-    if (!response.ok) {
-        throw new Error(`i-AUD 서버 요청 실패: HTTP ${response.status} ${response.statusText}`);
+    return await postServiceRequest(config, url, packetStr);
+}
+/**
+ * 저장 전 서버의 보고서 수정일자를 확인하여 충돌 여부를 검사합니다.
+ * 서버 파일이 로컬보다 최근에 수정되었으면 에러를 throw 합니다.
+ */
+async function callCheckSaveService(config, url, reportCode, clientEditDate) {
+    const packetStr = buildPacket(config, "@AUD_SAVE_SERVICE@CHECK_SAVE", SERVICE_SOURCE_LIST.CHECK_SAVE || "", [
+        { Key: "VS_REPORT_CODE", Value: [reportCode] },
+        { Key: "VS_EDIT_DATE", Value: [clientEditDate] },
+    ]);
+    try {
+        const data = await postServiceRequest(config, url, packetStr);
+        let result = data;
+        if (typeof data === "string") {
+            result = JSON.parse(data);
+        }
+        if (result.Success === false) {
+            throw new Error(result.Message);
+        }
     }
-    const data = await response.json();
-    if (data.retCode && data.retMsg) {
-        throw new Error(`i-AUD 서버 오류: [${data.retCode}] ${data.retMsg}`);
+    catch (e) {
+        // postServiceRequest의 서버 오류(retCode/retMsg)는 에러 메시지만 출력하고 저장 진행
+        if (e.message?.includes("i-AUD 서버 오류")) {
+            process.stderr.write(`[aud_mcp_server] checkSaveConflict server error: ${e.message}\n`);
+            return;
+        }
+        throw e;
     }
-    return data;
 }
 /**
  * i-AUD 서버에 보고서를 저장(Publish)합니다.
+ * 저장 전 서버 파일 변경 충돌 검사를 수행합니다.
  * VS Code Extension의 submitSaveReportPost와 동일한 역할입니다.
  */
 export async function callSaveReportService(saveModel) {
-    const config = getAudConfig();
-    if (!config.serviceUrl || !config.apiKey) {
-        throw new Error("i-AUD 서버 접속 정보를 찾을 수 없습니다.\n"
-            + "다음 중 하나를 설정해 주세요:\n"
-            + "  1) .vscode/settings.json의 aud.config (ServiceURL, ApiKey, UserName)\n"
-            + "  2) 환경변수: AUD_SERVICE_URL, AUD_API_KEY, AUD_USER_NAME");
-    }
-    const url = config.serviceUrl
-        + (config.serviceUrl.endsWith("/") ? "servlet/DataSet.maf" : "/servlet/DataSet.maf");
+    const { config, url } = ensureConfig();
+    // 1. 저장 전 충돌 검사
+    const reportCode = saveModel.REPORT_CODE || "";
+    const clientEditDate = saveModel.ReportModel?.ReportInfo?.EditDate || "";
+    await callCheckSaveService(config, url, reportCode, clientEditDate);
+    // 2. 서버 전송
     const packetStr = buildPacket(config, "@AUD_SAVE_SERVICE@SAVE_REPORT", SERVICE_SOURCE_LIST.SAVE_REPORT, [
         { Key: "VS_REPORT_INFO", Value: [JSON.stringify(saveModel)] },
     ]);
-    const formBody = new URLSearchParams();
-    formBody.append("ENC", "false");
-    formBody.append("OUT", "1");
-    formBody.append("hashcode", "aud.mcp." + config.userName);
-    formBody.append("ver", "400");
-    formBody.append("PACKET", packetStr);
-    const response = await fetch(url, {
-        method: "POST",
-        headers: {
-            "Content-Type": "application/x-www-form-urlencoded",
-            "Authorization": "Bearer " + config.apiKey,
-        },
-        body: formBody.toString(),
-    });
-    if (!response.ok) {
-        throw new Error(`i-AUD 서버 요청 실패: HTTP ${response.status} ${response.statusText}`);
-    }
-    const data = await response.json();
-    if (data.retCode && data.retMsg) {
-        throw new Error(`i-AUD 서버 오류: [${data.retCode}] ${data.retMsg}`);
-    }
-    return data;
+    return await postServiceRequest(config, url, packetStr);
 }
 /**
  * i-AUD 서버에서 보고서를 읽어옵니다 (Pull).
  * VS Code Extension의 submitReadReportPost와 동일한 역할입니다.
  */
 export async function callReadReportService(reportCode) {
-    const config = getAudConfig();
-    if (!config.serviceUrl || !config.apiKey) {
-        throw new Error("i-AUD 서버 접속 정보를 찾을 수 없습니다.\n"
-            + "다음 중 하나를 설정해 주세요:\n"
-            + "  1) .vscode/settings.json의 aud.config (ServiceURL, ApiKey, UserName)\n"
-            + "  2) 환경변수: AUD_SERVICE_URL, AUD_API_KEY, AUD_USER_NAME");
-    }
-    const url = config.serviceUrl
-        + (config.serviceUrl.endsWith("/") ? "servlet/DataSet.maf" : "/servlet/DataSet.maf");
+    const { config, url } = ensureConfig();
     const packetStr = buildPacket(config, "@AUD_SAVE_SERVICE@READ_REPORT", SERVICE_SOURCE_LIST.READ_REPORT, [
         { Key: "VS_REPORT_CODE", Value: [reportCode] },
         { Key: "VS_REPORT_NAME", Value: [""] },
     ]);
-    const formBody = new URLSearchParams();
-    formBody.append("ENC", "false");
-    formBody.append("OUT", "1");
-    formBody.append("hashcode", "aud.mcp." + config.userName);
-    formBody.append("ver", "400");
-    formBody.append("PACKET", packetStr);
-    const response = await fetch(url, {
-        method: "POST",
-        headers: {
-            "Content-Type": "application/x-www-form-urlencoded",
-            "Authorization": "Bearer " + config.apiKey,
-        },
-        body: formBody.toString(),
-    });
-    if (!response.ok) {
-        throw new Error(`i-AUD 서버 요청 실패: HTTP ${response.status} ${response.statusText}`);
-    }
-    const data = await response.json();
-    if (data.retCode && data.retMsg) {
-        throw new Error(`i-AUD 서버 오류: [${data.retCode}] ${data.retMsg}`);
-    }
-    return data;
+    return await postServiceRequest(config, url, packetStr);
 }
 /**
  * MX_GRID 리소스 파일을 서버에서 다운로드하고 압축을 풀어 로컬에 저장합니다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bimatrix-aud-platform/aud_mcp_server",
-  "version": "1.1.81",
+  "version": "1.1.83",
   "description": "MCP Server for i-AUD MTSD document validation, generation, schema querying, control info extraction, and database operations",
   "type": "module",
   "main": "dist/index.js",