@agent-native/core 0.77.3 → 0.77.4

package/docs/content/locales/ja-JP/file-uploads.md

@@ -19,16 +19,16 @@ description: "ファイル アップロード ストレージを構成します
 
 ```an-diagram title="プロバイダーの解決順序" summary="UploadFile() は、最初に構成されたプロバイダーを順番に選択します。 SQL フォールバックは常に存在するため、アップロードはセットアップなしで機能します。"
 {
-  "html": "<div class=\"diagram-upload\"><div class=\"diagram-box\" data-rough>uploadFile()<br><small class=\"diagram-muted\">POST /_agent-native/file-upload</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-step\"><span class=\"diagram-pill accent\">1</span><div class=\"diagram-node\">User-registered<br><small class=\"diagram-muted\">registerFileUploadProvider() — S3, R2, GCS…</small></div></div><div class=\"diagram-step\"><span class=\"diagram-pill\">2</span><div class=\"diagram-node\">Builder.io<br><small class=\"diagram-muted\">auto when connected — CDN-served</small></div></div><div class=\"diagram-step\"><span class=\"diagram-pill warn\">3</span><div class=\"diagram-node\">SQL fallback<br><small class=\"diagram-muted\">base64 in DB — dev only</small></div></div></div></div>",
+  "html": "<div class=\"diagram-upload\"><div class=\"diagram-box\" data-rough>uploadFile()<br><small class=\"diagram-muted\">POST /_agent-native/file-upload</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-step\"><span class=\"diagram-pill accent\">1</span><div class=\"diagram-node\">ユーザー登録<br><small class=\"diagram-muted\">registerFileUploadProvider() — S3, R2, GCS…</small></div></div><div class=\"diagram-step\"><span class=\"diagram-pill\">2</span><div class=\"diagram-node\">Builder.io<br><small class=\"diagram-muted\">接続時に自動 — CDN 配信</small></div></div><div class=\"diagram-step\"><span class=\"diagram-pill warn\">3</span><div class=\"diagram-node\">SQL フォールバック<br><small class=\"diagram-muted\">DB 内 base64 — 開発専用</small></div></div></div></div>",
   "css": ".diagram-upload{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-upload .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-upload .diagram-step{display:flex;align-items:center;gap:8px}.diagram-upload .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
 
-```an-api title="The upload endpoint" method="POST" path="/_agent-native/file-upload"
+```an-api title="アップロードエンドポイント" method="POST" path="/_agent-native/file-upload"
 {
   "method": "POST",
   "path": "/_agent-native/file-upload",
-  "summary": "Upload a file through the active provider and get back a public URL.",
+  "summary": "アクティブなプロバイダーを通じてファイルをアップロードし、パブリック URL を取得します。",
   "description": "Dispatches to the first configured provider in resolution order. Check the active provider at `GET /_agent-native/file-upload/status`.",
   "request": { "contentType": "multipart/form-data" },
   "responses": [
@@ -117,6 +117,6 @@ const result = await uploadFile({
 if (result) {
   // Provider handled it — result.url is the public URL
 } else {
-  // No provider configured — handle SQL fallback yourself, or skip
+  // No provider configured — handle SQL フォールバック yourself, or skip
 }
 ```

package/docs/content/locales/ja-JP/frames.md

@@ -22,7 +22,7 @@ description: "ローカル開発フレーム、埋め込みエージェント
 
 ```an-diagram title="3 つのフレーム、1 つのランタイム" summary="アプリとエージェント パネルはどのフレームでも同じです。それらを囲むラッパーのみが変更されます。"
 {
-  "html": "<div class=\"diagram-frames\"><div class=\"diagram-card\" data-rough><span class=\"diagram-pill accent\">Embedded panel</span><small class=\"diagram-muted\">ships in every app · dev + prod</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">Local dev frame</span><small class=\"diagram-muted\">app in an iframe + panel + CLI terminal</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">Builder.io cloud frame</span><small class=\"diagram-muted\">hosted: collaboration · visual edit · parallel runs</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>Same runtime<br><small class=\"diagram-muted\">your app · actions · application state</small></div></div>",
+  "html": "<div class=\"diagram-frames\"><div class=\"diagram-card\" data-rough><span class=\"diagram-pill accent\">埋め込みパネル</span><small class=\"diagram-muted\">すべてのアプリに同梱 · dev + prod</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">ローカル開発フレーム</span><small class=\"diagram-muted\">iframe内のアプリ + パネル + CLI端末</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">Builder.ioクラウドフレーム</span><small class=\"diagram-muted\">ホスト版: 共同作業 · ビジュアル編集 · 並列実行</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>同じruntime<br><small class=\"diagram-muted\">あなたのアプリ · アクション · アプリ状態</small></div></div>",
   "css": ".diagram-frames{display:flex;flex-direction:column;gap:10px;align-items:stretch}.diagram-frames .diagram-card{display:flex;flex-direction:column;gap:4px;padding:12px 16px}.diagram-frames .diagram-arrow{font-size:22px;line-height:1;align-self:center}"
 }
 ```

package/docs/content/locales/ja-JP/getting-started.md

@@ -63,7 +63,7 @@ npx @agent-native/core@latest create my-agent --headless
 次に、作成したフォルダーからインストールします。
 
 ```bash
-cd my-agent # or my-app if you chose the Chat template
+cd my-agent # または、チャット テンプレートを選択した場合は my-app
 pnpm install
 ```
 
