@agent-native/core 0.93.0 → 0.94.0

package/corpus/core/docs/content/locales/ko-KR/actions.mdx

@@ -11,7 +11,7 @@ Actions는 앱이 수행하는 모든 작업에 대한 단일 정보 소스입
 - **Typesafe 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를 통해 다른 에이전트 기반 앱에서 호출됩니다.
 - **CLI 명령** — 스크립팅 및 개발 루프용 `pnpm action <name>`.
 
@@ -558,7 +558,7 @@ export default defineAction({
 });
 ```
 
-CLI 및 비UI MCP 클라이언트에 대한 대체 항목으로 `link`를 유지합니다. 이는 또한 임베드의 실행 목표이기도 합니다. The embed bridge — the signed embed-start session, transplant vs. controlled-frame rendering, the `ui/*` host bridge, CSP, and height clamping — is owned by [External Agents](/docs/external-agents#mcp-app-bridge).
+CLI 및 비UI MCP 호스트에 대한 대체 항목으로 `link`를 유지합니다. 이는 또한 임베드의 실행 목표이기도 합니다. The embed bridge — the signed embed-start session, transplant vs. controlled-frame rendering, the `ui/*` host bridge, CSP, and height clamping — is owned by [External Agents](/docs/external-agents#mcp-app-bridge).
 
 ## 표준 actions {#standard-actions}
 

package/corpus/core/docs/content/locales/ko-KR/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/ko-KR/agent-surfaces.mdx

@@ -139,8 +139,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";
 
@@ -493,12 +492,11 @@ actions 주변 또는 도메인 [template](/docs/cloneable-saas)에서
 채팅에 풍부한 UI가 필요한 경우 위젯 결과를 제공하고 사용자가 있는 경우에만 전체 화면을 추가합니다.
 영구 객체를 탐색, 비교, 구성 또는 공동 작업해야 합니다.
 
-## 관련 문서 {#related-docs}
+## 다음 단계 {#related-docs}
 
-- [Actions](/docs/actions) — 헤드리스 작업을 한 번 정의합니다.
-- [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) — 임시 또는 영구 sandbox 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/ko-KR/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/ko-KR/authentication.mdx

@@ -15,7 +15,7 @@ description: "이메일/비밀번호, 소셜 공급자, 조직 및 MCP 보유자
 - **원격 MCP OAuth:** Claude 코드 및 ChatGPT 커넥터와 같은 MCP 호스트용 표준 OAuth 2.1.
 - **사용자 정의:** `getSession` 콜백을 통해 자신만의 인증을 가져옵니다.
 
-<Diagram id="doc-block-14pt28n" title={"세 가지 방법으로 하나의 세션"} summary={"브라우저 방문자, 프로그래밍 방식의 MCP 클라이언트 및 사용자 정의 공급자는 모두 다운스트림 범위 지정이 읽는 동일한 AuthSession을 확인합니다."}>
+<Diagram id="doc-block-14pt28n" title={"세 가지 방법으로 하나의 세션"} summary={"브라우저 방문자, MCP 호스트 및 사용자 정의 공급자는 모두 다운스트림 범위 지정이 읽는 동일한 AuthSession을 확인합니다."}>
 
 ```html
 <div class="auth-modes">

package/corpus/core/docs/content/locales/ko-KR/components.mdx

@@ -470,10 +470,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,
@@ -488,3 +490,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/ko-KR/creating-templates.mdx

@@ -44,7 +44,6 @@ Chat은 인증, 내구성 있는 채팅 스레드, SQL 지원 리소스, 도구,
 <FileTree
   id="doc-block-1sjtdow"
   title={"템플릿 프로젝트 구조"}
-  title="my-template/"
   entries={[
     {
       path: "app/",
@@ -172,8 +171,7 @@ Chat은 인증, 내구성 있는 채팅 스레드, SQL 지원 리소스, 도구,
 
 SQLite, Postgres, D1, Turso, Supabase, Neon 및 기타 지원되는 백엔드에서 스키마 이식성을 유지할 수 있도록 프레임워크 Drizzle 도우미를 사용하여 도메인 테이블을 정의하세요.
 
-```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 쿼리 매개변수에 공유 가능한 필터를 유지합니다. 프레임
 URL가 알려진 경우 `path`. 동일한 동작에 `__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/ko-KR/cross-app-sso.mdx

@@ -9,7 +9,11 @@ description: "Dispatch를 ID 기관으로 사용하여 ID 페더레이션을 통
 
 이것은 이미 사용하고 있는 동일한 신뢰 기본 요소 [A2A](/docs/a2a-protocol) 및 [External Agents](/docs/external-agents)(요청 경계에서 확인된 `A2A_SECRET` 서명 JWT)로 에이전트 간 호출 대신 인간 로그인 경로에 적용됩니다.
 
-> **통합 배포와 도메인별 배포.** 하나의 원본(`your-agents.com/mail`, `your-agents.com/calendar`)에서 모든 앱을 호스팅하는 경우 이미 단일 쿠키 도메인을 통해 공유 로그인을 받고 있으므로 페더레이션이 필요하지 않습니다. Cross-App SSO는 앱이 별도의 도메인에서 실행되는 경우에만 필요합니다. [Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment)를 참조하세요.
+<Callout tone="info">
+
+**통합 배포와 도메인별 배포.** 하나의 원본(`your-agents.com/mail`, `your-agents.com/calendar`)에서 모든 앱을 호스팅하는 경우 이미 단일 쿠키 도메인을 통해 공유 로그인을 받고 있으므로 페더레이션이 필요하지 않습니다. Cross-App SSO는 앱이 별도의 도메인에서 실행되는 경우에만 필요합니다. [Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment)를 참조하세요.
+
+</Callout>
 
 ## 무엇과 이유 {#what-why}
 
@@ -86,15 +90,17 @@ description: "Dispatch를 ID 기관으로 사용하여 ID 페더레이션을 통
 
 </Diagram>
 
-1. **앱 → 디스패치(승인).** 앱이 사용자를 신원 인증 기관으로 보냅니다:
+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-ko-kr" 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`를 검사한 다음 **확인된 이메일만으로 적시 연결**을 수행합니다.
    - 해당 이메일을 가진 로컬 사용자가 존재하는 경우 → 변경하지 않고 다시 사용하세요.
    - 그렇지 않은 경우 → 해당 이메일에 대한 로컬 사용자를 생성하세요.
 
@@ -292,9 +298,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/ko-KR/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/ko-KR/external-agents.mdx

@@ -136,13 +136,8 @@ OAuth 토큰. ChatGPT는 검토 또는 게시된 커넥터 도구를 유지할
 도구 또는 MCP 앱 메타데이터가 변경되었습니다. 아직 오래된 앱별 커넥터가 있는 경우
 각 오래된 커넥터를 디스패치, 새로 고치거나 다시 연결하는 것과 함께 활성화됩니다. 업데이트 중
 디스패치는 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/ko-KR/key-concepts.mdx

@@ -11,11 +11,9 @@ description: "에이전트 네이티브 앱 작동 방식: actions 우선, SQL
 
 모든 에이전트 기반 앱은 세 가지가 함께 작동합니다.
 
-> **에이전트** — 데이터를 읽고, 쓰고, actions를 실행하고, 코드를 수정하는 자율 AI입니다. skills 및 지침으로 사용자 정의할 수 있습니다.
->
-> **적용** — 에이전트 주변의 제품 표면. 처음에는 작업만 수행할 수도 있고, 풍부한 채팅, 작은 제어 영역 또는 대시보드, 흐름, 시각화가 포함된 전체 React UI 화면일 수도 있습니다.
->
-> **컴퓨터** — 데이터베이스, 브라우저, 코드 실행. 에이전트는 SQL 및 내장 도구를 사용하여 직접 작업합니다. MCP 서버는 기본이 아닌 선택적인 추가 기능입니다.
+- **에이전트** — 데이터를 읽고, 쓰고, actions를 실행하고, 코드를 수정하는 자율 AI입니다. skills 및 지침으로 사용자 정의할 수 있습니다.
+- **적용** — 에이전트 주변의 제품 표면. 처음에는 작업만 수행할 수도 있고, 풍부한 채팅, 작은 제어 영역 또는 대시보드, 흐름, 시각화가 포함된 전체 React UI 화면일 수도 있습니다.
+- **컴퓨터** — 데이터베이스, 브라우저, 코드 실행. 에이전트는 SQL 및 내장 도구를 사용하여 직접 작업합니다. MCP 서버는 기본이 아닌 선택적인 추가 기능입니다.
 
 <Diagram id="doc-block-nxqkcw" title={"에이전트, 애플리케이션 및 컴퓨터"} summary={"하나의 공유 SQL 저장소에서 세 개의 레이어가 함께 작동합니다. 에이전트와 애플리케이션은 모두 동일한 데이터를 읽고 씁니다."}>
 
@@ -278,8 +276,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";
 
@@ -381,9 +378,8 @@ useDbSync({ queryClient });
 
 에이전트 네이티브 앱에는 UI 앱과 함께 AI 에이전트를 제공하는 내장형 에이전트 패널이 포함되어 있습니다. 이것이 아키텍처가 작동하는 이유입니다. 에이전트에는 컴퓨터(데이터베이스, 브라우저, 코드 실행)가 필요하고 앱에는 AI 작업을 위한 에이전트가 필요합니다.
 
-> **내장형 에이전트 패널** — 모든 앱에 채팅 및 선택적 CLI 터미널이 내장되어 있습니다. Claude 코드, Codex, Gemini, OpenCode 및 Builder.io를 지원합니다. 로컬로 실행됩니다. 무료 오픈 소스.
->
-> **클라우드** — 실시간 공동 작업, 시각적 편집, 역할 및 권한을 통해 모든 클라우드에 배포합니다. 팀에 가장 적합합니다.
+- **내장형 에이전트 패널** — 모든 앱에 채팅 및 선택적 CLI 터미널이 내장되어 있습니다. Claude 코드, Codex, Gemini, OpenCode 및 Builder.io를 지원합니다. 로컬로 실행됩니다. 무료 오픈 소스.
+- **클라우드** — 실시간 공동 작업, 시각적 편집, 역할 및 권한을 통해 모든 클라우드에 배포합니다. 팀에 가장 적합합니다.
 
 ## 상황 인식 {#context-awareness}
 
@@ -455,14 +451,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, 구성 요소 및 자격 증명을 사용하여 하나의 단일 저장소에서 여러 앱을 호스팅합니다.
+- [**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/ko-KR/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-7qqrxz" 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를 사용하여 하나의 단일 저장소에서 여러 에이전트 기반 앱 호스팅
+- [**Authentication**](/docs/authentication#organizations) — 세션, 소셜 제공자 및 조직 관리 표면
+- [**Security — Data Scoping**](/docs/security#data-scoping) — SQL 수준 격리, `ownableColumns()` 계약 및 액세스 가드
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — 공유 인증 및 RBAC로 하나의 monorepo에서 여러 Agent-Native 앱을 호스팅합니다

package/corpus/core/docs/content/locales/ko-KR/notifications.mdx

@@ -113,6 +113,7 @@ await notify(
 | `inbox`   | `notifications` 테이블에 유지됩니다. 종 UI를 운전 | 항상 켜짐 — 기본 요소의 일부.                                   |
 | `webhook` | POST JSON를 구성된 URL로                          | 시작 시 `NOTIFICATIONS_WEBHOOK_URL` 환경 변수가 설정되었습니다. |
 
+이메일, Slack, webhook은 받은 편지함과 함께 항상 등록됩니다. 전송 시 알림별 메타데이터의 URL/수신자를 우선 사용하고, 그다음 일치하는 환경 변수로 대체합니다. 둘 다 설정되지 않으면 해당 채널은 알림 전송 시 아무 작업도 하지 않습니다.
 웹훅 채널은 소유자의 임시 [secrets](/docs/security)에 대해 URL 및 `NOTIFICATIONS_WEBHOOK_AUTH` 모두에서 `${keys.NAME}` 참조를 확인하므로 원시 값이 에이전트의 컨텍스트에 입력되지 않습니다. 키별 URL 허용 목록이 시행됩니다. 이는 자동화 `web-request` 도구에서 사용하는 것과 동일한 규칙입니다.
 
 <Diagram id="doc-block-1lw1rdr" title={"채널 및 심각도"} summary={"받은 편지함은 항상 켜져 있습니다. 웹훅에는 환경 변수가 필요합니다. 맞춤 채널은 시작 시 등록됩니다. 심각도는 배지 스타일을 결정하고 모든 채널에 전달됩니다."}>
@@ -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-1232thx" 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-1232thx" 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() {

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

@@ -49,8 +49,11 @@ description: "모델의 스트리밍된 출력과 도구 호출을 중간에 관
 
 </Diagram>
 
-> [!WARNING]
-> 프로세서는 **구성**이지 도구나 작업이 아니며 저작 DSL도 아닙니다. 프로세서는 자체 스트림 범위 상태와 `abort()`만 관찰하고 변경합니다. 앱 동작을 정의하거나 actions를 대체하거나 모델에 나타나지 않습니다. 앱 작업은 [actions](/docs/actions)에 속합니다.
+<Callout id="doc-block-proc1cfg" tone="warning">
+
+프로세서는 **구성**이지 도구나 작업이 아니며 저작 DSL도 아닙니다. 프로세서는 자체 스트림 범위 상태와 `abort()`만 관찰하고 변경합니다. 앱 동작을 정의하거나 actions를 대체하거나 모델에 나타나지 않습니다. 앱 작업은 [actions](/docs/actions)에 속합니다.
+
+</Callout>
 
 ## 후크 {#hooks}
 
@@ -131,10 +134,13 @@ await runAgentLoop({
 
 **사용하지 않을 때 오버헤드가 없습니다.** 루프는 하나 이상의 프로세서가 제공되는 경우에만 프로세서 체인을 구축합니다. `processors`가 생략되거나 비어 있으면 이음매 코드가 실행되지 않으며 루프는 바이트 단위로 변경되지 않습니다. 후크는 등록 순서에 따라 실행되며 동기화되거나 비동기화될 수 있습니다.
 
-> [!NOTE]
-> 루프 수준 이음매는 현재 제공 가능하며 하위 에이전트, A2A, MCP 및 테스트에서 직접 호출할 수 있습니다. HTTP 채팅 핸들러를 통해 `processors`를 스레딩하는 것(요청별 확인자가 `runAgentLoop`를 직접 호출하지 않고 구성할 수 있도록)은 아직 연결되지 않은 편리한 배관입니다. 지금은 `runAgentLoop` 호출 사이트에서 프로세서를 구성하세요.
+<Callout id="doc-block-proc1note" tone="info">
+
+루프 수준 이음매는 현재 제공 가능하며 하위 에이전트, A2A, MCP 및 테스트에서 직접 호출할 수 있습니다. HTTP 채팅 핸들러를 통해 `processors`를 스레딩하는 것(요청별 확인자가 `runAgentLoop`를 직접 호출하지 않고 구성할 수 있도록)은 아직 연결되지 않은 편리한 배관입니다. 지금은 `runAgentLoop` 호출 사이트에서 프로세서를 구성하세요.
+
+</Callout>
 
-## 관련
+## 다음 단계
 
 - [**Durable Resume**](/docs/durable-resume) — 완료된 부작용을 다시 실행하지 않고 루프가 중단을 견디는 방법
 - [**Custom Agents & Teams**](/docs/agent-teams) — 하위 에이전트는 동일한 루프를 실행하며 자체 프로세서를 보유할 수 있습니다.

package/corpus/core/docs/content/locales/ko-KR/server.mdx

@@ -94,8 +94,7 @@ server/routes/
 
 각 경로는 `defineEventHandler`를 내보냅니다.
 
-```ts
-// server/routes/api/health.get.ts
+```ts filename="server/routes/api/health.get.ts"
 import { defineEventHandler } from "h3";
 
 export default defineEventHandler(() => ({
@@ -135,8 +134,7 @@ UI와 에이전트가 모두 작업을 수행해야 하는 경우 사용자 지
 
 읽기 전용 상태 endpoint는 action으로 유지하세요:
 
-```ts
-// actions/get-status.ts
+```ts filename="actions/get-status.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -169,8 +167,7 @@ GET /_agent-native/actions/get-status?service=billing
 도구, 채팅 기록 또는 실행 상태에서는 `completeText()`를 명시적 이스케이프로 사용
 해치.
 
-```ts
-// actions/classify-message.ts
+```ts filename="actions/classify-message.ts"
 import { defineAction } from "@agent-native/core/action";
 import { completeText } from "@agent-native/core/server";
 import { z } from "zod";
@@ -235,8 +232,7 @@ UI와 에이전트는 동일한 기능을 공유합니다.
 
 플러그인은 `server/plugins/`에 있으며 시작 시 실행됩니다. 마이그레이션, 공급자 설정, 반복 작업, 통합 어댑터 및 프레임워크 플러그인 구성에 사용하세요.
 
-```ts
-// server/plugins/db.ts
+```ts filename="server/plugins/db.ts"
 import { runMigrations } from "@agent-native/core/db";
 
 export default runMigrations(
@@ -414,8 +410,11 @@ export default runMigrations(
 
 </Diagram>
 
-> [!WARNING]
-> 응답을 반환한 후 기다리지 않은 약속에 의존하지 마십시오. 서버리스 호스트는 실행을 정지시킵니다. 정식 통합 대기열은 [Messaging](/docs/messaging)를 참조하세요.
+<Callout tone="warning">
+  응답을 반환한 후 기다리지 않은 약속에 의존하지 마십시오. 서버리스 호스트는
+  실행을 정지시킵니다. 정식 통합 대기열은 [Messaging](/docs/messaging)를
+  참조하세요.
+</Callout>
 
 ## 고급: 탈출 해치 {#advanced-escape-hatches}
 
@@ -457,3 +456,11 @@ const handler = createProductionAgentHandler({
   systemPrompt: "You are the app agent...",
 });
 ```
+
+## 다음 단계
+
+- [**Actions**](/docs/actions) — 기본 작업 표면이며, 여기에 맞지 않을 때만 사용자 지정 경로를 사용합니다
+- [**Database**](/docs/database) — 사용자 지정 경로와 작업이 모두 가져오는 `getDb()`/`schema` 패턴
+- [**Security**](/docs/security#access-guards) — `accessFilter`/`assertAccess`와 전체 데이터 범위 지정 모델
+- [**Messaging**](/docs/messaging) — 인바운드 webhook을 위한 표준 통합 큐 패턴
+- [**MCP Protocol**](/docs/mcp-protocol) — 이 서버가 자동으로 마운트하는 `/_agent-native/mcp` 엔드포인트

package/corpus/core/docs/content/locales/ko-KR/sharing.mdx

@@ -1,13 +1,13 @@
 ---
 title: "공유 및 개인정보 보호"
-description: "프레임워크에 내장된 Google-Docs 스타일 공유. 문서, 대시보드, 디자인, 데크, 클립, 녹음, 양식 등 사용자가 생성한 모든 리소스는 하나의 일관된 공유 UI를 통해 기본적으로 동일한 비공개 모델을 얻습니다."
+description: "프레임워크에 내장된 익숙하고 일관된 공유 기능입니다. 문서, 대시보드, 디자인, 자료, 클립, 녹화, 양식 등 사용자가 만든 모든 리소스에 동일한 기본 비공개 모델과 일관된 공유 UI가 적용됩니다."
 ---
 
 # 공유 및 개인정보 보호
 
 문서, 대시보드, 디자인, 데크, 화면 녹화, 회의 기록, 양식, 예약 링크 등 사용자가 에이전트 기반 앱에서 생성하는 모든 리소스는 **기본적으로 작성자에게 공개됩니다**. 다른 사람들은 작성자가 명시적으로 공유하거나 공개 상태를 `org` 또는 `public`로 변경한 경우에만 볼 수 있습니다.
 
-Google 문서도구처럼 보이고 작동합니다. 동일한 공유 버튼, 동일한 대화 상자, 동일한 3계층 가시성 모델, 동일한 사용자별/조직별 부여 — 앱별 재창조 없이 모든 템플릿에 적용됩니다.
+어디서나 하나의 익숙한 공유 모델을 사용합니다. 모든 템플릿에서 앱별로 새로 만들 필요 없이 동일한 공유 버튼, 동일한 대화 상자, 동일한 3단계 공개 범위 모델, 동일한 사용자별/조직별 권한 부여를 사용합니다.
 
 ## 왜 하나의 모델 {#why}
 
@@ -92,7 +92,7 @@ Google 문서도구처럼 보이고 작동합니다. 동일한 공유 버튼,
 - **콘텐츠** — 문서
 - **슬라이드** — 자료
 - **디자인** — 디자인 및 자산
-- **클립** — 화면 녹화(Loom 스타일)
+- **클립** — 화면 녹화
 - **Plan** — visual plans and PR recaps
 - **양식** — 양식 정의
 - **캘린더** — 이벤트 및 예약 링크
@@ -115,7 +115,7 @@ Google 문서도구처럼 보이고 작동합니다. 동일한 공유 버튼,
 
 - 가시성 선택기(`Private` / `Organization` / `Public link`).
 - "사람 또는 팀 추가" 자동 완성 — 조직에서 사용자를 검색하거나 이메일을 붙여넣습니다.
-- 개별 이메일 승인을 위한 Google 문서 스타일 `알림 people` 확인란.
+- 개별 이메일 권한 부여를 위한 `사용자에게 알림` 확인란.
 - 역할 선택기와 제거 컨트롤이 포함된 현재 부여 목록입니다.
 - 현재 표시 여부를 고려하는 링크 복사 버튼입니다.
 
@@ -270,7 +270,7 @@ export const deckShares = createSharesTable("deck_shares");
 
 `server/db/index.ts`에서 한 번의 등록 호출:
 
-```ts
+```ts filename="server/db/index.ts"
 import { registerShareableResource } from "@agent-native/core/sharing";
 
 registerShareableResource({
@@ -315,9 +315,9 @@ For resources that execute code or carry elevated trust (like extensions), set `
 
 프레임워크의 더 광범위한 데이터 범위 지정 모델에 대한 공유 - 소유 가능한 테이블에 대한 목록/읽기/쓰기 액세스는 `accessFilter()` / `resolveAccess()` / `assertAccess()`를 통과하며 `org_id` 태그가 지정된 리소스는 조직 전체에서 보이지 않습니다. 전체 파이프라인, CI 가드 및 위협 표면에 대해서는 [Security → Data Scoping](/docs/security#data-scoping)를 참조하세요.
 
-## 참조 {#see-also}
+## 다음 단계 {#see-also}
 
-- [Security & Data Scoping](/docs/security) — 공유를 기반으로 하는 액세스 필터 및 소유권 모델
-- [Authentication](/docs/authentication) — 세션, 조직 및 ID가 요청 컨텍스트로 흐르는 방식
-- [Extensions](/docs/extensions#sharing) — 샌드박스 미니앱 표면에서 공유.
-- [Creating Templates](/docs/creating-templates) — `ownableColumns`를 새 템플릿의 스키마에 연결합니다.
+- [**보안 — 데이터 범위 지정**](/docs/security#data-scoping) — 공유의 기반이 되는 액세스 필터 및 소유권 모델
+- [**인증**](/docs/authentication) — 세션, 조직, 요청 컨텍스트로 ID가 전달되는 방식
+- [**Extensions**](/docs/extensions#sharing) — 샌드박스 미니 앱 표면에서의 공유
+- [**템플릿 만들기**](/docs/creating-templates) — 새 템플릿 스키마에 `ownableColumns` 연결하기