@agent-native/core 0.79.26 → 0.80.0

package/docs/content/locales/ko-KR/workspace-connections.mdx

@@ -16,13 +16,75 @@ description: "어디서나 연결 한 번 사용 통합을 위한 공유 공급
 - **credentialRef** — 저장소 비밀(`{ key: "SLACK_BOT_TOKEN", scope: "org" }`)에 대한 포인터입니다. 연결은 토큰이 어디에 있는지 알려줍니다. 금고에는 가치가 보관되어 있습니다.
 - **준비 상태** — 앱에 표시되는 결합 상태: `connected`(허용됨 + 자격 증명 존재), `needs_grant`, `needs_credentials`, `needs_attention` 또는 `not_configured`.
 
-```an-diagram title="한 번 연결하고 앱을 부여하고 자격 증명을 재사용하세요." summary="연결은 저장소를 가리키는 공급자 메타데이터(비밀 아님)와 credentialRef를 보유합니다. 앱별 보조금으로 잠금을 해제할 수 있습니다. 앱은 단일 준비 상태를 읽습니다."
-{
-  "html": "<div class=\"diagram-conn\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">Connection</span><div class=\"diagram-box\" data-rough>named provider account<br><small class=\"diagram-muted\">provider, label, 상태, 범위, 설정 &middot; never stores secret values</small></div><div class=\"diagram-muted\">credentialRef &rarr; pointer to a vault secret</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill\">Grant</span><div class=\"diagram-box\" data-rough>per-app permission<br><small class=\"diagram-muted\">no grant = no credential access</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill ok\">Readiness</span><small class=\"diagram-muted\">what the app sees</small><div class=\"sev-row\"><span class=\"diagram-pill ok\">connected</span><span class=\"diagram-pill warn\">needs_grant</span></div><div class=\"sev-row\"><span class=\"diagram-pill warn\">needs_credentials</span><span class=\"diagram-pill warn\">needs_attention</span></div><div class=\"sev-row\"><span class=\"diagram-pill\">not_configured</span></div></div></div>",
-  "css": ".diagram-conn{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-conn .col{display:flex;flex-direction:column;gap:8px;padding:14px;min-width:220px}.diagram-conn .diagram-arrow{font-size:22px;line-height:1}.diagram-conn .sev-row{display:flex;gap:8px;flex-wrap:wrap}"
+<Diagram id="doc-block-1wzcv48" title={"한 번 연결하고 앱을 부여하고 자격 증명을 재사용하세요."} summary={"연결은 저장소를 가리키는 공급자 메타데이터(비밀 아님)와 credentialRef를 보유합니다. 앱별 보조금으로 잠금을 해제할 수 있습니다. 앱은 단일 준비 상태를 읽습니다."}>
+
+```html
+<div class="diagram-conn">
+  <div class="diagram-panel col" data-rough>
+    <span class="diagram-pill accent">Connection</span>
+    <div class="diagram-box" data-rough>
+      named provider account<br /><small class="diagram-muted"
+        >provider, label, 상태, 범위, 설정 &middot; never stores secret
+        values</small
+      >
+    </div>
+    <div class="diagram-muted">
+      credentialRef &rarr; pointer to a vault secret
+    </div>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-panel col" data-rough>
+    <span class="diagram-pill">Grant</span>
+    <div class="diagram-box" data-rough>
+      per-app permission<br /><small class="diagram-muted"
+        >no grant = no credential access</small
+      >
+    </div>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-panel col" data-rough>
+    <span class="diagram-pill ok">Readiness</span
+    ><small class="diagram-muted">what the app sees</small>
+    <div class="sev-row">
+      <span class="diagram-pill ok">connected</span
+      ><span class="diagram-pill warn">needs_grant</span>
+    </div>
+    <div class="sev-row">
+      <span class="diagram-pill warn">needs_credentials</span
+      ><span class="diagram-pill warn">needs_attention</span>
+    </div>
+    <div class="sev-row"><span class="diagram-pill">not_configured</span></div>
+  </div>
+</div>
+```
+
+```css
+.diagram-conn {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-conn .col {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 14px;
+  min-width: 220px;
+}
+.diagram-conn .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
+}
+.diagram-conn .sev-row {
+  display: flex;
+  gap: 8px;
+  flex-wrap: wrap;
 }
 ```
 
+</Diagram>
+
 ### 작업된 예: Slack
 
 Slack를 한 번 연결하고 Brain 및 Analytics에 부여하세요:
@@ -260,13 +322,71 @@ const brainCatalog = await listWorkspaceConnectionProviderCatalogForApp({
 
 작업 공간 연결 공급자 메타데이터 답변: "이 공급자는 누구이며, 무엇을 할 수 있고, 어떤 자격 증명 키가 필요할 수 있으며, 어떤 템플릿을 제공해야 합니까?"
 
-```an-diagram title="연결 저장소와 Vault" summary="볼트는 비밀 값을 소유합니다. 연결은 공급자 메타데이터와 credentialRef(포인터)를 소유합니다. 실행 시 앱은 부여된 연결을 통해 참조를 확인하고 자격 증명 모음에서 값을 읽습니다."
-{
-  "html": "<div class=\"diagram-vault\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">연결 저장소</span><div class=\"diagram-box\" data-rough>provider account + metadata<br><small class=\"diagram-muted\">상태, 범위, 설정</small></div><div class=\"diagram-box\" data-rough>credentialRef<br><small class=\"diagram-muted\">{ key: SLACK_BOT_TOKEN, scope: org }</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">앱 action</span><small class=\"diagram-muted\">resolves at execution time through a granted ref</small><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill ok\">Vault</span><div class=\"diagram-box\" data-rough>secret value<br><small class=\"diagram-muted\">에이전트나 UI에 반환되지 않음</small></div></div></div>",
-  "css": ".diagram-vault{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-vault .col{display:flex;flex-direction:column;gap:8px;padding:14px;min-width:220px}.diagram-vault .diagram-card{display:flex;flex-direction:column;gap:6px;padding:12px 14px}.diagram-vault .diagram-arrow{font-size:22px;line-height:1}"
+<Diagram id="doc-block-v93o3k" title={"연결 저장소와 Vault"} summary={"볼트는 비밀 값을 소유합니다. 연결은 공급자 메타데이터와 credentialRef(포인터)를 소유합니다. 실행 시 앱은 부여된 연결을 통해 참조를 확인하고 자격 증명 모음에서 값을 읽습니다."}>
+
+```html
+<div class="diagram-vault">
+  <div class="diagram-panel col" data-rough>
+    <span class="diagram-pill accent">연결 저장소</span>
+    <div class="diagram-box" data-rough>
+      provider account + metadata<br /><small class="diagram-muted"
+        >상태, 범위, 설정</small
+      >
+    </div>
+    <div class="diagram-box" data-rough>
+      credentialRef<br /><small class="diagram-muted"
+        >{ key: SLACK_BOT_TOKEN, scope: org }</small
+      >
+    </div>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill">앱 action</span
+    ><small class="diagram-muted"
+      >resolves at execution time through a granted ref</small
+    >
+    <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-panel col" data-rough>
+    <span class="diagram-pill ok">Vault</span>
+    <div class="diagram-box" data-rough>
+      secret value<br /><small class="diagram-muted"
+        >에이전트나 UI에 반환되지 않음</small
+      >
+    </div>
+  </div>
+</div>
+```
+
+```css
+.diagram-vault {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-vault .col {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 14px;
+  min-width: 220px;
+}
+.diagram-vault .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 12px 14px;
+}
+.diagram-vault .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 둘 다 함께 사용:
 
 1. 디스패치(또는 다른 작업공간 설정 흐름)는 기본 저장소 비밀 또는 OAuth 자격 증명 참조를 생성합니다.

package/docs/content/locales/ko-KR/workspace-management.mdx

@@ -9,13 +9,59 @@ description: "브랜칭, CODEOWNERS, PR 검토 및 Dispatch가 Git 수준 거버
 
 이 가이드에서는 분기 방법, 누가 무엇을 검토하는지, 코드 소유권을 설정하는 방법, Dispatch 제어 플레인이 거버넌스 모델에 어떻게 적합한지 등 에이전트 기반 작업 영역 실행의 운영 측면을 다룹니다.
 
-```an-diagram title="두 개의 거버넌스 평면" summary="Git은 코드를 관리합니다. Dispatch은 런타임을 관리합니다. 그것들은 보완적입니다. 하나를 다른 것 안에 복제하지 마십시오."
-{
-  "html": "<div class=\"gov\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Git 및 GitHub</span><strong>코드 거버넌스</strong><div class=\"gov-list\"><span class=\"diagram-pill\">CODEOWNERS</span><span class=\"diagram-pill\">branch protection</span><span class=\"diagram-pill\">PR 검토</span><span class=\"diagram-pill\">git log / blame</span></div></div><div class=\"diagram-pill diagram-muted\">+</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Dispatch</span><strong>Runtime governance</strong><div class=\"gov-list\"><span class=\"diagram-pill\">vault secrets &amp; grants</span><span class=\"diagram-pill\">workspace resources</span><span class=\"diagram-pill\">agent profiles</span><span class=\"diagram-pill\">approvals &amp; audit</span></div></div></div>",
-  "css": ".gov{display:flex;align-items:center;gap:16px;flex-wrap:wrap}.gov .diagram-card{display:flex;flex-direction:column;gap:8px;padding:16px 18px;flex:1;min-width:240px}.gov .gov-list{display:flex;flex-wrap:wrap;gap:6px;margin-top:4px}"
+<Diagram id="doc-block-103vlkm" title={"두 개의 거버넌스 평면"} summary={"Git은 코드를 관리합니다. Dispatch은 런타임을 관리합니다. 그것들은 보완적입니다. 하나를 다른 것 안에 복제하지 마십시오."}>
+
+```html
+<div class="gov">
+  <div class="diagram-card">
+    <span class="diagram-pill accent">Git 및 GitHub</span
+    ><strong>코드 거버넌스</strong>
+    <div class="gov-list">
+      <span class="diagram-pill">CODEOWNERS</span
+      ><span class="diagram-pill">branch protection</span
+      ><span class="diagram-pill">PR 검토</span
+      ><span class="diagram-pill">git log / blame</span>
+    </div>
+  </div>
+  <div class="diagram-pill diagram-muted">+</div>
+  <div class="diagram-card">
+    <span class="diagram-pill accent">Dispatch</span
+    ><strong>Runtime governance</strong>
+    <div class="gov-list">
+      <span class="diagram-pill">vault secrets &amp; grants</span
+      ><span class="diagram-pill">workspace resources</span
+      ><span class="diagram-pill">agent profiles</span
+      ><span class="diagram-pill">approvals &amp; audit</span>
+    </div>
+  </div>
+</div>
+```
+
+```css
+.gov {
+  display: flex;
+  align-items: center;
+  gap: 16px;
+  flex-wrap: wrap;
+}
+.gov .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 16px 18px;
+  flex: 1;
+  min-width: 240px;
+}
+.gov .gov-list {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  margin-top: 4px;
 }
 ```
 
+</Diagram>
+
 ## 분기
 
 ### 기능 분기

package/docs/content/locales/ko-KR/workspace.mdx

@@ -11,13 +11,68 @@ description: "Claude-사용자별 코드 수준 사용자 정의 — skills, 메
 
 비틀림: **파일 시스템 파일이 아니라 SQL 행입니다.** 각 사용자는 데이터베이스에 저장된 자신의 작업 공간을 얻습니다. 가동할 개발 상자도 없고, 사용자당 컨테이너도 없고, 마운트할 파일도 없습니다. 멀티 테넌트 SaaS는 개인 메모리, 개인 MCP 서버, 개인 skills, 개인 하위 에이전트 등 모든 행이 행으로 구성되어 있고 공유 코드베이스가 이 모든 것을 한 번에 호스팅하기 때문에 모든 사용자에게 본질적으로 무료로 완전히 사용자 정의 가능한 에이전트를 제공할 수 있습니다.
 
-```an-diagram title="Claude-Code 작업 공간이지만 SQL에 저장됨" summary="동일한 사용자 정의 계층(지침, 기술, 메모리, 에이전트, 작업, MCP)은 모든 파일이 공유 다중 테넌트 데이터베이스의 행이라는 점을 제외합니다."
-{
-  "html": "<div class=\"ws-map\"><div class=\"diagram-card cc\"><span class=\"diagram-pill warn\">Claude Code / Codex</span><small class=\"diagram-muted\">~/.claude/ on a local disk</small><div class=\"ws-files\"><span class=\"diagram-box\">CLAUDE.md</span><span class=\"diagram-box\">skills/</span><span class=\"diagram-box\">memory</span><span class=\"diagram-box\">mcp.json</span></div><small class=\"diagram-muted\">one codebase per developer</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card an\"><span class=\"diagram-pill accent\">Agent-native 워크스페이스</span><small class=\"diagram-muted\">rows in one SQL 데이터베이스</small><div class=\"ws-rows\"><span class=\"diagram-pill\">AGENTS.md</span><span class=\"diagram-pill\">skills/&hellip;</span><span class=\"diagram-pill\">memory/&hellip;</span><span class=\"diagram-pill\">mcp-servers/&hellip;</span></div><small class=\"diagram-muted\">하나의 코드베이스, 여러 사용자, 범위 지정 <code>u:&lt;email&gt;:&hellip;</code></small></div></div>",
-  "css": ".ws-map{display:flex;align-items:center;gap:16px;flex-wrap:wrap}.ws-map .diagram-card{display:flex;flex-direction:column;gap:8px;padding:16px 18px;flex:1;min-width:220px}.ws-map .ws-files,.ws-map .ws-rows{display:flex;flex-wrap:wrap;gap:6px;margin:4px 0}.ws-map .diagram-arrow{font-size:24px}"
+<Diagram id="doc-block-19r4wnf" title={"Claude-Code 작업 공간이지만 SQL에 저장됨"} summary={"동일한 사용자 정의 계층(지침, 기술, 메모리, 에이전트, 작업, MCP)은 모든 파일이 공유 다중 테넌트 데이터베이스의 행이라는 점을 제외합니다."}>
+
+```html
+<div class="ws-map">
+  <div class="diagram-card cc">
+    <span class="diagram-pill warn">Claude Code / Codex</span
+    ><small class="diagram-muted">~/.claude/ on a local disk</small>
+    <div class="ws-files">
+      <span class="diagram-box">CLAUDE.md</span
+      ><span class="diagram-box">skills/</span
+      ><span class="diagram-box">memory</span
+      ><span class="diagram-box">mcp.json</span>
+    </div>
+    <small class="diagram-muted">one codebase per developer</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-card an">
+    <span class="diagram-pill accent">Agent-native 워크스페이스</span
+    ><small class="diagram-muted">rows in one SQL 데이터베이스</small>
+    <div class="ws-rows">
+      <span class="diagram-pill">AGENTS.md</span
+      ><span class="diagram-pill">skills/&hellip;</span
+      ><span class="diagram-pill">memory/&hellip;</span
+      ><span class="diagram-pill">mcp-servers/&hellip;</span>
+    </div>
+    <small class="diagram-muted"
+      >하나의 코드베이스, 여러 사용자, 범위 지정
+      <code>u:&lt;email&gt;:&hellip;</code></small
+    >
+  </div>
+</div>
+```
+
+```css
+.ws-map {
+  display: flex;
+  align-items: center;
+  gap: 16px;
+  flex-wrap: wrap;
+}
+.ws-map .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 16px 18px;
+  flex: 1;
+  min-width: 220px;
+}
+.ws-map .ws-files,
+.ws-map .ws-rows {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  margin: 4px 0;
+}
+.ws-map .diagram-arrow {
+  font-size: 24px;
 }
 ```
 
+</Diagram>
+
 | Claude 코드 / Codex                  | 에이전트 기반 작업공간                         |
 | ------------------------------------ | ---------------------------------------------- |
 | 로컬 디스크의 파일                   | 공유 SQL 데이터베이스의 행                     |
@@ -51,13 +106,61 @@ description: "Claude-사용자별 코드 수준 사용자 정의 — skills, 메
 
 이러한 경로는 작업 영역, 조직/앱, 개인의 세 가지 범위 모두에 적용됩니다. 동일한 경로가 여러 수준에 존재하는 경우 나중 범위가 우선합니다.
 
-```an-diagram title="세 가지 범위, 하나의 유효 파일" summary="런타임은 읽기 시 작업 영역, 앱 및 개인 범위에서 동일한 경로를 확인합니다. 가장 구체적인 범위가 우선합니다."
-{
-  "html": "<div class=\"ws-stack\"><div class=\"diagram-card\"><span class=\"diagram-pill\">Workspace</span><small class=\"diagram-muted\">Dispatch의 회사 전체 기본값</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">조직 / 앱</span><small class=\"diagram-muted\">team override for one app</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Personal</span><small class=\"diagram-muted\">per-user override &mdash; wins</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box ok\">Effective <code>context/brand.md</code></div></div>",
-  "css": ".ws-stack{display:flex;flex-direction:column;align-items:flex-start;gap:8px}.ws-stack .diagram-card{display:flex;flex-direction:column;gap:4px;padding:12px 16px;min-width:280px}.ws-stack .diagram-arrow{font-size:20px;align-self:center}.ws-stack code{font-size:.85em}.ws-stack .diagram-box{align-self:center;margin-top:4px}"
+<Diagram id="doc-block-1ckc1ao" title={"세 가지 범위, 하나의 유효 파일"} summary={"런타임은 읽기 시 작업 영역, 앱 및 개인 범위에서 동일한 경로를 확인합니다. 가장 구체적인 범위가 우선합니다."}>
+
+```html
+<div class="ws-stack">
+  <div class="diagram-card">
+    <span class="diagram-pill">Workspace</span
+    ><small class="diagram-muted">Dispatch의 회사 전체 기본값</small
+    ><code>context/brand.md</code>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill">조직 / 앱</span
+    ><small class="diagram-muted">team override for one app</small
+    ><code>context/brand.md</code>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill accent">Personal</span
+    ><small class="diagram-muted">per-user override &mdash; wins</small
+    ><code>context/brand.md</code>
+  </div>
+  <div class="diagram-arrow diagram-accent" aria-hidden="true">&rarr;</div>
+  <div class="diagram-box ok">Effective <code>context/brand.md</code></div>
+</div>
+```
+
+```css
+.ws-stack {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 8px;
+}
+.ws-stack .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 12px 16px;
+  min-width: 280px;
+}
+.ws-stack .diagram-arrow {
+  font-size: 20px;
+  align-self: center;
+}
+.ws-stack code {
+  font-size: 0.85em;
+}
+.ws-stack .diagram-box {
+  align-self: center;
+  margin-top: 4px;
 }
 ```
 
+</Diagram>
+
 ## 시작하기: 1분 둘러보기 {#getting-started}
 
 60초 안에 상담원의 행동 방식을 변경하세요.

package/docs/content/locales/ko-KR/writing-agent-instructions.mdx

@@ -7,13 +7,47 @@ description: "에이전트 기본 앱 또는 템플릿에 대한 훌륭한 에
 
 에이전트 기본 앱에서 에이전트의 행동은 사용자가 제공한 지침만큼만 좋습니다. 해당 지침은 `AGENTS.md`(지도), skills(심층 분석), 작업/도구 설명(에이전트가 올바른 도구를 선택하는 방법) 등 세 가지 표면에 전달됩니다. 산문이 아닌 빠른 검색을 위해 각각 작성하세요.
 
-```an-diagram title="작성된 표면 3개 + 런타임 표면 1개" summary="AGENTS.md 및 도구 설명은 매 턴마다 로드됩니다. 수요에 따른 기술 부하; application_state는 UI를 통해 실시간으로 작성됩니다."
-{
-  "html": "<div class=\"diagram-surfaces\"><div class=\"diagram-card always\" data-rough><span class=\"diagram-pill accent\">모든 턴</span><strong>AGENTS.md</strong><small class=\"diagram-muted\">지도: 목적, 핵심 규칙, 상태 키, action + skills 색인</small></div><div class=\"diagram-card always\" data-rough><span class=\"diagram-pill accent\">모든 턴</span><strong>도구 설명</strong><small class=\"diagram-muted\">도구 선택 유도 — 각각 정확한 한 문장</small></div><div class=\"diagram-card ondemand\" data-rough><span class=\"diagram-pill\">요청 시</span><strong>기술</strong><small class=\"diagram-muted\">상세 가이드, 설명이 맞을 때 로드</small></div><div class=\"diagram-card runtime\" data-rough><span class=\"diagram-pill ok\">Live</span><strong>application_state</strong><small class=\"diagram-muted\">UI가 작성: 탐색, 선택, 포커스</small></div></div>",
-  "css": ".diagram-surfaces{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px}.diagram-surfaces .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px}"
+<Diagram id="doc-block-z104n2" title={"작성된 표면 3개 + 런타임 표면 1개"} summary={"AGENTS.md 및 도구 설명은 매 턴마다 로드됩니다. 수요에 따른 기술 부하; application_state는 UI를 통해 실시간으로 작성됩니다."}>
+
+```html
+<div class="diagram-surfaces">
+  <div class="diagram-card always" data-rough>
+    <span class="diagram-pill accent">모든 턴</span><strong>AGENTS.md</strong
+    ><small class="diagram-muted"
+      >지도: 목적, 핵심 규칙, 상태 키, action + skills 색인</small
+    >
+  </div>
+  <div class="diagram-card always" data-rough>
+    <span class="diagram-pill accent">모든 턴</span><strong>도구 설명</strong
+    ><small class="diagram-muted">도구 선택 유도 — 각각 정확한 한 문장</small>
+  </div>
+  <div class="diagram-card ondemand" data-rough>
+    <span class="diagram-pill">요청 시</span><strong>기술</strong
+    ><small class="diagram-muted">상세 가이드, 설명이 맞을 때 로드</small>
+  </div>
+  <div class="diagram-card runtime" data-rough>
+    <span class="diagram-pill ok">Live</span><strong>application_state</strong
+    ><small class="diagram-muted">UI가 작성: 탐색, 선택, 포커스</small>
+  </div>
+</div>
+```
+
+```css
+.diagram-surfaces {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 12px;
+}
+.diagram-surfaces .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 14px 16px;
 }
 ```
 
+</Diagram>
+
 ## AGENTS.md를 작고 훑어볼 수 있도록 유지 {#small-agents-md}
 
 `AGENTS.md`가 방향으로 로드됩니다. 모든 것이 skills에 깊숙이 들어가 에이전트가 올바르게 작동할 수 있도록 하는 가장 작은 것이어야 합니다. 다음 섹션을 목표로 하세요:

package/docs/content/locales/pt-BR/a2a-protocol.mdx

@@ -20,13 +20,55 @@ Conceitos principais:
 - **Tarefas** — cada mensagem cria uma tarefa com um ciclo de vida (enviada, em funcionamento, concluída, com falha, cancelada)
 - **Autenticação do portador JWT** — a produção A2A requer `A2A_SECRET` ou um `apiKeyEnv` legado explícito
 
-```an-diagram title="Um agente passa o trabalho para outro" summary="Um agente de correio descobre o cartão do agente analítico, envia uma mensagem JSON-RPC e recebe de volta uma tarefa concluída."
-{
-  "html": "<div class=\"diagram-handoff\"><div class=\"diagram-card\"><strong>Agente Mail</strong><small class=\"diagram-muted\">needs analytics</small></div><div class=\"diagram-col\"><div class=\"diagram-pill\">GET /.well-known/agent-card.json</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill accent\">POST /_agent-native/a2a<br><small class=\"diagram-muted\">message/send</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&larr;</div><div class=\"diagram-pill ok\">tarefa · concluída</div></div><div class=\"diagram-card\" data-rough><strong>Agente Analytics</strong><small class=\"diagram-muted\">executa run-query e retorna o resultado</small></div></div>",
-  "css": ".diagram-handoff{display:flex;align-items:center;gap:16px;flex-wrap:wrap}.diagram-handoff .diagram-col{display:flex;flex-direction:column;align-items:center;gap:6px}.diagram-handoff .diagram-arrow{font-size:20px;line-height:1}"
+<Diagram id="doc-block-1txglhg" title="Um agente passa o trabalho para outro" summary={"Um agente de correio descobre o cartão do agente analítico, envia uma mensagem JSON-RPC e recebe de volta uma tarefa concluída."}>
+
+```html
+<div class="diagram-handoff">
+  <div class="diagram-card">
+    <strong>Agente Mail</strong
+    ><small class="diagram-muted">needs analytics</small>
+  </div>
+  <div class="diagram-col">
+    <div class="diagram-pill">GET /.well-known/agent-card.json</div>
+    <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+    <div class="diagram-pill accent">
+      POST /_agent-native/a2a<br /><small class="diagram-muted"
+        >message/send</small
+      >
+    </div>
+    <div class="diagram-arrow diagram-muted" aria-hidden="true">&larr;</div>
+    <div class="diagram-pill ok">tarefa · concluída</div>
+  </div>
+  <div class="diagram-card" data-rough>
+    <strong>Agente Analytics</strong
+    ><small class="diagram-muted"
+      >executa run-query e retorna o resultado</small
+    >
+  </div>
+</div>
+```
+
+```css
+.diagram-handoff {
+  display: flex;
+  align-items: center;
+  gap: 16px;
+  flex-wrap: wrap;
+}
+.diagram-handoff .diagram-col {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 6px;
+}
+.diagram-handoff .diagram-arrow {
+  font-size: 20px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 ## Configuração do servidor {#server-setup}
 
 A maioria dos modelos obtém A2A por meio do plugin de chat do agente de estrutura. Se você mesmo estiver montando, chame `mountA2A()` em um plugin de servidor:
@@ -176,14 +218,62 @@ JSON-RPC 2.0 endpoint for `message/send`, `message/stream`, `tasks/get`, and `ta
 
 Quando `message/send` é chamado com `async: true`, o manipulador JSON-RPC enfileira a tarefa e dispara automaticamente um POST para uma rota interna `/_agent-native/a2a/_process-task` para que o manipulador seja executado em uma nova execução de função com seu próprio tempo limite completo. Esta rota é autenticada com um token HMAC vinculado ao ID da tarefa (tempo de vida de 5 minutos, assinado com `A2A_SECRET`). Ele é montado antes da rota `/_agent-native/a2a` JSON-RPC para que a correspondência de prefixo de h3 não o engula.
 
-```an-diagram title="Ciclo de vida de tarefa assíncrona sem servidor" summary="async:true retorna funcionando em milissegundos e, em seguida, uma nova execução executa o loop do agente enquanto o chamador pesquisa."
-{
-  "html": "<div class=\"diagram-async\"><div class=\"diagram-box\" data-rough>message/send<br><small class=\"diagram-muted\">async: true</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel\"><span class=\"diagram-pill\">enqueue task</span><span class=\"diagram-pill warn\">return working</span><small class=\"diagram-muted\">~milissegundos</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>POST autoacionado /_agent-native/a2a/_process-task<br><small class=\"diagram-muted\">token HMAC · execução nova · timeout completo</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-pill\">tasks/get (poll)</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-pill ok\">completed</div></div></div>",
-  "css": ".diagram-async{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-async .diagram-panel{display:flex;flex-direction:column;align-items:center;gap:6px}.diagram-async .diagram-col{display:flex;flex-direction:column;align-items:center;gap:6px}.diagram-async .diagram-arrow{font-size:20px;line-height:1}",
-  "caption": "A recurring sweeper re-claims any task left in flight if the function execution dies mid-run."
+<Diagram id="doc-block-ksal9u" title={"Ciclo de vida de tarefa assíncrona sem servidor"} summary={"async:true retorna funcionando em milissegundos e, em seguida, uma nova execução executa o loop do agente enquanto o chamador pesquisa."} caption="A recurring sweeper re-claims any task left in flight if the function execution dies mid-run.">
+
+```html
+<div class="diagram-async">
+  <div class="diagram-box" data-rough>
+    message/send<br /><small class="diagram-muted">async: true</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-panel">
+    <span class="diagram-pill">enqueue task</span
+    ><span class="diagram-pill warn">return working</span
+    ><small class="diagram-muted">~milissegundos</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-box" data-rough>
+    POST autoacionado /_agent-native/a2a/_process-task<br /><small
+      class="diagram-muted"
+      >token HMAC · execução nova · timeout completo</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-col">
+    <div class="diagram-pill">tasks/get (poll)</div>
+    <div class="diagram-arrow diagram-muted" aria-hidden="true">&#8635;</div>
+    <div class="diagram-pill ok">completed</div>
+  </div>
+</div>
+```
+
+```css
+.diagram-async {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-async .diagram-panel {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 6px;
+}
+.diagram-async .diagram-col {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 6px;
+}
+.diagram-async .diagram-arrow {
+  font-size: 20px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 > [!IMPORTANT]
 > **Tempos limite de webhook e gateway sem servidor:**
 > Gateways de ambiente hospedado (como Netlify, Vercel ou Cloudflare Pages) impõem limites de execução rígidos (geralmente de 10 a 30 segundos) em rotas HTTP públicas. Como os loops de agente podem levar um tempo significativo para executar consultas, buscar contexto e executar ferramentas, você **deve usar `async: true`** ao chamar endpoints A2A ou manipular webhooks externo. Isso retorna imediatamente um status `working` para o gateway API, mantendo a conexão aberta apenas por alguns milissegundos, enquanto o `/process-task` POST autoacionado executa o loop do agente em segundo plano. Não bloqueie a solicitação HTTP primária aguardando a conclusão do loop do agente.

package/docs/content/locales/pt-BR/actions.mdx

@@ -19,13 +19,76 @@ Uma definição, sete consumidores. Este é o degrau 3 do [ladder](/docs/what-is
 Se você está decidindo se deseja expor uma operação sem cabeça, no chat, em um
 arquivo lateral incorporado ou como tela inteira do aplicativo, consulte [Agent Surfaces](/docs/agent-surfaces).
 
-```an-diagram title="Uma definição, sete consumidores" summary="Um único defineAction() se espalha por todas as superfícies — agente, UI, HTTP, MCP, A2A e CLI — com um esquema validado e um corpo run()."
-{
-  "html": "<div class=\"diagram-fanout\"><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">defineAction()</span><small class=\"diagram-muted\">schema + run(), definido uma vez</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-grid\"><div class=\"diagram-node\">Ferramenta do agente<br><small class=\"diagram-muted\">JSON Schema no contexto</small></div><div class=\"diagram-node\">Hooks React<br><small class=\"diagram-muted\">useActionQuery/Mutation</small></div><div class=\"diagram-node\">callAction()<br><small class=\"diagram-muted\">cliente imperativo</small></div><div class=\"diagram-node\">HTTP<br><small class=\"diagram-muted\">/_agent-native/actions/:name</small></div><div class=\"diagram-node\">Ferramenta MCP<br><small class=\"diagram-muted\">hosts externos</small></div><div class=\"diagram-node\">Ferramenta A2A<br><small class=\"diagram-muted\">outros apps agent-native</small></div><div class=\"diagram-node\">CLI<br><small class=\"diagram-muted\">pnpm action &lt;name&gt;</small></div></div></div>",
-  "css": ".diagram-fanout{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-fanout .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:14px 16px}.diagram-fanout .diagram-arrow{font-size:22px;line-height:1}.diagram-fanout .diagram-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px}"
+<Diagram id="doc-block-1sdcyx8" title={"Uma definição, sete consumidores"} summary={"Um único defineAction() se espalha por todas as superfícies — agente, UI, HTTP, MCP, A2A e CLI — com um esquema validado e um corpo run()."}>
+
+```html
+<div class="diagram-fanout">
+  <div class="diagram-panel center" data-rough>
+    <span class="diagram-pill accent">defineAction()</span
+    ><small class="diagram-muted">schema + run(), definido uma vez</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-grid">
+    <div class="diagram-node">
+      Ferramenta do agente<br /><small class="diagram-muted"
+        >JSON Schema no contexto</small
+      >
+    </div>
+    <div class="diagram-node">
+      Hooks React<br /><small class="diagram-muted"
+        >useActionQuery/Mutation</small
+      >
+    </div>
+    <div class="diagram-node">
+      callAction()<br /><small class="diagram-muted">cliente imperativo</small>
+    </div>
+    <div class="diagram-node">
+      HTTP<br /><small class="diagram-muted"
+        >/_agent-native/actions/:name</small
+      >
+    </div>
+    <div class="diagram-node">
+      Ferramenta MCP<br /><small class="diagram-muted">hosts externos</small>
+    </div>
+    <div class="diagram-node">
+      Ferramenta A2A<br /><small class="diagram-muted"
+        >outros apps agent-native</small
+      >
+    </div>
+    <div class="diagram-node">
+      CLI<br /><small class="diagram-muted">pnpm action &lt;name&gt;</small>
+    </div>
+  </div>
+</div>
+```
+
+```css
+.diagram-fanout {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-fanout .center {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
+  padding: 14px 16px;
+}
+.diagram-fanout .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
+}
+.diagram-fanout .diagram-grid {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 8px;
 }
 ```
 
+</Diagram>
+
 Se o UI e o agente precisarem fazer algo, tome uma ação, não uma ação personalizada
 rota. Para saber quando um protocolo em forma de rota _é_ a chamada certa, consulte [Preferir Actions
 Para operações de aplicativos](/docs/server#actions-first).