fenix-mcp 0.5.6__py3-none-any.whl → 0.5.8__py3-none-any.whl

fenix_mcp/__init__.py

@@ -8,4 +8,4 @@ Fênix Cloud MCP Server (Python edition).
 __all__ = ["__version__"]
 
 
-__version__ = "0.5.6"
+__version__ = "0.5.8"

fenix_mcp/application/tools/intelligence.py

@@ -155,10 +155,21 @@ class IntelligenceTool(Tool):
     async def _handle_smart_create(self, payload: IntelligenceRequest):
         if not payload.title or not payload.content:
             return text("❌ Informe título e conteúdo para criar uma memória.")
+
+        if not payload.metadata or not payload.metadata.strip():
+            return text("❌ Informe metadata para criar uma memória.")
+
+        if not payload.source or not payload.source.strip():
+            return text("❌ Informe source para criar uma memória.")
+
         try:
             normalized_tags = _ensure_tag_sequence(payload.tags)
         except ValueError as exc:
             return text(f"❌ {exc}")
+
+        if not normalized_tags or len(normalized_tags) == 0:
+            return text("❌ Informe tags para criar uma memória.")
+
         memory = await self._service.smart_create_memory(
             title=payload.title,
             content=payload.content,
@@ -271,6 +282,7 @@ class IntelligenceTool(Tool):
             payload.metadata,
             importance=payload.importance,
             tags=normalized_tags,
+            source=payload.source,
             existing=existing.get("metadata") if isinstance(existing, dict) else None,
         )
         update_fields: Dict[str, Any] = {
@@ -330,6 +342,17 @@ def _ensure_tag_sequence(raw: Optional[Any]) -> Optional[List[str]]:
         result = [str(item).strip() for item in raw if str(item).strip()]
         return result or None
     if isinstance(raw, str):
+        # Try to parse as JSON array first
+        try:
+            import json
+
+            parsed = json.loads(raw)
+            if isinstance(parsed, list):
+                result = [str(item).strip() for item in parsed if str(item).strip()]
+                return result or None
+        except (json.JSONDecodeError, TypeError):
+            pass
+
         raise ValueError(
             "O campo `tags` deve ser enviado como array JSON, por exemplo: "
             '["tag1", "tag2"].'

fenix_mcp/domain/intelligence.py

@@ -5,7 +5,7 @@ from __future__ import annotations
 
 import asyncio
 from dataclasses import dataclass
-from typing import Any, Dict, Iterable, List, Optional, Union
+from typing import Any, Dict, Iterable, List, Optional
 
 from fenix_mcp.infrastructure.fenix_api.client import FenixApiClient
 
@@ -20,18 +20,34 @@ class IntelligenceService:
         *,
         title: str,
         content: str,
-        metadata: Optional[str],
+        metadata: str,
         context: Optional[str],
-        source: Optional[str],
+        source: str,
         importance: str,
-        tags: Optional[Union[Iterable[str], str]] = None,
+        tags: List[str],
     ) -> Dict[str, Any]:
+        # Validate required parameters
+        if not metadata or not metadata.strip():
+            raise ValueError("metadata is required and cannot be empty")
+
+        if not source or not source.strip():
+            raise ValueError("source is required and cannot be empty")
+
+        if not tags or not isinstance(tags, list) or len(tags) == 0:
+            raise ValueError("tags is required and must be a non-empty List[str]")
+
+        # Validate all tags are strings
+        for i, tag in enumerate(tags):
+            if not isinstance(tag, str) or not tag.strip():
+                raise ValueError(
+                    f"All tags must be non-empty strings, got {type(tag)} at index {i}"
+                )
+
         importance_value = importance or "medium"
-        normalized_tags = normalize_tags(tags)
         metadata_str = build_metadata(
             metadata,
             importance=importance_value,
-            tags=normalized_tags,
+            tags=tags,
             context=context,
             source=source,
         )
@@ -40,7 +56,7 @@ class IntelligenceService:
             "content": content,
             "metadata": metadata_str,
             "priority_score": _importance_to_priority(importance_value),
-            "tags": normalized_tags,
+            "tags": tags,
         }
         return await self._call(self.api.smart_create_memory, _strip_none(payload))
 
