refactor: 공용 클래스(MCP, Manifest, UseCase 등) lib 패키지로 이관 및 통합

dap-tool-core/src/main/java/io/shinhanlife/dap/lib/dto/OperationType.java

@@ -0,0 +1,20 @@
+package io.shinhanlife.dap.lib.dto;
+
+/**
+ * @package io.shinhanlife.dap.mcg.dto
+ * @className OperationType
+ * @description AX HUB 시스템 처리 클래스
+ * @author 0986406
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  0986406    최초생성
+ * 
+ * </pre>
+ */
+public enum OperationType {
+    READ,
+    WRITE
+}

dap-tool-core/src/main/java/io/shinhanlife/dap/lib/dto/ToolMetadata.java

@@ -0,0 +1,132 @@
+package io.shinhanlife.dap.lib.dto;
+
+import lombok.Getter;
+import lombok.Setter;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.util.Map;
+import java.util.Set;
+import java.util.List;
+import java.util.HashSet;
+/**
+ * Tool(Agent)의 명세 및 라우팅 정보를 담고 있는 메타데이터 클래스
+ * Redis 레지스트리에 저장되며, Planner와 Router 간의 통신 객체(Plan)로 사용됩니다.
+ */
+/**
+ * @package io.shinhanlife.dap.mcg.dto
+ * @className ToolMetadata
+ * @description AX HUB 시스템 처리 클래스
+ * @author 0986406
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  0986406    최초생성
+ * 
+ * </pre>
+ */
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@Getter
+@Setter
+public class ToolMetadata {
+
+    // 1. Tool 기본 정보
+    private String uid;               // UUID 형식의 고유 식별자
+    private String semver;            // 버전 (예: 1.0.0)
+    private String displayName;              // 사람이 읽는 라벨 (1-128자)
+    private String name;       // MCP 서브툴 명칭 (64자 이하, 예: CustomerSearchTool)
+    private String description;       // 툴의 목적 및 설명 (LLM 프롬프트에 활용 가능)
+
+    // 2. 파라미터 스키마 (JSON Schema 형태의 Map)
+    private Map<String, Object> parametersSchema;
+
+    // 2-0. 프론트엔드 UI용 함수별 프롬프트 매핑 (추가됨)
+    private Map<String, String> actionPrompts;
+
+    // 2-1. 도메인 부서 그룹명 (category_key, 슬러그 형식)
+    private String categoryKey;
+
+    // 2-2. 툴 처리 엔드포인트 URI 경로 (예: /api/tool/customer-info)
+    private String endpoint;
+
+    // 2-3. Pod 실행 URL (독립적인 Microservice 라우팅용, 예: http://localhost:8082)
+    private String podUrl;
+
+    // 2-4. 가시성 여부
+    @Builder.Default
+    private Boolean visible = true;
+    
+    // 활성화 여부
+    @Builder.Default
+    private Boolean enabled = true;
+
+    // 2-5. Redis 등록 여부 (UI 표출용)
+    @Builder.Default
+    private Boolean isRegistered = true;
+
+    // 2-6. HITL 승인 필요 여부
+    @Builder.Default
+    private Boolean requiresApproval = false;
+
+    @Builder.Default
+    private Boolean readOnlyHint = false;
+
+    @Builder.Default
+    private Boolean destructiveHint = false;
+
+    @Builder.Default
+    private Boolean idempotentHint = false;
+
+    @Builder.Default
+    private Boolean openWorldHint = false;
+
+
+
+    // 3. 연동 아키텍처 구분 (DIRECT / MCI_EAI)
+    private String integrationType;   // 연동 타입: "DIRECT" 또는 "MCI_EAI"
+
+    // 4. 레거시(MCI/EAI) 연동 시 필수 정보 (integrationType이 "MCI_EAI"일 때 사용)
+    private String mciServiceId;      // MCI/EAI 호출을 위한 서비스 ID (예: CRM_001, LICO_992)
+
+    // 5. 인프라 상태 정보 (DIRECT 연동 시 사용)
+    private Long lastHeartbeat;       // Redis TTL 갱신용 마지막 하트비트 타임스탬프
+
+    // 6. 동적 서킷 브레이커 & 속도 제어 설정 (Registry 기반)
+    private Integer failureRateThreshold; // 서킷 브레이커 동작 기준 실패율 (%)
+    private Integer slidingWindowSize;    // 서킷 브레이커 에러율 계산 표본 요청 수
+    private Integer rateLimitForPeriod;   // 속도 제어: 1초당 허용 최대 요청 수
+
+    // 7. Gateway 코어 제어용 설정 필드 추가 (재시도, 타임아웃, 오퍼레이션 타입)
+    @Builder.Default
+    private OperationType operationType = OperationType.READ;
+    
+    @Builder.Default
+    private Boolean retryEnabled = true;
+
+    @Builder.Default
+    private Integer circuitBreakerFailureThreshold = 0;
+
+    @Builder.Default
+    private Long circuitBreakerOpenMillis = 0L;
+
+    @Builder.Default
+    private Long timeoutMillis = 0L;
+
+    // --- Guardrail 호환성을 위한 메서드 추가 ---
+    public Set<String> allowedArguments() {
+        if (parametersSchema == null || !parametersSchema.containsKey("properties")) return Set.of();
+        return ((Map<String, Object>) parametersSchema.get("properties")).keySet();
+    }
+
+    public Set<String> requiredArguments() {
+        if (parametersSchema == null || !parametersSchema.containsKey("required")) return Set.of();
+        return new HashSet<>((List<String>) parametersSchema.get("required"));
+    }
+}

