@agent-native/core 0.96.0 → 0.98.0

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

@@ -381,7 +381,7 @@ function MyComponent() {
 /_agent-native/sign-in?return=<same-origin-path>
 ```
 
-익명의 뷰어가 이 URL를 조회하면 프레임워크의 로그인 페이지가 제공됩니다. 로그인에 성공하면(토큰, 이메일/비밀번호 또는 구글 OAuth 등 모든 흐름) 시청자는 302 `return`로 이동됩니다.
+익명의 뷰어가 이 URL를 조회하면 프레임워크의 로그인 페이지가 제공됩니다. 로그인에 성공하면(토큰, 이메일/비밀번호 또는 구글 OAuth 등 모든 흐름) 브라우저는 `return`로 돌아갑니다.
 
 `return` 매개변수는 **동일 출처 경로**로 검증됩니다. 네트워크 경로 참조(`//evil.com/...`), 절대 URL, `data:`/`javascript:` 체계 및 포함된 제어 문자는 모두 `/`로 대체됩니다. 검증된 경로는 입력에서 다시 에코되지 않고 URL 파서에서 재구성됩니다.
 
@@ -402,7 +402,7 @@ function SignInCta() {
 
 ### 북마크된 비공개 경로
 
-익명의 사용자가 `/dashboard`와 같은 개인 경로로 직접 이동하면 프레임워크는 이미 해당 URL에서 로그인 페이지를 제공합니다. 로그인에 성공하면 페이지가 다시 로드되고 사용자는 `/dashboard`에 도달합니다. 특별한 취급이 필요하지 않습니다. 이는 토큰, 이메일/비밀번호, **및** 구글 OAuth에 적용됩니다.
+일반 앱 페이지는 모든 방문자에게 동일한 비개인화 공개 캐시 가능 SSR 셸을 사용합니다. `AppProviders`가 클라이언트에서 세션을 확인하며, `/dashboard` 같은 비공개 경로에서는 비공개 UI를 마운트하기 전에 익명 방문자를 `/_agent-native/sign-in?return=%2Fdashboard`로 리디렉션합니다. 로그인 후에는 `/dashboard`로 돌아옵니다. 공개/SEO 경로에는 `isPublicPath`를, MCP 임베드 토큰처럼 별도의 제한된 인증 방식을 사용하는 화면에는 `sessionBypass`를 지정하세요.
 
 ### 비하인드 스토리: 구글 OAuth
 

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

@@ -114,13 +114,13 @@ description: "자연어 조건을 사용한 이벤트 트리거 및 예약 자
 
 자동화는 [recurring-jobs frontmatter table](/docs/recurring-jobs#frontmatter)의 모든 필드를 공유합니다. 다음 추가 필드는 이벤트 트리거, 조건 및 실행 모드를 제어합니다.
 
-| 필드          | 유형                             | 기본값       | 설명                                                                                                                                                                |
-| ------------- | -------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `triggerType` | `"schedule"` \| `"event"`        | `"schedule"` | 자동화 실행 방법                                                                                                                                                    |
-| `event`       | 문자열                           | _(선택사항)_ | 구독할 이벤트 이름(이벤트 트리거에만 해당)                                                                                                                          |
-| `condition`   | 문자열                           | _(선택사항)_ | 배송 전 자연어 조건 평가                                                                                                                                            |
-| `mode`        | `"agentic"` \| `"deterministic"` | `"agentic"`  | 전체 에이전트 루프. (`"deterministic"`는 예약되어 있지만 아직 구현되지 않았습니다. 이를 설정한 자동화는 건너뜁니다. 모든 현재 자동화에는 `"agentic"`를 사용하세요.) |
-| `domain`      | 문자열                           | _(선택사항)_ | 그룹화 태그(메일, 캘린더, 클립 등)                                                                                                                                  |
+| 필드          | 유형                      | 기본값       | 설명                                                                                                                                            |
+| ------------- | ------------------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| `triggerType` | `"schedule"` \| `"event"` | `"schedule"` | 자동화 실행 방법                                                                                                                                |
+| `event`       | 문자열                    | _(선택사항)_ | 구독할 이벤트 이름(이벤트 트리거에만 해당)                                                                                                      |
+| `condition`   | 문자열                    | _(선택사항)_ | 배송 전 자연어 조건 평가                                                                                                                        |
+| `mode`        | `"agentic"`               | `"agentic"`  | 전체 에이전트 루프(유일하게 지원되는 모드). `"deterministic"`는 제거되었습니다 — 구현된 적이 없으며, 이를 설정한 자동화는 실행된 적이 없습니다. |
+| `domain`      | 문자열                    | _(선택사항)_ | 그룹화 태그(메일, 캘린더, 클립 등)                                                                                                              |
 
 이벤트 트리거의 경우 `schedule`는 `""`(비어 있음)입니다. 일정 트리거의 경우 cron 표현식을 전달합니다. 또한 디스패처는 스케줄러와 동일한 관리형 `lastRun` / `lastStatus` / `lastError` 필드를 작성하고 조건이 false로 평가되면 `"skipped"` 상태도 작성합니다.
 

package/docs/content/locales/ko-KR/external-agents.mdx

@@ -136,7 +136,7 @@ OAuth 토큰. ChatGPT는 검토 또는 게시된 커넥터 도구를 유지할
 도구 또는 MCP 앱 메타데이터가 변경되었습니다. 아직 오래된 앱별 커넥터가 있는 경우
 각 오래된 커넥터를 디스패치, 새로 고치거나 다시 연결하는 것과 함께 활성화됩니다. 업데이트 중
 디스패치는 ChatGPT 또는 Claude의 캐시된 캘린더/메일/등을 다시 쓰지 않습니다.
-스냅샷. `mcp:read` / `mcp:write` / `mcp:apps` 범위는 아래의
+스냅샷. `mcp:read` / `mcp:write` / `mcp:apps` / `offline_access` 범위는 아래의
 [표준 원격 MCP OAuth](#standard-oauth)에서 설명하는 범위와 같습니다.
 
 Cursor, Goose, Postman, MCPJam 및 VS Code GitHub Copilot은 동일한 리모컨을 사용합니다.
@@ -283,13 +283,14 @@ OAuth 흐름은 새로 고침 토큰 순환이 포함된 인증 코드 + PKCE입
 
 현재 범위는 다음과 같습니다:
 
-| 범위        | 허용                                                      |
-| ----------- | --------------------------------------------------------- |
-| `mcp:read`  | 읽기 전용 MCP actions 및 일반 도구/리소스 검색            |
-| `mcp:write` | actions 및 `ask-agent` 메타 도구 변형                     |
-| `mcp:apps`  | MCP 지원되는 경우 앱 리소스 목록/읽기 및 인라인 UI 렌더링 |
+| 범위             | 허용                                                      |
+| ---------------- | --------------------------------------------------------- |
+| `mcp:read`       | 읽기 전용 MCP actions 및 일반 도구/리소스 검색            |
+| `mcp:write`      | actions 및 `ask-agent` 메타 도구 변형                     |
+| `mcp:apps`       | MCP 지원되는 경우 앱 리소스 목록/읽기 및 인라인 UI 렌더링 |
+| `offline_access` | 호스트 연결을 유지하기 위한 새로 고침 토큰 액세스         |
 
-클라이언트가 명시적인 범위를 요청하지 않으면 앱은 세 가지 범위를 모두 허용하므로 커넥터는 브라우저에서 승인된 Connect 흐름처럼 작동합니다. 바로 붙여넣을 수 있는 구성 블록이 필요한 로컬 개발, 대체 호스트 및 클라이언트에 대해 베어러 토큰 연결 페이지와 `npx @agent-native/core@latest connect --token <token>` 대체를 유지하세요.
+클라이언트가 명시적인 범위를 요청하지 않으면 앱은 네 가지 범위를 모두 허용하므로 커넥터는 브라우저에서 승인된 Connect 흐름처럼 작동하고 다시 로그인하지 않고 액세스를 새로 고칠 수 있습니다. 바로 붙여넣을 수 있는 구성 블록이 필요한 로컬 개발, 대체 호스트 및 클라이언트에 대해 베어러 토큰 연결 페이지와 `npx @agent-native/core@latest connect --token <token>` 대체를 유지하세요.
 
 ## 카탈로그 계층 {#catalog-tiers}
 

package/docs/content/locales/ko-KR/getting-started.mdx

@@ -163,7 +163,13 @@ export const responseInsights = table("response_insights", {
   />
 </WireframeBlock>
 
-`view-screen`과 `navigate`를 확장해 agent가 현재 route를 알고 `/response-insights`를 열 수 있게 합니다. 결과에 `href: "/response-insights"`를 넣으면 채팅에 "응답 인사이트 열기" 버튼을 표시할 수 있습니다.
+## 6. agent가 탐색하게 하기 {#agent-navigation}
+
+Chat 템플릿에는 `view-screen`과 `navigate` action이 포함되어 있습니다. 앱이 성장함에 따라 이를 확장하세요:
+
+- `view-screen`은 application state를 읽어 현재 route, 선택된 insight, 활성 필터, agent에게 필요한 간결한 페이지 컨텍스트를 반환해야 합니다.
+- `navigate`는 agent가 사용자에게 결과를 시각적으로 확인시켜야 한다고 판단할 때 `/response-insights`와 같은 same-origin 경로를 기록해야 합니다.
+- action 결과에는 `href: "/response-insights"` 같은 링크를 포함할 수 있어, chat이 명시적인 "응답 인사이트 열기" 버튼을 제공할 수 있습니다.
 
 전체 페이지 chat에서 app 페이지를 열 때는 [Agent Surfaces](/docs/agent-surfaces#rich-chat)의 `AgentChatSurface`, `AgentSidebar`, `useAgentChatHomeHandoff`, `useAgentChatHomeHandoffLinks`, `chatViewTransition`을 사용해 같은 thread를 유지한 채 chat을 사이드바로 이동시킵니다.
 

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

@@ -59,7 +59,7 @@ export const i18nCatalog = {
 ```
 
 항상 `en-US`를 번들로 묶으세요. 영어가 아닌 카탈로그를 동적 가져오기하여 사용자만
-활성 로캘을 다운로드합니다. 지원되는 로캘 코드는 `en-US`, `zh-CN`,
+활성 로캘을 다운로드합니다. 지원되는 로캘 코드는 `en-US`, `zh-CN`, `zh-TW`,
 `es-ES`, `fr-FR`, `de-DE`, `ja-JP`, `ko-KR`, `pt-BR`, `hi-IN` 및 `ar-SA`.
 
 ## UI

package/docs/content/locales/ko-KR/mcp-protocol.mdx

@@ -240,7 +240,7 @@ claude mcp add --transport http agent-native https://dispatch.agent-native.com/_
 
 ```http
 HTTP/1.1 401 Unauthorized
-WWW-Authenticate: Bearer resource_metadata="https://dispatch.agent-native.com/.well-known/oauth-protected-resource", scope="mcp:read mcp:write mcp:apps"
+WWW-Authenticate: Bearer resource_metadata="https://dispatch.agent-native.com/.well-known/oauth-protected-resource", scope="mcp:read mcp:write mcp:apps offline_access"
 ```
 
 검색 엔드포인트:

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

@@ -0,0 +1,20 @@
+---
+title: 패키지 수명 주기
+description: 매니페스트 기반 Agent Native 패키지를 안전하게 검사하고 추가하거나 꺼냅니다.
+---
+
+# 패키지 수명 주기
+
+재사용 패키지는 버전이 지정된 정적 `agent-native.package.json`을 게시할 수
+있습니다. CLI는 검사 중 이 JSON만 읽고 패키지 코드를 실행하지 않습니다.
+
+```bash
+agent-native package inspect @agent-native/scheduling --json
+agent-native package add @agent-native/scheduling --apply
+agent-native package eject @agent-native/scheduling --apply
+```
+
+추가와 꺼내기는 기본적으로 미리 보기입니다. `--apply`를 지정해야 파일을 쓰고
+패키지 관리자를 실행합니다. 충돌과 알 수 없는 레이아웃은 거부하며 설치가
+실패하면 파일과 잠금 파일을 복원합니다. 파일럿에서는 Scheduling만 꺼낼 수
+있으며 Pinpoint는 보류합니다.

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

@@ -101,6 +101,10 @@ Agent-Native에는 좁은 뒤에 있는 문제를 고려하는 두 개의 어댑
       path: "index.ts",
       note: "선택: getSandboxAdapter() / registerSandboxAdapter()",
     },
+    {
+      path: "background.ts",
+      note: "내구성 큐 마커와 백그라운드 실행 수명 주기",
+    },
     {
       path: "local-child-process-adapter.ts",
       note: "기본 backend: 잠긴 Node child process",
@@ -181,12 +185,17 @@ registerSandboxAdapter(adapter)  →  AGENT_NATIVE_SANDBOX  →  local default
 
 ### `AGENT_NATIVE_SANDBOX` 환경 변수 {#env}
 
-ID별로 내장 어댑터를 선택합니다. 현재는 `local`(기본값)만 연결되어 있습니다. 알 수 없는 값은 실행에 실패하지 않고 로컬로 대체됩니다.
+ID별로 내장 어댑터를 선택합니다. `local`(기본값)과 `background`가 모두 연결되어 있습니다. 알 수 없는 값은 실행에 실패하지 않고 `local`로 대체됩니다.
 
 ```bash
-AGENT_NATIVE_SANDBOX=local   # 기본값 - 명시적
+AGENT_NATIVE_SANDBOX=local        # 기본값 - 명시적
+AGENT_NATIVE_SANDBOX=background   # 모든 run-code 호출을 내구성 큐에 추가
 ```
 
+`background`는 원시 코드를 `sandbox_executions`에 저장하고 `status: "queued"`와 `executionId`를 즉시 반환합니다. 서명된 self-dispatch는 새로운 serverless 호출을 시작하고, 장기 실행 Node는 프로세스 내에서 분리된 작업을 시작합니다. 상태 polling과 주기적 sweep은 누락된 dispatch 또는 만료된 lease를 다시 구동합니다. 영구 저장된 결과는 나중에 실행을 polling하여 가져옵니다.
+
+`BackgroundQueueAdapter`는 내구성 큐 마커이지 executor가 아닙니다. 큐에 있는 작업은 사용 가능한 경우 등록된 non-queued execution adapter를 사용하고, 그렇지 않으면 로컬 child process로 대체됩니다. `background`만 선택해도 원격 또는 컨테이너 격리가 제공되지 않으며 edge 런타임이 `node:child_process`와 호환되는 것도 아닙니다.
+
 ### `registerSandboxAdapter()` {#register}
 
 호스트 프로세스는 솔기의 `index.ts`를 통한 모든 후속 `run-code` 호출에 대해 백엔드를 재정의합니다. 예를 들어 원격 컨테이너에서 모든 호출을 실행합니다.
@@ -211,13 +220,15 @@ registerSandboxAdapter(new RemoteSandboxAdapter());
 
 ## 튼튼한 러너를 위한 솔기 {#durable}
 
-이 인터페이스는 의도적으로 미래의 원격/내구성 샌드박스를 위한 이음새입니다. 원격 또는 내구성 있는 어댑터(Docker, Vercel-Sandbox 스타일 실행기 또는 대기 중인 백그라운드 작업자)는 다음을 수행합니다.
+내장 `background` 어댑터는 이미 내구성 큐와 새로운 실행 예산을 제공하지만 실제 실행은 계속 non-queued adapter 또는 로컬 child-process fallback을 사용합니다. 별도로 등록한 원격 또는 격리 어댑터(Docker나 Vercel-Sandbox 스타일 실행기)는 다른 실행 경계를 제공하고 호출별 백그라운드 작업도 실행할 수 있습니다.
+
+이러한 어댑터는 다음을 수행합니다.
 
 1. out-of-process 런타임에 대해 `SandboxAdapter.run`를 구현합니다.
-2. 루프백 브리지(또는 프록시 브리지가 상위 브리지로 다시 호출)를 터널링합니다.
-3. 요청 수명 주기와 관계없이 대규모 데이터 작업을 완료할 수 있습니다. 이는 로컬 하위 프로세스 어댑터를 제한하는 호스팅된 최대 40초 코드 실행 한도를 초과합니다.
+2. 루프백 브리지를 터널링하거나 브리지 호출을 상위 프로세스로 프록시합니다.
+3. 제공된 내구성 큐 수명 주기와 독립적으로 원격 또는 컨테이너 격리를 제공합니다.
 
-새로운 `AGENT_NATIVE_SANDBOX` 값(예: `remote`) 및/또는 `registerSandboxAdapter()`를 통해 등록하세요. 에이전트 루프와 `run-code.ts`는 절대 변경되지 않습니다.
+`registerSandboxAdapter()`를 통해 프로그래밍 방식으로 등록하세요. 에이전트 루프와 `run-code.ts`를 변경할 필요가 없습니다.
 
 > [!TIP]
 > `agent-native add sandbox docker` 청사진은 이 솔기에 대해 Docker 어댑터를 구현하기 위한 완전하고 독립적인 레시피를 내보냅니다. [Blueprint Installer](/docs/blueprint-installer)를 참조하세요.

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

@@ -386,6 +386,8 @@ A2A_SECRET=your-shared-secret-at-least-32-chars
 - [ ] `AGENT_NATIVE_KEYS_WORKSPACE_FALLBACK`는 조직이 실제로 작업 공간 키를 공유하지 않는 한 **설정되지 않습니다** — [Cross-User Tooling Secrets](#tooling-secrets) 참조
 - [ ] 다중 테넌트 배포에서 **사용자는 자신의 `ANTHROPIC_API_KEY`를 가져옵니다** — 프레임워크는 배포 수준 env var로 폴백하는 것을 거부합니다.
 
+`agent-native doctor`(스캐폴딩된 앱에서는 `pnpm doctor`)를 실행하면 이 체크리스트의 스키마, 자격 증명, 환경 변수 항목을 자동으로 확인할 수 있습니다 — 각 결과는 guard, 파일, 줄을 알려줍니다. 자세한 내용은 [Doctor](/docs/doctor) 문서를 참조하세요.
+
 ---
 
 아래 섹션에서는 특정 배포에서만 사용할 수 있는 틈새 환경 플래그를 다룹니다. 대부분의 앱은 절대 터치하지 않습니다.
@@ -413,3 +415,11 @@ AGENT_NATIVE_KEYS_WORKSPACE_FALLBACK=1
 ```
 
 작업 영역 범위 비밀 쓰기에는 이 플래그에 관계없이 여전히 조직 소유자/관리자 역할이 필요합니다.
+
+## 다음 단계
+
+- [**Authentication**](/docs/authentication) — 이 페이지가 기반으로 하는 인증 모드, cookie realm, 세션 세부 정보
+- [**Multi-Tenancy**](/docs/multi-tenancy) — `org_id` 스코핑 뒤에 있는 조직 멤버십 모델
+- [**Sharing**](/docs/sharing) — 공유 가능한 리소스에 적용되는 `ownableColumns()` 및 access-guard 패턴
+- [**Messaging**](/docs/messaging#env-vars) — 위 체크리스트에서 참조하는 통합별 webhook 서명 비밀
+- [**Deployment**](/docs/deployment) — 이 체크리스트가 설정되어 있다고 가정하는 프로덕션 환경 변수

package/docs/content/locales/pt-BR/audit-log.mdx

@@ -73,10 +73,11 @@ Tudo em `audit` é opcional. A adição mínima útil é `target: () => ({ type,
 
 ## Lendo a trilha {#reading}
 
-Duas leituras actions estão disponíveis para o agente **e** o frontend em cada aplicativo, com escopo SQL para o chamador — eles nunca retornam as linhas de outro locatário:
+Três leituras actions estão disponíveis para o agente **e** o frontend em cada aplicativo, com escopo SQL para o chamador — eles nunca retornam as linhas de outro locatário:
 
 - **`list-audit-events`** — filtrar por `targetType` / `targetId`, `actorKind` (`agent` | `human` | `system`), `status`, `threadId` / `turnId`, `action`, `sinceMs` e `limit`.
 - **`get-audit-event`** — um evento por ID, incluindo sua carga útil de entrada editada.
+- **`export-audit-events`** — exporta a trilha em massa como CSV ou NDJSON em vez de paginar manualmente `list-audit-events`, para extrações de conformidade offline. Aceita os mesmos filtros de `list-audit-events` (sem `limit`) mais `format` (`csv` | `ndjson`, padrão `csv`) e `maxRows` (padrão 5000, limite máximo 10000), e retorna `{ content, rowCount, truncated, format }` — `truncated: true` significa que mais linhas corresponderam do que `maxRows` permitia. É, em si, uma leitura sensível, auditada via `audit: { onRead: true }`.
 
 Crie um feed de atividades ou uma linha "quem mudou isto" chamando `list-audit-events` do UI com `useActionQuery` — nunca escreva manualmente uma busca na tabela de auditoria:
 

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

@@ -381,7 +381,7 @@ Modelos com **páginas públicas** (compartilhar links, incorporações, página
 /_agent-native/sign-in?return=<same-origin-path>
 ```
 
-Quando um visualizador anônimo acessa este URL, a página de login do framework é exibida. Após um login bem-sucedido (qualquer fluxo – token, e-mail/senha ou Google OAuth), o visualizador é direcionado para 302 para `return`.
+Quando um visualizador anônimo acessa este URL, a página de login do framework é exibida. Após um login bem-sucedido (qualquer fluxo – token, e-mail/senha ou Google OAuth), o navegador retorna a `return`.
 
 O parâmetro `return` é validado como um **caminho de mesma origem**. Referências de caminho de rede (`//evil.com/...`), URLs absolutos, esquemas `data:`/`javascript:` e caracteres de controle incorporados retornam para `/`. O caminho validado é reconstruído a partir do analisador URL, e não retornado da entrada.
 
@@ -402,7 +402,7 @@ function SignInCta() {
 
 ### Caminhos privados marcados
 
-Quando um usuário anônimo navega diretamente para um caminho privado como `/dashboard`, a estrutura já serve a página de login nesse URL — após o login bem-sucedido, a página é recarregada e o usuário chega ao `/dashboard`. Não é necessário nenhum tratamento especial; isso funciona para token, e-mail/senha **e** Google OAuth.
+As páginas normais do aplicativo usam um único shell SSR impessoal e armazenável em cache público para todos os visitantes. O `AppProviders` verifica a sessão no cliente; em um caminho privado como `/dashboard`, ele redireciona o visitante anônimo para `/_agent-native/sign-in?return=%2Fdashboard` antes de montar a interface privada. Após o login, o visitante retorna a `/dashboard`. Use `isPublicPath` para rotas públicas/SEO ou `sessionBypass` para uma superfície autenticada por outro mecanismo limitado, como um token de incorporação MCP.
 
 ### Nos bastidores: Google OAuth
 

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

@@ -114,13 +114,13 @@ O terceiro caminho — escrever o arquivo `jobs/<name>.md` manualmente via `reso
 
 As automações compartilham todos os campos do [recurring-jobs frontmatter table](/docs/recurring-jobs#frontmatter). Esses campos adicionais controlam gatilhos de eventos, condições e modo de execução:
 
-| Campo         | Tipo                             | Padrão       | Descrição                                                                                                                                                                             |
-| ------------- | -------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `triggerType` | `"schedule"` \| `"event"`        | `"schedule"` | Como a automação é acionada                                                                                                                                                           |
-| `event`       | string                           | _(opcional)_ | Nome do evento para assinatura (somente acionadores de eventos)                                                                                                                       |
-| `condition`   | string                           | _(opcional)_ | Condição de linguagem natural avaliada antes do envio                                                                                                                                 |
-| `mode`        | `"agentic"` \| `"deterministic"` | `"agentic"`  | Loop completo do agente. (`"deterministic"` está reservado, mas ainda não implementado — as automações que o definem são ignoradas. Use `"agentic"` para todas as automações atuais.) |
-| `domain`      | string                           | _(opcional)_ | Tag de agrupamento (e-mail, calendário, clipes etc.)                                                                                                                                  |
+| Campo         | Tipo                      | Padrão       | Descrição                                                                                                                                                        |
+| ------------- | ------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `triggerType` | `"schedule"` \| `"event"` | `"schedule"` | Como a automação é acionada                                                                                                                                      |
+| `event`       | string                    | _(opcional)_ | Nome do evento para assinatura (somente acionadores de eventos)                                                                                                  |
+| `condition`   | string                    | _(opcional)_ | Condição de linguagem natural avaliada antes do envio                                                                                                            |
+| `mode`        | `"agentic"`               | `"agentic"`  | Loop completo do agente (o único modo suportado). `"deterministic"` foi removido — nunca foi implementado, e as automações que o definiam nunca eram disparadas. |
+| `domain`      | string                    | _(opcional)_ | Tag de agrupamento (e-mail, calendário, clipes etc.)                                                                                                             |
 
 Para um acionador de evento, `schedule` é `""` (vazio); para um gatilho de agendamento, ele carrega a expressão cron. O despachante também grava os mesmos campos gerenciados `lastRun`/`lastStatus`/`lastError` que o agendador faz, além de um status `"skipped"` quando uma condição é avaliada como falsa.
 

package/docs/content/locales/pt-BR/external-agents.mdx

@@ -136,7 +136,7 @@ instantâneo até que você o atualize/revise novamente, então verifique novame
 alterações nos metadados da ferramenta ou do aplicativo MCP. Se você ainda tiver conectores por aplicativo antigos
 ativado junto com Dispatch, atualize ou reconecte cada conector obsoleto; atualizando
 O Dispatch não reescreve o calendário/correio/etc em cache de ChatGPT ou Claude.
-instantâneos. Os escopos `mcp:read` / `mcp:write` / `mcp:apps` são os mesmos
+instantâneos. Os escopos `mcp:read` / `mcp:write` / `mcp:apps` / `offline_access` são os mesmos
 descritos abaixo em
 [OAuth remoto padrão do MCP](#standard-oauth).
 
@@ -284,13 +284,14 @@ O fluxo OAuth é código de autorização + PKCE com rotação de token de atual
 
 Os escopos atuais são:
 
-| Escopo      | Permite                                                                                     |
-| ----------- | ------------------------------------------------------------------------------------------- |
-| `mcp:read`  | MCP somente leitura actions e descoberta comum de ferramentas/recursos                      |
-| `mcp:write` | mutação de actions e da meta-ferramenta `ask-agent`                                         |
-| `mcp:apps`  | Listagem/leitura de recursos de aplicativos MCP e renderização UI in-line quando compatível |
+| Escopo           | Permite                                                                                     |
+| ---------------- | ------------------------------------------------------------------------------------------- |
+| `mcp:read`       | MCP somente leitura actions e descoberta comum de ferramentas/recursos                      |
+| `mcp:write`      | mutação de actions e da meta-ferramenta `ask-agent`                                         |
+| `mcp:apps`       | Listagem/leitura de recursos de aplicativos MCP e renderização UI in-line quando compatível |
+| `offline_access` | Acesso ao token de atualização para manter o host conectado                                 |
 
-Quando o cliente não solicita nenhum escopo explícito, o aplicativo concede todos os três para que o conector se comporte como o fluxo do Connect autorizado pelo navegador. Mantenha a página Connect do token de portador e o substituto `npx @agent-native/core@latest connect --token <token>` para desenvolvedores locais, hosts substitutos e clientes onde você precisa de um bloco de configuração pronto para colar.
+Quando o cliente não solicita nenhum escopo explícito, o aplicativo concede todos os quatro para que o conector se comporte como o fluxo do Connect autorizado pelo navegador e possa atualizar o acesso sem outro login. Mantenha a página Connect do token de portador e o substituto `npx @agent-native/core@latest connect --token <token>` para desenvolvedores locais, hosts substitutos e clientes onde você precisa de um bloco de configuração pronto para colar.
 
 ## Níveis de catálogo {#catalog-tiers}
 

package/docs/content/locales/pt-BR/getting-started.mdx

@@ -163,7 +163,13 @@ Adicione a route `/response-insights` com `useActionQuery("list-response-insight
   />
 </WireframeBlock>
 
-Estenda `view-screen` e `navigate` para que o agent saiba a route atual e possa abrir `/response-insights`. Resultados também podem incluir `href: "/response-insights"` para mostrar um botão "Abrir insights de respostas".
+## 6. Deixe o agent navegar {#agent-navigation}
+
+O template de Chat inclui as actions `view-screen` e `navigate`. Estenda-as conforme sua app cresce:
+
+- `view-screen` deve ler o application state e retornar a route atual, o insight selecionado, os filtros ativos e qualquer contexto compacto de página que o agent precise.
+- `navigate` deve escrever um caminho same-origin como `/response-insights` quando o agent decidir que o usuário deve inspecionar o resultado visualmente.
+- Resultados de action podem incluir links como `href: "/response-insights"` para que o chat ofereça um botão explícito "Abrir insights de respostas".
 
 Quando o chat em página inteira abrir uma página da app, use `AgentChatSurface`, `AgentSidebar`, `useAgentChatHomeHandoff`, `useAgentChatHomeHandoffLinks` e `chatViewTransition` de [Agent Surfaces](/docs/agent-surfaces#rich-chat) para mover o chat para a lateral sem perder o thread.
 

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

@@ -59,7 +59,7 @@ export const i18nCatalog = {
 ```
 
 Sempre inclua `en-US`. Importação dinâmica de catálogos em idiomas diferentes do inglês apenas para usuários
-baixe a localidade ativa. Os códigos de localidade suportados são `en-US`, `zh-CN`,
+baixe a localidade ativa. Os códigos de localidade suportados são `en-US`, `zh-CN`, `zh-TW`,
 `es-ES`, `fr-FR`, `de-DE`, `ja-JP`, `ko-KR`, `pt-BR`, `hi-IN` e `ar-SA`.
 
 ## UI

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

@@ -240,7 +240,7 @@ A primeira solicitação MCP não autenticada recebe:
 
 ```http
 HTTP/1.1 401 Unauthorized
-WWW-Authenticate: Bearer resource_metadata="https://dispatch.agent-native.com/.well-known/oauth-protected-resource", scope="mcp:read mcp:write mcp:apps"
+WWW-Authenticate: Bearer resource_metadata="https://dispatch.agent-native.com/.well-known/oauth-protected-resource", scope="mcp:read mcp:write mcp:apps offline_access"
 ```
 
 Endpoints de descoberta:

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

@@ -0,0 +1,21 @@
+---
+title: Ciclo de vida de pacotes
+description: Inspecione, adicione e ejete pacotes Agent Native orientados por manifesto.
+---
+
+# Ciclo de vida de pacotes
+
+Pacotes reutilizáveis podem publicar um `agent-native.package.json` estático e
+versionado. A CLI lê somente esse JSON e não executa código do pacote durante a
+inspeção.
+
+```bash
+agent-native package inspect @agent-native/scheduling --json
+agent-native package add @agent-native/scheduling --apply
+agent-native package eject @agent-native/scheduling --apply
+```
+
+Adicionar e ejetar são simulações por padrão. `--apply` permite gravações e
+executa o gerenciador de pacotes. A CLI recusa colisões e layouts desconhecidos
+e restaura arquivos e lockfiles se a instalação falhar. Apenas Scheduling pode
+ser ejetado neste piloto; Pinpoint fica adiado.

package/docs/content/locales/pt-BR/sandbox-adapters.mdx

@@ -103,6 +103,10 @@ A costura reside no núcleo em `packages/core/src/coding-tools/sandbox/` — `ad
       path: "index.ts",
       note: "Seleção: getSandboxAdapter() / registerSandboxAdapter()",
     },
+    {
+      path: "background.ts",
+      note: "marcador de fila durável e ciclo de vida da execução em segundo plano",
+    },
     {
       path: "local-child-process-adapter.ts",
       note: "O backend padrão: processo filho Node bloqueado",
@@ -183,12 +187,17 @@ registerSandboxAdapter(adapter)  →  AGENT_NATIVE_SANDBOX  →  local default
 
 ### Var ambiente `AGENT_NATIVE_SANDBOX` {#env}
 
-Seleciona um adaptador integrado por ID. Atualmente apenas `local` (o padrão) está conectado; valores desconhecidos voltam para o local em vez de falhar na execução.
+Seleciona um adaptador integrado por ID. Tanto `local` (o padrão) quanto `background` estão conectados; valores desconhecidos voltam para `local` em vez de falhar na execução.
 
 ```bash
-AGENT_NATIVE_SANDBOX=local   # o padrão - explícito
+AGENT_NATIVE_SANDBOX=local        # o padrão - explícito
+AGENT_NATIVE_SANDBOX=background   # enfileira cada chamada run-code de forma durável
 ```
 
+`background` armazena o código bruto em `sandbox_executions` e retorna imediatamente um `executionId` com `status: "queued"`. Um auto-dispatch assinado inicia uma nova invocação serverless; um processo Node de longa duração inicia trabalho desacoplado no processo; a consulta de status e a varredura periódica reativam dispatches perdidos ou leases expirados. Consulte a execução mais tarde para obter o resultado persistido.
+
+`BackgroundQueueAdapter` é um marcador de fila durável, não o executor. O trabalho enfileirado usa um adaptador de execução registrado que não seja de fila quando disponível; caso contrário, volta para o processo filho local. Selecionar apenas `background` não fornece isolamento remoto nem de contêiner e não torna um runtime edge compatível com `node:child_process`.
+
 ### `registerSandboxAdapter()` {#register}
 
 Um processo host substitui o backend para todas as invocações `run-code` subsequentes por meio do `index.ts` da costura — por exemplo, para executar todas as chamadas em um contêiner remoto:
@@ -213,13 +222,15 @@ registerSandboxAdapter(new RemoteSandboxAdapter());
 
 ## A costura para um corredor durável {#durable}
 
-Esta interface é deliberadamente a costura para uma futura sandbox remota/durável. Um adaptador remoto ou durável (Docker, um executor estilo Vercel-Sandbox ou um trabalhador em segundo plano na fila) faria:
+O adaptador integrado `background` já fornece enfileiramento durável e um novo orçamento de execução, enquanto a execução real ainda usa um adaptador que não seja de fila ou o processo filho local como fallback. Um adaptador remoto ou isolado registrado separadamente (Docker ou um executor estilo Vercel-Sandbox) pode fornecer outro limite de execução e também executar trabalho em segundo plano por chamada.
+
+Esse adaptador:
 
-1. Implemente `SandboxAdapter.run` em um tempo de execução fora do processo.
-2. Coloque um túnel na ponte de loopback (ou chamadas da ponte proxy de volta para o pai).
-3. Permita que grandes trabalhos de dados sejam executados até a conclusão independentemente do ciclo de vida da solicitação, excedendo o limite máximo de execução de código hospedado de aproximadamente 40 anos que limita o adaptador de processo filho local.
+1. Implementaria `SandboxAdapter.run` em um runtime fora do processo.
+2. Criaria um túnel para a ponte de loopback ou encaminharia suas chamadas ao processo pai.
+3. Forneceria isolamento remoto ou de contêiner independentemente do ciclo de vida da fila durável incluída.
 
-Registre-o com um novo valor `AGENT_NATIVE_SANDBOX` (por exemplo, `remote`) e/ou via `registerSandboxAdapter()`. O loop do agente e `run-code.ts` nunca mudam.
+Registre-o programaticamente por meio de `registerSandboxAdapter()`. O loop do agente e `run-code.ts` não precisam mudar.
 
 > [!TIP]
 > O blueprint `agent-native add sandbox docker` emite uma receita completa e independente para implementar um adaptador Docker nessa junção. Consulte [Blueprint Installer](/docs/blueprint-installer).

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

@@ -392,6 +392,8 @@ Anteriormente, essa era uma postura de "avisar e aceitar" - defina o segredo que
 - [ ] `AGENT_NATIVE_KEYS_WORKSPACE_FALLBACK` **não** é definido, a menos que sua organização realmente compartilhe chaves de espaço de trabalho — consulte [Cross-User Tooling Secrets](#tooling-secrets)
 - [ ] Em implantações multilocatários, **os usuários trazem seu próprio `ANTHROPIC_API_KEY`** — a estrutura se recusa a voltar para o ambiente de nível de implantação var
 
+Execute `agent-native doctor` (`pnpm doctor` em um app gerado pelo scaffold) para verificar automaticamente os itens de esquema, credenciais e variáveis de ambiente desta checklist — cada descoberta indica o guard, o arquivo e a linha. Consulte a documentação do [Doctor](/docs/doctor).
+
 ---
 
 As seções abaixo abordam sinalizadores de ambiente de nicho que você só alcança em implantações específicas. A maioria dos aplicativos nunca toca neles.
@@ -419,3 +421,11 @@ AGENT_NATIVE_KEYS_WORKSPACE_FALLBACK=1
 ```
 
 As gravações secretas no escopo do workspace ainda exigem a função de proprietário/administrador da organização, independentemente dessa sinalização.
+
+## Próximos passos
+
+- [**Authentication**](/docs/authentication) — modos de autenticação, cookie realms e detalhes de sessão sobre os quais esta página se baseia
+- [**Multi-Tenancy**](/docs/multi-tenancy) — o modelo de associação à organização por trás do escopo `org_id`
+- [**Sharing**](/docs/sharing) — o padrão `ownableColumns()` e de access-guard aplicado a recursos compartilháveis
+- [**Messaging**](/docs/messaging#env-vars) — os segredos de assinatura de webhook por integração referenciados na lista de verificação acima
+- [**Deployment**](/docs/deployment) — as variáveis de ambiente de produção que esta lista de verificação pressupõe estarem definidas

package/docs/content/locales/zh-CN/audit-log.mdx

@@ -73,10 +73,11 @@ export default defineAction({
 
 ## 阅读踪迹 {#reading}
 
-每个应用程序中的代理**和**前端都可以使用两个读取的actions，调用者的范围在SQL中 - 它们永远不会返回其他租户的行：
+每个应用程序中的代理**和**前端都可以使用三个读取的actions，调用者的范围在SQL中 - 它们永远不会返回其他租户的行：
 
 - **`list-audit-events`** — 按 `targetType` / `targetId`、`actorKind` (`agent` | `human` | `system`)、`status`、`threadId` / `turnId`、`action` 过滤， `sinceMs`、`limit`。
 - **`get-audit-event`** — 按 id 的一个事件，包括其经过编辑的输入负载。
+- **`export-audit-events`** — 以 CSV 或 NDJSON 形式批量导出审计记录，而不必手动翻页 `list-audit-events`，用于离线合规性提取。使用与 `list-audit-events` 相同的过滤器（不含 `limit`），另加 `format`（`csv` | `ndjson`，默认 `csv`）和 `maxRows`（默认 5000，硬上限 10000），返回 `{ content, rowCount, truncated, format }` —— `truncated: true` 表示匹配的行数超过了 `maxRows` 允许的数量。它本身也是一次敏感读取，通过 `audit: { onRead: true }` 进行审计。
 
 通过使用 `useActionQuery` 从 UI 调用 `list-audit-events` 来构建活动源或“谁更改了此”行 - 切勿手写对审核表的提取：
 

package/docs/content/locales/zh-CN/authentication.mdx

@@ -381,7 +381,7 @@ function MyComponent() {
 /_agent-native/sign-in?return=<same-origin-path>
 ```
 
-当匿名查看者点击此 URL 时，将提供框架的登录页面。成功登录（任何流程 - 令牌、电子邮件/密码或 谷歌OAuth）后，查看者将 302 转至 `return`。
+当匿名查看者点击此 URL 时，将提供框架的登录页面。成功登录（任何流程 - 令牌、电子邮件/密码或 谷歌OAuth）后，浏览器会返回 `return`。
 
 `return` 参数被验证为**同源路径**。网络路径引用 (`//evil.com/...`)、绝对 URL、`data:` / `javascript:` 方案和嵌入式控制字符都回退到 `/`。验证的路径是从 URL 解析器重建的，而不是从输入中回显。
 
@@ -402,7 +402,7 @@ function SignInCta() {
 
 ### 已添加书签的私有路径
 
-当匿名用户直接导航到 `/dashboard` 等私有路径时，框架已经在该 URL 处提供登录页面 - 成功登录后，页面重新加载并且用户登陆 `/dashboard`。无需特殊处理；这适用于令牌、电子邮件/密码、**和** 谷歌OAuth。
+普通应用页面为所有访问者使用同一个非个性化、可公开缓存的 SSR 外壳。`AppProviders` 在客户端检查会话；访问 `/dashboard` 等私有路径时，它会在挂载私有应用界面之前将匿名访问者重定向到 `/_agent-native/sign-in?return=%2Fdashboard`。登录后，访问者会返回 `/dashboard`。公共或 SEO 路由请使用 `isPublicPath`；通过 MCP 嵌入令牌等其他受限机制认证的界面请使用 `sessionBypass`。
 
 ### 幕后花絮：谷歌OAuth
 

package/docs/content/locales/zh-CN/automations.mdx

@@ -114,13 +114,13 @@ description: "具有自然语言条件的事件触发和计划自动化"
 
 自动化共享 [recurring-jobs frontmatter table](/docs/recurring-jobs#frontmatter) 中的每个字段。这些附加字段控制事件触发器、条件和执行模式：
 
-| 字段          | 类型                             | 默认         | 描述                                                                                                                   |
-| ------------- | -------------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------- |
-| `triggerType` | `"schedule"` \| `"event"`        | `"schedule"` | 自动化如何启动                                                                                                         |
-| `event`       | 字符串                           | _（可选）_   | 要订阅的事件名称（仅限事件触发器）                                                                                     |
-| `condition`   | 字符串                           | _（可选）_   | 在调度之前评估自然语言条件                                                                                             |
-| `mode`        | `"agentic"` \| `"deterministic"` | `"agentic"`  | 完整的代理循环。 （`"deterministic"` 已保留，但尚未实现 - 设置它的自动化将被跳过。对所有当前自动化使用 `"agentic"`。） |
-| `domain`      | 字符串                           | _（可选）_   | 分组标签（邮件、日历、剪辑等）                                                                                         |
+| 字段          | 类型                      | 默认         | 描述                                                                                                           |
+| ------------- | ------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------- |
+| `triggerType` | `"schedule"` \| `"event"` | `"schedule"` | 自动化如何启动                                                                                                 |
+| `event`       | 字符串                    | _（可选）_   | 要订阅的事件名称（仅限事件触发器）                                                                             |
+| `condition`   | 字符串                    | _（可选）_   | 在调度之前评估自然语言条件                                                                                     |
+| `mode`        | `"agentic"`               | `"agentic"`  | 完整的代理循环（唯一受支持的模式）。`"deterministic"` 已被移除——它从未被实现过，设置该模式的自动化从未被触发。 |
+| `domain`      | 字符串                    | _（可选）_   | 分组标签（邮件、日历、剪辑等）                                                                                 |
 
 对于事件触发器，`schedule`为`""`（空）；对于计划触发器，它带有 cron 表达式。调度程序还写入与调度程序相同的托管 `lastRun` / `lastStatus` / `lastError` 字段，以及当条件评估为 false 时的 `"skipped"` 状态。
 

package/docs/content/locales/zh-CN/external-agents.mdx

@@ -136,7 +136,7 @@ OAuth 代币。 ChatGPT可以保留已审查或已发布的连接器工具
 工具或 MCP 应用元数据更改。如果您仍然有旧的每应用连接器
 与调度、刷新或重新连接每个过时的连接器一起启用；正在更新
 Dispatch 不会重写 ChatGPT 或 Claude 的缓存日历/邮件/等。
-快照。`mcp:read` / `mcp:write` / `mcp:apps` 范围与下文
+快照。`mcp:read` / `mcp:write` / `mcp:apps` / `offline_access` 范围与下文
 [标准远程 MCP OAuth](#standard-oauth) 中介绍的相同。
 
 Cursor、Goose、Postman、MCPJam 和 VS Code GitHub Copilot 使用相同的遥控器
@@ -283,13 +283,14 @@ OAuth 流程是授权代码 + PKCE 和刷新令牌轮换。访问令牌是受众
 
 当前范围是：
 
-| 范围        | 允许                                             |
-| ----------- | ------------------------------------------------ |
-| `mcp:read`  | 只读MCP actions和普通工具/资源发现               |
-| `mcp:write` | 变异 actions 和 `ask-agent` 元工具               |
-| `mcp:apps`  | MCP Apps 资源列表/读取和内联 UI 渲染（如果支持） |
+| 范围             | 允许                                             |
+| ---------------- | ------------------------------------------------ |
+| `mcp:read`       | 只读MCP actions和普通工具/资源发现               |
+| `mcp:write`      | 变异 actions 和 `ask-agent` 元工具               |
+| `mcp:apps`       | MCP Apps 资源列表/读取和内联 UI 渲染（如果支持） |
+| `offline_access` | 刷新令牌访问权限，使主机保持连接                 |
 
-当客户端请求没有明确的范围时，应用程序会授予所有三个范围，因此连接器的行为类似于浏览器授权的连接流。为本地开发人员、后备主机和需要准备粘贴配置块的客户端保留不记名令牌连接页面和 `npx @agent-native/core@latest connect --token <token>` 后备。
+当客户端请求没有明确的范围时，应用程序会授予所有四个范围，因此连接器的行为类似于浏览器授权的连接流，并且可以在无需再次登录的情况下刷新访问权限。为本地开发人员、后备主机和需要准备粘贴配置块的客户端保留不记名令牌连接页面和 `npx @agent-native/core@latest connect --token <token>` 后备。
 
 ## 目录层 {#catalog-tiers}
 

package/docs/content/locales/zh-CN/getting-started.mdx

@@ -174,11 +174,13 @@ export const responseInsights = table("response_insights", {
   />
 </WireframeBlock>
 
-扩展 `view-screen` 和 `navigate`：
+## 6. 让 agent 导航 {#agent-navigation}
 
-- `view-screen` 返回当前 route、选中的 insight 和页面上下文。
-- `navigate` 写入 `/response-insights` 这样的同源 path。
-- action 结果可以包含 `href: "/response-insights"`，让聊天显示“打开回复洞察”按钮。
+Chat 模板包含 `view-screen` 和 `navigate` action。随着应用的成长扩展它们：
+
+- `view-screen` 应读取 application state，返回当前 route、选中的 insight、生效的筛选条件，以及 agent 需要的任何精简页面上下文。
+- 当 agent 判断用户需要直观查看结果时，`navigate` 应写入 `/response-insights` 这样的同源 path。
+- action 结果可以包含 `href: “/response-insights”` 这样的链接，让聊天提供明确的”打开回复洞察”按钮。
 
 当完整聊天页打开 app 页面时，使用 [Agent Surfaces](/docs/agent-surfaces#rich-chat) 里的 `AgentChatSurface`、`AgentSidebar`、`useAgentChatHomeHandoff`、`useAgentChatHomeHandoffLinks` 和 `chatViewTransition`，让聊天滑到侧边栏并保留同一个 thread。
 

package/docs/content/locales/zh-CN/internationalization.mdx

@@ -59,7 +59,7 @@ export const i18nCatalog = {
 ```
 
 始终捆绑 `en-US`。动态导入非英语目录，仅限用户
-下载活动区域设置。支持的区域设置代码为 `en-US`、`zh-CN`、
+下载活动区域设置。支持的区域设置代码为 `en-US`、`zh-CN`、`zh-TW`、
 `es-ES`、`fr-FR`、`de-DE`、`ja-JP`、`ko-KR`、`pt-BR`、`hi-IN` 和 `ar-SA`。
 
 ## UI

package/docs/content/locales/zh-CN/mcp-protocol.mdx

@@ -240,7 +240,7 @@ claude mcp add --transport http agent-native https://dispatch.agent-native.com/_
 
 ```http
 HTTP/1.1 401 Unauthorized
-WWW-Authenticate: Bearer resource_metadata="https://dispatch.agent-native.com/.well-known/oauth-protected-resource", scope="mcp:read mcp:write mcp:apps"
+WWW-Authenticate: Bearer resource_metadata="https://dispatch.agent-native.com/.well-known/oauth-protected-resource", scope="mcp:read mcp:write mcp:apps offline_access"
 ```
 
 发现端点：

package/docs/content/locales/zh-CN/package-lifecycle.mdx

@@ -0,0 +1,19 @@
+---
+title: 软件包生命周期
+description: 安全检查、添加和弹出由清单驱动的 Agent Native 软件包。
+---
+
+# 软件包生命周期
+
+可复用软件包可以发布带版本的静态 `agent-native.package.json`。CLI 在检查时
+只读取此 JSON，不执行软件包代码。
+
+```bash
+agent-native package inspect @agent-native/scheduling --json
+agent-native package add @agent-native/scheduling --apply
+agent-native package eject @agent-native/scheduling --apply
+```
+
+添加和弹出默认仅预览。只有指定 `--apply` 才会写入文件并运行检测到的软件包
+管理器。CLI 会拒绝冲突和未知布局；安装失败时会还原文件和锁文件。试点阶段
+仅支持弹出 Scheduling，Pinpoint 暂不迁移。