@@ -197,12 +213,12 @@ def _strip_none(data: Dict[str, Any]) -> Dict[str, Any]:
 
 
 def build_metadata(
-    explicit: Optional[str],
+    explicit: str,
     *,
     importance: Optional[str],
-    tags: Optional[Union[Iterable[str], str]],
+    tags: List[str],
     context: Optional[str] = None,
-    source: Optional[str] = None,
+    source: str,
     existing: Optional[str] = None,
 ) -> str:
     if explicit and explicit.strip():
@@ -259,31 +275,37 @@ def _slugify(value: Optional[str]) -> str:
     return "-".join(part for part in sanitized.split() if part).lower()
 
 
-def _format_tags(tags: Optional[Union[Iterable[str], str]]) -> str:
-    if tags is None or tags == "":
-        return ""
-    if isinstance(tags, str):
-        iterable: Iterable[str] = [part.strip() for part in tags.split(",")]
-    else:
-        iterable = tags
-    normalized = {
-        _slugify(tag) for tag in iterable if isinstance(tag, str) and _slugify(tag)
-    }
-    if not normalized:
-        return ""
-    return ",".join(sorted(normalized))
-
-
-def normalize_tags(tags: Optional[Union[Iterable[str], str]]) -> Optional[List[str]]:
-    if tags is None or tags == "":
-        return None
-    if isinstance(tags, str):
-        parts = [part.strip() for part in tags.split(",") if part.strip()]
-    else:
-        parts = [str(part).strip() for part in tags if str(part).strip()]
-    if not parts:
-        return None
-    slugged = [_slugify(part) for part in parts if _slugify(part)]
-    if not slugged:
-        return None
-    return sorted(set(slugged))
+def _format_tags(tags: List[str]) -> str:
+    """
+    Format tags list into a comma-separated string for metadata.
+
+    Args:
+        tags: List of string tags (required)
+
+    Returns:
+        Comma-separated string of tags
+
+    Raises:
+        TypeError: If tags is not a List[str]
+        ValueError: If tags is empty
+    """
+    if not isinstance(tags, list):
+        raise TypeError(f"tags must be List[str], got {type(tags)}")
+
+    if not tags:
+        raise ValueError("tags cannot be empty")
+
+    # Clean and validate tags
+    cleaned_tags = []
+    for tag in tags:
+        if isinstance(tag, str) and tag.strip():
+            cleaned_tags.append(tag.strip())
+        else:
+            raise ValueError(
+                f"All tags must be non-empty strings, got {type(tag)}: {tag}"
+            )
+
+    if not cleaned_tags:
+        raise ValueError("No valid tags found after cleaning")
+
+    return ",".join(sorted(set(cleaned_tags)))

