@agent-native/core 0.109.3 → 0.110.0

package/corpus/core/docs/content/locales/ko-KR/agent-native-toolkit.mdx

@@ -1,23 +1,15 @@
 ---
-title: "Toolkits"
-description: "Battle-tested reusable building blocks for high-quality agentic applications: collaboration, sharing, settings, teams, setup, navigation, resources, agent UX, history, comments, and observability."
+title: "Toolkit"
+description: "재사용 가능한 기반, 편집기와 캔버스, 에이전트 컨텍스트, 거버넌스, 워크스페이스 크롬, 운영 및 Toolkit 기능 모듈을 담은 균형 잡힌 카탈로그입니다."
 ---
 
 <!-- i18n-docs-ignore -->
 
-# Toolkits
+# Toolkit
 
-Toolkits are reusable, battle-tested building blocks for high-quality agentic
-applications. They turn the hard product work that repeats across apps into
-standard surfaces: realtime collaboration between humans and agents, sharing
-with humans and agents, settings, teams, setup, resources, history, review, and
-observability.
+Toolkit은 고품질 에이전트형 애플리케이션을 위한 재사용 가능하고 실전에서 검증된 구성 요소입니다. 앱 전반에서 반복되는 어려운 제품 작업을 사람과 에이전트 사이의 실시간 협업, 사람과 에이전트를 위한 공유, 설정, 팀, 설정 과정, 리소스, 기록, 검토, 관찰 가능성과 같은 표준 화면으로 만듭니다.
 
-Each kit packages the UI patterns, action contracts, app-state expectations,
-access boundaries, and agent-visible behavior that users expect to work
-consistently. Apps still own their domain model and visual identity; toolkits
-make the common product systems feel complete from the first version instead of
-being rebuilt in slightly different ways every time.
+각 키트는 사용자가 일관되게 동작하리라 기대하는 UI 패턴, 액션 계약, 앱 상태 기대치, 접근 경계, 에이전트에 보이는 동작을 묶습니다. 앱은 여전히 도메인 모델과 시각적 정체성을 소유합니다. Toolkit은 공통 제품 시스템을 매번 조금씩 다르게 다시 만들지 않고 첫 버전부터 완성된 느낌이 들게 합니다.
 
 <WireframeBlock id="doc-block-toolkits-index">
   <Screen
@@ -28,23 +20,23 @@ being rebuilt in slightly different ways every time.
   />
 </WireframeBlock>
 
-<Diagram id="doc-block-toolkits-boundary" title="How kits fit" summary={"The framework runtime supplies durable guarantees. Toolkits turn those guarantees into reusable product systems. Apps add domain-specific data, routes, and visual identity."}>
+<Diagram id="doc-block-toolkits-boundary" title="키트의 위치" summary={"프레임워크 런타임은 지속적인 보장을 제공합니다. Toolkit은 그 보장을 재사용 가능한 제품 시스템으로 바꿉니다. 앱은 도메인별 데이터, 라우트, 시각적 정체성을 더합니다."}>
 
 ```html
 <div class="diagram-row">
   <div class="diagram-card">
-    <span class="diagram-pill accent">Runtime</span><br />
-    actions, SQL, auth, app state, access checks, realtime transport
+    <span class="diagram-pill accent">런타임</span><br />
+    액션, SQL, 인증, 앱 상태, 접근 검사, 실시간 전송
   </div>
   <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
   <div class="diagram-card">
-    <span class="diagram-pill accent">Toolkits</span><br />
-    collaboration, sharing, setup, review, history, observability
+    <span class="diagram-pill accent">Toolkit</span><br />
+    협업, 공유, 설정 과정, 검토, 기록, 관찰 가능성
   </div>
   <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
   <div class="diagram-card">
-    <span class="diagram-pill accent">Apps</span><br />
-    domain schema, routes, actions, branding, specialized workflows
+    <span class="diagram-pill accent">앱</span><br />
+    도메인 스키마, 라우트, 액션, 브랜딩, 전문 워크플로
   </div>
 </div>
 ```
@@ -68,45 +60,60 @@ being rebuilt in slightly different ways every time.
 
 </Diagram>
 
