@agent-native/core 0.92.12 → 0.94.0

package/docs/content/locales/pt-BR/cross-app-sso.mdx

@@ -9,7 +9,11 @@ Cada aplicativo hospedado no `*.agent-native.com` executa sua própria implanta
 
 Esta é a mesma primitiva de confiança que [A2A](/docs/a2a-protocol) e [External Agents](/docs/external-agents) já usam — um `A2A_SECRET` assinado por JWT verificado no limite da solicitação — aplicado ao caminho de login humano em vez de chamadas de agente para agente.
 
-> **Implantação unificada versus implantação por domínio.** Se você hospedar todos os aplicativos em uma origem (`your-agents.com/mail`, `your-agents.com/calendar`), você já terá login compartilhado por meio de um único domínio de cookie, sem necessidade de federação. Cross-App SSO só é necessário quando os aplicativos são executados em domínios separados. Consulte [Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment).
+<Callout tone="info">
+
+**Implantação unificada versus implantação por domínio.** Se você hospedar todos os aplicativos em uma origem (`your-agents.com/mail`, `your-agents.com/calendar`), você já terá login compartilhado por meio de um único domínio de cookie, sem necessidade de federação. Cross-App SSO só é necessário quando os aplicativos são executados em domínios separados. Consulte [Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment).
+
+</Callout>
 
 ## O quê e por quê {#what-why}
 
@@ -86,15 +90,17 @@ O fluxo é um redirecionamento padrão de autorização → token assinado → r
 
 </Diagram>
 
-1. **Aplicativo → Envio (autorizar).** O aplicativo envia o usuário para a autoridade de identidade:
+1. **Aplicativo → Dispatch (autorização).** A rota `GET /_agent-native/identity/login` do aplicativo (à qual o botão “Entrar com Agent-Native” aponta) cria o redirecionamento e envia o usuário à autoridade de identidade:
 
