@agent-native/core 0.87.0 → 0.90.1

package/docs/content/locales/ja-JP/deployment.mdx

@@ -384,24 +384,23 @@ openssl rand -hex 32
 ## 本番エージェント ツール {#production-agent-tools}
 
 運用エージェントは、アプリの登録済み actions とフレームワーク ツールを次のサイトから取得します
-エージェント チャット プラグイン。 raw DB
-ツールのスコープは認証されたユーザー/組織に限定されますが、アプリ所有者は範囲を狭めることができます
-展開にもっと独自性を持たせる必要がある場合に浮上します:
+エージェント チャット プラグイン。SQL 検査はデフォルトで有効です。データベース書き込みは、
+アプリが明示的に raw write tools を有効にしない限り、型付きアプリ actions を通ります:
 
 ```ts
 // server/plugins/agent-chat.ts
 export default createAgentChatPlugin({
-  // Default: "write" (also true)
+  // Default: "read"
   databaseTools: "read", // "write" | "read" | "off"
   extensionTools: false,
 });
 ```
 
-- `databaseTools: "write"` — デフォルト。 `db-schema`、`db-query`、
-  `db-exec`、および `db-patch`。書き込みの範囲は現在のユーザー/組織に限定されます。
-  スキーマの変更はブロックされます。
-- `databaseTools: "read"` — `db-schema` および `db-query` のみを登録します。エージェント
-  SQL を使用してデータを検査しますが、書き込みには型付きアプリ actions を使用する必要があります。
+- `databaseTools: "read"` — デフォルト。`db-schema` と `db-query` のみを登録します。
+  エージェントは SQL でデータを検査しますが、書き込みには型付きアプリ actions を使用します。
+- `databaseTools: "write"` または `true` — 意図的な raw SQL メンテナンス用に
+  `db-exec` と `db-patch` も登録します。書き込みは現在のユーザー/組織に
+  スコープされ、スキーマ変更はブロックされます。
 - `databaseTools: "off"` または `false` — 生のデータベース ツールを
   エージェント サーフェスのため、アプリの actions が唯一のデータ アクセス パスになります。
 - `extensionTools: false` — フレームワーク拡張管理 actions を削除し、

package/docs/content/locales/ja-JP/extensions.mdx

@@ -34,7 +34,7 @@ QuickBooks Online を使用したことがある方は、このモデルを見
     <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>
@@ -225,7 +225,7 @@ iframe サンドボックス内では、すべての拡張機能に `window` の
 | `appAction(name, params)`                        | ホスト テンプレートの actions のいずれかを呼び出します                 | `appAction('list-emails', { view: 'inbox' })`             |
 | `appFetch(path, options)`                        | `/_agent-native/*` で許可されたフレームワーク エンドポイントを呼び出す | `appFetch('/_agent-native/application-state/navigation')` |
 | `dbQuery(sql, args)`                             | SQL から読み取り (ユーザーに自動スコープ設定)                          | `dbQuery('SELECT id, name FROM tools')`                   |
-| `dbExec(sql, args)`                              | SQL に書き込みます                                                     | `dbExec('INSERT INTO ...')`                               |
+| `dbExec(sql, args)`                              | Legacy trusted SQL writes for editor/admin extensions                  | Prefer `appAction` for app data writes                    |
 | `extensionFetch(url, options)`                   | シークレットを使用して安全なプロキシを介して外部 API にアクセスする    | `extensionFetch('https://api.github.com/user')`           |
 | `extensionData.set(collection, id, data, opts?)` | 拡張子ごとにデータを保持する (ユーザー/組織のスコープ設定)             | `extensionData.set('notes', id, { text: '...' })`         |
 | `extensionData.list(collection, opts?)`          | 永続化された項目をリストする                                           | `extensionData.list('notes', { scope: 'all' })`           |
@@ -395,7 +395,7 @@ extensions/
 
 - `extensionData` は、無効になっていない限り、小規模なランタイム状態で使用できます。
 - `appAction` 呼び出しは、`permissions.appActions` に明示的にリストする必要があります。