{fenix_mcp-0.5.6.dist-info → fenix_mcp-0.5.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fenix-mcp
-Version: 0.5.6
+Version: 0.5.8
 Summary: Fênix Cloud MCP server implemented in Python
 Author: Fenix Inc
 Requires-Python: >=3.10

{fenix_mcp-0.5.6.dist-info → fenix_mcp-0.5.8.dist-info}/RECORD

@@ -1,4 +1,4 @@
-fenix_mcp/__init__.py,sha256=LV_5ywWiAnodLDI7k4GMy1VEsHv9aaa6jyvhAjBS4_g,180
+fenix_mcp/__init__.py,sha256=M1F9ZYuoc3sexAMDAfEhKTIlIzuf38ZtbSzPeq48pPw,180
 fenix_mcp/main.py,sha256=iJV-9btNMDJMObvcn7wBQdbLLKjkYCQ1ANGEwHGHlMU,2857
 fenix_mcp/application/presenters.py,sha256=fGME54PdCDhTBhXO-JUB9yLdBHiE1aeXLTC2fCuxnxM,689
 fenix_mcp/application/tool_base.py,sha256=qUcb46qx9gHQfrSHgj4RD4NCHW-OIvKQdR5G9uxZ5l4,1316
@@ -6,12 +6,12 @@ fenix_mcp/application/tool_registry.py,sha256=bPT5g8GfxG_qu28R1WaDOZHvtmG6TPDvZi
 fenix_mcp/application/tools/__init__.py,sha256=Gi1YvYh-KdL9HD8gLVrknHrxiKKEOhHBEZ02KBXJaKQ,796
 fenix_mcp/application/tools/health.py,sha256=m5DxhoRbdwl6INzd6PISxv1NAv-ljCrezsr773VB0wE,834
 fenix_mcp/application/tools/initialize.py,sha256=f33DNDn9u8IYwpqiBj6bjJ-wHgaUP1zEuAvUM1rMYPc,4674
-fenix_mcp/application/tools/intelligence.py,sha256=5qdCZbEK1IuKjhS5eDqgny0_zyT9lpYeZly-hM6ilxs,14165
+fenix_mcp/application/tools/intelligence.py,sha256=WwJqWDkkdsh1oCub_WxAoCkPU0A2QyMaymVoWSKHbrY,14955
 fenix_mcp/application/tools/knowledge.py,sha256=4ClGoFRqyFIPuzzg2DAg-w2eMvTP37mH0THXDGftinw,44634
 fenix_mcp/application/tools/productivity.py,sha256=2IMkNdZ-Kd1CFAO7geruAVjtf_BWoDdbnwkl76vhtC8,9973
 fenix_mcp/application/tools/user_config.py,sha256=8mPOZuwszO0TapxgrA7Foe15VQE874_mvfQYlGzyv4Y,6230
 fenix_mcp/domain/initialization.py,sha256=AZhdSNITQ7O3clELBuqGvjJc-c8pFKc7zQz-XR2xXPc,6933
-fenix_mcp/domain/intelligence.py,sha256=IyZUA_fbCHDgHaWCgxkahXAaAT5qQlaz5AT7Cw2Gwko,9006
+fenix_mcp/domain/intelligence.py,sha256=2V70uZygyMcukHS4hVinkB-20VokGOw1gQR7jziX9-M,9515
 fenix_mcp/domain/knowledge.py,sha256=fKQOTt20u5aa5Yo7gPeQ1Qxa_K5pBxn1yn8FEfOFltM,20241
 fenix_mcp/domain/productivity.py,sha256=nmHRuVJGRRu1s4eMoAv8vXHKsSauCPl-FvFx3I_yCTE,6661
 fenix_mcp/domain/user_config.py,sha256=LzBDCk31gLMtKHTbBmYb9VoFPHDW6OydpmDXeHHd0Mw,1642
@@ -22,8 +22,8 @@ fenix_mcp/infrastructure/logging.py,sha256=bHrWlSi_0HshRe3--BK_5nzUszW-gh37q6jsd
 fenix_mcp/infrastructure/fenix_api/client.py,sha256=Navi7cGAOradghcbYkFIQQINpjFrdINlNhdfZ4iSSYQ,28338
 fenix_mcp/interface/mcp_server.py,sha256=5UM2NJuNbwHkmCEprIFataJ5nFZiO8efTtP_oW3_iX0,2331
 fenix_mcp/interface/transports.py,sha256=PxdhfjH8UMl03f7nuCLc-M6tMx6-Y-btVz_mSqXKrSI,8138
-fenix_mcp-0.5.6.dist-info/METADATA,sha256=uORCg1OqP0TIm_d39HHxxpatgW5JFL6yHt1yUspe9bI,7260
-fenix_mcp-0.5.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-fenix_mcp-0.5.6.dist-info/entry_points.txt,sha256=o52x_YHBupEd-1Z1GSfUjv3gJrx5_I-EkHhCgt1WBaE,49
-fenix_mcp-0.5.6.dist-info/top_level.txt,sha256=2G1UtKpwjaIGQyE7sRoHecxaGLeuexfjrOUjv9DDKh4,10
-fenix_mcp-0.5.6.dist-info/RECORD,,
+fenix_mcp-0.5.8.dist-info/METADATA,sha256=0j10_pcGqJTS4YeWVgso-tcOrQ0wU_lwldkHtuJT2wA,7260
+fenix_mcp-0.5.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+fenix_mcp-0.5.8.dist-info/entry_points.txt,sha256=o52x_YHBupEd-1Z1GSfUjv3gJrx5_I-EkHhCgt1WBaE,49
+fenix_mcp-0.5.8.dist-info/top_level.txt,sha256=2G1UtKpwjaIGQyE7sRoHecxaGLeuexfjrOUjv9DDKh4,10
+fenix_mcp-0.5.8.dist-info/RECORD,,