-   ```
+   ```http
    GET https://dispatch.agent-native.com/_agent-native/identity/authorize
        ?app=<requesting-app>
        &redirect_uri=<app-callback-url>
        &estado=<csrf-state>
    ```
 
+   `redirect_uri` é a rota `GET /_agent-native/identity/callback` do próprio aplicativo — a rota que recebe o token assinado na etapa 3.
+
 <Endpoint id="cross-app-sso-identity-authorize-pt-br" title={"Endpoint de autorização de identidade"} method="GET" path="/_agent-native/identity/authorize" summary="Dispatch (autoridade de identidade) autentica o humano e redireciona de volta com um token de identidade assinado" auth={"Sessão de envio (login interativo se não houver)"} params={[
   {
     "name": "app",
@@ -143,7 +149,7 @@ O fluxo é um redirecionamento padrão de autorização → token assinado → r
    | `scope`       | Sempre `"identity"` — este token autoriza apenas o login   |
    | `exp`         | **≤ 2 minutos** a partir da edição                         |
 
-4. **O aplicativo verifica os links JIT por e-mail.** O aplicativo verifica a assinatura do token com seu próprio `A2A_SECRET`, verifica `scope: "identity"` e `exp` e, em seguida, executa **vinculação just-in-time estritamente por e-mail verificado**:
+4. **O aplicativo verifica e vincula JIT por e-mail.** A rota `GET /_agent-native/identity/callback` verifica a assinatura do token com `A2A_SECRET`, confere `scope: "identity"` e `exp` e realiza **vinculação just-in-time estritamente por e-mail verificado**:
    - Se existir um usuário local com esse e-mail → reutilize-o inalterado.
    - Caso contrário → crie um usuário local para esse e-mail.
 
@@ -290,9 +296,13 @@ Depois que um aplicativo for verificado, repita as etapas 2 a 3 para o próximo
 **5. Rollback = desativa a variável env na implantação desse aplicativo.**
 Para reverter qualquer aplicativo, **remova `AGENT_NATIVE_IDENTITY_HUB_URL` do ambiente desse aplicativo e reimplante-o/reinicie-o.** O aplicativo retorna imediatamente ao seu comportamento de autenticação anterior. Não há **nenhuma alteração de dados para desfazer** — as linhas de identidade apenas foram adicionadas e a desativação da variável simplesmente torna o caminho da federação inativo novamente. A substituição e a reversão de cada app são independentes e reversíveis.
 
-> A implementação desconecta os usuários à medida que cada aplicativo é ativado (eles autenticam novamente via Dispatch), mas eles sempre fazem login novamente na **mesma conta correspondente por e-mail com os dados intactos**, porque as linhas de identidade nunca são destruídas ou renomeadas, apenas adicionadas.
+<Callout tone="info">
+
+A implementação desconecta os usuários à medida que cada aplicativo é ativado (eles autenticam novamente via Dispatch), mas eles sempre fazem login novamente na **mesma conta correspondente por e-mail com os dados intactos**, porque as linhas de identidade nunca são destruídas ou renomeadas, apenas adicionadas.
+
+</Callout>
 
-## Relacionado {#related}
+## Próximos passos {#whats-next}
 
 - [Authentication](/docs/authentication) — modos de autenticação local, sessões, organizações, a variável de ambiente `A2A_SECRET`.
 - [A2A Protocol](/docs/a2a-protocol) — o modelo de confiança JWT assinado e de verificação no limite que ele reutiliza.

package/docs/content/locales/pt-BR/deployment.mdx

@@ -452,3 +452,11 @@ Consulte [Frames](/docs/frames) para saber mais sobre o painel de agente incorpo
 ## Implantações de múltiplas instâncias {#multi-instance}
 
 Os aplicativos nativos do agente armazenam todo o estado em SQL com Drizzle e sincronizam o UI via [polling](/docs/key-concepts#polling-sync) com o banco de dados – sem estado do sistema de arquivos, sem sessões fixas, sem caches na memória. Isso significa que implantações de múltiplas instâncias e sem servidor funcionam imediatamente: aponte cada instância para o mesmo `DATABASE_URL` e elas convergem automaticamente. Consulte [Key Concepts — Data in SQL](/docs/key-concepts#data-in-sql) e [Portability](/docs/key-concepts#hosting-agnostic).
+
+## Próximos passos
+
+- [**Database**](/docs/database#production) — escolha um backend SQL persistente antes da primeira implantação em produção
+- [**Security**](/docs/security) — a lista de verificação de produção e os sinalizadores opcionais mencionados nesta página
+- [**Authentication**](/docs/authentication) — credenciais OAuth e variáveis de ambiente para o modo de autenticação escolhido
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — o modelo de espaço de trabalho por trás da compilação de origem única do `deploy`
+- [**Frames**](/docs/frames) — o painel de agente incorporado em comparação com o quadro de nuvem da Builder.io para edições da UI de produção

package/docs/content/locales/pt-BR/extensions.mdx

@@ -11,6 +11,15 @@ Se você usou QuickBooks Online, você viu o modelo: QBO fornece um produto cont
 
 O enquadramento é importante: uma extensão não é uma sandbox genérica do tipo "faça o que quiser". É um **miniaplicativo que estende um modelo específico** — Mail, Analytics, Calendar, Clips, Design — e usa o actions e os dados desse modelo. Uma extensão Mail lê e-mails. Uma extensão do Analytics lê as métricas de um painel. Uma extensão do Calendário atua no evento aberto. Eles se sentem parte do produto hospedeiro porque _são_ parte do produto hospedeiro.
 
+> **As extensões adicionam interface; elas não reescrevem a interface do
+> aplicativo host.** Uma extensão é exibida em sua própria página ou em um
+> [slot](#slots) nomeado exposto pelo modelo. Ela não pode inserir elementos em
+> componentes nativos arbitrários — por exemplo, ao lado de cada participante
+> no Calendário — a menos que o modelo exponha um slot nesse local. Para uma
+> personalização mais profunda, peça ao agente para editar o código-fonte do
+> modelo. A personalização completa do código é um recurso central do Agent
+> Native; as extensões são a camada rápida, sem implantação.
+
 Três coisas fazem as extensões funcionarem:
 
 - **Sem código, sem implantação.** O agente os grava e eles ficam ativos em segundos. Armazenado no banco de dados, não no repositório.

package/docs/content/locales/pt-BR/external-agents.mdx

@@ -136,13 +136,9 @@ instantâneo até que você o atualize/revise novamente, então verifique novame
 alterações nos metadados da ferramenta ou do aplicativo MCP. Se você ainda tiver conectores por aplicativo antigos
 ativado junto com Dispatch, atualize ou reconecte cada conector obsoleto; atualizando
 O Dispatch não reescreve o calendário/correio/etc em cache de ChatGPT ou Claude.
-instantâneos. Os escopos são:
-
-| Escopo      | O que ele permite                                                |
-| ----------- | ---------------------------------------------------------------- |
-| `mcp:read`  | Ferramentas somente leitura e descoberta de ferramentas/recursos |
-| `mcp:write` | Esboço, atualização e outras mutações do actions                 |
-| `mcp:apps`  | Aplicativos MCP inline, gráficos, painéis, rascunhos e UIs       |
+instantâneos. Os escopos `mcp:read` / `mcp:write` / `mcp:apps` são os mesmos
+descritos abaixo em
+[OAuth remoto padrão do MCP](#standard-oauth).
 
 Cursor, Goose, Postman, MCPJam e VS Code GitHub Copilot usam o mesmo controle remoto
 MCP URL por meio de seus próprios servidores MCP UIs quando sua compilação suporta OAuth remoto

package/docs/content/locales/pt-BR/key-concepts.mdx

@@ -11,11 +11,9 @@ Como os aplicativos nativos do agente funcionam nos bastidores — os princípio
 
 Cada aplicativo nativo do agente consiste em três coisas trabalhando juntas:
 
-> **Agente** — IA autônoma que lê dados, grava dados, executa actions e modifica código. Personalizável com skills e instruções.
->
-> **Aplicação** — A superfície do produto ao redor do agente. Inicialmente, isso pode ser apenas ação, bate-papo avançado, um pequeno plano de controle ou um UI React completo com painéis, fluxos e visualizações.
->
-> **Computador** — Banco de dados, navegador, execução de código. Os agentes trabalham diretamente com SQL e ferramentas integradas; Os servidores MCP são complementos opcionais, não a base.
+- **Agente** — IA autônoma que lê dados, grava dados, executa actions e modifica código. Personalizável com skills e instruções.
+- **Aplicação** — A superfície do produto ao redor do agente. Inicialmente, isso pode ser apenas ação, bate-papo avançado, um pequeno plano de controle ou um UI React completo com painéis, fluxos e visualizações.
+- **Computador** — Banco de dados, navegador, execução de código. Os agentes trabalham diretamente com SQL e ferramentas integradas; Os servidores MCP são complementos opcionais, não a base.
 
 <Diagram id="doc-block-12lr99b" title="Agente, aplicativo e computador" summary={"Três camadas trabalhando juntas em um armazenamento SQL compartilhado. O agente e o aplicativo leem e gravam os mesmos dados."}>
 
@@ -277,8 +275,7 @@ Por que não chamar um LLM inline?
 
 Quando o agente precisa fazer algo complexo — chamar um API, processar dados, consultar o banco de dados — ele executa uma **ação**. Actions são arquivos TypeScript em `actions/` que exportam um `defineAction()` padrão:
 
-```ts
-// actions/fetch-data.ts
+```ts filename="actions/fetch-data.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -380,9 +377,8 @@ Um _frame_ é o ambiente que hospeda o agente próximo ao seu aplicativo – loc
 
 Os aplicativos nativos do agente incluem um painel de agente incorporado que fornece o agente de IA junto com o aplicativo UI. É isso que faz a arquitetura funcionar: o agente precisa de um computador (banco de dados, navegador, execução de código) e o aplicativo precisa do agente para o trabalho de IA.
 
-> **Painel de agente incorporado** — Bate-papo e terminal CLI opcional integrado em cada aplicativo. Suporta código Claude, Codex, Gemini, OpenCode e Builder.io. Executa localmente. Gratuito e de código aberto.
->
-> **Nuvem** — Implante em qualquer nuvem com colaboração em tempo real, edição visual, funções e permissões. Melhor para equipes.
+- **Painel de agente incorporado** — Bate-papo e terminal CLI opcional integrado em cada aplicativo. Suporta código Claude, Codex, Gemini, OpenCode e Builder.io. Executa localmente. Gratuito e de código aberto.
+- **Nuvem** — Implante em qualquer nuvem com colaboração em tempo real, edição visual, funções e permissões. Melhor para equipes.
 
 ## Consciência do contexto {#context-awareness}
 
@@ -454,14 +450,11 @@ Adotar o framework é valioso principalmente por causa do que você deixa de ter
 
 Esse é o "e tudo mais" que você mesmo estaria colando.
 
-## Aprofundamentos {#deep-dives}
-
-Para orientação detalhada sobre padrões específicos:
+## Próximos passos {#deep-dives}
 
-- [What Is Agent-Native?](/docs/what-is-agent-native) — a visão e a filosofia
-- [Context Awareness](/docs/context-awareness) — estado de navegação, tela de visualização, comandos de navegação
-- [Skills Guide](/docs/skills-guide) — estrutura skills, domínio skills, criação de skills personalizado
-- [Native Interface de chat](/docs/native-chat-ui) — tabelas declaradas por ação, gráficos e postura de tempo de execução BYO
-- [Agent Surfaces](/docs/agent-surfaces) — bate-papo avançado e sem interface, sidecar incorporado e caminhos de aplicativos completos
-- [A2A Protocol](/docs/a2a-protocol) — comunicação entre agentes
-- [Multi-App Workspace](/docs/multi-app-workspace) — hospede vários aplicativos em um monorepo com autenticação compartilhada, skills, componentes e credenciais
+- [**What Is Agent-Native?**](/docs/what-is-agent-native) — a visão e a filosofia por trás destas regras
+- [**Context Awareness**](/docs/context-awareness) — estado de navegação e comandos view-screen e navigate em detalhes
+- [**Skills Guide**](/docs/skills-guide) — skills do framework, skills de domínio e criação de skills personalizadas
+- [**Native Chat UI**](/docs/native-chat-ui) — tabelas e gráficos declarados por actions e suporte a tempos de execução próprios
+- [**Agent Surfaces**](/docs/agent-surfaces) — chat, UI nativa integrada, páginas completas de aplicativo, sidecar incorporado, automação e caminhos de agentes externos
+- [**A2A Protocol**](/docs/a2a-protocol) — comunicação entre agentes

package/docs/content/locales/pt-BR/messaging.mdx

@@ -1,11 +1,15 @@
 ---
 title: "Mensagens"
-description: "Fale com seu agente por Slack, e-mail, Telegram ou WhatsApp — mesmo agente, mesma memória, mesmas ferramentas."
+description: "Fale com seu agente pelo Slack, Microsoft Teams, interações do Discord, e-mail, Telegram ou WhatsApp."
 ---
 
 # Mensagens
 
-Conecte seu agente ao Slack, e-mail, Telegram ou WhatsApp para que você possa conversar com ele nos aplicativos que você já usa. É o mesmo agente — mesma memória, mesmas ferramentas, mesmos threads — apenas acessível de mais lugares.
+Conecte seu agente ao Slack, Microsoft Teams, interações do Discord, e-mail, Telegram ou WhatsApp. É o mesmo agente, com a mesma memória, ferramentas e histórico.
+
+> **Escopo exato:** o Teams valida os JWTs oficiais do Bot Framework e responde na conversa original. O Discord oferece comandos de barra por interações HTTP assinadas com Ed25519 e confirmação adiada; mensagens comuns de servidor e DMs ainda exigem um runtime Gateway. O Telegram preserva `message_thread_id`, e o WhatsApp usa o `wamid` recebido em respostas contextuais.
+>
+> O Teams exige `MICROSOFT_TEAMS_APP_ID`, `MICROSOFT_TEAMS_APP_PASSWORD` e `MICROSOFT_TEAMS_ALLOWED_TENANT_IDS`. O Discord exige `DISCORD_APPLICATION_ID` e `DISCORD_PUBLIC_KEY`. O Telegram também exige `TELEGRAM_WEBHOOK_SECRET`, e o WhatsApp, `WHATSAPP_APP_SECRET`.
 
 > **Usando o modelo Dispatch?** Tudo isso está configurado para você em **Configurações → Mensagens**. Clique para conectar cada plataforma — você não precisa ler o restante desta página, a menos que esteja personalizando ou construindo seu próprio modelo. Consulte [Dispatch](/docs/dispatch) ou [Dispatch template reference](/docs/template-dispatch).
 
@@ -78,7 +82,6 @@ Conecte seu agente ao Slack, e-mail, Telegram ou WhatsApp para que você possa c
    - `chat:write` — permite que o agente envie mensagens
    - `app_mentions:read` — permite que o agente veja quando ele é @mencionado (opcional)
    - `im:history` — permite que o agente leia mensagens diretas enviadas a ele
-   - `assistant:write` — opcional; permite que Slack mostre o status nativo "está pensando..." em threads assistentes
    - `users:read.email` — opcional; ajuda modelos como o Mail a verificar o e-mail do remetente Slack quanto à identidade da fila de rascunho
 3. Clique em **Instalar no Workspace** na parte superior da página. Slack lhe dará um **Token de usuário de bot OAuth** que começa com `xoxb-`. Copie.
 4. Acesse **Informações básicas** na barra lateral e copie o **Segredo de assinatura**.
@@ -123,12 +126,80 @@ e eventos `link_shared` para o manipulador de desdobramento de clipes.
 
 ### Dicas
 
-- **Menções ao canal** — o bot só responde nos canais quando é mencionado com @, para evitar ruído.
-- **DMs** — cada DM é tratado como uma conversa privada com o agente.
-- **Mesma identidade, todos os canais** — se um usuário Slack tiver o mesmo e-mail de um usuário registrado em seu aplicativo, o agente o tratará como a mesma pessoa.
+- **Menções ao canal** — use uma @menção para iniciar o trabalho. Respostas sem menção só continuam enquanto esse mesmo tópico tiver trabalho ativo.
+- **Mensagens diretas** — as mensagens diretas pessoais aceitas são conversas privadas e exigem um membro verificado da organização ou uma identidade Slack vinculada.
+- **Identidade** — DMs podem associar um e-mail Slack verificado ao mesmo usuário do app; canais gerenciados usam sua identidade de serviço e política.
 - **Listas de permissões de produção** — defina `SLACK_ALLOWED_TEAM_IDS` e, para aplicativos Slack compartilhados, `SLACK_ALLOWED_API_APP_IDS` para que um segredo de assinatura válido não possa ser reutilizado por um espaço de trabalho inesperado.
 - **O aplicativo Clips é aberto** — Agent-Native instalável Os clipes para Slack usam `SLACK_CLIENT_ID`, `SLACK_CLIENT_SECRET`, `SLACK_SIGNING_SECRET` e `/api/slack/oauth/callback`. Cada espaço de trabalho Slack conectado obtém seu próprio token de bot criptografado em `app_secrets`; `SLACK_BOT_TOKEN` é apenas um substituto herdado de espaço de trabalho único.
 
+### Add to Slack gerenciado
+
+OAuth gerenciado é a configuração recomendada. Em **Configurações → Mensagens**,
+selecione **Agent manifest** para baixar o arquivo específico do host
+`agent-native-slack-manifest.json` e importe-o em **App Manifest** no Slack.
+O manifesto ativa a experiência `agent_view` atual e uma aba **Messages** gravável
+para mensagens diretas. Confirme estes escopos de bot:
+
+O ícone do aplicativo não faz parte do manifesto. Em **Basic Information →
+Display Information**, envie o ícone do Agent Native para que o seletor de Agents
+corresponda à marca do produto. Você pode usar o `icon-512.svg` público do
+aplicativo como origem e convertê-lo para um formato de upload aceito pelo Slack,
+se necessário.
+
+```text
+assistant:write
+app_mentions:read
+   channels:history
+   channels:read
+   chat:write
+files:read
+   groups:history
+   groups:read
+   im:history
+im:read
+   mpim:history
+   mpim:read
+   pins:read
+   reactions:read
+users:read
+users:read.email
+```
+
+Defina OAuth Redirect URL como
+`https://your-app.example.com/_agent-native/integrations/slack/oauth/callback`,
+Event Subscriptions Request URL como
+`https://your-app.example.com/_agent-native/integrations/slack/webhook` e
+Interactivity Request URL como
+`https://your-app.example.com/_agent-native/integrations/slack/interactions`.
+Assine `app_home_opened`, `app_context_changed`, `app_mention`,
+`message.channels`, `message.groups`, `message.im` e `message.mpim`.
+Configure `SLACK_CLIENT_ID`, `SLACK_CLIENT_SECRET` e
+`SLACK_SIGNING_SECRET`; depois escolha **Add to Slack** em
+**Configurações → Mensagens**. Cada instalação mantém seu token criptografado e
+separa chaves de conversa por espaço, app, canal e tópico.
+
+Reinstale o aplicativo Slack depois de alterar o manifesto, os escopos, os
+eventos, a Agent view ou a aba Messages. `app_home_opened` detecta quando a DM é
+aberta, `app_context_changed` fornece o contexto atual do Slack e `message.im`
+entrega as mensagens diretas. Administradores do Slack podem ocultar agentes
+instalados para toda a organização, e cada usuário pode ocultá-los da própria
+barra superior. Se a instalação funcionar mas o agente não aparecer, verifique
+esses controles ou abra-o em **Tools → Apps**.
+
+Mensagens diretas pessoais do Slack só são aceitas de um membro verificado da
+organização Agent Native ou de uma identidade Slack já vinculada. As políticas e
+os orçamentos do principal de serviço do canal são separados.
+
+Respostas sem menção só orientam um tópico com tarefa ativa; o restante da conversa
+do canal não chama o agente. Um contexto limitado inclui reações e referências de
+arquivo, e um cartão nativo mostra plano, progresso, cancelar e aprovar/negar. DMs
+usam identidade pessoal; canais gerenciados usam uma identidade de serviço explícita
+e políticas de convidados, Slack Connect e modelo. A memória do canal é explícita,
+isolada e nunca automática. Rotinas criadas no canal retornam ao mesmo Slack.
+Orçamentos diários ou mensais por organização, solicitante e canal são aplicados com
+linhagem completa de auditoria. `assistant:write` ativa os eventos de contexto do
+Agent View; `chat:write` possibilita respostas e atualizações de status ao vivo.
+
 ## Configurar o Telegram {#telegram}
 
 ### O que você precisa
