@agent-native/core 0.92.12 → 0.93.0

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/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/template-clips.mdx

@@ -77,6 +77,7 @@ Pense nos moldes de Loom + Granola + Wispr Flow reunidos em um aplicativo - mas
 ## O que você pode fazer com isso
 
 - **Grave sua tela** com um gravador integrado, sobreposição de webcam, captura de áudio e pausa/corte.
+- **Importe vídeos públicos do Loom.** Na web, selecione **Gravar → Importar Loom** e cole um URL de compartilhamento ou incorporação do Loom. O Clips salva uma cópia na sua biblioteca e importa a transcrição pública quando ela estiver disponível.
 - **Capture reuniões do seu calendário.** Conecte Google Calendar, veja as próximas reuniões na barra lateral e clique em gravar em qualquer uma. Você recebe uma transcrição ao vivo, além de um resumo da IA, notas com marcadores e itens de ação no momento em que termina.
 - **Ditado push-to-talk.** Segure Fn em sua máquina, fale, e o texto limpo será exibido em qualquer aplicativo que você estiver usando. Cada ditado é mantido em um histórico pesquisável com os originais e as versões limpas por IA lado a lado.
 - **Obtenha títulos, resumos e marcadores de capítulo gerados automaticamente** para cada gravação. O agente os preenche e os mantém atualizados.

package/docs/content/locales/pt-BR/template-design.mdx

@@ -89,6 +89,7 @@ Quando você abre o aplicativo, o protótipo gerado é o centro da área de trab
 ## O que você pode fazer com isso
 
 - **Gere protótipos completos.** Descreva a tela ou página necessária e o agente criará um documento HTML funcional com estilo Tailwind e interactions Alpine.
+- **Comece com modelos reutilizáveis.** Escolha um formato dimensionado para anúncios, páginas únicas ou páginas de destino, ou salve qualquer design integrado como modelo. O prompt ajusta apenas o conteúdo desbloqueado e mantém logotipos e fundos bloqueados.
 - **Compare variantes.** Comece com várias direções, escolha a mais forte e continue refinando.
 - **Ajuste visual.** Use os controles de ajuste integrados para alterações comuns ou peça ao agente atualizações de cópia, layout, cor, espaçamento e interação.
 - **Aplique sistemas de design.** Salve e reutilize as preferências do sistema de design para que o trabalho gerado fique mais próximo de sua marca.

package/docs/content/locales/zh-CN/extensions.mdx

@@ -11,6 +11,12 @@ description: "用户在模板内构建的迷你应用程序 - Analytics 中的
 
 框架很重要：扩展不是通用的“做你想做的”沙箱。它是一个**迷你应用程序，扩展了特定模板**（邮件、分析、日历、剪辑、设计）并使用该模板的 actions 和数据。邮件扩展可以读取电子邮件。 Analytics 扩展读取仪表板的指标。日历扩展作用于打开的事件。它们感觉像是主机产品的一部分，因为它们*是*主机产品的一部分。
 