-- `dbQuery`、`dbExec`、および `extensionFetch` は現在ブロックされています。
+- `dbQuery` と `extensionFetch` は現在ブロックされています。
 - SQL による更新、削除、共有、履歴 actions は次のメッセージを返します。
   ローカルエントリファイルを指します。
 
@@ -428,6 +428,8 @@ extensions/
 
 経験則: **1 ユーザーまたは 1 チーム用の場合、それは拡張機能です。** テンプレートのすべてのユーザーがそれを入手する必要がある場合は、実際の機能として出荷してください。
 
+専用ウィジェット UI ではなくネイティブなチャートやテーブルにデータを供給すべきカスタムデータ取得については、[データプログラム](/docs/data-programs) を参照してください——拡張機能の iframe を一切介さずに dashboard パネルが直接バインドする、保存済みで更新可能な `run-code` スクリプトです。
+
 ## セキュリティ {#security}
 
 <Callout id="doc-block-frp4nq" tone="success">
@@ -442,7 +444,7 @@ extensions/
 - `${keys.NAME}` テンプレートを使用した**サーバー側のシークレット インジェクション** — 実際のキーの値がブラウザーに到達することはありません。
 - **ドメインロックされたシークレット** — 各キーは URL ホワイトリストにバインドされています。プロキシは他のホストへのリクエストを拒否します。
 - **プライベート ネットワーク保護** — 拡張機能は内部アドレスに到達できません。
-- **認証が必要** — 拡張機能はログイン ユーザーに対してのみ実行され、`dbQuery` / `dbExec` 呼び出しは自動スコープされます。
+- **認証が必要** — 拡張機能はログイン ユーザーに対してのみ実行され、`dbQuery` 呼び出しは自動スコープされます。
 
 ## 名前付けについて知っておくべきいくつかのこと {#naming-back-compat}
 

package/docs/content/locales/ja-JP/key-concepts.mdx

