@hed-hog/core 0.0.399 → 0.0.401

package/hedhog/data/mail.yaml

@@ -501,7 +501,7 @@
   body:
     en: |
       Hello {{name}},<br>
-      You have been added to <strong>{{company}}</strong>'s account on the Hcode training platform (<a href="https://hcode.training">https://hcode.training</a>).<br>
+      You have been added to <strong>{{company}}</strong>'s account on the Hcode training platform.<br>
       {{#if hasAccount}}
       You already have an account with this email. Click the secure link below to authorize this access:<br>
       Authorize access: <a href="{{link}}">{{link}}</a><br>
@@ -515,7 +515,7 @@
       The Hcode Team
     pt: |
       Olá {{name}},<br>
-      Você foi adicionado à conta de <strong>{{company}}</strong> na plataforma de treinamentos da Hcode (<a href="https://hcode.training">https://hcode.training</a>).<br>
+      Você foi adicionado à conta de <strong>{{company}}</strong> na plataforma de treinamentos da Hcode.<br>
       {{#if hasAccount}}
       Você já possui uma conta com este e-mail. Clique no link seguro abaixo para autorizar esse acesso:<br>
       Autorizar acesso: <a href="{{link}}">{{link}}</a><br>

package/hedhog/data/mail_layout.yaml

@@ -2,7 +2,10 @@
   is_default: true
   # Shell que estava hardcoded em packages/api-mail/src/mail-template.ts.
   # Tokens: {{{header}}} {{{content}}} {{{footer}}} {{subject}} {{brandName}} {{{brandMark}}}
-  #         {{primaryColor}} {{primaryForeground}} {{year}} {{lang}}
+  #         {{primaryColor}} {{primaryForeground}} {{accentColor}} {{year}} {{lang}}
+  # accentColor e a cor da ETAPA que o e-mail comunica (confirmado, recusado,
+  # enviado...), enviada pelo remetente em `variables.accentColor`. Quem nao manda
+  # nada cai em primaryColor, e por isso os e-mails que ja existiam nao mudam.
   # brandMark/primaryColor/primaryForeground vem das settings image-url, theme-primary-light
   # e theme-primary-foreground-light (ver MailService.resolveLayout em packages/api-mail).
   wrapper: |
@@ -73,7 +76,7 @@
           }
           .panel-accent {
             height: 4px;
-            background: {{primaryColor}};
+            background: {{accentColor}};
           }
           .content {
             padding: 32px 34px 28px;
@@ -163,7 +166,7 @@
                 <tr>
                   <td>
                     <div class="panel">
-                      <div class="panel-accent" style="background:{{primaryColor}};"></div>
+                      <div class="panel-accent" style="background:{{accentColor}};"></div>
                       <div class="content">
                         {{{content}}}
                       </div>

package/hedhog/data/menu.yaml

@@ -143,6 +143,30 @@
           slug: admin
       - where:
           slug: admin-mail
+# Texto das mensagens que a plataforma manda fora do e-mail — hoje, os avisos de
+# WhatsApp do atendimento e do comercio.
+#
+# Fica ao lado dos templates de e-mail, e nao dentro de um modulo, porque a lista
+# e de todos eles: cada library declara os seus e a tela agrupa por modulo.
+- menu_id:
+    where:
+      slug: /core/mail-management
+  url: /core/message-templates
+  # Depois dos perfis de integracao: ordem 4 e 5 ja eram do log de e-mails e dos
+  # perfis, e reordenar as duas exigiria mexer em linhas que ja estao em
+  # producao por outras migrations.
+  order: 6
+  icon: message-square-text
+  name:
+    en: Message Templates
+    pt: Modelos de mensagem
+  slug: /core/message-template
+  relations:
+    role:
+      - where:
+          slug: admin
+      - where:
+          slug: admin-mail
 - menu_id:
     where:
       slug: /core/mail-management
@@ -157,13 +181,9 @@
     role:
       - where:
           slug: admin
-# Fica no nivel de Management, e nao sob Emails: o cadastro cobre e-mail,
-# WhatsApp, storage, IA, OAuth e pagamento - a tela tem uma aba por tipo.
-# Aninhado em Emails, so era encontrado por quem procurava configuracao de
-# e-mail.
 - menu_id:
     where:
-      slug: /core/management
+      slug: /core/mail-management
   url: /core/integration/profiles
   order: 5
   icon: plug-2

package/hedhog/data/route.yaml

@@ -1293,6 +1293,70 @@
           slug: admin
       - where:
           slug: admin-mail
+# Modelos de mensagem — o texto das mensagens que a plataforma manda fora do
+# e-mail (hoje, os avisos de WhatsApp do atendimento e do comercio).
+#
+# Papeis `admin` e `admin-mail`, e nao o admin de cada modulo: a tela passou a
+# listar os modelos de TODOS eles, entao dar acesso ao admin de um modulo daria
+# acesso ao texto dos outros. `admin-mail` e quem ja cuida do que sai da
+# plataforma.
+#
+# Enderecadas por SLUG, e nao por id: a linha no banco so existe depois da
+# primeira edicao, entao um modelo ainda no padrao nao tem id nenhum.
+- url: /message-templates
+  method: GET
+  type: HTTP
+  relations:
+    role:
+      - where:
+          slug: admin
+      - where:
+          slug: admin-mail
+- url: /message-templates/modules
+  method: GET
+  type: HTTP
+  relations:
+    role:
+      - where:
+          slug: admin
+      - where:
+          slug: admin-mail
+- url: /message-templates/:slug
+  method: GET
+  type: HTTP
+  relations:
+    role:
+      - where:
+          slug: admin
+      - where:
+          slug: admin-mail
+- url: /message-templates/:slug
+  method: PATCH
+  type: HTTP
+  relations:
+    role:
+      - where:
+          slug: admin
+      - where:
+          slug: admin-mail
+- url: /message-templates/:slug/preview
+  method: POST
+  type: HTTP
+  relations:
+    role:
+      - where:
+          slug: admin
+      - where:
+          slug: admin-mail
+- url: /message-templates/:slug/restore
+  method: POST
+  type: HTTP
+  relations:
+    role:
+      - where:
+          slug: admin
+      - where:
+          slug: admin-mail
 - url: /mail-sent
   method: GET
   type: HTTP
@@ -2633,6 +2697,48 @@
       - where:
           slug: admin
 
+# Upload sem passar o conteudo pela conversa: o cliente abre o upload, manda o
+# binario pelo PUT assinado (ou em partes) e usa o fileId na tool que precisa dele.
+- tool_name: core.files.create-upload-url
+  type: MCP
+  name: Create File Upload URL
+  relations:
+    role:
+      - where:
+          slug: admin
+      - where:
+          slug: admin-access
+
+- tool_name: core.files.upload.init
+  type: MCP
+  name: Init Chunked File Upload
+  relations:
+    role:
+      - where:
+          slug: admin
+      - where:
+          slug: admin-access
+
+- tool_name: core.files.upload.append
+  type: MCP
+  name: Append File Upload Chunk
+  relations:
+    role:
+      - where:
+          slug: admin
+      - where:
+          slug: admin-access
+
+- tool_name: core.files.upload.complete
+  type: MCP
+  name: Complete File Upload
+  relations:
+    role:
+      - where:
+          slug: admin
+      - where:
+          slug: admin-access
+
 # ─── Mail ────────────────────────────────────────────────────────────────────
 
 - tool_name: core.mail.list
@@ -3647,3 +3753,45 @@
   method: GET
   type: HTTP
   relations: *core_user_roles
+
+# Tools MCP que existiam so no decorador @McpTool: sem declaracao aqui o
+# McpPermissionGuard nao acha linha em `route` e nega todas elas.
+# As cinco de perfil operam sempre sobre o usuario autenticado (context.userId),
+# nunca sobre terceiros, e por isso acompanham os papeis de acesso.
+- tool_name: core.profile.get
+  type: MCP
+  name: Get Own Profile
+  relations: *core_user_roles
+- tool_name: core.profile.update
+  type: MCP
+  name: Update Own Profile
+  relations: *core_user_roles
+- tool_name: core.profile.update-preferences
+  type: MCP
+  name: Update Own Preferences
+  relations: *core_user_roles
+- tool_name: core.profile.mfa.list
+  type: MCP
+  name: List Own MFA Methods
+  relations: *core_user_roles
+- tool_name: core.profile.change-password
+  type: MCP
+  name: Change Own Password
+  relations: *core_user_roles
+# Escrita de setting fica so em admin: a leitura equivalente
+# (core.settings.get) e que acompanha admin-access.
+- tool_name: core.settings.set
+  type: MCP
+  name: Set Setting Value
+  relations:
+    role:
+      - where:
+          slug: admin
+
+- tool_name: core.access-log.list
+  type: MCP
+  name: List Access Log
+  relations:
+    role:
+      - where:
+          slug: admin

package/hedhog/data/setting_group.yaml

@@ -165,8 +165,8 @@
           en: Batch Limit
           pt: Limite de Lote
         description:
-          en: Maximum number of records to delete per cleanup task execution. Smaller values prevent long table locks but increase cleanup duration
-          pt: Número máximo de registros a deletar por execução de tarefa de limpeza. Valores menores evitam locks prolongados mas aumentam a duração da limpeza
+          en: Maximum number of records to delete per batch. Cleanup repeats batches until the backlog is drained, so smaller values prevent long table locks but increase cleanup duration
+          pt: Número máximo de registros a deletar por lote. A limpeza repete os lotes até drenar o acúmulo, então valores menores evitam locks prolongados mas aumentam a duração da limpeza
         value: 20000
         user_override: false
         subgroup_id:
@@ -273,6 +273,10 @@
       - slug: mail-integration-profile-id
         type: string
         component: entity-picker
+        entity_filter:
+          typeSlug: email
+          excludeProviders:
+            - imap
         name:
           en: Mail Profile
           pt: Perfil de Email
@@ -323,6 +327,9 @@
       - slug: ai-openai-profile-id
         type: string
         component: entity-picker
+        entity_filter:
+          typeSlug: ai
+          providerSlug: openai
         name:
           en: OpenAI Profile
           pt: Perfil OpenAI
@@ -337,6 +344,9 @@
       - slug: ai-gemini-profile-id
         type: string
         component: entity-picker
+        entity_filter:
+          typeSlug: ai
+          providerSlug: gemini
         name:
           en: Gemini Profile
           pt: Perfil Gemini
@@ -351,6 +361,9 @@
       - slug: ai-deepseek-profile-id
         type: string
         component: entity-picker
+        entity_filter:
+          typeSlug: ai
+          providerSlug: deepseek
         name:
           en: DeepSeek Profile
           pt: Perfil DeepSeek
@@ -362,6 +375,20 @@
         subgroup_id:
           where:
             slug: ai-configuration
+      - slug: mcp-connector-denied-tools
+        type: array
+        component: input-tags
+        name:
+          en: Tools denied to connectors
+          pt: Ferramentas negadas ao conector
+        description:
+          en: Tools an external OAuth client (such as Claude) can never call, even when the person's role allows it. One per tag, by tool name.
+          pt: Ferramentas que um cliente OAuth externo (como o Claude) nunca pode chamar, mesmo que o papel da pessoa permita. Uma por tag, pelo nome da tool.
+        value: '["core.roles.create", "core.roles.delete", "core.roles.menus.update", "core.roles.routes.update", "core.roles.screens.update", "core.roles.update", "core.roles.users.update", "core.routes.create", "core.routes.delete", "core.routes.roles.update", "core.routes.screens.update", "core.routes.update", "core.screens.create", "core.screens.delete", "core.screens.roles.update", "core.screens.routes.update", "core.screens.update", "core.sessions.revoke", "core.sessions.revoke-all", "core.sessions.revoke-all-other", "core.settings.delete", "core.settings.set", "core.settings.set-many", "core.settings.update-from-slug", "core.users.assign-role", "core.users.create", "core.users.delete", "core.users.remove-role", "core.users.reset-password", "core.users.update", "core.users.verify-identifier"]'
+        user_override: false
+        subgroup_id:
+          where:
+            slug: ai-configuration
       - slug: mcp-enabled
         type: boolean
         component: switch
@@ -379,6 +406,8 @@
       - slug: mcp-ai-profile-id
         type: string
         component: entity-picker
+        entity_filter:
+          typeSlug: ai
         name:
           en: AI Profile
           pt: Perfil de IA
@@ -407,6 +436,8 @@
       - slug: richtext-ai-profile-id
         type: string
         component: entity-picker
+        entity_filter:
+          typeSlug: ai
         name:
           en: AI Profile
           pt: Perfil de IA
@@ -890,6 +921,9 @@
       - slug: oauth-google-profile-id
         type: string
         component: entity-picker
+        entity_filter:
+          typeSlug: oauth
+          providerSlug: google-oauth
         name:
           en: Google OAuth Profile
           pt: Perfil OAuth Google
@@ -940,6 +974,9 @@
       - slug: oauth-facebook-profile-id
         type: string
         component: entity-picker
+        entity_filter:
+          typeSlug: oauth
+          providerSlug: facebook-oauth
         name:
           en: Facebook OAuth Profile
           pt: Perfil OAuth Facebook
@@ -994,6 +1031,9 @@
       - slug: oauth-github-profile-id
         type: string
         component: entity-picker
+        entity_filter:
+          typeSlug: oauth
+          providerSlug: github-oauth
         name:
           en: GitHub OAuth Profile
           pt: Perfil OAuth GitHub
@@ -1042,6 +1082,9 @@
       - slug: oauth-microsoft-profile-id
         type: string
         component: entity-picker
+        entity_filter:
+          typeSlug: oauth
+          providerSlug: microsoft-oauth
         name:
           en: Microsoft OAuth Profile
           pt: Perfil OAuth Microsoft
@@ -1096,6 +1139,9 @@
       - slug: oauth-microsoft-entra-id-profile-id
         type: string
         component: entity-picker
+        entity_filter:
+          typeSlug: oauth
+          providerSlug: microsoft-entra-id-oauth
         name:
           en: Microsoft Entra ID OAuth Profile
           pt: Perfil OAuth Microsoft Entra ID
@@ -1164,6 +1210,17 @@
               order: 13
             - value: OnlineMeetingRecording.Read.All
               order: 14
+            # Necessario para IMPORTAR o anexo do chat da reuniao: o download usa
+            # o token delegado da conta que le o chat, e sem escopo de arquivo o
+            # /shares/{id}/driveItem/content responde 403 — o material vira link
+            # para o arquivo original em vez do arquivo em si.
+            - value: Files.Read.All
+              order: 15
+            # Necessario para o sistema PUBLICAR no chat da reuniao (o convite da
+            # chamada por codigo). E o unico escopo de ESCRITA em chat que
+            # usamos, e so a conta de servico precisa dele.
+            - value: Chat.ReadWrite
+              order: 16
         subgroup_id:
           where:
             slug: microsoft-entra-id
@@ -1295,9 +1352,40 @@
         subgroup_id:
           where:
             slug: microsoft-entra-id
+      - slug: microsoft-meeting-chat-capture-enabled
+        type: boolean
+        component: switch
+        name:
+          en: Capture meeting chat
+          pt: Capturar o chat da reunião
+        description:
+          en: 'After a managed meeting ends, read its Teams chat so the source module can turn what the host shared into materials. Off by default: it reads what people wrote and needs a delegated account with Chat.Read.'
+          pt: 'Quando uma reunião gerenciada termina, ler o chat dela no Teams para o módulo de origem transformar o que o instrutor compartilhou em materiais. Desligado por padrão: lê o que as pessoas escreveram e exige conta delegada com Chat.Read.'
+        value: 'false'
+        user_override: false
+        subgroup_id:
+          where:
+            slug: microsoft-entra-id
+      - slug: microsoft-meeting-chat-delegated-upn
+        type: string
+        component: input-text
+        name:
+          en: Account that reads the chat
+          pt: Conta que lê o chat
+        description:
+          en: UPN of the account whose delegated token reads meeting chats. Empty uses the meeting service account, which organizes every meeting and is therefore in every meeting chat. It must be connected under My account, with Chat.Read granted.
+          pt: UPN da conta cujo token delegado lê os chats das reuniões. Vazio usa a conta de serviço das reuniões, que organiza todas e por isso participa de todos os chats. Ela precisa estar conectada em Minha conta, com Chat.Read concedido.
+        value: ''
+        user_override: false
+        subgroup_id:
+          where:
+            slug: microsoft-entra-id
       - slug: oauth-apple-profile-id
         type: string
         component: entity-picker
+        entity_filter:
+          typeSlug: oauth
+          providerSlug: apple-oauth
         name:
           en: Apple OAuth Profile
           pt: Perfil OAuth Apple
@@ -1346,6 +1434,9 @@
       - slug: oauth-linkedin-profile-id
         type: string
         component: entity-picker
+        entity_filter:
+          typeSlug: oauth
+          providerSlug: linkedin-oauth
         name:
           en: LinkedIn OAuth Profile
           pt: Perfil OAuth LinkedIn
@@ -2070,6 +2161,8 @@
       - slug: file-storage-profile-id
         type: string
         component: entity-picker
+        entity_filter:
+          typeSlug: storage
         name:
           en: Storage Profile
           pt: Perfil de Armazenamento
@@ -2088,7 +2181,7 @@
         description:
           en: MIME types accepted for file uploads (e.g., images, documents, videos)
           pt: Tipos MIME aceitos para upload de arquivos (por exemplo, imagens, documentos, vídeos)
-        value: '["application/pdf","image/jpeg","image/png","image/gif"]'
+        value: '["application/pdf","image/jpeg","image/png","image/gif","text/html"]'
         component: checkbox
         relations:
           setting_list:
@@ -2134,6 +2227,8 @@
               order: 16
             - value: audio/flac
               order: 17
+            - value: text/html
+              order: 18
         subgroup_id:
           where:
             slug: storage-general
@@ -2149,6 +2244,53 @@
         subgroup_id:
           where:
             slug: storage-general
+      # Validade da URL assinada de upload (PUT /file/upload/:token). Curta de
+      # proposito: o token e a unica credencial do endpoint publico, e o cliente
+      # sobe o arquivo logo depois de pedir a URL.
+      - slug: storage-upload-url-ttl
+        type: number
+        name:
+          en: Upload URL Lifetime (seconds)
+          pt: Validade da URL de Upload (segundos)
+        description:
+          en: How long a signed upload URL stays valid. The token is single use and scoped to one upload ticket.
+          pt: Por quanto tempo uma URL assinada de upload continua valida. O token e de uso unico e vale para um unico ticket de upload.
+        value: 900
+        component: input-number
+        subgroup_id:
+          where:
+            slug: storage-general
+      # Tamanho de cada parte no upload em partes pelo MCP. O teto real e o limite
+      # de saida do modelo: base64 infla ~33%, entao 64 KiB viram ~87 mil
+      # caracteres por chamada.
+      - slug: mcp-upload-chunk-bytes
+        type: number
+        name:
+          en: MCP Upload Chunk Size (bytes)
+          pt: Tamanho da Parte no Upload MCP (bytes)
+        description:
+          en: Chunk size for core.files.upload.append. Larger chunks mean fewer calls but risk overflowing the model output limit once base64-encoded.
+          pt: Tamanho de cada parte em core.files.upload.append. Partes maiores significam menos chamadas, mas arriscam estourar o limite de saida do modelo depois de codificadas em base64.
+        value: 65536
+        component: input-number
+        subgroup_id:
+          where:
+            slug: storage-general
+      # Allowlist opcional para a modalidade fileUrl. Vazia = qualquer host
+      # publico (enderecos privados sao recusados de qualquer forma).
+      - slug: mcp-file-url-allowed-hosts
+        type: string
+        name:
+          en: Allowed Hosts for File URLs
+          pt: Hosts Permitidos para URL de Arquivo
+        description:
+          en: Comma-separated hostnames the server may download from when a tool receives fileUrl. Leave empty to allow any public host. Private, loopback, link-local and metadata addresses are always rejected.
+          pt: Nomes de host separados por virgula dos quais o servidor pode baixar quando uma tool recebe fileUrl. Deixe vazio para permitir qualquer host publico. Enderecos privados, loopback, link-local e de metadados sao sempre recusados.
+        value: ''
+        component: input-text
+        subgroup_id:
+          where:
+            slug: storage-general
       - slug: image-compression-enabled
         type: boolean
         component: switch
@@ -2524,4 +2666,48 @@
           pt: Cor hexadecimal principal para PDFs da área Research (padrão #9400B5)
         value: '#9400B5'
         user_override: false
+      - slug: pdf-legal-footer
+        type: string
+        component: input-text
+        name:
+          en: Legal Footer
+          pt: Rodapé Legal
+        description:
+          en: Line repeated in the footer of commercial documents, such as legal name, tax ID and address. Leave empty to show the company name.
+          pt: Linha repetida no rodapé dos documentos comerciais, como razão social, CNPJ e endereço. Deixe vazio para mostrar o nome da empresa.
+        value: ''
+        user_override: false
+      - slug: pdf-partner-line
+        type: string
+        component: input-text
+        name:
+          en: Partner Line
+          pt: Linha de Parceiros
+        description:
+          en: Short line printed on the cover of commercial proposals, such as partnerships or certifications. Leave empty to hide it.
+          pt: Linha curta impressa na capa das propostas comerciais, como parcerias ou certificações. Deixe vazio para ocultar.
+        value: ''
+        user_override: false
+      - slug: pdf-font-family
+        type: string
+        component: input-text
+        name:
+          en: Document Font
+          pt: Fonte dos Documentos
+        description:
+          en: CSS font stack for the body and titles of commercial documents.
+          pt: Pilha de fontes CSS para o corpo e os títulos dos documentos comerciais.
+        value: "'Inter', sans-serif"
+        user_override: false
+      - slug: pdf-font-mono
+        type: string
+        component: input-text
+        name:
+          en: Label Font
+          pt: Fonte dos Rótulos
+        description:
+          en: Monospace CSS font stack for labels, section numbers and the footer of commercial documents.
+          pt: Pilha de fontes CSS monoespaçada para rótulos, números de seção e rodapé dos documentos comerciais.
+        value: "'JetBrains Mono', monospace"
+        user_override: false