@agent-native/core 0.92.12 → 0.94.0

package/corpus/core/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

package/corpus/core/docs/content/locales/pt-BR/skills-guide.mdx

@@ -5,7 +5,7 @@ description: "Como o skills funciona no agente nativo: estrutura skills, domíni
 
 # Guia Skills
 
-Skills são arquivos Markdown que fornecem ao agente conhecimento profundo sobre padrões e fluxos de trabalho específicos.
+Skills são arquivos Markdown que dão ao agente conhecimento profundo sobre padrões e fluxos de trabalho específicos. Em vez de concentrar todas as regras em um único prompt de sistema, você divide o conhecimento em arquivos focados que o agente carrega somente quando uma tarefa realmente precisa deles. Assim, o contexto padrão permanece pequeno, sem impedir que o agente se aprofunde sob demanda.
 
 ## O que são skills {#what-are-skills}
 
@@ -120,9 +120,11 @@ O domínio skills segue o mesmo formato do framework skills. Eles codificam padr
 
 As skills com suporte de app atuais incluem `visual-plan`, `visual-recap` e `visualize-repo` do Plan, `visual-edit` do Design, `assets` do Assets e `content` para edição docs/blog/MDX apoiada pelo repositório.
 
-O skills apoiado por aplicativo empacota um aplicativo nativo do agente como um artefato do mercado de habilidades. O pacote pode incluir instruções do agente, metadados exportados do conector skills, MCP, instruções de inicialização hospedadas/locais e superfícies UI, como aplicativos MCP.
+<Callout tone="info">
 