@@ -435,7 +506,9 @@ POST /_agent-native/integrations/telegram/setup
 | E-mail     | `EMAIL_AGENT_ADDRESS`, mais um de `RESEND_API_KEY` ou `SENDGRID_API_KEY`     | `EMAIL_INBOUND_WEBHOOK_SECRET`                        |
 | WhatsApp   | `WHATSAPP_ACCESS_TOKEN`, `WHATSAPP_VERIFY_TOKEN`, `WHATSAPP_PHONE_NUMBER_ID` | —                                                     |
 
-Todas as credenciais residem em env vars - nunca no banco de dados, nunca no código-fonte. Use as configurações da barra lateral UI ou o painel ambiental do seu provedor de hospedagem.
+As credenciais de integração são resolvidas primeiro a partir dos segredos com escopo do proprietário da integração (usuário, organização e depois espaço de trabalho); variáveis de ambiente de implantação são um fallback para instalações locais ou deliberadamente de tenant único. A UI de configuração salva segredos com escopo; os valores nunca retornam ao navegador nem são armazenados no código-fonte.
+
+Os adaptadores de runtime integrados são **Slack**, **Telegram**, **WhatsApp Cloud API** e e-mail por webhook de provedor (Resend ou SendGrid). Discord e Microsoft Teams não são conectáveis até que um adaptador verificado seja implementado e registrado.
 
 ### Rodeamento e identidade {#threading-and-identity}
 