@@ -82,9 +82,9 @@ pnpm install
   "annotations": [
     { "lines": "5", "label": "ツール説明", "note": "エージェントは `description` を読み、いつツールとして呼び出すかを判断します。" },
     { "lines": "6-8", "label": "型付き契約", "note": "1 つの zod `schema` が、エージェント、UI、HTTP、MCP、A2A のすべての入力を検証します。" },
-    { "lines": "9", "label": "HTTP verb", "note": "Opt this action into an auto-mounted HTTP endpoint." },
-    { "lines": "10", "label": "Read-only", "note": "`readOnly` marks the action as safe to call without approval and cacheable for queries." },
-    { "lines": "11-13", "label": "One implementation", "note": "The `run` body is the single source of truth that every surface executes." }
+    { "lines": "9", "label": "HTTP 動詞", "note": "このアクションを自動マウントされる HTTP エンドポイントとして公開します。" },
+    { "lines": "10", "label": "読み取り専用", "note": "`readOnly` は、このアクションが承認なしで安全に呼び出せ、クエリとしてキャッシュ可能であることを示します。" },
+    { "lines": "11-13", "label": "単一の実装", "note": "`run` 本体は、すべてのサーフェスが実行する唯一の信頼できる実装です。" }
   ]
 }
 ```
@@ -123,7 +123,7 @@ pnpm dev
 
 ```an-diagram title="1 つのアクションであらゆる面に対応" summary="単一の defineAction ファイルは、追加の配線なしですべてのコンシューマに展開されます。"
 {
-  "html": "<div class=\"diagram-fan\"><div class=\"diagram-box\" data-rough>defineAction</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-surfaces\"><span class=\"diagram-pill\">Chat UI</span><span class=\"diagram-pill\">CLI</span><span class=\"diagram-pill\">HTTP</span><span class=\"diagram-pill\">MCP</span><span class=\"diagram-pill\">A2A</span><span class=\"diagram-pill\">Scheduled jobs</span><span class=\"diagram-pill\">Webhooks</span></div></div>",
+  "html": "<div class=\"diagram-fan\"><div class=\"diagram-box\" data-rough>defineAction</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-surfaces\"><span class=\"diagram-pill\">チャット UI</span><span class=\"diagram-pill\">CLI</span><span class=\"diagram-pill\">HTTP</span><span class=\"diagram-pill\">MCP</span><span class=\"diagram-pill\">A2A</span><span class=\"diagram-pill\">スケジュール済みジョブ</span><span class=\"diagram-pill\">Webhooks</span></div></div>",
   "css": ".diagram-fan{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-fan .diagram-surfaces{display:flex;flex-wrap:wrap;gap:8px;max-width:420px}.diagram-fan .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -138,7 +138,7 @@ pnpm dev
 ```an-callout
 {
   "tone": "info",
-  "body": "**Headless is still a real app.** The app-agent loop persists sessions, threads, runs, settings, and credentials in SQL — it is not a stateless prompt. You can add a UI later without touching your actions or state."
+  "body": "**ヘッドレスは依然として実際のアプリです。**アプリとエージェントのループは、セッション、スレッド、実行、設定、資格情報を SQL に保持します。これはステートレス プロンプトではありません。アクションや状態に手を加えずに、後から UI を追加できます。"
 }
 ```
 
@@ -165,7 +165,7 @@ export default function ChatRoute() {
   `useActionMutation()`.
 
 完全なコンポーネント セットについては、[Drop-in Agent](/docs/drop-in-agent) を参照してください。
-[Native Chat UI](/docs/native-chat-ui) はアクションの結果をテーブルとしてレンダリングします。
+[Native チャット UI](/docs/native-chat-ui) はアクションの結果をテーブルとしてレンダリングします。
 プレーンテキストの代わりにグラフと入力されたカード。
 
 **ヘッドレスで始めましたが、後で UI が必要ですか?** チャット テンプレートは UI オンランプです —
@@ -178,12 +178,12 @@ export default function ChatRoute() {
 
 ```text
 my-app/
-  actions/         # Agent-callable actions
-  app/             # React frontend (UI templates only; omitted when headless)
-  server/          # Nitro API server (routes, plugins)
-  AGENTS.md        # Always-on agent instructions
-  .agents/         # Skills the agent can pull in when relevant
-  data/app.db      # Local SQLite state when DATABASE_URL is unset
+  actions/         # エージェントが呼び出せるアクション
+  app/             # React フロントエンド（UI テンプレートのみ。headless では省略）
+  server/          # Nitro API サーバー（ルート、プラグイン）
+  AGENTS.md        # 常に適用されるエージェント指示
+  .agents/         # 必要に応じてエージェントが読み込むスキル
+  data/app.db      # DATABASE_URL 未設定時のローカル SQLite 状態
 ```
 
 ## 次にどこに行くか

package/docs/content/locales/ja-JP/harness-agents.md

@@ -215,7 +215,7 @@ const run = startAgentHarnessRun({
 
 ```an-diagram title="ターン、プロセス、デプロイをまたいで再開" summary="各ターンは、不透明なresumeStateをSQLに切り離します。次のターンでは、チャット履歴を再生する代わりに、それが createSession にフィードバックされます。"
 {
-  "html": "<div class=\"diagram-resume\"><div class=\"diagram-node\" data-rough>Turn N<br><small class=\"diagram-muted\">streamTurn</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>detach &rarr; resumeState<br><small class=\"diagram-muted\">opaque · SQL harness session</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\" data-rough>Turn N+1<br><small class=\"diagram-muted\">createSession.resumeState</small></div></div>",
+  "html": "<div class=\"diagram-resume\"><div class=\"diagram-node\" data-rough>ターンN<br><small class=\"diagram-muted\">streamTurn</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>detach &rarr; resumeState<br><small class=\"diagram-muted\">不透明 · SQL harnessセッション</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\" data-rough>ターンN+1<br><small class=\"diagram-muted\">createSession.resumeState</small></div></div>",
   "css": ".diagram-resume{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-resume .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -267,7 +267,7 @@ Agent-Native actions から `createSession.tools` までの意図的なセット
 ネイティブ ウィジェットの `mcpApp` ペイロード)、`approval-request`、`file-change`、
 `compaction`、`usage`、`error`、および `done`。ツールの結果は
 同じ翻訳、アクション宣言されたネイティブ ウィジェットは引き続きレンダリングされます — を参照
-[Native Chat UI](/docs/native-chat-ui).
+[Native チャット UI](/docs/native-chat-ui).
 
 ## バックグラウンド実行と UI {#background-runs}
 
@@ -341,7 +341,7 @@ registerAgentHarness({
 
 ## 関連ドキュメント {#related-docs}
 
-- [Native Chat UI](/docs/native-chat-ui) — `AgentChatRuntime` とのチャット UI の背後に独自のエージェントを配置します。
+- [Native チャット UI](/docs/native-chat-ui) — `AgentChatRuntime` とのチャット UI の背後に独自のエージェントを配置します。
 - [Agent Surfaces](/docs/agent-surfaces) — ヘッドレス、チャット、サイドカー、またはフルアプリを選択します。
 - [Agent-Native Code UI](/docs/code-agents-ui) — 再利用可能なコーディング ワークスペース サーフェス。
 - [Custom Agents & Teams](/docs/agent-teams) — バックグラウンド実行とサブエージェントの委任。

package/docs/content/locales/ja-JP/human-approval.md

@@ -20,8 +20,8 @@ description: "重要なアクションが実行される前にエージェント
   "language": "ts",
   "code": "export default defineAction({\n  description: \"Send an email via Gmail.\",\n  schema: z.object({\n    to: z.string(),\n    subject: z.string(),\n    body: z.string(),\n  }),\n  // Sending is outward-facing and hard to undo, so the agent can never send\n  // without a human approving the specific call. Drafting/queueing is\n  // unaffected — only the real send is gated.\n  needsApproval: true,\n  run: async (args) => {\n    /* ...actually send... */\n  },\n});",
   "annotations": [
-    { "lines": "10", "label": "The whole gate", "note": "One flag. With it truthy and the call unapproved, the loop stops before `run` — the model never reaches the side effect on its own." },
-    { "lines": "11-13", "label": "run() is untouched", "note": "The handler stays the same. Approval is enforced by the loop around it, not by anything inside `run`." }
+    { "lines": "10", "label": "門全体", "note": "フラグは 1 つです。それが真実であり、呼び出しが承認されていない場合、ループは `run` の前で停止します。つまり、モデル自体が副作用に到達することはありません。" },
+    { "lines": "11-13", "label": "run() is untouched", "note": "ハンドラーはそのままです。承認は、`run` 内の何かによってではなく、周囲のループによって強制されます。" }
   ]
 }
 ```
@@ -72,7 +72,7 @@ description: "重要なアクションが実行される前にエージェント
 
 ```an-diagram title="承認の中断" summary="ゲート呼び出しは、run() が起動される前にターンを一時停止します。承認により、コールのキーを保持するターンが再発行されます。そうして初めて副作用が起こります。"
 {
-  "html": "<div class=\"diagram-approve\"><div class=\"diagram-box\" data-rough>Agent calls send-email</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-panel warn\" data-rough><strong>Gate truthy, call not yet approved</strong><small class=\"diagram-muted\">loop emits tool_start + approval_required { tool, input, approvalKey }</small><span class=\"diagram-pill warn\">turn pauses &mdash; run() did NOT execute</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>Human clicks Approve in chat<br><small class=\"diagram-muted\">client re-issues the turn with approvedToolCalls: [approvalKey]</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-panel ok\" data-rough><span class=\"diagram-pill ok\">Gate sees the key &rarr; run() executes &rarr; email sends</span></div></div>",
+  "html": "<div class=\"diagram-approve\"><div class=\"diagram-box\" data-rough>エージェントがsend-emailを呼び出す</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-panel warn\" data-rough><strong>Gateはtrue、呼び出しは未承認</strong><small class=\"diagram-muted\">loop emits tool_start + approval_required { tool, input, approvalKey }</small><span class=\"diagram-pill warn\">turn pauses &mdash; run() did NOT execute</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>人がチャットで承認をクリック<br><small class=\"diagram-muted\">クライアントがapprovedToolCalls: [approvalKey]でターンを再発行</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-panel ok\" data-rough><span class=\"diagram-pill ok\">Gate sees the key &rarr; run() executes &rarr; email sends</span></div></div>",
   "css": ".diagram-approve{display:flex;flex-direction:column;align-items:center;gap:8px}.diagram-approve .diagram-panel{display:flex;flex-direction:column;gap:6px;align-items:center;padding:12px 16px;text-align:center}.diagram-approve .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```

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

@@ -13,13 +13,13 @@ description: "エージェント ネイティブ アプリの仕組み: 最初
 
 > **エージェント** — データの読み取り、書き込み、actions の実行、およびコードの変更を行う自律型 AI。 skills と説明書でカスタマイズ可能。
 >
-> **アプリケーション** — エージェントの周囲の製品表面。これは、最初はアクションのみ、リッチ チャット、小さなコントロール プレーン、またはダッシュボード、フロー、ビジュアライゼーションを備えた完全な React UI である可能性があります。
+> **アプリケーション** — エージェントの周囲の製品表面。これは、最初はアクションのみ、リッチ チャット、小さなコントロール プレーン、またはダッシュボード、フロー、ビジュアライゼーションを備えた完全な React UI画面 である可能性があります。
 >
 > **コンピュータ** — データベース、ブラウザ、コード実行。エージェントは SQL および組み込みツールと直接連携します。 MCP サーバーはオプションのアドオンであり、基盤ではありません。
 
 ```an-diagram title="エージェント、アプリケーション、およびコンピュータ" summary="3 つのレイヤーが 1 つの共有 SQL ストア上で連携します。エージェントとアプリケーションは両方とも同じデータの読み取りと書き込みを行います。"
 {
-  "html": "<div class=\"diagram-arch\"><div class=\"diagram-row\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Agent</span><small class=\"diagram-muted\">reads + writes data, runs actions, modifies code</small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">Application</span><small class=\"diagram-muted\">action-only, chat, control plane, or full React UI</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;&nbsp;&uarr;</div><div class=\"diagram-box\" data-rough>Computer<br><small class=\"diagram-muted\">SQLデータベース · browser · code execution</small></div></div>",
+  "html": "<div class=\"diagram-arch\"><div class=\"diagram-row\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Agent</span><small class=\"diagram-muted\">データを読み書きし、actionsを実行し、コードを変更</small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">Application</span><small class=\"diagram-muted\">actionのみ、チャット、コントロールプレーン、または完全なReact UI画面</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;&nbsp;&uarr;</div><div class=\"diagram-box\" data-rough>Computer<br><small class=\"diagram-muted\">SQLデータベース · browser · code execution</small></div></div>",
   "css": ".diagram-arch{display:flex;flex-direction:column;align-items:center;gap:10px}.diagram-arch .diagram-row{display:flex;gap:12px;flex-wrap:wrap;justify-content:center}.diagram-arch .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:220px}.diagram-arch .diagram-arrow{font-size:20px;line-height:1}.diagram-arch .diagram-box{text-align:center;padding:12px 18px}"
 }
 ```
@@ -86,22 +86,22 @@ UI のみを持つ機能はエージェントには表示されません。 acti
 - `oauth_tokens` — OAuth 資格情報
 - `sessions` — 認証セッション
 
-```an-schema title="Core SQL stores" summary="Auto-created in every template — the agent and UI both read and write these."
+```an-schema title="コア SQL ストア" summary="すべてのテンプレートで自動作成されます。エージェントと UI は両方ともこれらの読み取りと書き込みを行います。"
 {
   "entities": [
-    { "id": "application_state", "name": "application_state", "note": "Ephemeral UI state the agent reads for context", "fields": [
-      { "name": "key", "type": "text", "pk": true, "note": "e.g. 'navigation'" },
-      { "name": "value", "type": "json", "note": "view, selection, drafts" }
+    { "id": "application_state", "name": "application_state", "note": "エージェントがコンテキストのために読み取る一時的な UI 状態", "fields": [
+      { "name": "key", "type": "text", "pk": true, "note": "e.g。 「ナビゲーション」" },
+      { "name": "value", "type": "json", "note": "ビュー、選択、ドラフト" }
     ] },
-    { "id": "settings", "name": "settings", "note": "Persistent key-value config", "fields": [
+    { "id": "settings", "name": "settings", "note": "永続的なキーと値の構成", "fields": [
       { "name": "key", "type": "text", "pk": true },
       { "name": "value", "type": "json" }
     ] },
-    { "id": "oauth_tokens", "name": "oauth_tokens", "note": "OAuth credentials", "fields": [
+    { "id": "oauth_tokens", "name": "oauth_tokens", "note": "OAuth認証情報", "fields": [
       { "name": "provider", "type": "text", "pk": true },
       { "name": "token", "type": "text" }
     ] },
-    { "id": "sessions", "name": "sessions", "note": "Auth sessions", "fields": [
+    { "id": "sessions", "name": "sessions", "note": "認証セッション", "fields": [
       { "name": "id", "type": "text", "pk": true },
       { "name": "userId", "type": "text" }
     ] }
@@ -123,11 +123,11 @@ export const forms = table("forms", {
 ```
 
 ```bash
-# Core actions for quick database inspection and one-off maintenance
+# 迅速なデータベース検査と 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 on a large text column — sends a diff, not the whole value
+# 大きなテキスト列の Surgical find/replace — 値全体ではなく差分を送信します
 pnpm action db-patch --table documents --column content \
   --where "id='doc-1'" --find "old heading" --replace "new heading"
 ```
@@ -213,7 +213,7 @@ useDbSync({ queryClient });
 
 ```an-diagram title="ライブ同期フロー" summary="エージェントの書き込みは、手動更新のない UI レンダリングになります。最初に SSE が行われ、ユニバーサル フォールバックとしてポーリングされます。"
 {
-  "html": "<div class=\"diagram-sync\"><div class=\"diagram-node\">Agent action<br><small class=\"diagram-muted\">writes to DB</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">Change event<br><small class=\"diagram-muted\">source: action / settings</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">useDbSync</span><small class=\"diagram-muted\">SSE &middot; poll fallback</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">Query refetch<br><small class=\"diagram-muted\">render, no reload</small></div></div>",
+  "html": "<div class=\"diagram-sync\"><div class=\"diagram-node\">エージェントアクション<br><small class=\"diagram-muted\">DB に書き込み</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">変更イベント<br><small class=\"diagram-muted\">source: action / settings</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">useDbSync</span><small class=\"diagram-muted\">SSE &middot; poll fallback</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">クエリ再取得<br><small class=\"diagram-muted\">再読み込みなしで描画</small></div></div>",
   "css": ".diagram-sync{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.diagram-sync .diagram-arrow{font-size:22px;line-height:1}.diagram-sync .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:10px 14px}"
 }
 ```
@@ -288,7 +288,7 @@ UI はルート変更時にこれを書き込みます。エージェントは
 - **1 つのアクション = すべてのサーフェス。** `defineAction()` で定義されたすべてのアクションは、同時にエージェント ツール、タイプセーフ フロントエンド フック (`useActionQuery` / `useActionMutation`)、フレームワーク所有の HTTP トランスポート、CLI コマンド、外部クライアント用の MCP ツール、および他のエージェント ネイティブ アプリ用の A2A ツールでもあります。オプションの `link` および `mcpApp` メタデータは、2 番目の実装なしでディープ リンクと MCP アプリ UI を追加します。
 - **ユーザーごとの完全なワークスペース。** Skills、共有 `LEARNINGS.md`、個人 `memory/MEMORY.md`、`AGENTS.md`、カスタム サブエージェント、スケジュールされたジョブ、接続された MCP サーバー — すべて SQL でサポートされており、dev-box は必要ありません。 [Workspace](/docs/workspace) を参照してください。
 - **React コンポーネントをドロップインします。** `<AgentPanel />` および `<AgentSidebar />` は、アプリ内の任意の場所にチャットとワークスペースをレンダリングします。 [Drop-in Agent](/docs/drop-in-agent) を参照してください。
-- **BYO エージェント チャット ランタイム。** 同じチャット UI は、OpenAI エージェント、OpenAI レスポンス、Claude エージェント SDK、Vercel AI SDK、AG-UI、または独自の正規化された HTTP ストリームの上に置くことができます。 [Native Chat UI](/docs/native-chat-ui#byo-agent-runtimes) を参照してください。
+- **BYO エージェント チャット ランタイム。** 同じチャット UI は、OpenAI エージェント、OpenAI レスポンス、Claude エージェント SDK、Vercel AI SDK、AG-UI、または独自の正規化された HTTP ストリームの上に置くことができます。 [Native チャット UI](/docs/native-chat-ui#byo-agent-runtimes) を参照してください。
 - **エージェントと UI 間のライブ同期。** 同じプロセスが `/_agent-native/events` 経由でストリームをすぐに書き込みます。軽量のポーリングにより、サーバーレス、cron、およびクロスプロセス書き込みが収束されます。 actions を変更すると、アクションに基づくクエリが自動的に無効になるため、エージェントが作成したレコードは手動で更新しなくても表示されます。以下の [Live Sync](#polling-sync) を参照してください。
 - **認証、組織、RBAC。** 組織/メンバー/ロールによる優れた認証がすべてのテンプレートに組み込まれています。 [Authentication](/docs/authentication) を参照してください。
 - **コンテキスト認識。** エージェントは、`navigation` アプリ状態キーを通じてユーザーが何を見ているのかを常に認識します。 [Context Awareness](/docs/context-awareness) を参照してください。
@@ -306,7 +306,7 @@ UI はルート変更時にこれを書き込みます。エージェントは
 - [What Is Agent-Native?](/docs/what-is-agent-native) — ビジョンと哲学
 - [Context Awareness](/docs/context-awareness) — ナビゲーション状態、ビュー画面、ナビゲーション コマンド
 - [Skills Guide](/docs/skills-guide) — フレームワーク skills、ドメイン skills、カスタム skills の作成
-- [Native Chat UI](/docs/native-chat-ui) — アクション宣言されたテーブル、チャート、および BYO 実行時の状態
+- [Native チャット UI](/docs/native-chat-ui) — アクション宣言されたテーブル、チャート、および BYO 実行時の状態
 - [Agent Surfaces](/docs/agent-surfaces) — ヘッドレス、リッチ チャット、埋め込みサイドカー、フルアプリ パス
 - [A2A Protocol](/docs/a2a-protocol) — エージェント間の通信
 - [Multi-App Workspace](/docs/multi-app-workspace) — 共有認証、skills、コンポーネント、資格情報を使用して 1 つのモノリポジトリで多くのアプリをホストします

package/docs/content/locales/ja-JP/local-file-mode.md

@@ -48,7 +48,7 @@ SQL 行またはローカル ファイルへ。
 
 ```an-diagram title="同じ行動、2 つの真実の情報源" summary="UI とエージェントは、両方のモードで同じアクションを呼び出します。アクション層は、各呼び出しが SQL 行またはリポジトリ ファイルのどちらに解決されるかを決定します。"
 {
-  "html": "<div class=\"diagram-mode\"><div class=\"diagram-col entry\"><div class=\"diagram-node\">Content UI</div><div class=\"diagram-node\">Agent + actions<br><small class=\"diagram-muted\">list/get/update-document</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-row resolve\"><div class=\"diagram-panel\" data-rough><span class=\"diagram-pill accent\">Database mode</span><small class=\"diagram-muted\">SQL rows via Drizzle</small><small class=\"diagram-muted\">hosted · sharing · comments · history</small></div><div class=\"diagram-panel\" data-rough><span class=\"diagram-pill ok\">Local File Mode</span><small class=\"diagram-muted\">repo files via agent-native.json</small><small class=\"diagram-muted\">Git review · coding-agent edits</small></div></div></div>",
+  "html": "<div class=\"diagram-mode\"><div class=\"diagram-col entry\"><div class=\"diagram-node\">コンテンツUI</div><div class=\"diagram-node\">エージェント + actions<br><small class=\"diagram-muted\">list/get/update-document</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-row resolve\"><div class=\"diagram-panel\" data-rough><span class=\"diagram-pill accent\">データベースモード</span><small class=\"diagram-muted\">SQL rows via Drizzle</small><small class=\"diagram-muted\">ホスト版 · 共有 · コメント · 履歴</small></div><div class=\"diagram-panel\" data-rough><span class=\"diagram-pill ok\">Local File Mode</span><small class=\"diagram-muted\">repo files via agent-native.json</small><small class=\"diagram-muted\">Gitレビュー · コーディングエージェント編集</small></div></div></div>",
   "css": ".diagram-mode{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-mode .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-mode .diagram-arrow{font-size:22px;line-height:1}.diagram-mode .resolve{display:flex;gap:12px;flex-wrap:wrap}.diagram-mode .diagram-panel{display:flex;flex-direction:column;gap:4px;padding:12px 14px}"
 }
 ```
@@ -165,13 +165,13 @@ npx @agent-native/core@latest skills add content --mode local-files --scope proj
 
 ```mdx
 ---
-title: "Getting Started"
+title: "はじめに"
 icon: "sparkles"
 isFavorite: true
 updatedAt: "2026-06-12T20:00:00.000Z"
 ---
 
-# Getting Started
+# はじめに
 
 Use <FrameworkTabs value="react" /> to show framework-specific code.
 ```
@@ -251,10 +251,10 @@ export const ImpactCounterInputs = {
 
 ```mdx
 ---
-title: "Launch Notes"
+title: "起動ノート"
 ---
 
-# Launch Notes
+# 起動ノート
 
 <ImpactCounter label="wins" />
 ```

package/docs/content/locales/ja-JP/mcp-apps.md

@@ -32,7 +32,7 @@ MCP アプリ拡張機能をサポートするホストの場合、アクショ
 
 ```an-diagram title="MCP アプリ埋め込みラウンドトリップ" summary="アクションのリンク ターゲットは埋め込みターゲットでもあります。有効なホストは、同じ署名済みアプリ ルートをインラインで読み込みます。他の人は全員ディープリンクに戻ります。"
 {
-  "html": "<div class=\"diagram-embed\"><div class=\"diagram-card\" data-rough><strong>Action</strong><small class=\"diagram-muted\">`link` target = MCP App embed target</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\" data-rough><strong>embedApp()</strong><span class=\"diagram-pill accent\">create_embed_session</span><small class=\"diagram-muted\">mints short-lived embed session</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\" data-rough><strong>/_agent-native/embed/start</strong><small class=\"diagram-muted\">exchanges one-time SQL ticket</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\" data-rough><strong>Signed app route</strong><span class=\"diagram-pill ok\">real React route</span><small class=\"diagram-muted\">short-lived browser session</small></div><div class=\"diagram-fallback\"><span class=\"diagram-pill warn\">no MCP Apps support</span><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>&quot;Open in … &rarr;&quot; deep link</div></div></div>",
+  "html": "<div class=\"diagram-embed\"><div class=\"diagram-card\" data-rough><strong>Action</strong><small class=\"diagram-muted\">`link` target = MCP App embed target</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\" data-rough><strong>embedApp()</strong><span class=\"diagram-pill accent\">create_embed_session</span><small class=\"diagram-muted\">mints short-lived embed session</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\" data-rough><strong>/_agent-native/embed/start</strong><small class=\"diagram-muted\">一回限りのSQL ticketを交換</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\" data-rough><strong>Signed app route</strong><span class=\"diagram-pill ok\">実際のReactルート</span><small class=\"diagram-muted\">short-lived browser session</small></div><div class=\"diagram-fallback\"><span class=\"diagram-pill warn\">MCP Apps 非対応</span><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>&quot;Open in … &rarr;&quot; deep link</div></div></div>",
 "css": ".diagram-embed{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-embed .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:140px}.diagram-embed .diagram-arrow{font-size:22px;line-height:1}.diagram-embed .diagram-fallback{display:flex;flex-direction:column;align-items:center;gap:6px;margin-inline-start:8px}"
 }
 
@@ -60,9 +60,9 @@ export default defineAction({
   "language": "ts",
   "code": "import { embedApp } from \"@agent-native/core\";\n\nexport default defineAction({\n  // ...description, schema, run, link...\n  mcpApp: {\n    resource: embedApp({\n      title: \"Review draft\",\n      description: \"Open the generated draft in the real Mail compose UI.\",\n      iframeTitle: \"Agent-Native Mail\",\n      openLabel: \"Open in Mail\",\n    }),\n  },\n});",
   "annotations": [
-    { "lines": "6", "label": "Progressive enhancement", "note": "`mcpApp.resource` advertises an inline UI for hosts that support the MCP Apps extension. Keep the action's `link` builder too — CLI-only and older hosts ignore the UI metadata and still need the deep link." },
+    { "lines": "6", "label": "段階的な強化", "note": "`mcpApp.resource` は、MCP Apps 拡張機能をサポートするホストのインライン UI をアドバタイズします。アクションの `link` ビルダーも保持します。CLI のみの古いホストは UI メタデータを無視し、依然としてディープ リンクを必要とします。" },
     { "lines": "7", "label": "Embed = the link target", "note": "`embedApp()` uses the action's `link` as its launch target: it calls `create_embed_session`, exchanges a one-time SQL ticket at `/_agent-native/embed/start`, and navigates the MCP App frame to the same signed app route." },
-    { "lines": "11", "label": "Universal fallback label", "note": "`openLabel` is the visible `\"Open in … →\"` text used as the deep-link escape hatch when a host does not render the inline iframe." }
+    { "lines": "11", "label": "ユニバーサルフォールバックラベル", "note": "`openLabel` is the visible `\"Open in … →\"` text used as the deep-link escape hatch when a host does not render the inline iframe." }
   ]
 }
 ```
@@ -81,7 +81,7 @@ MCP アプリの埋め込みはルートの埋め込みであり、個別のミ
 
 ```an-diagram title="2 つのホスト ブリッジ パス、1 つの署名済みルート" summary="クロードは水和ルートを移植し、直接 ui/_bridge を使用します。 ChatGPT は、window.openai 経由で制御された iframe を取得し、postMessage 経由でホスト アクションを中継します。どちらも同じ署名済みアプリ ルートを指します。"
 {
-  "html": "<div class=\"diagram-bridge\"><div class=\"diagram-col\"><div class=\"diagram-card\" data-rough><strong>Claude web</strong><span class=\"diagram-pill accent\">single-frame transplant</span><small class=\"diagram-muted\">hydrates signed app HTML in Claude's iframe, then direct`ui/_` host bridge</small></div><div class=\"diagram-card\" data-rough><strong>ChatGPT web</strong><span class=\"diagram-pill accent\">controlled route iframe</span><small class=\"diagram-muted\">`window.openai`host APIs ·`agentNative.mcpHost.*` postMessage relay</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Same signed app route<br><small class=\"diagram-muted\">normal route + React components</small></div></div>",
+  "html": "<div class=\"diagram-bridge\"><div class=\"diagram-col\"><div class=\"diagram-card\" data-rough><strong>Claude web</strong><span class=\"diagram-pill accent\">single-frame transplant</span><small class=\"diagram-muted\">Claudeのiframeで署名済みアプリHTMLをhydrateし、その後直接`ui/_`ホストブリッジ</small></div><div class=\"diagram-card\" data-rough><strong>ChatGPT web</strong><span class=\"diagram-pill accent\">controlled route iframe</span><small class=\"diagram-muted\">`window.openai`host APIs ·`agentNative.mcpHost.*` postMessage relay</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Same signed app route<br><small class=\"diagram-muted\">通常ルート + React コンポーネント</small></div></div>",
 "css": ".diagram-bridge{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-bridge .diagram-col{display:flex;flex-direction:column;gap:12px}.diagram-bridge .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;max-width:300px}.diagram-bridge .diagram-arrow{font-size:22px;line-height:1}.diagram-bridge .diagram-box{padding:16px 18px;text-align:center}"
 }
 

package/docs/content/locales/ja-JP/mcp-clients.md

@@ -22,7 +22,7 @@ description: "エージェント ネイティブ アプリをローカル MCP
 
 ```an-diagram title="クライアントの方向性: 多数のソース、1 つのツール レジストリ" summary="構成ファイル、環境、およびランタイム UI はすべて MCP マネージャーにマージされます。そのツールは接頭辞付きで表示され、アプリのアクションと一緒にツール検索可能です。これはサーバーの方向性を反映したものです。"
 {
-  "html": "<div class=\"mcp-merge\"><div class=\"diagram-col sources\"><div class=\"diagram-box\" data-rough>Workspace <code>mcp.config.json</code><br><small class=\"diagram-muted\">shared across apps</small></div><div class=\"diagram-box\" data-rough>App-root <code>mcp.config.json</code><br><small class=\"diagram-muted\">per-app override</small></div><div class=\"diagram-box\" data-rough><code>MCP_SERVERS</code> env<br><small class=\"diagram-muted\">CI / production</small></div><div class=\"diagram-box\" data-rough>Remote via settings UI<br><small class=\"diagram-muted\">personal &amp; org scope</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">MCP manager</span><small class=\"diagram-muted\">merge &middot; hot-reload</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col out\"><div class=\"diagram-node\">Agent tool registry<br><small class=\"diagram-muted\"><code>mcp__&lt;server-id&gt;__&lt;tool&gt;</code></small></div><div class=\"diagram-node\"><code>tool-search</code><br><small class=\"diagram-muted\">discover by intent</small></div></div></div>",
+  "html": "<div class=\"mcp-merge\"><div class=\"diagram-col sources\"><div class=\"diagram-box\" data-rough>Workspace <code>mcp.config.json</code><br><small class=\"diagram-muted\">アプリ間で共有</small></div><div class=\"diagram-box\" data-rough>アプリルート <code>mcp.config.json</code><br><small class=\"diagram-muted\">アプリごとの上書き</small></div><div class=\"diagram-box\" data-rough><code>MCP_SERVERS</code> env<br><small class=\"diagram-muted\">CI / 本番</small></div><div class=\"diagram-box\" data-rough>設定 UI からリモート設定<br><small class=\"diagram-muted\">personal &amp; org scope</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">MCP マネージャー</span><small class=\"diagram-muted\">merge &middot; hot-reload</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col out\"><div class=\"diagram-node\">エージェントツール registry<br><small class=\"diagram-muted\"><code>mcp__&lt;server-id&gt;__&lt;tool&gt;</code></small></div><div class=\"diagram-node\"><code>tool-search</code><br><small class=\"diagram-muted\">意図で発見</small></div></div></div>",
   "css": ".mcp-merge{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.mcp-merge .diagram-col{display:flex;flex-direction:column;gap:8px}.mcp-merge .center{display:flex;flex-direction:column;align-items:center;gap:4px}.mcp-merge .diagram-arrow{font-size:22px;line-height:1}.mcp-merge code{font-size:.85em}"
 }
 ```
@@ -108,9 +108,9 @@ Chrome DevTools はデフォルトで `--autoConnect` を使用します。こ
   "language": "jsonc",
   "code": "{\n  \"$schema\": \"https://agent-native.com/schema/mcp.config.json\",\n  \"servers\": {\n    \"claude-in-chrome\": {\n      \"command\": \"claude-in-chrome-mcp\",\n      \"args\": [],\n      \"env\": { \"LOG_LEVEL\": \"info\" }\n    },\n    \"filesystem\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-filesystem@latest\", \"/Users/me/projects\"]\n    }\n  }\n}",
   "annotations": [
-    { "lines": "3", "label": "Server id", "note": "The key becomes the tool prefix: this server's tools surface as `mcp__claude-in-chrome__*` in the agent's registry, so they can't collide with your template's actions." },
-    { "lines": "4-6", "label": "stdio launcher", "note": "`command` + `args` spawn a local binary. Stdio servers are intended for **local development** — they are a no-op in edge runtimes." },
-    { "lines": "6", "label": "Process env", "note": "Optional `env` is passed to the spawned process. Keep secrets out of committed config; prefer `MCP_SERVERS` or the settings UI for tokens." }
+    { "lines": "3", "label": "サーバーID", "note": "キーはツールのプレフィックスになります。このサーバーのツールはエージェントのレジストリ内で `mcp__claude-in-chrome__*` として表示されるため、テンプレートのアクションと衝突することはありません。" },
+    { "lines": "4-6", "label": "stdio launcher", "note": "`command` + `args` はローカル バイナリを生成します。 Stdio サーバーは**ローカル開発**を目的としており、エッジ ランタイムでは何も操作されません。" },
+    { "lines": "6", "label": "プロセス環境", "note": "Optional `env` is passed to the spawned process. Keep secrets out of committed config; prefer `MCP_SERVERS` or the settings UI for tokens." }
   ]
 }
 ```
@@ -131,7 +131,7 @@ Chrome DevTools はデフォルトで `--autoConnect` を使用します。こ
 MCP 設定は次の順序で解決され、最初に一致したものが優先されます:
 
 1. **ワークスペース ルート `mcp.config.json`** — `package.json` の `agent-native.workspaceCore` 経由で検出されました。ワークスペース内のすべてのアプリ間で共有されます。
-2. **App-root `mcp.config.json`** — すべてのアプリで MCP サーバーを使用したくない場合は、アプリごとのオーバーライド。
+2. **アプリルート `mcp.config.json`** — すべてのアプリで MCP サーバーを使用したくない場合は、アプリごとのオーバーライド。
 3. **`MCP_SERVERS` env var** — ファイルが意味をなさない CI/運用環境用の、同じ形状の JSON 文字列。
 
 ## 本番デプロイ: `MCP_SERVERS` {#mcp-servers-env}
@@ -204,7 +204,7 @@ Dispatch は従来のハブであり、すでにアプリ間で調整されて
 
 ```an-diagram title="ハブ モデル: 1 つのアプリが組織スコープの MCP サーバーにサービスを提供します" summary="Dispatch は組織スコープの MCP サーバーを保持します。コンシューマ アプリは、それらを mcp__hub_<orgId>_<name>__* としてプルしてマージします。組織スコープの行のみが共有され、個人の認証情報は保持されます。"
 {
-  "html": "<div class=\"mcp-hub\"><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">Dispatch hub</span><small class=\"diagram-muted\">org-scope MCP servers</small><small class=\"diagram-muted\"><code>GET /mcp/hub/servers</code></small></div><div class=\"diagram-col arrows\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div></div><div class=\"diagram-col consumers\"><div class=\"diagram-box\" data-rough>Mail<br><small class=\"diagram-muted\"><code>mcp__hub_&lt;orgId&gt;_&lt;name&gt;__*</code></small></div><div class=\"diagram-box\" data-rough>Clips<br><small class=\"diagram-muted\">pull + merge each ~60s</small></div></div></div><p class=\"diagram-muted note\">Bearer-gated by <code>AGENT_NATIVE_MCP_HUB_TOKEN</code>. Personal (user-scope) servers are never re-exposed.</p>",
+  "html": "<div class=\"mcp-hub\"><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">Dispatch hub</span><small class=\"diagram-muted\">組織スコープのMCPサーバー</small><small class=\"diagram-muted\"><code>GET /mcp/hub/servers</code></small></div><div class=\"diagram-col arrows\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div></div><div class=\"diagram-col consumers\"><div class=\"diagram-box\" data-rough>Mail<br><small class=\"diagram-muted\"><code>mcp__hub_&lt;orgId&gt;_&lt;name&gt;__*</code></small></div><div class=\"diagram-box\" data-rough>Clips<br><small class=\"diagram-muted\">約60秒ごとにpull + merge</small></div></div></div><p class=\"diagram-muted note\">Bearer-gated by <code>AGENT_NATIVE_MCP_HUB_TOKEN</code>. Personal (user-scope) servers are never re-exposed.</p>",
   "css": ".mcp-hub{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.mcp-hub .center{display:flex;flex-direction:column;align-items:center;gap:4px}.mcp-hub .diagram-col{display:flex;flex-direction:column;gap:10px}.mcp-hub .arrows .diagram-arrow{font-size:22px;line-height:1}.mcp-hub .note{margin:8px 0 0;font-size:.85em}.mcp-hub code{font-size:.85em}"
 }
 ```
@@ -220,7 +220,7 @@ Dispatch は従来のハブであり、すでにアプリ間で調整されて
   "headers": {
     "Authorization": "Bearer ${keys.MCP_SERVER_TOKEN}"
   },
-  "description": "Shared MCP tools for workspace apps"
+  "description": "Shared MCP ツールs for workspace apps"
 }
 ```
 
@@ -285,7 +285,7 @@ AGENT_NATIVE_MCP_HUB_TOKEN=<the-same-secret>
 {
   "method": "GET",
   "path": "/_agent-native/mcp/status",
-  "summary": "MCP client status for tooling and onboarding",
+  "summary": "ツールとオンボーディングに関する MCP クライアントのステータス",
   "description": "Reports which configured servers connected, the total live tool count, the merged prefixed tool list, and any per-server connection errors. Use it to build \"detected — your agent can now drive X\" hints or to debug connection problems.",
   "responses": [
     {

package/docs/content/locales/ja-JP/mcp-protocol.md

@@ -92,11 +92,11 @@ POST https://your-app.example.com/_agent-native/mcp
 
 サーバーは、標準の MCP ハンドシェイク: `initialize` → `initialized` → `tools/list` → `tools/call` をサポートします。
 
-```an-api title="MCP endpoint" summary="The auto-mounted Streamable HTTP endpoint every agent-native app exposes."
+```an-api title="MCP エンドポイント" summary="すべてのエージェント ネイティブ アプリが公開する、自動マウントされる Streamable HTTP エンドポイント。"
 {
   "method": "POST",
   "path": "/_agent-native/mcp",
-  "summary": "MCP Streamable HTTP endpoint",
+  "summary": "MCP ストリーミング可能な HTTP エンドポイント",
   "description": "Auto-mounted on every app. Speaks the standard MCP handshake (`initialize` → `initialized` → `tools/list` → `tools/call`) plus `resources/list`, `resources/templates/list`, and `resources/read` when an action declares `mcpApp`. Each action maps to one tool; `ask-agent` delegates to the full agent loop.",
   "auth": "Standard remote MCP OAuth (Bearer access token), connect-minted JWT, or static ACCESS_TOKEN/ACCESS_TOKENS",
   "params": [
@@ -196,7 +196,7 @@ WWW-Authenticate: Bearer resource_metadata="https://dispatch.agent-native.com/.w
 
 ```an-diagram title="OAuth 検出フロー" summary="401 によって検出、登録、PKCE による承認→トークン交換が開始されます。 Bearer トークンは、対象者に限定され、スコープが設定されています。"
 {
-  "html": "<div class=\"diagram-oauth\"><div class=\"diagram-box\" data-rough>first request<br><small class=\"diagram-muted\">no token</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill warn\">401 · WWW-Authenticate</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel\"><span class=\"diagram-pill\">/.well-known/oauth-protected-resource</span><span class=\"diagram-pill\">/.well-known/oauth-authorization-server</span><small class=\"diagram-muted\">discover</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-pill\">register</div><div class=\"diagram-pill\">authorize (PKCE)</div><div class=\"diagram-pill\">token</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Bearer access token<br><small class=\"diagram-muted\">audience-bound · mcp:read / write / apps</small></div></div>",
+  "html": "<div class=\"diagram-oauth\"><div class=\"diagram-box\" data-rough>first request<br><small class=\"diagram-muted\">no token</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill warn\">401 · WWW-Authenticate</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel\"><span class=\"diagram-pill\">/.well-known/oauth-protected-resource</span><span class=\"diagram-pill\">/.well-known/oauth-authorization-server</span><small class=\"diagram-muted\">discover</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-pill\">register</div><div class=\"diagram-pill\">authorize (PKCE)</div><div class=\"diagram-pill\">token</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Bearer access token<br><small class=\"diagram-muted\">audienceバインド · mcp:read / write / apps</small></div></div>",
   "css": ".diagram-oauth{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-oauth .diagram-panel{display:flex;flex-direction:column;align-items:center;gap:4px}.diagram-oauth .diagram-col{display:flex;flex-direction:column;gap:6px}.diagram-oauth .diagram-arrow{font-size:20px;line-height:1}"
 }
 ```

package/docs/content/locales/ja-JP/messaging.md

@@ -18,9 +18,9 @@ description: "Slack、電子メール、テレグラム、または WhatsApp か
 - **同じエージェント、同じ記憶。** Slack で話した内容は、後で電子メールで送信したときに記憶されます。 Web チャットと外部メッセージは 1 つのスレッド履歴を共有します。
 - 一方向のアプリ内アラート (ベルのアイコン、webhooks) については、[Notifications](/docs/notifications) を参照してください。
 
-```an-diagram title="多くのチャネル、1 人のエージェント" summary="すべてのプラットフォームは同じエージェント ループと同じ SQL スレッド履歴にファンインするため、Slack DM と電子メールは同じ会話を継続します。"
+```an-diagram title="多くのチャネル、1 人のエージェント" summary="すべてのプラットフォームは同じエージェント ループと同じ SQL スレッド履歴にファンインするため、SlackのDM と電子メールは同じ会話を継続します。"
 {
-  "html": "<div class=\"msg-fanin\"><div class=\"diagram-col\"><div class=\"diagram-node\">Slack</div><div class=\"diagram-node\">Email</div><div class=\"diagram-node\">Telegram</div><div class=\"diagram-node\">WhatsApp</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">One agent loop</span><small class=\"diagram-muted\">same memory · same tools</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>One SQL thread history<br><small class=\"diagram-muted\">web chat + external messages share it</small></div></div>",
+  "html": "<div class=\"msg-fanin\"><div class=\"diagram-col\"><div class=\"diagram-node\">Slack</div><div class=\"diagram-node\">Email</div><div class=\"diagram-node\">Telegram</div><div class=\"diagram-node\">WhatsApp</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">1 つのエージェントループ</span><small class=\"diagram-muted\">同じメモリ · 同じツール</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>1 つの SQL スレッド履歴<br><small class=\"diagram-muted\">web chat + external messages share it</small></div></div>",
   "css": ".msg-fanin{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.msg-fanin .diagram-col{display:flex;flex-direction:column;gap:8px}.msg-fanin .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```
@@ -233,18 +233,18 @@ Slack アプリには 1 つのイベント API リクエスト URL がありま
 
 ```an-diagram title="インバウンド Webhook ライフサイクル" summary="Webhook は検証し、キューに入れ、200 を返すだけです。新しい関数を実行するとキューが空になり、セーフティ ネットとして 60 秒の再試行ジョブを使用してエージェント ループが実行されます。"
 {
-  "html": "<div class=\"msg-flow\"><div class=\"msg-row\"><div class=\"diagram-node\">Platform<br><small class=\"diagram-muted\">Slack · email · etc.</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough><strong>/webhook</strong><br><small class=\"diagram-muted\">verify signature + parse</small><br><span class=\"diagram-pill\">INSERT pending task</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill ok\">return 200</div></div><div class=\"msg-fire\"><span class=\"diagram-muted\">fire-and-forget</span> <span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</span></div><div class=\"msg-row\"><div class=\"diagram-box\" data-rough><strong>/process-task</strong><br><small class=\"diagram-muted\">fresh execution · own timeout</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill accent\">claim</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill accent\">agent loop</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill accent\">adapter.sendResponse</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill ok\">completed</div></div><div class=\"diagram-panel msg-retry\" data-rough><span class=\"diagram-pill warn\">every 60s</span> <span class=\"diagram-muted\">retry job sweeps stuck tasks (pending &gt;90s · processing &gt;5min) and re-fires /process-task &mdash; capped at 3 attempts, then <strong>failed</strong></span></div></div>",
+  "html": "<div class=\"msg-flow\"><div class=\"msg-row\"><div class=\"diagram-node\">Platform<br><small class=\"diagram-muted\">Slack · メール · など</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough><strong>/webhook</strong><br><small class=\"diagram-muted\">verify signature + parse</small><br><span class=\"diagram-pill\">INSERT 保留中タスク</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill ok\">return 200</div></div><div class=\"msg-fire\"><span class=\"diagram-muted\">fire-and-forget</span> <span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</span></div><div class=\"msg-row\"><div class=\"diagram-box\" data-rough><strong>/process-task</strong><br><small class=\"diagram-muted\">新規実行 · 独自タイムアウト</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill accent\">claim</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill accent\">agent loop</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill accent\">adapter.sendResponse</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill ok\">completed</div></div><div class=\"diagram-panel msg-retry\" data-rough><span class=\"diagram-pill warn\">every 60s</span> <span class=\"diagram-muted\">retry job sweeps stuck tasks (pending &gt;90s · processing &gt;5min) and re-fires /process-task &mdash; capped at 3 attempts, then <strong>failed</strong></span></div></div>",
   "css": ".msg-flow{display:flex;flex-direction:column;gap:12px}.msg-flow .msg-row{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.msg-flow .msg-fire{display:flex;align-items:center;gap:8px;padding-inline-start:12px}.msg-flow .msg-retry{display:flex;align-items:center;gap:8px;flex-wrap:wrap}"
 }
 ```
 
-インバウンドとアウトバウンドの会話は同じ SQL スレッド内で行われるため、ウェブ UI から Slack DM を継続したり、その逆も可能です。
+インバウンドとアウトバウンドの会話は同じ SQL スレッド内で行われるため、ウェブ UI から SlackのDM を継続したり、その逆も可能です。
 
 ```an-api
 {
   "method": "POST",
   "path": "/_agent-native/integrations/slack/webhook",
-  "summary": "Slack Events API inbound webhook",
+  "summary": "Slack イベント API インバウンド Webhook",
   "description": "Receives Slack events (DMs and channel `app_mention`s). Verifies the request signature, parses the payload into an `IncomingMessage`, inserts a `pending` row into `integration_pending_tasks`, fires the fresh-execution processor, and returns **200 immediately** — well inside Slack's 3-second SLA. The same route shape exists per platform under `/_agent-native/integrations/<platform>/webhook`.",
   "auth": "HMAC-SHA256 of the raw body using `SLACK_SIGNING_SECRET`, checked against the `X-Slack-Signature` header. In production also gated by `SLACK_ALLOWED_TEAM_IDS` / `SLACK_ALLOWED_API_APP_IDS`.",
   "params": [
@@ -322,7 +322,7 @@ POST /_agent-native/integrations/telegram/setup
 
 各外部会話は、エージェント ネイティブ データベース内の永続スレッドにマップされます。
 
-- **Slack DM** → Slack ユーザーごとに 1 つのスレッド。
+- **SlackのDM** → Slack ユーザーごとに 1 つのスレッド。
 - **Slack チャンネル @mention** → チャンネルごとに 1 つのスレッド。
 - **テレグラム チャット** → テレグラム チャットごとに 1 つのスレッド。
 - **WhatsApp での会話** → WhatsApp 番号ごとに 1 つのスレッド。

package/docs/content/locales/ja-JP/migration-workbench.md

@@ -11,7 +11,7 @@ description: "移行は、別個のアプリではなく、Agent-Native コー
 
 ```an-diagram title="/merge はコード セッションであり、別個のアプリではありません" summary="パス、URL、または説明が入ります。実行では、他のすべてのコード セッションと同じストア、トランスクリプト、およびコントロールを共有し、ポータブルなドシエを出力できます。"
 {
-  "html": "<div class=\"diagram-migrate\"><div class=\"diagram-col\"><div class=\"diagram-pill\">./local-app</div><div class=\"diagram-pill\">https://example.com</div><div class=\"diagram-pill\">--describe \\\"...\\\"</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">/migrate goal</span><small class=\"diagram-muted\">same store · transcript · run controls</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\" data-rough>Migrated app</div><div class=\"diagram-pill ok\">--emit dossier</div></div></div>",
+  "html": "<div class=\"diagram-migrate\"><div class=\"diagram-col\"><div class=\"diagram-pill\">./local-app</div><div class=\"diagram-pill\">https://example.com</div><div class=\"diagram-pill\">--describe \\\"...\\\"</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">/migrate goal</span><small class=\"diagram-muted\">同じストア · トランスクリプト · 実行制御</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\" data-rough>移行済みアプリ</div><div class=\"diagram-pill ok\">--emit dossier</div></div></div>",
   "css": ".diagram-migrate{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-migrate .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-migrate .diagram-arrow{font-size:22px;line-height:1}.diagram-migrate .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```

package/docs/content/locales/ja-JP/multi-app-workspace.md

@@ -66,7 +66,7 @@ CLI には、すべてのファーストパーティ テンプレートの複数
 
 ```bash
 cd my-company-platform
-cp .env.example .env             # fill in ANTHROPIC_API_KEY, BETTER_AUTH_SECRET, ...
+cp .env.example .env             # ANTHROPIC_API_KEY、BETTER_AUTH_SECRET、...を入力します。
 pnpm install
 pnpm dev                         # opens Dispatch; other apps start on first visit
 ```

package/docs/content/locales/ja-JP/multi-tenancy.md

@@ -21,7 +21,7 @@ CRM、プロジェクト トラッカー、サポート インボックス、ま
 
 ```an-diagram title="組織のメンバーシップと隔離" summary="ユーザーは owner/admin/member として組織に参加します。すべての所有可能な行には、それを所有するテナントの org_id が含まれており、境界を越えて行がリークすることはありません。"
 {
-  "html": "<div class=\"mt-grid\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Org A</span><small class=\"diagram-muted\">members: alice (owner), bob (member)</small><div class=\"diagram-box\">rows where org_id = A</div></div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Org B</span><small class=\"diagram-muted\">members: carol (owner)</small><div class=\"diagram-box\">rows where org_id = B</div></div></div><div class=\"mt-wall\" aria-hidden=\"true\"><span class=\"diagram-pill warn\">no cross-org reads</span></div>",
+  "html": "<div class=\"mt-grid\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">組織 A</span><small class=\"diagram-muted\">members: alice (owner), bob (member)</small><div class=\"diagram-box\">rows where org_id = A</div></div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">組織 B</span><small class=\"diagram-muted\">members: carol (owner)</small><div class=\"diagram-box\">rows where org_id = B</div></div></div><div class=\"mt-wall\" aria-hidden=\"true\"><span class=\"diagram-pill warn\">no cross-org reads</span></div>",
   "css": ".mt-grid{display:flex;gap:16px;flex-wrap:wrap}.mt-grid .diagram-card{display:flex;flex-direction:column;gap:8px;padding:14px 16px;flex:1;min-width:200px}.mt-wall{display:flex;justify-content:center;margin-top:12px}"
 }
 ```