mailflat 0.3.1__tar.gz → 0.3.3__tar.gz

{mailflat-0.3.1 → mailflat-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mailflat
-Version: 0.3.1
+Version: 0.3.3
 Summary: Official Python SDK for MailFlat — disposable, automation-friendly email inboxes with one-line OTP retrieval.
 Project-URL: Homepage, https://mailflat.net
 Project-URL: Documentation, https://mailflat.net

{mailflat-0.3.1 → mailflat-0.3.3}/pyproject.toml

@@ -4,7 +4,10 @@ build-backend = "hatchling.build"
 
 [project]
 name = "mailflat"
-version = "0.3.1"
+# Sürüm TEK KAYNAKTAN okunur: src/mailflat/__init__.py::__version__ (bkz. [tool.hatch.version]).
+# Buraya elle bir `version = ...` yazmak B-052'yi geri getirir: 0.3.1 yayımlanmışken paketin
+# kendisi `mailflat.__version__ == "0.3.0"` diyordu. İki kaynak = eninde sonunda ayrışma.
+dynamic = ["version"]
 description = "Official Python SDK for MailFlat — disposable, automation-friendly email inboxes with one-line OTP retrieval."
 readme = "README.md"
 requires-python = ">=3.8"
@@ -37,6 +40,9 @@ Source = "https://github.com/onderyentar/mailflat"
 langchain = ["langchain-core>=0.2"]
 dev = ["pytest>=7", "respx>=0.20", "langchain-core>=0.2"]
 
+[tool.hatch.version]
+path = "src/mailflat/__init__.py"
+
 [tool.hatch.build.targets.wheel]
 packages = ["src/mailflat"]
 

{mailflat-0.3.1 → mailflat-0.3.3}/src/mailflat/__init__.py

@@ -11,6 +11,7 @@ Key exports:
   - `Inbox`, `Message` — domain tipleri
   - hata tipleri: `MailFlatError`, `AuthenticationError`, `PermissionError`,
     `NotFoundError`, `RateLimitError`, `APIError`, `OTPTimeoutError`, `EncryptedInboxError`
+  - `redact_secrets()` — ajan araç çıktısından sır alanlarını atar (MCP/LangChain kullanır)
 """
 from __future__ import annotations
 
@@ -26,8 +27,11 @@ from .errors import (
     RateLimitError,
 )
 from .inbox import Inbox, Message
+from .redact import redact_secrets
 
-__version__ = "0.3.0"
+# Paketin TEK sürüm kaynağı — pyproject.toml bunu [tool.hatch.version] ile okur.
+# Yayın = burayı yükselt, başka hiçbir yeri değil.
+__version__ = "0.3.3"
 
 __all__ = [
     "MailFlat",
@@ -41,5 +45,6 @@ __all__ = [
     "APIError",
     "OTPTimeoutError",
     "EncryptedInboxError",
+    "redact_secrets",
     "__version__",
 ]

{mailflat-0.3.1 → mailflat-0.3.3}/src/mailflat/langchain.py

@@ -9,8 +9,11 @@ Kullanım:
     tools = toolkit.get_tools()   # create_inbox, list_inboxes, read_messages,
                                   # wait_for_otp, send_email, delete_inbox
 
+⚠️ Araç çıktıları `redact_secrets()`'ten geçer: per-inbox `api_key` modelin bağlamına
+(ve oradan LangSmith trace'lerine) girmemeli — bkz. B-055.
+
 Connected to:
-  - imports from: mailflat.client (MailFlat), langchain_core.tools (StructuredTool)
+  - imports from: mailflat.client (MailFlat), mailflat.redact, langchain_core.tools
   - imported by:  kullanıcı kodu (LangChain ajanları)
 
 Key exports:
@@ -30,6 +33,7 @@ except ImportError as exc:  # langchain-core kurulu değil → açıklayıcı ha
 
 from .client import DEFAULT_BASE_URL, MailFlat
 from .errors import EncryptedInboxError, MailFlatError, OTPTimeoutError
+from .redact import redact_secrets
 
 if TYPE_CHECKING:
     from collections.abc import Sequence
@@ -73,14 +77,14 @@ class MailFlatToolkit:
                     label=label or None,
                     retention_hours=retention_hours if retention_hours and retention_hours > 0 else None,
                 )
-                return inbox.raw
+                return redact_secrets(inbox.raw)
             except MailFlatError as e:
                 return {"error": str(e)}
 
         def list_inboxes() -> dict:
             """List all inboxes available to this API key."""
             try:
-                return {"ok": True, "inboxes": [i.raw for i in client.list()]}
+                return redact_secrets({"ok": True, "inboxes": [i.raw for i in client.list()]})
             except MailFlatError as e:
                 return {"error": str(e)}
 
@@ -91,7 +95,7 @@ class MailFlatToolkit:
                 address: The full inbox address, e.g. signup-8f3@mailflat.net.
             """
             try:
-                return {"ok": True, "emails": [m.raw for m in client.inbox(address).messages()]}
+                return redact_secrets({"ok": True, "emails": [m.raw for m in client.inbox(address).messages()]})
             except MailFlatError as e:
                 return {"error": str(e)}
 
@@ -106,7 +110,7 @@ class MailFlatToolkit:
                 inbox = client.inbox(address)
                 otp = inbox.wait_for_otp(timeout=timeout)
                 latest = inbox.latest()
-                return {"otp_code": otp, "email": latest.raw if latest else None}
+                return redact_secrets({"otp_code": otp, "email": latest.raw if latest else None})
             except OTPTimeoutError:
                 return {"otp_code": None, "error": "timeout"}
             except EncryptedInboxError as e:
@@ -127,7 +131,7 @@ class MailFlatToolkit:
                 html: Optional HTML body.
             """
             try:
-                return client.inbox(address).send(to, subject=subject, body=body, html=html or None)
+                return redact_secrets(client.inbox(address).send(to, subject=subject, body=body, html=html or None))
             except MailFlatError as e:
                 return {"error": str(e)}
 
@@ -138,7 +142,7 @@ class MailFlatToolkit:
                 address: The inbox address to delete.
             """
             try:
-                return client.inbox(address).delete()
+                return redact_secrets(client.inbox(address).delete())
             except MailFlatError as e:
                 return {"error": str(e)}
 

mailflat-0.3.3/src/mailflat/redact.py

@@ -0,0 +1,56 @@
+"""Ajan araçlarının çıktısından sır alanlarını temizler (B-055).
+
+Neden var: `create_inbox` ve `list_inboxes` backend yanıtını olduğu gibi döndürüyordu ve o
+yanıtta per-inbox `api_key` (`mf_sk_…`) vardı. Araç çıktısı **model bağlamına** giriyor;
+oradan prompt loglarına, trace araçlarına (LangSmith, AI SDK telemetry), hata raporlarına ve
+modelin sonraki cevaplarına geçiyor. `list_inboxes` tek çağrıda hesabın **tüm** inbox
+anahtarlarını döküyordu.
+
+Ayrım bilinçli:
+  - **SDK = kod yüzeyi.** `Inbox.api_key` duruyor; insanın yazdığı kod onu kullanabilir.
+  - **Tool = model yüzeyi.** Buradan geçen her şey redakte edilir.
+
+Yöntem **isim bazlı**, değer bazlı değil: mesaj gövdesini tarayıp `mf_` ile başlayan
+string'leri silmek, kullanıcının kendi test anahtarını konu ettiği bir maili bozardı. Alan
+adına bakmak hem kesin hem zararsız.
+
+Connected to:
+  - imports from: —
+  - imported by:  mailflat_mcp.server, mailflat.langchain, testler
+
+Key exports:
+  - `redact_secrets(value)` — dict/list içindeki sır alanlarını atmış kopya
+  - `SECRET_NAME_PARTS` — hangi alan adlarının sır sayıldığı
+"""
+from __future__ import annotations
+
+from typing import Any
+
+#: Normalize edilmiş alan adı bunlardan birini İÇERİYORSA alan atılır.
+#: Dar tutuldu: `token` bilerek YOK — domain `verify_token` gibi alanlar zararsız ve
+#: gerektiğinde işe yarar, `otp` ise ajanın asıl istediği şey. Buradaki üçünün hiçbiri
+#: modele bir fayda sağlamıyor.
+SECRET_NAME_PARTS = ("apikey", "secret", "password")
+
+
+def _normalise(key: Any) -> str:
+    return str(key).replace("_", "").replace("-", "").lower()
+
+
+def _is_secret(key: Any) -> bool:
+    name = _normalise(key)
+    return any(part in name for part in SECRET_NAME_PARTS)
+
+
+def redact_secrets(value: Any) -> Any:
+    """`value`'nun sır alanları çıkarılmış kopyasını döndür (girdi değiştirilmez).
+
+    dict → sır alanları atılır, kalanlar özyinelemeli temizlenir
+    list/tuple → her eleman temizlenir (liste olarak döner, JSON'a zaten liste gidiyor)
+    diğer → olduğu gibi
+    """
+    if isinstance(value, dict):
+        return {k: redact_secrets(v) for k, v in value.items() if not _is_secret(k)}
+    if isinstance(value, (list, tuple)):
+        return [redact_secrets(v) for v in value]
+    return value