@agent-native/core 0.109.3 → 0.110.0

package/docs/content/locales/ko-KR/real-time-collaboration.mdx

@@ -258,7 +258,7 @@ export default createCollabPlugin({
 ### 4. 클라이언트 후크를 사용하세요
 
 ```ts
-import { useCollaborativeDoc } from "@agent-native/core/client";
+import { useCollaborativeDoc } from "@agent-native/core/client/collab";
 import { emailToColor, emailToName } from "@agent-native/toolkit/collab-ui";
 
 const TAB_ID = generateTabId(); // or Math.random().toString(36)
@@ -431,8 +431,7 @@ import {
 원격 참가자의 반응 목록과 로컬 존재 페이로드에 대한 설정자를 반환합니다.
 
 ```ts
-import { usePresence } from "@agent-native/core/client";
-
+import { usePresence } from "@agent-native/core/client/collab";
 const { others, setPresence } = usePresence(awareness, ydoc?.clientID);
 
 // Publish cursor position (normalized 0–1)
@@ -494,8 +493,7 @@ import { RemoteSelectionRings } from "@agent-native/toolkit/collab-ui";
 팔로우하는 참가자의 뷰포트가 변경될 때마다 콜백을 호출합니다.
 
 ```ts
-import { useFollowUser } from "@agent-native/core/client";
-
+import { useFollowUser } from "@agent-native/core/client/collab";
 const { isFollowing, stopFollowing } = useFollowUser({
   others,
   followingId, // null to stop following
@@ -529,8 +527,7 @@ const { isFollowing, stopFollowing } = useFollowUser({
 ### 정규화된 좌표 도우미 {#norm-coords}
 
 ```ts
-import { toNormalized, fromNormalized } from "@agent-native/core/client";
-
+import { toNormalized, fromNormalized } from "@agent-native/core/client/collab";
 // In a pointer event handler:
 const norm = toNormalized(
   e.clientX,

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

@@ -122,8 +122,7 @@ description: "프레임워크에 내장된 익숙하고 일관된 공유 기능
 공유 버튼은 단일 가져오기입니다:
 
 ```tsx
-import { ShareButton } from "@agent-native/core/client";
-
+import { ShareButton } from "@agent-native/core/client/sharing";
 <ShareButton
   resourceType="deck"
   resourceId={deck.id}

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

@@ -162,8 +162,7 @@ npx @agent-native/core@latest create my-agent --headless
 
 ```tsx
 // app/routes/_index.tsx
-import { AgentChatSurface } from "@agent-native/core/client";
-
+import { AgentChatSurface } from "@agent-native/core/client/agent-chat";
 export default function ChatRoute() {
   return (
     <AgentChatSurface

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/ko-KR/tracking.mdx

@@ -176,8 +176,7 @@ Identity is resolved **server-side** from the session — browser code never pas
 </Endpoint>
 
 ```ts
-import { track } from "@agent-native/core/client";
-
+import { track } from "@agent-native/core/client/analytics";
 // e.g. inside a click handler or effect
 track("checkout.completed", { total: 49.99, items: 3 });
 ```
@@ -196,8 +195,7 @@ track("checkout.completed", { total: 49.99, items: 3 });
 Agent Native 앱은 두 번째 분석 SDK를 추가하지 않고도 퍼스트파티 브라우저 세션 리플레이를 사용하도록 설정할 수 있습니다. 브라우저 루트에서 `configureTracking()`을 한 번 호출하고 Analytics 공개 키와 수집기 엔드포인트를 전달하세요.
 
 ```ts
-import { configureTracking } from "@agent-native/core/client";
-
+import { configureTracking } from "@agent-native/core/client/analytics";
 configureTracking({
   key: "anpk_...",
   endpoint: "https://analytics.example.com/api/analytics/track",

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

@@ -284,8 +284,7 @@ const { mutate } = useActionMutation("reply-to-email");
 
 ```tsx
 // And the agent panel mounted anywhere in your app
-import { AgentSidebar } from "@agent-native/core/client";
-
+import { AgentSidebar } from "@agent-native/core/client/agent-chat";
 <AgentSidebar />;
 ```
 

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

@@ -443,8 +443,7 @@ Dois ganchos, ambos em `@agent-native/core/client`. Os tipos são inferidos a pa
 Para actions que muda de estado:
 
 ```tsx
-import { useActionMutation } from "@agent-native/core/client";
-
+import { useActionMutation } from "@agent-native/core/client/hooks";
 const { mutate, isPending } = useActionMutation("reply-to-email");
 
 <Button
@@ -462,8 +461,7 @@ Em caso de sucesso, a estrutura emite um evento de mudança com `source: "action
 Para GET actions somente leitura:
 
 ```ts
-import { useActionQuery } from "@agent-native/core/client";
-
+import { useActionQuery } from "@agent-native/core/client/hooks";
 const { data, isLoading } = useActionQuery("get-lead", { leadId });
 ```
 

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/agent-surfaces.mdx

@@ -15,8 +15,7 @@ para que os modos Resources e Settings apontem para a página completa sem
 duplicar esses fluxos.
 
 ```tsx filename="app/routes/agent.tsx"
-import { AgentTabsPage } from "@agent-native/core/client";
-
+import { AgentTabsPage } from "@agent-native/core/client/agent-chat";
 export default function AgentRoute() {
   return <AgentTabsPage />;
 }
@@ -415,8 +414,7 @@ export default createAgentNativeEmbeddedPlugin({
 O sidecar React passa o contexto da página e comandos de host:
 
 ```tsx
-import { AgentNativeEmbedded } from "@agent-native/core/client";
-
+import { AgentNativeEmbedded } from "@agent-native/core/client/host";
 export function AppShell({ children }) {
   return (
     <AgentNativeEmbedded

package/docs/content/locales/pt-BR/audit-log.mdx

@@ -82,8 +82,7 @@ Três leituras actions estão disponíveis para o agente **e** o frontend em cad
 Crie um feed de atividades ou uma linha "quem mudou isto" chamando `list-audit-events` do UI com `useActionQuery` — nunca escreva manualmente uma busca na tabela de auditoria:
 
 ```tsx
-import { useActionQuery } from "@agent-native/core/client";
-
+import { useActionQuery } from "@agent-native/core/client/hooks";
 const { data } = useActionQuery("list-audit-events", {
   targetType: "recording",
   targetId: recordingId,

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

@@ -363,8 +363,9 @@ interface AuthSession {
 No cliente, use o gancho `useSession()`:
 
 ```ts
-import { useSession } from "@agent-native/core/client";
-
+import {
+  useSession,
+} from "@agent-native/core/client/hooks"
 function MyComponent() {
   const { session, isLoading } = useSession();
   if (isLoading) return <p>Loading...</p>;

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

@@ -67,8 +67,7 @@ import {
   useActionQuery,
   useActionMutation,
   callAction,
-} from "@agent-native/core/client";
-
+} from "@agent-native/core/client/hooks";
 // Read: auto-cached, auto-invalidated on mutations
 const { data, isLoading } = useActionQuery("get-lead", { leadId });
 
@@ -85,8 +84,7 @@ await callAction("archive-lead", { leadId });
 Envie uma mensagem para o chat do agente via postMessage — a maneira comum de delegar uma tarefa de IA de uma interação UI. Passe `context` para contexto de modelo oculto e `submit: true` para enviar imediatamente ou `submit: false` para preencher previamente um rascunho que o usuário analisará primeiro.
 
 ```ts
-import { sendToAgentChat } from "@agent-native/core/client";
-
+import { sendToAgentChat } from "@agent-native/core/client/agent-chat";
 // Auto-submit a prompt with hidden context
 sendToAgentChat({
   message: "Generate alt text for this image",
@@ -176,8 +174,7 @@ guia Configurações da barra lateral do agente. Passe um ID de seção como `"l
 `"automations"`, `"voice"` ou `"limits"` para abrir uma seção específica.
 
 ```ts
-import { openAgentSettings } from "@agent-native/core/client";
-
+import { openAgentSettings } from "@agent-native/core/client/navigation";
 openAgentSettings();
 openAgentSettings("secrets");
 ```
@@ -185,8 +182,7 @@ openAgentSettings("secrets");
 Prefira este auxiliar ao despachar `agent-panel:open-settings` diretamente.
 
 ```tsx
-import { useAgentChatContext } from "@agent-native/core/client";
-
+import { useAgentChatContext } from "@agent-native/core/client/agent-chat";
 function SelectionContextButton({ record }: { record: { id: string } }) {
   const chatContext = useAgentChatContext();
   const contextKey = `selected-record:${record.id}`;
@@ -244,8 +240,10 @@ inicia o trabalho do agente — em vez de criar um modal personalizado. Alcance
 composer para detalhes de forma livre e um formulário/popover para entrada de vários campos.
 
 ```tsx
-import { askUserQuestion, sendToAgentChat } from "@agent-native/core/client";
-
+import {
+  askUserQuestion,
+  sendToAgentChat,
+} from "@agent-native/core/client/agent-chat";
 const length = await askUserQuestion({
   question: "How long should this deck be?",
   header: "Deck length", // optional short chip/heading (≈12 chars)
@@ -288,7 +286,7 @@ import {
   requestMcpAppDisplayMode,
   updateMcpAppModelContext,
   useMcpAppHostContext,
-} from "@agent-native/core/client";
+} from "@agent-native/core/client/agent-chat";
 ```
 
 `getMcpAppHostContext()` lê o último instantâneo de contexto do host enviado;
@@ -323,8 +321,9 @@ Defina `dynamicSuggestions={false}` para manter apenas chips estáticos. Passe `
 Gancho React que envolve sendToAgentChat com rastreamento de estado de carregamento:
 
 ```ts
-import { useAgentChatGenerating } from "@agent-native/core/client";
-
+import {
+  useAgentChatGenerating,
+} from "@agent-native/core/client/agent-chat"
 function GenerateButton() {
   const [isGenerating, send] = useAgentChatGenerating();
 
@@ -350,7 +349,9 @@ function GenerateButton() {
 Gancho React (anteriormente `useFileWatcher`) que escuta alterações no banco de dados em SSE, recorre à pesquisa e invalida os caches de consulta da estrutura que mantêm o UI alinhado com as gravações do agente:
 
 ```ts
-import { useDbSync } from "@agent-native/core/client";
+import {
+  useDbSync,
+} from "@agent-native/core/client/hooks"
 import { useQueryClient } from "@tanstack/react-query";
 
 function App() {
@@ -395,8 +396,7 @@ Quando ocorre qualquer mutação no banco de dados do lado do servidor, o servid
 
 ```tsx
 import { useQuery } from "@tanstack/react-query";
-import { useChangeVersion } from "@agent-native/core/client";
-
+import { useChangeVersion } from "@agent-native/core/client/hooks";
 function DashboardView({ id }) {
   // Get version for dashboards domain source
   const v = useChangeVersion("dashboards");
@@ -461,8 +461,9 @@ function DashboardView({ id }) {
 Utilitário para mesclar nomes de classes (clsx + tailwind-merge):
 
 ```ts
-import { cn } from "@agent-native/core/client";
-
+import {
+  cn,
+} from "@agent-native/toolkit/utils"
 <div className={cn(
   "px-4 py-2 rounded",
   isActive && "bg-primary text-primary-foreground",

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

@@ -13,7 +13,7 @@ componentes quando possível e uma camada suspensa quando precisar do produto pe
 Importar navegador UI de subcaminhos de cliente em foco:
 
 ```tsx
-import { AgentSidebar } from "@agent-native/core/client";
+import { AgentSidebar } from "@agent-native/core/client/agent-chat";
 import { PromptComposer } from "@agent-native/core/client/composer";
 import { AgentConversation } from "@agent-native/core/client/conversation";
 import { usePresence } from "@agent-native/core/client/collab";

package/docs/content/locales/pt-BR/context-awareness.mdx

@@ -198,8 +198,7 @@ Use a chave de estado do aplicativo `selection` para uma seleção durável que
 Escreva no UI quando o usuário seleciona, foca ou faz seleção múltipla de objetos significativos:
 
 ```tsx
-import { setClientAppState } from "@agent-native/core/client";
-
+import { setClientAppState } from "@agent-native/core/client/hooks";
 async function syncSelection(selection: unknown | null) {
   await setClientAppState("selection", selection, { keepalive: true });
 }
@@ -228,8 +227,7 @@ O agente de produção injeta essa chave no próximo turno como contexto de sele
 Editores personalizados podem escrever a mesma chave quando sua seleção não é representada pela seleção nativa do navegador:
 
 ```tsx
-import { setClientAppState } from "@agent-native/core/client";
-
+import { setClientAppState } from "@agent-native/core/client/hooks";
 await setClientAppState(
   "pending-selection-context",
   {
@@ -291,8 +289,7 @@ O agente deve chamar `pnpm action view-screen` antes de agir no UI atual. Esta
 Às vezes, o contexto não deve ficar apenas no estado do aplicativo. Um usuário clica em um botão, coloca um alfinete de comentário, seleciona um item e escolhe “Perguntar ao agente” ou pressiona um comando de IA em uma barra de ferramentas. Esse clique é uma instrução. No navegador UI, entregue-o ao agente com `sendToAgentChat()`.
 
 ```tsx
-import { sendToAgentChat } from "@agent-native/core/client";
-
+import { sendToAgentChat } from "@agent-native/core/client/agent-chat";
 function askAgentAboutSelection(selection: {
   documentId: string;
   blockId: string;
@@ -375,7 +372,7 @@ Ele permanece curto porque é um invólucro fino em torno da primitiva da estrut
 
 ```tsx
 // app/hooks/use-navigation-state.ts -- this file lives in YOUR app
-import { useAgentRouteState } from "@agent-native/core/client";
+import { useAgentRouteState } from "@agent-native/core/client/navigation";
 import { TAB_ID } from "@/lib/tab-id";
 
 interface NavigationState {

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

@@ -270,8 +270,10 @@ Use `http: { method: "GET" }` ou `readOnly: true` para actions somente leitura.
 As rotas residem em `app/routes/` e usam o roteamento de arquivos do React Router v8. Consulte dados por meio de manipuladores actions ou API e torne as mutações otimistas por padrão.
 
 ```tsx
-import { useActionMutation, useActionQuery } from "@agent-native/core/client";
-
+import {
+  useActionMutation,
+  useActionQuery,
+} from "@agent-native/core/client/hooks";
 export default function ProjectsPage() {
   const { data: projects = [] } = useActionQuery("list-projects", {});
   const create = useActionMutation("create-project");
@@ -287,7 +289,7 @@ export default function ProjectsPage() {
 Conecte a sincronização ao vivo uma vez perto do shell do aplicativo para que os caches de consulta React sejam atualizados quando o agente, outra guia ou uma ação alterar os dados:
 
 ```tsx
-import { useDbSync } from "@agent-native/core/client";
+import { useDbSync } from "@agent-native/core/client/hooks";
 import { useQueryClient } from "@tanstack/react-query";
 
 export function AppSync() {
@@ -300,7 +302,7 @@ export function AppSync() {
 **A promessa do agente nativo: as gravações do agente aparecem no UI sem uma atualização manual.** `useActionQuery` é o caminho mais fácil — cada gancho é buscado novamente quando uma ação mutante emite `source: "action"`. Se você acessar `useQuery` bruto com uma chave personalizada (por exemplo, um auxiliar de cliente de baixo nível que lê o status de integração), inclua o contador por origem no queryKey para atualizações direcionadas:
 
 ```tsx
-import { useChangeVersions } from "@agent-native/core/client";
+import { useChangeVersions } from "@agent-native/core/client/hooks";
 
 const v = useChangeVersions(["dashboards", "action"]);
 useQuery({
@@ -323,7 +325,7 @@ O estado da aplicação é como o agente sabe o que o usuário está vendo. No m
 Use `useAgentRouteState` para o gancho UI para que gravações no estado do aplicativo, leituras de comandos com escopo de guia, exclusão após leitura e proteção de comando duplicado permaneçam consistentes:
 
 ```tsx
-import { useAgentRouteState } from "@agent-native/core/client";
+import { useAgentRouteState } from "@agent-native/core/client/navigation";
 import { TAB_ID } from "@/lib/tab-id";
 
 export function useNavigationState() {

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

@@ -0,0 +1,10 @@
+---
+title: Doctor
+description: Verificações de segurança e migração.
+---
+
+# Doctor
+
+`agent-native doctor` executa oito guardas: sete de segurança e `migration-manifest`. Ele encontra imports no `migration-manifest.json` instalado e não permite opt-out. Execute `agent-native doctor --only migration-manifest`, pré-visualize com `npx @agent-native/core@latest upgrade --codemods` e aplique com `--yes`. O JSON lista os oito nomes em `guardsRun`.
+
+Entradas marcadas como `planned` aparecem apenas como avisos e não são reescritas. Entradas ativas são achados; o codemod só as reescreve quando o export de destino está instalado.