@agent-native/core 0.79.25 → 0.79.27

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

@@ -25,13 +25,69 @@ Agent-Native は意図的に構成可能です。 UI をあまり必要とせず
 エージェントは 1 つのアクションを持ち、表またはグラフとしてチャットに表示され、後にエージェントになります
 エージェントが呼び出す操作を変更せずにアプリを全画面表示します。
 
-```an-diagram title="表面スペクトル" summary="1 つのアクション サーフェス、4 つの製品シェイプ — それぞれが、その下の操作を変更せずに UI を追加します。"
-{
-  "html": "<div class=\"diagram-spectrum\"><div class=\"diagram-card\"><strong>Headless</strong><small class=\"diagram-muted\">actions、ジョブ、スクリプト、他のエージェント</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>リッチチャット</strong><small class=\"diagram-muted\">コンポーザー、文字起こし、ツールカード</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>埋め込み sidecar</strong><small class=\"diagram-muted\">agent beside an existing app</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card accent-card\"><span class=\"diagram-pill accent\">ほとんどの UI</span><strong>完全なアプリケーション</strong><small class=\"diagram-muted\">永続画面、データ、コラボレーション</small></div></div><div class=\"diagram-base\" data-rough><span class=\"diagram-muted\">同じ actions · 同じ SQL · 同じエージェントループ</span></div>",
-  "css": ".diagram-spectrum{display:flex;align-items:stretch;gap:10px;flex-wrap:wrap}.diagram-spectrum .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:150px;flex:1}.diagram-spectrum .diagram-arrow{align-self:center;font-size:22px;line-height:1}.diagram-base{margin-top:12px;padding:10px 14px;text-align:center}"
+<Diagram id="doc-block-kmhk8i" title={"表面スペクトル"} summary={"1 つのアクション サーフェス、4 つの製品シェイプ — それぞれが、その下の操作を変更せずに UI を追加します。"}>
+
+```html
+<div class="diagram-spectrum">
+  <div class="diagram-card">
+    <strong>Headless</strong
+    ><small class="diagram-muted"
+      >actions、ジョブ、スクリプト、他のエージェント</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-card">
+    <strong>リッチチャット</strong
+    ><small class="diagram-muted">コンポーザー、文字起こし、ツールカード</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-card">
+    <strong>埋め込み sidecar</strong
+    ><small class="diagram-muted">agent beside an existing app</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-card accent-card">
+    <span class="diagram-pill accent">ほとんどの UI</span
+    ><strong>完全なアプリケーション</strong
+    ><small class="diagram-muted">永続画面、データ、コラボレーション</small>
+  </div>
+</div>
+<div class="diagram-base" data-rough>
+  <span class="diagram-muted"
+    >同じ actions · 同じ SQL · 同じエージェントループ</span
+  >
+</div>
+```
+
+```css
+.diagram-spectrum {
+  display: flex;
+  align-items: stretch;
+  gap: 10px;
+  flex-wrap: wrap;
+}
+.diagram-spectrum .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 14px 16px;
+  min-width: 150px;
+  flex: 1;
+}
+.diagram-spectrum .diagram-arrow {
+  align-self: center;
+  font-size: 22px;
+  line-height: 1;
+}
+.diagram-base {
+  margin-top: 12px;
+  padding: 10px 14px;
+  text-align: center;
 }
 ```
 
+</Diagram>
+
 ## ヘッドレスエージェント {#headless}
 
 カスタム アプリ画面を見つめる必要がない場合は、ヘッドレス パスを使用します。
@@ -347,13 +403,65 @@ export function AppShell({ children }) {
 }
 ```
 