@@ -240,21 +240,18 @@ export const forms = table("forms", {
 ```
 
 ```bash
-# 迅速なデータベース検査と 1 回限りのメンテナンスのための主要なアクション
+# 迅速なデータベース検査のための主要なアクション
 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"]'
-# 大きなテキスト列の Surgical find/replace — 値全体ではなく差分を送信します
-pnpm action db-patch --table documents --column content \
-  --where "id='doc-1'" --find "old heading" --replace "new heading"
 ```
 
-実稼働エージェントのチャット プラグインにより、デフォルトで生のデータベースへの書き込みが有効になります
-(`databaseTools: "write"`) エージェントがアプリ所有のデータを待機せずに修正できるようにする
-新しい型のアクション。これらの書き込みは、認証されたユーザー/組織に限定されます。セット
-`databaseTools: "read"` で `db-schema` / `db-query` 検査のみを維持するか、
-`databaseTools: "off"` / `false` は、すべてのデータに対して型付きアプリ actions を要求します
-アクセス
+実稼働エージェントのチャット プラグインは raw SQL ツールをデフォルトで読み取り専用にします
+(`databaseTools: "read"`)。エージェントは `db-schema` / `db-query` で
+アプリ所有データを検査し、書き込みは型付きアプリ actions 経由で行います。
+スコープ付きの `db-exec` / `db-patch` も公開する必要がある意図的な
+メンテナンス面だけで `databaseTools: "write"` (または `true`) を設定します。
+すべてのデータアクセスに型付きアプリ actions を要求するには
+`databaseTools: "off"` / `false` を設定します。
 
 ## エージェント チャット ブリッジ {#agent-chat-bridge}
 
@@ -438,6 +435,7 @@ UI はルート変更時にこれを書き込みます。エージェントは
 
 - **[Dispatch](/docs/dispatch)** — ワークスペース コントロール プレーン: 共有受信トレイ、シークレット ボールト、スケジュールされたジョブ、および A2A を介して専門アプリに委任するオーケストレーター。
 - **[Extensions](/docs/extensions)** — エージェントが実行時に作成するサンドボックス化された Alpine.js ミニアプリ。ソースの変更や移行はありません。
+- **[データプログラム](/docs/data-programs)** — エージェントが作成し保存する `run-code` スクリプトで、ハードコードされた provider action の代わりに、キャッシュされ更新可能な結果を dashboard パネルに提供します。
 - **[A2A Protocol](/docs/a2a-protocol)** — 同じワークスペース内のアプリが JSON ～ RPC 経由で相互に検出して呼び出しを行う方法。
 
 ## 無料で得られるもの {#what-you-get-for-free}

package/docs/content/locales/ja-JP/real-time-collaboration.mdx

@@ -260,11 +260,8 @@ export default createCollabPlugin({
 ### 4. クライアントフックを使用する
 
 ```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)
 
@@ -366,12 +363,14 @@ pnpm action edit-document --id doc123 --find "delete me" --replace ""
 
 ```ts
 import {
-  PresenceBar,
-  LiveCursorOverlay,
-  RemoteSelectionRings,
   useCollaborativeDoc,
   usePresence,
 } from "@agent-native/core/client/collab";
+import {
+  PresenceBar,
+  LiveCursorOverlay,
+  RemoteSelectionRings,
+} from "@agent-native/toolkit/collab-ui";
 ```
 
 サーバー側のエージェント プレゼンス ヘルパーは、下位​​レベルのコラボレーション パッケージに残ります。
@@ -457,7 +456,7 @@ setPresence({ cursor: { x: 0.4, y: 0.7 }, selection: "#hero" });
 リモート カーソルをコンテナ要素上の絶対位置のラベルとしてレンダリングします。
 
 ```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" }}>
@@ -477,7 +476,7 @@ import { LiveCursorOverlay } from "@agent-native/core/client";
 リモートで選択された要素上に色付きのアウトライン リングと名前タグをレンダリングします:
 
 ```tsx
-import { RemoteSelectionRings } from "@agent-native/core/client";
+import { RemoteSelectionRings } from "@agent-native/toolkit/collab-ui";
 
 <div ref={containerRef} style={{ position: "relative" }}>
   {content}

package/docs/content/locales/ja-JP/sharing.mdx

@@ -93,9 +93,10 @@ description: "フレームワークに組み込まれた Google ドキュメン
 - **スライド** — デッキ
 - **デザイン** — デザインとアセット
 - **クリップ** — 画面録画 (Loom スタイル)
+- **Plan** — visual plans and PR recaps
 - **フォーム** — フォーム定義
 - **カレンダー** — イベントと予約リンク
-- **Analytics** — ダッシュボード (展開中 — 分析テンプレートの `AGENTS.md` を参照)
+- **Analytics** — dashboards, saved analyses, and tokenized session replays
 - **拡張機能** — サンドボックス化されたミニアプリ ([Extensions](/docs/extensions#sharing) を参照)
 
 これらはすべて、同じ `ownableColumns()` スキーマ ヘルパー、同じ `share-resource` アクション、および同じ `<ShareButton>` UI を使用します。あるテンプレートから別のテンプレートに移動すると、共有ダイアログは同じように見えます。
@@ -136,15 +137,22 @@ import { ShareButton } from "@agent-native/core/client";
 
 フレームワークはこれらの actions をすべてのテンプレートに自動マウントします。エージェントはこれらをツールとして呼び出し、UI は `useActionQuery` / `useActionMutation` を通じてこれらを呼び出します。
 
-| アクション                | 機能                                                                                                           |
-| ------------------------- | -------------------------------------------------------------------------------------------------------------- |
-| `share-resource`          | ユーザーまたは組織に特定のロールでのアクセスを許可します。オプションの `notify` は電子メール通知を制御します。 |
-| `unshare-resource`        | ユーザーまたは組織のアクセス権を取り消します。                                                                 |
-| `list-resource-shares`    | 現在の可視性とすべての明示的な許可を表示します。                                                               |
-| `set-resource-visibility` | `private`、`org`、または `public` に変更します。                                                               |
+| アクション                   | 機能                                                                                                           |
+| ---------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| `share-resource`             | ユーザーまたは組織に特定のロールでのアクセスを許可します。オプションの `notify` は電子メール通知を制御します。 |
+| `unshare-resource`           | ユーザーまたは組織のアクセス権を取り消します。                                                                 |
+| `list-resource-shares`       | 現在の可視性とすべての明示的な許可を表示します。                                                               |
+| `set-resource-visibility`    | `private`、`org`、または `public` に変更します。                                                               |
+| `create-agent-resource-link` | Mint a temporary read-only `agent_access` URL for a registered agent-readable resource.                        |
 
 エージェントに「このデザインを編集者としてマーケティング チームと共有する」ように指示すると、エージェントは UI が使用するのと同じエンドポイントに対して `share-resource` を呼び出します。結果は、次回のレンダリング時に共有ダイアログに表示されます。
 
+## 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`.
+
 ## 新しいテンプレートに組み込む {#building}
 
 テンプレートを作成している場合 ([Creating Templates](/docs/creating-templates) を参照)、配線の共有は短くなります。スキーマへの 2 つの追加:

package/docs/content/locales/ko-KR/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/docs/content/locales/ko-KR/cloneable-saas.mdx

@@ -1,19 +1,19 @@
 ---
-title: "템플릿"
+title: "앱"
 description: "작동하는 SaaS 제품을 포크하여 귀하의 것으로 만드세요. 에이전트가 포함됩니다."
 ---
 
-# 템플릿
+# 앱
 
-자신만의 AI 기반 분석 도구를 출시하고 싶으십니까? 메일 클라이언트? 양식 작성기? 템플릿을 선택하면 몇 분 안에 에이전트, 데이터베이스, 인증 및 배포 파이프라인이 이미 연결되어 작동하는 SaaS를 얻을 수 있습니다.
+자신만의 AI 기반 분석 도구를 출시하고 싶으십니까? 메일 클라이언트? 양식 작성기? 예제 앱을 선택하면 몇 분 안에 에이전트, 데이터베이스, 인증 및 배포 파이프라인이 이미 연결되어 작동하는 SaaS를 얻을 수 있습니다.
 
-대부분의 "템플릿"은 빈 비계와 긴 TODO 목록을 제공합니다. 에이전트 네이티브는 이를 뒤집습니다. 각 제품은 **완전한 SaaS급 제품**입니다. 첫날부터 이미 실행 가능하고 배송 가능하며 사용자 정의, 브랜딩 및 배포가 전적으로 귀하의 소유입니다. 스타터 키트가 아닌 복제 가능한 SaaS로 생각하십시오. 상용구를 쳐다보는 것이 아니라 완성된 제품을 포크하는 것입니다.
+대부분의 스타터 템플릿은 빈 비계와 긴 TODO 목록을 제공합니다. 에이전트 네이티브는 이를 뒤집습니다. 각 예제 앱은 **완전한 SaaS급 제품**입니다. 첫날부터 이미 실행 가능하고 배송 가능하며 사용자 정의, 브랜딩 및 배포가 전적으로 귀하의 소유입니다. 스타터 키트가 아닌 복제 가능한 SaaS로 생각하십시오. 상용구를 쳐다보는 것이 아니라 완성된 제품을 포크하는 것입니다.
 
-## 사용 가능한 템플릿 {#catalog}
+## 예제 앱 {#catalog}
 
 각각은 현재 사용할 수 있는 실제 앱이자 자신만의 버전을 위한 런칭 패드입니다.
 
-| 템플릿                                    | 무엇인가요                                                                                                             |
+| 앱                                        | 무엇인가요                                                                                                             |
 | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
 | [**Chat**](/docs/template-chat)           | 내구성 있는 스레드, actions, 인증 및 맞춤형 UI 또는 자체 백엔드에 대한 명확한 경로를 갖춘 최소한의 채팅 우선 앱입니다. |
 | [**Mail**](/docs/template-mail)           | 요원 출신의 슈퍼휴먼. 받은편지함, 라벨, AI 분류, 키보드 우선, 초안 작성 및 에이전트를 통한 전송.                       |
@@ -35,16 +35,16 @@ description: "작동하는 SaaS 제품을 포크하여 귀하의 것으로 만
 
 ## 상자에서 꺼내는 것 {#what-you-get}
 
-모든 템플릿에는 일반적으로 제작하는 데 수개월이 걸리는 부품이 포함되어 있습니다.
+모든 예제 앱에는 일반적으로 제작하는 데 수개월이 걸리는 부품이 포함되어 있습니다.
 
 - **작동 중인 에이전트** — 이미 앱에 연결되어 있고, 이미 데이터에 대해 actions를 가져올 수 있으며, 보고 있는 내용에 대해 이미 컨텍스트를 인식하고 있습니다. 작동 방식은 [Messaging the agent](/docs/messaging)를 참조하세요.
 - **인증** — 로그인, 세션, 조직, 다중 테넌트 격리. 이미 완료되었습니다.
-- **데이터베이스** — 모든 템플릿에는 스키마, 쿼리 및 마이그레이션이 준비되어 있습니다. 자체 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가 있습니다.
 
@@ -159,7 +159,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}
 
@@ -168,10 +168,10 @@ description: "작동하는 SaaS 제품을 포크하여 귀하의 것으로 만
 ## 이를 토대로 구축
 
 - [**Getting Started**](/docs/getting-started) — chat-first app을 만들고, action을 추가하고, structured result를 렌더링한 뒤 page로 확장하기
-- [**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}
 
@@ -181,10 +181,10 @@ description: "작동하는 SaaS 제품을 포크하여 귀하의 것으로 만
 npx @agent-native/core@latest create my-platform
 ```
 
-다중 선택 선택 도구가 제공됩니다. 하나의 앱(독립 실행형) 또는 여러 개(작업 공간 - 앱 공유 인증, 브랜드, 에이전트 구성 및 데이터베이스)를 선택합니다. 선택한 각 템플릿은 필요한 모든 파일과 함께 `apps/<name>/`에 스캐폴딩됩니다. 템플릿 UI 대신 브라우저 UI 없는 automation을 만들려면 `npx @agent-native/core@latest create my-agent --headless`를 사용하세요.
+다중 선택 선택 도구가 제공됩니다. 하나의 앱(독립 실행형) 또는 여러 개(작업 공간 - 앱 공유 인증, 브랜드, 에이전트 구성 및 데이터베이스)를 선택합니다. 선택한 각 앱은 필요한 모든 파일과 함께 `apps/<name>/`에 스캐폴딩됩니다. 앱 UI 대신 브라우저 UI 없는 automation을 만들려면 `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/docs/content/locales/ko-KR/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, 단순 app shell helpers, 기타 template composition modules입니다. 전환 기간 동안 Core는 호환성 re-export를 유지하지만, 새 템플릿과 앱 코드는 toolkit modules를 직접 가져와야 합니다:
+`@agent-native/toolkit`은 기본 런타임 계약에 속하지 않는 재사용 가능한 앱 구축 요소에 사용하세요: shadcn 스타일 UI primitives, 공유 hooks, 단순 app shell helpers, 기타 template composition modules입니다. 전환 기간 동안 Core는 호환성 re-export를 유지합니다.
+
+재사용 가능한 패키지는 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";
 ```
 
+템플릿 앱 안에서는 앱 로컬 어댑터를 선호하세요. 그러면 팀이 primitive를 한 번 교체해도 재사용되는 모든 Toolkit surface가 로컬 구현을 사용합니다:
+
+```tsx
+import { Button } from "@/components/ui/button";
+import { useToast } from "@/hooks/use-toast";
+```
+
 <Diagram id="doc-block-wyryue" 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}