@agent-native/core 0.93.0 → 0.94.0

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

package/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/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/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/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."}>
 
@@ -83,7 +83,7 @@ Pense nos moldes de Loom + Granola + Wispr Flow reunidos em um aplicativo - mas
 - **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
@@ -508,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/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>
@@ -134,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/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/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/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/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/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/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