-## The Kits {#the-kits}
-
-| Kit                                                      | Use it for                                                                                                  |
-| -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
-| [Sharing](/docs/toolkit-sharing)                         | Ownable resources, share dialogs, visibility badges, share actions, public/private/org access.              |
-| [Collaboration](/docs/toolkit-collaboration)             | Realtime editing, presence, live cursors, recent-edit highlights, collaborative undo.                       |
-| [Settings](/docs/toolkit-settings)                       | Standard settings pages and tabs so app settings and agent/provider settings live in one predictable place. |
-| [Org & Team](/docs/toolkit-org-team)                     | Team pages, org switching, invites, org domains, roles, and app switching.                                  |
-| [Setup & Connections](/docs/toolkit-setup-connections)   | Onboarding, secrets, workspace connections, OAuth/provider readiness, and Builder connect.                  |
-| [Command & Navigation](/docs/toolkit-command-navigation) | Command menu, deep links, standard app routes, sidebar and shell patterns.                                  |
-| [Resources](/docs/toolkit-resources)                     | Resource trees, editors, file picker/search, attachments, and local file mode.                              |
-| [Agent UX](/docs/toolkit-agent-ux)                       | Composer, model picker, context chips, approvals, run recovery, and the runs tray.                          |
-| [History](/docs/toolkit-history)                         | Version history, audit logs, undo/redo, restore, and "what changed" surfaces.                               |
-| [Comments & Review](/docs/toolkit-comments-review)       | Inline comments, annotations, mentions, resolved threads, review status.                                    |
-| [Observability](/docs/toolkit-observability)             | Usage, spend, feedback, replay, errors, and run diagnostics.                                                |
-
-## Implementation Boundary {#implementation-boundary}
-
-Kits are product surfaces first. Some pieces are runtime-backed
-(`@agent-native/core`), some are presentation primitives
-(`@agent-native/toolkit`), and apps usually wrap both through local adapters.
-Use the package path that owns the needed behavior, but design the user-facing
-settings, collaboration, sharing, team, review, and setup experiences as one
-coherent kit instead of exposing package boundaries in the app.
-
-## Foundation Pieces {#foundation-pieces}
-
-- [UI Primitives](/docs/toolkit-ui) cover shared shadcn-style primitives under
-  `@agent-native/toolkit/ui/*`.
-- [App Adapters](/docs/toolkit-ui#app-adapters) show how apps wrap Toolkit pieces
-  through local `@/components/*` adapters.
-- [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.
-
-## Design Rule {#design-rule}
-
-Use a toolkit when the behavior repeats across apps and users expect it to feel
-standard: sharing, settings, teams, comments, history, and agent progress should
-not be slightly different in every template. Keep domain-specific data,
-workflows, labels, and visual styling in the app.
+## 카탈로그 {#catalog}
+
+| 영역                     | 시작점                                             | 포함 내용                                                               |
+| ------------------------ | -------------------------------------------------- | ----------------------------------------------------------------------- |
+| 기반                     | [UI 프리미티브](/docs/toolkit-ui)                  | 공유 컨트롤, 훅, 앱 어댑터, 셸 연결 지점.                               |
+| 편집기와 캔버스          | [편집기와 캔버스](/docs/toolkit-editors-canvases)  | 리치 편집, 구조화된 블록, 재사용 가능한 캔버스 컨트롤, Design 패턴.     |
+| 에이전트 경험과 컨텍스트 | [컨텍스트와 지식](/docs/toolkit-context-knowledge) | Context X-Ray, 리소스, 지식, 컴포저 컨텍스트 및 에이전트에 보이는 상태. |
+| 협업과 거버넌스          | [협업](/docs/toolkit-collaboration)                | 공유, 현재 상태, 검토, 기록, 감사 및 조직 경계.                         |
+| 워크스페이스 크롬        | [앱 크롬](/docs/toolkit-settings)                  | 설정, 팀, 설정 과정, 탐색, 리소스 및 에이전트 UX.                       |
+| 운영                     | [관찰 가능성](/docs/toolkit-observability)         | 사용량, 피드백, 리플레이, 진단 및 운영 가시성.                          |
+| Toolkit 기능 모듈        | [기능 패키지](/docs/toolkit-capability-packages)   | 필요 시 설치하는 도메인 패키지와 수명 주기 매니페스트.                  |
+
+## 제품 키트 {#product-kits}
+
+| 키트                                             | 용도                                                                                  |
+| ------------------------------------------------ | ------------------------------------------------------------------------------------- |
+| [공유](/docs/toolkit-sharing)                    | 소유 가능한 리소스, 공유 대화 상자, 공개 범위 배지, 공유 액션, 공개/비공개/조직 접근. |
+| [협업](/docs/toolkit-collaboration)              | 실시간 편집, 현재 상태, 라이브 커서, 최근 편집 강조, 협업 실행 취소.                  |
+| [설정](/docs/toolkit-settings)                   | 앱 설정과 에이전트/프로바이더 설정을 예측 가능한 한곳에 두는 표준 설정 페이지와 탭.   |
+| [조직 및 팀](/docs/toolkit-org-team)             | 팀 페이지, 조직 전환, 초대, 조직 도메인, 역할, 앱 전환.                               |
+| [설정 및 연결](/docs/toolkit-setup-connections)  | 온보딩, 시크릿, 워크스페이스 연결, OAuth/프로바이더 준비 상태, Builder 연결.          |
+| [명령 및 탐색](/docs/toolkit-command-navigation) | 명령 메뉴, 딥 링크, 표준 앱 라우트, 사이드바와 셸 패턴.                               |
+| [리소스](/docs/toolkit-resources)                | 리소스 트리, 편집기, 파일 선택/검색, 첨부 파일, 로컬 파일 모드.                       |
+| [에이전트 UX](/docs/toolkit-agent-ux)            | 컴포저, 모델 선택기, 컨텍스트 칩, 승인, 실행 복구, 실행 트레이.                       |
+| [기록](/docs/toolkit-history)                    | 버전 기록, 감사 로그, 실행 취소/다시 실행, 복원, 변경 사항 화면.                      |
+| [댓글 및 검토](/docs/toolkit-comments-review)    | 인라인 댓글, 주석, 멘션, 해결된 스레드, 검토 상태.                                    |
+| [관찰 가능성](/docs/toolkit-observability)       | 사용량, 비용, 피드백, 재생, 오류, 실행 진단.                                          |
+
+## 패키지 성숙도와 소유권 {#package-maturity-and-ownership}
+
+- 리치 편집기는 **Toolkit** 소유입니다. 마이그레이션 동안 기존 Core import는 얇은 호환 re-export로 유지됩니다.
+- Design은 재사용 가능한 `design-tweaks`를 사용하는 **템플릿 패턴**이며, 완전한 드롭인 편집기나 캔버스가 아닙니다.
+- Blocks와 Context X-Ray 엔진은 이 단계에서 **Core 소유**로 유지됩니다. 재사용 가능한 Context X-Ray 표현은 Toolkit 소유입니다.
+- Creative Context, Scheduling, Pinpoint는 필요 시 설치하는 **Toolkit 기능 모듈**이며 별도의 npm 패키지와 수명 주기 매니페스트를 유지합니다. Dispatch는 별도 제품입니다.
+
+## 구현 경계 {#implementation-boundary}
+
+키트는 우선 제품 화면입니다. 일부는 런타임을 기반으로 하고(`@agent-native/core`), 일부는 표현 프리미티브이며(`@agent-native/toolkit`), 앱은 보통 로컬 어댑터로 둘 다 감쌉니다. 필요한 동작을 소유하는 패키지 경로를 사용하되, 사용자 대상 설정, 협업, 공유, 팀, 검토, 설정 경험은 앱에서 패키지 경계를 드러내지 않는 하나의 일관된 키트로 설계하세요.
+
+## 기반 구성 요소 {#foundation-pieces}
+
+- [UI 프리미티브](/docs/toolkit-ui)는 `@agent-native/toolkit/ui/*`의 공유 shadcn 스타일 프리미티브를 다룹니다.
+- [앱 어댑터](/docs/toolkit-ui#app-adapters)는 앱이 로컬 `@/components/*` 어댑터로 Toolkit 구성 요소를 감싸는 방법을 보여 줍니다.
+- [셸 및 훅](/docs/toolkit-ui#shell-hooks)은 헤더 액션, 모바일 훅, 토스트, 작은 앱 셸 도우미를 다룹니다.
+- [컴포넌트 API](/docs/components)는 공개 React export의 하위 수준 참조입니다.
+
+## 설계 원칙 {#design-rule}
+
+동작이 앱 전체에서 반복되고 사용자가 표준적인 느낌을 기대한다면 Toolkit을 사용하세요. 공유, 설정, 팀, 댓글, 기록, 에이전트 진행 상황은 템플릿마다 조금씩 달라서는 안 됩니다. 도메인별 데이터, 워크플로, 라벨, 시각적 스타일은 앱에 유지하세요.
+
+## 다음 단계
+
+- [**Toolkit UI 프리미티브**](/docs/toolkit-ui) — 공유 프리미티브, 앱 어댑터, 셸 훅.
+- [**공유 키트**](/docs/toolkit-sharing) — 리소스, 공유 대화상자, 가시성을 위한 좋은 첫 키트.
+- [**템플릿 만들기**](/docs/creating-templates) — 템플릿을 처음부터 만들고 키트가 어디에 맞는지 확인합니다.
+- [**컴포넌트 API**](/docs/components) — 모든 공개 React export의 참조입니다.
+- [**패키지 수명 주기**](/docs/package-lifecycle) — manifest 기반 Toolkit 기능 모듈을 안전하게 검사, 추가, eject합니다.

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

@@ -14,8 +14,7 @@ search: "헤드리스 에이전트 리치 채팅 전체 앱 BYO 에이전트 런
 모드에서 흐름을 중복하지 않고 전체 페이지로 이동할 수 있습니다.
 
 ```tsx filename="app/routes/agent.tsx"
-import { AgentTabsPage } from "@agent-native/core/client";
-
+import { AgentTabsPage } from "@agent-native/core/client/agent-chat";
 export default function AgentRoute() {
   return <AgentTabsPage />;
 }
@@ -412,8 +411,7 @@ export default createAgentNativeEmbeddedPlugin({
 React 사이드카는 페이지 컨텍스트 및 호스트 명령을 전달합니다.
 
 ```tsx
-import { AgentNativeEmbedded } from "@agent-native/core/client";
-
+import { AgentNativeEmbedded } from "@agent-native/core/client/host";
 export function AppShell({ children }) {
   return (
     <AgentNativeEmbedded

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

@@ -82,8 +82,7 @@ export default defineAction({
 `useActionQuery`를 사용하여 UI에서 `list-audit-events`를 호출하여 활동 피드 또는 "이 항목을 변경한 사람" 줄을 작성합니다. 감사 테이블에 가져오기를 직접 작성하지 마세요.
 
 ```tsx
-import { useActionQuery } from "@agent-native/core/client";
-
+import { useActionQuery } from "@agent-native/core/client/hooks";
 const { data } = useActionQuery("list-audit-events", {
   targetType: "recording",
   targetId: recordingId,

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

@@ -363,8 +363,9 @@ interface AuthSession {
 클라이언트에서는 `useSession()` 후크를 사용합니다.
 
 ```ts
-import { useSession } from "@agent-native/core/client";
-
+import {
+  useSession,
+} from "@agent-native/core/client/hooks"
 function MyComponent() {
   const { session, isLoading } = useSession();
   if (isLoading) return <p>Loading...</p>;

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

@@ -65,8 +65,7 @@ import {
   useActionQuery,
   useActionMutation,
   callAction,
-} from "@agent-native/core/client";
-
+} from "@agent-native/core/client/hooks";
 // Read: auto-cached, auto-invalidated on mutations
 const { data, isLoading } = useActionQuery("get-lead", { leadId });
 
@@ -83,8 +82,7 @@ await callAction("archive-lead", { leadId });
 UI 상호 작용에서 AI 작업을 위임하는 일반적인 방법인 postMessage를 통해 에이전트 채팅에 메시지를 보냅니다. 숨겨진 모델 컨텍스트의 경우 `context`를 전달하고 즉시 전송하려면 `submit: true`를 전달하거나 사용자가 먼저 검토하는 초안을 미리 채우려면 `submit: false`를 전달하세요.
 
 ```ts
-import { sendToAgentChat } from "@agent-native/core/client";
-
+import { sendToAgentChat } from "@agent-native/core/client/agent-chat";
 // Auto-submit a prompt with hidden context
 sendToAgentChat({
   message: "Generate alt text for this image",
@@ -174,8 +172,7 @@ const tabId = sendToAgentChat({
 `"automations"`, `"voice"` 또는 `"limits"`를 사용하여 특정 섹션을 엽니다.
 
 ```ts
-import { openAgentSettings } from "@agent-native/core/client";
-
+import { openAgentSettings } from "@agent-native/core/client/navigation";
 openAgentSettings();
 openAgentSettings("secrets");
 ```
@@ -183,8 +180,7 @@ openAgentSettings("secrets");
 `agent-panel:open-settings`를 직접 파견하는 것보다 이 도우미를 선호하세요.
 
 ```tsx
-import { useAgentChatContext } from "@agent-native/core/client";
-
+import { useAgentChatContext } from "@agent-native/core/client/agent-chat";
 function SelectionContextButton({ record }: { record: { id: string } }) {
   const chatContext = useAgentChatContext();
   const contextKey = `selected-record:${record.id}`;
@@ -242,8 +238,10 @@ UI가 실행하기 전에 정확히 하나의 작은 결정(2~4개 옵션)이
 자유형 세부정보를 위한 작성기 및 다중 필드 입력을 위한 양식/팝오버
 
 ```tsx
-import { askUserQuestion, sendToAgentChat } from "@agent-native/core/client";
-
+import {
+  askUserQuestion,
+  sendToAgentChat,
+} from "@agent-native/core/client/agent-chat";
 const length = await askUserQuestion({
   question: "How long should this deck be?",
   header: "Deck length", // optional short chip/heading (≈12 chars)
@@ -286,7 +284,7 @@ import {
   requestMcpAppDisplayMode,
   updateMcpAppModelContext,
   useMcpAppHostContext,
-} from "@agent-native/core/client";
+} from "@agent-native/core/client/agent-chat";
 ```
 
 `getMcpAppHostContext()`는 최근 푸시된 호스트 컨텍스트 스냅샷을 읽습니다.
@@ -321,8 +319,9 @@ import {
 로드 상태 추적으로 sendToAgentChat을 래핑하는 React 후크:
 
 ```ts
-import { useAgentChatGenerating } from "@agent-native/core/client";
-
+import {
+  useAgentChatGenerating,
+} from "@agent-native/core/client/agent-chat"
 function GenerateButton() {
   const [isGenerating, send] = useAgentChatGenerating();
 
@@ -348,7 +347,9 @@ function GenerateButton() {
 SSE에 대한 데이터베이스 변경 사항을 수신하고 폴링으로 대체하며 UI를 에이전트 쓰기와 일치하도록 유지하는 프레임워크 쿼리 캐시를 무효화하는 React 후크(이전 `useFileWatcher`):
 
 ```ts
-import { useDbSync } from "@agent-native/core/client";
+import {
+  useDbSync,
+} from "@agent-native/core/client/hooks"
 import { useQueryClient } from "@tanstack/react-query";
 
 function App() {
@@ -393,8 +394,7 @@ function App() {
 
 ```tsx
 import { useQuery } from "@tanstack/react-query";
-import { useChangeVersion } from "@agent-native/core/client";
-
+import { useChangeVersion } from "@agent-native/core/client/hooks";
 function DashboardView({ id }) {
   // Get version for dashboards domain source
   const v = useChangeVersion("dashboards");
@@ -459,8 +459,9 @@ function DashboardView({ id }) {
 클래스 이름 병합을 위한 유틸리티(clsx + tailwind-merge):
 
 ```ts
-import { cn } from "@agent-native/core/client";
-
+import {
+  cn,
+} from "@agent-native/toolkit/utils"
 <div className={cn(
   "px-4 py-2 rounded",
   isActive && "bg-primary text-primary-foreground",

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

@@ -13,7 +13,7 @@ Agent-Native는 전체 사이드바를 제공하지만 사이드바는 계약이
 중점 클라이언트 하위 경로에서 브라우저 UI 가져오기:
 
 ```tsx
-import { AgentSidebar } from "@agent-native/core/client";
+import { AgentSidebar } from "@agent-native/core/client/agent-chat";
 import { PromptComposer } from "@agent-native/core/client/composer";
 import { AgentConversation } from "@agent-native/core/client/conversation";
 import { usePresence } from "@agent-native/core/client/collab";

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

@@ -196,8 +196,7 @@ if (url?.searchParams) {
 사용자가 의미 있는 객체를 선택하거나, 초점을 맞추거나, 다중 선택하는 경우 UI에서 작성합니다.
 
 ```tsx
-import { setClientAppState } from "@agent-native/core/client";
-
+import { setClientAppState } from "@agent-native/core/client/hooks";
 async function syncSelection(selection: unknown | null) {
   await setClientAppState("selection", selection, { keepalive: true });
 }
@@ -226,8 +225,7 @@ async function syncSelection(selection: unknown | null) {
 사용자 정의 편집기는 자신의 선택이 기본 브라우저 선택으로 표시되지 않을 때 동일한 키를 작성할 수 있습니다.
 
 ```tsx
-import { setClientAppState } from "@agent-native/core/client";
-
+import { setClientAppState } from "@agent-native/core/client/hooks";
 await setClientAppState(
   "pending-selection-context",
   {
@@ -289,8 +287,7 @@ await setClientAppState(
 때로는 컨텍스트가 앱 상태에만 있어서는 안 됩니다. 사용자는 버튼을 클릭하고, 댓글 핀을 놓고, 항목을 선택하고 "에이전트에게 물어보기"를 선택하거나, 도구 모음에서 AI 명령을 누릅니다. 그 클릭은 지시입니다. 브라우저 UI에서 `sendToAgentChat()`를 사용하여 상담원에게 전달하세요.
 
 ```tsx
-import { sendToAgentChat } from "@agent-native/core/client";
-
+import { sendToAgentChat } from "@agent-native/core/client/agent-chat";
 function askAgentAboutSelection(selection: {
   documentId: string;
   blockId: string;
@@ -373,7 +370,7 @@ UI 측에서는 이 키를 직접 폴링하거나 삭제하지 않습니다. 경
 
 ```tsx
 // app/hooks/use-navigation-state.ts -- this file lives in YOUR app
-import { useAgentRouteState } from "@agent-native/core/client";
+import { useAgentRouteState } from "@agent-native/core/client/navigation";
 import { TAB_ID } from "@/lib/tab-id";
 
 interface NavigationState {

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

@@ -270,8 +270,10 @@ export default runMigrations(
 경로는 `app/routes/`에 있으며 React 라우터 v8 파일 라우팅을 사용합니다. actions 또는 API 핸들러를 통해 데이터를 쿼리하고 기본적으로 돌연변이를 낙관적으로 만듭니다.
 
 ```tsx
-import { useActionMutation, useActionQuery } from "@agent-native/core/client";
-
+import {
+  useActionMutation,
+  useActionQuery,
+} from "@agent-native/core/client/hooks";
 export default function ProjectsPage() {
   const { data: projects = [] } = useActionQuery("list-projects", {});
   const create = useActionMutation("create-project");
@@ -287,7 +289,7 @@ export default function ProjectsPage() {
 에이전트, 다른 탭 또는 작업이 데이터를 변경할 때 React 쿼리가 새로 고침을 캐시하도록 앱 셸 근처에서 실시간 동기화를 한 번 연결합니다.
 
 ```tsx
-import { useDbSync } from "@agent-native/core/client";
+import { useDbSync } from "@agent-native/core/client/hooks";
 import { useQueryClient } from "@tanstack/react-query";
 
 export function AppSync() {
@@ -300,7 +302,7 @@ export function AppSync() {
 **에이전트 네이티브 약속: 에이전트 쓰기는 수동 새로 고침 없이 UI에 표시됩니다.** `useActionQuery`는 쉬운 경로입니다. 변형 작업이 `source: "action"`를 내보낼 때 모든 후크가 다시 가져옵니다. 사용자 정의 키(예: 통합 상태를 읽는 하위 수준 클라이언트 도우미)를 사용하여 원시 `useQuery`에 도달하는 경우 대상 새로 고침을 위해 소스별 카운터를 queryKey에 접습니다.
 
 ```tsx
-import { useChangeVersions } from "@agent-native/core/client";
+import { useChangeVersions } from "@agent-native/core/client/hooks";
 
 const v = useChangeVersions(["dashboards", "action"]);
 useQuery({
@@ -323,7 +325,7 @@ useQuery({
 UI 후크에 `useAgentRouteState`를 사용하면 애플리케이션 상태 쓰기, 탭 범위 명령 읽기, 읽기 후 삭제 및 중복 명령 보호가 일관되게 유지됩니다.
 
 ```tsx
-import { useAgentRouteState } from "@agent-native/core/client";
+import { useAgentRouteState } from "@agent-native/core/client/navigation";
 import { TAB_ID } from "@/lib/tab-id";
 
 export function useNavigationState() {

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

@@ -0,0 +1,10 @@
+---
+title: Doctor
+description: 보안 및 마이그레이션 검사.
+---
+
+# Doctor
+
+`agent-native doctor`는 7개의 보안 guard와 `migration-manifest`를 포함한 8개 guard를 실행합니다. 후자는 설치된 `migration-manifest.json`의 import를 찾으며 opt-out이 없습니다. `agent-native doctor --only migration-manifest`를 실행하고 `npx @agent-native/core@latest upgrade --codemods`로 미리 본 뒤 `--yes`로 적용하세요. JSON `guardsRun`에는 8개 이름이 나옵니다.
+
+`planned`로 표시된 항목은 경고로만 보고되며 다시 쓰지 않습니다. active 항목은 finding으로 처리되고, codemod는 대상 export가 설치된 경우에만 다시 씁니다.

package/corpus/core/docs/content/locales/ko-KR/drop-in-agent.mdx

@@ -105,7 +105,7 @@ description: "<AgentPanel>, <AgentSidebar> 및 sendToAgentChat()을 사용하여
   filename="app/root.tsx"
   language="tsx"
   code={
-    'import { Outlet } from "react-router";\nimport { AgentSidebar, AgentToggleButton } from "@agent-native/core/client";\n\nexport default function Root() {\n  return (\n    <AgentSidebar\n      emptyStateText="무엇을 도와드릴까요?"\n      suggestions={[\n        "Summarize my inbox",\n        "Draft a reply to the latest email",\n        "Show me yesterday\'s signup numbers",\n      ]}\n      dynamicSuggestions\n      defaultSidebarWidth={420}\n      position="right"\n    >\n      <header>\n        <AgentToggleButton />\n      </header>\n\n      <main>\n        <Outlet />\n      </main>\n    </AgentSidebar>\n  );\n}'
+    'import { Outlet } from "react-router";\nimport { AgentSidebar, AgentToggleButton } from "@agent-native/core/client/agent-chat";\n\nexport default function Root() {\n  return (\n    <AgentSidebar\n      emptyStateText="무엇을 도와드릴까요?"\n      suggestions={[\n        "Summarize my inbox",\n        "Draft a reply to the latest email",\n        "Show me yesterday\'s signup numbers",\n      ]}\n      dynamicSuggestions\n      defaultSidebarWidth={420}\n      position="right"\n    >\n      <header>\n        <AgentToggleButton />\n      </header>\n\n      <main>\n        <Outlet />\n      </main>\n    </AgentSidebar>\n  );\n}'
   }
   annotations={[
     {
@@ -154,8 +154,7 @@ description: "<AgentPanel>, <AgentSidebar> 및 sendToAgentChat()을 사용하여
 
 ```tsx
 // app/routes/agent.tsx
-import { AgentPanel } from "@agent-native/core/client";
-
+import { AgentPanel } from "@agent-native/core/client/agent-chat";
 export default function AgentRoute() {
   return (
     <div className="h-screen">
@@ -182,8 +181,7 @@ export default function AgentRoute() {
 인라인 `llm()` 호출을 실행하는 대신 에이전트에 직접 작업을 전달하는 버튼 - [ladder](/docs/what-is-agent-native#the-ladder)의 안티 패턴:
 
 ```tsx
-import { sendToAgentChat } from "@agent-native/core/client";
-
+import { sendToAgentChat } from "@agent-native/core/client/agent-chat";
 <Button
   onClick={() =>
     sendToAgentChat({
@@ -232,8 +230,7 @@ MCP 앱 브리지 동작을 위한 [Client](/docs/client#sendtoagentchat).
 로드 상태를 원하면 `useSendToAgentChat()` 후크를 사용하세요. `send`와 `isGenerating`를 모두 반환합니다.
 
 ```ts
-import { useSendToAgentChat } from "@agent-native/core/client";
-
+import { useSendToAgentChat } from "@agent-native/core/client/agent-chat";
 const { send, isGenerating } = useSendToAgentChat();
 ```
 
@@ -267,8 +264,7 @@ const { send, isGenerating } = useSendToAgentChat();
 UI가 에이전트 도구가 실행하는 것과 동일한 작업을 실행해야 하는 경우([ladder](/docs/what-is-agent-native#rung-three)의 3번 단계) `useActionMutation`를 사용하세요.
 
 ```tsx
-import { useActionMutation } from "@agent-native/core/client";
-
+import { useActionMutation } from "@agent-native/core/client/hooks";
 const { mutate, isPending } = useActionMutation("reply-to-email");
 
 <Button onClick={() => mutate({ emailId, body: "Thanks!" })}>
@@ -298,8 +294,7 @@ import {
   AgentSidebar,
   AgentToggleButton,
   sendToAgentChat,
-} from "@agent-native/core/client";
-
+} from "@agent-native/core/client/agent-chat";
 export default function Root() {
   return (
     <AgentSidebar suggestions={["Draft a reply", "Summarize selection"]}>

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

@@ -116,8 +116,7 @@ export default createAgentNativeEmbeddedPlugin({
 import {
   AgentNativeEmbedded,
   defineClientAction,
-} from "@agent-native/core/client";
-
+} from "@agent-native/core/client/host";
 export function BuilderAppShell({ children, content, editor }) {
   return (
     <AgentNativeEmbedded
@@ -295,8 +294,10 @@ for await (const chunk of sendMessage(
 독립형 사이드카 앱 또는 교차 출처 iframe의 경우 하위 수준 `<AgentNative />`를 사용하세요. iframe 사이드카 및 연결 페이지 컨텍스트, 라이브 클라이언트 actions, 호스트 새로 고침/탐색 명령을 한 곳에서 렌더링합니다.
 
 ```tsx
-import { AgentNative, defineClientAction } from "@agent-native/core/client";
-
+import {
+  AgentNative,
+  defineClientAction,
+} from "@agent-native/core/client/host";
 export function AssistantDock({ customer, sessionToken }) {
   return (
     <AgentNative
@@ -383,8 +384,7 @@ import {
   requestAgentNativeHostContext,
   runAgentNativeHostAction,
   sendAgentNativeHostCommand,
-} from "@agent-native/core/client";
-
+} from "@agent-native/core/client/host";
 announceAgentNativeFrameReady({ hostOrigin: "https://app.example.com" });
 
 const context = await requestAgentNativeHostContext({
@@ -457,8 +457,7 @@ CLAW 스타일 동료의 경우 iframe은 사이드카 백엔드에 라이브
 
 ```tsx
 import { useEffect } from "react";
-import { startAgentNativeBrowserSessionBridge } from "@agent-native/core/client";
-
+import { startAgentNativeBrowserSessionBridge } from "@agent-native/core/client/host";
 export function SidecarRuntime() {
   useEffect(() => {
     const bridge = startAgentNativeBrowserSessionBridge({
@@ -510,8 +509,7 @@ import {
   AgentNativeExtensionSlot,
   createHttpAgentNativeExtensionStorage,
   defineClientAction,
-} from "@agent-native/core/client";
-
+} from "@agent-native/core/client/host";
 const storage = createHttpAgentNativeExtensionStorage({
   endpoint: "/api/agent-native/extensions/storage",
   headers: () => ({ Authorization: `Bearer ${sessionToken()}` }),

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

@@ -15,7 +15,11 @@ SQL 설정에서 언어 선택, actions로 노출 및 대체
 `AppProviders`를 통해 공급자 사용:
 
 ```tsx
-import { AppProviders, getLocaleInitScript } from "@agent-native/core/client";
+import {
+  AppProviders,
+} from "@agent-native/core/client/hooks"import {
+  getLocaleInitScript,
+} from "@agent-native/core/client/i18n"
 import { i18nCatalog } from "./i18n";
 
 const LOCALE_INIT_SCRIPT = getLocaleInitScript();
@@ -42,8 +46,7 @@ React가 수화되기 전의 `window.__AGENT_NATIVE_LOCALE__`. 공개 SSR 경로
 ```ts
 // app/i18n/index.ts
 import enUS from "./en-US";
-import type { AgentNativeI18nCatalog } from "@agent-native/core/client";
-
+import type { AgentNativeI18nCatalog } from "@agent-native/core/client/i18n";
 export const i18nCatalog = {
   sourceLocale: "en-US",
   messages: enUS,
@@ -71,10 +74,10 @@ export const i18nCatalog = {
 ```tsx
 import {
   LanguagePicker,
-  openAgentSettings,
   useT,
-} from "@agent-native/core/client";
-
+} from "@agent-native/core/client/i18n"import {
+  openAgentSettings,
+} from "@agent-native/core/client/navigation"
 function SettingsPage() {
   const t = useT();
   return (

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

@@ -256,8 +256,7 @@ UI는 LLM를 직접 호출하지 않습니다. 사용자가 "차트 생성" 또
 
 ```ts
 // In a React component — delegate AI work to the agent
-import { sendToAgentChat } from "@agent-native/core/client";
-
+import { sendToAgentChat } from "@agent-native/core/client/agent-chat";
 sendToAgentChat({
   message: "Generate a chart showing signups by source",
   context: "Dashboard ID: main, date range: last 30 days",
@@ -308,8 +307,7 @@ export default defineAction({
 
 ```ts
 // Client: subscribe to agent/UI data changes once near the app shell
-import { useDbSync } from "@agent-native/core/client";
-
+import { useDbSync } from "@agent-native/core/client/hooks";
 useDbSync({ queryClient });
 ```
 

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

@@ -94,8 +94,7 @@ description: "에이전트 추적, 평가, 피드백, A/B 실험 및 내장 대
 
 ```tsx
 // app/routes/observability.tsx
-import { ObservabilityDashboard } from "@agent-native/core/client";
-
+import { ObservabilityDashboard } from "@agent-native/core/client/observability";
 export default function ObservabilityPage() {
   return (
     <div className="min-h-screen bg-background p-6">

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

@@ -18,3 +18,9 @@ agent-native package eject @agent-native/scheduling --apply
 패키지 관리자를 실행합니다. 충돌과 알 수 없는 레이아웃은 거부하며 설치가
 실패하면 파일과 잠금 파일을 복원합니다. 파일럿에서는 Scheduling만 꺼낼 수
 있으며 Pinpoint는 보류합니다.
+
+## 마이그레이션
+
+게시된 패키지에는 이동한 경로와 심볼용 `migration-manifest.json`이 들어 있습니다. `npx @agent-native/core@latest upgrade --codemods`로 diff를 확인한 뒤 `--yes`로 적용하세요. CI에서는 `agent-native doctor --only migration-manifest`를 실행하며 opt-out은 없습니다.
+
+`planned` 항목은 대상보다 먼저 배포할 수 있으며, 차단하지 않는 경고로 표시되고 codemod가 다시 쓰지 않습니다. active 이동은 대상 export가 설치된 경우에만 다시 씁니다.