@agent-native/core 0.79.25 → 0.79.27

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

@@ -7,13 +7,50 @@ description: "Ganchos de observador/guardrail internos em loop que observam a sa
 
 Um `Processor` é um **observador/guardrail** interno de loop para a execução do agente. Ele observa a saída transmitida do modelo e a ferramenta chama as solicitações _conforme a execução avança_, mantém seu próprio estado inicial e pode **abortar** a execução antes que um "pronto" seja reivindicado. Este é o pré-requisito estrutural para proteções em tempo real (bloquear a saída não permitida no meio do fluxo) e uma porta de prova/cobertura (inspecionar o que o modelo está prestes a fazer e interrompê-lo).
 
-```an-diagram title="Onde os três ganchos disparam na corrida" summary="processOutputStream observa cada pedaço, processOutputStep bloqueia chamadas de ferramenta por resposta, processOutputResult registra um veredicto no final. Qualquer gancho pode abortar com um TripWire."
-{
-  "html": "<div class=\"diagram-proc\"><div class=\"diagram-node\" data-rough>stream chunks<br><small class=\"diagram-muted\">processOutputStream</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\" data-rough>per model response<br><small class=\"diagram-muted\">processOutputStep — controla chamadas de ferramentas</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\" data-rough>run end<br><small class=\"diagram-muted\">processOutputResult — veredito</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-pill warn\">abort() &rarr; TripWire &rarr; tripwire event</div></div>",
-  "css": ".diagram-proc{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-proc .diagram-arrow{font-size:22px;line-height:1}.diagram-proc .diagram-pill{flex-basis:100%}"
+<Diagram id="doc-block-1t6qi1z" title={"Onde os três ganchos disparam na corrida"} summary={"processOutputStream observa cada pedaço, processOutputStep bloqueia chamadas de ferramenta por resposta, processOutputResult registra um veredicto no final. Qualquer gancho pode abortar com um TripWire."}>
+
+```html
+<div class="diagram-proc">
+  <div class="diagram-node" data-rough>
+    stream chunks<br /><small class="diagram-muted">processOutputStream</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node" data-rough>
+    per model response<br /><small class="diagram-muted"
+      >processOutputStep — controla chamadas de ferramentas</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node" data-rough>
+    run end<br /><small class="diagram-muted"
+      >processOutputResult — veredito</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-pill warn">
+    abort() &rarr; TripWire &rarr; tripwire event
+  </div>
+</div>
+```
+
+```css
+.diagram-proc {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+.diagram-proc .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
+}
+.diagram-proc .diagram-pill {
+  flex-basis: 100%;
 }
 ```
 
+</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).
 

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

@@ -41,13 +41,55 @@ Preocupação separada de [notifications](/docs/notifications): as notificaçõe
 | `failed`    | Erro no terminal                  |
 | `cancelled` | Usuário interrompido              |
 
-```an-diagram title="Executar ciclo de vida" summary="startRun abre uma linha em execução; updateRunProgress corrige; completeRun move-o para um status de terminal e marca completed_at."
-{
-  "html": "<div class=\"diagram-run\"><div class=\"diagram-box\" data-rough>startRun()</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel running\" data-rough><span class=\"diagram-pill accent\">running</span><small class=\"diagram-muted\">updateRunProgress() &#8635; percent + step</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col terminal\"><span class=\"diagram-pill ok\">succeeded</span><span class=\"diagram-pill warn\">failed</span><span class=\"diagram-pill\">cancelled</span><small class=\"diagram-muted\">completeRun() &rarr; sets completed_at</small></div></div>",
-  "css": ".diagram-run{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-run .diagram-panel{display:flex;flex-direction:column;gap:6px;padding:12px 16px}.diagram-run .terminal{display:flex;flex-direction:column;gap:6px;align-items:flex-start}.diagram-run .diagram-arrow{font-size:22px;line-height:1}"
+<Diagram id="doc-block-1p9httw" title="Executar ciclo de vida" summary={"startRun abre uma linha em execução; updateRunProgress corrige; completeRun move-o para um status de terminal e marca completed_at."}>
+
+```html
+<div class="diagram-run">
+  <div class="diagram-box" data-rough>startRun()</div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-panel running" data-rough>
+    <span class="diagram-pill accent">running</span
+    ><small class="diagram-muted"
+      >updateRunProgress() &#8635; percent + step</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-col terminal">
+    <span class="diagram-pill ok">succeeded</span
+    ><span class="diagram-pill warn">failed</span
+    ><span class="diagram-pill">cancelled</span
+    ><small class="diagram-muted">completeRun() &rarr; sets completed_at</small>
+  </div>
+</div>
+```
+
+```css
+.diagram-run {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-run .diagram-panel {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 12px 16px;
+}
+.diagram-run .terminal {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  align-items: flex-start;
+}
+.diagram-run .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 Status do terminal definidos como `completed_at`. A bandeja UI mostra apenas linhas `running`; as linhas concluídas permanecem no banco de dados para consultas `action=list`.
 
 ## API {#api}

package/corpus/core/docs/content/locales/pt-BR/pure-agent-apps.mdx

@@ -12,13 +12,57 @@ métricas diárias para Slack" — e o agente atua e retorna o resultado onde qu
 pertence. Ainda é um aplicativo real: actions, sessões, estado do aplicativo, histórico,
 configurações, credenciais e registros de compartilhamento, todos ativos em SQL.
 
-```an-diagram title="O loop app-agent é a porta de entrada" summary="Muitos pontos de entrada alcançam um loop de agente sobre ações e estados SQL-backed; os resultados retornam para o local de origem da solicitação. A IU é adicionada apenas quando humanos precisam supervisionar."
-{
-  "html": "<div class=\"diagram-pure\"><div class=\"diagram-col\"><div class=\"diagram-pill\">Terminal</div><div class=\"diagram-pill\">Slack · e-mail</div><div class=\"diagram-pill\">Job agendado</div><div class=\"diagram-pill\">Another agent (A2A)</div><div class=\"diagram-pill\">Chat</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">Loop do agente do app</span><small class=\"diagram-muted\">ações · sessões · estado do app em SQL</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Resultado retornado<br><small class=\"diagram-muted\">to where it belongs</small></div></div>",
-  "css": ".diagram-pure{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-pure .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-pure .diagram-arrow{font-size:22px;line-height:1}.diagram-pure .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+<Diagram id="doc-block-8brd1i" title={"O loop app-agent é a porta de entrada"} summary={"Muitos pontos de entrada alcançam um loop de agente sobre ações e estados SQL-backed; os resultados retornam para o local de origem da solicitação. A IU é adicionada apenas quando humanos precisam supervisionar."}>
+
+```html
+<div class="diagram-pure">
+  <div class="diagram-col">
+    <div class="diagram-pill">Terminal</div>
+    <div class="diagram-pill">Slack · e-mail</div>
+    <div class="diagram-pill">Job agendado</div>
+    <div class="diagram-pill">Another agent (A2A)</div>
+    <div class="diagram-pill">Chat</div>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-panel center" data-rough>
+    <span class="diagram-pill accent">Loop do agente do app</span
+    ><small class="diagram-muted">ações · sessões · estado do app em SQL</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-box" data-rough>
+    Resultado retornado<br /><small class="diagram-muted"
+      >to where it belongs</small
+    >
+  </div>
+</div>
+```
+
+```css
+.diagram-pure {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-pure .diagram-col {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.diagram-pure .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
+}
+.diagram-pure .center {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
 }
 ```
 
+</Diagram>
+
 Alcance esta forma quando o trabalho é executado em segundo plano, a saída sai do
 aplicativo, o domínio é único ou você está criando um protótipo. O agente ainda precisa de um UI —
 não é um painel, mas um lugar para humanos supervisionarem, configurarem e orientarem —

package/corpus/core/docs/content/locales/pt-BR/real-time-collaboration.mdx

@@ -36,13 +36,58 @@ Isso se baseia em três tecnologias testadas em batalha: **Yjs** (CRDT para fus
 
 O sistema de colaboração possui cinco camadas interligadas.
 
-```an-diagram title="Cinco camadas interligadas" summary="Desde o CRDT na memória até o transporte que transporta atualizações entre pares – cada camada tem um trabalho."
-{
-  "html": "<div class=\"diagram-stack\"><div class=\"diagram-card layer\"><span class=\"diagram-pill accent\">1 &middot; Yjs Y.Doc</span><small class=\"diagram-muted\">CRDT &mdash; mesclagem sem conflitos, sem coordenador</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill\">2 &middot; Conteúdo canônico SQL</span><small class=\"diagram-muted\">_collab_docs &mdash; durable source of truth, versioned</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill\">3 &middot; reconciliação controlada por updatedAt</span><small class=\"diagram-muted\">edições do agente se propagam pelo bump de SQL</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill\">4 &middot; Eleição do cliente líder</span><small class=\"diagram-muted\">exatamente uma aba aplica o snapshot</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill ok\">5 &middot; caminho rápido SSE + polling</span><small class=\"diagram-muted\">~dezenas de ms, degrada para polling de 2s em qualquer lugar</small></div></div>",
-  "css": ".diagram-stack{display:flex;flex-direction:column;gap:8px}.diagram-stack .layer{display:flex;flex-direction:column;gap:4px;padding:12px 14px}"
+<Diagram id="doc-block-ijg0gb" title="Cinco camadas interligadas" summary={"Desde o CRDT na memória até o transporte que transporta atualizações entre pares – cada camada tem um trabalho."}>
+
+```html
+<div class="diagram-stack">
+  <div class="diagram-card layer">
+    <span class="diagram-pill accent">1 &middot; Yjs Y.Doc</span
+    ><small class="diagram-muted"
+      >CRDT &mdash; mesclagem sem conflitos, sem coordenador</small
+    >
+  </div>
+  <div class="diagram-card layer">
+    <span class="diagram-pill">2 &middot; Conteúdo canônico SQL</span
+    ><small class="diagram-muted"
+      >_collab_docs &mdash; durable source of truth, versioned</small
+    >
+  </div>
+  <div class="diagram-card layer">
+    <span class="diagram-pill"
+      >3 &middot; reconciliação controlada por updatedAt</span
+    ><small class="diagram-muted"
+      >edições do agente se propagam pelo bump de SQL</small
+    >
+  </div>
+  <div class="diagram-card layer">
+    <span class="diagram-pill">4 &middot; Eleição do cliente líder</span
+    ><small class="diagram-muted">exatamente uma aba aplica o snapshot</small>
+  </div>
+  <div class="diagram-card layer">
+    <span class="diagram-pill ok">5 &middot; caminho rápido SSE + polling</span
+    ><small class="diagram-muted"
+      >~dezenas de ms, degrada para polling de 2s em qualquer lugar</small
+    >
+  </div>
+</div>
+```
+
+```css
+.diagram-stack {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.diagram-stack .layer {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 12px 14px;
 }
 ```
 
+</Diagram>
+
 ### 1. Yjs Y.Doc (camada CRDT)
 
 Cada documento colaborativo é um `Y.Doc` contendo tipos compartilhados — geralmente um
@@ -100,13 +145,67 @@ ciclo.
 
 Erros de rede usam espera exponencial com jitter, limitado a aproximadamente 15 s.
 
-```an-diagram title="Dois caminhos de edição, uma mesclagem" summary="Fluxo de teclas humanas Y.Doc → servidor → SSE. As edições do agente passam por SQL: a ação é atualizada em, o cliente principal se reconcilia e a alteração entra novamente em Yjs."
-{
-  "html": "<div class=\"diagram-collab\"><div class=\"lane\"><span class=\"diagram-pill\">Edição humana</span><div class=\"diagram-node\">Y.Doc update<br><small class=\"diagram-muted\">debounce ~80 ms</small></div><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\" data-rough>POST /update<br><small class=\"diagram-muted\">apply + persist</small></div><span class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box diagram-accent\">SSE push<br><small class=\"diagram-muted\">to all peers</small></div></div><div class=\"lane\"><span class=\"diagram-pill warn\">Edição do agente</span><div class=\"diagram-node\">A ação escreve SQL<br><small class=\"diagram-muted\">atualiza updatedAt</small></div><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\" data-rough>Cliente líder<br><small class=\"diagram-muted\">setContent no Y.Doc</small></div><span class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box diagram-accent\">POST /update<br><small class=\"diagram-muted\">re-enters Yjs &middot; SSE push</small></div></div></div>",
-  "css": ".diagram-collab{display:flex;flex-direction:column;gap:14px}.diagram-collab .lane{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.diagram-collab .diagram-arrow{font-size:22px;line-height:1}"
+<Diagram id="doc-block-18ahdfi" title={"Dois caminhos de edição, uma mesclagem"} summary={"Fluxo de teclas humanas Y.Doc → servidor → SSE. As edições do agente passam por SQL: a ação é atualizada em, o cliente principal se reconcilia e a alteração entra novamente em Yjs."}>
+
+```html
+<div class="diagram-collab">
+  <div class="lane">
+    <span class="diagram-pill">Edição humana</span>
+    <div class="diagram-node">
+      Y.Doc update<br /><small class="diagram-muted">debounce ~80 ms</small>
+    </div>
+    <span class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</span>
+    <div class="diagram-box" data-rough>
+      POST /update<br /><small class="diagram-muted">apply + persist</small>
+    </div>
+    <span class="diagram-arrow diagram-accent" aria-hidden="true">&rarr;</span>
+    <div class="diagram-box diagram-accent">
+      SSE push<br /><small class="diagram-muted">to all peers</small>
+    </div>
+  </div>
+  <div class="lane">
+    <span class="diagram-pill warn">Edição do agente</span>
+    <div class="diagram-node">
+      A ação escreve SQL<br /><small class="diagram-muted"
+        >atualiza updatedAt</small
+      >
+    </div>
+    <span class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</span>
+    <div class="diagram-box" data-rough>
+      Cliente líder<br /><small class="diagram-muted"
+        >setContent no Y.Doc</small
+      >
+    </div>
+    <span class="diagram-arrow diagram-accent" aria-hidden="true">&rarr;</span>
+    <div class="diagram-box diagram-accent">
+      POST /update<br /><small class="diagram-muted"
+        >re-enters Yjs &middot; SSE push</small
+      >
+    </div>
+  </div>
+</div>
+```
+
+```css
+.diagram-collab {
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+}
+.diagram-collab .lane {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  flex-wrap: wrap;
+}
+.diagram-collab .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 ## Início rápido {#quickstart}
 
 ### 1. Instalar pacotes

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

@@ -113,13 +113,68 @@ Summarize overnight emails.`,
 
 O agendador é um plugin de estrutura (a rotina interna `processRecurringJobs()`) que é executado no processo: um `setInterval` é acionado a cada 60 segundos (com um atraso de inicialização de 10 segundos) dentro do plugin de chat do agente, onde quer que o servidor esteja em execução.
 
-```an-diagram title="Um tick do agendador" summary="A cada 60 segundos, o agendador encontra tarefas vencidas, executa cada uma delas como um novo encadeamento de agente e grava o resultado de volta no arquivo de tarefas."
-{
-  "html": "<div class=\"sched\"><div class=\"diagram-box accent\"><code>setInterval</code> &bull; 60s &#8635;</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">1 &middot; scan</span><small class=\"diagram-muted\">list every enabled <code>jobs/*.md</code> across all owners</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">2 &middot; due?</span><small class=\"diagram-muted\">compare <code>nextRun</code> to now</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card accent\"><span class=\"diagram-pill accent\">3 &middot; run</span><small class=\"diagram-muted\">fresh agent thread, job body as the user message &mdash; actions, SQL, A2A, email</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card ok\"><span class=\"diagram-pill ok\">4 &middot; record</span><small class=\"diagram-muted\">write <code>lastRun</code> / <code>lastStatus</code> / <code>lastError</code>, recompute <code>nextRun</code></small></div></div>",
-  "css": ".sched{display:flex;flex-direction:column;gap:6px;max-width:520px}.sched .diagram-card{display:flex;flex-direction:column;gap:2px;padding:10px 14px}.sched .diagram-box{align-self:flex-start}.sched .diagram-arrow{font-size:18px;align-self:center}"
+<Diagram id="doc-block-16bw537" title="Um tick do agendador" summary={"A cada 60 segundos, o agendador encontra tarefas vencidas, executa cada uma delas como um novo encadeamento de agente e grava o resultado de volta no arquivo de tarefas."}>
+
+```html
+<div class="sched">
+  <div class="diagram-box accent">
+    <code>setInterval</code> &bull; 60s &#8635;
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill">1 &middot; scan</span
+    ><small class="diagram-muted"
+      >list every enabled <code>jobs/*.md</code> across all owners</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill">2 &middot; due?</span
+    ><small class="diagram-muted">compare <code>nextRun</code> to now</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card accent">
+    <span class="diagram-pill accent">3 &middot; run</span
+    ><small class="diagram-muted"
+      >fresh agent thread, job body as the user message &mdash; actions, SQL,
+      A2A, email</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card ok">
+    <span class="diagram-pill ok">4 &middot; record</span
+    ><small class="diagram-muted"
+      >write <code>lastRun</code> / <code>lastStatus</code> /
+      <code>lastError</code>, recompute <code>nextRun</code></small
+    >
+  </div>
+</div>
+```
+
+```css
+.sched {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  max-width: 520px;
+}
+.sched .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  padding: 10px 14px;
+}
+.sched .diagram-box {
+  align-self: flex-start;
+}
+.sched .diagram-arrow {
+  font-size: 18px;
+  align-self: center;
 }
 ```
 
+</Diagram>
+
 <Callout id="doc-block-j6yn07" tone="risk">
 
 **Scale-to-zero caveat.** The scheduler is in-process, so on serverless hosts jobs only fire while an instance is warm. If reliable scheduling matters, keep an instance warm with keep-alive pings or use an always-on host (Fly, Render, a VPS).

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

@@ -21,14 +21,53 @@ Os aplicativos nativos do agente usam o **React Router v8** com roteamento basea
 
 Prefixe um segmento com `$` para um parâmetro dinâmico. Prefixe com `_` para torná-la uma rota de layout sem caminho (sem segmento URL). Os modelos usam `flatRoutes()` — o arquivo de notação de ponto acima é o principal; o formato de pasta aninhada `inbox/route.tsx` também funciona.
 
-```an-diagram title="Layout sem caminho envolve as páginas" summary="Um layout _app.tsx (sem segmento URL) renderiza o shell compartilhado uma vez; as páginas correspondentes são renderizadas dentro de seu <Outlet/>, para que a barra lateral do agente nunca seja remontada na navegação."
-{
-"html": "<div class=\"diagram-layout\" data-rough><div class=\"diagram-shell\"><span class=\"diagram-pill accent\">_app.tsx</span><small class=\"diagram-muted\">layout sem rota · shell persistente + barra do agente</small><div class=\"diagram-outlet\" data-rough><small class=\"diagram-muted\">&lt;Outlet/&gt; — the matched page</small><div class=\"diagram-row\"><span class=\"diagram-pill\">_index.tsx &rarr; /</span><span class=\"diagram-pill\">settings.tsx &rarr; /settings</span><span class=\"diagram-pill\">inbox.$threadId.tsx &rarr; /inbox/:threadId</span></div></div></div></div>",
-"css": ".diagram-layout .diagram-shell{display:flex;flex-direction:column;gap:8px;padding:16px}.diagram-layout .diagram-outlet{display:flex;flex-direction:column;gap:8px;padding:14px;margin-top:6px}.diagram-layout .diagram-row{display:flex;flex-wrap:wrap;gap:8px;margin-top:4px}"
-}
+<Diagram id="doc-block-1kqvwtx" title={"Layout sem caminho envolve as páginas"} summary={"Um layout _app.tsx (sem segmento URL) renderiza o shell compartilhado uma vez; as páginas correspondentes são renderizadas dentro de seu <Outlet/>, para que a barra lateral do agente nunca seja remontada na navegação."}>
+
+```html
+<div class="diagram-layout" data-rough>
+  <div class="diagram-shell">
+    <span class="diagram-pill accent">_app.tsx</span
+    ><small class="diagram-muted"
+      >layout sem rota · shell persistente + barra do agente</small
+    >
+    <div class="diagram-outlet" data-rough>
+      <small class="diagram-muted">&lt;Outlet/&gt; — the matched page</small>
+      <div class="diagram-row">
+        <span class="diagram-pill">_index.tsx &rarr; /</span
+        ><span class="diagram-pill">settings.tsx &rarr; /settings</span
+        ><span class="diagram-pill"
+          >inbox.$threadId.tsx &rarr; /inbox/:threadId</span
+        >
+      </div>
+    </div>
+  </div>
+</div>
+```
 
+```css
+.diagram-layout .diagram-shell {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 16px;
+}
+.diagram-layout .diagram-outlet {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 14px;
+  margin-top: 6px;
+}
+.diagram-layout .diagram-row {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  margin-top: 4px;
+}
 ```
 
+</Diagram>
+
 ## Adicionando uma nova página {#adding-a-page}
 
 Crie o arquivo e exporte um componente padrão:

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

@@ -40,13 +40,52 @@ O back-end padrão gera um processo filho do Node local bloqueado. Isso é limit
 
 Manter o contrato restrito significa que um adaptador remoto herda a mesma postura de segurança. O processo pai mantém a propriedade de tudo que contém segredo: ele cria o módulo sandbox, executa a ponte localhost (que mantém o contexto da solicitação e aplica listas de permissões de host + proteções SSRF), limpa o env e formata a saída. Um adaptador recebe apenas uma fonte de módulo **não secreta** já preparada, além de limites de recursos — ele é responsável exclusivamente por _executá-lo_ e capturar o status stdout/stderr/exit.
 
-```an-diagram title="Os pais guardam os segredos; o adaptador só executa código" summary="run-code constrói o módulo e executa a ponte de loopback; o adaptador recebe um módulo não secreto + limites e retorna stdout/stderr/exit."
-{
-  "html": "<div class=\"diagram-sandbox\"><div class=\"diagram-box\" data-rough><strong>Processo pai</strong><small class=\"diagram-muted\">cria módulo · ponte loopback · limpeza de env · formato de saída</small></div><div class=\"diagram-col\"><div class=\"diagram-pill accent\">non-secret module + limits &rarr;</div><div class=\"diagram-pill ok\">&larr; stdout / stderr / exitCode</div><div class=\"diagram-pill\">&harr; bridge calls (127.0.0.1)</div></div><div class=\"diagram-panel center\" data-rough><strong>SandboxAdapter.run</strong><small class=\"diagram-muted\">processo filho local · Docker · remoto · durável</small></div></div>",
-  "css": ".diagram-sandbox{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-sandbox .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-sandbox .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+<Diagram id="doc-block-r5ly0l" title={"Os pais guardam os segredos; o adaptador só executa código"} summary={"run-code constrói o módulo e executa a ponte de loopback; o adaptador recebe um módulo não secreto + limites e retorna stdout/stderr/exit."}>
+
+```html
+<div class="diagram-sandbox">
+  <div class="diagram-box" data-rough>
+    <strong>Processo pai</strong
+    ><small class="diagram-muted"
+      >cria módulo · ponte loopback · limpeza de env · formato de saída</small
+    >
+  </div>
+  <div class="diagram-col">
+    <div class="diagram-pill accent">non-secret module + limits &rarr;</div>
+    <div class="diagram-pill ok">&larr; stdout / stderr / exitCode</div>
+    <div class="diagram-pill">&harr; bridge calls (127.0.0.1)</div>
+  </div>
+  <div class="diagram-panel center" data-rough>
+    <strong>SandboxAdapter.run</strong
+    ><small class="diagram-muted"
+      >processo filho local · Docker · remoto · durável</small
+    >
+  </div>
+</div>
+```
+
+```css
+.diagram-sandbox {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-sandbox .diagram-col {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.diagram-sandbox .center {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
 }
 ```
 
+</Diagram>
+
 ## A interface {#interface}
 
 A costura reside no núcleo em `packages/core/src/coding-tools/sandbox/` — `adapter.ts` (o contrato), `index.ts` (seleção: `getSandboxAdapter()` / `registerSandboxAdapter()`) e `local-child-process-adapter.ts` (o padrão). Ele é conectado no pacote por `run-code.ts`; um host conecta um back-end diferente por meio do auxiliar de registro `index.ts` (ou, para um back-end do Docker, por meio do [blueprint](/docs/blueprint-installer) que edita esses arquivos diretamente).

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

@@ -9,13 +9,45 @@ Os aplicativos nativos do agente são projetados para serem seguros por padrão.
 
 ## O que você ganha de graça e o que você possui {#what-you-own}
 
-```an-diagram title="Defesa em camadas" summary="A estrutura possui a maior parte da superfície de ameaças; você possui duas coisas: marcar tabelas para definir o escopo e validar entradas externas."
-{
-  "html": "<div class=\"sec-layers\"><div class=\"diagram-card free\"><span class=\"diagram-pill ok\">Pertence ao framework</span><small class=\"diagram-muted\">SQL isolation &middot; parameterized queries &middot; XSS escaping &middot; auth guard &middot; CSRF cookies &middot; secret encryption</small></div><div class=\"diagram-card you\"><span class=\"diagram-pill warn\">Você controla</span><small class=\"diagram-muted\">A. tag tables with ownableColumns() &amp; route through access guards<br>B. give every action a Zod schema &amp; send user URLs through the SSRF guard</small></div></div>",
-  "css": ".sec-layers{display:flex;flex-direction:column;gap:12px}.sec-layers .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px}"
+<Diagram id="doc-block-5ijovz" title="Defesa em camadas" summary={"A estrutura possui a maior parte da superfície de ameaças; você possui duas coisas: marcar tabelas para definir o escopo e validar entradas externas."}>
+
+```html
+<div class="sec-layers">
+  <div class="diagram-card free">
+    <span class="diagram-pill ok">Pertence ao framework</span
+    ><small class="diagram-muted"
+      >SQL isolation &middot; parameterized queries &middot; XSS escaping
+      &middot; auth guard &middot; CSRF cookies &middot; secret
+      encryption</small
+    >
+  </div>
+  <div class="diagram-card you">
+    <span class="diagram-pill warn">Você controla</span
+    ><small class="diagram-muted"
+      >A. tag tables with ownableColumns() &amp; route through access guards<br />B.
+      give every action a Zod schema &amp; send user URLs through the SSRF
+      guard</small
+    >
+  </div>
+</div>
+```
+
+```css
+.sec-layers {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+.sec-layers .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 14px 16px;
 }
 ```
 
+</Diagram>
+
 Quando você desenvolve os padrões padrão, a estrutura já lida com a maior parte da superfície de ameaças para você:
 
 - **Isolamento de dados** — o agente SQL foi reescrito para poder ver apenas as linhas do usuário atual (e da organização ativa). Consulte [Data Scoping](#data-scoping).
@@ -122,13 +154,55 @@ O escopo flui da sessão autenticada até o SQL que o agente executa:
 session.orgId → AGENT_ORG_ID → SQL row scoping
 ```
 
-```an-diagram title="O pipeline de escopo" summary="O agente SQL nunca toca as tabelas base diretamente - ele lê uma visão temporária com escopo para a identidade atual, portanto, um nome de tabela vazio só pode retornar linhas próprias."
-{
-  "html": "<div class=\"scope-pipe\"><div class=\"diagram-node\">Sessão conectada<br><small class=\"diagram-muted\">email &middot; orgId</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">Request context<br><small class=\"diagram-muted\">AGENT_ORG_ID</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Temporary VIEW<br><small class=\"diagram-muted\">WHERE owner_email = ? AND org_id = ?</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node ok\">SQL do agente<br><small class=\"diagram-muted\">bare table names only</small></div></div>",
-  "css": ".scope-pipe{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.scope-pipe .diagram-node{display:flex;flex-direction:column;gap:2px;padding:10px 14px}.scope-pipe .diagram-arrow{font-size:22px;line-height:1}"
+<Diagram id="doc-block-16s8kyp" title="O pipeline de escopo" summary={"O agente SQL nunca toca as tabelas base diretamente - ele lê uma visão temporária com escopo para a identidade atual, portanto, um nome de tabela vazio só pode retornar linhas próprias."}>
+
+```html
+<div class="scope-pipe">
+  <div class="diagram-node">
+    Sessão conectada<br /><small class="diagram-muted"
+      >email &middot; orgId</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node">
+    Request context<br /><small class="diagram-muted">AGENT_ORG_ID</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-box">
+    Temporary VIEW<br /><small class="diagram-muted"
+      >WHERE owner_email = ? AND org_id = ?</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node ok">
+    SQL do agente<br /><small class="diagram-muted"
+      >bare table names only</small
+    >
+  </div>
+</div>
+```
+
+```css
+.scope-pipe {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+.scope-pipe .diagram-node {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  padding: 10px 14px;
+}
+.scope-pipe .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 A sessão conectada carrega `email` e (quando uma organização está ativa) `orgId`. A estrutura estabelece o contexto de solicitação dessa sessão, expõe a organização ativa ao agente SQL como `AGENT_ORG_ID` e reescreve cada consulta para que possa ver apenas as linhas que a identidade atual possui. O mesmo caminho se aplica quer a consulta venha do UI, de uma ação ou do agente — o agente não pode ler dados de uma organização da qual o usuário não é membro.
 
 ### Escopo por usuário (`owner_email`)