@agent-native/core 0.93.0 → 0.94.0

package/docs/content/locales/ko-KR/template-design.mdx

@@ -11,7 +11,7 @@ Design은 에이전트 기반 HTML 프로토타이핑 스튜디오입니다. 에
   <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'>제품 출시 페이지</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>생성된 HTML 프로토타입</strong></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span class='wf-muted'>히어로를 더 밀도 있게 만들고 CTA를 더 명확하게 하세요.</span><div style='flex:1'></div><button class='primary'>수정 적용</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'>제품 출시 페이지</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'>Agent-Native로 더 빠르게 출시하세요</strong><span class='wf-muted' style='max-width:70%'>프롬프트에서 작동하는 프로토타입을 생성한 다음 그 자리에서 다듬으세요.</span><button class='primary'>시작하기</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'>히어로를 더 밀도 있게 만들고 CTA를 더 명확하게 하세요.</span><div style='flex:1'></div><button class='primary'>수정 적용</button></div></div></div>"
     }
   />
 </WireframeBlock>
@@ -134,6 +134,8 @@ pnpm dev
 
 모든 데이터는 Drizzle ORM를 통해 SQL에 있습니다. 스키마: `templates/design/server/db/schema.ts`. 디자인 및 디자인 시스템은 표준 `ownableColumns`와 일치하는 프레임워크 공유 테이블을 전달하므로 사용자별/조직별 공유 모델에 속합니다.
 
+아래 표는 디자인, 파일, 템플릿, 버전, 디자인 시스템이라는 핵심 소유 가능 리소스를 다룹니다. 같은 스키마의 다른 7개 테이블은 핵심 리소스 모델이 아니라 이 문서의 다른 부분에서 설명하는 기능을 지원합니다. `design_localhost_connections`와 `design_localhost_write_grants`(localhost 소스 모드), `component_index`(컴포넌트 인덱싱), `motion_timeline`(모션), `design_state`(편집기 상태 스냅샷), `design_fusion_edits`(전체 앱 Fusion 모드), `design_review_snapshot`(리뷰 스냅샷)입니다.
+
 | 테이블                                   | 무엇을 담고 있는지                                                                                                                   |
 | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
 | `designs`                                | 디자인 프로젝트 — `title`, `description`, `project_type` (`prototype` / `other`), `data` JSON blob 및 선택적 `design_system_id` 링크 |

package/docs/content/locales/ko-KR/template-dispatch.mdx

@@ -5,7 +5,11 @@ description: "Dispatch는 중앙 받은 편지함, 앱 간 오케스트레이션
 
 # 파견
 
-> **참조:** Dispatch의 기능과 원하는 시기에 대한 개념적 개요는 [Dispatch](/docs/dispatch)를 참조하세요. 이 페이지는 템플릿별 참조입니다.
+<Callout tone="info">
+
+**참조:** Dispatch의 기능과 원하는 시기에 대한 개념적 개요는 [Dispatch](/docs/dispatch)를 참조하세요. 이 페이지는 템플릿별 참조입니다.
+
+</Callout>
 
 디스패치는 **작업공간 제어 평면**입니다. 다른 템플릿이 도메인 앱(Mail, Calendar, Analytics, Brain)인 경우 Dispatch는 중앙 받은 편지함, 비밀 저장소, 예약된 작업, Slack/Telegram 통합, 도메인 작업을 [A2A](/docs/a2a-protocol)를 통해 올바른 전문 앱에 위임하는 오케스트레이터 에이전트 등 모든 것을 조정하기 위해 템플릿과 함께 실행하는 앱입니다.
 

package/docs/content/locales/ko-KR/template-mail.mdx

