@agent-native/core 0.93.0 → 0.94.0

package/corpus/core/docs/content/locales/hi-IN/tracking.mdx

@@ -127,6 +127,8 @@ import { defineAction } from "@agent-native/core/action";
 import { track } from "@agent-native/core/tracking";
 import { z } from "zod";
 
+import { getDb, schema } from "../server/db/index.js";
+
 export default defineAction({
   description: "Create a new project.",
   schema: z.object({
@@ -134,14 +136,15 @@ export default defineAction({
     template: z.string().optional(),
   }),
   run: async ({ name, template }, ctx) => {
-    const project = await db
-      .insert(projects)
+    const db = getDb();
+    const [project] = await db
+      .insert(schema.projects)
       .values({ name, template })
       .returning();
 
-    track("project.created", { name, template }, { userId: ctx.userEmail });
+    track("project.created", { name, template }, { userId: ctx?.userEmail });
 
-    return { ok: true, projectId: project[0].id };
+    return { ok: true, projectId: project.id };
   },
 });
 ```
@@ -349,5 +352,5 @@ interface TrackingEvent {
 ## आगे क्या है
 
 - [**Actions**](/docs/actions) - जहां अधिकांश ट्रैकिंग कॉल शुरू होती हैं
-- [**Server Plugins**](/docs/server) - `registerBuiltinProviders()` स्टार्टअप पर कोर-रूट्स प्लगइन में चलता है
-- [**Secrets**](/docs/security) - ट्रैकिंग प्रदाताओं के लिए API कुंजी प्रबंधित करें
+- [**Server Plugins**](/docs/server#server-plugins) - `registerBuiltinProviders()` स्टार्टअप पर कोर-रूट्स प्लगइन में चलता है
+- [**सुरक्षा — सीक्रेट प्रबंधन**](/docs/security#secrets) - ट्रैकिंग प्रदाताओं के लिए API कुंजी प्रबंधित करें

package/corpus/core/docs/content/locales/hi-IN/using-your-agent.mdx

@@ -92,21 +92,14 @@ description: "एजेंट के साथ काम करने का द
 
 एजेंट कोई अलग ऐप नहीं है जिस पर आप टैब करते हैं। यह मुट्ठी भर React घटकों - एक साइडबार, एक कच्चा पैनल और एक `sendToAgentChat()` कॉल - के रूप में शिप करता है जिसे आप किसी भी ऐप में डाल सकते हैं। प्रत्येक स्क्रीन को एक टॉगल करने योग्य एजेंट देने के लिए `<AgentSidebar>` रेंडर करें, या एक-शॉट LLM कॉल चलाने के बजाय चैट को एक विशिष्ट कार्य सौंपने के लिए एक बटन वायर करें।
 
-→ [**Drop-in Agent**](/docs/drop-in-agent) - `<AgentPanel>`, `<AgentSidebar>`, और `sendToAgentChat()` को किसी भी React ऐप में माउंट करें।
-→ [**Agent Surfaces**](/docs/agent-surfaces) - चुनें कि क्या वर्कफ़्लो हेडलेस, चैट-फर्स्ट, एम्बेडेड या पूर्ण ऐप होना चाहिए।
-
 ## आप UI-लाइट पर जा सकते हैं {#ui-light}
 
 हर ऐप को पूर्ण डैशबोर्ड की आवश्यकता नहीं होती है। जब एजेंट *उत्पाद*है, तो आप अधिकांश कस्टम UI को छोड़ सकते हैं: ऐप खोलें, जो आप चाहते हैं उसके लिए पूछें, और एजेंट को बाकी काम करने दें। एजेंट के पास अभी भी प्रबंधन सतह है - इतिहास, कार्यक्षेत्र, सेटिंग्स - लेकिन प्राथमिक इंटरैक्शन क्लिक के बजाय बातचीत है।
 
-→ [**Automation-First Apps**](/docs/pure-agent-apps) - jobs, queues, scripts और external agents के लिए no-browser apps।
-
 ## आप इसके साथ सह-संपादन करें {#you-co-edit}
 
 जब आप और एजेंट एक ही दस्तावेज़ पर काम कर रहे होते हैं, तो आप बारी-बारी से काम नहीं करते हैं। वास्तविक समय सहयोग के साथ, एजेंट के संपादन आपके साथ स्ट्रीम होते हैं - लाइव कर्सर, कोई ओवरराइट नहीं - उसी तरह जैसे एक टीम के साथी का होता है। जब तक यह काम करता है तब तक आप टाइप करना जारी रख सकते हैं और यह आपके बदलावों को वैसे ही देखता है जैसे वे होते हैं।
 
-→ [**Real-Time Collaboration**](/docs/real-time-collaboration) - एक ही दस्तावेज़ में लाइव कर्सर और एजेंट संपादन के साथ बहु-उपयोगकर्ता सहयोगात्मक संपादन।
-
 ## आगे क्या है {#whats-next}
 
 - [**Context Awareness**](/docs/context-awareness) - एजेंट जानता है कि आप क्या देख रहे हैं

package/corpus/core/docs/content/locales/hi-IN/voice-input.mdx

@@ -9,6 +9,12 @@ description: "एजेंट चैट कंपोजर में वॉय
 
 फ्रेमवर्क यह सब स्वचालित रूप से संभालता है। Builder-कनेक्टेड उपयोगकर्ताओं को डिफ़ॉल्ट रूप से Builder-होस्टेड जेमिनी फ्लैश-लाइट मिलता है; अन्यथा उपयोगकर्ता अपनी स्वयं की प्रदाता कुंजी ला सकते हैं या ब्राउज़र वाक् पहचान पर वापस आ सकते हैं।
 
+## रीयलटाइम स्पीच मोड {#realtime-speech-mode}
+
+माइक्रोफ़ोन खोलने पर एक पॉपओवर आपको **रीयलटाइम बातचीत** और **संपादन योग्य डिक्टेशन** में से चुनने देता है। रीयलटाइम मोड के लिए उपयोगकर्ता के दायरे वाली `OPENAI_API_KEY` चाहिए और यह WebRTC के ज़रिए ब्राउज़र को `gpt-realtime-2.1` से जोड़ता है। चैट नीचे दाईं ओर एक वॉइस ऑर्ब में सिमट जाती है; बातचीत समाप्त किए बिना चैट दिखाने या छिपाने के लिए ऑर्ब पर क्लिक करें।
+
+स्पीच मॉडल चैट वाले उन्हीं प्रमाणीकृत Agent Native टूल का उपयोग करता है, इसलिए वह बोलते समय ऐप में नेविगेट कर सकता है और कार्रवाइयाँ चला सकता है। जिन कार्रवाइयों के लिए स्वीकृति चाहिए, वे आपकी स्वीकृति मिलने तक रुकी रहती हैं। ऑडियो कभी भी SQL में संग्रहीत नहीं होता; Agent Native केवल सत्र और ट्रांसक्रिप्ट की संक्षिप्त स्थिति रखता है। एक रीयलटाइम सत्र अधिकतम 60 मिनट तक चलता है।
+
 ## यह कैसे काम करता है {#how-it-works}
 
 संगीतकार का आवाज बटन ब्राउज़र में ऑडियो रिकॉर्ड करता है, फिर एक प्रदाता चुनता है:

package/corpus/core/docs/content/locales/hi-IN/workspace-connections.mdx

@@ -425,10 +425,9 @@ const brainCatalog = await listWorkspaceConnectionProviderCatalogForApp({
 
 ### डिस्पैच कंट्रोल-प्लेन सेटअप
 
-डिस्पैच नियंत्रण-प्लेन actions को उजागर करता है जो समान साझा स्टोर फ़ंक्शन लिखता है जिसे एक ऐप सीधे कॉल कर सकता है:
+Dispatch ऐसे control-plane actions उपलब्ध कराता है जो उन्हीं shared store functions का उपयोग करते हैं जिन्हें कोई ऐप सीधे कॉल कर सकता है — इसका `upsert-workspace-connection` action provider catalog के विरुद्ध input को validate करता है, फिर इसी पृष्ठ पर दिखाए गए `upsertWorkspaceConnection()` को delegate करता है:
 
 ```ts
-// templates/dispatch/actions/upsert-workspace-connection.ts delegates to this.
 await upsertWorkspaceConnection({
   id: "team-slack",
   provider: "slack",
@@ -493,3 +492,11 @@ await upsertWorkspaceConnectionGrant({
 सीमा को सख्त रखें: प्रदाता मेटाडेटा दिखाना सुरक्षित है; क्रेडेंशियल मान तिजोरी में रहते हैं।
 
 </details>
+
+## आगे क्या है {#whats-next}
+
+- [**Dispatch**](/docs/dispatch) — वह ऐप जो आम तौर पर workspace connection setup और vault का स्वामी होता है
+- [**सुरक्षा**](/docs/security) — credential vault, secret scoping और access model जिनकी ओर connections संकेत करते हैं
+- [**Onboarding**](/docs/onboarding#checking-workspace-connections-in-onboarding) — template setup checklist से connection readiness जाँचना
+- [**MCP Clients**](/docs/mcp-clients) — workspace में MCP server credentials साझा करने का संबंधित reusable-config pattern
+- [**Brain**](/docs/template-brain) — इस model पर आधारित provider Sources page का reference implementation

package/corpus/core/docs/content/locales/hi-IN/workspace.mdx

@@ -5,7 +5,11 @@ description: "प्रति उपयोगकर्ता Claude-कोड-
 
 # कार्यस्थान
 
-> **कौन सा कार्यक्षेत्र दस्तावेज़?** यह पृष्ठ **अनुकूलन परत** को कवर करता है - कार्यक्षेत्र *क्या*है। परिनियोजन आकार (एक मोनोरेपो, कई ऐप्स) के लिए [Multi-App Workspaces](/docs/multi-app-workspace) देखें; शासन के लिए (कौन समीक्षा करता है, अनुमोदन करता है और उसका मालिक है) [Workspace Governance](/docs/workspace-management) देखें।
+<Callout tone="info">
+
+**कौन सा कार्यक्षेत्र दस्तावेज़?** यह पृष्ठ **अनुकूलन परत** को कवर करता है - कार्यक्षेत्र *क्या*है। परिनियोजन आकार (एक मोनोरेपो, कई ऐप्स) के लिए [Multi-App Workspaces](/docs/multi-app-workspace) देखें; शासन के लिए (कौन समीक्षा करता है, अनुमोदन करता है और उसका मालिक है) [Workspace Governance](/docs/workspace-management) देखें।
+
+</Callout>
 
 प्रत्येक एजेंट-नेटिव ऐप एक **कार्यस्थान** के साथ आता है: अनुकूलन परत जो एजेंट को आपका बनाती है। इसमें टीम निर्देश (`AGENTS.md`), साझा सीख (`LEARNINGS.md`), व्यक्तिगत संरचित मेमोरी (`memory/MEMORY.md`), skills एजेंट मांग पर खींचता है, कस्टम उप-एजेंट, शेड्यूल किए गए कार्य और कनेक्टेड MCP सर्वर शामिल हैं - वह सब कुछ जो आप Claude कोड / Codex सेटअप से उम्मीद करते हैं।
 
@@ -82,7 +86,7 @@ description: "प्रति उपयोगकर्ता Claude-कोड-
 | प्रति-प्रोजेक्ट `CLAUDE.md` / skills  | प्रति-ऐप `AGENTS.md` + कार्यस्थान मेमोरी संसाधन        |
 | JSON फ़ाइल में MCP कॉन्फिगरेशन        | JSON में MCP कॉन्फिगरेशन _या_ सेटिंग्स UI, प्रति स्कोप |
 
-समान क्षमताएं। अलग अर्थशास्त्र. SaaS के लिए यह क्यों मायने रखता है, इसके लिए [Templates](/docs/cloneable-saas) देखें।
+समान क्षमताएं। अलग अर्थशास्त्र. SaaS के लिए यह क्यों मायने रखता है, इसके लिए [ऐप्स](/docs/cloneable-saas) देखें।
 
 ## अवलोकन {#overview}
 
@@ -219,11 +223,9 @@ workspace context/brand.md
 -> personal context/brand.md
 ```
 
-`context/` फ़ाइलों को संक्षिप्त और तथ्यात्मक रखें - एजेंट कुछ हद तक बच सकता है:
-
-```text
-<!-- context/brand.md -->
+उदाहरण के लिए:
 
+```text filename="context/brand.md"
 # ब्रांड
 
 - Voice: direct, warm, concrete
@@ -388,15 +390,9 @@ Skills, `skills/` पथ (अधिमानतः `skills/<name>/SKILL.md`) क
 
 एक ऐप के भीतर प्रतिनिधिमंडल के लिए कस्टम एजेंटों का उपयोग करें। जब आपको A2A पर किसी अन्य ऐप को कॉल करने की आवश्यकता हो तो कनेक्टेड एजेंटों का उपयोग करें।
 
-## @टैगिंग {#at-tagging}
-
-कार्यस्थान आइटम को संदर्भित करने के लिए चैट इनपुट में `@` टाइप करें। कर्सर पर एक ड्रॉपडाउन दिखाई देता है जिसमें मेल खाते एजेंट और फ़ाइलें दिखाई देती हैं। नेविगेट करने के लिए तीर कुंजियों का उपयोग करें और चयन करने के लिए Enter कुंजी का उपयोग करें। चयनित आइटम इनपुट में इनलाइन चिप के रूप में दिखाई देता है।
-
-जब आप कोई संदेश भेजते हैं, तो **फ़ाइलें/संसाधन** को संदर्भ के रूप में पारित किया जाता है जिसे एजेंट पढ़ सकता है, **कस्टम एजेंट** अपने प्रोफ़ाइल निर्देशों के साथ स्थानीय रूप से चलते हैं, और **कनेक्टेड एजेंट** को A2A पर कॉल किया जाता है।
+## @ टैगिंग और / स्लैश कमांड {#at-tagging}
 
-## / स्लैश कमांड {#slash-commands}
-
-किसी कौशल को शुरू करने के लिए पंक्ति की शुरुआत में `/` टाइप करें। एक ड्रॉपडाउन उनके नाम और विवरण के साथ उपलब्ध skills दिखाता है; किसी एक का चयन करने से एक इनलाइन चिप जुड़ जाती है और संदेश भेजे जाने पर इसकी सामग्री संदर्भ के रूप में शामिल हो जाती है। यदि कोई skills कॉन्फ़िगर नहीं किया गया है, तो ड्रॉपडाउन इन दस्तावेज़ों से लिंक करता है।
+किसी एजेंट, फ़ाइल या संसाधन का संदर्भ देने के लिए चैट इनपुट में `@` टाइप करें, या skill चलाने के लिए `/` टाइप करें — दोनों कर्सर पर ड्रॉपडाउन खोलते हैं और आइटम चुनने पर इनलाइन चिप जोड़ते हैं। पूरी प्रक्रिया (रूटिंग, `MentionProvider`, उप-एजेंट चयन) के लिए [एजेंट उल्लेख](/docs/agent-mentions) और skills कैसे लिखे व खोजे जाते हैं, इसके लिए [Skills गाइड](/docs/skills-guide) देखें।
 
 ## कोड बनाम ऐप मोड {#dev-vs-prod}
 
@@ -416,10 +412,6 @@ Skills, `skills/` पथ (अधिमानतः `skills/<name>/SKILL.md`) क
 
 त्वरित प्रारंभ, कनेक्शन/अनुदान/क्रेडेंशियलRef API, और ठोस Slack, HubSpot, और GitHub उदाहरणों के लिए [Workspace Connections](/docs/workspace-connections) देखें।
 
----
-
-# संदर्भ
-
 ## संसाधन API {#resource-api}
 
 संसाधनों को सर्वर कोड, actions, या REST API से प्रबंधित किया जा सकता है।
@@ -463,3 +455,12 @@ pnpm action resource-write --path "notes/meeting.md" --content "# मीटि
 # एक संसाधन हटाएं
 pnpm action resource-delete --path "notes/old.md"
 ```
+
+## आगे क्या है {#whats-next}
+
+- [**Skills गाइड**](/docs/skills-guide) — `skills/` से संदर्भित skill फ़ाइलें लिखें और उनका दायरा तय करें
+- [**एजेंट उल्लेख**](/docs/agent-mentions) — `@` उल्लेख और `/` कमांड की पूरी प्रक्रिया
+- [**आवर्ती जॉब**](/docs/recurring-jobs) — Scheduled Tasks से बनाए गए प्रॉम्प्ट शेड्यूल करें
+- [**Workspace गवर्नेंस**](/docs/workspace-management) — workspace परिवर्तनों की समीक्षा, स्वीकृति और स्वामित्व किसके पास है
+- [**मल्टी-ऐप Workspace**](/docs/multi-app-workspace) — वह परिनियोजन आकार जिसमें एक workspace फैला होता है
+- [**Workspace कनेक्शन**](/docs/workspace-connections) — ऐप्स के बीच प्रदाता क्रेडेंशियल साझा करें

package/corpus/core/docs/content/locales/ja-JP/actions.mdx

@@ -11,7 +11,7 @@ Actions は、アプリの動作に関する唯一の信頼できる情報源で
 - **タイプセーフ React フック** — フロントエンドの `useActionQuery("name")` および `useActionMutation("name")`、タイプはスキーマから推論されます。
 - **命令型クライアント呼び出し** — フックが適合しない場合の `callAction("name", params)`。
 - **フレームワーク トランスポート** — これらのフックの背後にあるフレームワークによって自動マウントされ、外部 HTTP クライアントが利用できます。
-- **MCP ツール** — Claude、ChatGPT カスタム MCP アプリ、Claude デスクトップ/コード、カーソル、Codex、およびその他の MCP クライアントに公開されます。
+- **MCP ツール** — Claude、ChatGPT カスタム MCP アプリ、Claude デスクトップ/コード、カーソル、Codex、およびその他の MCP ホストに公開されます。
 - **A2A ツール** — A2A 経由で他のエージェント ネイティブ アプリによって呼び出されます。
 - **A CLI コマンド** — スクリプト作成および開発ループ用の `pnpm action <name>`。
 
@@ -562,7 +562,7 @@ export default defineAction({
 });
 ```
 
-`link` を CLI および非 UI MCP クライアントのフォールバックとして保持します。これは、埋め込みの起動ターゲットでもあります。埋め込みブリッジ (署名付き埋め込み開始セッション、移植対制御フレーム レンダリング、`ui/*` ホスト ブリッジ、CSP、および高さクランプ) は、[External Agents](/docs/external-agents#mcp-app-bridge) によって所有されています。
+`link` を CLI および非 UI MCP ホストのフォールバックとして保持します。これは、埋め込みの起動ターゲットでもあります。埋め込みブリッジ (署名付き埋め込み開始セッション、移植対制御フレーム レンダリング、`ui/*` ホスト ブリッジ、CSP、および高さクランプ) は、[External Agents](/docs/external-agents#mcp-app-bridge) によって所有されています。
 
 ## 標準 actions {#standard-actions}
 

package/corpus/core/docs/content/locales/ja-JP/agent-native-toolkit.mdx

@@ -97,9 +97,9 @@ coherent kit instead of exposing package boundaries in the app.
 
 - [UI Primitives](/docs/toolkit-ui) cover shared shadcn-style primitives under
   `@agent-native/toolkit/ui/*`.
-- [App Adapters](/docs/toolkit-app-adapters) show how apps wrap Toolkit pieces
+- [App Adapters](/docs/toolkit-ui#app-adapters) show how apps wrap Toolkit pieces
   through local `@/components/*` adapters.
-- [Shell & Hooks](/docs/toolkit-shell-hooks) cover header actions, mobile hooks,
+- [Shell & Hooks](/docs/toolkit-ui#shell-hooks) cover header actions, mobile hooks,
   toasts, and small app-shell helpers.
 - [Component API](/docs/components) remains the lower-level reference for the
   public React exports.

package/corpus/core/docs/content/locales/ja-JP/agent-surfaces.mdx

@@ -141,8 +141,7 @@ pnpm install
 
 次に、永続的な操作を定義します。
 
-```ts
-// actions/summarize-week.ts
+```ts filename="actions/summarize-week.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -496,12 +495,11 @@ actions の周囲、またはドメイン [template](/docs/cloneable-saas) か
 チャットにリッチな UI が必要な場合はウィジェットの結果が表示され、ユーザーがいる場合にのみ全画面が追加されます
 永続オブジェクトを参照、比較、構成、または共同作業する必要があります。
 
-## 関連ドキュメント {#related-docs}
+## 次のステップ {#related-docs}
 
-- [Actions](/docs/actions) — ヘッドレス操作を 1 回定義します。
-- [Native チャット UI](/docs/native-chat-ui) — 入力されたアクションの結果をチャットにレンダリングします。
-- [Drop-in Agent](/docs/drop-in-agent) — チャット、サイドバー、またはパネルの表面をマウントします。
-- [Component API](/docs/components) — 下位レベルの React チャット/作曲家作品。
-- [Embedding SDK](/docs/embedding-sdk) — Agent-Native を既存のアプリに追加します。
-- [External Agents](/docs/external-agents) — MCP 互換ホストをアプリに接続します。
-- [A2A Protocol](/docs/a2a-protocol) — 他のエージェントからエージェントに電話をかけます。
+- [**Actions**](/docs/actions) — 操作を一度定義します。上記のすべてのサーフェスが同じ操作を呼び出します
+- [**Native チャット UI**](/docs/native-chat-ui) — 型付き action 結果を表、グラフ、カードとしてチャットに表示します
+- [**Generative UI**](/docs/generative-ui) — 一時的または永続化されたサンドボックス UI をチャット内に生成します
+- [**Automation-First Apps**](/docs/pure-agent-apps) — ジョブ、キュー、スクリプト、外部エージェント向けの完全なブラウザー不要パターン
+- [**External Agents**](/docs/external-agents) — MCP 互換ホストをアプリに接続します
+- [**A2A Protocol**](/docs/a2a-protocol) — 他の Agent-Native アプリからエージェントを呼び出します

package/corpus/core/docs/content/locales/ja-JP/agent-teams.mdx

@@ -239,6 +239,7 @@ interface AgentTask {
   summary: string; // full summary once completed
   currentStep: string; // latest step label (updated while running)
   createdAt: number;
+  delegationDepth?: number; // 1 for a direct sub-agent, 2 for a sub-agent of that sub-agent, etc.
   // Additional fields: parentThreadId, name, updatedAt, startedAt,
   // completedAt, runId, error
 }

package/corpus/core/docs/content/locales/ja-JP/authentication.mdx

@@ -15,7 +15,7 @@ description: "電子メール/パスワード、ソーシャル プロバイダ
 - **リモート MCP OAuth:** Claude コードや ChatGPT コネクタなどの MCP ホスト用の標準 OAuth 2.1。
 - **カスタム:** `getSession` コールバック経由で独自の認証を取得します。
 
-<Diagram id="doc-block-76smlp" title={"1 回のセッションで 3 つの方法で"} summary={"ブラウザーの訪問者、プログラムによる MCP クライアント、およびカスタム プロバイダーはすべて、ダウンストリーム スコーピングが読み取る同じ AuthSession に解決されます。"}>
+<Diagram id="doc-block-76smlp" title={"1 回のセッションで 3 つの方法で"} summary={"ブラウザーの訪問者、MCP ホスト、およびカスタム プロバイダーはすべて、ダウンストリーム スコーピングが読み取る同じ AuthSession に解決されます。"}>
 
 ```html
 <div class="auth-modes">

package/corpus/core/docs/content/locales/ja-JP/components.mdx

@@ -474,10 +474,12 @@ UI とエージェントが同じ機能を共有するようにアクション
 ```ts
 import { defineAction } from "@agent-native/core/action";
 import { completeText } from "@agent-native/core/server";
+import { z } from "zod";
 
 export default defineAction({
   description: "Classify a short message",
-  run: async ({ body }: { body: string }) => {
+  schema: z.object({ body: z.string() }),
+  run: async ({ body }) => {
     const result = await completeText({
       systemPrompt: "Return exactly one label.",
       input: body,
@@ -492,3 +494,11 @@ export default defineAction({
 次の場合は代わりに `sendToAgentChat({ background: true, openSidebar: false })` を使用してください
 作業にはツール、状態、監査可能性、ユーザー操作、または複数のステップが必要です
 推論。
+
+## 次のステップ {#whats-next}
+
+- [**Drop-in Agent**](/docs/drop-in-agent) — チュートリアル中心のガイドで `<AgentSidebar>` と `<AgentPanel>` をマウントする
+- [**Native Chat UI**](/docs/native-chat-ui) — データウィジェットとカスタムレンダラーを支えるアクション結果コントラクト
+- [**Actions**](/docs/actions) — `defineAction()`、スキーマ、およびこれらのコンポーネントが呼び出すアクションサーフェス
+- [**Real-Time Collaboration**](/docs/real-time-collaboration) — コラボレーションフックとプレゼンスコンポーネントの詳細
+- [**Sharing**](/docs/sharing) — 所有可能なリソース向けの `<ShareButton>` と `<ShareDialog>` の配線

package/corpus/core/docs/content/locales/ja-JP/creating-templates.mdx

@@ -44,7 +44,6 @@ npx @agent-native/core@latest create my-platform
 <FileTree
   id="doc-block-a0ipml"
   title={"テンプレートプロジェクトの構成"}
-  title="my-template/"
   entries={[
     {
       path: "app/",
@@ -172,8 +171,7 @@ npx @agent-native/core@latest create my-platform
 
 フレームワーク Drizzle ヘルパーを使用してドメイン テーブルを定義し、SQLite、Postgres、D1、Turso、Supabase、Neon、およびその他のサポートされているバックエンド間でスキーマの移植性を維持します。
 
-```ts
-// server/db/schema.ts
+```ts filename="server/db/schema.ts"
 import {
   table,
   text,
@@ -204,8 +202,7 @@ export const projectShares = createSharesTable("project_shares");
 
 アプリの読み取りと書き込みには、Drizzle のクエリ ビルダーと `drizzle-orm` のポータブル オペレーターを使用します。 Drizzle でクエリを表現できる場合は、生の SQL を使用して製品コードを記述しないでください。また、テンプレートで `drizzle-orm/sqlite-core` または `drizzle-orm/pg-core` からインポートしないでください。
 
-```ts
-// server/plugins/db.ts
+```ts filename="server/plugins/db.ts"
 import { runMigrations } from "@agent-native/core/db";
 
 export default runMigrations(
@@ -349,8 +346,7 @@ URL クエリ パラメータで共有可能なフィルターを保持します
 `path` (URL が既知の場合)。同じ動きに対して `__set_url__` も書き込まないでください。
 そのキーは、フレームワーク URL ツールおよび URL のみのフィルター変更用に予約されています。
 
-```ts
-// actions/navigate.ts
+```ts filename="actions/navigate.ts"
 import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { z } from "zod";

package/corpus/core/docs/content/locales/ja-JP/cross-app-sso.mdx

@@ -9,7 +9,11 @@ description: "Dispatch を ID 権限とする ID フェデレーションを介
 
 これは、[A2A](/docs/a2a-protocol) と [External Agents](/docs/external-agents) がすでに使用しているものと同じ信頼プリミティブです。リクエスト境界で検証された `A2A_SECRET` 署名付き JWT が、エージェント間の呼び出しではなく人間のサインイン パスに適用されます。
 
-> **統合デプロイとドメインごとのデプロイ。** すべてのアプリを 1 つのオリジン (`your-agents.com/mail`、`your-agents.com/calendar`) でホストする場合、すでに単一の Cookie ドメイン経由で共有ログインが得られます。フェデレーションは必要ありません。クロスアプリ SSO は、アプリが別のドメインで実行される場合にのみ必要です。 [Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment) を参照してください。
+<Callout tone="info">
+
+**統合デプロイとドメインごとのデプロイ。** すべてのアプリを 1 つのオリジン (`your-agents.com/mail`、`your-agents.com/calendar`) でホストする場合、すでに単一の Cookie ドメイン経由で共有ログインが得られます。フェデレーションは必要ありません。クロスアプリ SSO は、アプリが別のドメインで実行される場合にのみ必要です。 [Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment) を参照してください。
+
+</Callout>
 
 ## 内容と理由 {#what-why}
 
@@ -86,15 +90,17 @@ description: "Dispatch を ID 権限とする ID フェデレーションを介
 
 </Diagram>
 
-1. **アプリ → ディスパッチ (承認)。** アプリはユーザーを ID 認証局に送信します。
+1. **アプリ → Dispatch（認可）。** アプリ側の `GET /_agent-native/identity/login` ルート（「Agent-Native でサインイン」ボタンのリンク先）がリダイレクトを構築し、ユーザーを ID 機関に送ります。
 
-   ```
+   ```http
    GET https://dispatch.agent-native.com/_agent-native/identity/authorize
        ?app=<requesting-app>
        &redirect_uri=<app-callback-url>
        &state=<csrf-state>
    ```
 
+   `redirect_uri` は、このアプリ自身の `GET /_agent-native/identity/callback` ルートです。このルートがステップ 3 で署名済みトークンを受け取ります。
+
 <Endpoint id="cross-app-sso-identity-authorize-ja-jp" title={"ID 承認エンドポイント"} method="GET" path="/_agent-native/identity/authorize" summary={"ディスパッチ (ID 機関) が人間を認証し、署名された ID トークンでリダイレクトします"} auth={"セッションをディスパッチします (ない場合は対話型ログイン)"} params={[
   {
     "name": "app",
@@ -143,7 +149,7 @@ description: "Dispatch を ID 権限とする ID フェデレーションを介
    | `scope`      | 常に `"identity"` — このトークンはサインインのみを承認します |
    | `exp`        | **≤ 2 分** 発行から                                          |
 
-4. **アプリは電子メールで検証し、JIT リンクします。** アプリは独自の `A2A_SECRET` でトークンの署名を検証し、`scope: "identity"` と `exp` をチェックして、**検証された電子メールによって厳密にジャストインタイム リンク**を実行します。
+4. **アプリはメールで検証し、JIT リンクします。** アプリの `GET /_agent-native/identity/callback` ルートは、独自の `A2A_SECRET` でトークン署名を検証し、`scope: "identity"` と `exp` を確認してから、**検証済みメールのみに基づくジャストインタイム リンク**を実行します。
    - その電子メールを持つローカル ユーザーが存在する場合 → それを変更せずに再利用します。
    - そうでない場合は、そのメールのローカル ユーザーを作成します。
 
@@ -290,9 +296,13 @@ AGENT_NATIVE_IDENTITY_HUB_URL=https://dispatch.agent-native.com
 **5.ロールバック = そのアプリのデプロイで環境変数の設定を解除します。**
 アプリを元に戻すには、**そのアプリの環境から `AGENT_NATIVE_IDENTITY_HUB_URL` を削除し、再デプロイ/再起動します。** アプリはすぐに以前の認証動作に戻ります。 **元に戻すデータ変更はありません**。ID 行は追加されただけであり、変数の設定を解除するとフェデレーション パスが再び休止状態になるだけです。各アプリのカットオーバーとロールバックは独立しており、元に戻すことができます。
 
-> ロールアウトは、各アプリが有効になるとユーザーをログアウトします (ユーザーは Dispatch 経由で再認証します)。ただし、ID 行は破棄されたり名前が変更されたりすることはなく、追加されるだけであるため、**データがそのままの状態で同じ電子メールが一致したアカウント**に常にログインし直します。
+<Callout tone="info">
+
+ロールアウトは、各アプリが有効になるとユーザーをログアウトします (ユーザーは Dispatch 経由で再認証します)。ただし、ID 行は破棄されたり名前が変更されたりすることはなく、追加されるだけであるため、**データがそのままの状態で同じ電子メールが一致したアカウント**に常にログインし直します。
+
+</Callout>
 
-## 関連 {#related}
+## 次のステップ {#whats-next}
 
 - [Authentication](/docs/authentication) — ローカル認証モード、セッション、組織、`A2A_SECRET` 環境変数
 - [A2A Protocol](/docs/a2a-protocol) — これが再利用する署名付き JWT、境界検証信頼モデル。

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

@@ -452,3 +452,11 @@ export default createAgentChatPlugin({
 ## マルチインスタンスの展開 {#multi-instance}
 
 エージェント ネイティブ アプリは、Drizzle 経由ですべての状態を SQL に保存し、[polling](/docs/key-concepts#polling-sync) 経由で UI をデータベースと同期します。ファイル システムの状態、スティッキー セッション、メモリ内キャッシュはありません。つまり、マルチインスタンスおよびサーバーレスのデプロイメントはすぐに機能し、すべてのインスタンスを同じ `DATABASE_URL` にポイントすると、それらは自動的に収束します。 [Key Concepts — Data in SQL](/docs/key-concepts#data-in-sql) および [Portability](/docs/key-concepts#hosting-agnostic) を参照してください。
+
+## 次のステップ
+
+- [**Database**](/docs/database#production) — 最初の本番デプロイ前に永続 SQL バックエンドを選択します
+- [**Security**](/docs/security) — このページで参照されている本番チェックリストとオプトイン フラグ
+- [**Authentication**](/docs/authentication) — 選択した認証モードの OAuth 資格情報と環境変数
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — `deploy` の単一オリジン ビルドを支えるワークスペース モデル
+- [**Frames**](/docs/frames) — 本番 UI 編集における埋め込みエージェント パネルと Builder.io クラウド フレームの違い

package/corpus/core/docs/content/locales/ja-JP/external-agents.mdx

@@ -136,13 +136,8 @@ OAuth トークン。 ChatGPT は、レビューまたは公開されたコネ
 ツールまたは MCP アプリのメタデータが変更されます。古いアプリごとのコネクタがまだある場合
 各古いコネクタのディスパッチ、リフレッシュ、または再接続とともに有効になります。更新中
 Dispatch は、ChatGPT または Claude のキャッシュされたカレンダー/メールなどを書き換えません。
-スナップショット。スコープは次のとおりです:
-
-| スコープ    | それによって何が可能になるか                                         |
-| ----------- | -------------------------------------------------------------------- |
-| `mcp:read`  | 読み取り専用ツールとツール/リソースの検出                            |
-| `mcp:write` | ドラフト、更新、その他の変更中の actions                             |
-| `mcp:apps`  | インライン MCP アプリ、チャート、ダッシュボード、ドラフト、および UI |
+スナップショット。`mcp:read` / `mcp:write` / `mcp:apps` スコープは、以下の
+[標準リモート MCP OAuth](#standard-oauth) で説明するものと同じです。
 
 Cursor、Goose、Postman、MCPJam、VS Code GitHub Copilot は同じリモートを使用します
 ビルドがリモート OAuth をサポートしている場合、独自の MCP サーバー UI を介した MCP URL

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

@@ -11,11 +11,9 @@ description: "エージェント ネイティブ アプリの仕組み: 最初
 
 すべてのエージェント ネイティブ アプリは、次の 3 つの要素が連携して機能します。
 
-> **エージェント** — データの読み取り、書き込み、actions の実行、およびコードの変更を行う自律型 AI。 skills と説明書でカスタマイズ可能。
->
-> **アプリケーション** — エージェントの周囲の製品表面。これは、最初はアクションのみ、リッチ チャット、小さなコントロール プレーン、またはダッシュボード、フロー、ビジュアライゼーションを備えた完全な React UI画面 である可能性があります。
->
-> **コンピュータ** — データベース、ブラウザ、コード実行。エージェントは SQL および組み込みツールと直接連携します。 MCP サーバーはオプションのアドオンであり、基盤ではありません。
+- **エージェント** — データの読み取り、書き込み、actions の実行、およびコードの変更を行う自律型 AI。 skills と説明書でカスタマイズ可能。
+- **アプリケーション** — エージェントの周囲の製品表面。これは、最初はアクションのみ、リッチ チャット、小さなコントロール プレーン、またはダッシュボード、フロー、ビジュアライゼーションを備えた完全な React UI画面 である可能性があります。
+- **コンピュータ** — データベース、ブラウザ、コード実行。エージェントは SQL および組み込みツールと直接連携します。 MCP サーバーはオプションのアドオンであり、基盤ではありません。
 
 <Diagram id="doc-block-1ngou9i" title={"エージェント、アプリケーション、およびコンピュータ"} summary={"3 つのレイヤーが 1 つの共有 SQL ストア上で連携します。エージェントとアプリケーションは両方とも同じデータの読み取りと書き込みを行います。"}>
 
@@ -279,8 +277,7 @@ LLM をインラインで呼び出してみませんか?
 
 エージェントが何か複雑なこと (API の呼び出し、データの処理、データベースのクエリなど) を実行する必要がある場合、**アクション** を実行します。 Actions は、デフォルトの `defineAction()` をエクスポートする `actions/` 内の TypeScript ファイルです:
 
-```ts
-// actions/fetch-data.ts
+```ts filename="actions/fetch-data.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -382,9 +379,8 @@ _frame_ は、アプリの隣にエージェントをホストする環境です
 
 エージェント ネイティブ アプリには、アプリ UI とともに AI エージェントを提供する埋め込みエージェント パネルが含まれています。これがアーキテクチャを機能させるものです。エージェントにはコンピュータ (データベース、ブラウザ、コード実行) が必要であり、アプリには AI の作業のためにエージェントが必要です。
 
-> **埋め込みエージェント パネル** — チャットとオプションの CLI ターミナルがすべてのアプリに組み込まれています。 Claude コード、Codex、Gemini、OpenCode、および Builder.io をサポートします。ローカルで実行されます。無料のオープンソース。
->
-> **クラウド** — リアルタイムのコラボレーション、ビジュアル編集、ロール、権限を備えた任意のクラウドに展開します。チームに最適です。
+- **埋め込みエージェント パネル** — チャットとオプションの CLI ターミナルがすべてのアプリに組み込まれています。 Claude コード、Codex、Gemini、OpenCode、および Builder.io をサポートします。ローカルで実行されます。無料のオープンソース。
+- **クラウド** — リアルタイムのコラボレーション、ビジュアル編集、ロール、権限を備えた任意のクラウドに展開します。チームに最適です。
 
 ## コンテキスト認識 {#context-awareness}
 
@@ -456,14 +452,11 @@ UI はルート変更時にこれを書き込みます。エージェントは
 
 これは、自分で接着する必要がある「その他すべて」です。
 
-## ディープダイブ {#deep-dives}
-
-特定のパターンに関する詳細なガイダンスについては:
+## 次のステップ {#deep-dives}
 
-- [What Is Agent-Native?](/docs/what-is-agent-native) — ビジョンと哲学
-- [Context Awareness](/docs/context-awareness) — ナビゲーション状態、ビュー画面、ナビゲーション コマンド
-- [Skills Guide](/docs/skills-guide) — フレームワーク skills、ドメイン skills、カスタム skills の作成
-- [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 つのモノリポジトリで多くのアプリをホストします
+- [**What Is Agent-Native?**](/docs/what-is-agent-native) — これらのルールを支えるビジョンと理念
+- [**Context Awareness**](/docs/context-awareness) — ナビゲーション状態、view-screen、navigate コマンドの詳細
+- [**Skills Guide**](/docs/skills-guide) — フレームワーク skills、ドメイン skills、カスタム skills の作成
+- [**Native Chat UI**](/docs/native-chat-ui) — action で宣言する表とグラフ、および独自ランタイムへの対応
+- [**Agent Surfaces**](/docs/agent-surfaces) — チャット、ネイティブ インライン UI、完全なアプリページ、埋め込み sidecar、自動化、外部エージェント パス
+- [**A2A Protocol**](/docs/a2a-protocol) — エージェント間通信

package/corpus/core/docs/content/locales/ja-JP/multi-tenancy.mdx

@@ -17,7 +17,7 @@ description: "すべてのエージェント ネイティブ アプリは、設
 - **組織の切り替え** — セッションはアクティブな組織 (`session.orgId`) を追跡し、それを切り替えるとユーザーとエージェントに表示されるデータが変更されます。
 - **組織ごとのデータ分離** — すべてのクエリのスコープは自動的にアクティブな組織に設定されます。
 
-CRM、プロジェクト トラッカー、サポート インボックス、またはその他のチーム ツールのエージェント ネイティブを評価している場合、マルチテナントの基盤はすでに存在しています。すべてのファーストパーティ テンプレートはマルチテナントです。リストについては、[Cloneable SaaS templates](/docs/cloneable-saas) を参照してください。
+CRM、プロジェクト トラッカー、サポート インボックス、またはその他のチーム ツールのエージェント ネイティブを評価している場合、マルチテナントの基盤はすでに存在しています。すべてのファーストパーティ テンプレートはマルチテナントです。リストについては、[テンプレート](/docs/cloneable-saas) を参照してください。
 
 <Diagram id="doc-block-1b0ytkl" title={"組織のメンバーシップと隔離"} summary={"ユーザーは owner/admin/member として組織に参加します。すべての所有可能な行には、それを所有するテナントの org_id が含まれており、境界を越えて行がリークすることはありません。"}>
 
@@ -117,8 +117,8 @@ CRM、プロジェクト トラッカー、サポート インボックス、ま
 
 これは、ユーザーごとのスコープ設定に使用されるのと同じパイプラインです。 SQL レベルのメカニズム、`ownableColumns()` コントラクト、および `accessFilter` / `resolveAccess` / `assertAccess` ガードについては、スコープ パイプラインの信頼できる唯一の情報源である [Security → Data Scoping](/docs/security#data-scoping) を参照してください。
 
-## 関連ドキュメント {#related}
+## 次のステップ {#related}
 
-- [Authentication](/docs/authentication#organizations) — セッション、ソーシャル プロバイダー、および組織管理画面
-- [Security → Data Scoping](/docs/security#data-scoping) — SQL レベルの分離、`ownableColumns()` コントラクト、およびアクセス ガード
-- [Multi-App Workspace](/docs/multi-app-workspace) — 共有認証と RBAC を使用して 1 つのモノリポジトリで複数のエージェント ネイティブ アプリをホストする
+- [**Authentication**](/docs/authentication#organizations) — セッション、ソーシャル プロバイダー、組織管理画面
+- [**Security — Data Scoping**](/docs/security#data-scoping) — SQL レベルの分離、`ownableColumns()` コントラクト、アクセス ガード
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — 共有認証と RBAC を使用して 1 つの monorepo で複数の Agent-Native アプリをホストします

package/corpus/core/docs/content/locales/ja-JP/notifications.mdx

@@ -113,6 +113,7 @@ await notify(
 | `inbox`    | `notifications` テーブルに保持されます。ベル UI を動かします | 常時オン — プリミティブの一部。                              |
 | `webhook`  | POST JSON から構成済みの URL                                 | `NOTIFICATIONS_WEBHOOK_URL` 環境変数は起動時に設定されます。 |
 
+メール、Slack、Webhook はすべて、受信トレイとともに常に登録されます。配信では通知ごとのメタデータにある URL または受信者が優先され、その後、対応する環境変数にフォールバックします。どちらも設定されていない場合、そのチャネルは通知時に何も行いません。
 Webhook チャネルは、所有者のアドホック [secrets](/docs/security) に対して URL と `NOTIFICATIONS_WEBHOOK_AUTH` の両方の `${keys.NAME}` 参照を解決するため、生の値がエージェントのコンテキストに入ることはありません。キーごとの URL ホワイトリストが適用されます。自動化 `web-request` ツールが使用するのと同じルールです。
 
 <Diagram id="doc-block-pmqexc" title={"チャネルと重大度"} summary={"受信トレイは常にオンになっています。 Webhook には環境変数が必要です。カスタム チャネルは起動時に登録されます。重大度はバッジのスタイルを決定し、すべてのチャネルに渡されます。"}>
@@ -203,7 +204,7 @@ await notify(
 
 任意のサーバー プラグインからカスタム チャネルを登録します。
 
-```ts
+```ts filename="server/plugins/notifications-slack-ops.ts"
 import { registerNotificationChannel } from "@agent-native/core/notifications";
 
 registerNotificationChannel({
@@ -274,15 +275,15 @@ interface NotificationMeta {
 
 core-routes プラグインによって `/_agent-native/notifications/*` にマウントされます。すべてのルートは、認証されたセッションの電子メールにスコープされます。
 
-| メソッド | パス                                                |
-| -------- | --------------------------------------------------- |
-| `GET`    | `/_agent-native/notifications?unread=true&limit=50` |
-| `GET`    | `/_agent-native/notifications/count`                |
-| `POST`   | `/_agent-native/notifications/:id/read`             |
-| `POST`   | `/_agent-native/notifications/read-all`             |
-| `DELETE` | `/_agent-native/notifications/:id`                  |
+| メソッド | パス                                                           |
+| -------- | -------------------------------------------------------------- |
+| `GET`    | `/_agent-native/notifications?unread=true&limit=50&before=ISO` |
+| `GET`    | `/_agent-native/notifications/count`                           |
+| `POST`   | `/_agent-native/notifications/:id/read`                        |
+| `POST`   | `/_agent-native/notifications/read-all`                        |
+| `DELETE` | `/_agent-native/notifications/:id`                             |
 
-<Endpoint id="doc-block-wg8xf2" title={"リスト通知"} summary={"The route behind listNotifications() — scoped to the authenticated session's email."} method="GET" path={"/_agent-native/notifications?unread=true&limit=50"} summary={"現在のユーザーに対する最近の通知を一覧表示します"} auth={"Authenticated session; results are scoped to the session's email."} params={[
+<Endpoint id="doc-block-wg8xf2" title={"リスト通知"} method="GET" path={"/_agent-native/notifications?unread=true&limit=50&before=ISO"} summary={"現在のユーザーに対する最近の通知を一覧表示します"} auth={"Authenticated session; results are scoped to the session's email."} params={[
   {
     "name": "unread",
     "in": "query",
@@ -296,6 +297,13 @@ core-routes プラグインによって `/_agent-native/notifications/*` にマ
     "type": "number",
     "required": false,
     "description": "Max rows to return."
+  },
+  {
+    "name": "before",
+    "in": "query",
+    "type": "string",
+    "required": false,
+    "description": "ISO タイムスタンプカーソル。ページネーションのため、この時刻より前に作成された通知を返します。"
   }
 ]} responses={[
   {
@@ -308,7 +316,7 @@ core-routes プラグインによって `/_agent-native/notifications/*` にマ
 
 ## UIコンポーネント {#ui}
 
-```tsx
+```tsx filename="app/components/HeaderBar.tsx"
 import { NotificationsBell } from "@agent-native/core/client/notifications";
 
 export function HeaderBar() {