fenix-mcp 0.6.0__tar.gz → 0.7.0__tar.gz

{fenix_mcp-0.6.0 → fenix_mcp-0.7.0}/PKG-INFO

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

{fenix_mcp-0.6.0 → fenix_mcp-0.7.0}/fenix_mcp/__init__.py

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

{fenix_mcp-0.6.0 → fenix_mcp-0.7.0}/fenix_mcp/application/tool_base.py

@@ -4,12 +4,31 @@
 from __future__ import annotations
 
 from abc import ABC, abstractmethod
-from typing import Annotated, Any, Dict, Type
+from typing import Annotated, Any, Dict, List, Optional, Type, TypeVar
 
 from pydantic import BaseModel, ConfigDict, Field, StringConstraints
 
 from fenix_mcp.infrastructure.context import AppContext
 
+T = TypeVar("T")
+
+
+def sanitize_null(value: Optional[T]) -> Optional[T]:
+    """Convert string 'null' to None. Handles AI agents passing 'null' as string."""
+    if value == "null" or value == "None" or value == "":
+        return None
+    return value
+
+
+def sanitize_null_list(value: Optional[List[T]]) -> Optional[List[T]]:
+    """Sanitize list values, converting 'null' string to None."""
+    if value == "null" or value == "None" or value == "":  # type: ignore
+        return None
+    if isinstance(value, list):
+        return [v for v in value if v != "null" and v != "None" and v != ""]
+    return value
+
+
 # =============================================================================
 # Type aliases for common field types - generates proper JSON schema
 # =============================================================================

{fenix_mcp-0.6.0 → fenix_mcp-0.7.0}/fenix_mcp/application/tools/initialize.py

@@ -3,8 +3,8 @@
 
 from __future__ import annotations
 
-from enum import Enum
 import json
+from enum import Enum
 from typing import List, Optional
 
 from pydantic import Field
@@ -93,7 +93,28 @@ class InitializeTool(Tool):
         if data.recent_memories:
             payload_dict["recent_memories"] = data.recent_memories
 
