@agent-native/core 0.87.0 → 0.90.1

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

@@ -34,7 +34,7 @@ agente de aplicativo intacto.
     <div class="ext-helpers">
       <span class="diagram-pill">appAction</span
       ><span class="diagram-pill">appFetch</span
-      ><span class="diagram-pill">dbQuery / dbExec</span
+      ><span class="diagram-pill">dbQuery</span
       ><span class="diagram-pill">extensionData</span
       ><span class="diagram-pill">extensionFetch</span>
     </div>
@@ -227,7 +227,7 @@ Dentro da sandbox iframe, cada extensão tem estes auxiliares em `window`:
 | `appAction(name, params)`                        | Chame qualquer actions do modelo de host                       | `appAction('list-emails', { view: 'inbox' })`             |
 | `appFetch(path, options)`                        | Chamar endpoints de estrutura permitidos em `/_agent-native/*` | `appFetch('/_agent-native/application-state/navigation')` |
 | `dbQuery(sql, args)`                             | Ler de SQL (com escopo automático para o usuário)              | `dbQuery('SELECT id, name FROM tools')`                   |
-| `dbExec(sql, args)`                              | Escrever para SQL                                              | `dbExec('INSERT INTO ...')`                               |
+| `dbExec(sql, args)`                              | Legacy trusted SQL writes for editor/admin extensions          | Prefer `appAction` for app data writes                    |
 | `extensionFetch(url, options)`                   | Atingir APIs externos através de um proxy seguro com segredos  | `extensionFetch('https://api.github.com/user')`           |
 | `extensionData.set(collection, id, data, opts?)` | Persistir dados por extensão (escopo de usuário/organização)   | `extensionData.set('notes', id, { text: '...' })`         |
 | `extensionData.list(collection, opts?)`          | Listar itens persistentes                                      | `extensionData.list('notes', { scope: 'all' })`           |
@@ -397,7 +397,7 @@ As extensões locais têm um modelo de permissão v1 mais rígido:
 
 - `extensionData` está disponível para estado de tempo de execução pequeno, a menos que esteja desativado.
 - As chamadas `appAction` devem ser listadas explicitamente em `permissions.appActions`.
-- `dbQuery`, `dbExec` e `extensionFetch` estão bloqueados por enquanto.
+- `dbQuery` e `extensionFetch` estão bloqueados por enquanto.
 - Atualização, exclusão, compartilhamento e histórico apoiados por SQL actions retornam uma mensagem que
   aponta para o arquivo de entrada local.
 
@@ -430,6 +430,8 @@ A estrutura permite que o agente edite o código-fonte do aplicativo diretamente
 
 Regra geral: **se for para um usuário ou uma equipe, é uma extensão.** Se todos os usuários do modelo quiserem obtê-lo, envie-o como um recurso real.
 
+Para busca de dados personalizada que deva alimentar gráficos e tabelas nativos em vez de uma UI de widget sob medida, veja [Programas de dados](/docs/data-programs) — um script `run-code` armazenado e atualizável ao qual os painéis de dashboard se vinculam diretamente, sem nenhum iframe de extensão envolvido.
+
 ## Segurança {#security}
 
 <Callout id="doc-block-frp4nq" tone="success">
@@ -444,7 +446,7 @@ As extensões são executadas em um iframe em sandbox:
 - **Injeção de segredo no lado do servidor** por meio do modelo `${keys.NAME}` — o valor real da chave nunca chega ao navegador.
 - **Segredos bloqueados por domínio** — cada chave está vinculada a uma lista de permissões URL; o proxy recusa solicitações para outros hosts.
 - **Proteção de rede privada** — as extensões não podem alcançar endereços internos.
-- **Autenticação necessária** — as extensões são executadas apenas para usuários logados, e as chamadas `dbQuery`/`dbExec` têm escopo automático.
+- **Autenticação necessária** — as extensões são executadas apenas para usuários logados, e as chamadas `dbQuery` têm escopo automático.
 
 ## Algumas coisas que você deve saber sobre nomenclatura {#naming-back-compat}
 

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

