@agent-native/core 0.95.1 → 0.97.0

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

@@ -413,3 +413,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/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/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/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

@@ -419,3 +419,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/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/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/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 暂不迁移。

package/docs/content/locales/zh-CN/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: "默认后端：受限的 Node 子进程",
@@ -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`。签名的自分发会启动新的 serverless 调用；长时间运行的 Node 会在进程内启动分离任务；状态轮询和定期 sweep 会重新驱动丢失的分发或已过期的 lease。稍后轮询该执行即可获取持久化结果。
+
+`BackgroundQueueAdapter` 是持久队列标记，而不是执行器。排队的工作会在可用时使用已注册的非队列执行适配器，否则回退到本地子进程。仅选择 `background` 不会提供远程或容器隔离，也不会让 edge 运行时兼容 `node:child_process`。
+
 ### `registerSandboxAdapter()` {#register}
 
 主机进程通过接缝的 `index.ts` 覆盖所有后续 `run-code` 调用的后端 - 例如，运行远程容器中的每个调用：
@@ -211,13 +220,15 @@ registerSandboxAdapter(new RemoteSandboxAdapter());
 
 ## 耐用跑鞋的接缝 {#durable}
 
-这个接口是特意为未来的远程/持久沙箱做的接缝。远程或持久适配器（Docker、Vercel-Sandbox 式运行程序或排队后台工作程序）将：
+内置 `background` 适配器已经提供持久排队和新的执行预算，但实际执行仍使用非队列适配器或本地子进程回退。单独注册的远程或隔离适配器（Docker 或 Vercel-Sandbox 式运行器）可以提供不同的执行边界，也可以执行每次调用的后台工作。
+
+此类适配器将：
 
 1. 针对进程外运行时实现 `SandboxAdapter.run`。
-2. 通过隧道环回网桥（或代理网桥回调至父级）。
-3. 让大数据作业独立于请求生命周期运行直至完成 - 超过限制本地子进程适配器的托管约 40 秒代码执行上限。
+2. 为 loopback 网桥建立隧道，或将网桥调用代理回父进程。
+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/zh-CN/security.mdx

@@ -413,3 +413,11 @@ AGENT_NATIVE_KEYS_WORKSPACE_FALLBACK=1
 ```
 
 无论此标志如何，工作空间范围的秘密写入仍然需要组织所有者/管理员角色。
+
+## 下一步
+
+- [**Authentication**](/docs/authentication) — 本页所依赖的身份验证模式、cookie realm 和会话细节
+- [**Multi-Tenancy**](/docs/multi-tenancy) — `org_id` 范围界定背后的组织成员模型
+- [**Sharing**](/docs/sharing) — 应用于可共享资源的 `ownableColumns()` 和访问守卫模式
+- [**Messaging**](/docs/messaging#env-vars) — 上方清单中提到的每个集成的 webhook 签名密钥
+- [**Deployment**](/docs/deployment) — 此清单假定已设置的生产环境变量

package/docs/content/locales/zh-TW/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-TW/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-TW/getting-started.mdx

@@ -171,11 +171,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-TW/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-TW/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 暫不納入。

package/docs/content/locales/zh-TW/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: "預設後端：受限的 Node 子行程",
@@ -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`。簽署的自我派送會啟動新的 serverless 呼叫；長時間執行的 Node 會在行程內啟動分離工作；狀態輪詢與定期 sweep 會重新驅動遺失的派送或已過期的 lease。稍後輪詢該執行即可取得持久化結果。
+
+`BackgroundQueueAdapter` 是持久佇列標記，而不是執行器。佇列中的工作會在可用時使用已註冊的非佇列執行轉接器，否則回退到本機子行程。僅選取 `background` 不會提供遠端或容器隔離，也不會讓 edge 執行環境與 `node:child_process` 相容。
+
 ### `registerSandboxAdapter()` {#register}
 
 主機行程透過接縫的 `index.ts` 覆蓋所有後續 `run-code` 呼叫的後端 - 例如，執行遠端容器中的每個呼叫：
@@ -211,13 +220,15 @@ registerSandboxAdapter(new RemoteSandboxAdapter());
 
 ## 耐用跑鞋的接縫 {#durable}
 
-這個介面是特意為未來的遠端/持久沙箱做的接縫。遠端或持久轉接器（Docker、Vercel-Sandbox 式執行程式或排隊背景工作程式）將：
+內建 `background` 轉接器已提供持久排隊與新的執行預算，但實際執行仍使用非佇列轉接器或本機子行程回退。另行註冊的遠端或隔離轉接器（Docker 或 Vercel-Sandbox 式執行器）可以提供不同的執行邊界，也可以執行每次呼叫的背景工作。
+
+此類轉接器將：
 
-1. 針對行程外執行時實現 `SandboxAdapter.run`。
-2. 透過隧道環回網橋（或代理網橋回調至父級）。
-3. 讓大資料作業獨立於請求生命週期執行直至完成 - 超過限制本機子行程轉接器的託管約 40 秒程式碼執行上限。
+1. 針對行程外執行環境實作 `SandboxAdapter.run`。
+2. 為 loopback 橋接建立通道，或將橋接呼叫代理回父行程。
+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/zh-TW/security.mdx

@@ -415,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()` 和存取守衛模式
+- [**Messaging**](/docs/messaging#env-vars) — 上方清單中提到的每個整合的 webhook 簽名金鑰
+- [**Deployment**](/docs/deployment) — 此清單假定已設定的正式環境變數

package/docs/content/package-lifecycle.mdx

@@ -0,0 +1,51 @@
+---
+title: Package Lifecycle
+description: Inspect, add, and eject manifest-driven Agent Native packages safely.
+---
+
+# Package lifecycle
+
+Reusable Agent Native packages can publish a versioned static
+`agent-native.package.json`. The CLI reads that JSON without executing package
+code and reports the package's actions, schema entry point, skills, secret key
+names, and peer providers.
+
+```bash
+agent-native package inspect @agent-native/scheduling
+agent-native package inspect @agent-native/scheduling --json
+agent-native package add @agent-native/scheduling
+agent-native package add @agent-native/scheduling --apply
+agent-native package eject @agent-native/scheduling --apply
+```
+
+`add` and `eject` are dry-run by default. `--apply` is required before the CLI
+writes files or runs the detected package manager. Use `--root` for a different
+project root; at a workspace root, pass `--app <name>` to select the target app.
+
+## Safety and idempotency
+
+Before writing, the CLI resolves every contribution and refuses missing or
+ambiguous layouts, existing files with different content, escaping manifest
+paths, and eject targets that already exist. It stages the complete write set,
+uses atomic renames, snapshots package and lock files, and rolls back if the
+package-manager install fails. A provenance record under
+`.agent-native/packages/` makes a repeated add a no-op when generated files are
+unchanged.
+
+Inspection and registry staging use static package metadata only. The CLI never
+imports a package's JavaScript manifest and passes `--ignore-scripts` while
+downloading an uninstalled package archive. Reports show credential key names,
+never credential values.
+
+## Scheduling pilot
+
+`@agent-native/scheduling` is the first package with the generic manifest. Add
+creates action re-export stubs, adds the schema export, copies its agent skills,
+records the dependency, and reports required secret names and providers.
+Eject copies the published Scheduling source to `packages/scheduling`, switches
+the dependency to `workspace:*`, and preserves canonical
+`@agent-native/scheduling` imports so workspace resolution selects the local
+copy.
+
+Ejecting other packages, including Pinpoint, is intentionally refused until the
+Scheduling pilot has proven the contract.