-        message_lines = [
+        # Extract key IDs for easy reference
+        profile = data.profile or {}
+        user_info = profile.get("user") or {}
+        tenant_info = profile.get("tenant") or {}
+        team_info = profile.get("team") or {}
+
+        context_lines = ["📋 **Contexto do Usuário**"]
+        if user_info.get("id"):
+            context_lines.append(f"- **user_id**: `{user_info['id']}`")
+        if user_info.get("name"):
+            context_lines.append(f"- **user_name**: {user_info['name']}")
+        if tenant_info.get("id"):
+            context_lines.append(f"- **tenant_id**: `{tenant_info['id']}`")
+        if tenant_info.get("name"):
+            context_lines.append(f"- **tenant_name**: {tenant_info['name']}")
+        if team_info.get("id"):
+            context_lines.append(f"- **team_id**: `{team_info['id']}`")
+        if team_info.get("name"):
+            context_lines.append(f"- **team_name**: {team_info['name']}")
+
+        message_lines = context_lines + [
+            "",
             "📦 **Dados de inicialização completos**",
             "```json",
             json.dumps(payload_dict, ensure_ascii=False, indent=2),

{fenix_mcp-0.6.0 → fenix_mcp-0.7.0}/fenix_mcp/application/tools/knowledge.py

@@ -22,6 +22,8 @@ from fenix_mcp.application.tool_base import (
     ToolRequest,
     UUIDStr,
     VersionStr,
+    sanitize_null,
+    sanitize_null_list,
 )
 from fenix_mcp.domain.knowledge import KnowledgeService, _format_date
 from fenix_mcp.infrastructure.context import AppContext
@@ -420,20 +422,23 @@ class KnowledgeTool(Tool):
             return text(f"🗑️ Work item {payload.id} removido.")
 
         if action is KnowledgeAction.WORK_BACKLOG:
-            if not payload.team_id:
+            team_id = sanitize_null(payload.team_id)
+            if not team_id:
                 return text("❌ Informe team_id para consultar o backlog.")
-            items = await self._service.work_backlog(team_id=payload.team_id)
+            items = await self._service.work_backlog(team_id=team_id)
             if not items:
                 return text("📋 Backlog vazio para o time informado.")
             body = "\n\n".join(_format_work(item) for item in items)
             return text(f"📋 **Backlog ({len(items)}):**\n\n{body}")
 
         if action is KnowledgeAction.WORK_SEARCH:
-            if not payload.query or not payload.team_id:
+            query = sanitize_null(payload.query)
+            team_id = sanitize_null(payload.team_id)
+            if not query or not team_id:
                 return text("❌ Informe query e team_id para buscar work items.")
             items = await self._service.work_search(
-                query=payload.query,
-                team_id=payload.team_id,
+                query=query,
+                team_id=team_id,
                 limit=payload.limit,
             )
             if not items:
@@ -442,9 +447,10 @@ class KnowledgeTool(Tool):
             return text(f"🔍 **Resultados ({len(items)}):**\n\n{body}")
 
         if action is KnowledgeAction.WORK_ANALYTICS:
-            if not payload.team_id:
+            team_id = sanitize_null(payload.team_id)
+            if not team_id:
                 return text("❌ Informe team_id para obter analytics.")
-            analytics = await self._service.work_analytics(team_id=payload.team_id)
+            analytics = await self._service.work_analytics(team_id=team_id)
             lines = ["📊 **Analytics de Work Items**"]
             for key, value in analytics.items():
                 lines.append(f"- {key}: {value}")
@@ -826,20 +832,20 @@ class KnowledgeTool(Tool):
             doc = await self._service.doc_create(
                 {
                     "title": payload.doc_title,
-                    "description": payload.doc_description,
-                    "content": payload.doc_content,
-                    "status": payload.doc_status,
-                    "doc_type": payload.doc_type,
-                    "language": payload.doc_language,
-                    "parent_id": payload.doc_parent_id,
-                    "team_id": payload.doc_team_id or payload.team_id,
-                    "owner_user_id": payload.doc_owner_id,
-                    "reviewer_user_id": payload.doc_reviewer_id,
-                    "version": payload.doc_version,
-                    "category": payload.doc_category,
-                    "tags": payload.doc_tags,
-                    "emoji": payload.doc_emoji or payload.doc_emote,
-                    "keywords": payload.doc_keywords,
+                    "description": sanitize_null(payload.doc_description),
+                    "content": sanitize_null(payload.doc_content),
+                    "status": sanitize_null(payload.doc_status),
+                    "doc_type": sanitize_null(payload.doc_type),
+                    "language": sanitize_null(payload.doc_language),
+                    "parent_id": sanitize_null(payload.doc_parent_id),
+                    "team_id": sanitize_null(payload.doc_team_id or payload.team_id),
+                    "owner_user_id": sanitize_null(payload.doc_owner_id),
+                    "reviewer_user_id": sanitize_null(payload.doc_reviewer_id),
+                    "version": sanitize_null(payload.doc_version),
+                    "category": sanitize_null(payload.doc_category),
+                    "tags": sanitize_null_list(payload.doc_tags),
+                    "emoji": sanitize_null(payload.doc_emoji or payload.doc_emote),
+                    "keywords": sanitize_null_list(payload.doc_keywords),
                     "is_public": payload.doc_is_public,
                 }
             )
@@ -876,21 +882,21 @@ class KnowledgeTool(Tool):
             doc = await self._service.doc_update(
                 payload.id,
                 {
-                    "title": payload.doc_title,
-                    "description": payload.doc_description,
-                    "content": payload.doc_content,
-                    "status": payload.doc_status,
-                    "doc_type": payload.doc_type,
-                    "language": payload.doc_language,
-                    "parent_id": payload.doc_parent_id,
-                    "team_id": payload.doc_team_id or payload.team_id,
-                    "owner_user_id": payload.doc_owner_id,
-                    "reviewer_user_id": payload.doc_reviewer_id,
-                    "version": payload.doc_version,
-                    "category": payload.doc_category,
-                    "tags": payload.doc_tags,
-                    "emoji": payload.doc_emoji or payload.doc_emote,
-                    "keywords": payload.doc_keywords,
+                    "title": sanitize_null(payload.doc_title),
+                    "description": sanitize_null(payload.doc_description),
+                    "content": sanitize_null(payload.doc_content),
+                    "status": sanitize_null(payload.doc_status),
+                    "doc_type": sanitize_null(payload.doc_type),
+                    "language": sanitize_null(payload.doc_language),
+                    "parent_id": sanitize_null(payload.doc_parent_id),
+                    "team_id": sanitize_null(payload.doc_team_id or payload.team_id),
+                    "owner_user_id": sanitize_null(payload.doc_owner_id),
+                    "reviewer_user_id": sanitize_null(payload.doc_reviewer_id),
+                    "version": sanitize_null(payload.doc_version),
+                    "category": sanitize_null(payload.doc_category),
+                    "tags": sanitize_null_list(payload.doc_tags),
+                    "emoji": sanitize_null(payload.doc_emoji or payload.doc_emote),
+                    "keywords": sanitize_null_list(payload.doc_keywords),
                     "is_public": payload.doc_is_public,
                 },
             )
@@ -903,11 +909,13 @@ class KnowledgeTool(Tool):
             return text(f"🗑️ Documentação {payload.id} removida.")
 
         if action is KnowledgeAction.DOC_SEARCH:
-            if not payload.query or not (payload.doc_team_id or payload.team_id):
+            query = sanitize_null(payload.query)
+            team_id = sanitize_null(payload.doc_team_id or payload.team_id)
+            if not query or not team_id:
                 return text("❌ Informe query e team_id para buscar documentação.")
             docs = await self._service.doc_search(
-                query=payload.query,
-                team_id=payload.doc_team_id or payload.team_id,
+                query=query,
+                team_id=team_id,
                 limit=payload.limit,
             )
             if not docs:
@@ -918,11 +926,10 @@ class KnowledgeTool(Tool):
             return text(f"🔍 **Resultados ({len(docs)}):**\n\n{body}")
 
         if action is KnowledgeAction.DOC_ROOTS:
-            if not (payload.doc_team_id or payload.team_id):
+            team_id = sanitize_null(payload.doc_team_id or payload.team_id)
+            if not team_id:
                 return text("❌ Informe team_id para listar raízes.")
-            docs = await self._service.doc_roots(
-                team_id=payload.doc_team_id or payload.team_id
-            )
+            docs = await self._service.doc_roots(team_id=team_id)
             if not docs:
                 return text("📚 Nenhuma raiz encontrada.")
             body = "\n".join(
@@ -932,10 +939,11 @@ class KnowledgeTool(Tool):
             return text(f"📚 **Raízes de documentação:**\n{body}")
 
         if action is KnowledgeAction.DOC_RECENT:
-            if not (payload.doc_team_id or payload.team_id):
+            team_id = sanitize_null(payload.doc_team_id or payload.team_id)
+            if not team_id:
                 return text("❌ Informe team_id para listar documentos recentes.")
             docs = await self._service.doc_recent(
-                team_id=payload.doc_team_id or payload.team_id,
+                team_id=team_id,
                 limit=payload.limit,
             )
             if not docs:
@@ -944,11 +952,10 @@ class KnowledgeTool(Tool):
             return text(f"🕒 **Documentos recentes ({len(docs)}):**\n\n{body}")
 
         if action is KnowledgeAction.DOC_ANALYTICS:
-            if not (payload.doc_team_id or payload.team_id):
+            team_id = sanitize_null(payload.doc_team_id or payload.team_id)
+            if not team_id:
                 return text("❌ Informe team_id para obter analytics.")
-            analytics = await self._service.doc_analytics(
-                team_id=payload.doc_team_id or payload.team_id
-            )
+            analytics = await self._service.doc_analytics(team_id=team_id)
             lines = ["📊 **Analytics de Documentação**"]
             for key, value in analytics.items():
                 lines.append(f"- {key}: {value}")

{fenix_mcp-0.6.0 → fenix_mcp-0.7.0}/fenix_mcp.egg-info/PKG-INFO

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