@agent-native/core 0.109.2 → 0.109.4

package/docs/content/locales/ko-KR/agent-native-toolkit.mdx

@@ -1,23 +1,15 @@
 ---
-title: "Toolkits"
-description: "Battle-tested reusable building blocks for high-quality agentic applications: collaboration, sharing, settings, teams, setup, navigation, resources, agent UX, history, comments, and observability."
+title: "Toolkit"
+description: "재사용 가능한 기반, 편집기와 캔버스, 에이전트 컨텍스트, 거버넌스, 워크스페이스 크롬, 운영 및 Toolkit 기능 모듈을 담은 균형 잡힌 카탈로그입니다."
 ---
 
 <!-- i18n-docs-ignore -->
 
-# Toolkits
+# Toolkit
 
-Toolkits are reusable, battle-tested building blocks for high-quality agentic
-applications. They turn the hard product work that repeats across apps into
-standard surfaces: realtime collaboration between humans and agents, sharing
-with humans and agents, settings, teams, setup, resources, history, review, and
-observability.
+Toolkit은 고품질 에이전트형 애플리케이션을 위한 재사용 가능하고 실전에서 검증된 구성 요소입니다. 앱 전반에서 반복되는 어려운 제품 작업을 사람과 에이전트 사이의 실시간 협업, 사람과 에이전트를 위한 공유, 설정, 팀, 설정 과정, 리소스, 기록, 검토, 관찰 가능성과 같은 표준 화면으로 만듭니다.
 
-Each kit packages the UI patterns, action contracts, app-state expectations,
-access boundaries, and agent-visible behavior that users expect to work
-consistently. Apps still own their domain model and visual identity; toolkits
-make the common product systems feel complete from the first version instead of
-being rebuilt in slightly different ways every time.
+각 키트는 사용자가 일관되게 동작하리라 기대하는 UI 패턴, 액션 계약, 앱 상태 기대치, 접근 경계, 에이전트에 보이는 동작을 묶습니다. 앱은 여전히 도메인 모델과 시각적 정체성을 소유합니다. Toolkit은 공통 제품 시스템을 매번 조금씩 다르게 다시 만들지 않고 첫 버전부터 완성된 느낌이 들게 합니다.
 
 <WireframeBlock id="doc-block-toolkits-index">
   <Screen
@@ -28,23 +20,23 @@ being rebuilt in slightly different ways every time.
   />
 </WireframeBlock>
 
-<Diagram id="doc-block-toolkits-boundary" title="How kits fit" summary={"The framework runtime supplies durable guarantees. Toolkits turn those guarantees into reusable product systems. Apps add domain-specific data, routes, and visual identity."}>
+<Diagram id="doc-block-toolkits-boundary" title="키트의 위치" summary={"프레임워크 런타임은 지속적인 보장을 제공합니다. Toolkit은 그 보장을 재사용 가능한 제품 시스템으로 바꿉니다. 앱은 도메인별 데이터, 라우트, 시각적 정체성을 더합니다."}>
 
 ```html
 <div class="diagram-row">
   <div class="diagram-card">
-    <span class="diagram-pill accent">Runtime</span><br />
-    actions, SQL, auth, app state, access checks, realtime transport
+    <span class="diagram-pill accent">런타임</span><br />
+    액션, SQL, 인증, 앱 상태, 접근 검사, 실시간 전송
   </div>
   <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
   <div class="diagram-card">
-    <span class="diagram-pill accent">Toolkits</span><br />
-    collaboration, sharing, setup, review, history, observability
+    <span class="diagram-pill accent">Toolkit</span><br />
+    협업, 공유, 설정 과정, 검토, 기록, 관찰 가능성
   </div>
   <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
   <div class="diagram-card">
-    <span class="diagram-pill accent">Apps</span><br />
-    domain schema, routes, actions, branding, specialized workflows
+    <span class="diagram-pill accent">앱</span><br />
+    도메인 스키마, 라우트, 액션, 브랜딩, 전문 워크플로
   </div>
 </div>
 ```
@@ -68,45 +60,60 @@ being rebuilt in slightly different ways every time.
 
 </Diagram>
 
