@agent-native/core 0.92.12 → 0.94.0

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/extensions.mdx

@@ -11,6 +11,14 @@ QuickBooks Online을 사용해 본 적이 있다면 모델을 본 적이 있을
 
 프레임 구성이 중요합니다. 확장 프로그램은 "원하는 대로 수행"하는 일반적인 샌드박스가 아닙니다. 메일, 분석, 캘린더, 클립, 디자인 등 특정 템플릿을 확장하고 해당 템플릿의 actions 및 데이터를 사용하는 \*\*미니 앱입니다. 메일 확장은 이메일을 읽습니다. Analytics 확장은 대시보드의 지표를 읽습니다. 캘린더 확장은 공개 이벤트에 대해 작동합니다. 호스트 제품의 일부이기 때문에 호스트 제품의 일부처럼 느껴집니다.
 
+> **확장 프로그램은 UI를 추가하지만 호스트 UI 자체를 다시 작성하지는
+> 않습니다.** 확장 프로그램은 자체 페이지 또는 템플릿이 제공하는 이름 있는
+> [슬롯](#slots) 안에 표시됩니다. 예를 들어 캘린더의 각 참석자 옆처럼 임의의
+> 네이티브 컴포넌트 안에 요소를 삽입하려면 해당 위치에 슬롯이 있어야 합니다.
+> 더 깊은 사용자 지정이 필요하면 에이전트에게 템플릿의 소스 코드를 편집해
+> 달라고 요청하세요. 전체 코드를 사용자 지정할 수 있다는 점은 Agent Native의
+> 핵심 기능이며, 확장 프로그램은 배포 없이 빠르게 추가하는 계층입니다.
+
 확장 프로그램이 작동하는 세 가지 요소:
 
 - **코드도 없고 배포도 없습니다.** 에이전트가 이를 작성하면 몇 초 만에 활성화됩니다. 저장소가 아닌 데이터베이스에 저장됩니다.

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/messaging.mdx

@@ -1,11 +1,15 @@
 ---
 title: "메시지"
-description: "Slack, 이메일, Telegram 또는 WhatsApp에서 에이전트와 대화하세요. 동일한 에이전트, 동일한 메모리, 동일한 도구입니다."
+description: "Slack, Microsoft Teams, Discord 인터랙션, 이메일, Telegram 또는 WhatsApp에서 에이전트와 대화하세요."
 ---
 
 # 메시지
 
-에이전트를 Slack, 이메일, Telegram 또는 WhatsApp에 연결하면 이미 사용하고 있는 앱에서 에이전트와 채팅할 수 있습니다. 동일한 에이전트, 동일한 메모리, 동일한 도구, 동일한 스레드이므로 더 많은 곳에서 연결할 수 있습니다.
+에이전트를 Slack, Microsoft Teams, Discord 인터랙션, 이메일, Telegram 또는 WhatsApp에 연결할 수 있습니다. 메모리, 도구, 대화 기록은 그대로 유지됩니다.
+
+> **정확한 지원 범위:** Teams는 공식 Bot Framework JWT를 검증하고 원래 대화에 답합니다. Discord는 Ed25519 서명 HTTP 인터랙션을 통한 슬래시 명령과 지연 응답을 지원합니다. 일반 서버 메시지와 DM에는 Gateway 런타임이 필요합니다. Telegram은 `message_thread_id`를 유지하고 WhatsApp은 수신 `wamid`를 문맥 답장에 사용합니다.
+>
+> Teams에는 `MICROSOFT_TEAMS_APP_ID`, `MICROSOFT_TEAMS_APP_PASSWORD`, `MICROSOFT_TEAMS_ALLOWED_TENANT_IDS`가 필요합니다. Discord에는 `DISCORD_APPLICATION_ID`와 `DISCORD_PUBLIC_KEY`가 필요합니다. Telegram에는 `TELEGRAM_WEBHOOK_SECRET`, WhatsApp에는 `WHATSAPP_APP_SECRET`도 필요합니다.
 
 > **디스패치 템플릿을 사용하십니까?** 이 모든 것이 **설정 → 메시지**에 연결되어 있습니다. 각 플랫폼을 연결하려면 클릭하세요. 자신만의 템플릿을 사용자 정의하거나 구축하지 않는 한 이 페이지의 나머지 부분을 읽을 필요가 없습니다. [Dispatch](/docs/dispatch) 또는 [Dispatch template reference](/docs/template-dispatch)를 참조하세요.
 
@@ -78,7 +82,6 @@ description: "Slack, 이메일, Telegram 또는 WhatsApp에서 에이전트와
    - `chat:write` — 에이전트가 메시지를 보낼 수 있게 합니다
    - `app_mentions:read` — @-멘션이 언제인지 에이전트가 확인할 수 있도록 합니다(선택 사항)
    - `im:history` — 에이전트가 자신에게 전송된 DM을 읽을 수 있도록 합니다.
-   - `assistant:write` — 선택 사항; Slack는 보조 스레드에서 기본 "생각 중..." 상태를 표시합니다.
    - `users:read.email` — 선택 사항; 메일과 같은 템플릿이 Slack 발신자 이메일에서 초안 대기열 신원을 확인하는 데 도움이 됩니다.
 3. 해당 페이지 상단에서 **작업공간에 설치**를 클릭하세요. Slack는 `xoxb-`로 시작하는 **봇 사용자 OAuth 토큰**을 제공합니다. 복사하세요.
 4. 사이드바의 **기본 정보**로 이동하여 **서명 비밀**을 복사하세요.
@@ -123,12 +126,72 @@ Slack 앱에는 하나의 이벤트 API 요청 URL가 있습니다. 동일한 Sl
 
 ### 팁
 
-- **채널 멘션** — 봇은 소음을 피하기 위해 @-멘션될 때만 채널에서 응답합니다.
-- **DM** — 모든 DM은 상담원과의 비공개 대화로 처리됩니다.
-- **동일한 신원, 모든 채널** — Slack 사용자가 앱에 등록된 사용자와 동일한 이메일을 가지고 있는 경우 에이전트는 이들을 동일한 사람으로 취급합니다.
+- **채널 멘션** — 작업을 시작할 때 @mention을 사용합니다. 멘션 없는 답글은 같은 스레드에 활성 작업이 있을 때만 이어집니다.
+- **DM** — 허용되는 개인 DM은 비공개 대화이며 확인된 조직 구성원 또는 연결된 Slack 신원이 필요합니다.
+- **신원** — DM은 확인된 Slack 이메일을 같은 앱 사용자에 연결할 수 있으며 관리 채널은 자체 서비스 신원과 정책을 사용합니다.
 - **프로덕션 허용 목록** — `SLACK_ALLOWED_TEAM_IDS`를 설정하고 공유 Slack 앱의 경우 `SLACK_ALLOWED_API_APP_IDS`를 설정하여 예상치 못한 작업 공간에서 유효한 서명 비밀을 재사용할 수 없도록 합니다.
 - **Clips 앱이 펼쳐집니다** — 설치 가능한 Agent-Native Slack용 클립은 `SLACK_CLIENT_ID`, `SLACK_CLIENT_SECRET`, `SLACK_SIGNING_SECRET` 및 `/api/slack/oauth/callback`를 사용합니다. 연결된 각 Slack 작업 공간은 `app_secrets`에서 자체 암호화된 봇 토큰을 얻습니다. `SLACK_BOT_TOKEN`는 레거시 단일 작업공간 대체일 뿐입니다.
 
+### 관리형 Add to Slack
+
+관리형 OAuth가 권장 설정입니다. **설정 → 메시징**에서 **Agent manifest**를 선택해
+호스트별 `agent-native-slack-manifest.json`을 다운로드한 뒤 Slack의 **App Manifest**에서
+가져오세요. 이 매니페스트는 현재 `agent_view` 환경과 DM을 위한 쓰기 가능한 **Messages**
+탭을 활성화합니다. 다음 Bot Token Scopes가 포함되었는지 확인하세요.
+
+앱 아이콘은 매니페스트에 포함되지 않습니다. Agents 선택 화면이 제품 브랜딩과 일치하도록
+**Basic Information → Display Information**에서 Agent Native 아이콘을 업로드하세요. 앱의 공개
+`icon-512.svg`를 원본으로 사용하고 필요하면 Slack이 지원하는 업로드 형식으로 변환할 수 있습니다.
+
+```text
+assistant:write
+app_mentions:read
+   channels:history
+   channels:read
+   chat:write
+files:read
+   groups:history
+   groups:read
+   im:history
+im:read
+   mpim:history
+   mpim:read
+   pins:read
+   reactions:read
+users:read
+users:read.email
+```
+
+OAuth Redirect URL은
+`https://your-app.example.com/_agent-native/integrations/slack/oauth/callback`,
+Event Subscriptions Request URL은
+`https://your-app.example.com/_agent-native/integrations/slack/webhook`,
+Interactivity Request URL은
+`https://your-app.example.com/_agent-native/integrations/slack/interactions`로 설정합니다.
+`app_home_opened`, `app_context_changed`, `app_mention`, `message.channels`,
+`message.groups`, `message.im`, `message.mpim`을 구독하세요.
+`SLACK_CLIENT_ID`, `SLACK_CLIENT_SECRET`, `SLACK_SIGNING_SECRET`을
+설정한 뒤 **설정 → 메시징**에서 **Add to Slack**을 선택합니다. 설치별 토큰은
+암호화되고 대화 키는 작업 공간, 앱, 채널, 스레드별로 분리됩니다.
+
+매니페스트, 범위, 이벤트, Agent view 또는 Messages 탭을 변경한 뒤에는 Slack 앱을 다시
+설치하세요. `app_home_opened`는 DM 열기를 감지하고, `app_context_changed`는 현재 보고 있는
+Slack 컨텍스트를 제공하며, `message.im`은 DM을 전달합니다. Slack 관리자는 설치된 에이전트를
+조직 전체에서 숨길 수 있고, 각 사용자는 자신의 상단 바에서 숨길 수 있습니다. 설치에 성공했지만
+에이전트가 보이지 않으면 이 표시 설정을 확인하거나 **Tools → Apps**에서 여세요.
+
+개인 Slack DM은 확인된 Agent Native 조직 구성원이나 이미 연결된 Slack 신원에서만
+허용됩니다. 채널 서비스 주체의 정책과 예산은 이 개인 신원과 별도로 적용됩니다.
+
+멘션 없는 답글은 실행 중인 같은 스레드만 이어가며 일반 채널 대화는 에이전트를
+실행하지 않습니다. 제한된 컨텍스트에는 리액션과 파일 참조가 포함되고 네이티브
+카드는 계획, 진행률, 취소, 승인/거부를 표시합니다. DM은 개인 ID를, 관리 채널은
+명시적인 서비스 ID와 게스트, Slack Connect, 모델 정책을 사용합니다. 채널 메모리는
+명시적인 요청으로만 저장하거나 삭제되며 자동 저장되지 않습니다. 채널에서 만든
+루틴은 같은 Slack 대상으로 결과를 보냅니다. 조직, 요청자, 채널의 일별 또는 월별
+예산은 전체 감사 계보와 함께 적용됩니다. `assistant:write`는 Agent View 컨텍스트 이벤트를
+활성화하고, `chat:write`는 답글과 실시간 상태 업데이트를 처리합니다.
+
 ## 텔레그램 설정 {#telegram}
 
 ### 필요한 것
@@ -438,7 +501,9 @@ POST /_agent-native/integrations/telegram/setup
 | 이메일   | `EMAIL_AGENT_ADDRESS`와 `RESEND_API_KEY` 또는 `SENDGRID_API_KEY` 중 하나     | `EMAIL_INBOUND_WEBHOOK_SECRET`                        |
 | 왓츠앱   | `WHATSAPP_ACCESS_TOKEN`, `WHATSAPP_VERIFY_TOKEN`, `WHATSAPP_PHONE_NUMBER_ID` | —                                                     |
 
-모든 자격 증명은 환경 변수에 있습니다. 절대 데이터베이스나 소스 코드가 아닙니다. 사이드바 설정 UI 또는 호스팅 제공업체의 환경 패널을 사용하세요.
+통합 자격 증명은 먼저 통합 소유자의 범위 지정 시크릿(사용자, 조직, 그다음 워크스페이스)에서 확인됩니다. 배포 환경 변수는 로컬 또는 의도적인 단일 테넌트 설치를 위한 대체 수단입니다. 설정 UI는 범위 지정 시크릿을 저장하며, 값이 브라우저로 반환되거나 소스 코드에 저장되지는 않습니다.
+
+기본 제공 런타임 어댑터는 **Slack**, **Telegram**, **WhatsApp Cloud API**, 그리고 공급자 webhook 이메일(Resend 또는 SendGrid)입니다. 검증된 어댑터를 구현하고 등록하기 전까지 Discord와 Microsoft Teams는 연결할 수 없습니다.
 
 ### 스레딩 및 ID {#threading-and-identity}
 
@@ -484,13 +549,13 @@ import type {
 import type { EnvKeyConfig } from "@agent-native/core/server";
 
 const myAdapter: PlatformAdapter = {
-  platform: "discord",
-  label: "Discord",
+  platform: "my-chat",
+  label: "My Chat",
 
   // Env keys this adapter needs (rendered in the settings UI)
   getRequiredEnvKeys(): EnvKeyConfig[] {
     return [
-      { key: "DISCORD_BOT_TOKEN", label: "Discord Bot Token", required: true },
+      { key: "MY_CHAT_BOT_TOKEN", label: "My Chat Bot Token", required: true },
     ];
   },
 
@@ -510,10 +575,10 @@ const myAdapter: PlatformAdapter = {
   // Return null to silently ignore the event (bot messages, edits, etc.).
   async parseIncomingMessage(event: H3Event): Promise<IncomingMessage | null> {
     return {
-      platform: "discord",
+      platform: "my-chat",
       externalThreadId: "channel-or-thread-id",
       text: "the user's message",
-      senderId: "discord-user-id",
+      senderId: "my-chat-user-id",
       platformContext: { channelId: "channel-id" },
       timestamp: Date.now(),
     };
@@ -541,10 +606,10 @@ const myAdapter: PlatformAdapter = {
   // baseUrl is the app's public URL, used for status checks that need it.
   async getStatus(baseUrl?: string) {
     return {
-      platform: "discord",
-      label: "Discord",
+      platform: "my-chat",
+      label: "My Chat",
       enabled: true,
-      configured: !!process.env.DISCORD_BOT_TOKEN,
+      configured: !!process.env.MY_CHAT_BOT_TOKEN,
     };
   },
 };

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` 엔드포인트