@@ -481,13 +554,13 @@ import type {
 import type { EnvKeyConfig } from "@agent-native/core/server";
 
 const myAdapter: PlatformAdapter = {
-  platform: "discord",
-  label: "Discord",
+  platform: "my-chat",
+  label: "My Chat",
 
   // Env keys this adapter needs (rendered in the settings UI)
   getRequiredEnvKeys(): EnvKeyConfig[] {
     return [
-      { key: "DISCORD_BOT_TOKEN", label: "Discord Bot Token", required: true },
+      { key: "MY_CHAT_BOT_TOKEN", label: "My Chat Bot Token", required: true },
     ];
   },
 
@@ -507,10 +580,10 @@ const myAdapter: PlatformAdapter = {
   // Return null to silently ignore the event (bot messages, edits, etc.).
   async parseIncomingMessage(event: H3Event): Promise<IncomingMessage | null> {
     return {
-      platform: "discord",
+      platform: "my-chat",
       externalThreadId: "channel-or-thread-id",
       text: "the user's message",
-      senderId: "discord-user-id",
+      senderId: "my-chat-user-id",
       platformContext: { channelId: "channel-id" },
       timestamp: Date.now(),
     };
@@ -538,10 +611,10 @@ const myAdapter: PlatformAdapter = {
   // baseUrl is the app's public URL, used for status checks that need it.
   async getStatus(baseUrl?: string) {
     return {
-      platform: "discord",
-      label: "Discord",
+      platform: "my-chat",
+      label: "My Chat",
       enabled: true,
-      configured: !!process.env.DISCORD_BOT_TOKEN,
+      configured: !!process.env.MY_CHAT_BOT_TOKEN,
     };
   },
 };

package/docs/content/locales/pt-BR/multi-tenancy.mdx

@@ -17,7 +17,7 @@ Um novo andaime `npx @agent-native/core@latest create` já vem com:
 - **Troca de organização** — a sessão rastreia a organização ativa (`session.orgId`) e a troca altera os dados que o usuário e o agente veem.
 - **Isolamento de dados por organização** — cada consulta tem como escopo automático a organização ativa.
 
-Se você estiver avaliando agente nativo para um CRM, rastreador de projeto, caixa de entrada de suporte ou qualquer ferramenta de equipe, a base multilocatário já está lá. Todos os modelos próprios são multilocatários. Consulte [Cloneable SaaS templates](/docs/cloneable-saas) para ver a lista.
+Se você estiver avaliando agente nativo para um CRM, rastreador de projeto, caixa de entrada de suporte ou qualquer ferramenta de equipe, a base multilocatário já está lá. Todos os modelos próprios são multilocatários. Consulte [Modelos](/docs/cloneable-saas) para ver a lista.
 
 <Diagram id="doc-block-nfti3p" title={"Associação e isolamento da organização"} summary={"Os usuários ingressam em organizações como owner/admin/member. Cada linha proprietária carrega o org_id do locatário que a possui e nenhuma linha vaza através do limite."}>
 
@@ -117,8 +117,8 @@ Os dados do locatário são isolados por uma coluna `org_id` (adicionada por `ow
 
 Este é o mesmo pipeline usado para escopo por usuário. Para a mecânica de nível SQL, o contrato `ownableColumns()` e os protetores `accessFilter`/`resolveAccess`/`assertAccess`, consulte [Security → Data Scoping](/docs/security#data-scoping) — a única fonte de verdade para o pipeline de escopo.
 
-## Documentos relacionados {#related}
+## Próximos passos {#related}
 
-- [Authentication](/docs/authentication#organizations) — sessões, provedores sociais e superfície de gerenciamento organizacional
-- [Security → Data Scoping](/docs/security#data-scoping) — Isolamento no nível SQL, contrato `ownableColumns()` e proteções de acesso
-- [Multi-App Workspace](/docs/multi-app-workspace) — hospeda vários aplicativos nativos de agente em um monorepo com autenticação compartilhada e RBAC
+- [**Authentication**](/docs/authentication#organizations) — sessões, provedores sociais e superfície de gerenciamento organizacional
+- [**Security — Data Scoping**](/docs/security#data-scoping) — isolamento no nível SQL, contrato `ownableColumns()` e proteções de acesso
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — hospede vários aplicativos Agent-Native em um monorepo com autenticação compartilhada e RBAC

package/docs/content/locales/pt-BR/notifications.mdx

@@ -113,6 +113,7 @@ A gravidade orienta o estilo do selo no menu suspenso e é transmitida aos canai
 | `inbox`   | Persiste na tabela `notifications`; toca a campainha UI | Sempre ligado — parte do primitivo.                            |
 | `webhook` | POST JSON para um URL configurado                       | `NOTIFICATIONS_WEBHOOK_URL` env var definida na inicialização. |
 
+E-mail, Slack e webhook são sempre registrados junto com a caixa de entrada. A entrega prioriza a URL ou os destinatários nos metadados da notificação e, em seguida, usa a variável de ambiente correspondente. Se nenhum deles estiver definido, esse canal não faz nada durante a emissão.
 O canal webhook resolve referências `${keys.NAME}` em URL e `NOTIFICATIONS_WEBHOOK_AUTH` em relação ao [secrets](/docs/security) ad-hoc do proprietário, de forma que o valor bruto nunca entre no contexto do agente. As listas de permissões URL por chave são aplicadas – a mesma regra que a ferramenta de automações `web-request` usa.
 
 <Diagram id="doc-block-1b6ozy6" title="Canais e gravidade" summary={"a caixa de entrada está sempre ativada; o webhook precisa de um env var; canais personalizados são registrados na inicialização. A severidade impulsiona o estilo do emblema e é transmitida a todos os canais."}>
@@ -203,7 +204,7 @@ await notify(
 
 Registre um canal personalizado de qualquer plugin de servidor.
 
-```ts
+```ts filename="server/plugins/notifications-slack-ops.ts"
 import { registerNotificationChannel } from "@agent-native/core/notifications";
 
 registerNotificationChannel({
@@ -274,15 +275,15 @@ interface NotificationMeta {
 
 Montado em `/_agent-native/notifications/*` pelo plugin core-routes. Todas as rotas têm como escopo o e-mail da sessão autenticada.
 
-| Método   | Caminho                                             |
-| -------- | --------------------------------------------------- |
-| `GET`    | `/_agent-native/notifications?unread=true&limit=50` |
-| `GET`    | `/_agent-native/notifications/count`                |
-| `POST`   | `/_agent-native/notifications/:id/read`             |
-| `POST`   | `/_agent-native/notifications/read-all`             |
-| `DELETE` | `/_agent-native/notifications/:id`                  |
+| Método   | Caminho                                                        |
+| -------- | -------------------------------------------------------------- |
+| `GET`    | `/_agent-native/notifications?unread=true&limit=50&before=ISO` |
+| `GET`    | `/_agent-native/notifications/count`                           |
+| `POST`   | `/_agent-native/notifications/:id/read`                        |
+| `POST`   | `/_agent-native/notifications/read-all`                        |
+| `DELETE` | `/_agent-native/notifications/:id`                             |
 
-<Endpoint id="doc-block-11yfpn9" title={"Listar notificações"} summary={"The route behind listNotifications() — scoped to the authenticated session's email."} method="GET" path={"/_agent-native/notifications?unread=true&limit=50"} summary={"Listar notificações recentes para o usuário atual"} auth={"Authenticated session; results are scoped to the session's email."} params={[
+<Endpoint id="doc-block-11yfpn9" title={"Listar notificações"} method="GET" path={"/_agent-native/notifications?unread=true&limit=50&before=ISO"} summary={"Listar notificações recentes para o usuário atual"} auth={"Authenticated session; results are scoped to the session's email."} params={[
   {
     "name": "unread",
     "in": "query",
@@ -296,6 +297,13 @@ Montado em `/_agent-native/notifications/*` pelo plugin core-routes. Todas as ro
     "type": "number",
     "required": false,
     "description": "Max rows to return."
+  },
+  {
+    "name": "before",
+    "in": "query",
+    "type": "string",
+    "required": false,
+    "description": "Cursor de timestamp ISO — retorna notificações criadas antes desse horário para paginação."
   }
 ]} responses={[
   {
@@ -308,7 +316,7 @@ Montado em `/_agent-native/notifications/*` pelo plugin core-routes. Todas as ro
 
 ## Componente UI {#ui}
 
-```tsx
+```tsx filename="app/components/HeaderBar.tsx"
 import { NotificationsBell } from "@agent-native/core/client/notifications";
 
 export function HeaderBar() {

package/docs/content/locales/pt-BR/processors.mdx

@@ -51,8 +51,11 @@ Um `Processor` é um **observador/guardrail** interno de loop para a execução
 
 </Diagram>
 
-> [!WARNING]
-> Um processador é **configuração**, não é uma ferramenta, não é uma ação e não é um DSL de autoria. Os processadores apenas observam, alteram seu próprio estado com escopo de fluxo e `abort()`. Eles nunca definem o comportamento do aplicativo, substituem actions ou aparecem para o modelo. As operações do aplicativo pertencem a [actions](/docs/actions).
+<Callout id="doc-block-proc1cfg" tone="warning">
+
+Um processador é **configuração**, não é uma ferramenta, não é uma ação e não é um DSL de autoria. Os processadores apenas observam, alteram seu próprio estado com escopo de fluxo e `abort()`. Eles nunca definem o comportamento do aplicativo, substituem actions ou aparecem para o modelo. As operações do aplicativo pertencem a [actions](/docs/actions).
+
+</Callout>
 
 ## Os ganchos {#hooks}
 
@@ -133,10 +136,13 @@ await runAgentLoop({
 
 **Zero sobrecarga quando não utilizado.** O loop cria a cadeia do processador somente quando pelo menos um processador é fornecido; quando `processors` é omitido ou vazio, nenhum código de costura é executado e o loop permanece inalterado byte por byte. Os ganchos são executados em ordem de registro e podem ser sincronizados ou assíncronos.
 
-> [!NOTE]
-> A junção em nível de loop é entregue hoje e pode ser chamada diretamente por subagentes, A2A, MCP e testes. Encadear `processors` por meio do manipulador de bate-papo HTTP (para que um resolvedor por solicitação possa configurá-los sem chamar `runAgentLoop` diretamente) é um encanamento de conveniência que ainda não está conectado. Configure os processadores no site de chamada `runAgentLoop` por enquanto.
+<Callout id="doc-block-proc1note" tone="info">
+
+A junção em nível de loop é entregue hoje e pode ser chamada diretamente por subagentes, A2A, MCP e testes. Encadear `processors` por meio do manipulador de bate-papo HTTP (para que um resolvedor por solicitação possa configurá-los sem chamar `runAgentLoop` diretamente) é um encanamento de conveniência que ainda não está conectado. Configure os processadores no site de chamada `runAgentLoop` por enquanto.
+
+</Callout>
 
-## Relacionado
+## O que vem a seguir
 
 - [**Durable Resume**](/docs/durable-resume) — como o loop sobrevive a interrupções sem executar novamente os efeitos colaterais concluídos.
 - [**Custom Agents & Teams**](/docs/agent-teams) — os subagentes executam o mesmo loop e podem carregar seus próprios processadores.

package/docs/content/locales/pt-BR/server.mdx

@@ -96,8 +96,7 @@ server/routes/
 
 Cada rota exporta um `defineEventHandler`:
 
-```ts
-// server/routes/api/health.get.ts
+```ts filename="server/routes/api/health.get.ts"
 import { defineEventHandler } from "h3";
 
 export default defineEventHandler(() => ({
@@ -137,8 +136,7 @@ Use a opção `http` da action para moldar o acesso HTTP direto: actions são `P
 
 Para um endpoint de status somente leitura, mantenha-o como uma action:
 
-```ts
-// actions/get-status.ts
+```ts filename="actions/get-status.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -171,8 +169,7 @@ o que aconteceu. Para transformações estreitas do lado do servidor que intenci
 ferramentas, histórico de bate-papo ou estado de execução, use `completeText()` como um escape explícito
 hachurada.
 
-```ts
-// actions/classify-message.ts
+```ts filename="actions/classify-message.ts"
 import { defineAction } from "@agent-native/core/action";
 import { completeText } from "@agent-native/core/server";
 import { z } from "zod";
@@ -237,8 +234,7 @@ Actions montado pela estrutura é executado automaticamente com contexto de soli
 
 Os plug-ins ficam no `server/plugins/` e são executados na inicialização. Use-os para migrações, configuração de provedores, trabalhos recorrentes, adaptadores de integração e configuração de plug-ins de estrutura.
 
-```ts
-// server/plugins/db.ts
+```ts filename="server/plugins/db.ts"
 import { runMigrations } from "@agent-native/core/db";
 
 export default runMigrations(
@@ -416,8 +412,11 @@ A entrada webhooks deve verificar, persistir e retornar rapidamente. O trabalho
 
 </Diagram>
 
-> [!WARNING]
-> Não confie em promessas inesperadas após retornar uma resposta — hosts sem servidor congelam a execução. Consulte [Messaging](/docs/messaging) para ver a fila de integração canônica.
+<Callout tone="warning">
+  Não confie em promessas inesperadas após retornar uma resposta — hosts sem
+  servidor congelam a execução. Consulte [Messaging](/docs/messaging) para ver a
+  fila de integração canônica.
+</Callout>
 
 ## Avançado: Escotilhas de Fuga {#advanced-escape-hatches}
 
@@ -459,3 +458,11 @@ const handler = createProductionAgentHandler({
   systemPrompt: "You are the app agent...",
 });
 ```
+
+## Próximos passos
+
+- [**Actions**](/docs/actions) — a superfície de operação padrão; use uma rota personalizada apenas quando ela não se encaixar
+- [**Banco de dados**](/docs/database) — o padrão `getDb()`/`schema` importado por rotas personalizadas e actions
+- [**Segurança**](/docs/security#access-guards) — `accessFilter`/`assertAccess` e o modelo completo de escopo de dados
+- [**Mensagens**](/docs/messaging) — o padrão canônico de fila de integração para webhooks recebidos
+- [**Protocolo MCP**](/docs/mcp-protocol) — o endpoint `/_agent-native/mcp` que este servidor monta automaticamente

package/docs/content/locales/pt-BR/sharing.mdx

@@ -1,13 +1,13 @@
 ---
 title: "Compartilhamento e privacidade"
-description: "Compartilhamento no estilo Google Docs, integrado à estrutura. Cada recurso criado pelo usuário (documentos, painéis, designs, apresentações, clipes, gravações, formulários) recebe o mesmo modelo privado por padrão com um compartilhamento consistente UI."
+description: "Compartilhamento familiar e consistente, integrado ao framework. Cada recurso criado pelo usuário — documentos, painéis, designs, apresentações, clipes, gravações e formulários — recebe o mesmo modelo privado por padrão com uma interface de compartilhamento consistente."
 ---
 
 # Compartilhamento e privacidade
 
 Cada recurso que um usuário cria em um aplicativo nativo do agente — um documento, um painel, um design, uma apresentação, uma gravação de tela, uma transcrição de reunião, um formulário, um link de reserva — é **privado para o criador por padrão**. Outras pessoas só o veem quando o criador o compartilha explicitamente ou altera sua visibilidade para `org` ou `public`.
 
-Parece e funciona como o Google Docs. O mesmo botão de compartilhamento, a mesma caixa de diálogo, o mesmo modelo de visibilidade de três níveis, as mesmas concessões por usuário/por organização, em todos os modelos, sem reinvenção por aplicativo.
+É um único modelo de compartilhamento familiar em todos os lugares: o mesmo botão, a mesma caixa de diálogo, o mesmo modelo de visibilidade em três níveis e as mesmas concessões por usuário e organização, em todos os modelos e sem reinvenção por aplicativo.
 
 ## Por que um modelo {#why}
 
@@ -92,7 +92,7 @@ Todo modelo que armazena trabalhos de autoria do usuário usa esse modelo. Concr
 - **Conteúdo** — documentos
 - **Apresentações** — apresentações
 - **Design** — designs e recursos
-- **Clipes** — gravações de tela (estilo Loom)
+- **Clipes** — gravações de tela
 - **Plan** — visual plans and PR recaps
 - **Formulários** — definições de formulário
 - **Calendário** — links para eventos e reservas
@@ -115,7 +115,7 @@ Todo recurso compartilhável recebe um botão de compartilhamento em seu cabeça
 
 - Seletor de visibilidade (`Private` / `Organization` / `Public link`).
 - Preenchimento automático "Adicionar pessoas ou equipes": pesquise usuários na organização ou cole um e-mail.
-- Uma caixa de seleção `Notificar people` no estilo do Google Docs para concessões de e-mail individuais.
+- Uma caixa de seleção `Notificar pessoas` para concessões individuais por e-mail.
 - Uma lista de concessões atuais com seletores de funções e um controle de remoção.
 - Um botão de copiar link que respeita a visibilidade atual.
 
@@ -270,7 +270,7 @@ export const deckShares = createSharesTable("deck_shares");
 
 Uma chamada de registro em `server/db/index.ts`:
 
-```ts
+```ts filename="server/db/index.ts"
 import { registerShareableResource } from "@agent-native/core/sharing";
 
 registerShareableResource({
@@ -315,9 +315,9 @@ For resources that execute code or carry elevated trust (like extensions), set `
 
 O compartilhamento depende do modelo mais amplo de escopo de dados da estrutura: o acesso de lista/leitura/gravação a tabelas próprias passa por `accessFilter()`/`resolveAccess()`/`assertAccess()`, e os recursos marcados com `org_id` são invisíveis nas organizações. Consulte [Security → Data Scoping](/docs/security#data-scoping) para ver o pipeline completo, o protetor de CI e a superfície da ameaça.
 
-## Veja também {#see-also}
+## Próximos passos {#see-also}
 
-- [Security & Data Scoping](/docs/security) — o filtro de acesso e o modelo de propriedade em que o compartilhamento funciona.
-- [Authentication](/docs/authentication) — sessões, organizações e como a identidade flui no contexto da solicitação.
-- [Extensions](/docs/extensions#sharing) — compartilhamento na superfície do miniaplicativo em sandbox.
-- [Creating Templates](/docs/creating-templates) — conectando `ownableColumns` ao esquema de um novo modelo.
+- [**Segurança — Escopo de dados**](/docs/security#data-scoping) — o modelo de filtro de acesso e propriedade no qual o compartilhamento se baseia
+- [**Autenticação**](/docs/authentication) — sessões, organizações e como a identidade flui para o contexto da solicitação
+- [**Extensões**](/docs/extensions#sharing) — compartilhamento na superfície de miniaplicativos em sandbox
+- [**Criação de modelos**](/docs/creating-templates) — conexão de `ownableColumns` ao esquema de um novo modelo