@@ -239,21 +239,17 @@ export const forms = table("forms", {
 ```
 
 ```bash
-# Ações principais para inspeção rápida do banco de dados e manutenção pontual
+# Ações principais para inspeção rápida do banco de dados
 pnpm action db-schema                                       # show all tables
 pnpm action db-query --sql "SELECT * FROM forms"
-pnpm action db-exec --sql "UPDATE forms SET status = ? WHERE id = ?" --args '["closed","form-1"]'
-# Cirúrgico find/replace em uma coluna de texto grande — envia uma comparação, não o valor inteiro
-pnpm action db-patch --table documents --column content \
-  --where "id='doc-1'" --find "old heading" --replace "new heading"
 ```
 
-O plug-in de bate-papo do agente de produção permite gravações de banco de dados brutos por padrão
-(`databaseTools: "write"`) para que os agentes possam corrigir dados de propriedade do aplicativo sem esperar por um
-nova ação digitada. Essas gravações têm como escopo o usuário/organização autenticado. Definir
-`databaseTools: "read"` para manter apenas a inspeção `db-schema` / `db-query` ou
-`databaseTools: "off"` / `false` para exigir o aplicativo digitado actions para todos os dados
-acesso.
+O plug-in de bate-papo do agente de produção deixa as ferramentas SQL brutas em modo somente leitura por padrão
+(`databaseTools: "read"`). Os agentes inspecionam dados do app com `db-schema` /
+`db-query` e escrevem por meio de actions tipadas do app. Defina
+`databaseTools: "write"` (ou `true`) apenas para superfícies de manutenção
+intencionais que também devam expor `db-exec` / `db-patch` com escopo; use
+`databaseTools: "off"` / `false` para exigir actions tipadas para todo acesso a dados.
 
 ## Ponte de bate-papo do agente {#agent-chat-bridge}
 
@@ -437,6 +433,7 @@ Eles estão no mesmo contrato e têm seus próprios aprofundamentos:
 
 - **[Dispatch](/docs/dispatch)** — o plano de controle do espaço de trabalho: caixa de entrada compartilhada, cofre de segredos, trabalhos agendados e um orquestrador que delega A2A a aplicativos especializados.
 - **[Extensions](/docs/extensions)** — miniaplicativos Alpine.js em sandbox que o agente cria em tempo de execução, sem alterações de origem ou migrações.
+- **[Programas de dados](/docs/data-programs)** — scripts `run-code` armazenados e escritos pelo agente que fornecem aos painéis de dashboard um resultado em cache e atualizável, em vez de uma action de provedor codificada.
 - **[A2A Protocol](/docs/a2a-protocol)** — como aplicativos no mesmo espaço de trabalho descobrem e chamam uns aos outros por meio de JSON-RPC.
 
 ## O que você ganha de graça {#what-you-get-for-free}

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

@@ -261,11 +261,8 @@ export default createCollabPlugin({
 ### 4. Use o gancho do cliente
 
 ```ts
-import {
-  useCollaborativeDoc,
-  emailToColor,
-  emailToName,
-} from "@agent-native/core/client";
+import { useCollaborativeDoc } from "@agent-native/core/client";
+import { emailToColor, emailToName } from "@agent-native/toolkit/collab-ui";
 
 const TAB_ID = generateTabId(); // or Math.random().toString(36)
 
@@ -367,12 +364,14 @@ Importe a presença e o editor do lado do cliente UI do subcaminho do navegador
 
 ```ts
 import {
-  PresenceBar,
-  LiveCursorOverlay,
-  RemoteSelectionRings,
   useCollaborativeDoc,
   usePresence,
 } from "@agent-native/core/client/collab";
+import {
+  PresenceBar,
+  LiveCursorOverlay,
+  RemoteSelectionRings,
+} from "@agent-native/toolkit/collab-ui";
 ```
 
 Os auxiliares de presença do agente do lado do servidor permanecem no pacote de colaboração de nível inferior:
@@ -458,7 +457,7 @@ O agente (AGENT_CLIENT_ID) aparece como um participante de primeira classe com `
 Renderiza cursores remotos como rótulos absolutamente posicionados sobre um elemento contêiner:
 
 ```tsx
-import { LiveCursorOverlay } from "@agent-native/core/client";
+import { LiveCursorOverlay } from "@agent-native/toolkit/collab-ui";
 
 // cursor positions stored as { x, y } normalized 0–1 under presence.cursor
 <div ref={containerRef} style={{ position: "relative" }}>
@@ -478,7 +477,7 @@ O cursor do agente é renderizado distintamente com um ícone brilhante. Os curs
 Renderiza anéis de contorno coloridos + tags de nome sobre elementos selecionados remotamente:
 
 ```tsx
-import { RemoteSelectionRings } from "@agent-native/core/client";
+import { RemoteSelectionRings } from "@agent-native/toolkit/collab-ui";
 
 <div ref={containerRef} style={{ position: "relative" }}>
   {content}

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

@@ -93,9 +93,10 @@ Todo modelo que armazena trabalhos de autoria do usuário usa esse modelo. Concr
 - **Apresentações** — apresentações
 - **Design** — designs e recursos
 - **Clipes** — gravações de tela (estilo Loom)
+- **Plan** — visual plans and PR recaps
 - **Formulários** — definições de formulário
 - **Calendário** — links para eventos e reservas
-- **Analytics** — painéis (lançamento — veja o modelo de análise `AGENTS.md`)
+- **Analytics** — dashboards, saved analyses, and tokenized session replays
 - **Extensões** — miniaplicativos em sandbox (consulte [Extensions](/docs/extensions#sharing))
 
 Cada um deles usa o mesmo auxiliar de esquema `ownableColumns()`, a mesma ação `share-resource` e o mesmo `<ShareButton>` UI. Mude de um modelo para outro e a caixa de diálogo de compartilhamento parecerá idêntica.
@@ -136,15 +137,22 @@ Para listas, coloque um `<VisibilityBadge visibility={row.visibility} />` ao lad
 
 A estrutura monta automaticamente esses actions em cada modelo — o agente os chama como ferramentas e o UI os chama por meio de `useActionQuery` / `useActionMutation`:
 
-| Ação                      | O que faz                                                                                                                |
-| ------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
-| `share-resource`          | Conceda acesso a um usuário ou organização em uma função específica. `notify` opcional controla notificações por e-mail. |
-| `unshare-resource`        | Revogar o acesso de um usuário ou organização.                                                                           |
-| `list-resource-shares`    | Mostrar a visibilidade atual e todas as concessões explícitas.                                                           |
-| `set-resource-visibility` | Mude para `private`, `org` ou `public`.                                                                                  |
+| Ação                         | O que faz                                                                                                                |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| `share-resource`             | Conceda acesso a um usuário ou organização em uma função específica. `notify` opcional controla notificações por e-mail. |
+| `unshare-resource`           | Revogar o acesso de um usuário ou organização.                                                                           |
+| `list-resource-shares`       | Mostrar a visibilidade atual e todas as concessões explícitas.                                                           |
+| `set-resource-visibility`    | Mude para `private`, `org` ou `public`.                                                                                  |
+| `create-agent-resource-link` | Mint a temporary read-only `agent_access` URL for a registered agent-readable resource.                                  |
 
 Diga ao agente "compartilhe este design com a equipe de marketing como editores" e ele chamará `share-resource` no mesmo endpoint que UI usa. O resultado aparece na caixa de diálogo de compartilhamento na próxima renderização.
 
+## Agent-readable share links {#agent-readable-links}
+
+Human share links should also work for agents when the resource is a document-like artifact: plans, documents, decks, designs, analytics dashboards, saved analyses, clips, and similar "things you would send to a person." Public links expose a small SSR discovery script that points at structured JSON. Private resources use a short-lived `agent_access` token scoped to exactly one resource.
+
+Register the resource with `agentReadable`, add a read-only JSON context endpoint, inject the SSR discovery script with `renderAgentReadableResourceDiscoveryScript()`, and let agents call `create-agent-resource-link` when they need a temporary private URL. The endpoint must return data only when the row is `public` or `verifyScopedAgentAccessToken()` accepts the token for that exact `resourceKind` and `resourceId`.
+
 ## Construindo-o em um novo modelo {#building}
 
 Se você estiver criando um modelo (consulte [Creating Templates](/docs/creating-templates)), o compartilhamento de conexão será curto. Duas adições ao seu esquema:

package/corpus/core/docs/content/locales/zh-CN/agent-native-toolkit.mdx

@@ -0,0 +1,103 @@
+---
+title: "Toolkit"
+description: "Reusable app-building primitives that sit between @agent-native/core and template apps."
+---
+
+# Toolkit
+
+`@agent-native/core` owns the foundational runtime: actions, app state, auth,
+SQL, server plugins, agent chat, sharing access checks, and collaboration
+transport. `@agent-native/toolkit` owns reusable app-building pieces that sit on
+top of that runtime: UI primitives, app-local adapters, shell helpers, sharing
+badges, and collaboration UI.
+
+Apps should compose those pieces through local adapters. That keeps app UI easy
+to customize without copying Toolkit implementation code.
+
+<WireframeBlock id="doc-block-toolkit-layering">
+  <Screen
+    surface="desktop"
+    html={
+      "<div style='min-height:520px;box-sizing:border-box;padding:48px 36px;display:flex;align-items:center;justify-content:center'><div style='width:min(900px,100%);display:grid;grid-template-columns:1fr;gap:18px'><div class='wf-card' style='padding:22px 24px'><div style='display:flex;align-items:center;justify-content:space-between;gap:16px'><div><strong>App</strong><p class='wf-muted' style='margin:6px 0 0'>Domain routes, actions, local UI adapters, product-specific views</p></div><span class='wf-pill'>@/components/ui/button</span></div></div><div class='wf-card' style='padding:22px 24px;border-color:hsl(var(--primary))'><div style='display:flex;align-items:center;justify-content:space-between;gap:16px'><div><strong>Toolkit</strong><p class='wf-muted' style='margin:6px 0 0'>Reusable primitives, collab UI, sharing UI, app shell hooks</p></div><span class='wf-pill'>ToolkitProvider</span></div><div style='display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:10px;margin-top:16px'><span class='wf-pill'>UI</span><span class='wf-pill'>Collab UI</span><span class='wf-pill'>Sharing UI</span><span class='wf-pill'>Shell</span></div></div><div class='wf-card' style='padding:22px 24px'><div style='display:flex;align-items:center;justify-content:space-between;gap:16px'><div><strong>Core</strong><p class='wf-muted' style='margin:6px 0 0'>Actions, SQL, auth, sharing runtime, Yjs transport, app state</p></div><span class='wf-pill'>@agent-native/core</span></div></div></div></div>"
+    }
+  />
+</WireframeBlock>
+
+## What Ships Today {#what-ships-today}
+
+- **UI primitives**: shadcn-style components under
+  `@agent-native/toolkit/ui/*`.
+- **App adapters**: template-local wrappers such as
+  `@/components/ui/button` that re-export Toolkit primitives until an app wants
+  to customize them.
+- **ToolkitProvider**: an override layer that lets reusable Toolkit UI use an
+  app's local primitives, starting with `Button`.
+- **Collaboration UI**: presence avatars, live cursors, remote selection rings,
+  recent edit highlights, and agent presence chips under
+  `@agent-native/toolkit/collab-ui`.
+- **Sharing UI**: the reusable `VisibilityBadge` under
+  `@agent-native/toolkit/sharing`.
+- **Shell and hooks**: app-shell header actions plus shared hooks such as
+  `useIsMobile` and `useToast`.
+
+## Compatibility {#compatibility}
+
+Existing imports from `@agent-native/core/client` keep working. Core now exposes
+thin re-export shims for Toolkit-owned visual pieces while keeping runtime
+behavior in core.
+
+Those core shims are temporary migration support, not the long-term dependency
+direction. The next major can remove them; after that, reusable app-building
+packages should import Toolkit directly, and behaviorful Toolkit kits may compose
+core runtime APIs as peer/runtime dependencies instead of pushing more UI back
+into core.
+
+Extract future behaviorful kits one at a time before broadening the split.
+Sharing is the first candidate to validate that model because it exercises
+access checks, action-backed data, and share-link UI together.
+
+That means this keeps working:
+
+```tsx
+import { PresenceBar, VisibilityBadge } from "@agent-native/core/client";
+```
+
+New reusable app code should prefer Toolkit or app-local adapters:
+
+```tsx
+import { PresenceBar } from "@agent-native/toolkit/collab-ui";
+import { Button } from "@/components/ui/button";
+```
+
+## Boundary {#boundary}
+
+Move code into Toolkit when it is reusable app-building UI or a pure UI contract.
+Keep code in core when it owns access control, SQL, actions, request context,
+Yjs transport, auth, or other runtime guarantees.
+
+Good Toolkit candidates:
+
+- Components that render the same interaction across apps.
+- Display-only helpers and structural prop types.
+- Base components that receive data and callbacks from an app or core wrapper.
+- App-shell hooks and adapters that do not own domain data.
+
+Keep app-local:
+
+- Domain-specific workflows.
+- Resource-specific mutations and routes.
+- Custom visual systems an app intentionally owns.
+
+Keep core-owned:
+
+- Sharing actions and access checks.
+- Collaboration storage, awareness transport, and Yjs document sync.
+- Auth, sessions, app state, SQL, and server plugins.
+
+## Pages {#pages}
+
+- [UI Primitives](/docs/toolkit-ui)
+- [App Adapters](/docs/toolkit-app-adapters)
+- [Collaboration UI](/docs/toolkit-collaboration-ui)
+- [Sharing UI](/docs/toolkit-sharing-ui)
+- [Shell & Hooks](/docs/toolkit-shell-hooks)

package/corpus/core/docs/content/locales/zh-CN/cloneable-saas.mdx

@@ -1,19 +1,19 @@
 ---
-title: "模板"
+title: "应用"
 description: "分叉一个可用的 SaaS 产品并使其成为您的产品 - 包括代理。"
 ---
 
-# 模板
+# 应用
 
-想要发布您自己的人工智能分析工具吗？邮件客户端？表格生成器？选择一个模板，您只需几分钟即可获得一个可运行的 SaaS — 代理、数据库、身份验证和部署管道已连接完毕。
+想要发布您自己的人工智能分析工具吗？邮件客户端？表格生成器？选择一个示例应用，您只需几分钟即可获得一个可运行的 SaaS — 代理、数据库、身份验证和部署管道已连接完毕。
 
-大多数“模板”都会为您提供一个空白的脚手架和一个很长的 TODO 列表。代理本机翻转了这一点。每一个都是**完整的 SaaS 级产品** - 在第一天就已经可以运行，已经可以发货，并且完全由您来定制、品牌化和部署。将它们视为可克隆的 SaaS，而不是入门工具包：您正在分叉成品，而不是盯着样板文件。
+大多数入门模板都会为您提供一个空白的脚手架和一个很长的 TODO 列表。代理本机翻转了这一点。每个示例应用都是**完整的 SaaS 级产品** - 在第一天就已经可以运行，已经可以发货，并且完全由您来定制、品牌化和部署。将它们视为可克隆的 SaaS，而不是入门工具包：您正在分叉成品，而不是盯着样板文件。
 
-## 可用模板 {#catalog}
+## 示例应用 {#catalog}
 
 每一个都是您今天可以使用的真实应用程序，以及您自己版本的启动板。
 
-| 模板                                      | 它是什么                                                                                            |
+| 应用                                      | 它是什么                                                                                            |
 | ----------------------------------------- | --------------------------------------------------------------------------------------------------- |
 | [**Chat**](/docs/template-chat)           | 最小的聊天优先应用程序，具有持久线程、actions、身份验证以及通往自定义 UI 或您自己的后端的干净路径。 |
 | [**Mail**](/docs/template-mail)           | 特工本地超人。收件箱、标签、人工智能分类、键盘优先、通过代理起草和发送。                            |
@@ -35,16 +35,16 @@ description: "分叉一个可用的 SaaS 产品并使其成为您的产品 - 包
 
 ## 开箱即用的东西 {#what-you-get}
 
-每个模板都附带通常需要数月才能构建的部件：
+每个示例应用都附带通常需要数月才能构建的部件：
 
 - **工作代理** — 已经连接到应用程序，已经能够在您的数据上获取 actions，已经能够了解您正在查看的内容。请参阅 [Messaging the agent](/docs/messaging) 了解其工作原理。
 - **Auth** — 登录、会话、组织、多租户隔离。已经完成了。
-- **数据库** — 每个模板都有其架构、查询和迁移准备就绪。带上您自己的 SQL 数据库（Postgres、SQLite、Turso、D1）——框架会进行调整。
+- **数据库** — 每个示例应用都有其架构、查询和迁移准备就绪。带上您自己的 SQL 数据库（Postgres、SQLite、Turso、D1）——框架会进行调整。
 - **实时 UI** — 屏幕与代理的操作保持同步。在聊天中点击“草稿电子邮件”，草稿立即出现在您的收件箱中。
 - **部署就绪** — 推送到 Netlify、Vercel、Cloudflare、AWS 或运行 Node.js 的任何其他地方。没有供应商锁定。
 - **品牌挂钩** - 名称、颜色、徽标、文案都很容易更改。
 
-这不是理论上的主张。该框架的作者在邮件模板上运行他的实际收件箱，在日历模板上运行他的实际日历，在分析模板上运行他的实际分析。模板是日常驱动软件。
+这不是理论上的主张。该框架的作者在 Mail 应用上运行他的实际收件箱，在 Calendar 应用上运行他的实际日历，在 Analytics 应用上运行他的实际分析。这些都是日常使用的应用。
 
 ## 你做什么 {#what-you-do}
 
@@ -56,7 +56,7 @@ description: "分叉一个可用的 SaaS 产品并使其成为您的产品 - 包
 <div class="diagram-fork">
   <div class="diagram-card">
     <span class="diagram-pill">1</span><strong>Pick</strong
-    ><small class="diagram-muted">a complete template</small>
+    ><small class="diagram-muted">完整应用</small>
   </div>
   <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
   <div class="diagram-card">
@@ -98,8 +98,8 @@ description: "分叉一个可用的 SaaS 产品并使其成为您的产品 - 包
 
 </Diagram>
 
-1. **选择一个模板。**使用 CLI 选择器，或浏览文档并选择一个开始。
-2. **打造品牌。**更改名称、颜色、徽标和文案。大多数模板都将其公开在单个配置文件中。
+1. **选择一个示例应用。**使用 CLI 选择器，或浏览文档并选择一个开始。
+2. **打造品牌。**更改名称、颜色、徽标和文案。大多数示例应用都将其公开在单个配置文件中。
 3. **自定义它。** 要求代理添加您需要的列，更改收件箱分组的方式，连接到您的内部 API，添加新视图。代理编辑代码；您查看差异。
 4. **发货。**运行部署命令。您现在在自己的域中拥有自己的生产 SaaS。
 
@@ -157,7 +157,7 @@ description: "分叉一个可用的 SaaS 产品并使其成为您的产品 - 包
 
 ## 不想分叉？ {#hosted}
 
-你不必这样做。每个模板还可以作为 `agent-native.com` 上的托管应用程序使用 - `mail.agent-native.com`、`calendar.agent-native.com` 等。免费或付费使用托管版本；仅当您想要更改托管版本未公开的内容时才进行分叉。
+你不必这样做。每个示例应用还可以作为 `agent-native.com` 上的托管应用程序使用 - `mail.agent-native.com`、`calendar.agent-native.com` 等。免费或付费使用托管版本；仅当您想要更改托管版本未公开的内容时才进行分叉。
 
 ## 尝试一下技巧 {#try-with-a-skill}
 
@@ -166,10 +166,10 @@ description: "分叉一个可用的 SaaS 产品并使其成为您的产品 - 包
 ## 在此基础上构建
 
 - [**Getting Started**](/docs/getting-started) - 创建聊天优先应用，添加 action，渲染结构化结果，并扩展为页面
-- [**Messaging the agent**](/docs/messaging) - 用户（和您）如何与每个模板附带的代理对话
-- [**Multi-App Workspace**](/docs/multi-app-workspace) — 将多个模板捆绑到一个共享身份验证、品牌和代理的工作区
-- [**Dispatch**](/docs/template-dispatch) — 工作区控制平面模板
-- [**Creating Templates**](/docs/creating-templates) — 创作并发布您自己的模板
+- [**Messaging the agent**](/docs/messaging) - 用户（和您）如何与每个应用附带的代理对话
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — 将多个应用捆绑到一个共享身份验证、品牌和代理的工作区
+- [**Dispatch**](/docs/template-dispatch) — 工作区控制平面应用
+- [**Creating Templates**](/docs/creating-templates) — 创作并发布您自己的应用模板
 
 ### 对于开发者 {#dev-details}
 
@@ -179,10 +179,10 @@ description: "分叉一个可用的 SaaS 产品并使其成为您的产品 - 包
 npx @agent-native/core@latest create my-platform
 ```
 
-您将获得一个多选选择器。选择一个应用程序（独立）或多个应用程序（工作区 - 应用程序共享身份验证、品牌、代理配置和数据库）。每个挑选的模板都与您需要的每个文件一起构建到 `apps/<name>/` 中。对于没有浏览器 UI 的自动化应用，而不是模板 UI，请使用 `npx @agent-native/core@latest create my-agent --headless`。
+您将获得一个多选选择器。选择一个应用程序（独立）或多个应用程序（工作区 - 应用程序共享身份验证、品牌、代理配置和数据库）。每个挑选的应用都与您需要的每个文件一起构建到 `apps/<name>/` 中。对于没有浏览器 UI 的自动化应用，而不是应用 UI，请使用 `npx @agent-native/core@latest create my-agent --headless`。
 
 填写`.env`（主要是`ANTHROPIC_API_KEY`和`DATABASE_URL`）、`pnpm install`、`pnpm dev`，就可以了。没有“TODO：实现登录”，没有占位符路由。
 
 部署目标：任何 Nitro 兼容主机（Node、Cloudflare、Netlify、Vercel、Deno、Lambda、Bun）和任何 Drizzle 兼容 SQL 数据库（SQLite、Postgres、Turso、D1、Supabase、Neon）。对于工作区，`npx @agent-native/core@latest deploy` 一次构建每个应用程序并将它们发送到单个源。参见[Deployment](/docs/deployment)。
 
-要创作和发布您自己的模板，请参阅 [Creating Templates](/docs/creating-templates)。
+要创作和发布您自己的应用模板，请参阅 [Creating Templates](/docs/creating-templates)。

package/corpus/core/docs/content/locales/zh-CN/components.mdx

@@ -25,7 +25,9 @@ import { ResourcesPanel } from "@agent-native/core/client/resources";
 `@agent-native/core/client` 或聚焦的 `@agent-native/core/client/*` 子路径
 因此捆绑商选择浏览器安全的条目。
 
-将 `@agent-native/toolkit` 用于不属于基础运行时契约的可复用应用构建部件：shadcn 风格 UI primitives、共享 hooks、简单应用 shell helpers，以及其他模板组合模块。迁移期间 Core 会保留兼容 re-export，但新的模板和应用代码应直接导入 toolkit 模块：
+将 `@agent-native/toolkit` 用于不属于基础运行时契约的可复用应用构建部件：shadcn 风格 UI primitives、共享 hooks、简单应用 shell helpers，以及其他模板组合模块。迁移期间 Core 会保留兼容 re-export。
+
+可复用 packages 可以直接导入 Toolkit 模块：
 
 ```tsx
 import { Button } from "@agent-native/toolkit/ui/button";
@@ -34,6 +36,13 @@ import { useToast } from "@agent-native/toolkit/hooks/use-toast";
 import { useSetHeaderActions } from "@agent-native/toolkit/app-shell";
 ```
 
+在模板应用里，优先使用 app-local adapters，这样团队只替换一次 primitive，所有复用的 Toolkit surface 都会使用本地实现：
+
+```tsx
+import { Button } from "@/components/ui/button";
+import { useToast } from "@/hooks/use-toast";
+```
+
 <Diagram id="doc-block-1tquzyh" title={"下拉一层，不脱离框架"} summary={"每个层都保持相同的运行时 - 操作、线程状态和 SQL-backed 同步 - 同时让您更好地控制镶边。"}>
 
 ```html
@@ -435,15 +444,16 @@ function WorkspaceResources() {
 
 ## 其他公共UI {#other-ui}
 
-| 区域         | APIs                                                  | 导入路径                                  |
-| ------------ | ----------------------------------------------------- | ----------------------------------------- |
-| 分享         | `<ShareButton>`, `<ShareDialog>`, `<VisibilityBadge>` | `@agent-native/core/client/sharing`       |
-| 通知         | `<NotificationsBell>`                                 | `@agent-native/core/client/notifications` |
-| 进度         | `<RunsTray>`，进度挂钩和类型                          | `@agent-native/core/client/progress`      |
-| 入职         | `useOnboarding()`，入门面板挂钩                       | `@agent-native/core/client/onboarding`    |
-| 可观察性     | `<ObservabilityDashboard>`, `<ThumbsFeedback>`        | `@agent-native/core/client/observability` |
-| 资源         | `<ResourcesPanel>`、`<ResourceTree>`、资源挂钩        | `@agent-native/core/client/resources`     |
-| 丰富的编辑器 | `<SharedRichEditor>`，斜杠命令，块节点挂钩            | `@agent-native/core/client/editor`        |
+| 区域         | APIs                                           | 导入路径                                  |
+| ------------ | ---------------------------------------------- | ----------------------------------------- |
+| 分享         | `<ShareButton>`, `<ShareDialog>`               | `@agent-native/core/client/sharing`       |
+| Sharing UI   | `<VisibilityBadge>`                            | `@agent-native/toolkit/sharing`           |
+| 通知         | `<NotificationsBell>`                          | `@agent-native/core/client/notifications` |
+| 进度         | `<RunsTray>`，进度挂钩和类型                   | `@agent-native/core/client/progress`      |
+| 入职         | `useOnboarding()`，入门面板挂钩                | `@agent-native/core/client/onboarding`    |
+| 可观察性     | `<ObservabilityDashboard>`, `<ThumbsFeedback>` | `@agent-native/core/client/observability` |
+| 资源         | `<ResourcesPanel>`、`<ResourceTree>`、资源挂钩 | `@agent-native/core/client/resources`     |
+| 丰富的编辑器 | `<SharedRichEditor>`，斜杠命令，块节点挂钩     | `@agent-native/core/client/editor`        |
 
 ## 一次性文本完成 {#one-off-text-completion}