dap-tool-core/src/main/java/io/shinhanlife/dap/lib/manifest/ToolManifestAnnotations.java

@@ -1,4 +1,4 @@
-package io.shinhanlife.dap.mcc.manifest;
+package io.shinhanlife.dap.lib.manifest;
 
 /** Behaviour hints exposed by the Tool Service manifest. */
 public record ToolManifestAnnotations(

dap-tool-core/src/main/java/io/shinhanlife/dap/lib/manifest/ToolManifestItem.java

@@ -1,4 +1,4 @@
-package io.shinhanlife.dap.mcc.manifest;
+package io.shinhanlife.dap.lib.manifest;
 
 import com.fasterxml.jackson.annotation.JsonProperty;
 import java.util.Map;

dap-tool-core/src/main/java/io/shinhanlife/dap/lib/manifest/ToolManifestMeta.java

@@ -1,4 +1,4 @@
-package io.shinhanlife.dap.mcc.manifest;
+package io.shinhanlife.dap.lib.manifest;
 
 /** Operational metadata exposed by the Tool Service manifest. */
 public record ToolManifestMeta(String version, long timeoutMillis, boolean enabled) {

dap-tool-core/src/main/java/io/shinhanlife/dap/lib/manifest/ToolManifestResponse.java

@@ -1,4 +1,4 @@
-package io.shinhanlife.dap.mcc.manifest;
+package io.shinhanlife.dap.lib.manifest;
 
 import java.util.List;
 

dap-tool-core/src/main/java/io/shinhanlife/dap/lib/manifest/ToolManifestService.java

@@ -1,9 +1,9 @@
-package io.shinhanlife.dap.mcc.manifest;
+package io.shinhanlife.dap.lib.manifest;
 
 import com.fasterxml.jackson.databind.ObjectMapper;
 import io.shinhanlife.dap.lib.config.McpProperties;
-import io.shinhanlife.dap.mcc.dto.ToolMetadata;
-import io.shinhanlife.dap.mcc.usecase.ToolRegistryHeartbeatSender;
+import io.shinhanlife.dap.lib.dto.ToolMetadata;
+import io.shinhanlife.dap.lib.usecase.ToolRegistryHeartbeatSender;
 import java.nio.charset.StandardCharsets;
 import java.security.MessageDigest;
 import java.util.Comparator;

dap-tool-core/src/main/java/io/shinhanlife/dap/lib/mcp/mcp/McpRequestHeaderContext.java

@@ -1,4 +1,4 @@
-package io.shinhanlife.dap.mcc.mcp;
+package io.shinhanlife.dap.lib.mcp;
 
 /** Holds optional MCP headers for the lifetime of one HTTP request thread. */
 public final class McpRequestHeaderContext {

dap-tool-core/src/main/java/io/shinhanlife/dap/lib/mcp/mcp/McpRequestHeaderFilter.java

@@ -1,4 +1,4 @@
-package io.shinhanlife.dap.mcc.mcp;
+package io.shinhanlife.dap.lib.mcp;
 
 import java.io.IOException;
 import jakarta.servlet.FilterChain;

dap-tool-core/src/main/java/io/shinhanlife/dap/lib/mcp/mcp/McpRequestHeaders.java

@@ -1,4 +1,4 @@
-package io.shinhanlife.dap.mcc.mcp;
+package io.shinhanlife.dap.lib.mcp;
 
 /** Optional request headers propagated from an MCP HTTP request to a Tool invocation. */
 public record McpRequestHeaders(

dap-tool-core/src/main/java/io/shinhanlife/dap/lib/mcp/mcp/ToolMcpServerConfiguration.java

@@ -1,4 +1,4 @@
-package io.shinhanlife.dap.mcc.mcp;
+package io.shinhanlife.dap.lib.mcp;
 
 import io.modelcontextprotocol.server.transport.HttpServletStreamableServerTransportProvider;
 import org.springframework.boot.web.servlet.ServletRegistrationBean;

dap-tool-core/src/main/java/io/shinhanlife/dap/lib/mcp/mcp/ToolPodMcpToolSynchronizer.java

@@ -1,12 +1,12 @@
-package io.shinhanlife.dap.mcc.mcp;
+package io.shinhanlife.dap.lib.mcp;
 
 import com.fasterxml.jackson.databind.ObjectMapper;
 import io.modelcontextprotocol.server.McpServerFeatures;
 import io.modelcontextprotocol.server.McpSyncServer;
 import io.modelcontextprotocol.spec.McpSchema;
-import io.shinhanlife.dap.mcc.dto.ToolMetadata;
+import io.shinhanlife.dap.lib.dto.ToolMetadata;
 import io.shinhanlife.dap.mcc.presentation.BusinessToolController;
-import io.shinhanlife.dap.mcc.usecase.ToolRegistryHeartbeatSender;
+import io.shinhanlife.dap.lib.usecase.ToolRegistryHeartbeatSender;
 import java.util.LinkedHashMap;
 import java.util.Map;
 import org.springframework.boot.context.event.ApplicationReadyEvent;

dap-tool-core/src/main/java/io/shinhanlife/dap/lib/usecase/AbstractMcpToolUseCase.java

@@ -1,4 +1,4 @@
-package io.shinhanlife.dap.mcc.usecase;
+package io.shinhanlife.dap.lib.usecase;
 
 import io.shinhanlife.dap.lib.adapter.connector.LegacyEimsConnector;
 import io.shinhanlife.dap.lib.adapter.util.PiiMaskingUtils;

dap-tool-core/src/main/java/io/shinhanlife/dap/lib/usecase/ToolRegistryHeartbeatSender.java

@@ -1,4 +1,4 @@
-package io.shinhanlife.dap.mcc.usecase;
+package io.shinhanlife.dap.lib.usecase;
 
 
 /**
@@ -19,7 +19,7 @@ import com.fasterxml.jackson.databind.ObjectMapper;
 import io.shinhanlife.dap.lib.annotation.McpFunction;
 import io.shinhanlife.dap.lib.annotation.McpTool;
 import io.shinhanlife.dap.lib.config.McpProperties;
-import io.shinhanlife.dap.mcc.dto.ToolMetadata;
+import io.shinhanlife.dap.lib.dto.ToolMetadata;
 import io.shinhanlife.dap.lib.util.ToolSchemaResolver;
 import jakarta.annotation.PostConstruct;
 import java.lang.reflect.Method;

dap-tool-core/src/main/java/io/shinhanlife/dap/lib/util/ToolScaffolder.java

@@ -330,7 +330,7 @@ public class ToolScaffolder {
                 import %s.dto.%sRequest;
                 import %s.dto.%sResponse;
                 import %s.usecase.%sUseCase;
-                import io.shinhanlife.dap.mcc.usecase.AbstractMcpToolUseCase;
+                import io.shinhanlife.dap.lib.usecase.AbstractMcpToolUseCase;
                 import %s.converter.%sConverter;
                 import org.springframework.stereotype.Service;
                 import lombok.RequiredArgsConstructor;

dap-tool-core/src/main/java/io/shinhanlife/dap/lib/validation/ToolArgumentSchemaValidator.java

@@ -1,4 +1,4 @@
-package io.shinhanlife.dap.mcc.presentation;
+package io.shinhanlife.dap.lib.validation;
 
 import com.fasterxml.jackson.databind.ObjectMapper;
 import com.networknt.schema.Error;

dap-tool-core/src/main/java/io/shinhanlife/dap/mcc/dto/ToolMetadata.java

@@ -1,76 +0,0 @@
-package io.shinhanlife.dap.mcc.dto;
-
-import lombok.Getter;
-import lombok.Setter;
-import lombok.Builder;
-import lombok.NoArgsConstructor;
-import lombok.AllArgsConstructor;
-
-import java.util.Map;
-
-/**
- * @package io.shinhanlife.dap.mcc.dto
- * @className ToolMetadata
- * @description AX HUB 시스템 처리 클래스
- * @author 0986406
- * @create 2026.09.01
- * <pre>
- * ---------- 개정이력 ----------
- * 수정일      수정자    수정내용
- * ---------- -------- ---------------------------
- * 2026.09.01  0986406    최초생성
- * 
- * </pre>
- */
-@Getter
-@Setter
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class ToolMetadata {
-    // 1. Tool 기본 정보
-    private String uid;               // UUID 형식의 고유 식별자
-    private String semver;            // 버전 (예: 1.0.0)
-    private Long timeoutMillis;
-    private Boolean enabled;
-    private String displayName;              // 사람이 읽는 라벨 (1-128자)
-    private String name;       // MCP 서브툴 명칭 (64자 이하, 예: CustomerSearchTool)
-    private String description;       // 툴의 목적 및 설명 (LLM 프롬프트에 활용 가능)
-
-    // 2. 파라미터 스키마 (JSON Schema 형태의 Map)
-    private Map<String, Object> parametersSchema;
-
-    // 2-0. 프론트엔드 UI용 함수별 프롬프트 매핑 (추가됨)
-    private Map<String, String> actionPrompts;
-
-    // 2-1. 도메인 부서 그룹명 (category_key, 슬러그 형식)
-    private String categoryKey;
-    private String endpoint;
-    private String podUrl;
-    private String integrationType;
-    private String mciServiceId;
-
-
-    @Builder.Default
-    private Boolean visible = true;
-
-    @Builder.Default
-    private Boolean isRegistered = true;
-
-    @Builder.Default
-    private Boolean requiresApproval = false;
-
-    @Builder.Default
-    private Boolean readOnlyHint = false;
-
-    @Builder.Default
-    private Boolean destructiveHint = false;
-
-    @Builder.Default
-    private Boolean idempotentHint = false;
-
-    @Builder.Default
-    private Boolean openWorldHint = false;
-
-
-}

dap-tool-core/src/main/java/io/shinhanlife/dap/mcc/presentation/BusinessToolController.java

@@ -18,10 +18,11 @@ package io.shinhanlife.dap.mcc.presentation;
 import com.fasterxml.jackson.databind.ObjectMapper;
 import com.networknt.schema.Error;
 import io.shinhanlife.dap.lib.annotation.McpFunction;
+import io.shinhanlife.dap.lib.validation.ToolArgumentSchemaValidator;
 import io.shinhanlife.dap.lib.annotation.McpTool;
 import io.shinhanlife.dap.lib.config.McpProperties;
-import io.shinhanlife.dap.mcc.dto.ToolMetadata;
-import io.shinhanlife.dap.mcc.usecase.ToolRegistryHeartbeatSender;
+import io.shinhanlife.dap.lib.dto.ToolMetadata;
+import io.shinhanlife.dap.lib.usecase.ToolRegistryHeartbeatSender;
 import io.shinhanlife.dap.lib.util.ToolSchemaResolver;
 import java.lang.reflect.Method;
 import java.util.ArrayList;

dap-tool-core/src/main/java/io/shinhanlife/dap/mcc/presentation/ToolManifestController.java

@@ -1,7 +1,7 @@
 package io.shinhanlife.dap.mcc.presentation;
 
-import io.shinhanlife.dap.mcc.manifest.ToolManifestResponse;
-import io.shinhanlife.dap.mcc.manifest.ToolManifestService;
+import io.shinhanlife.dap.lib.manifest.ToolManifestResponse;
+import io.shinhanlife.dap.lib.manifest.ToolManifestService;
 import org.springframework.http.HttpHeaders;
 import org.springframework.http.MediaType;
 import org.springframework.http.ResponseEntity;

dap-tool-core/src/test/java/io/shinhanlife/dap/mcc/manifest/ToolManifestServiceTest.java

@@ -1,4 +1,4 @@
-package io.shinhanlife.dap.mcc.manifest;
+package io.shinhanlife.dap.lib.manifest;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertThrows;
@@ -6,7 +6,7 @@ import static org.junit.jupiter.api.Assertions.assertTrue;
 
 import com.fasterxml.jackson.databind.ObjectMapper;
 import io.shinhanlife.dap.lib.config.McpProperties;
-import io.shinhanlife.dap.mcc.dto.ToolMetadata;
+import io.shinhanlife.dap.lib.dto.ToolMetadata;
 import java.util.List;
 import java.util.Map;
 import org.junit.jupiter.api.Test;

dap-tool-core/src/test/java/io/shinhanlife/dap/mcc/mcp/McpRequestHeaderFilterTest.java

@@ -1,4 +1,4 @@
-package io.shinhanlife.dap.mcc.mcp;
+package io.shinhanlife.dap.lib.mcp;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertNull;
@@ -11,7 +11,7 @@ import static org.mockito.Mockito.when;
 import com.fasterxml.jackson.databind.ObjectMapper;
 import io.modelcontextprotocol.server.McpSyncServer;
 import io.shinhanlife.dap.mcc.presentation.BusinessToolController;
-import io.shinhanlife.dap.mcc.usecase.ToolRegistryHeartbeatSender;
+import io.shinhanlife.dap.lib.usecase.ToolRegistryHeartbeatSender;
 import java.lang.reflect.Method;
 import java.util.Map;
 import org.junit.jupiter.api.Test;

dap-tool-core/src/test/java/io/shinhanlife/dap/mcc/mcp/ToolMcpServerConfigurationTest.java

@@ -1,4 +1,4 @@
-package io.shinhanlife.dap.mcc.mcp;
+package io.shinhanlife.dap.lib.mcp;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertFalse;

dap-tool-core/src/test/java/io/shinhanlife/dap/mcc/presentation/ToolArgumentSchemaValidatorTest.java

@@ -4,6 +4,7 @@ import static org.junit.jupiter.api.Assertions.assertFalse;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
 import com.fasterxml.jackson.databind.ObjectMapper;
+import io.shinhanlife.dap.lib.validation.ToolArgumentSchemaValidator;
 import java.util.List;
 import java.util.Map;
 import org.junit.jupiter.api.Test;