-```an-diagram title="サイドカーがホスト アプリにブリッジする方法" summary="プラグインは Agent-Native ルーティングをサーバー側にマウントします。 React サイドカーは、ページ コンテキストをストリーム入力し、ホスト コマンドを出力します。"
-{
-  "html": "<div class=\"diagram-sidecar\"><div class=\"diagram-panel\"><strong>ホストアプリ</strong><small class=\"diagram-muted\">既存の SaaS</small><div class=\"diagram-node\">getContext()<br><small class=\"diagram-muted\">ルート · 選択</small></div><div class=\"diagram-node\">onNavigate / onRefresh<br><small class=\"diagram-muted\">ホストコマンド</small></div></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\">&larr;</div></div><div class=\"diagram-panel accent-panel\"><span class=\"diagram-pill accent\">AgentNativeEmbedded</span><small class=\"diagram-muted\">agent + workspace</small><div class=\"diagram-box\" data-rough>Agent-Native ルート<br><small class=\"diagram-muted\">mounted by the server plugin</small></div></div></div>",
-  "css": ".diagram-sidecar{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-sidecar .diagram-panel{display:flex;flex-direction:column;gap:8px;padding:14px 16px;min-width:200px}.diagram-sidecar .diagram-col-arrows{display:flex;flex-direction:column;gap:6px}.diagram-sidecar .diagram-arrow{font-size:22px;line-height:1}"
+<Diagram id="doc-block-vsm8e2" title={"サイドカーがホスト アプリにブリッジする方法"} summary={"プラグインは Agent-Native ルーティングをサーバー側にマウントします。 React サイドカーは、ページ コンテキストをストリーム入力し、ホスト コマンドを出力します。"}>
+
+```html
+<div class="diagram-sidecar">
+  <div class="diagram-panel">
+    <strong>ホストアプリ</strong
+    ><small class="diagram-muted">既存の SaaS</small>
+    <div class="diagram-node">
+      getContext()<br /><small class="diagram-muted">ルート · 選択</small>
+    </div>
+    <div class="diagram-node">
+      onNavigate / onRefresh<br /><small class="diagram-muted"
+        >ホストコマンド</small
+      >
+    </div>
+  </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">&larr;</div>
+  </div>
+  <div class="diagram-panel accent-panel">
+    <span class="diagram-pill accent">AgentNativeEmbedded</span
+    ><small class="diagram-muted">agent + workspace</small>
+    <div class="diagram-box" data-rough>
+      Agent-Native ルート<br /><small class="diagram-muted"
+        >mounted by the server plugin</small
+      >
+    </div>
+  </div>
+</div>
+```
+
+```css
+.diagram-sidecar {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-sidecar .diagram-panel {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 14px 16px;
+  min-width: 200px;
+}
+.diagram-sidecar .diagram-col-arrows {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+.diagram-sidecar .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 ホスト認証、データベース分離については、[Embedding SDK](/docs/embedding-sdk) を参照してください。
 iframe/ピッカー モード、および下位レベルのブリッジ API。
 

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

@@ -20,13 +20,72 @@ description: "メイン エージェントは、独自のスレッドで実行
 
 サブエージェントの状態は `application_state` SQL テーブル (`agent-task:<taskId>` の下) に保持されるため、タスクはサーバーレス コールド スタート後も存続し、複数のプロセスにわたって動作します。
 
-```an-diagram title="オーケストレーターとスペシャリスト" summary="メイン チャットは、独自のスレッドで実行され、インライン チップとして報告されるサブエージェントに委任します。"
-{
-  "html": "<div class=\"at-orc\"><div class=\"diagram-card main\"><span class=\"diagram-pill accent\">メインチャット</span><small class=\"diagram-muted\">orchestrator &mdash; reads your request, delegates</small></div><div class=\"at-fan\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"at-subs\"><div class=\"diagram-box\">コードレビュー<br><small class=\"diagram-muted\">own thread &amp; prompt</small></div><div class=\"diagram-box\">BigQuery分析<br><small class=\"diagram-muted\">own tools</small></div><div class=\"diagram-box\">音声でメール<br><small class=\"diagram-muted\">own context</small></div></div></div><div class=\"diagram-pill\">each appears inline as a live chip &#8635;</div></div>",
-  "css": ".at-orc{display:flex;flex-direction:column;align-items:center;gap:12px}.at-orc .diagram-card{padding:14px 18px;display:flex;flex-direction:column;gap:4px;align-items:center}.at-orc .at-fan{display:flex;flex-direction:column;align-items:center;gap:8px}.at-orc .diagram-arrow{font-size:22px}.at-orc .at-subs{display:flex;gap:12px;flex-wrap:wrap;justify-content:center}.at-orc .diagram-box{text-align:center}"
+<Diagram id="doc-block-1ela3w5" title={"オーケストレーターとスペシャリスト"} summary={"メイン チャットは、独自のスレッドで実行され、インライン チップとして報告されるサブエージェントに委任します。"}>
+
+```html
+<div class="at-orc">
+  <div class="diagram-card main">
+    <span class="diagram-pill accent">メインチャット</span
+    ><small class="diagram-muted"
+      >orchestrator &mdash; reads your request, delegates</small
+    >
+  </div>
+  <div class="at-fan">
+    <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+    <div class="at-subs">
+      <div class="diagram-box">
+        コードレビュー<br /><small class="diagram-muted"
+          >own thread &amp; prompt</small
+        >
+      </div>
+      <div class="diagram-box">
+        BigQuery分析<br /><small class="diagram-muted">own tools</small>
+      </div>
+      <div class="diagram-box">
+        音声でメール<br /><small class="diagram-muted">own context</small>
+      </div>
+    </div>
+  </div>
+  <div class="diagram-pill">each appears inline as a live chip &#8635;</div>
+</div>
+```
+
+```css
+.at-orc {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 12px;
+}
+.at-orc .diagram-card {
+  padding: 14px 18px;
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  align-items: center;
+}
+.at-orc .at-fan {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 8px;
+}
+.at-orc .diagram-arrow {
+  font-size: 22px;
+}
+.at-orc .at-subs {
+  display: flex;
+  gap: 12px;
+  flex-wrap: wrap;
+  justify-content: center;
+}
+.at-orc .diagram-box {
+  text-align: center;
 }
 ```
 
+</Diagram>
+
 ## サブエージェントをいつ生成するか {#when-to-spawn}
 
 タスクが発生した場合:
@@ -85,13 +144,70 @@ const task = await spawnTask({
 
 ## タスクのライフサイクル {#lifecycle}
 
-```an-diagram title="spawnTask() の機能" summary="各スポーンはスレッドを作成し、状態を SQL に保持し、チップ イベントを完了までストリーミングします。"
-{
-  "html": "<div class=\"at-life\"><div class=\"diagram-box\"><code>spawnTask()</code></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">create thread</span><small class=\"diagram-muted\">new row in <code>chat_threads</code>, description as first message</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">persist state</span><small class=\"diagram-muted\"><code>agent-task:&lt;id&gt;</code> &rarr; <code>application_state</code>, status=running</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">stream</span><small class=\"diagram-muted\"><code>agent_task_started</code> &rarr; chip appears; <code>agent_task_step</code> &rarr; chip updates live</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card ok\"><span class=\"diagram-pill ok\">complete</span><small class=\"diagram-muted\">status=completed, write summary + preview, emit <code>agent_task_done</code></small></div></div>",
-  "css": ".at-life{display:flex;flex-direction:column;align-items:stretch;gap:6px;max-width:560px}.at-life .diagram-card{display:flex;flex-direction:column;gap:3px;padding:10px 14px}.at-life .diagram-box{align-self:flex-start}.at-life .diagram-arrow{font-size:18px;align-self:center}"
+<Diagram id="doc-block-1farow0" title={"spawnTask() の機能"} summary={"各スポーンはスレッドを作成し、状態を SQL に保持し、チップ イベントを完了までストリーミングします。"}>
+
+```html
+<div class="at-life">
+  <div class="diagram-box"><code>spawnTask()</code></div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill">create thread</span
+    ><small class="diagram-muted"
+      >new row in <code>chat_threads</code>, description as first message</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill">persist state</span
+    ><small class="diagram-muted"
+      ><code>agent-task:&lt;id&gt;</code> &rarr; <code>application_state</code>,
+      status=running</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill accent">stream</span
+    ><small class="diagram-muted"
+      ><code>agent_task_started</code> &rarr; chip appears;
+      <code>agent_task_step</code> &rarr; chip updates live</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card ok">
+    <span class="diagram-pill ok">complete</span
+    ><small class="diagram-muted"
+      >status=completed, write summary + preview, emit
+      <code>agent_task_done</code></small
+    >
+  </div>
+</div>
+```
+
+```css
+.at-life {
+  display: flex;
+  flex-direction: column;
+  align-items: stretch;
+  gap: 6px;
+  max-width: 560px;
+}
+.at-life .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 3px;
+  padding: 10px 14px;
+}
+.at-life .diagram-box {
+  align-self: flex-start;
+}
+.at-life .diagram-arrow {
+  font-size: 18px;
+  align-self: center;
 }
 ```
 
+</Diagram>
+
 親エージェントはいつでも、`sendToTask(taskId, message)` 経由でサブエージェントを再開してフォローアップできます。サブエージェントにエラーが発生した場合、`markTaskErrored(taskId, reason)` は失敗を記録し、ユーザーに表示します。
 
 双方向メッセージングは永続的です。実行中のサブエージェントに対する親のフォローアップは次のとおりです。
@@ -138,13 +254,57 @@ interface AgentTask {
 
 トップレベルのチャットは深さ `0` です。それが生成するサブエージェントの深さは `1` です。そのサブエージェントはもう一度出現する可能性があります (深さ `2`)。深さ `3` サブエージェントを作成するスポーンは **拒否**されます。デフォルトの上限は **2** です。
 
-```an-diagram title="委任深度ガード (デフォルトのキャップ 2)" summary="各レベルはキャップに達するまでさらに深くスポーンする可能性があります。それを超えたスポーンはサーバー側で拒否されます。"
-{
-  "html": "<div class=\"at-depth\"><div class=\"diagram-card ok\"><span class=\"diagram-pill\">depth 0</span><strong>トップレベルチャット</strong><small class=\"diagram-muted ok\">may spawn &darr;</small></div><div class=\"diagram-card ok\"><span class=\"diagram-pill\">depth 1</span><strong>サブエージェント</strong><small class=\"diagram-muted ok\">may spawn &darr;</small></div><div class=\"diagram-card warn\"><span class=\"diagram-pill warn\">depth 2</span><strong>サブエージェント's sub-agent</strong><small class=\"diagram-muted\">at the cap &mdash; may NOT spawn</small></div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">depth 3</span><strong>Refused</strong><small class=\"diagram-muted\">server-side error</small></div></div>",
-  "css": ".at-depth{display:flex;flex-direction:column;gap:8px}.at-depth .diagram-card{display:flex;flex-direction:column;gap:2px;padding:10px 14px}.at-depth .rung-1,.at-depth .diagram-card:nth-child(2){margin-inline-start:24px}.at-depth .diagram-card:nth-child(3){margin-inline-start:48px}.at-depth .diagram-card:nth-child(4){margin-inline-start:72px}"
+<Diagram id="doc-block-s9g4jr" title={"委任深度ガード (デフォルトのキャップ 2)"} summary={"各レベルはキャップに達するまでさらに深くスポーンする可能性があります。それを超えたスポーンはサーバー側で拒否されます。"}>
+
+```html
+<div class="at-depth">
+  <div class="diagram-card ok">
+    <span class="diagram-pill">depth 0</span
+    ><strong>トップレベルチャット</strong
+    ><small class="diagram-muted ok">may spawn &darr;</small>
+  </div>
+  <div class="diagram-card ok">
+    <span class="diagram-pill">depth 1</span><strong>サブエージェント</strong
+    ><small class="diagram-muted ok">may spawn &darr;</small>
+  </div>
+  <div class="diagram-card warn">
+    <span class="diagram-pill warn">depth 2</span
+    ><strong>サブエージェント's sub-agent</strong
+    ><small class="diagram-muted">at the cap &mdash; may NOT spawn</small>
+  </div>
+  <div class="diagram-card">
+    <span class="diagram-pill warn">depth 3</span><strong>Refused</strong
+    ><small class="diagram-muted">server-side error</small>
+  </div>
+</div>
+```
+
+```css
+.at-depth {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.at-depth .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  padding: 10px 14px;
+}
+.at-depth .rung-1,
+.at-depth .diagram-card:nth-child(2) {
+  margin-inline-start: 24px;
+}
+.at-depth .diagram-card:nth-child(3) {
+  margin-inline-start: 48px;
+}
+.at-depth .diagram-card:nth-child(4) {
+  margin-inline-start: 72px;
 }
 ```
 
+</Diagram>
+
 強制はアンビエントです。各サブエージェントは、自身の深さを記録する `AsyncLocalStorage` 内で実行されるため、その実行から推移的に到達した `spawnTask` は、親の深さを読み取り、上限に達すると拒否します。たとえ `agent-teams` ツールが、それを持っているはずのないサブエージェントに渡されたとしてもです。この決定は、純粋で単体テスト可能な `evaluateSubagentDepth(parentDepth)` として公開されます。生成を拒否すると、明確なエラーが返されます: _「委任の深さの制限に達しました (最大 N)。別のサブエージェントを生成できません。」_
 
 ### キャップの構成 {#depth-guard-config}

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

@@ -19,13 +19,60 @@ description: "パブリック ルートを、エージェントによるクロ
 
 `publicMcp: true` を設定すると、オプトインされた actions がパブリック MCP エンドポイントとしてさらに公開され、外部エージェントがそれらを直接呼び出すことができるようになります ([MCP Protocol](/docs/mcp-protocol) を参照)。
 
-```an-diagram title="パブリックルートが公開するもの" summary="パブリック ルートは、エージェントに優しい表現に展開されます。ルートの読み取りはツールの呼び出しとは別のものです。ツールへのアクセスはオプトインのままです。"
-{
-  "html": "<div class=\"diagram-web\"><div class=\"diagram-box\" data-rough>公開ルート<br><small class=\"diagram-muted\">derived from route access settings</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-grid\"><span class=\"diagram-pill\">robots.txt</span><span class=\"diagram-pill\">sitemap.xml</span><span class=\"diagram-pill\">llms.txt</span><span class=\"diagram-pill\">.md mirror</span><span class=\"diagram-pill\">JSON-LD</span><span class=\"diagram-pill\">text/markdown</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col gate\"><span class=\"diagram-pill warn\">ツールは非公開のまま</span><small class=\"diagram-muted\">publicMcp + publicAgent.expose required</small></div></div>",
-  "css": ".diagram-web{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-web .diagram-arrow{font-size:22px;line-height:1}.diagram-web .diagram-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px}.diagram-web .gate{display:flex;flex-direction:column;gap:4px;align-items:flex-start}"
+<Diagram id="doc-block-1xzjykc" title={"パブリックルートが公開するもの"} summary={"パブリック ルートは、エージェントに優しい表現に展開されます。ルートの読み取りはツールの呼び出しとは別のものです。ツールへのアクセスはオプトインのままです。"}>
+
+```html
+<div class="diagram-web">
+  <div class="diagram-box" data-rough>
+    公開ルート<br /><small class="diagram-muted"
+      >derived from route access settings</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-grid">
+    <span class="diagram-pill">robots.txt</span
+    ><span class="diagram-pill">sitemap.xml</span
+    ><span class="diagram-pill">llms.txt</span
+    ><span class="diagram-pill">.md mirror</span
+    ><span class="diagram-pill">JSON-LD</span
+    ><span class="diagram-pill">text/markdown</span>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-col gate">
+    <span class="diagram-pill warn">ツールは非公開のまま</span
+    ><small class="diagram-muted"
+      >publicMcp + publicAgent.expose required</small
+    >
+  </div>
+</div>
+```
+
+```css
+.diagram-web {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-web .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
+}
+.diagram-web .diagram-grid {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 8px;
+}
+.diagram-web .gate {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  align-items: flex-start;
 }
 ```
 
+</Diagram>
+
 ## 構成 {#config}
 
 既存のワークスペース アプリ構成の下 (アプリの `agent-native` キーの下の `package.json`、または同等の `workspace.agentWeb`、`agentWeb`、または `root.agentWeb`) に `agentWeb` を追加します。パブリック ルート リストは依然としてアプリのルート アクセス設定から派生します。 `agentWeb` は、パブリック サーフェスがエージェントに対してどのように表示されるかを制御します。

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

@@ -15,13 +15,73 @@ description: "電子メール/パスワード、ソーシャル プロバイダ
 - **リモート MCP OAuth:** Claude コードや ChatGPT コネクタなどの MCP ホスト用の標準 OAuth 2.1。
 - **カスタム:** `getSession` コールバック経由で独自の認証を取得します。
 
-```an-diagram title="1 回のセッションで 3 つの方法で" summary="ブラウザーの訪問者、プログラムによる MCP クライアント、およびカスタム プロバイダーはすべて、ダウンストリーム スコーピングが読み取る同じ AuthSession に解決されます。"
-{
-  "html": "<div class=\"auth-modes\"><div class=\"diagram-col\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Default</span><strong>Better Auth</strong><small class=\"diagram-muted\">email/password &middot; Google &middot; GitHub</small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">Remote MCP OAuth</span><strong>OAuth 2.1 + PKCE</strong><small class=\"diagram-muted\">Claude Code、ChatGPTコネクタ</small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">Custom</span><strong>getSession callback</strong><small class=\"diagram-muted\">Clerk &middot; Auth0 &middot; Firebase</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill ok\">AuthSession</span><small class=\"diagram-muted\">email &middot; orgId &middot; orgRole</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Request context &amp; data scoping</div></div>",
-  "css": ".auth-modes{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.auth-modes .diagram-col{display:flex;flex-direction:column;gap:10px}.auth-modes .diagram-card{display:flex;flex-direction:column;gap:4px;padding:10px 12px}.auth-modes .diagram-arrow{font-size:22px;line-height:1}.auth-modes .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+<Diagram id="doc-block-76smlp" title={"1 回のセッションで 3 つの方法で"} summary={"ブラウザーの訪問者、プログラムによる MCP クライアント、およびカスタム プロバイダーはすべて、ダウンストリーム スコーピングが読み取る同じ AuthSession に解決されます。"}>
+
+```html
+<div class="auth-modes">
+  <div class="diagram-col">
+    <div class="diagram-card">
+      <span class="diagram-pill accent">Default</span
+      ><strong>Better Auth</strong
+      ><small class="diagram-muted"
+        >email/password &middot; Google &middot; GitHub</small
+      >
+    </div>
+    <div class="diagram-card">
+      <span class="diagram-pill">Remote MCP OAuth</span
+      ><strong>OAuth 2.1 + PKCE</strong
+      ><small class="diagram-muted">Claude Code、ChatGPTコネクタ</small>
+    </div>
+    <div class="diagram-card">
+      <span class="diagram-pill">Custom</span
+      ><strong>getSession callback</strong
+      ><small class="diagram-muted"
+        >Clerk &middot; Auth0 &middot; Firebase</small
+      >
+    </div>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-panel center">
+    <span class="diagram-pill ok">AuthSession</span
+    ><small class="diagram-muted">email &middot; orgId &middot; orgRole</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-box">Request context &amp; data scoping</div>
+</div>
+```
+
+```css
+.auth-modes {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.auth-modes .diagram-col {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+}
+.auth-modes .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 10px 12px;
+}
+.auth-modes .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
+}
+.auth-modes .center {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
 }
 ```
 
+</Diagram>
+
 ブラウザ フローはどこでも同じ Better Auth フローです。**開発認証バイパスはありません**。`getSession()` が `local@localhost` センチネルにフォールバックすることはありません。環境間で変わるのはサインアップの摩擦であり、ログインの壁ではありません:
 
 | 環境                | 初回読み込み時の動作                                                                   | メール認証                                                      |
@@ -164,13 +224,67 @@ https://mail.agent-native.com/_agent-native/mcp
 
 認証されていない MCP リクエストは、`/.well-known/oauth-protected-resource` を指す `WWW-Authenticate` チャレンジを返します。次に、クライアントはアプリの OAuth メタデータを検出し、パブリック クライアントを動的に登録し、アプリの認証ページを開き、アクセス トークンとリフレッシュ トークンのために認証コードを PKCE と交換します。
 
-```an-diagram title="リモート MCP OAuth ハンドシェイク" summary="OAuth 対応クライアントは、MCP URL だけからブートストラップし、チャレンジ、検出、動的登録、その後 PKCE コード交換を行います。"
-{
-  "html": "<div class=\"mcp-flow\"><div class=\"diagram-node\">1 &middot; MCP request<br><small class=\"diagram-muted\">no token</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node warn\">2 &middot; 401 challenge<br><small class=\"diagram-muted\">WWW-Authenticate</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">3 &middot; Discover metadata<br><small class=\"diagram-muted\">.well-known</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">4 &middot; Register client<br><small class=\"diagram-muted\">動的、公開</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">5 &middot; Authorize + PKCE<br><small class=\"diagram-muted\">code exchange</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node ok\">6 &middot; Access + refresh<br><small class=\"diagram-muted\">audience-bound</small></div></div>",
-  "css": ".mcp-flow{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.mcp-flow .diagram-node{display:flex;flex-direction:column;gap:2px;padding:8px 12px}.mcp-flow .diagram-arrow{font-size:20px;line-height:1}"
+<Diagram id="doc-block-1fsvafh" title={"リモート MCP OAuth ハンドシェイク"} summary={"OAuth 対応クライアントは、MCP URL だけからブートストラップし、チャレンジ、検出、動的登録、その後 PKCE コード交換を行います。"}>
+
+```html
+<div class="mcp-flow">
+  <div class="diagram-node">
+    1 &middot; MCP request<br /><small class="diagram-muted">no token</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node warn">
+    2 &middot; 401 challenge<br /><small class="diagram-muted"
+      >WWW-Authenticate</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node">
+    3 &middot; Discover metadata<br /><small class="diagram-muted"
+      >.well-known</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node">
+    4 &middot; Register client<br /><small class="diagram-muted"
+      >動的、公開</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node">
+    5 &middot; Authorize + PKCE<br /><small class="diagram-muted"
+      >code exchange</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node ok">
+    6 &middot; Access + refresh<br /><small class="diagram-muted"
+      >audience-bound</small
+    >
+  </div>
+</div>
+```
+
+```css
+.mcp-flow {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  flex-wrap: wrap;
+}
+.mcp-flow .diagram-node {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  padding: 8px 12px;
+}
+.mcp-flow .diagram-arrow {
+  font-size: 20px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 アクセス トークンは、設定されている場合は `A2A_SECRET` で署名され、それ以外の場合は `BETTER_AUTH_SECRET` で署名されます。これらは、署名されたユーザー/組織 ID と `mcp:read`、`mcp:write`、および/または `mcp:apps` スコープを保持し、正確な MCP リソース URL にオーディエンス バインドされています。リフレッシュ トークンはハッシュとしてのみ保存され、リフレッシュのたびにローテーションされます。ツール呼び出しと MCP アプリ リソースの読み取りは、サインインしているユーザーと同じ要求コンテキスト内で実行されます。埋め込まれた MCP アプリ iframe は、生の OAuth トークンを受信しません。
 
 `npx @agent-native/core@latest connect <url> --client claude-code` は、この標準フローの URL 専用の MCP エントリを書き込みます。リモート MCP OAuth を実行できないクライアントの場合は、接続ページまたは `npx @agent-native/core@latest connect --token <token>` フォールバックを使用して、明示的なベアラー トークン エントリを書き込みます。