+> **扩展用于添加 UI，而不会重写宿主应用的 UI。** 扩展会显示在自己的页面中，
+> 或显示在模板公开的命名[插槽](#slots)中。它不能向任意原生组件中注入元素
+> ——例如显示在日历的每位参与者旁边——除非模板在该位置公开了插槽。
+> 如需更深入的自定义，请让代理编辑模板的源代码。完整的代码自定义是 Agent
+> Native 的核心能力；扩展则是快速、无需部署的自定义层。
+
 使扩展发挥作用的三件事：
 
 - **无需代码，无需部署。** 代理编写它们并且它们在几秒钟内即可生效。存储在数据库中，而不是存储库中。

package/docs/content/locales/zh-CN/messaging.mdx

@@ -1,11 +1,15 @@
 ---
 title: "消息传递"
-description: "通过 Slack、电子邮件、Telegram 或 WhatsApp 与您的客服人员交谈 — 相同的客服人员、相同的内存、相同的工具。"
+description: "通过 Slack、Microsoft Teams、Discord 交互、电子邮件、Telegram 或 WhatsApp 与您的代理交谈。"
 ---
 
 # 消息传递
 
-将您的代理连接到 Slack、电子邮件、Telegram 或 WhatsApp，以便您可以通过您已使用的应用程序与其聊天。这是同一个代理——相同的内存、相同的工具、相同的线程——只是可以从更多的地方访问。
+将您的代理连接到 Slack、Microsoft Teams、Discord 交互、电子邮件、Telegram 或 WhatsApp。它仍使用相同的记忆、工具和对话历史。
+
+> **准确的支持范围：** Teams 会验证官方 Bot Framework JWT，并回复原始会话。Discord 支持通过 Ed25519 签名的 HTTP 交互执行斜杠命令和延迟确认；普通服务器消息和私信仍需要 Gateway 运行时。Telegram 会保留 `message_thread_id`，WhatsApp 会使用传入的 `wamid` 发送上下文回复。
+>
+> Teams 需要 `MICROSOFT_TEAMS_APP_ID`、`MICROSOFT_TEAMS_APP_PASSWORD` 和 `MICROSOFT_TEAMS_ALLOWED_TENANT_IDS`。Discord 需要 `DISCORD_APPLICATION_ID` 和 `DISCORD_PUBLIC_KEY`。Telegram 还需要 `TELEGRAM_WEBHOOK_SECRET`，WhatsApp 还需要 `WHATSAPP_APP_SECRET`。
 
 > **使用调度模板？** 所有这些都已在 **设置 → 消息传送** 中为您做好准备。单击以连接每个平台 - 您无需阅读本页的其余部分，除非您正在自定义或构建自己的模板。请参阅 [Dispatch](/docs/dispatch) 或 [Dispatch template reference](/docs/template-dispatch)。
 
@@ -78,7 +82,6 @@ description: "通过 Slack、电子邮件、Telegram 或 WhatsApp 与您的客
    - `chat:write` — 让代理发送消息
    - `app_mentions:read` — 让代理看到它何时被@提及（可选）
    - `im:history` — 让代理读取发送给它的 DM
-   - `assistant:write` — 可选；让 Slack 在助理线程中显示本机“正在思考...”状态
    - `users:read.email` — 可选；帮助 Mail 等模板验证 Slack 发件人电子邮件的草稿队列身份
 3. 单击该页面顶部的“**安装到工作区**”。 Slack 将为您提供一个以 `xoxb-` 开头的 **机器人用户 OAuth 令牌**。复制它。
 4. 转到侧边栏中的**基本信息**并复制**签名密钥**。
@@ -123,12 +126,70 @@ Slack 应用程序有一个事件 API 请求 URL。如果同一个 Slack 应用
 
 ### 提示
 
-- **频道提及** - 机器人仅在被@提及时在频道中做出响应，以避免噪音。
-- **私信** — 每个私信都被视为与代理的私人对话。
-- **相同的身份，所有渠道** — 如果 Slack 用户与您应用中的注册用户具有相同的电子邮件地址，则代理会将他们视为同一个人。
+- **频道提及** - 使用 @mention 开始工作。只有同一线程仍有活跃任务时，未提及机器人的回复才会继续任务。
+- **私信** — 已接受的个人私信属于私密会话，并要求已验证的组织成员或已关联的 Slack 身份。
+- **身份** — 私信可把经过验证的 Slack 邮箱映射到同一应用用户；托管频道使用自己的服务身份和策略。
 - **生产允许列表** — 设置 `SLACK_ALLOWED_TEAM_IDS`，对于共享 Slack 应用，设置 `SLACK_ALLOWED_API_APP_IDS`，以便有效的签名密钥无法被意外的工作区重复使用。
 - **Clips 应用程序展开** — 适用于 Slack 的可安装 Agent-Native Clips 使用 `SLACK_CLIENT_ID`、`SLACK_CLIENT_SECRET`、`SLACK_SIGNING_SECRET` 和 `/api/slack/oauth/callback`。每个连接的 Slack 工作空间都会在 `app_secrets` 中获得自己的加密机器人令牌； `SLACK_BOT_TOKEN` 只是传统的单一工作区后备方案。
 
+### 托管 Add to Slack
+
+推荐使用托管 OAuth。在**设置 → 消息**中选择 **Agent manifest**，下载当前主机专用的
+`agent-native-slack-manifest.json`，然后从 Slack 的 **App Manifest** 导入。
+该清单会启用当前的 `agent_view` 体验，以及可写入的 **Messages** 私信标签页。
+请确认包含以下 Bot Token Scopes：
+
+应用图标不包含在清单中。请在 **Basic Information → Display Information** 中上传
+Agent Native 图标，使 Agents 选择器与产品品牌一致。可以使用应用公开的
+`icon-512.svg` 作为源文件，并在需要时转换为 Slack 支持的上传格式。
+
+```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
+```
+
+将 OAuth Redirect URL 设置为
+`https://your-app.example.com/_agent-native/integrations/slack/oauth/callback`，
+Event Subscriptions Request URL 设置为
+`https://your-app.example.com/_agent-native/integrations/slack/webhook`，
+Interactivity Request URL 设置为
+`https://your-app.example.com/_agent-native/integrations/slack/interactions`。
+订阅 `app_home_opened`、`app_context_changed`、`app_mention`、
+`message.channels`、`message.groups`、`message.im` 和 `message.mpim`。
+配置 `SLACK_CLIENT_ID`、`SLACK_CLIENT_SECRET` 和
+`SLACK_SIGNING_SECRET` 后，在**设置 → 消息**中点击 **Add to Slack**。
+每个安装使用独立的加密令牌，并按工作区、应用、频道和线程隔离会话键。
+
+更改清单、权限范围、事件、Agent view 或 Messages 标签页后，请重新安装 Slack 应用。
+`app_home_opened` 用于检测私信是否打开，`app_context_changed` 提供当前查看的 Slack
+上下文，`message.im` 负责传递私信。Slack 管理员可以为整个组织隐藏已安装的代理，
+每位成员也可以从自己的顶部栏隐藏代理。如果安装成功但代理未显示，请检查这些显示
+设置，或从 **Tools → Apps** 打开。
+
+个人 Slack 私信只接受已验证的 Agent Native 组织成员，或已关联到该成员的 Slack
+身份。频道服务主体的策略和预算与个人身份分开管理。
+
+未提及机器人的回复只会继续活跃线程；普通频道聊天不会调用代理。有限上下文包含
+反应和文件引用，原生任务卡显示计划、进度、取消和批准/拒绝。私信使用个人身份；
+托管频道使用明确的服务身份以及访客、Slack Connect 和模型策略。频道记忆仅在明确
+要求时保存或删除，绝不自动记忆。在频道中创建的例程会把结果发送回同一 Slack。
+组织、请求者和频道的每日或每月预算会随完整审计链一起执行。`assistant:write`
+启用 Agent View 上下文事件，`chat:write` 用于回复和实时状态更新。
+
 ## 设置 Telegram {#telegram}
 
 ### 您需要什么
@@ -435,7 +496,9 @@ POST /_agent-native/integrations/telegram/setup
 | 电子邮件 | `EMAIL_AGENT_ADDRESS`，加上 `RESEND_API_KEY` 或 `SENDGRID_API_KEY` 之一      | `EMAIL_INBOUND_WEBHOOK_SECRET`                        |
 | WhatsApp | `WHATSAPP_ACCESS_TOKEN`, `WHATSAPP_VERIFY_TOKEN`, `WHATSAPP_PHONE_NUMBER_ID` | —                                                     |
 
-所有凭证都存在于环境变量中——不是数据库，也不是源代码。使用侧边栏设置 UI 或托管提供商的环境面板。
+集成凭证首先从集成所有者的作用域密钥中解析（用户、组织、再到工作区）；部署环境变量是本地或有意单租户部署的后备方案。设置 UI 会保存作用域密钥；值绝不会返回给浏览器，也不会存入源代码。
+
+内置运行时适配器包括 **Slack**、**Telegram**、**WhatsApp Cloud API** 和提供商 webhook 电子邮件（Resend 或 SendGrid）。在实现并注册经过验证的适配器之前，Discord 和 Microsoft Teams 不可连接。
 
 ### 线程和身份 {#threading-and-identity}
 
@@ -481,13 +544,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 +570,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 +601,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/zh-CN/template-clips.mdx

@@ -77,6 +77,7 @@ search: "Clips 浏览器日志 开发人员日志 控制台日志 网络日志
 ## 你可以用它做什么
 
 - **使用内置录音机、网络摄像头覆盖、音频捕获和暂停/修剪来录制屏幕**。
+- **导入公开的 Loom 视频。** 在网页端选择 **录制 → 导入 Loom**，然后粘贴 Loom 分享或嵌入 URL。Clips 会将副本保存到你的资料库，并在可用时导入公开的转录文本。
 - **从日历中捕获会议。** 连接 Google Calendar，在侧边栏中查看即将举行的会议，并在任何一个会议上进行记录。您将在结束时获得实时记录以及 AI 摘要、项目符号注释和行动项目。
 - **一键通听写。** 按住机器上的 Fn，说话，清理后的文本就会放入您正在使用的任何应用程序中。每个听写都保存在可搜索的历史记录中，原始版本和人工智能清理的版本并排保存。
 - **为每个录音获取自动生成的标题、摘要和章节标记** - 客服人员会填写这些内容并使其保持最新状态。

package/docs/content/locales/zh-CN/template-design.mdx

@@ -89,6 +89,7 @@ Design 是一家代理原生 HTML 原型工作室。该代理不是分层绘图
 ## 你可以用它做什么
 
 - **生成完整的原型。**描述您需要的屏幕或页面，代理将创建一个具有 Tailwind 样式和 Alpine interactions 的工作 HTML 文档。
+- **从可复用模板开始。** 为广告、单页文档、着陆页等选择固定尺寸的起点，或将任意内联设计保存为模板。提示只调整副本中未锁定的内容，锁定的徽标和背景会保持不变。
 - **比较变体。**从多个方向开始，选择最强的一个，然后继续完善。
 - **视觉上的调整。**使用内置的调整控件进行常见更改，或向代理询问副本、布局、颜色、间距和交互更新。
 - **应用设计系统。**保存并重用设计系统首选项，以便生成的作品更贴近您的品牌。

package/docs/content/locales/zh-TW/extensions.mdx

@@ -11,6 +11,12 @@ description: "使用者在範本內建置的迷你應用程式 - Analytics 中
 
 框架很重要：擴充功能不是通用的“做你想做的”沙箱。它是一個**迷你應用程式，擴充功能了特定範本**（郵件、分析、行事曆、剪輯、設計）並使用該範本的 actions 和資料。郵件擴充功能可以讀取電子郵件。 Analytics 擴充功能讀取儀表板的指標。行事曆擴充功能作用於開啟的事件。它們感覺像是主機產品的一部分，因為它們*是*主機產品的一部分。
 
+> **擴充功能用來新增 UI，而不會重寫主應用程式的 UI。** 擴充功能會顯示在
+> 自己的頁面中，或顯示在範本公開的具名[插槽](#slots)中。它無法將元素注入
+> 任意原生元件中——例如顯示在行事曆的每位與會者旁邊——除非範本在該位置
+> 公開了插槽。如需更深入的自訂，請讓代理編輯範本的原始碼。完整的程式碼
+> 自訂是 Agent Native 的核心能力；擴充功能則是快速、無需部署的自訂層。
+
 使擴充功能發揮作用的三件事：
 
 - **無需程式碼，無需部署。** 代理編寫它們並且它們在幾秒鐘內即可生效。儲存在資料庫中，而不是儲存庫中。

package/docs/content/locales/zh-TW/messaging.mdx

@@ -1,11 +1,15 @@
 ---
 title: "訊息傳遞"
-description: "透過 Slack、電子郵件、Telegram 或 WhatsApp 與您的代理交談 — 相同的代理、相同的記憶、相同的工具。"
+description: "透過 Slack、Microsoft Teams、Discord 互動、電子郵件、Telegram 或 WhatsApp 與您的代理交談。"
 ---
 
 # 訊息傳遞
 
-將您的代理連線到 Slack、電子郵件、Telegram 或 WhatsApp，以便您可以透過您已使用的應用程式與其聊天。這是同一個代理——相同的記憶、相同的工具、相同的對話串——只是可以從更多的地方存取。
+將您的代理連線到 Slack、Microsoft Teams、Discord 互動、電子郵件、Telegram 或 WhatsApp。它仍使用相同的記憶、工具和對話紀錄。
+
+> **準確的支援範圍：** Teams 會驗證官方 Bot Framework JWT，並回覆原始對話。Discord 支援透過 Ed25519 簽署的 HTTP 互動執行斜線命令和延遲確認；一般伺服器訊息和私訊仍需要 Gateway 執行階段。Telegram 會保留 `message_thread_id`，WhatsApp 會使用傳入的 `wamid` 傳送情境回覆。
+>
+> Teams 需要 `MICROSOFT_TEAMS_APP_ID`、`MICROSOFT_TEAMS_APP_PASSWORD` 和 `MICROSOFT_TEAMS_ALLOWED_TENANT_IDS`。Discord 需要 `DISCORD_APPLICATION_ID` 和 `DISCORD_PUBLIC_KEY`。Telegram 還需要 `TELEGRAM_WEBHOOK_SECRET`，WhatsApp 還需要 `WHATSAPP_APP_SECRET`。
 
 > **使用調度範本？** 所有這些都已在 **設定 → 訊息傳送** 中為您做好準備。點選以連線每個平台 - 您無需閱讀本頁面的其餘部分，除非您正在自訂或建置自己的範本。請參閱 [Dispatch](/docs/dispatch) 或 [Dispatch template reference](/docs/template-dispatch)。
 
@@ -78,7 +82,6 @@ description: "透過 Slack、電子郵件、Telegram 或 WhatsApp 與您的代
    - `chat:write` — 讓代理傳送訊息
    - `app_mentions:read` — 讓代理看到它何時被@提及（可選）
    - `im:history` — 讓代理讀取傳送給它的 DM
-   - `assistant:write` — 可選；讓 Slack 在助理對話串中顯示本機“正在思考...”狀態
    - `users:read.email` — 可選；幫助 Mail 等範本驗證 Slack 發件人電子郵件的草稿佇列身分
 3. 點選該頁面頂部的“**安裝到工作區**”。 Slack 將為您提供一個以 `xoxb-` 開頭的 **機器人使用者 OAuth 權杖**。複製它。
 4. 轉到側邊欄中的**基本資訊**並複製**簽名金鑰**。
@@ -123,12 +126,70 @@ Slack 應用程式有一個事件 API 請求 URL。如果同一個 Slack 應用
 
 ### 提示
 
-- **頻道提及** - 機器人僅在被@提及時在頻道中做出回應，以避免噪音。
-- **私信** — 每個私信都被視為與代理的私人對話。
-- **相同的身分，所有管道** — 如果 Slack 使用者與您應用中的註冊使用者具有相同的電子郵件地址，則代理會將他們視為同一個人。
+- **頻道提及** - 使用 @mention 開始工作。只有同一對話串仍有進行中的任務時，未提及機器人的回覆才會繼續任務。
+- **私訊** — 已接受的個人私訊屬於私密對話，並要求已驗證的組織成員或已連結的 Slack 身分。
+- **身分** — 私訊可把驗證過的 Slack 電子郵件對應至同一應用使用者；受管理頻道使用自己的服務身分和政策。
 - **正式環境允許清單** — 設定 `SLACK_ALLOWED_TEAM_IDS`，對於共用 Slack 應用，設定 `SLACK_ALLOWED_API_APP_IDS`，以便有效的簽名金鑰無法被意外的工作區重複使用。
 - **Clips 應用程式展開** — 適用於 Slack 的可安裝 Agent-Native Clips 使用 `SLACK_CLIENT_ID`、`SLACK_CLIENT_SECRET`、`SLACK_SIGNING_SECRET` 和 `/api/slack/oauth/callback`。每個連線的 Slack 工作空間都會在 `app_secrets` 中獲得自己的加密機器人權杖； `SLACK_BOT_TOKEN` 只是傳統的單一工作區後備方案。
 
+### 受管理的 Add to Slack
+
+建議使用受管理的 OAuth。在**設定 → 訊息**中選擇 **Agent manifest**，下載目前主機專用的
+`agent-native-slack-manifest.json`，再從 Slack 的 **App Manifest** 匯入。
+此清單會啟用目前的 `agent_view` 體驗，以及可寫入的 **Messages** 私訊分頁。
+請確認包含以下 Bot Token Scopes：
+
+應用程式圖示不包含在清單中。請在 **Basic Information → Display Information** 上傳
+Agent Native 圖示，讓 Agents 選擇器符合產品品牌。可以使用應用程式公開的
+`icon-512.svg` 作為來源，並在需要時轉換成 Slack 支援的上傳格式。
+
+```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
+```
+
+將 OAuth Redirect URL 設為
+`https://your-app.example.com/_agent-native/integrations/slack/oauth/callback`，
+Event Subscriptions Request URL 設為
+`https://your-app.example.com/_agent-native/integrations/slack/webhook`，
+Interactivity Request URL 設為
+`https://your-app.example.com/_agent-native/integrations/slack/interactions`。
+訂閱 `app_home_opened`、`app_context_changed`、`app_mention`、
+`message.channels`、`message.groups`、`message.im` 和 `message.mpim`。
+設定 `SLACK_CLIENT_ID`、`SLACK_CLIENT_SECRET` 和
+`SLACK_SIGNING_SECRET` 後，在**設定 → 訊息**中點選 **Add to Slack**。
+每個安裝使用獨立的加密權杖，並依工作區、應用、頻道和對話串隔離會話鍵。
+
+變更清單、權限範圍、事件、Agent view 或 Messages 分頁後，請重新安裝 Slack 應用程式。
+`app_home_opened` 用來偵測私訊是否開啟，`app_context_changed` 提供目前檢視的 Slack
+內容，`message.im` 負責傳遞私訊。Slack 管理員可以為整個組織隱藏已安裝的代理，
+每位成員也可從自己的頂端列隱藏代理。若安裝成功但未顯示代理，請檢查這些顯示
+設定，或從 **Tools → Apps** 開啟。
+
+個人 Slack 私訊只接受已驗證的 Agent Native 組織成員，或已連結到該成員的 Slack
+身分。頻道服務主體的政策與預算會和個人身分分開管理。
+
+未提及機器人的回覆只會繼續進行中的對話串；一般頻道聊天不會呼叫代理。有限內容
+包含反應和檔案參照，原生任務卡顯示計畫、進度、取消與核准/拒絕。私訊使用個人
+身分；受管理頻道使用明確的服務身分，以及訪客、Slack Connect 和模型政策。
+頻道記憶只在明確要求時儲存或刪除，絕不自動記憶。在頻道中建立的例程會把結果
+送回同一 Slack。組織、請求者與頻道的每日或每月預算會連同完整稽核脈絡一起執行。
+`assistant:write` 會啟用 Agent View 內容事件；`chat:write` 用於回覆與即時狀態更新。
+
 ## 設定 Telegram {#telegram}
 
 ### 您需要什麼
@@ -435,7 +496,9 @@ POST /_agent-native/integrations/telegram/setup
 | 電子郵件 | `EMAIL_AGENT_ADDRESS`，加上 `RESEND_API_KEY` 或 `SENDGRID_API_KEY` 之一      | `EMAIL_INBOUND_WEBHOOK_SECRET`                        |
 | WhatsApp | `WHATSAPP_ACCESS_TOKEN`, `WHATSAPP_VERIFY_TOKEN`, `WHATSAPP_PHONE_NUMBER_ID` | —                                                     |
 
-所有憑證都存在於環境變數中——不是資料庫，也不是來源程式碼。使用側邊欄設定 UI 或託管提供者的環境面板。
+整合憑證會先從整合擁有者的範圍限定密鑰中解析（使用者、組織、再到工作區）；部署環境變數是本機或刻意單一租戶部署的後備方案。設定 UI 會儲存範圍限定密鑰；值絕不會傳回瀏覽器，也不會存入來源程式碼。
+
+內建執行階段轉接器包含 **Slack**、**Telegram**、**WhatsApp Cloud API** 和提供者 webhook 電子郵件（Resend 或 SendGrid）。在實作並註冊已驗證的轉接器之前，Discord 和 Microsoft Teams 無法連線。
 
 ### 對話串和身分 {#threading-and-identity}
 
@@ -481,13 +544,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 +570,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 +601,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/zh-TW/template-clips.mdx

@@ -77,6 +77,7 @@ search: "Clips 瀏覽器記錄 開發人員記錄 主控台記錄 網路記錄
 ## 你可以用它做什麼
 
 - **使用內建錄音機、網路攝影機覆蓋、音訊捕獲和暫停/修剪來錄製螢幕**。
+- **匯入公開的 Loom 影片。** 在網頁版選擇 **錄製 → 匯入 Loom**，然後貼上 Loom 分享或嵌入 URL。Clips 會將副本儲存到你的媒體庫，並在可用時匯入公開的逐字稿。
 - **從行事曆中捕獲會議。** 連線 Google Calendar，在側邊欄中檢視即將舉行的會議，並在任何一個會議上進行紀錄。您將在結束時獲得即時紀錄以及 AI 摘要、專案符號註解和行動項目。
 - **一鍵通聽寫。** 按住機器上的 Fn，說話，清理後的文字就會放入您正在使用的任何應用程式中。每個聽寫都儲存在可搜尋的歷史紀錄中，原始版本和人工智慧清理的版本並排儲存。
 - **為每個錄音取得自動產生的標題、摘要和章節標記** - 代理會填寫這些內容並使其保持最新狀態。

package/docs/content/locales/zh-TW/template-design.mdx

@@ -89,6 +89,7 @@ Design 是一家 Agent-Native HTML 原型工作室。該代理不是分層繪圖
 ## 你可以用它做什麼
 
 - **產生完整的原型。**描述您需要的螢幕或頁面，代理將建立一個具有 Tailwind 樣式和 Alpine interactions 的工作 HTML 檔案。
+- **從可重複使用的範本開始。** 為廣告、單頁文件、到達頁面等選擇固定尺寸的起點，或將任何內嵌設計儲存為範本。提示只會調整副本中未鎖定的內容，鎖定的標誌與背景會保持不變。
 - **比較變體。**從多個方向開始，選取最強的一個，然後繼續完善。
 - **視覺上的調整。**使用內建的調整控制項進行常見更改，或向代理詢問副本、布局、顏色、間距和互動更新。
 - **應用設計系統。**儲存並重用設計系統偏好設定，以便產生的作品更貼近您的品牌。