fenix-mcp 0.7.0__py3-none-any.whl → 1.1.0__py3-none-any.whl

fenix_mcp/__init__.py

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

fenix_mcp/application/tools/initialize.py

@@ -21,34 +21,29 @@ class InitializeAction(str, Enum):
 
 
 class InitializeRequest(ToolRequest):
-    action: InitializeAction = Field(
-        description="Operação de inicialização a executar."
-    )
+    action: InitializeAction = Field(description="Initialization operation to execute.")
     include_user_docs: bool = Field(
         default=True,
         description=(
-            "Inclui documentos pessoais durante a inicialização "
-            "(apenas para ação init)."
+            "Include personal documents during initialization (only for init action)."
         ),
     )
     limit: int = Field(
         default=50,
         ge=1,
         le=200,
-        description=("Quantidade máxima de documentos principais/pessoais carregados."),
+        description=("Maximum number of core/personal documents to load."),
     )
     answers: Optional[List[str]] = Field(
         default=None,
-        description=(
-            "Lista com 9 respostas textuais para processar o setup personalizado."
-        ),
+        description=("List of 9 text answers to process the personalized setup."),
     )
 
 
 class InitializeTool(Tool):
     name = "initialize"
     description = (
-        "Inicializa o ambiente do Fênix Cloud ou processa o setup personalizado."
+        "Initializes the Fenix Cloud environment or processes the personalized setup."
     )
     request_model = InitializeRequest
 
@@ -61,7 +56,7 @@ class InitializeTool(Tool):
             return await self._handle_init(payload)
         if payload.action is InitializeAction.SETUP:
             return await self._handle_setup(payload)
-        return text("❌ Ação de inicialização desconhecida.")
+        return text("❌ Unknown initialization action.")
 
     async def _handle_init(self, payload: InitializeRequest):
         try:
@@ -72,8 +67,8 @@ class InitializeTool(Tool):
         except Exception as exc:  # pragma: no cover - defensive
             self._context.logger.error("Initialize failed: %s", exc)
             return text(
-                "❌ Falha ao carregar dados de inicialização. "
-                "Verifique se o token tem acesso à API."
+                "❌ Failed to load initialization data. "
+                "Verify that the token has API access."
             )
 
         if (
@@ -82,7 +77,7 @@ class InitializeTool(Tool):
             and not data.profile
         ):
             return text(
-                "⚠️ Não consegui carregar documentos nem perfil. Confirme o token e, se for o primeiro acesso, use `initialize action=setup` para responder ao questionário inicial."
+                "⚠️ Could not load documents or profile. Confirm the token and, if this is your first access, use `initialize action=setup` to answer the initial questionnaire."
             )
 
         payload_dict = {
@@ -99,7 +94,7 @@ class InitializeTool(Tool):
         tenant_info = profile.get("tenant") or {}
         team_info = profile.get("team") or {}
 
-        context_lines = ["📋 **Contexto do Usuário**"]
+        context_lines = ["📋 **User Context**"]
         if user_info.get("id"):
             context_lines.append(f"- **user_id**: `{user_info['id']}`")
         if user_info.get("name"):
@@ -115,7 +110,7 @@ class InitializeTool(Tool):
 
         message_lines = context_lines + [
             "",
-            "📦 **Dados de inicialização completos**",
+            "📦 **Complete initialization data**",
             "```json",
             json.dumps(payload_dict, ensure_ascii=False, indent=2),
             "```",
@@ -138,11 +133,11 @@ class InitializeTool(Tool):
             return text(f"❌ {validation_error}")
 
         summary_lines = [
-            "📝 **Setup personalizado recebido!**",
+            "📝 **Personalized setup received!**",
             "",
-            "Suas respostas foram registradas. Vou sugerir documentos, regras e rotinas com base nessas informações.",
+            "Your answers have been registered. I will suggest documents, rules and routines based on this information.",
             "",
-            "Resumo das respostas:",
+            "Answer summary:",
         ]
         for idx, answer in enumerate(answers, start=1):
             summary_lines.append(f"{idx}. {answer.strip()}")
@@ -150,7 +145,7 @@ class InitializeTool(Tool):
         summary_lines.extend(
             [
                 "",
-                "Agora você pode pedir conteúdos específicos, por exemplo:",
+                "You can now request specific content, for example:",
                 "- `productivity action=todo_create ...`",
                 "- `knowledge action=mode_list`",
             ]

fenix_mcp/application/tools/intelligence.py

@@ -32,17 +32,17 @@ class IntelligenceAction(str, Enum):
 
     SMART_CREATE = (
         "memory_smart_create",
-        "Cria memórias inteligentes com análise de similaridade.",
+        "Creates intelligent memories with similarity analysis.",
     )
-    QUERY = ("memory_query", "Lista memórias aplicando filtros e busca textual.")
-    SIMILARITY = ("memory_similarity", "Busca memórias similares a um conteúdo base.")
+    QUERY = ("memory_query", "Lists memories applying filters and text search.")
+    SIMILARITY = ("memory_similarity", "Finds memories similar to a base content.")
     CONSOLIDATE = (
         "memory_consolidate",
-        "Consolida múltiplas memórias em uma principal.",
+        "Consolidates multiple memories into a primary one.",
     )
-    UPDATE = ("memory_update", "Atualiza campos de uma memória existente.")
-    DELETE = ("memory_delete", "Remove uma memória pelo ID.")
-    HELP = ("memory_help", "Mostra as ações suportadas e seus usos.")
+    UPDATE = ("memory_update", "Updates fields of an existing memory.")
+    DELETE = ("memory_delete", "Removes a memory by ID.")
+    HELP = ("memory_help", "Shows supported actions and their uses.")
 
     @classmethod
     def choices(cls) -> List[str]:
@@ -51,7 +51,7 @@ class IntelligenceAction(str, Enum):
     @classmethod
     def formatted_help(cls) -> str:
         lines = [
-            "| **Ação** | **Descrição** |",
+            "| **Action** | **Description** |",
             "| --- | --- |",
         ]
         for member in cls:
@@ -60,7 +60,7 @@ class IntelligenceAction(str, Enum):
 
 
 ACTION_FIELD_DESCRIPTION = (
-    "Ação de inteligência a executar. Use um dos valores: "
+    "Intelligence action to execute. Use one of the values: "
     + ", ".join(
         f"`{member.value}` ({member.description.rstrip('.')})."
         for member in IntelligenceAction
@@ -70,31 +70,31 @@ ACTION_FIELD_DESCRIPTION = (
 
 class IntelligenceRequest(ToolRequest):
     action: IntelligenceAction = Field(description=ACTION_FIELD_DESCRIPTION)
-    title: Optional[TitleStr] = Field(default=None, description="Título da memória.")
+    title: Optional[TitleStr] = Field(default=None, description="Memory title.")
     content: Optional[MarkdownStr] = Field(
-        default=None, description="Conteúdo/texto da memória (Markdown)."
+        default=None, description="Memory content/text (Markdown)."
     )
     metadata: Optional[MarkdownStr] = Field(
         default=None,
-        description="Metadata estruturada da memória (formato pipe, toml compacto, etc.).",
+        description="Structured memory metadata (pipe format, compact toml, etc.).",
     )
-    context: Optional[str] = Field(default=None, description="Contexto adicional.")
-    source: Optional[str] = Field(default=None, description="Fonte da memória.")
+    context: Optional[str] = Field(default=None, description="Additional context.")
+    source: Optional[str] = Field(default=None, description="Memory source.")
     importance: Optional[str] = Field(
         default=None,
-        description="Nível de importância da memória (low, medium, high, critical).",
+        description="Memory importance level (low, medium, high, critical).",
     )
     include_content: bool = Field(
         default=False,
-        description="Retornar conteúdo completo das memórias? Defina true para incluir o texto integral.",
+        description="Return full memory content? Set true to include the full text.",
     )
     include_metadata: bool = Field(
         default=False,
-        description="Retornar metadata completa das memórias? Defina true para incluir o campo bruto.",
+        description="Return full memory metadata? Set true to include the raw field.",
     )
     tags: Optional[List[TagStr]] = Field(
         default=None,
-        description="Tags da memória como array JSON de strings.",
+        description='Memory tags. REQUIRED for create. Format: JSON array of strings, e.g.: ["tag1", "tag2"]. Do not use a single string.',
         json_schema_extra={"example": ["tag1", "tag2", "tag3"]},
     )
 
@@ -126,55 +126,51 @@ class IntelligenceRequest(ToolRequest):
         # For any other type, convert to string and wrap in list
         return [str(v).strip()] if str(v).strip() else None
 
-    limit: int = Field(default=20, ge=1, le=100, description="Limite de resultados.")
-    offset: int = Field(default=0, ge=0, description="Offset para paginação.")
-    query: Optional[str] = Field(default=None, description="Termo de busca.")
+    limit: int = Field(default=20, ge=1, le=100, description="Result limit.")
+    offset: int = Field(default=0, ge=0, description="Pagination offset.")
+    query: Optional[str] = Field(default=None, description="Search term.")
     category: Optional[CategoryStr] = Field(
-        default=None, description="Categoria para filtro."
+        default=None, description="Category for filtering."
     )
     date_from: Optional[DateTimeStr] = Field(
-        default=None, description="Filtro inicial (ISO 8601)."
+        default=None, description="Start date filter (ISO 8601)."
     )
     date_to: Optional[DateTimeStr] = Field(
-        default=None, description="Filtro final (ISO 8601)."
+        default=None, description="End date filter (ISO 8601)."
     )
     threshold: float = Field(
-        default=0.8, ge=0, le=1, description="Limite mínimo de similaridade."
+        default=0.8, ge=0, le=1, description="Minimum similarity threshold."
     )
     max_results: int = Field(
-        default=5, ge=1, le=20, description="Máximo de memórias similares."
+        default=5, ge=1, le=20, description="Maximum similar memories."
     )
     memory_ids: Optional[List[UUIDStr]] = Field(
-        default=None, description="IDs das memórias para consolidação (UUIDs)."
+        default=None, description="Memory IDs for consolidation (UUIDs)."
     )
-    strategy: str = Field(default="merge", description="Estratégia de consolidação.")
-    time_range: str = Field(
-        default="month", description="Janela de tempo para analytics."
-    )
-    group_by: str = Field(default="category", description="Agrupamento para analytics.")
-    id: Optional[UUIDStr] = Field(default=None, description="ID da memória (UUID).")
+    strategy: str = Field(default="merge", description="Consolidation strategy.")
+    time_range: str = Field(default="month", description="Time window for analytics.")
+    group_by: str = Field(default="category", description="Grouping for analytics.")
+    id: Optional[UUIDStr] = Field(default=None, description="Memory ID (UUID).")
     documentation_item_id: Optional[UUIDStr] = Field(
-        default=None, description="ID de documentação relacionada (UUID)."
+        default=None, description="Related documentation ID (UUID)."
     )
     mode_id: Optional[UUIDStr] = Field(
-        default=None, description="ID do modo relacionado (UUID)."
+        default=None, description="Related mode ID (UUID)."
     )
     rule_id: Optional[UUIDStr] = Field(
-        default=None, description="ID da regra relacionada (UUID)."
+        default=None, description="Related rule ID (UUID)."
     )
     work_item_id: Optional[UUIDStr] = Field(
-        default=None, description="ID do work item relacionado (UUID)."
+        default=None, description="Related work item ID (UUID)."
     )
     sprint_id: Optional[UUIDStr] = Field(
-        default=None, description="ID do sprint relacionado (UUID)."
+        default=None, description="Related sprint ID (UUID)."
     )
 
 
 class IntelligenceTool(Tool):
     name = "intelligence"
-    description = (
-        "Operações de inteligência do Fênix Cloud (memórias e smart operations)."
-    )
+    description = "Fenix Cloud intelligence operations (memories and smart operations)."
     request_model = IntelligenceRequest
 
     def __init__(self, context: AppContext):
@@ -198,19 +194,19 @@ class IntelligenceTool(Tool):
         if action is IntelligenceAction.DELETE:
             return await self._handle_delete(payload)
         return text(
-            "❌ Ação inválida para intelligence.\n\nEscolha um dos valores:\n"
+            "❌ Invalid action for intelligence.\n\nChoose one of the values:\n"
             + "\n".join(f"- `{value}`" for value in IntelligenceAction.choices())
         )
 
     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.")
+            return text("❌ Provide title and content to create a memory.")
 
         if not payload.metadata or not payload.metadata.strip():
-            return text("❌ Informe metadata para criar uma memória.")
+            return text("❌ Provide metadata to create a memory.")
 
         if not payload.source or not payload.source.strip():
-            return text("❌ Informe source para criar uma memória.")
+            return text("❌ Provide source to create a memory.")
 
         try:
             normalized_tags = _ensure_tag_sequence(payload.tags)
@@ -218,7 +214,7 @@ class IntelligenceTool(Tool):
             return text(f"❌ {exc}")
 
         if not normalized_tags or len(normalized_tags) == 0:
-            return text("❌ Informe tags para criar uma memória.")
+            return text("❌ Provide tags to create a memory.")
 
         memory = await self._service.smart_create_memory(
             title=payload.title,
@@ -230,12 +226,12 @@ class IntelligenceTool(Tool):
             tags=normalized_tags,
         )
         lines = [
-            "🧠 **Memória criada com sucesso!**",
+            "🧠 **Memory created successfully!**",
             f"ID: {memory.get('memoryId') or memory.get('id', 'N/A')}",
-            f"Ação: {memory.get('action') or 'criado'}",
-            f"Similaridade: {format_percentage(memory.get('similarity'))}",
-            f"Tags: {', '.join(memory.get('tags', [])) or 'Automáticas'}",
-            f"Categoria: {memory.get('category') or 'Automática'}",
+            f"Action: {memory.get('action') or 'created'}",
+            f"Similarity: {format_percentage(memory.get('similarity'))}",
+            f"Tags: {', '.join(memory.get('tags', [])) or 'Automatic'}",
+            f"Category: {memory.get('category') or 'Automatic'}",
         ]
         return text("\n".join(lines))
 
@@ -258,44 +254,44 @@ class IntelligenceTool(Tool):
             importance=payload.importance,
         )
         if not memories:
-            return text("🧠 Nenhuma memória encontrada.")
+            return text("🧠 No memories found.")
         body = "\n\n".join(_format_memory(mem) for mem in memories)
-        return text(f"🧠 **Memórias ({len(memories)}):**\n\n{body}")
+        return text(f"🧠 **Memories ({len(memories)}):**\n\n{body}")
 
     async def _handle_similarity(self, payload: IntelligenceRequest):
         if not payload.content:
-            return text("❌ Informe o conteúdo base para comparar similitude.")
+            return text("❌ Provide the base content to compare similarity.")
         memories = await self._service.similar_memories(
             content=payload.content,
             threshold=payload.threshold,
             max_results=payload.max_results,
         )
         if not memories:
-            return text("🔍 Nenhuma memória similar encontrada.")
+            return text("🔍 No similar memories found.")
         body = "\n\n".join(
-            f"🔍 **{mem.get('title', 'Sem título')}**\n   Similaridade: {format_percentage(mem.get('finalScore'))}\n   ID: {mem.get('memoryId', 'N/A')}"
+            f"🔍 **{mem.get('title', 'Untitled')}**\n   Similarity: {format_percentage(mem.get('finalScore'))}\n   ID: {mem.get('memoryId', 'N/A')}"
             for mem in memories
         )
-        return text(f"🔍 **Memórias similares ({len(memories)}):**\n\n{body}")
+        return text(f"🔍 **Similar memories ({len(memories)}):**\n\n{body}")
 
     async def _handle_consolidate(self, payload: IntelligenceRequest):
         if not payload.memory_ids or len(payload.memory_ids) < 2:
-            return text("❌ Informe ao menos 2 IDs de memória para consolidar.")
+            return text("❌ Provide at least 2 memory IDs to consolidate.")
         result = await self._service.consolidate_memories(
             memory_ids=payload.memory_ids,
             strategy=payload.strategy,
         )
         lines = [
-            "🔄 **Consolidação concluída!**",
-            f"Memória principal: {result.get('primary_memory_id', 'N/A')}",
-            f"Consolidadas: {result.get('consolidated_count', 'N/A')}",
-            f"Ação executada: {result.get('action', 'N/A')}",
+            "🔄 **Consolidation complete!**",
+            f"Primary memory: {result.get('primary_memory_id', 'N/A')}",
+            f"Consolidated: {result.get('consolidated_count', 'N/A')}",
+            f"Action executed: {result.get('action', 'N/A')}",
         ]
         return text("\n".join(lines))
 
     async def _handle_update(self, payload: IntelligenceRequest):
         if not payload.id:
-            return text("❌ Informe o ID da memória para atualização.")
+            return text("❌ Provide the memory ID for update.")
         existing = await self._service.get_memory(
             payload.id, include_content=False, include_metadata=True
         )
@@ -326,23 +322,23 @@ class IntelligenceTool(Tool):
         return text(
             "\n".join(
                 [
-                    "✅ **Memória atualizada!**",
+                    "✅ **Memory updated!**",
                     f"ID: {memory.get('id', payload.id)}",
-                    f"Título: {memory.get('title', 'N/A')}",
-                    f"Prioridade: {memory.get('priority_score', 'N/A')}",
+                    f"Title: {memory.get('title', 'N/A')}",
+                    f"Priority: {memory.get('priority_score', 'N/A')}",
                 ]
             )
         )
 
     async def _handle_delete(self, payload: IntelligenceRequest):
         if not payload.id:
-            return text("❌ Informe o ID da memória para remover.")
+            return text("❌ Provide the memory ID to remove.")
         await self._service.delete_memory(payload.id)
-        return text(f"🗑️ Memória {payload.id} removida com sucesso.")
+        return text(f"🗑️ Memory {payload.id} removed successfully.")
 
     async def _handle_help(self):
         return text(
-            "📚 **Ações disponíveis para intelligence**\n\n"
+            "📚 **Available actions for intelligence**\n\n"
             + IntelligenceAction.formatted_help()
         )
 
@@ -350,12 +346,12 @@ class IntelligenceTool(Tool):
 def _format_memory(memory: Dict[str, Any]) -> str:
     return "\n".join(
         [
-            f"🧠 **{memory.get('title', 'Sem título')}**",
+            f"🧠 **{memory.get('title', 'Untitled')}**",
             f"ID: {memory.get('id', memory.get('memoryId', 'N/A'))}",
-            f"Categoria: {memory.get('category', 'N/A')}",
-            f"Tags: {', '.join(memory.get('tags', [])) or 'Nenhuma'}",
-            f"Importância: {memory.get('importance', 'N/A')}",
-            f"Acessos: {memory.get('access_count', 'N/A')}",
+            f"Category: {memory.get('category', 'N/A')}",
+            f"Tags: {', '.join(memory.get('tags', [])) or 'None'}",
+            f"Importance: {memory.get('importance', 'N/A')}",
+            f"Accesses: {memory.get('access_count', 'N/A')}",
         ]
     )
 
@@ -385,7 +381,7 @@ def _ensure_tag_sequence(raw: Optional[Any]) -> Optional[List[str]]:
             pass
 
         raise ValueError(
-            "O campo `tags` deve ser enviado como array JSON, por exemplo: "
+            "The `tags` field must be sent as a JSON array, for example: "
             '["tag1", "tag2"].'
         )
     return [str(raw).strip()]