@agent-native/core 0.79.26 → 0.79.27

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

@@ -7,13 +7,48 @@ description: "모델의 스트리밍된 출력과 도구 호출을 중간에 관
 
 `Processor`는 에이전트 실행을 위한 루프 내부 **관찰자/가드레일**입니다. 모델의 스트리밍된 출력을 관찰하고 도구는 _실행이 진행됨에 따라_ 요청을 호출하고 자체 스크래치 상태를 유지하며 "완료"가 요청되기 전에 실행을 **중단**할 수 있습니다. 이는 실시간 가드레일(허용되지 않는 출력 미드스트림 차단) 및 완료 증명/커버리지 게이트(모델이 수행할 작업을 검사하고 중지)에 대한 구조적 전제 조건입니다.
 
-```an-diagram title="세 개의 갈고리가 달려가는 곳" summary="processOutputStream은 모든 청크를 감시하고, processOutputStep은 응답당 도구 호출을 게이트하고, processOutputResult는 마지막에 판정을 기록합니다. 모든 후크는 TripWire을 사용하여 중단할 수 있습니다."
-{
-  "html": "<div class=\"diagram-proc\"><div class=\"diagram-node\" data-rough>stream chunks<br><small class=\"diagram-muted\">processOutputStream</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\" data-rough>per model response<br><small class=\"diagram-muted\">processOutputStep — 도구 호출 제어</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\" data-rough>run end<br><small class=\"diagram-muted\">processOutputResult — 판정</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-pill warn\">abort() &rarr; TripWire &rarr; tripwire event</div></div>",
-  "css": ".diagram-proc{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-proc .diagram-arrow{font-size:22px;line-height:1}.diagram-proc .diagram-pill{flex-basis:100%}"
+<Diagram id="doc-block-1efxdmn" title={"세 개의 갈고리가 달려가는 곳"} summary={"processOutputStream은 모든 청크를 감시하고, processOutputStep은 응답당 도구 호출을 게이트하고, processOutputResult는 마지막에 판정을 기록합니다. 모든 후크는 TripWire을 사용하여 중단할 수 있습니다."}>
+
+```html
+<div class="diagram-proc">
+  <div class="diagram-node" data-rough>
+    stream chunks<br /><small class="diagram-muted">processOutputStream</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node" data-rough>
+    per model response<br /><small class="diagram-muted"
+      >processOutputStep — 도구 호출 제어</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node" data-rough>
+    run end<br /><small class="diagram-muted">processOutputResult — 판정</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-pill warn">
+    abort() &rarr; TripWire &rarr; tripwire event
+  </div>
+</div>
+```
+
+```css
+.diagram-proc {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+.diagram-proc .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
+}
+.diagram-proc .diagram-pill {
+  flex-basis: 100%;
 }
 ```
 
+</Diagram>
+
 > [!WARNING]
 > 프로세서는 **구성**이지 도구나 작업이 아니며 저작 DSL도 아닙니다. 프로세서는 자체 스트림 범위 상태와 `abort()`만 관찰하고 변경합니다. 앱 동작을 정의하거나 actions를 대체하거나 모델에 나타나지 않습니다. 앱 작업은 [actions](/docs/actions)에 속합니다.
 

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

@@ -41,13 +41,55 @@ await completeRun(run.id, run.owner, "succeeded");
 | `failed`    | 오류 터미널                     |
 | `cancelled` | 사용자가 방해했습니다           |
 
-```an-diagram title="수명 주기 실행" summary="startRun은 실행 중인 행을 엽니다. updateRunProgress가 이를 패치합니다. completeRun은 이를 하나의 터미널 상태로 이동하고 completed_at을 스탬프 처리합니다."
-{
-  "html": "<div class=\"diagram-run\"><div class=\"diagram-box\" data-rough>startRun()</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel running\" data-rough><span class=\"diagram-pill accent\">running</span><small class=\"diagram-muted\">updateRunProgress() &#8635; percent + step</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col terminal\"><span class=\"diagram-pill ok\">succeeded</span><span class=\"diagram-pill warn\">failed</span><span class=\"diagram-pill\">cancelled</span><small class=\"diagram-muted\">completeRun() &rarr; sets completed_at</small></div></div>",
-  "css": ".diagram-run{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-run .diagram-panel{display:flex;flex-direction:column;gap:6px;padding:12px 16px}.diagram-run .terminal{display:flex;flex-direction:column;gap:6px;align-items:flex-start}.diagram-run .diagram-arrow{font-size:22px;line-height:1}"
+<Diagram id="doc-block-1e1tyjk" title={"수명 주기 실행"} summary={"startRun은 실행 중인 행을 엽니다. updateRunProgress가 이를 패치합니다. completeRun은 이를 하나의 터미널 상태로 이동하고 completed_at을 스탬프 처리합니다."}>
+
+```html
+<div class="diagram-run">
+  <div class="diagram-box" data-rough>startRun()</div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-panel running" data-rough>
+    <span class="diagram-pill accent">running</span
+    ><small class="diagram-muted"
+      >updateRunProgress() &#8635; percent + step</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-col terminal">
+    <span class="diagram-pill ok">succeeded</span
+    ><span class="diagram-pill warn">failed</span
+    ><span class="diagram-pill">cancelled</span
+    ><small class="diagram-muted">completeRun() &rarr; sets completed_at</small>
+  </div>
+</div>
+```
+
+```css
+.diagram-run {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-run .diagram-panel {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 12px 16px;
+}
+.diagram-run .terminal {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  align-items: flex-start;
+}
+.diagram-run .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 종료 상태는 `completed_at`로 설정됩니다. UI 트레이에는 `running` 행만 표시됩니다. 완료된 행은 `action=list` 쿼리에 대해 데이터베이스에 유지됩니다.
 
 ## API {#api}

package/docs/content/locales/ko-KR/pure-agent-apps.mdx

@@ -12,13 +12,55 @@ Slack"에 대한 일일 측정항목 - 에이전트는 어디에서나 작동하
 속합니다. actions, 세션, 앱 상태, 기록 등은 여전히 실제 앱입니다.
 설정, 자격 증명 및 공유 기록은 모두 SQL에 있습니다.
 
-```an-diagram title="앱 에이전트 루프는 정문입니다" summary="많은 진입점이 SQL-backed 작업 및 상태에 대해 하나의 에이전트 루프에 도달합니다. 결과는 요청이 발생한 곳으로 반환됩니다. UI는 사람이 감독해야 하는 경우에만 추가됩니다."
-{
-  "html": "<div class=\"diagram-pure\"><div class=\"diagram-col\"><div class=\"diagram-pill\">Terminal</div><div class=\"diagram-pill\">Slack · 이메일</div><div class=\"diagram-pill\">예약 작업</div><div class=\"diagram-pill\">Another agent (A2A)</div><div class=\"diagram-pill\">Chat</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">앱 에이전트 루프</span><small class=\"diagram-muted\">작업 · 세션 · SQL의 앱 상태</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>결과 반환<br><small class=\"diagram-muted\">to where it belongs</small></div></div>",
-  "css": ".diagram-pure{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-pure .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-pure .diagram-arrow{font-size:22px;line-height:1}.diagram-pure .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+<Diagram id="doc-block-l28sgj" title={"앱 에이전트 루프는 정문입니다"} summary={"많은 진입점이 SQL-backed 작업 및 상태에 대해 하나의 에이전트 루프에 도달합니다. 결과는 요청이 발생한 곳으로 반환됩니다. UI는 사람이 감독해야 하는 경우에만 추가됩니다."}>
+
+```html
+<div class="diagram-pure">
+  <div class="diagram-col">
+    <div class="diagram-pill">Terminal</div>
+    <div class="diagram-pill">Slack · 이메일</div>
+    <div class="diagram-pill">예약 작업</div>
+    <div class="diagram-pill">Another agent (A2A)</div>
+    <div class="diagram-pill">Chat</div>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-panel center" data-rough>
+    <span class="diagram-pill accent">앱 에이전트 루프</span
+    ><small class="diagram-muted">작업 · 세션 · SQL의 앱 상태</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-box" data-rough>
+    결과 반환<br /><small class="diagram-muted">to where it belongs</small>
+  </div>
+</div>
+```
+
+```css
+.diagram-pure {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-pure .diagram-col {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.diagram-pure .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
+}
+.diagram-pure .center {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
 }
 ```
 
+</Diagram>
+
 작업이 백그라운드에서 실행될 때 이 모양에 도달하면 출력이
 앱, 도메인은 일회성이거나 프로토타입을 만드는 중입니다. 상담원은 여전히 UI가 필요합니다 —
 대시보드가 아니라 사람이 감독하고 구성하고 조종하는 장소 —

package/docs/content/locales/ko-KR/real-time-collaboration.mdx

@@ -36,13 +36,55 @@ description: "AI 에이전트가 최고 수준의 피어인 다중 사용자 공
 
 협업 시스템에는 5개의 연동 레이어가 있습니다.
 
-```an-diagram title="다섯 개의 연동 레이어" summary="인메모리 CRDT부터 피어 간에 업데이트를 전달하는 전송까지, 각 계층에는 하나의 작업이 있습니다."
-{
-  "html": "<div class=\"diagram-stack\"><div class=\"diagram-card layer\"><span class=\"diagram-pill accent\">1 &middot; Yjs Y.Doc</span><small class=\"diagram-muted\">CRDT &mdash; 충돌 없는 병합, 조정자 없음</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill\">2 &middot; SQL 표준 콘텐츠</span><small class=\"diagram-muted\">_collab_docs &mdash; durable source of truth, versioned</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill\">3 &middot; updatedAt 기준 조정</span><small class=\"diagram-muted\">에이전트 편집은 SQL bump를 통해 전파</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill\">4 &middot; 리드 클라이언트 선출</span><small class=\"diagram-muted\">정확히 하나의 탭이 스냅샷 적용</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill ok\">5 &middot; SSE 빠른 경로 + 폴링</span><small class=\"diagram-muted\">수십 ms 수준, 어디서나 2초 폴링으로 폴백</small></div></div>",
-  "css": ".diagram-stack{display:flex;flex-direction:column;gap:8px}.diagram-stack .layer{display:flex;flex-direction:column;gap:4px;padding:12px 14px}"
+<Diagram id="doc-block-ascsep" title={"다섯 개의 연동 레이어"} summary={"인메모리 CRDT부터 피어 간에 업데이트를 전달하는 전송까지, 각 계층에는 하나의 작업이 있습니다."}>
+
+```html
+<div class="diagram-stack">
+  <div class="diagram-card layer">
+    <span class="diagram-pill accent">1 &middot; Yjs Y.Doc</span
+    ><small class="diagram-muted"
+      >CRDT &mdash; 충돌 없는 병합, 조정자 없음</small
+    >
+  </div>
+  <div class="diagram-card layer">
+    <span class="diagram-pill">2 &middot; SQL 표준 콘텐츠</span
+    ><small class="diagram-muted"
+      >_collab_docs &mdash; durable source of truth, versioned</small
+    >
+  </div>
+  <div class="diagram-card layer">
+    <span class="diagram-pill">3 &middot; updatedAt 기준 조정</span
+    ><small class="diagram-muted">에이전트 편집은 SQL bump를 통해 전파</small>
+  </div>
+  <div class="diagram-card layer">
+    <span class="diagram-pill">4 &middot; 리드 클라이언트 선출</span
+    ><small class="diagram-muted">정확히 하나의 탭이 스냅샷 적용</small>
+  </div>
+  <div class="diagram-card layer">
+    <span class="diagram-pill ok">5 &middot; SSE 빠른 경로 + 폴링</span
+    ><small class="diagram-muted"
+      >수십 ms 수준, 어디서나 2초 폴링으로 폴백</small
+    >
+  </div>
+</div>
+```
+
+```css
+.diagram-stack {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.diagram-stack .layer {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 12px 14px;
 }
 ```
 
+</Diagram>
+
 ### 1. Yjs Y.Doc(CRDT 레이어)
 
 각 공동 작업 문서는 공유 유형을 포함하는 `Y.Doc`입니다. 일반적으로
@@ -100,13 +142,67 @@ actions 에이전트는 진행 중인 Yjs에 푸시하지 않습니다. 대신
 
 네트워크 오류는 최대 15초로 제한되는 지터가 있는 지수 백오프를 사용합니다.
 
-```an-diagram title="두 개의 편집 경로, 하나의 병합" summary="인간의 키 입력 흐름은 Y.Doc → 서버 → SSE입니다. 상담원 편집은 SQL을 거칩니다. 작업 범프가 업데이트되고 리드 클라이언트가 조정된 다음 변경 사항이 Yjs에 다시 들어갑니다."
-{
-  "html": "<div class=\"diagram-collab\"><div class=\"lane\"><span class=\"diagram-pill\">사람 편집</span><div class=\"diagram-node\">Y.Doc update<br><small class=\"diagram-muted\">debounce 약 80ms</small></div><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\" data-rough>POST /update<br><small class=\"diagram-muted\">apply + persist</small></div><span class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box diagram-accent\">SSE push<br><small class=\"diagram-muted\">to all peers</small></div></div><div class=\"lane\"><span class=\"diagram-pill warn\">에이전트 편집</span><div class=\"diagram-node\">Action이 SQL 작성<br><small class=\"diagram-muted\">updatedAt 업데이트</small></div><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\" data-rough>리드 클라이언트<br><small class=\"diagram-muted\">setContent를 Y.Doc에 적용</small></div><span class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box diagram-accent\">POST /update<br><small class=\"diagram-muted\">re-enters Yjs &middot; SSE push</small></div></div></div>",
-  "css": ".diagram-collab{display:flex;flex-direction:column;gap:14px}.diagram-collab .lane{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.diagram-collab .diagram-arrow{font-size:22px;line-height:1}"
+<Diagram id="doc-block-1jdtfow" title={"두 개의 편집 경로, 하나의 병합"} summary={"인간의 키 입력 흐름은 Y.Doc → 서버 → SSE입니다. 상담원 편집은 SQL을 거칩니다. 작업 범프가 업데이트되고 리드 클라이언트가 조정된 다음 변경 사항이 Yjs에 다시 들어갑니다."}>
+
+```html
+<div class="diagram-collab">
+  <div class="lane">
+    <span class="diagram-pill">사람 편집</span>
+    <div class="diagram-node">
+      Y.Doc update<br /><small class="diagram-muted">debounce 약 80ms</small>
+    </div>
+    <span class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</span>
+    <div class="diagram-box" data-rough>
+      POST /update<br /><small class="diagram-muted">apply + persist</small>
+    </div>
+    <span class="diagram-arrow diagram-accent" aria-hidden="true">&rarr;</span>
+    <div class="diagram-box diagram-accent">
+      SSE push<br /><small class="diagram-muted">to all peers</small>
+    </div>
+  </div>
+  <div class="lane">
+    <span class="diagram-pill warn">에이전트 편집</span>
+    <div class="diagram-node">
+      Action이 SQL 작성<br /><small class="diagram-muted"
+        >updatedAt 업데이트</small
+      >
+    </div>
+    <span class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</span>
+    <div class="diagram-box" data-rough>
+      리드 클라이언트<br /><small class="diagram-muted"
+        >setContent를 Y.Doc에 적용</small
+      >
+    </div>
+    <span class="diagram-arrow diagram-accent" aria-hidden="true">&rarr;</span>
+    <div class="diagram-box diagram-accent">
+      POST /update<br /><small class="diagram-muted"
+        >re-enters Yjs &middot; SSE push</small
+      >
+    </div>
+  </div>
+</div>
+```
+
+```css
+.diagram-collab {
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+}
+.diagram-collab .lane {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  flex-wrap: wrap;
+}
+.diagram-collab .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 ## 빠른 시작 {#quickstart}
 
 ### 1. 패키지 설치

package/docs/content/locales/ko-KR/recurring-jobs.mdx

@@ -113,13 +113,68 @@ Summarize overnight emails.`,
 
 스케줄러는 프로세스 내에서 실행되는 프레임워크 플러그인(내부 `processRecurringJobs()` 루틴)입니다. `setInterval`는 서버가 실행되는 위치에 관계없이 에이전트 채팅 플러그인 내에서 60초마다(10초의 시작 지연) 실행됩니다.
 
-```an-diagram title="스케줄러 틱 1개" summary="60초마다 스케줄러는 예정된 작업을 찾아 각각을 새로운 에이전트 스레드로 실행하고 결과를 다시 작업 파일에 기록합니다."
-{
-  "html": "<div class=\"sched\"><div class=\"diagram-box accent\"><code>setInterval</code> &bull; 60s &#8635;</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">1 &middot; scan</span><small class=\"diagram-muted\">list every enabled <code>jobs/*.md</code> across all owners</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">2 &middot; due?</span><small class=\"diagram-muted\">compare <code>nextRun</code> to now</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card accent\"><span class=\"diagram-pill accent\">3 &middot; run</span><small class=\"diagram-muted\">fresh agent thread, job body as the user message &mdash; actions, SQL, A2A, email</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card ok\"><span class=\"diagram-pill ok\">4 &middot; record</span><small class=\"diagram-muted\">write <code>lastRun</code> / <code>lastStatus</code> / <code>lastError</code>, recompute <code>nextRun</code></small></div></div>",
-  "css": ".sched{display:flex;flex-direction:column;gap:6px;max-width:520px}.sched .diagram-card{display:flex;flex-direction:column;gap:2px;padding:10px 14px}.sched .diagram-box{align-self:flex-start}.sched .diagram-arrow{font-size:18px;align-self:center}"
+<Diagram id="doc-block-pijs62" title={"스케줄러 틱 1개"} summary={"60초마다 스케줄러는 예정된 작업을 찾아 각각을 새로운 에이전트 스레드로 실행하고 결과를 다시 작업 파일에 기록합니다."}>
+
+```html
+<div class="sched">
+  <div class="diagram-box accent">
+    <code>setInterval</code> &bull; 60s &#8635;
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill">1 &middot; scan</span
+    ><small class="diagram-muted"
+      >list every enabled <code>jobs/*.md</code> across all owners</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill">2 &middot; due?</span
+    ><small class="diagram-muted">compare <code>nextRun</code> to now</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card accent">
+    <span class="diagram-pill accent">3 &middot; run</span
+    ><small class="diagram-muted"
+      >fresh agent thread, job body as the user message &mdash; actions, SQL,
+      A2A, email</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card ok">
+    <span class="diagram-pill ok">4 &middot; record</span
+    ><small class="diagram-muted"
+      >write <code>lastRun</code> / <code>lastStatus</code> /
+      <code>lastError</code>, recompute <code>nextRun</code></small
+    >
+  </div>
+</div>
+```
+
+```css
+.sched {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  max-width: 520px;
+}
+.sched .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  padding: 10px 14px;
+}
+.sched .diagram-box {
+  align-self: flex-start;
+}
+.sched .diagram-arrow {
+  font-size: 18px;
+  align-self: center;
 }
 ```
 
+</Diagram>
+
 <Callout id="doc-block-j6yn07" tone="risk">
 
 **Scale-to-zero caveat.** The scheduler is in-process, so on serverless hosts jobs only fire while an instance is warm. If reliable scheduling matters, keep an instance warm with keep-alive pings or use an always-on host (Fly, Render, a VPS).

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

@@ -21,14 +21,53 @@ description: "React 라우터 v8을 사용한 에이전트 기반 앱을 위한
 
 동적 매개변수의 경우 세그먼트 앞에 `$`를 붙입니다. 경로 없는 레이아웃 경로(URL 세그먼트 없음)로 만들려면 접두사 `_`를 붙입니다. 템플릿은 `flatRoutes()`를 사용합니다. 위의 점 표기법 파일이 기본입니다. 중첩 폴더 형식 `inbox/route.tsx`도 작동합니다.
 
-```an-diagram title="경로 없는 레이아웃이 페이지를 래핑합니다." summary="_app.tsx 레이아웃(URL 세그먼트 없음)은 공유 쉘을 한 번 렌더링합니다. 일치하는 페이지는 <Outlet/> 내부에서 렌더링되므로 탐색 시 에이전트 사이드바가 다시 탑재되지 않습니다."
-{
-"html": "<div class=\"diagram-layout\" data-rough><div class=\"diagram-shell\"><span class=\"diagram-pill accent\">_app.tsx</span><small class=\"diagram-muted\">경로 없는 레이아웃 · 지속 셸 + 에이전트 사이드바</small><div class=\"diagram-outlet\" data-rough><small class=\"diagram-muted\">&lt;Outlet/&gt; — the matched page</small><div class=\"diagram-row\"><span class=\"diagram-pill\">_index.tsx &rarr; /</span><span class=\"diagram-pill\">settings.tsx &rarr; /settings</span><span class=\"diagram-pill\">inbox.$threadId.tsx &rarr; /inbox/:threadId</span></div></div></div></div>",
-"css": ".diagram-layout .diagram-shell{display:flex;flex-direction:column;gap:8px;padding:16px}.diagram-layout .diagram-outlet{display:flex;flex-direction:column;gap:8px;padding:14px;margin-top:6px}.diagram-layout .diagram-row{display:flex;flex-wrap:wrap;gap:8px;margin-top:4px}"
-}
+<Diagram id="doc-block-lgrfn7" title={"경로 없는 레이아웃이 페이지를 래핑합니다."} summary={"_app.tsx 레이아웃(URL 세그먼트 없음)은 공유 쉘을 한 번 렌더링합니다. 일치하는 페이지는 <Outlet/> 내부에서 렌더링되므로 탐색 시 에이전트 사이드바가 다시 탑재되지 않습니다."}>
+
+```html
+<div class="diagram-layout" data-rough>
+  <div class="diagram-shell">
+    <span class="diagram-pill accent">_app.tsx</span
+    ><small class="diagram-muted"
+      >경로 없는 레이아웃 · 지속 셸 + 에이전트 사이드바</small
+    >
+    <div class="diagram-outlet" data-rough>
+      <small class="diagram-muted">&lt;Outlet/&gt; — the matched page</small>
+      <div class="diagram-row">
+        <span class="diagram-pill">_index.tsx &rarr; /</span
+        ><span class="diagram-pill">settings.tsx &rarr; /settings</span
+        ><span class="diagram-pill"
+          >inbox.$threadId.tsx &rarr; /inbox/:threadId</span
+        >
+      </div>
+    </div>
+  </div>
+</div>
+```
 
+```css
+.diagram-layout .diagram-shell {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 16px;
+}
+.diagram-layout .diagram-outlet {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 14px;
+  margin-top: 6px;
+}
+.diagram-layout .diagram-row {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  margin-top: 4px;
+}
 ```
 
+</Diagram>
+
 ## 새 페이지 추가 {#adding-a-page}
 
 파일 생성 및 기본 구성 요소 내보내기:

package/docs/content/locales/ko-KR/sandbox-adapters.mdx

@@ -40,13 +40,50 @@ Agent-Native에는 좁은 뒤에 있는 문제를 고려하는 두 개의 어댑
 
 계약을 좁게 유지한다는 것은 원격 어댑터가 동일한 보안 상태를 상속한다는 것을 의미합니다. 상위 프로세스는 비밀이 포함된 모든 것에 대한 소유권을 유지합니다. 즉, 샌드박스 모듈을 빌드하고, localhost 브리지(요청 컨텍스트를 보유하고 호스트 허용 목록 + SSRF 가드를 적용함)를 실행하고, 환경을 스크러빙하고 출력 형식을 지정합니다. 어댑터는 이미 준비된 **비밀이 아닌** 모듈 소스와 리소스 제한만 수신합니다. 어댑터는 이를 *실행*하고 stdout/stderr/exit 상태를 캡처하는 역할만 담당합니다.
 
-```an-diagram title="부모는 비밀을 유지합니다. 어댑터는 코드만 실행합니다." summary="실행 코드는 모듈을 빌드하고 루프백 브리지를 실행합니다. 어댑터는 비밀이 아닌 모듈 + 제한을 수신하고 stdout/stderr/exit을 반환합니다."
-{
-  "html": "<div class=\"diagram-sandbox\"><div class=\"diagram-box\" data-rough><strong>부모 프로세스</strong><small class=\"diagram-muted\">모듈 빌드 · loopback 브리지 · env 정리 · 출력 형식</small></div><div class=\"diagram-col\"><div class=\"diagram-pill accent\">non-secret module + limits &rarr;</div><div class=\"diagram-pill ok\">&larr; stdout / stderr / exitCode</div><div class=\"diagram-pill\">&harr; bridge calls (127.0.0.1)</div></div><div class=\"diagram-panel center\" data-rough><strong>SandboxAdapter.run</strong><small class=\"diagram-muted\">로컬 자식 · Docker · 원격 · 지속</small></div></div>",
-  "css": ".diagram-sandbox{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-sandbox .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-sandbox .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+<Diagram id="doc-block-yzbzgh" title={"부모는 비밀을 유지합니다. 어댑터는 코드만 실행합니다."} summary={"실행 코드는 모듈을 빌드하고 루프백 브리지를 실행합니다. 어댑터는 비밀이 아닌 모듈 + 제한을 수신하고 stdout/stderr/exit을 반환합니다."}>
+
+```html
+<div class="diagram-sandbox">
+  <div class="diagram-box" data-rough>
+    <strong>부모 프로세스</strong
+    ><small class="diagram-muted"
+      >모듈 빌드 · loopback 브리지 · env 정리 · 출력 형식</small
+    >
+  </div>
+  <div class="diagram-col">
+    <div class="diagram-pill accent">non-secret module + limits &rarr;</div>
+    <div class="diagram-pill ok">&larr; stdout / stderr / exitCode</div>
+    <div class="diagram-pill">&harr; bridge calls (127.0.0.1)</div>
+  </div>
+  <div class="diagram-panel center" data-rough>
+    <strong>SandboxAdapter.run</strong
+    ><small class="diagram-muted">로컬 자식 · Docker · 원격 · 지속</small>
+  </div>
+</div>
+```
+
+```css
+.diagram-sandbox {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-sandbox .diagram-col {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.diagram-sandbox .center {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
 }
 ```
 
+</Diagram>
+
 ## 인터페이스 {#interface}
 
 심은 `packages/core/src/coding-tools/sandbox/` — `adapter.ts`(계약), `index.ts`(선택: `getSandboxAdapter()` / `registerSandboxAdapter()`) 및 `local-child-process-adapter.ts`(기본값)의 코어에 있습니다. `run-code.ts`에 의해 패키지 내로 배선됩니다. 호스트는 `index.ts` 등록 도우미를 통해(또는 Docker 백엔드의 경우 이러한 파일을 직접 편집하는 [blueprint](/docs/blueprint-installer)를 통해) 다른 백엔드에 연결됩니다.

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

@@ -9,13 +9,45 @@ description: "에이전트 네이티브 앱의 보안 모델: 입력 유효성
 
 ## 무료로 얻는 것과 소유한 것 {#what-you-own}
 
-```an-diagram title="계층별 방어" summary="프레임워크는 대부분의 위협 표면을 소유합니다. 당신은 외부 입력의 범위 지정 및 유효성 검사를 위한 태그 지정 테이블이라는 두 가지를 소유하고 있습니다."
-{
-  "html": "<div class=\"sec-layers\"><div class=\"diagram-card free\"><span class=\"diagram-pill ok\">프레임워크 소유</span><small class=\"diagram-muted\">SQL isolation &middot; parameterized queries &middot; XSS escaping &middot; auth guard &middot; CSRF cookies &middot; secret encryption</small></div><div class=\"diagram-card you\"><span class=\"diagram-pill warn\">직접 소유</span><small class=\"diagram-muted\">A. tag tables with ownableColumns() &amp; route through access guards<br>B. give every action a Zod schema &amp; send user URLs through the SSRF guard</small></div></div>",
-  "css": ".sec-layers{display:flex;flex-direction:column;gap:12px}.sec-layers .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px}"
+<Diagram id="doc-block-30s6xp" title={"계층별 방어"} summary={"프레임워크는 대부분의 위협 표면을 소유합니다. 당신은 외부 입력의 범위 지정 및 유효성 검사를 위한 태그 지정 테이블이라는 두 가지를 소유하고 있습니다."}>
+
+```html
+<div class="sec-layers">
+  <div class="diagram-card free">
+    <span class="diagram-pill ok">프레임워크 소유</span
+    ><small class="diagram-muted"
+      >SQL isolation &middot; parameterized queries &middot; XSS escaping
+      &middot; auth guard &middot; CSRF cookies &middot; secret
+      encryption</small
+    >
+  </div>
+  <div class="diagram-card you">
+    <span class="diagram-pill warn">직접 소유</span
+    ><small class="diagram-muted"
+      >A. tag tables with ownableColumns() &amp; route through access guards<br />B.
+      give every action a Zod schema &amp; send user URLs through the SSRF
+      guard</small
+    >
+  </div>
+</div>
+```
+
+```css
+.sec-layers {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+.sec-layers .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 14px 16px;
 }
 ```
 
+</Diagram>
+
 표준 패턴을 기반으로 구축하면 프레임워크가 이미 대부분의 위협 표면을 처리합니다.
 
 - **데이터 격리** — 에이전트 SQL가 다시 작성되어 현재 사용자(및 활성 조직)의 행만 볼 수 있습니다. [Data Scoping](#data-scoping)를 참조하세요.
@@ -122,13 +154,51 @@ const res = await ssrfSafeFetch(userProvidedUrl, {}, { maxRedirects: 3 });
 session.orgId → AGENT_ORG_ID → SQL row scoping
 ```
 
-```an-diagram title="범위 지정 파이프라인" summary="SQL 에이전트는 기본 테이블을 직접 건드리지 않습니다. 현재 ID로 범위가 지정된 임시 뷰를 통해 읽으므로 기본 테이블 이름은 소유한 행만 반환할 수 있습니다."
-{
-  "html": "<div class=\"scope-pipe\"><div class=\"diagram-node\">로그인된 세션<br><small class=\"diagram-muted\">email &middot; orgId</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">Request context<br><small class=\"diagram-muted\">AGENT_ORG_ID</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Temporary VIEW<br><small class=\"diagram-muted\">WHERE owner_email = ? AND org_id = ?</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node ok\">에이전트 SQL<br><small class=\"diagram-muted\">bare table names only</small></div></div>",
-  "css": ".scope-pipe{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.scope-pipe .diagram-node{display:flex;flex-direction:column;gap:2px;padding:10px 14px}.scope-pipe .diagram-arrow{font-size:22px;line-height:1}"
+<Diagram id="doc-block-adkvgz" title={"범위 지정 파이프라인"} summary={"SQL 에이전트는 기본 테이블을 직접 건드리지 않습니다. 현재 ID로 범위가 지정된 임시 뷰를 통해 읽으므로 기본 테이블 이름은 소유한 행만 반환할 수 있습니다."}>
+
+```html
+<div class="scope-pipe">
+  <div class="diagram-node">
+    로그인된 세션<br /><small class="diagram-muted">email &middot; orgId</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node">
+    Request context<br /><small class="diagram-muted">AGENT_ORG_ID</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-box">
+    Temporary VIEW<br /><small class="diagram-muted"
+      >WHERE owner_email = ? AND org_id = ?</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node ok">
+    에이전트 SQL<br /><small class="diagram-muted">bare table names only</small>
+  </div>
+</div>
+```
+
+```css
+.scope-pipe {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+.scope-pipe .diagram-node {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  padding: 10px 14px;
+}
+.scope-pipe .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 로그인된 세션은 `email` 및 (조직이 활성화된 경우) `orgId`를 전달합니다. 프레임워크는 해당 세션에서 요청 컨텍스트를 설정하고, 활성 조직을 에이전트 SQL에 `AGENT_ORG_ID`로 노출하고, 현재 ID가 소유한 행만 볼 수 있도록 모든 쿼리를 다시 작성합니다. 쿼리가 UI, 작업 또는 에이전트에서 발생하는지 여부에 관계없이 동일한 경로가 적용됩니다. 에이전트는 사용자가 구성원이 아닌 조직에 대한 데이터를 읽을 수 없습니다.
 
 ### 사용자별 범위 지정(`owner_email`)