-## The Kits {#the-kits}
-
-| Kit                                                      | Use it for                                                                                                  |
-| -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
-| [Sharing](/docs/toolkit-sharing)                         | Ownable resources, share dialogs, visibility badges, share actions, public/private/org access.              |
-| [Collaboration](/docs/toolkit-collaboration)             | Realtime editing, presence, live cursors, recent-edit highlights, collaborative undo.                       |
-| [Settings](/docs/toolkit-settings)                       | Standard settings pages and tabs so app settings and agent/provider settings live in one predictable place. |
-| [Org & Team](/docs/toolkit-org-team)                     | Team pages, org switching, invites, org domains, roles, and app switching.                                  |
-| [Setup & Connections](/docs/toolkit-setup-connections)   | Onboarding, secrets, workspace connections, OAuth/provider readiness, and Builder connect.                  |
-| [Command & Navigation](/docs/toolkit-command-navigation) | Command menu, deep links, standard app routes, sidebar and shell patterns.                                  |
-| [Resources](/docs/toolkit-resources)                     | Resource trees, editors, file picker/search, attachments, and local file mode.                              |
-| [Agent UX](/docs/toolkit-agent-ux)                       | Composer, model picker, context chips, approvals, run recovery, and the runs tray.                          |
-| [History](/docs/toolkit-history)                         | Version history, audit logs, undo/redo, restore, and "what changed" surfaces.                               |
-| [Comments & Review](/docs/toolkit-comments-review)       | Inline comments, annotations, mentions, resolved threads, review status.                                    |
-| [Observability](/docs/toolkit-observability)             | Usage, spend, feedback, replay, errors, and run diagnostics.                                                |
-
-## Implementation Boundary {#implementation-boundary}
-
-Kits are product surfaces first. Some pieces are runtime-backed
-(`@agent-native/core`), some are presentation primitives
-(`@agent-native/toolkit`), and apps usually wrap both through local adapters.
-Use the package path that owns the needed behavior, but design the user-facing
-settings, collaboration, sharing, team, review, and setup experiences as one
-coherent kit instead of exposing package boundaries in the app.
-
-## Foundation Pieces {#foundation-pieces}
-
-- [UI Primitives](/docs/toolkit-ui) cover shared shadcn-style primitives under
-  `@agent-native/toolkit/ui/*`.
-- [App Adapters](/docs/toolkit-ui#app-adapters) show how apps wrap Toolkit pieces
-  through local `@/components/*` adapters.
-- [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.
-
-## Design Rule {#design-rule}
-
-Use a toolkit when the behavior repeats across apps and users expect it to feel
-standard: sharing, settings, teams, comments, history, and agent progress should
-not be slightly different in every template. Keep domain-specific data,
-workflows, labels, and visual styling in the app.
+## 카탈로그 {#catalog}
+
+| 영역                     | 시작점                                             | 포함 내용                                                               |
+| ------------------------ | -------------------------------------------------- | ----------------------------------------------------------------------- |
+| 기반                     | [UI 프리미티브](/docs/toolkit-ui)                  | 공유 컨트롤, 훅, 앱 어댑터, 셸 연결 지점.                               |
+| 편집기와 캔버스          | [편집기와 캔버스](/docs/toolkit-editors-canvases)  | 리치 편집, 구조화된 블록, 재사용 가능한 캔버스 컨트롤, Design 패턴.     |
+| 에이전트 경험과 컨텍스트 | [컨텍스트와 지식](/docs/toolkit-context-knowledge) | Context X-Ray, 리소스, 지식, 컴포저 컨텍스트 및 에이전트에 보이는 상태. |
+| 협업과 거버넌스          | [협업](/docs/toolkit-collaboration)                | 공유, 현재 상태, 검토, 기록, 감사 및 조직 경계.                         |
+| 워크스페이스 크롬        | [앱 크롬](/docs/toolkit-settings)                  | 설정, 팀, 설정 과정, 탐색, 리소스 및 에이전트 UX.                       |
+| 운영                     | [관찰 가능성](/docs/toolkit-observability)         | 사용량, 피드백, 리플레이, 진단 및 운영 가시성.                          |
+| Toolkit 기능 모듈        | [기능 패키지](/docs/toolkit-capability-packages)   | 필요 시 설치하는 도메인 패키지와 수명 주기 매니페스트.                  |
+
+## 제품 키트 {#product-kits}
+
+| 키트                                             | 용도                                                                                  |
+| ------------------------------------------------ | ------------------------------------------------------------------------------------- |
+| [공유](/docs/toolkit-sharing)                    | 소유 가능한 리소스, 공유 대화 상자, 공개 범위 배지, 공유 액션, 공개/비공개/조직 접근. |
+| [협업](/docs/toolkit-collaboration)              | 실시간 편집, 현재 상태, 라이브 커서, 최근 편집 강조, 협업 실행 취소.                  |
+| [설정](/docs/toolkit-settings)                   | 앱 설정과 에이전트/프로바이더 설정을 예측 가능한 한곳에 두는 표준 설정 페이지와 탭.   |
+| [조직 및 팀](/docs/toolkit-org-team)             | 팀 페이지, 조직 전환, 초대, 조직 도메인, 역할, 앱 전환.                               |
+| [설정 및 연결](/docs/toolkit-setup-connections)  | 온보딩, 시크릿, 워크스페이스 연결, OAuth/프로바이더 준비 상태, Builder 연결.          |
+| [명령 및 탐색](/docs/toolkit-command-navigation) | 명령 메뉴, 딥 링크, 표준 앱 라우트, 사이드바와 셸 패턴.                               |
+| [리소스](/docs/toolkit-resources)                | 리소스 트리, 편집기, 파일 선택/검색, 첨부 파일, 로컬 파일 모드.                       |
+| [에이전트 UX](/docs/toolkit-agent-ux)            | 컴포저, 모델 선택기, 컨텍스트 칩, 승인, 실행 복구, 실행 트레이.                       |
+| [기록](/docs/toolkit-history)                    | 버전 기록, 감사 로그, 실행 취소/다시 실행, 복원, 변경 사항 화면.                      |
+| [댓글 및 검토](/docs/toolkit-comments-review)    | 인라인 댓글, 주석, 멘션, 해결된 스레드, 검토 상태.                                    |
+| [관찰 가능성](/docs/toolkit-observability)       | 사용량, 비용, 피드백, 재생, 오류, 실행 진단.                                          |
+
+## 패키지 성숙도와 소유권 {#package-maturity-and-ownership}
+
+- 리치 편집기는 **Toolkit** 소유입니다. 마이그레이션 동안 기존 Core import는 얇은 호환 re-export로 유지됩니다.
+- Design은 재사용 가능한 `design-tweaks`를 사용하는 **템플릿 패턴**이며, 완전한 드롭인 편집기나 캔버스가 아닙니다.
+- Blocks와 Context X-Ray 엔진은 이 단계에서 **Core 소유**로 유지됩니다. 재사용 가능한 Context X-Ray 표현은 Toolkit 소유입니다.
+- Creative Context, Scheduling, Pinpoint는 필요 시 설치하는 **Toolkit 기능 모듈**이며 별도의 npm 패키지와 수명 주기 매니페스트를 유지합니다. Dispatch는 별도 제품입니다.
+
+## 구현 경계 {#implementation-boundary}
+
+키트는 우선 제품 화면입니다. 일부는 런타임을 기반으로 하고(`@agent-native/core`), 일부는 표현 프리미티브이며(`@agent-native/toolkit`), 앱은 보통 로컬 어댑터로 둘 다 감쌉니다. 필요한 동작을 소유하는 패키지 경로를 사용하되, 사용자 대상 설정, 협업, 공유, 팀, 검토, 설정 경험은 앱에서 패키지 경계를 드러내지 않는 하나의 일관된 키트로 설계하세요.
+
+## 기반 구성 요소 {#foundation-pieces}
+
+- [UI 프리미티브](/docs/toolkit-ui)는 `@agent-native/toolkit/ui/*`의 공유 shadcn 스타일 프리미티브를 다룹니다.
+- [앱 어댑터](/docs/toolkit-ui#app-adapters)는 앱이 로컬 `@/components/*` 어댑터로 Toolkit 구성 요소를 감싸는 방법을 보여 줍니다.
+- [셸 및 훅](/docs/toolkit-ui#shell-hooks)은 헤더 액션, 모바일 훅, 토스트, 작은 앱 셸 도우미를 다룹니다.
+- [컴포넌트 API](/docs/components)는 공개 React export의 하위 수준 참조입니다.
+
+## 설계 원칙 {#design-rule}
+
+동작이 앱 전체에서 반복되고 사용자가 표준적인 느낌을 기대한다면 Toolkit을 사용하세요. 공유, 설정, 팀, 댓글, 기록, 에이전트 진행 상황은 템플릿마다 조금씩 달라서는 안 됩니다. 도메인별 데이터, 워크플로, 라벨, 시각적 스타일은 앱에 유지하세요.
+
+## 다음 단계
+
+- [**Toolkit UI 프리미티브**](/docs/toolkit-ui) — 공유 프리미티브, 앱 어댑터, 셸 훅.
+- [**공유 키트**](/docs/toolkit-sharing) — 리소스, 공유 대화상자, 가시성을 위한 좋은 첫 키트.
+- [**템플릿 만들기**](/docs/creating-templates) — 템플릿을 처음부터 만들고 키트가 어디에 맞는지 확인합니다.
+- [**컴포넌트 API**](/docs/components) — 모든 공개 React export의 참조입니다.
+- [**패키지 수명 주기**](/docs/package-lifecycle) — manifest 기반 Toolkit 기능 모듈을 안전하게 검사, 추가, eject합니다.

package/docs/content/locales/ko-KR/toolkit-capability-packages.mdx

@@ -0,0 +1,21 @@
+---
+title: "Capability 패키지"
+description: "도메인 기능과 매니페스트 기반 수명 주기를 Toolkit에 흡수하지 않고 관리합니다."
+---
+
+# Capability 패키지
+
+Toolkit은 횡단적인 제품 기반을 제공하고 Capability 패키지는 제한된 도메인, actions, skills 및 수명 주기 메타데이터를 제공합니다. Scheduling과 Creative Context는 Toolkit 키트가 아닌 별도 Capability 패키지입니다.
+
+`@agent-native/scheduling`은 일반 매니페스트 파일럿에 참여합니다. 확장 지점과 소유권은 각 패키지의 로컬 문서와 매니페스트를 참조하세요.
+
+- [Scheduling 패키지 문서](https://github.com/BuilderIO/agent-native/tree/main/packages/scheduling/docs)
+- [Creative Context 패키지 문서](https://github.com/BuilderIO/agent-native/tree/main/packages/creative-context/docs)
+
+```bash
+agent-native package inspect @agent-native/scheduling
+agent-native package add @agent-native/scheduling --apply
+agent-native package eject @agent-native/scheduling --apply
+```
+
+검사, dry run, eject 규칙은 [Package Lifecycle](/docs/package-lifecycle)를 참조하세요.

package/docs/content/locales/ko-KR/toolkit-context-knowledge.mdx

@@ -0,0 +1,12 @@
+---
+title: "컨텍스트와 지식"
+description: "엔진, 데이터 접근, 재사용 가능한 표현 계층을 지키며 에이전트 인식 컨텍스트 표면을 만듭니다."
+---
+
+# 컨텍스트와 지식
+
+Core는 애플리케이션 상태, 범위가 지정된 접근 및 Context X-Ray 엔진을 소유합니다. Toolkit은 재사용 가능한 표현을 제공하고 앱은 도메인 레코드, 분류 및 선택 규칙을 소유합니다.
+
+Context X-Ray 엔진은 Core 소유입니다. 일관된 표현에는 Toolkit을 사용하되 상태와 접근 결정은 Core와 actions에 둡니다. [Context awareness](/docs/context-awareness)는 탐색, 선택 및 포커스된 객체를 에이전트에 알리고 [Resources](/docs/toolkit-resources)는 파일과 첨부를 다룹니다.
+
+컨텍스트는 접근 제어를 대체하지 않습니다. 공급자 지식을 검색하기 전에 리소스와 자격 증명 확인을 유지하세요.

package/docs/content/locales/ko-KR/toolkit-editors-canvases.mdx

@@ -0,0 +1,17 @@
+---
+title: "에디터와 캔버스"
+description: "Core 호환성, 템플릿 패턴, Toolkit 프리미티브를 혼동하지 않고 재사용 가능한 표면을 선택합니다."
+---
+
+# 에디터와 캔버스
+
+에디터와 캔버스는 관련된 표면이지 하나의 대표 기능이 아닙니다.
+
+| 표면        | 현재 소유권                                                         |
+| ----------- | ------------------------------------------------------------------- |
+| 리치 에디터 | Toolkit 소유, Core 호환성 재내보내기 제공.                          |
+| 블록        | 이 단계에서는 Core.                                                 |
+| Design      | `design-tweaks`가 있는 템플릿 패턴이며 완전한 드롭인 에디터가 아님. |
+| 캔버스 표현 | Toolkit 또는 앱 조합.                                               |
+
+에디터는 `@agent-native/toolkit/editor`에서 가져옵니다. 기존 Core 경로는 호환성 재내보내기로 유지됩니다. 스키마, 명령, 저장은 앱에 둡니다. 블록은 Core에 남지만 Toolkit 섹션이 재사용 UI 카탈로그이므로 문서는 여기에 함께 둡니다.

package/docs/content/locales/pt-BR/agent-native-toolkit.mdx

@@ -1,21 +1,24 @@
 ---
-title: "Toolkits"
-description: "Battle-tested reusable building blocks for high-quality agentic applications: collaboration, sharing, settings, teams, setup, navigation, resources, agent UX, history, comments, and observability."
+title: "Toolkit"
+description: "Um catálogo equilibrado de fundações reutilizáveis, editores e telas, contexto de agente, governança, estrutura do espaço de trabalho, operações e módulos de capacidade do Toolkit."
 ---
 
 <!-- i18n-docs-ignore -->
 
-# Toolkits
+# Toolkit
 
-Toolkits are reusable, battle-tested building blocks for high-quality agentic
-applications. They turn the hard product work that repeats across apps into
-standard surfaces: realtime collaboration between humans and agents, sharing
-with humans and agents, settings, teams, setup, resources, history, review, and
-observability.
+Toolkit é a prateleira de blocos reutilizáveis e testados em produção para apps
+agênticos de qualidade. Ele transforma o trabalho de produto repetido entre apps
+em superfícies padrão, sem colocar um padrão de app no centro do catálogo.
+
+Esta seção é a prateleira única para descobrir UI reutilizável. Uma superfície
+entra nestes documentos porque é reutilizável, mesmo quando Core ou um template
+a possui hoje. Rótulos de propriedade e caminhos de importação deixam esse
+limite claro sem espalhar a orientação de UI pelo site.
 
 Each kit packages the UI patterns, action contracts, app-state expectations,
 access boundaries, and agent-visible behavior that users expect to work
-consistently. Apps still own their domain model and visual identity; toolkits
+consistently. Apps still own their domain model and visual identity; Toolkit
 make the common product systems feel complete from the first version instead of
 being rebuilt in slightly different ways every time.
 
@@ -28,23 +31,25 @@ being rebuilt in slightly different ways every time.
   />
 </WireframeBlock>
 
-<Diagram id="doc-block-toolkits-boundary" title="How kits fit" summary={"The framework runtime supplies durable guarantees. Toolkits turn those guarantees into reusable product systems. Apps add domain-specific data, routes, and visual identity."}>
+<Diagram id="doc-block-toolkits-boundary" title="Como os kits se encaixam" summary={"O runtime do framework fornece garantias duráveis. Toolkit as transforma em sistemas de produto reutilizáveis. Apps adicionam dados de domínio, rotas e identidade visual."}>
 
 ```html
 <div class="diagram-row">
   <div class="diagram-card">
     <span class="diagram-pill accent">Runtime</span><br />
-    actions, SQL, auth, app state, access checks, realtime transport
+    ações, SQL, autenticação, estado do app, verificações de acesso, transporte
+    em tempo real
   </div>
   <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
   <div class="diagram-card">
-    <span class="diagram-pill accent">Toolkits</span><br />
-    collaboration, sharing, setup, review, history, observability
+    <span class="diagram-pill accent">Toolkit</span><br />
+    colaboração, compartilhamento, configuração, revisão, histórico,
+    observabilidade
   </div>
   <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
   <div class="diagram-card">
     <span class="diagram-pill accent">Apps</span><br />
-    domain schema, routes, actions, branding, specialized workflows
+    esquema de domínio, rotas, ações, marca, fluxos especializados
   </div>
 </div>
 ```
@@ -68,45 +73,68 @@ being rebuilt in slightly different ways every time.
 
 </Diagram>
 
-## The Kits {#the-kits}
-
-| Kit                                                      | Use it for                                                                                                  |
-| -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
-| [Sharing](/docs/toolkit-sharing)                         | Ownable resources, share dialogs, visibility badges, share actions, public/private/org access.              |
-| [Collaboration](/docs/toolkit-collaboration)             | Realtime editing, presence, live cursors, recent-edit highlights, collaborative undo.                       |
-| [Settings](/docs/toolkit-settings)                       | Standard settings pages and tabs so app settings and agent/provider settings live in one predictable place. |
-| [Org & Team](/docs/toolkit-org-team)                     | Team pages, org switching, invites, org domains, roles, and app switching.                                  |
-| [Setup & Connections](/docs/toolkit-setup-connections)   | Onboarding, secrets, workspace connections, OAuth/provider readiness, and Builder connect.                  |
-| [Command & Navigation](/docs/toolkit-command-navigation) | Command menu, deep links, standard app routes, sidebar and shell patterns.                                  |
-| [Resources](/docs/toolkit-resources)                     | Resource trees, editors, file picker/search, attachments, and local file mode.                              |
-| [Agent UX](/docs/toolkit-agent-ux)                       | Composer, model picker, context chips, approvals, run recovery, and the runs tray.                          |
-| [History](/docs/toolkit-history)                         | Version history, audit logs, undo/redo, restore, and "what changed" surfaces.                               |
-| [Comments & Review](/docs/toolkit-comments-review)       | Inline comments, annotations, mentions, resolved threads, review status.                                    |
-| [Observability](/docs/toolkit-observability)             | Usage, spend, feedback, replay, errors, and run diagnostics.                                                |
-
-## Implementation Boundary {#implementation-boundary}
-
-Kits are product surfaces first. Some pieces are runtime-backed
+## Catálogo {#catalog}
+
+| Área                             | Comece aqui                                                | O que cobre                                                                               |
+| -------------------------------- | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
+| Fundamentos                      | [Primitivos de UI](/docs/toolkit-ui)                       | Controles, hooks, adaptadores de app e integrações de shell compartilhados.               |
+| Editores e telas                 | [Editores e telas](/docs/toolkit-editors-canvases)         | Edição rica, blocos estruturados, controles de tela e padrões de Design.                  |
+| Experiência e contexto do agente | [Contexto e conhecimento](/docs/toolkit-context-knowledge) | Context X-Ray, recursos, conhecimento, contexto do compositor e estado visível ao agente. |
+| Colaboração e governança         | [Colaboração](/docs/toolkit-collaboration)                 | Compartilhamento, presença, revisão, histórico, auditoria e limites organizacionais.      |
+| Estrutura do espaço de trabalho  | [Chrome do app](/docs/toolkit-settings)                    | Configurações, equipes, setup, navegação, recursos e UX do agente.                        |
+| Operações                        | [Observabilidade](/docs/toolkit-observability)             | Uso, feedback, replay, diagnóstico e visibilidade operacional.                            |
+| Módulos de capacidade do Toolkit | [Pacotes de capacidade](/docs/toolkit-capability-packages) | Pacotes de domínio instalados sob demanda e seus manifestos de ciclo de vida.             |
+
+## Kits de produto {#product-kits}
+
+| Kit                                                      | Use para                                                                                         |
+| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
+| [Sharing](/docs/toolkit-sharing)                         | Recursos próprios, diálogos/ações de compartilhar, visibilidade e acesso público/privado/org.    |
+| [Collaboration](/docs/toolkit-collaboration)             | Edição em tempo real, presença, cursores ao vivo, mudanças recentes e desfazer colaborativo.     |
+| [Settings](/docs/toolkit-settings)                       | Páginas e abas padrão para configurações do app e do agente/provedor no mesmo lugar.             |
+| [Org & Team](/docs/toolkit-org-team)                     | Páginas de equipe, troca de organização, convites, domínios, papéis e troca de app.              |
+| [Setup & Connections](/docs/toolkit-setup-connections)   | Onboarding, segredos, conexões de workspace, OAuth/prontidão de provedor e Builder connect.      |
+| [Command & Navigation](/docs/toolkit-command-navigation) | Menu de comandos, links profundos, rotas padrão, padrões de barra lateral e shell.               |
+| [Resources](/docs/toolkit-resources)                     | Árvores/editores de recursos, seletor/busca de arquivos, anexos e modo de arquivo local.         |
+| [Agent UX](/docs/toolkit-agent-ux)                       | Compositor, seletor de modelo, chips de contexto, aprovações, recuperação e gaveta de execuções. |
+| [History](/docs/toolkit-history)                         | Recursos versionados, snapshots, histórico, auditoria, desfazer/refazer, restauração e mudanças. |
+| [Comments & Review](/docs/toolkit-comments-review)       | Recursos revisáveis, comentários, feedback, threads, menções, resolução e status de revisão.     |
+| [Observability](/docs/toolkit-observability)             | Uso, gastos, feedback, replay, erros e diagnósticos de execução.                                 |
+
+## Maturidade e propriedade de pacotes {#package-maturity-and-ownership}
+
+- O editor rico pertence ao **Toolkit**; imports Core existentes permanecem reexports de compatibilidade leves durante a migração.
+- Design é um **padrão de template** com `design-tweaks` reutilizáveis, não um editor ou tela completa pronta para uso.
+- Blocks e o mecanismo Context X-Ray permanecem propriedade do **Core** nesta fase; a apresentação reutilizável de Context X-Ray pertence ao Toolkit.
+- Creative Context, Scheduling e Pinpoint são **módulos de capacidade do Toolkit** instalados sob demanda; mantêm pacotes npm e manifestos de ciclo de vida separados. Dispatch permanece um produto separado.
+
+## Limite de implementação {#implementation-boundary}
+
+Kits são primeiro superfícies de produto. Algumas partes usam o runtime
 (`@agent-native/core`), some are presentation primitives
 (`@agent-native/toolkit`), and apps usually wrap both through local adapters.
-Use the package path that owns the needed behavior, but design the user-facing
-settings, collaboration, sharing, team, review, and setup experiences as one
-coherent kit instead of exposing package boundaries in the app.
-
-## Foundation Pieces {#foundation-pieces}
-
-- [UI Primitives](/docs/toolkit-ui) cover shared shadcn-style primitives under
-  `@agent-native/toolkit/ui/*`.
-- [App Adapters](/docs/toolkit-ui#app-adapters) show how apps wrap Toolkit pieces
-  through local `@/components/*` adapters.
-- [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.
-
-## Design Rule {#design-rule}
-
-Use a toolkit when the behavior repeats across apps and users expect it to feel
-standard: sharing, settings, teams, comments, history, and agent progress should
-not be slightly different in every template. Keep domain-specific data,
-workflows, labels, and visual styling in the app.
+Use o caminho do pacote que possui o comportamento necessário, mas projete
+configurações, colaboração, compartilhamento, equipe, revisão e setup como um
+kit coerente, sem expor limites de pacotes no app.
+
+## Peças fundamentais {#foundation-pieces}
+
+- [Primitivos de UI](/docs/toolkit-ui) cobre primitivos compartilhados no estilo
+  shadcn em `@agent-native/toolkit/ui/*`, adaptadores locais e hooks de shell.
+- A [API de componentes](/docs/components) continua sendo a referência de baixo
+  nível para exports React públicos.
+
+## Regra de design {#design-rule}
+
+Use um kit quando o comportamento se repete entre apps e as pessoas esperam uma
+experiência padrão: compartilhamento, configurações, equipes, comentários,
+histórico e progresso do agente não devem variar entre templates. Mantenha no
+app os dados, fluxos, rótulos e estilo visual específicos do domínio.
+
+## Próximos passos
+
+- [**Primitivos de UI do Toolkit**](/docs/toolkit-ui) — primitivos compartilhados, adaptadores de app e hooks de shell.
+- [**Kit de compartilhamento**](/docs/toolkit-sharing) — um bom primeiro kit para recursos, diálogos de compartilhamento e visibilidade.
+- [**Criar templates**](/docs/creating-templates) — crie um template completo e veja onde os kits se encaixam.
+- [**API de componentes**](/docs/components) — a referência de todos os exports públicos do React.
+- [**Ciclo de vida de pacotes**](/docs/package-lifecycle) — inspecione, adicione e ejete módulos de capacidade do Toolkit guiados por manifesto com segurança.

package/docs/content/locales/pt-BR/toolkit-capability-packages.mdx

@@ -0,0 +1,21 @@
+---
+title: "Pacotes de capacidade"
+description: "Gerencie capacidades de domínio e seu ciclo de vida por manifesto sem incorporá-las ao Toolkit."
+---
+
+# Pacotes de capacidade
+
+O Toolkit fornece fundações de produto transversais; pacotes de capacidade trazem domínio delimitado, actions, skills e metadados de ciclo de vida. Scheduling e Creative Context permanecem pacotes de capacidade separados, não kits do Toolkit.
+
+`@agent-native/scheduling` participa do piloto do manifesto genérico. Consulte a documentação e o manifesto locais de cada pacote para pontos de extensão e responsabilidade.
+
+- [Documentação do pacote Scheduling](https://github.com/BuilderIO/agent-native/tree/main/packages/scheduling/docs)
+- [Documentação do pacote Creative Context](https://github.com/BuilderIO/agent-native/tree/main/packages/creative-context/docs)
+
+```bash
+agent-native package inspect @agent-native/scheduling
+agent-native package add @agent-native/scheduling --apply
+agent-native package eject @agent-native/scheduling --apply
+```
+
+Veja [Ciclo de vida de pacotes](/docs/package-lifecycle) para inspeção, simulação e eject.

package/docs/content/locales/pt-BR/toolkit-context-knowledge.mdx

@@ -0,0 +1,12 @@
+---
+title: "Contexto e conhecimento"
+description: "Crie superfícies de contexto para agentes respeitando as camadas de mecanismo, acesso a dados e apresentação reutilizável."
+---
+
+# Contexto e conhecimento
+
+O Core mantém estado da aplicação, acesso com escopo e o mecanismo Context X-Ray. O Toolkit fornece a apresentação reutilizável; o app mantém registros de domínio, taxonomia e regras de seleção.
+
+O mecanismo Context X-Ray continua no Core. Use a apresentação do Toolkit para contexto consistente, mas mantenha decisões de estado e acesso no Core e nas actions. [Context awareness](/docs/context-awareness) expõe navegação, seleção e objeto em foco ao agente; [Resources](/docs/toolkit-resources) cobre arquivos e anexos.
+
+Contexto não substitui controles de acesso. Preserve verificações de recurso e credencial antes de recuperar conhecimento de provedores.

package/docs/content/locales/pt-BR/toolkit-editors-canvases.mdx

@@ -0,0 +1,17 @@
+---
+title: "Editores e canvases"
+description: "Escolha superfícies reutilizáveis sem confundir compatibilidade do Core, padrões de template e primitivas do Toolkit."
+---
+
+# Editores e canvases
+
+Editores e canvases são superfícies relacionadas, não um único recurso principal.
+
+| Superfície             | Responsabilidade atual                                                          |
+| ---------------------- | ------------------------------------------------------------------------------- |
+| Editor rico            | Toolkit, com reexportações de compatibilidade pelo Core.                        |
+| Blocos                 | Core nesta fase.                                                                |
+| Design                 | Padrão de template com `design-tweaks`, não um editor completo pronto para uso. |
+| Apresentação de canvas | Composição do Toolkit ou do app.                                                |
+
+Importe o editor de `@agent-native/toolkit/editor`. Os caminhos antigos do Core continuam como reexportações de compatibilidade. Mantenha esquemas, comandos e persistência no app. Os blocos ficam no Core, mas são documentados aqui porque a seção Toolkit é o catálogo de UI reutilizável.