@@ -362,3 +362,11 @@ UI의 경로:
 **키보드 단축키 변경.** 키 바인딩 핸들러는 `templates/mail/app/components/email/`에 있습니다. `useHotkeys` 또는 `addEventListener("keydown"`를 검색하여 각 키가 연결된 위치를 찾으세요.
 
 상담원에게 이러한 변경을 요청하세요. 에이전트는 자체 소스를 편집할 수 있습니다. [Self-Modifying Code](/docs/key-concepts#agent-modifies-code)를 참조하세요.
+
+## 다음 단계
+
+- [**템플릿**](/docs/cloneable-saas) — 복제해 소유하는 모델과 시작점으로 사용할 수 있는 다른 모든 도메인 템플릿
+- [**시작하기**](/docs/getting-started) — actions, application state, 실시간 동기화 등 프레임워크의 기본 사항
+- [**캘린더**](/docs/template-calendar) — 일정 관리와 예약을 다루는 관련 도메인 템플릿
+- [**자동화**](/docs/automations) — Mail의 자동 분류 규칙이 기반으로 삼는 이벤트 트리거 엔진
+- [**Actions**](/docs/actions) — 채팅, 단축키, 자동화가 호출하는 action 시스템

package/docs/content/locales/ko-KR/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 @@ interface TrackingEvent {
 ## 다음 단계
 
 - [**Actions**](/docs/actions) — 대부분의 추적 통화가 발생하는 곳
-- [**Server Plugins**](/docs/server) — `registerBuiltinProviders()`는 시작 시 핵심 경로 플러그인에서 실행됩니다.
-- [**Secrets**](/docs/security) — 추적 제공자를 위한 API 키 관리
+- [**Server Plugins**](/docs/server#server-plugins) — `registerBuiltinProviders()`는 시작 시 핵심 경로 플러그인에서 실행됩니다.
+- [**보안 — 비밀 관리**](/docs/security#secrets) — 추적 제공자를 위한 API 키 관리

package/docs/content/locales/ko-KR/using-your-agent.mdx

@@ -92,21 +92,14 @@ description: "에이전트와 함께 작업하는 일상적인 루프: 에이전
 
 에이전트는 탭하여 이동할 수 있는 별도의 앱이 아닙니다. 사이드바, 원시 패널 및 `sendToAgentChat()` 호출과 같은 소수의 React 구성 요소로 제공되며 모든 앱에 드롭됩니다. `<AgentSidebar>`를 렌더링하여 모든 화면에 전환 가능한 에이전트를 제공하거나 일회성 LLM 호출을 실행하는 대신 버튼을 연결하여 특정 작업을 채팅에 전달할 수 있습니다.
 
-→ [**Drop-in Agent**](/docs/drop-in-agent) — `<AgentPanel>`, `<AgentSidebar>` 및 `sendToAgentChat()`를 React 앱에 마운트합니다.
-→ [**Agent Surfaces**](/docs/agent-surfaces) — 워크플로가 헤드리스, 채팅 우선, 내장형 또는 전체 앱인지 선택하세요.
-
 ## 가벼운 UI로 갈 수 있습니다 {#ui-light}
 
 모든 앱에 전체 대시보드가 필요한 것은 아닙니다. 상담원이 제품인 경우 대부분의 맞춤 UI를 건너뛸 수 있습니다. 앱을 열고 원하는 것을 요청하면 상담원이 나머지 작업을 수행하게 됩니다. 에이전트에는 여전히 기록, 작업 공간, 설정 등 관리 영역이 있지만 주요 상호 작용은 클릭이 아닌 대화입니다.
 
-→ [**Automation-First Apps**](/docs/pure-agent-apps) — jobs, queues, scripts, external agents를 위한 브라우저 없는 앱
-
 ## 함께 편집하세요 {#you-co-edit}
 
 귀하와 상담원이 동일한 문서를 작업할 때는 교대로 작업하지 않습니다. 실시간 공동작업을 통해 에이전트의 편집 내용이 팀원과 동일한 방식으로 실시간 커서로 사용자의 편집 내용과 함께 스트리밍됩니다. 덮어쓰기는 없습니다. 작동하는 동안 계속 입력할 수 있으며 변경사항이 발생하는 대로 표시됩니다.
 
-→ [**Real-Time Collaboration**](/docs/real-time-collaboration) — 동일한 문서에서 실시간 커서 및 에이전트 편집을 통한 다중 사용자 공동 편집.
-
 ## 다음 단계 {#whats-next}
 
 - [**Context Awareness**](/docs/context-awareness) — 상담원은 귀하가 무엇을 보고 있는지 알고 있습니다.

package/docs/content/locales/ko-KR/voice-input.mdx

@@ -9,6 +9,12 @@ description: "에이전트 채팅 작성기의 음성 받아쓰기 — Builder G
 
 프레임워크는 이 모든 것을 자동으로 처리합니다. Builder에 연결된 사용자는 기본적으로 Builder에서 호스팅되는 Gemini Flash-Lite를 얻습니다. 그렇지 않으면 사용자가 자신의 공급자 키를 가져오거나 브라우저 음성 인식으로 돌아갈 수 있습니다.
 
+## 실시간 음성 모드 {#realtime-speech-mode}
+
+마이크를 열면 팝오버에서 **실시간 음성 대화**와 **편집 가능한 받아쓰기** 중 하나를 선택할 수 있습니다. 실시간 모드에는 사용자 범위의 `OPENAI_API_KEY`가 필요하며, WebRTC를 통해 브라우저를 `gpt-realtime-2.1`에 연결합니다. 채팅은 오른쪽 아래의 음성 오브로 접힙니다. 오브를 클릭하면 대화를 끝내지 않고 채팅을 표시하거나 숨길 수 있습니다.
+
+음성 모델은 채팅과 동일한 인증된 Agent Native 도구를 사용하므로 말하는 동안 앱을 탐색하고 작업을 호출할 수 있습니다. 승인이 필요한 작업은 사용자가 승인할 때까지 일시 중지된 상태로 유지됩니다. 오디오는 SQL에 저장되지 않으며 Agent Native는 간결한 세션 및 대화 내용 상태만 보관합니다. 실시간 세션은 최대 60분 동안 지속됩니다.
+
 ## 작동 방식 {#how-it-works}
 
 작곡가의 음성 버튼은 브라우저에서 오디오를 녹음한 다음 제공자를 선택합니다.

package/docs/content/locales/ko-KR/workspace-connections.mdx

@@ -425,10 +425,9 @@ Brain의 소스 페이지는 참조 구현입니다. Brain 소스 레코드 옆
 
 ### 디스패치 제어 평면 설정
 
-Dispatch는 앱이 직접 호출할 수 있는 동일한 공유 저장소 기능을 작성하는 제어 평면 actions를 노출합니다.
+Dispatch는 앱이 직접 호출할 수 있는 것과 동일한 공유 저장소 함수를 사용하는 제어 평면 actions를 제공합니다. `upsert-workspace-connection` action은 공급자 카탈로그를 기준으로 입력을 검증한 다음 이 페이지에 나온 동일한 `upsertWorkspaceConnection()`에 위임합니다.
 
 ```ts
-// templates/dispatch/actions/upsert-workspace-connection.ts delegates to this.
 await upsertWorkspaceConnection({
   id: "team-slack",
   provider: "slack",
@@ -493,3 +492,11 @@ await upsertWorkspaceConnectionGrant({
 경계를 엄격하게 유지하십시오. 제공자 메타데이터는 표시해도 안전합니다. 자격 증명 값은 저장소에 유지됩니다.
 
 </details>
+
+## 다음 단계 {#whats-next}
+
+- [**Dispatch**](/docs/dispatch) — 일반적으로 작업 공간 연결 설정과 Vault를 관리하는 앱
+- [**보안**](/docs/security) — 연결이 가리키는 자격 증명 Vault, 시크릿 범위, 접근 모델
+- [**온보딩**](/docs/onboarding#checking-workspace-connections-in-onboarding) — 템플릿 설정 체크리스트에서 연결 준비 상태를 확인하는 방법
+- [**MCP 클라이언트**](/docs/mcp-clients) — 작업 공간 전체에서 MCP 서버 자격 증명을 공유하는 관련 재사용 가능 구성 패턴
+- [**Brain**](/docs/template-brain) — 이 모델을 기반으로 구축된 공급자 Sources 페이지의 참조 구현

package/docs/content/locales/ko-KR/workspace.mdx

@@ -5,7 +5,11 @@ description: "Claude-사용자별 코드 수준 사용자 정의 — skills, 메
 
 # 작업 공간
 
-> **어떤 작업공간 문서입니까?** 이 페이지에서는 **사용자 정의 레이어**, 즉 작업공간이*무엇인지* 다룹니다. 배포 형태(하나의 단일 저장소, 많은 앱)는 [Multi-App Workspaces](/docs/multi-app-workspace)를 참조하세요. 거버넌스(누가 무엇을 검토하고, 승인하고, 소유하는지)에 대해서는 [Workspace Governance](/docs/workspace-management)를 참조하세요.
+<Callout tone="info">
+
+**어떤 작업공간 문서입니까?** 이 페이지에서는 **사용자 정의 레이어**, 즉 작업공간이*무엇인지* 다룹니다. 배포 형태(하나의 단일 저장소, 많은 앱)는 [Multi-App Workspaces](/docs/multi-app-workspace)를 참조하세요. 거버넌스(누가 무엇을 검토하고, 승인하고, 소유하는지)에 대해서는 [Workspace Governance](/docs/workspace-management)를 참조하세요.
+
+</Callout>
 
 모든 에이전트 기반 앱에는 **작업 공간**, 즉 에이전트를 나만의 것으로 만드는 사용자 정의 레이어가 함께 제공됩니다. 여기에는 팀 지침(`AGENTS.md`), 공유 학습(`LEARNINGS.md`), 개인 구조적 메모리(`memory/MEMORY.md`), 에이전트가 요청 시 가져오는 skills, 사용자 정의 하위 에이전트, 예약된 작업 및 연결된 MCP 서버 등 Claude 코드/Codex 설정에서 기대할 수 있는 모든 것이 포함되어 있습니다.
 
@@ -82,7 +86,7 @@ description: "Claude-사용자별 코드 수준 사용자 정의 — skills, 메
 | 프로젝트별 `CLAUDE.md` / skills      | 앱별 `AGENTS.md` + 작업 공간 메모리 리소스     |
 | JSON 파일의 MCP 구성                 | JSON의 MCP 구성 _또는_ 범위당 UI 설정          |
 
-동일한 기능. 다른 경제학. 이것이 SaaS에 중요한 이유는 [Templates](/docs/cloneable-saas)를 참조하세요.
+동일한 기능. 다른 경제학. 이것이 SaaS에 중요한 이유는 [앱](/docs/cloneable-saas)를 참조하세요.
 
 ## 개요 {#overview}
 
@@ -219,11 +223,9 @@ workspace context/brand.md
 -> personal context/brand.md
 ```
 
-`context/` 파일을 짧고 사실대로 유지하세요. 상담원이 훑어볼 수 있는 몇 가지 글머리 기호는 다음과 같습니다.
-
-```text
-<!-- context/brand.md -->
+예:
 
+```text filename="context/brand.md"
 # 브랜드
 
 - Voice: direct, warm, concrete
@@ -388,15 +390,9 @@ Workspace에는 두 가지 에이전트 유형이 있습니다.
 
 하나의 앱 내에서 위임을 위해 사용자 정의 에이전트를 사용합니다. A2A를 통해 다른 앱에 전화해야 할 때 연결된 에이전트를 사용하세요.
 
-## @태깅 {#at-tagging}
-
-작업 영역 항목을 참조하려면 채팅 입력에 `@`를 입력하세요. 일치하는 에이전트와 파일을 보여주는 드롭다운이 커서에 나타납니다. 탐색하려면 화살표 키를 사용하고 선택하려면 Enter를 사용하세요. 선택한 항목이 입력에 인라인 칩으로 나타납니다.
-
-메시지를 보내면 **파일/리소스**는 에이전트가 읽을 수 있는 참조로 전달되고, **사용자 지정 에이전트**는 프로필 지침에 따라 로컬로 실행되며, **연결된 에이전트**는 A2A를 통해 호출됩니다.
+## @ 태그와 / 슬래시 명령 {#at-tagging}
 
-## / 슬래시 명령 {#slash-commands}
-
-스킬을 호출하려면 줄 시작 부분에 `/`를 입력하세요. 드롭다운에는 사용 가능한 skills가 이름 및 설명과 함께 표시됩니다. 하나를 선택하면 인라인 칩이 추가되고 메시지가 전송될 때 해당 내용이 컨텍스트로 포함됩니다. skills가 구성되지 않은 경우 드롭다운이 이 문서로 연결됩니다.
+채팅 입력에 `@`를 입력해 에이전트, 파일 또는 리소스를 참조하거나 `/`를 입력해 skill을 호출하세요. 둘 다 커서 위치에 드롭다운을 열고 항목을 선택하면 인라인 칩을 추가합니다. 전체 작동 방식(라우팅, `MentionProvider`, 하위 에이전트 선택)은 [에이전트 멘션](/docs/agent-mentions)을, skills 작성 및 검색 방법은 [Skills 가이드](/docs/skills-guide)를 참조하세요.
 
 ## 코드 대 앱 모드 {#dev-vs-prod}
 
@@ -416,10 +412,6 @@ Workspace에는 두 가지 에이전트 유형이 있습니다.
 
 빠른 시작, 연결/부여/자격 증명 참조 API 및 구체적인 Slack, HubSpot 및 GitHub 예는 [Workspace Connections](/docs/workspace-connections)를 참조하세요.
 
----
-
-# 참고자료
-
 ## 자원 API {#resource-api}
 
 리소스는 서버 코드 actions 또는 REST API에서 관리할 수 있습니다.
@@ -463,3 +455,12 @@ pnpm action resource-write --path "notes/meeting.md" --content "# 회의록..."
 # 리소스 삭제
 pnpm action resource-delete --path "notes/old.md"
 ```
+
+## 다음 단계 {#whats-next}
+
+- [**Skills 가이드**](/docs/skills-guide) — `skills/`에서 참조하는 skill 파일을 작성하고 범위 지정하기
+- [**에이전트 멘션**](/docs/agent-mentions) — `@` 멘션과 `/` 명령의 전체 작동 방식
+- [**반복 작업**](/docs/recurring-jobs) — Scheduled Tasks에서 만든 프롬프트 예약하기
+- [**Workspace 거버넌스**](/docs/workspace-management) — workspace 변경을 검토하고 승인하며 소유하는 주체
+- [**다중 앱 Workspace**](/docs/multi-app-workspace) — 하나의 workspace가 포괄하는 배포 형태
+- [**Workspace 연결**](/docs/workspace-connections) — 앱 간에 제공업체 자격 증명 공유하기

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

@@ -11,7 +11,7 @@ Actions são a única fonte de verdade para tudo o que seu aplicativo faz. Defin
 - **Ganchos Typesafe React** — `useActionQuery("name")` e `useActionMutation("name")` no frontend, tipos inferidos do esquema.
 - **Chamadas de cliente imperativas** — `callAction("name", params)` quando um gancho não cabe.
 - **Transporte de estrutura** — montado automaticamente pela estrutura por trás desses ganchos e disponível para clientes HTTP externos.
-- **Uma ferramenta MCP** — exposta a aplicativos Claude ChatGPT personalizados MCP, Claude Desktop/Code, Cursor, Codex e qualquer outro cliente MCP.
+- **Uma ferramenta MCP** — exposta a aplicativos Claude ChatGPT personalizados MCP, Claude Desktop/Code, Cursor, Codex e qualquer outro host MCP.
 - **Uma ferramenta A2A** — chamada por outros aplicativos nativos do agente em A2A.
 - **Um comando CLI** — `pnpm action <name>` para scripts e loops de desenvolvimento.
 
@@ -562,7 +562,7 @@ export default defineAction({
 });
 ```
 
-Mantenha `link` como substituto para clientes CLI e não UI MCP; é também o alvo de lançamento da incorporação. A ponte de incorporação (a sessão de início de incorporação assinada, transplante vs. renderização de quadro controlado, a ponte de host `ui/*`, CSP e fixação de altura) é propriedade de [External Agents](/docs/external-agents#mcp-app-bridge).
+Mantenha `link` como substituto para a CLI e hosts MCP sem interface de usuário; é também o alvo de lançamento da incorporação. A ponte de incorporação (a sessão de início de incorporação assinada, transplante vs. renderização de quadro controlado, a ponte de host `ui/*`, CSP e fixação de altura) é propriedade de [External Agents](/docs/external-agents#mcp-app-bridge).
 
 ## actions padrão {#standard-actions}
 

package/docs/content/locales/pt-BR/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/docs/content/locales/pt-BR/agent-surfaces.mdx

@@ -141,8 +141,7 @@ pnpm install
 
 Em seguida, defina a operação durável:
 
-```ts
-// actions/summarize-week.ts
+```ts filename="actions/summarize-week.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -496,12 +495,11 @@ Mantenha o contrato pequeno: defina operações duráveis como actions, retorne
 resultados de widget quando o bate-papo precisa de UI rico e adicionar telas inteiras somente quando os usuários
 precisa navegar, comparar, configurar ou colaborar em objetos persistentes.
 
-## Documentos relacionados {#related-docs}
+## Próximos passos {#related-docs}
 
-- [Actions](/docs/actions) — defina a operação sem comando uma vez.
-- [Native Interface de chat](/docs/native-chat-ui) — renderiza os resultados da ação digitada no bate-papo.
-- [Drop-in Agent](/docs/drop-in-agent) — monte bate-papo, barra lateral ou superfícies de painel.
-- [Component API](/docs/components) — peças de bate-papo/compositor React de nível inferior.
-- [Embedding SDK](/docs/embedding-sdk) — adicione Agent-Native a um aplicativo existente.
-- [External Agents](/docs/external-agents) — conecta hosts compatíveis com MCP a um aplicativo.
-- [A2A Protocol](/docs/a2a-protocol) — liga para agentes de outros agentes.
+- [**Actions**](/docs/actions) — defina a operação uma vez; todas as superfícies acima chamam a mesma operação
+- [**Native Interface de chat**](/docs/native-chat-ui) — renderize resultados tipados como tabelas, gráficos e cartões no chat
+- [**Generative UI**](/docs/generative-ui) — gere UI em sandbox, transitória ou persistida, diretamente no chat
+- [**Automation-First Apps**](/docs/pure-agent-apps) — o padrão completo sem navegador para trabalhos, filas, scripts e agentes externos
+- [**External Agents**](/docs/external-agents) — conecte hosts compatíveis com MCP a um aplicativo
+- [**A2A Protocol**](/docs/a2a-protocol) — chame agentes de outros aplicativos Agent-Native

package/docs/content/locales/pt-BR/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/docs/content/locales/pt-BR/authentication.mdx

@@ -15,7 +15,7 @@ A autenticação é configurada automaticamente via `autoMountAuth(app)` no plug
 - **MCP remoto OAuth:** OAuth 2.1 padrão para hosts MCP, como código Claude e conectores ChatGPT.
 - **Personalizado:** Traga sua própria autenticação por meio do retorno de chamada `getSession`.
 
-<Diagram id="doc-block-1rujd8s" title={"Três entradas, uma sessão"} summary={"Visitantes do navegador, clientes MCP programáticos e provedores personalizados resolvem para a mesma AuthSession que o escopo downstream lê."}>
+<Diagram id="doc-block-1rujd8s" title={"Três entradas, uma sessão"} summary={"Visitantes do navegador, hosts MCP e provedores personalizados resolvem para a mesma AuthSession que o escopo downstream lê."}>
 
 ```html
 <div class="auth-modes">

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

@@ -476,10 +476,12 @@ ação para que UI e o agente compartilhem a mesma capacidade.
 ```ts
 import { defineAction } from "@agent-native/core/action";
 import { completeText } from "@agent-native/core/server";
+import { z } from "zod";
 
 export default defineAction({
   description: "Classify a short message",
-  run: async ({ body }: { body: string }) => {
+  schema: z.object({ body: z.string() }),
+  run: async ({ body }) => {
     const result = await completeText({
       systemPrompt: "Return exactly one label.",
       input: body,
@@ -494,3 +496,11 @@ export default defineAction({
 Use `sendToAgentChat({ background: true, openSidebar: false })` quando
 o trabalho precisa de ferramentas, estado, auditabilidade, orientação do usuário ou várias etapas
 raciocínio.
+
+## O que vem a seguir {#whats-next}
+
+- [**Drop-in Agent**](/docs/drop-in-agent) — monte `<AgentSidebar>` e `<AgentPanel>` com um passo a passo voltado ao tutorial
+- [**Native Chat UI**](/docs/native-chat-ui) — o contrato de resultado de ações por trás de widgets de dados e renderizadores personalizados
+- [**Actions**](/docs/actions) — `defineAction()`, esquemas e a superfície de ações chamada por esses componentes
+- [**Real-Time Collaboration**](/docs/real-time-collaboration) — detalhes dos hooks de colaboração e componentes de presença
+- [**Sharing**](/docs/sharing) — configuração de `<ShareButton>` e `<ShareDialog>` para recursos com proprietário

package/docs/content/locales/pt-BR/creating-templates.mdx

@@ -44,7 +44,6 @@ Cada modelo segue o mesmo layout amplo:
 <FileTree
   id="doc-block-1mjrrpg"
   title="Layout do projeto de template"
-  title="my-template/"
   entries={[
     {
       path: "app/",
@@ -172,8 +171,7 @@ As quatro áreas de cada modelo se conectam por meio de uma superfície de açã
 
 Defina tabelas de domínio com os auxiliares da estrutura Drizzle para que os esquemas permaneçam portáveis em SQLite, Postgres, D1, Turso, Supabase, Neon e outros back-ends suportados:
 
-```ts
-// server/db/schema.ts
+```ts filename="server/db/schema.ts"
 import {
   table,
   text,
@@ -204,8 +202,7 @@ As alterações de esquema devem ser aditivas. Adicione tabelas e colunas atrav
 
 Para leituras e gravações de aplicativos, use o construtor de consultas do Drizzle e os operadores portáteis do `drizzle-orm`. Não escreva o código do produto com SQL bruto quando Drizzle puder expressar a consulta e não importe de `drizzle-orm/sqlite-core` ou `drizzle-orm/pg-core` em modelos.
 
-```ts
-// server/plugins/db.ts
+```ts filename="server/plugins/db.ts"
 import { runMigrations } from "@agent-native/core/db";
 
 export default runMigrations(
@@ -349,8 +346,7 @@ Para navegação no aplicativo, prefira um comando `navigate` que inclua uma mes
 `path` quando o URL é conhecido. Não escreva também `__set_url__` para o mesmo movimento;
 essa chave é reservada para as ferramentas da estrutura URL e alterações de filtro somente URL.
 
-```ts
-// actions/navigate.ts
+```ts filename="actions/navigate.ts"
 import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { z } from "zod";

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

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

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

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

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

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

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

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

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

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