-> **Detalhes completos abaixo:** a mecânica do skills baseado em aplicativo (formato de manifesto, comandos CLI, adaptadores de mercado, hash de atualização automática) é abordada em [App-backed skills — full details](#app-backed-skills-full).
+**Detalhes completos abaixo:** a mecânica do skills baseado em aplicativo (formato de manifesto, comandos CLI, adaptadores de mercado, hash de atualização automática) é abordada em [App-backed skills — full details](#app-backed-skills-full).
+
+</Callout>
 
 ## Criando skills personalizado {#creating-skills}
 
@@ -177,7 +179,11 @@ Os frontmatter `name` e `description` são usados ​​pelo sistema de ferramen
 
 Salve o arquivo em `.agents/skills/my-skill/SKILL.md`. O nome do diretório deve corresponder ao `name` no frontmatter.
 
-> **Veja também:** [Writing Agent Instructions](/docs/writing-agent-instructions) para saber como redigir descrições de habilidades, aplicar divulgação progressiva e manter `AGENTS.md` enxuto. Ambas as páginas usam a habilidade `project-imports` como exemplo de execução.
+<Callout tone="info">
+
+**Veja também:** [Writing Agent Instructions](/docs/writing-agent-instructions) para saber como redigir descrições de habilidades, aplicar divulgação progressiva e manter `AGENTS.md` enxuto. Ambas as páginas usam a habilidade `project-imports` como exemplo de execução.
+
+</Callout>
 
 ## Escopo da habilidade: tempo de execução vs desenvolvimento {#skill-scope}
 
@@ -267,33 +273,37 @@ Isso substitui o antigo hack de confiar na leitura do código Claude apenas `.cl
 
 </Diagram>
 
-> **Veja também:** [Writing Agent Instructions](/docs/writing-agent-instructions) para saber como redigir descrições de habilidades, aplicar divulgação progressiva e manter `AGENTS.md` enxuto.
-
 ## Skills versus AGENTS.md {#skills-vs-agents-md}
 
-> **AGENTS.md** — A visão geral. Lista todos os scripts, descreve o modelo de dados e explica a arquitetura do aplicativo. O agente lê isso primeiro para entender o aplicativo.
->
-> **Skills** — Mergulhos profundos. Cada habilidade se concentra em um padrão com regras detalhadas, exemplos de código e listas de fazer/não fazer. O agente os lê quando precisa seguir um padrão específico.
+<Callout tone="info">
+
+**AGENTS.md** — A visão geral. Lista todos os scripts, descreve o modelo de dados e explica a arquitetura do aplicativo. O agente lê isso primeiro para entender o aplicativo.
+
+**Skills** — Mergulhos profundos. Cada habilidade se concentra em um padrão com regras detalhadas, exemplos de código e listas de fazer/não fazer. O agente os lê quando precisa seguir um padrão específico.
+
+</Callout>
 
 `AGENTS.md` informa ao agente _o que_ o aplicativo faz. Skills diz ao agente _como_ fazer coisas específicas corretamente. Ambos são necessários — `AGENTS.md` para orientação, skills para execução.
 
 ## Skills versus memória {#skills-vs-memory}
 
-> **Skills** — Guias de instruções reutilizáveis e de autoria. Aplica-se a todos os usuários, invocado sob demanda quando a tarefa corresponde.
->
-> **Memória (`LEARNINGS.md`/`memory/MEMORY.md`)** — Aprendizados compartilhados do projeto e memória estruturada pessoal carregada a cada turno.
+<Callout tone="info">
+
+**Skills** — Guias de instruções reutilizáveis e de autoria. Aplica-se a todos os usuários, invocado sob demanda quando a tarefa corresponde.
+
+**Memória (`LEARNINGS.md`/`memory/MEMORY.md`)** — Aprendizados compartilhados do projeto e memória estruturada pessoal carregada a cada turno.
+
+</Callout>
 
 Se o conhecimento se aplica a _todos_ que trabalham no aplicativo ("sempre prefira CTEs a subconsultas"), é uma habilidade ou `LEARNINGS.md` compartilhado. Se for sobre _este usuário específico_ ("Steve gosta de respostas concisas"), ele pertence a `memory/MEMORY.md`. Consulte [Workspace Memory](/docs/workspace#memory) para o tratamento completo.
 
----
+## Skills versus recursos SQL {#skills-vs-resources}
 
-# Avançado
+Esta página apresenta um skill como um arquivo em `.agents/skills/<name>/SKILL.md`. [Workspace](/docs/workspace#skills) apresenta o mesmo skill como um recurso SQL no caminho `skills/<slug>/SKILL.md`, com escopo de workspace, compartilhado ou pessoal. Trata-se do mesmo conceito sob dois ângulos: o modo Code lê e grava o arquivo diretamente; o modo App o armazena como uma linha de recurso para funcionar sem um sistema de arquivos. Em ambos os casos, escreva o conteúdo no formato desta página.
 
 ## skills com suporte de aplicativo — detalhes completos {#app-backed-skills-full}
 
-O skills apoiado por aplicativo empacota um aplicativo nativo do agente como um artefato do mercado de habilidades.
-O pacote pode incluir instruções do agente, skills exportado, conector MCP
-metadados, instruções de inicialização hospedadas/locais e superfícies UI, como aplicativos MCP.
+O formato do manifesto, os comandos CLI, os adaptadores de marketplace e o hash de atualização automática por trás dos [skills baseados em aplicativo](#app-backed-skills), em detalhes:
 
 Cada habilidade apoiada pelo aplicativo começa com `agent-native.app-skill.json` na raiz do aplicativo:
 
@@ -410,3 +420,10 @@ npx @agent-native/core@latest skills update scaffold --project
 `AGENTS.md` e `.agents/skills` permanecem canônicos. O comando update também repara
 Links de compatibilidade Claude (`CLAUDE.md` e `.claude/skills`) para que o código Claude seja visto
 as mesmas instruções sem manter uma segunda cópia.
+
+## Próximos passos {#whats-next}
+
+- [**Escrever instruções do agente**](/docs/writing-agent-instructions) — redigir descrições de skills e dividir a orientação entre AGENTS.md, skills e memória
+- [**Workspace**](/docs/workspace#skills) — onde os skills ficam como recursos SQL no modo App
+- [**Menções de agentes**](/docs/agent-mentions) — o acionador de comando `/` que invoca um skill no chat
+- [**Plugin e marketplace do Plan**](/docs/plan-plugin) — fluxo completo de instalação e atualização automática de um skill real baseado em aplicativo

package/corpus/core/docs/content/locales/pt-BR/template-assets.mdx

@@ -92,6 +92,18 @@ Ao abrir o aplicativo, a biblioteca selecionada, o prompt, as referências e os
 - **Outros aplicativos precisam de um seletor ou gerador de recursos** — Slides, Design, Conteúdo, um editor de blog ou um construtor de sites podem incorporar o seletor ou chamar Assets por A2A.
 - **Você deseja que a mídia da marca seja disponibilizada pelo seu agente de codificação** — Codex, Claude Code, Claude ou ChatGPT podem gerar e selecionar recursos sem sair do chat.
 
+## O que você pode fazer com isso
+
+- **Crie bibliotecas de recursos.** Agrupe imagens de referência, vídeos, logotipos canônicos, notas de estilo, paletas, pastas e resultados gerados por marca, campanha, produto ou categoria.
+- **Gerar por meio de bate-papo.** O compositor inicial e os controles Gerar da biblioteca enviam o prompt ao agente com `sendToAgentChat()`, para que os usuários possam inspecionar variantes, fornecer feedback e iterar.
+- **Gere imagens e vídeos.** A geração de imagens gerenciadas pelo Builder está disponível quando ativada, e o Gemini potencializa a geração de vídeo e o substituto manual de imagens.
+- **Carregue e descreva referências.** Adicione imagens ou vídeos da biblioteca UI ou solicite o botão de anexo do compositor e pesquise por título, descrição, texto alternativo, prompt, modelo, tipo de mídia, status, função, pasta ou coleção.
+- **Mantenha um registro de auditoria de geração.** Cada execução registra prompts, modelo, proporção, referências, ativo de origem, linhagem, ativos gerados, status, erros e carimbos de data/hora para revisão posterior do projeto.
+- **Preserva a precisão do logotipo.** O agente pode gerar uma área de espaço reservado e o servidor compõe o logotipo canônico carregado na imagem final, em vez de depender do modelo de imagem para redesenhá-lo.
+- **Incorporado como um seletor.** Outros aplicativos podem criar iframe `/picker` e ouvir o evento `chooseAsset` de `@agent-native/embedding`, transformando o Assets em um seletor/gerador de ativos para editores de blog, construtores de sites, apresentações de slides e aplicativos personalizados. O seletor também emite o alias herdado `chooseImage` para hosts somente de imagem existentes.
+- **Instalar como uma habilidade apoiada por aplicativo.** O manifesto `agent-native.app-skill.json` exporta uma habilidade de Ativos mais metadados do conector MCP para que os mercados possam instalar o aplicativo, suas instruções e seu seletor juntos.
+- **Servir outros agentes.** Slides, Design, Content, Mail e Dispatch podem chamar recursos por meio de A2A para listar bibliotecas, gerar lotes, criar vídeos, refinar um recurso, buscar exportações e renderizar visualizações in-line onde a incorporação é permitida.
+
 ## Primeiros passos
 
 Demonstração ao vivo: [assets.agent-native.com](https://assets.agent-native.com).
@@ -114,18 +126,6 @@ Demonstração ao vivo: [assets.agent-native.com](https://assets.agent-native.co
 - "Transforme este diagrama enviado em uma imagem explicativa do produto mais limpa."
 - "Crie um storyboard de vídeo e salve o melhor conjunto de quadros nesta biblioteca."
 
-## O que você pode fazer com isso
-
-- **Crie bibliotecas de recursos.** Agrupe imagens de referência, vídeos, logotipos canônicos, notas de estilo, paletas, pastas e resultados gerados por marca, campanha, produto ou categoria.
-- **Gerar por meio de bate-papo.** O compositor inicial e os controles Gerar da biblioteca enviam o prompt ao agente com `sendToAgentChat()`, para que os usuários possam inspecionar variantes, fornecer feedback e iterar.
-- **Gere imagens e vídeos.** A geração de imagens gerenciadas pelo Builder está disponível quando ativada, e o Gemini potencializa a geração de vídeo e o substituto manual de imagens.
-- **Carregue e descreva referências.** Adicione imagens ou vídeos da biblioteca UI ou solicite o botão de anexo do compositor e pesquise por título, descrição, texto alternativo, prompt, modelo, tipo de mídia, status, função, pasta ou coleção.
-- **Mantenha um registro de auditoria de geração.** Cada execução registra prompts, modelo, proporção, referências, ativo de origem, linhagem, ativos gerados, status, erros e carimbos de data/hora para revisão posterior do projeto.
-- **Preserva a precisão do logotipo.** O agente pode gerar uma área de espaço reservado e o servidor compõe o logotipo canônico carregado na imagem final, em vez de depender do modelo de imagem para redesenhá-lo.
-- **Incorporado como um seletor.** Outros aplicativos podem criar iframe `/picker` e ouvir o evento `chooseAsset` de `@agent-native/embedding`, transformando o Assets em um seletor/gerador de ativos para editores de blog, construtores de sites, apresentações de slides e aplicativos personalizados. O seletor também emite o alias herdado `chooseImage` para hosts somente de imagem existentes.
-- **Instalar como uma habilidade apoiada por aplicativo.** O manifesto `agent-native.app-skill.json` exporta uma habilidade de Ativos mais metadados do conector MCP para que os mercados possam instalar o aplicativo, suas instruções e seu seletor juntos.
-- **Servir outros agentes.** Slides, Design, Content, Mail e Dispatch podem chamar recursos por meio de A2A para listar bibliotecas, gerar lotes, criar vídeos, refinar um recurso, buscar exportações e renderizar visualizações in-line onde a incorporação é permitida.
-
 ## Usando-o do seu agente de codificação
 
 Gere e escolha mídia de marca sem sair do código Codex, Claude, Claude ou ChatGPT.
@@ -168,10 +168,13 @@ Gere e escolha mídia de marca sem sair do código Codex, Claude, Claude ou Chat
 
 O restante deste documento é para qualquer pessoa que faça bifurcação do modelo Assets ou estenda-o.
 
-### Andaimes
+### Início rápido
 
 ```bash
 npx @agent-native/core@latest create my-assets --standalone --template assets
+cd my-assets
+pnpm install
+pnpm dev
 ```
 
 ### Modelo de dados

package/corpus/core/docs/content/locales/pt-BR/template-brain.mdx

@@ -205,7 +205,7 @@ Postgres, Neon, D1, Turso e hosts semelhantes. O estado do aplicativo reflete o
 rota atual, filtros e IDs selecionados para que o agente sempre saiba a rota atual
 navegação e seleção.
 
-O esquema do cérebro reside em `templates/brain/server/db/schema.ts`. Oito tabelas:
+O esquema do cérebro reside em `templates/brain/server/db/schema.ts`. Nove tabelas:
 
 | Tabela                   | O que ele contém                                                                                                                                             |
 | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
@@ -553,3 +553,5 @@ Peça ao agente para fazer alterações para você — ele pode editar sua próp
 - [**Dispatch template**](/docs/template-dispatch) — o aplicativo de coordenação de andaimes
 - [**Workspace**](/docs/workspace) — recursos compartilhados entre aplicativos
 - [**A2A Protocol**](/docs/a2a-protocol) — delegação entre aplicativos
+- [**Modelos**](/docs/cloneable-saas) — o modelo de clonar e possuir e todos os outros modelos de domínio para começar
+- [**Primeiros passos**](/docs/getting-started) — os fundamentos do framework: actions, estado da aplicação e sincronização em tempo real

package/corpus/core/docs/content/locales/pt-BR/template-clips.mdx

@@ -17,7 +17,7 @@ Um aplicativo que captura tudo: gravações de tela, notas de reuniões do seu c
   />
 </WireframeBlock>
 
-Pense nos moldes de Loom + Granola + Wispr Flow reunidos em um aplicativo - mas o agente é um editor de primeira classe em todas as superfícies, e as gravações, reuniões e ditados são seus, não de um fornecedor de SaaS. O Clips também torna as gravações compartilhadas legíveis pelo agente: cole um link de compartilhamento normal do Clips em um agente e ele poderá "ouvir" a transcrição como texto e "ver" os quadros de tela com carimbo de data e hora como imagens - sem necessidade de vídeo bruto. A visualização de quadros funciona em qualquer agente com capacidade de imagem (ChatGPT, Código Claude, Cursor, Codex); os bate-papos na web somente de texto ainda recebem a transcrição completa e podem levar um quadro que você carrega.
+Gravações de tela assíncronas, notas de reuniões sincronizadas com o calendário e ditado por pressionar para falar reunidos em um só aplicativo — o agente é um editor de primeira classe em todas as superfícies, e as gravações, reuniões e ditados são seus, não de um fornecedor de SaaS. O Clips também torna as gravações compartilhadas legíveis por agentes: cole um link público de compartilhamento do Clips ou um link temporário **Copiar para o agente** em um agente, e ele poderá "ouvir" a transcrição como texto e "ver" quadros de tela com marcação de tempo como imagens, sem precisar do vídeo bruto. A visualização de quadros funciona em qualquer agente com capacidade de imagem (ChatGPT, Claude Code, Cursor, Codex); chats web somente de texto ainda recebem a transcrição completa e podem usar um quadro que você enviar.
 
 <Diagram id="doc-block-1lenkc" title="Capture, transcreva, reutilize" summary={"Três tipos de captura pousam em uma biblioteca; o agente transcreve, titula e resume, então cada transcrição pode ser pesquisada e compartilhada."}>
 
@@ -77,12 +77,13 @@ 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.
 - **Pesquise todas as transcrições** — gravações de tela, reuniões e ditados, tudo em uma biblioteca. "Encontre o clipe em que discutimos o plano de implementação."
 - **Compartilhe clipes** com permissões por clipe (público, equipe, privado). O rastreamento de links e os comentários encadeados também funcionam.
-- **Visualize clipes públicos em Slack** com um desdobramento jogável no estilo Loom após o
+- **Visualize clipes públicos no Slack** com uma prévia de vídeo reproduzível depois que
   a área de trabalho instala seu aplicativo Clips Slack.
 - **Capturar registros do navegador com a extensão do Chrome.** As gravações do navegador podem
   anexe logs de console editados e metadados fetch/XHR, que são úteis para
@@ -507,7 +508,7 @@ As rotas no UI ficam em `templates/clips/app/routes/` — o aplicativo autentica
 
 ### Chave actions
 
-Cada operação que pode ser chamada pelo agente é um arquivo TypeScript em `templates/clips/actions/`, montado automaticamente em `POST /_agent-native/actions/:name` e executável a partir de CLI como `pnpm action <name>`. Existem ~80 actions; os agrupamentos úteis:
+Cada operação que pode ser chamada pelo agente é um arquivo TypeScript em `templates/clips/actions/`, montado automaticamente em `POST /_agent-native/actions/:name` e executável a partir de CLI como `pnpm action <name>`. Existem cerca de 100 actions; os agrupamentos úteis:
 
 - **Ciclo de vida de gravação** — `create-recording`, `finalize-recording`, `update-recording`, `set-thumbnail`, `archive-recording` / `restore-recording` / `trash-recording` / `delete-recording-permanent`, `move-recording`, `tag-recording`.
 - **Transcrição e IA** — `request-transcript`, `cleanup-transcript`, `regenerate-title` / `regenerate-summary` / `regenerate-chapters`, `set-chapters`, `generate-workflow`. (`cleanup-transcript` e `finalize-meeting` são chamadas de pipeline de mídia do lado do servidor; a maioria dos outros recursos de IA são delegados ao chat do agente.)

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

@@ -11,7 +11,7 @@ Design é um estúdio de prototipagem HTML nativo do agente. Em vez de uma tela
   <Screen
     surface="desktop"
     html={
-      "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Página de lançamento do produto</h1><span class='wf-pill accent'>Desktop</span><span class='wf-pill'>Tablet</span><span class='wf-pill'>Mobile</span><div style='flex:1'></div><button>Preview</button><button class='primary'>Export code</button></div><div class='wf-card' style='flex:1;display:grid;grid-template-rows:auto 1fr auto;gap:12px'><div style='display:flex;gap:8px'><span class='wf-pill accent'>Hero</span><span class='wf-pill'>Pricing</span><span class='wf-pill'>FAQ</span></div><div class='wf-box' style='display:flex;align-items:center;justify-content:center;min-height:230px'><strong>Protótipo HTML gerado</strong></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span class='wf-muted'>Deixe o hero mais denso e o CTA mais claro.</span><div style='flex:1'></div><button class='primary'>Aplicar revisão</button></div></div></div>"
+      "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Página de lançamento do produto</h1><span class='wf-pill accent'>Desktop</span><span class='wf-pill'>Tablet</span><span class='wf-pill'>Mobile</span><div style='flex:1'></div><button>Preview</button><button class='primary'>Export code</button></div><div class='wf-card' style='flex:1;display:grid;grid-template-rows:auto 1fr auto;gap:12px'><div style='display:flex;gap:8px'><span class='wf-pill accent'>Hero</span><span class='wf-pill'>Pricing</span><span class='wf-pill'>FAQ</span></div><div class='wf-box' style='display:flex;flex-direction:column;gap:12px;min-height:230px;padding:20px'><div style='display:flex;flex-direction:column;align-items:center;gap:8px;text-align:center'><strong style='font-size:22px'>Lance mais rápido com Agent-Native</strong><span class='wf-muted' style='max-width:70%'>Gere um protótipo funcional a partir de um prompt e refine-o no próprio lugar.</span><button class='primary'>Começar</button></div><div style='display:grid;grid-template-columns:repeat(3,1fr);gap:10px;flex:1'><div class='wf-card' style='min-height:56px'></div><div class='wf-card' style='min-height:56px'></div><div class='wf-card' style='min-height:56px'></div></div></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span class='wf-muted'>Deixe o hero mais denso e o CTA mais claro.</span><div style='flex:1'></div><button class='primary'>Aplicar revisão</button></div></div></div>"
     }
   />
 </WireframeBlock>
@@ -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.
@@ -133,6 +134,8 @@ pnpm dev
 
 Todos os dados residem em SQL com Drizzle ORM. Esquema: `templates/design/server/db/schema.ts`. Os designs e sistemas de design carregam o padrão `ownableColumns` e uma tabela de compartilhamentos de estrutura correspondente, para que eles se encaixem no modelo de compartilhamento por usuário/por organização.
 
+A tabela abaixo abrange os principais recursos com proprietário: designs, arquivos, modelos, versões e sistemas de design. Outras sete tabelas no mesmo esquema dão suporte a recursos descritos em outras partes deste documento, em vez do modelo de recursos principal: `design_localhost_connections` e `design_localhost_write_grants` (modo de origem localhost), `component_index` (indexação de componentes), `motion_timeline` (movimento), `design_state` (instantâneos do estado do editor), `design_fusion_edits` (modo de fusão do aplicativo completo) e `design_review_snapshot` (instantâneos de revisão).
+
 | Tabela                                   | O que ele contém                                                                                                                              |
 | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
 | `designs`                                | Um projeto de design — `title`, `description`, `project_type` (`prototype`/`other`), o blob `data` JSON e um link `design_system_id` opcional |

package/corpus/core/docs/content/locales/pt-BR/template-dispatch.mdx

@@ -5,7 +5,11 @@ description: "Dispatch é o plano de controle do espaço de trabalho: caixa de e
 
 # Envio
 
-> **Veja também:** para uma visão geral conceitual do que o Dispatch faz e quando você deseja, consulte [Dispatch](/docs/dispatch). Esta página é a referência específica do modelo.
+<Callout tone="info">
+
+**Veja também:** para uma visão geral conceitual do que o Dispatch faz e quando você deseja, consulte [Dispatch](/docs/dispatch). Esta página é a referência específica do modelo.
+
+</Callout>
 
 Dispatch é o **plano de controle do espaço de trabalho**. Enquanto outros modelos são aplicativos de domínio (Mail, Calendar, Analytics, Brain), o Dispatch é o aplicativo que você executa _juntamente_ com eles para coordenar tudo: uma caixa de entrada central, um cofre de segredos, trabalhos agendados, integração Slack/Telegram e um agente orquestrador que delega o trabalho do domínio ao aplicativo especializado certo por meio de [A2A](/docs/a2a-protocol).
 

package/corpus/core/docs/content/locales/pt-BR/template-mail.mdx

@@ -362,3 +362,11 @@ O correio é seu para alterar. Tudo o que é importante reside em alguns lugares
 **Alteração de atalhos de teclado.** Manipuladores de atalhos de teclado ficam em `templates/mail/app/components/email/`. Pesquise `useHotkeys` ou `addEventListener("keydown"` para descobrir onde cada tecla está conectada.
 
 Peça ao agente para fazer qualquer uma dessas alterações para você. O agente pode editar sua própria fonte — consulte [Self-Modifying Code](/docs/key-concepts#agent-modifies-code).
+
+## O que vem a seguir
+
+- [**Modelos**](/docs/cloneable-saas) — o modelo de clonar e possuir, além de todos os outros modelos de domínio para começar
+- [**Primeiros passos**](/docs/getting-started) — os fundamentos da estrutura: ações, estado do aplicativo e sincronização ao vivo
+- [**Calendário**](/docs/template-calendar) — um modelo de domínio relacionado para agendamento e reservas
+- [**Automações**](/docs/automations) — o mecanismo acionado por eventos sobre o qual as regras de triagem automática do Mail são criadas
+- [**Ações**](/docs/actions) — o sistema de ações que chat, atalhos e automações chamam

package/corpus/core/docs/content/locales/pt-BR/tracking.mdx

@@ -127,6 +127,8 @@ import { defineAction } from "@agent-native/core/action";
 import { track } from "@agent-native/core/tracking";
 import { z } from "zod";
 
+import { getDb, schema } from "../server/db/index.js";
+
 export default defineAction({
   description: "Create a new project.",
   schema: z.object({
@@ -134,14 +136,15 @@ export default defineAction({
     template: z.string().optional(),
   }),
   run: async ({ name, template }, ctx) => {
-    const project = await db
-      .insert(projects)
+    const db = getDb();
+    const [project] = await db
+      .insert(schema.projects)
       .values({ name, template })
       .returning();
 
-    track("project.created", { name, template }, { userId: ctx.userEmail });
+    track("project.created", { name, template }, { userId: ctx?.userEmail });
 
-    return { ok: true, projectId: project[0].id };
+    return { ok: true, projectId: project.id };
   },
 });
 ```
@@ -349,5 +352,5 @@ A estrutura também rastreia `builder connect clicked` de CTAs do Connect Builde
 ## O que vem a seguir
 
 - [**Actions**](/docs/actions) — onde se origina a maioria das chamadas de rastreamento
-- [**Server Plugins**](/docs/server) — `registerBuiltinProviders()` é executado no plugin core-routes na inicialização
-- [**Secrets**](/docs/security) — gerencie chaves API para provedores de rastreamento
+- [**Server Plugins**](/docs/server#server-plugins) — `registerBuiltinProviders()` é executado no plugin core-routes na inicialização
+- [**Segurança — Gerenciamento de segredos**](/docs/security#secrets) — gerencie chaves API para provedores de rastreamento

package/corpus/core/docs/content/locales/pt-BR/using-your-agent.mdx

@@ -92,21 +92,14 @@ Na maioria das vezes você orienta o agente digitando no chat. Duas coisas torna
 
 O agente não é um aplicativo separado que você acessa. Ele é fornecido como um punhado de componentes React – uma barra lateral, um painel bruto e uma chamada `sendToAgentChat()` – que você coloca em qualquer aplicativo. Renderize `<AgentSidebar>` para dar a cada tela um agente alternável ou conecte um botão para entregar uma tarefa específica ao chat em vez de executar uma chamada LLM única.
 
-→ [**Drop-in Agent**](/docs/drop-in-agent) — monte `<AgentPanel>`, `<AgentSidebar>` e `sendToAgentChat()` em qualquer aplicativo React.
-→ [**Agent Surfaces**](/docs/agent-surfaces) — escolha se o fluxo de trabalho deve ser headless, chat-first, incorporado ou um aplicativo completo.
-
 ## Você pode usar UI leve {#ui-light}
 
 Nem todo aplicativo precisa de um painel completo. Quando o agente _é_ o produto, você pode pular a maior parte do UI personalizado: abra o aplicativo, peça o que deseja e deixe o agente fazer o resto. O agente ainda tem sua superfície de gerenciamento (histórico, espaço de trabalho, configurações), mas a interação principal é a conversa, e não os cliques.
 
-→ [**Automation-First Apps**](/docs/pure-agent-apps) — apps sem navegador para jobs, filas, scripts e agents externos.
-
 ## Você coedita com ele {#you-co-edit}
 
 Quando você e o agente estão trabalhando no mesmo documento, vocês não se revezam. Com a colaboração em tempo real, as edições do agente são transmitidas junto com as suas — cursores ativos, sem substituições — da mesma forma que um colega de equipe faria. Você pode continuar digitando enquanto ele funciona e ele verá as alterações conforme elas acontecem.
 
-→ [**Real-Time Collaboration**](/docs/real-time-collaboration) — edição colaborativa multiusuário com cursores ativos e edições de agente no mesmo documento.
-
 ## O que vem a seguir {#whats-next}
 
 - [**Context Awareness**](/docs/context-awareness) — o agente sabe o que você está vendo

package/corpus/core/docs/content/locales/pt-BR/voice-input.mdx

@@ -9,6 +9,12 @@ Todo aplicativo nativo do agente possui um microfone no compositor de bate-papo.
 
 A estrutura lida com tudo isso automaticamente. Os usuários conectados ao Builder obtêm o Gemini Flash-Lite hospedado no Builder por padrão; caso contrário, os usuários poderão trazer sua própria chave de provedor ou recorrer ao reconhecimento de fala do navegador.
 
+## Modo de voz em tempo real {#realtime-speech-mode}
+
+Ao abrir o microfone, um popover permite escolher entre **Conversa em tempo real** e **Ditado editável**. O modo em tempo real exige uma `OPENAI_API_KEY` no escopo do usuário e conecta o navegador ao `gpt-realtime-2.1` por WebRTC. O chat se recolhe em uma esfera de voz no canto inferior direito; clique nela para mostrar ou ocultar o chat sem encerrar a conversa.
+
+O modelo de voz usa as mesmas ferramentas autenticadas do Agent Native que o chat, portanto pode navegar pelo aplicativo e chamar ações enquanto fala. Ações que exigem aprovação permanecem pausadas até você aprová-las. O áudio nunca é armazenado no SQL; o Agent Native mantém apenas um estado compacto da sessão e da transcrição. Uma sessão em tempo real dura no máximo 60 minutos.
+
 ## Como funciona {#how-it-works}
 
 O botão de voz do compositor grava o áudio no navegador e depois escolhe um provedor:

package/corpus/core/docs/content/locales/pt-BR/workspace-connections.mdx

@@ -425,10 +425,9 @@ Não duplique o armazenamento OAuth/token em cada aplicativo. O registro de cone
 
 ### Configuração do plano de controle de despacho
 
-O Dispatch expõe o plano de controle actions que escreve as mesmas funções de armazenamento compartilhado que um aplicativo poderia chamar diretamente:
+O Dispatch expõe actions do plano de controle que usam as mesmas funções de armazenamento compartilhado que um aplicativo poderia chamar diretamente — sua action `upsert-workspace-connection` valida a entrada em relação ao catálogo de provedores e então delega para a mesma `upsertWorkspaceConnection()` mostrada nesta página:
 
 ```ts
-// templates/dispatch/actions/upsert-workspace-connection.ts delegates to this.
 await upsertWorkspaceConnection({
   id: "team-slack",
   provider: "slack",
@@ -493,3 +492,11 @@ O catálogo de provedores e o armazenamento de concessões são a base para uma
 Mantenha os limites rígidos: os metadados do provedor podem ser exibidos com segurança; os valores das credenciais permanecem no cofre.
 
 </details>
+
+## O que vem a seguir {#whats-next}
+
+- [**Dispatch**](/docs/dispatch) — o aplicativo que normalmente gerencia a configuração de conexões do espaço de trabalho e o cofre
+- [**Segurança**](/docs/security) — o cofre de credenciais, o escopo de segredos e o modelo de acesso para os quais as conexões apontam
+- [**Integração**](/docs/onboarding#checking-workspace-connections-in-onboarding) — verificar a prontidão da conexão na lista de configuração de um modelo
+- [**Clientes MCP**](/docs/mcp-clients) — compartilhar credenciais de servidores MCP no espaço de trabalho como um padrão relacionado de configuração reutilizável
+- [**Brain**](/docs/template-brain) — a implementação de referência de uma página Sources de provedores criada sobre este modelo

package/corpus/core/docs/content/locales/pt-BR/workspace.mdx

@@ -5,7 +5,11 @@ description: "Claude – Personalização em nível de código por usuário —
 
 # Espaço de trabalho
 
-> **Qual documento do espaço de trabalho?** Esta página aborda a **camada de personalização** — o que _é_ um espaço de trabalho. Para o formato de implantação (um monorepo, muitos aplicativos), consulte [Multi-App Workspaces](/docs/multi-app-workspace); para governança (quem analisa, aprova e possui o quê), consulte [Workspace Governance](/docs/workspace-management).
+<Callout tone="info">
+
+**Qual documento do espaço de trabalho?** Esta página aborda a **camada de personalização** — o que _é_ um espaço de trabalho. Para o formato de implantação (um monorepo, muitos aplicativos), consulte [Multi-App Workspaces](/docs/multi-app-workspace); para governança (quem analisa, aprova e possui o quê), consulte [Workspace Governance](/docs/workspace-management).
+
+</Callout>
 
 Todo aplicativo nativo do agente vem com um **espaço de trabalho**: a camada de personalização que torna o agente seu. Ele contém instruções de equipe (`AGENTS.md`), aprendizados compartilhados (`LEARNINGS.md`), memória estruturada pessoal (`memory/MEMORY.md`), skills que o agente recebe sob demanda, subagentes personalizados, trabalhos agendados e servidores MCP conectados — tudo o que você esperaria de uma configuração do Código Claude/Codex.
 
@@ -82,7 +86,7 @@ A diferença: **são linhas SQL, não arquivos do sistema de arquivos.** Cada us
 | `CLAUDE.md`/skills por projeto       | `AGENTS.md` por aplicativo + recursos de memória do espaço de trabalho |
 | Configuração MCP em um arquivo JSON  | Configuração MCP em JSON _ou_ as configurações UI, por escopo          |
 
-Mesmas capacidades. Economia diferente. Consulte [Templates](/docs/cloneable-saas) para saber por que isso é importante para SaaS.
+Mesmas capacidades. Economia diferente. Consulte [Aplicativos](/docs/cloneable-saas) para saber por que isso é importante para SaaS.
 
 ## Visão geral {#overview}
 
@@ -219,11 +223,9 @@ workspace context/brand.md
 -> personal context/brand.md
 ```
 
-Mantenha os arquivos `context/` curtos e factuais – alguns pontos que o agente pode ler:
-
-```text
-<!-- context/brand.md -->
+Por exemplo:
 
+```text filename="context/brand.md"
 # Marca
 
 - Voice: direct, warm, concrete
@@ -388,15 +390,9 @@ Existem dois tipos de agentes no Workspace:
 
 Use agentes personalizados para delegação em um aplicativo. Use agentes conectados quando precisar ligar para outro aplicativo por A2A.
 
-## @ Marcação {#at-tagging}
-
-Digite `@` na entrada do chat para fazer referência aos itens do espaço de trabalho. Um menu suspenso aparece no cursor mostrando agentes e arquivos correspondentes. Use as teclas de seta para navegar e Enter para selecionar. O item selecionado aparece como um chip embutido na entrada.
-
-Quando você envia uma mensagem, **arquivos/recursos** são passados como referências que o agente pode ler, **agentes personalizados** são executados localmente com suas instruções de perfil e **agentes conectados** são chamados por A2A.
+## Marcação @ e comandos / {#at-tagging}
 
-## /Comandos de barra {#slash-commands}
-
-Digite `/` no início de uma linha para invocar uma habilidade. Um menu suspenso mostra os skills disponíveis com seus nomes e descrições; selecionar um adiciona um chip embutido e inclui seu conteúdo como contexto quando a mensagem é enviada. Se nenhum skills estiver configurado, o menu suspenso leva a esses documentos.
+Digite `@` na entrada do chat para referenciar um agente, arquivo ou recurso, ou `/` para invocar um skill. Ambos abrem uma lista suspensa no cursor e adicionam um chip em linha quando você seleciona um item. Consulte [Menções de agentes](/docs/agent-mentions) para conhecer toda a mecânica (roteamento, `MentionProvider`, seleção de subagente) e o [Guia Skills](/docs/skills-guide) para saber como os skills são criados e descobertos.
 
 ## Modo Código versus Modo Aplicativo {#dev-vs-prod}
 
@@ -416,10 +412,6 @@ O Workspace Connections permite que os aplicativos compartilhem a mesma conta de
 
 Consulte [Workspace Connections](/docs/workspace-connections) para obter o início rápido, conexão/concessão/redencialRef API e exemplos concretos de Slack, HubSpot e GitHub.
 
----
-
-# Referência
-
 ## Recurso API {#resource-api}
 
 Os recursos podem ser gerenciados a partir do código do servidor, actions ou REST API.
@@ -463,3 +455,12 @@ pnpm action resource-write --path "notes/meeting.md" --content "# Notas da reuni
 # Excluir um recurso
 pnpm action resource-delete --path "notes/old.md"
 ```
+
+## Próximos passos {#whats-next}
+
+- [**Guia Skills**](/docs/skills-guide) — criar e definir o escopo dos arquivos de skill referenciados em `skills/`
+- [**Menções de agentes**](/docs/agent-mentions) — mecânica completa das menções `@` e dos comandos `/`
+- [**Trabalhos recorrentes**](/docs/recurring-jobs) — agendar os prompts criados a partir de tarefas agendadas
+- [**Governança do Workspace**](/docs/workspace-management) — quem revisa, aprova e é responsável pelas alterações no workspace
+- [**Workspaces de vários aplicativos**](/docs/multi-app-workspace) — a forma de implantação abrangida por um workspace
+- [**Conexões do Workspace**](/docs/workspace-connections) — compartilhar credenciais de provedores entre aplicativos

package/corpus/core/docs/content/locales/zh-CN/actions.mdx

@@ -11,7 +11,7 @@ Actions 是您的应用所做的任何事情的唯一事实来源。使用 `defi
 - **类型安全 React 挂钩** - 前端的 `useActionQuery("name")` 和 `useActionMutation("name")`，从架构推断的类型。
 - **命令式客户端调用** — 当钩子不适合时 `callAction("name", params)`。
 - **框架传输** — 由这些钩子后面的框架自动安装，并可供外部 HTTP 客户端使用。
-- **MCP 工具** - 暴露给 Claude、ChatGPT 自定义 MCP 应用、Claude 桌面/代码、光标、Codex 和任何其他 MCP 客户端。
+- **MCP 工具** - 暴露给 Claude、ChatGPT 自定义 MCP 应用、Claude 桌面/代码、光标、Codex 和任何其他 MCP 主机。
 - **A2A 工具** — 由其他代理本机应用通过 A2A 调用。
 - **CLI 命令** - `pnpm action <name>` 用于脚本和开发循环。
 
@@ -560,7 +560,7 @@ export default defineAction({
 });
 ```
 
-保留 `link` 作为 CLI 和非 UI MCP 客户端的后备；这也是嵌入的启动目标。嵌入桥 - 已签名的嵌入启动会话、移植与受控帧渲染、`ui/*` 主桥、CSP 和高度限制 - 归 [External Agents](/docs/external-agents#mcp-app-bridge) 所有。
+保留 `link` 作为 CLI 和非 UI MCP 主机的后备；这也是嵌入的启动目标。嵌入桥 - 已签名的嵌入启动会话、移植与受控帧渲染、`ui/*` 主桥、CSP 和高度限制 - 归 [External Agents](/docs/external-agents#mcp-app-bridge) 所有。
 
 ## 标准actions {#standard-actions}
 

package/corpus/core/docs/content/locales/zh-CN/agent-native-toolkit.mdx

@@ -97,9 +97,9 @@ coherent kit instead of exposing package boundaries in the app.
 
 - [UI Primitives](/docs/toolkit-ui) cover shared shadcn-style primitives under
   `@agent-native/toolkit/ui/*`.
-- [App Adapters](/docs/toolkit-app-adapters) show how apps wrap Toolkit pieces
+- [App Adapters](/docs/toolkit-ui#app-adapters) show how apps wrap Toolkit pieces
   through local `@/components/*` adapters.
-- [Shell & Hooks](/docs/toolkit-shell-hooks) cover header actions, mobile hooks,
+- [Shell & Hooks](/docs/toolkit-ui#shell-hooks) cover header actions, mobile hooks,
   toasts, and small app-shell helpers.
 - [Component API](/docs/components) remains the lower-level reference for the
   public React exports.

package/corpus/core/docs/content/locales/zh-CN/agent-surfaces.mdx

@@ -136,8 +136,7 @@ pnpm install
 
 然后定义持久操作：
 
-```ts
-// actions/summarize-week.ts
+```ts filename="actions/summarize-week.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -488,12 +487,11 @@ iframe/picker 模式，以及较低级别的桥 APIs。
 聊天需要丰富UI时的小部件结果，并且仅在用户时添加全屏
 需要浏览、比较、配置或协作持久对象。
 
-## 相关文档 {#related-docs}
+## 下一步 {#related-docs}
 
-- [Actions](/docs/actions) — 定义一次无头操作。
-- [Native 聊天界面](/docs/native-chat-ui) — 在聊天中呈现键入的操作结果。
-- [Drop-in Agent](/docs/drop-in-agent) — 安装聊天、侧边栏或面板表面。
-- [Component API](/docs/components) — 较低级别的 React 聊天/作曲片段。
-- [Embedding SDK](/docs/embedding-sdk) — 将 Agent-Native 添加到现有应用。
-- [External Agents](/docs/external-agents) — 将 MCP 兼容主机连接到应用。
-- [A2A Protocol](/docs/a2a-protocol) — 从其他座席呼叫座席。
+- [**Actions**](/docs/actions) — 只需定义一次操作；上述每个界面都会调用同一个操作
+- [**Native 聊天界面**](/docs/native-chat-ui) — 在聊天中将类型化的 action 结果呈现为表格、图表和卡片
+- [**Generative UI**](/docs/generative-ui) — 在聊天中生成临时或持久化的沙盒 UI
+- [**Automation-First Apps**](/docs/pure-agent-apps) — 面向作业、队列、脚本和外部代理的完整无浏览器模式
+- [**External Agents**](/docs/external-agents) — 将 MCP 兼容主机连接到应用
+- [**A2A Protocol**](/docs/a2a-protocol) — 从其他 Agent-Native 应用调用代理

package/corpus/core/docs/content/locales/zh-CN/agent-teams.mdx

@@ -239,6 +239,7 @@ interface AgentTask {
   summary: string; // full summary once completed
   currentStep: string; // latest step label (updated while running)
   createdAt: number;
+  delegationDepth?: number; // 1 for a direct sub-agent, 2 for a sub-agent of that sub-agent, etc.
   // Additional fields: parentThreadId, name, updatedAt, startedAt,
   // completedAt, runId, error
 }

package/corpus/core/docs/content/locales/zh-CN/authentication.mdx

@@ -15,7 +15,7 @@ Auth 是通过 auth 服务器插件中的 `autoMountAuth(app)` 自动配置的
 - **远程 MCP OAuth：** 适用于 MCP 主机的标准 OAuth 2.1，例如 Claude 代码和 ChatGPT 连接器。
 - **自定义：**通过 `getSession` 回调带来您自己的身份验证。
 
-<Diagram id="doc-block-146mbx9" title={"三种方式，一次会议"} summary={"浏览器访问者、编程 MCP 客户端和自定义提供程序都解析为下游作用域读取的同一 AuthSession。"}>
+<Diagram id="doc-block-146mbx9" title={"三种方式，一次会议"} summary={"浏览器访问者、MCP 主机和自定义提供程序都解析为下游作用域读取的同一 AuthSession。"}>
 
 ```html
 <div class="auth-modes">