feat(tools): add compatibility fingerprints and bounded contact masking

CHANGELOG.md

@@ -1,4 +1,5 @@
 ## [Unreleased]
+- 새로운 분석 및 유틸리티 도구 3종(`hash_generator`, `url_extractor`, `pii_anonymizer`)을 추가하여 텍스트의 해시값을 생성하고, 본문 내 URL을 추출하며, 이메일 주소 및 전화번호 등의 개인정보를 비식별화할 수 있도록 지원합니다. 모든 도구는 입력 텍스트 길이 제한을 엄격히 준수합니다.
 - 긴 이메일·첨부 본문을 의미 단위 청크로 임베딩한 뒤 기존 email/attachment 벡터 계약으로 평균화하고, 청크 요청·벡터 누적을 제한된 창으로 처리합니다. OpenAI `text-embedding-3-*`에는 저장 차원(`1536`)을 직접 요청하도록 보강했습니다. 합성 메일 fixture 5건(70청크)과 provider 요청 계약으로 1,536차원 벡터 경로를 검증했으며, 실행 시 선택한 임베딩 제공자에 본문·파싱된 첨부 텍스트를 전송할 수 있습니다. 회사 기밀 데이터는 fixture·commit·PR·log에 포함하지 않습니다.
 - EmailDetail 테스트가 지원하지 않는 스레드 병합/분리 버튼을 `textContent`뿐 아니라 `aria-label`과 `title` 접근 가능 이름으로도 검출하도록 바꿔, 아이콘 전용 버튼 회귀를 놓치지 않습니다.
 

backend/api/tools.py

@@ -753,6 +753,83 @@
 )
 
 
+
+async def hash_generator_handler(params: Dict[str, Any]) -> Dict[str, str]:
+    text = params["text"]
+    if len(text) > ANALYSIS_TEXT_MAX_CHARS:
+        raise ValueError(f"Analysis text must not exceed {ANALYSIS_TEXT_MAX_CHARS} characters")
+
+    encoded = text.encode("utf-8")
+    return {
+        "md5": hashlib.md5(encoded).hexdigest(),
+        "sha1": hashlib.sha1(encoded).hexdigest(),
+        "sha256": hashlib.sha256(encoded).hexdigest(),
+    }
+
+registry.register(
+    ToolInfo(
+        code="hash_generator",
+        name="해시 생성기 (Hash Generator)",
+        description="텍스트의 MD5, SHA-1, SHA-256 해시값을 생성합니다.",
+        category="유틸리티",
+        parameters={"text": "string"},
+    ),
+    hash_generator_handler,
+)
+
+
+_URL_PATTERN = re.compile(r"https?://[^\s<>\"\',]+")
+
+async def url_extractor_handler(params: Dict[str, Any]) -> Dict[str, Any]:
+    text = params["text"]
+    if len(text) > ANALYSIS_TEXT_MAX_CHARS:
+        raise ValueError(f"Analysis text must not exceed {ANALYSIS_TEXT_MAX_CHARS} characters")
+
+    urls = _URL_PATTERN.findall(text)
+    unique_urls = []
+    for url in urls:
+        if url not in unique_urls:
+            unique_urls.append(url)
+
+    return {"urls": unique_urls, "count": len(unique_urls)}
+
+registry.register(
+    ToolInfo(
+        code="url_extractor",
+        name="URL 추출기 (URL Extractor)",
+        description="텍스트 본문에서 URL을 추출합니다.",
+        category="이메일 분석",
+        parameters={"text": "string"},
+    ),
+    url_extractor_handler,
+)
+
+
+_EMAIL_PATTERN = re.compile(r"[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}")
+_PHONE_PATTERN = re.compile(r"\b\d{2,3}-\d{3,4}-\d{4}\b|\b\d{3}-\d{4}-\d{4}\b")
+
+async def pii_anonymizer_handler(params: Dict[str, Any]) -> Dict[str, str]:
+    text = params["text"]
+    if len(text) > ANALYSIS_TEXT_MAX_CHARS:
+        raise ValueError(f"Analysis text must not exceed {ANALYSIS_TEXT_MAX_CHARS} characters")
+
+    anonymized = _EMAIL_PATTERN.sub("[EMAIL]", text)
+    anonymized = _PHONE_PATTERN.sub("[PHONE]", anonymized)
+
+    return {"anonymized_text": anonymized}
+
+registry.register(
+    ToolInfo(
+        code="pii_anonymizer",
+        name="개인정보 비식별화 (PII Anonymizer)",
+        description="텍스트에서 이메일 주소, 전화번호 등 개인정보를 마스킹 처리합니다.",
+        category="보안",
+        parameters={"text": "string"},
+    ),
+    pii_anonymizer_handler,
+)
+
+
 async def uuid_v4_generator_handler(params: Dict[str, Any]) -> Dict[str, str]:
     return {"uuid": str(uuid.uuid4())}
 

backend/pyproject.toml

@@ -38,6 +38,7 @@ dependencies = [
   "PyJWT==2.13.0",
   "icalendar==7.2.0",
   "defusedxml==0.7.1",
+  "pytest-cov>=7.1.0",
 ]
 
 [dependency-groups]

backend/tests/test_tools_api.py

@@ -1211,3 +1211,39 @@ def test_execute_analysis_tool_rejects_oversized_text():
             f"Analysis text must not exceed {ANALYSIS_TEXT_MAX_CHARS} characters"
         ),
     }
+
+
+
+@pytest.mark.asyncio
+async def test_hash_generator_handler():
+    from api.tools import hash_generator_handler, ANALYSIS_TEXT_MAX_CHARS
+
+    res = await hash_generator_handler({"text": "hello"})
+    assert res["md5"] == "5d41402abc4b2a76b9719d911017c592"
+    assert res["sha1"] == "aaf4c61ddcc5e8a2dabede0f3b482cd9aea9434d"
+    assert res["sha256"] == "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824"
+
+    with pytest.raises(ValueError, match="Analysis text must not exceed"):
+        await hash_generator_handler({"text": "x" * (ANALYSIS_TEXT_MAX_CHARS + 1)})
+
+@pytest.mark.asyncio
+async def test_url_extractor_handler():
+    from api.tools import url_extractor_handler, ANALYSIS_TEXT_MAX_CHARS
+
+    res = await url_extractor_handler({"text": "Check https://example.com and http://test.com, https://example.com"})
+    assert res["count"] == 2
+    assert "https://example.com" in res["urls"]
+    assert "http://test.com" in res["urls"]
+
+    with pytest.raises(ValueError, match="Analysis text must not exceed"):
+        await url_extractor_handler({"text": "x" * (ANALYSIS_TEXT_MAX_CHARS + 1)})
+
+@pytest.mark.asyncio
+async def test_pii_anonymizer_handler():
+    from api.tools import pii_anonymizer_handler, ANALYSIS_TEXT_MAX_CHARS
+
+    res = await pii_anonymizer_handler({"text": "Contact me at user@example.com or 010-1234-5678."})
+    assert res["anonymized_text"] == "Contact me at [EMAIL] or [PHONE]."
+
+    with pytest.raises(ValueError, match="Analysis text must not exceed"):
+        await pii_anonymizer_handler({"text": "x" * (ANALYSIS_TEXT_MAX_CHARS + 1)})