@agent-native/core 0.96.0 → 0.98.0

package/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/docs/content/locales/zh-CN/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`** - 框架拒绝回退到部署级别环境变量
 
+运行 `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()` 和访问守卫模式
+- [**Messaging**](/docs/messaging#env-vars) — 上方清单中提到的每个集成的 webhook 签名密钥
+- [**Deployment**](/docs/deployment) — 此清单假定已设置的生产环境变量

package/corpus/core/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/corpus/core/docs/content/locales/zh-TW/authentication.mdx

@@ -381,7 +381,7 @@ function MyComponent() {
 /_agent-native/sign-in?return=<same-origin-path>
 ```
 
-當匿名檢視者點選此 URL 時，將提供框架的登入頁面。成功登入（任何流程 - 權杖、電子郵件/密碼或 GoogleOAuth）後，檢視者將 302 轉至 `return`。
+當匿名檢視者點選此 URL 時，將提供框架的登入頁面。成功登入（任何流程 - 權杖、電子郵件/密碼或 GoogleOAuth）後，瀏覽器會返回 `return`。
 
 `return` 參數被驗證為**同來源路徑**。網路路徑引用 (`//evil.com/...`)、絕對 URL、`data:` / `javascript:` 方案和嵌入式控制字符都回退到 `/`。驗證的路徑是從 URL 解析器重建的，而不是從輸入中回顯。
 
@@ -402,7 +402,7 @@ function SignInCta() {
 
 ### 已新增書簽的私人路徑
 
-當匿名使用者直接導覽到 `/dashboard` 等私人路徑時，框架已經在該 URL 處提供登入頁面 - 成功登入後，頁面重新載入並且使用者登陸 `/dashboard`。無需特殊處理；這適用於權杖、電子郵件/密碼、**和** GoogleOAuth。
+一般應用程式頁面會為所有訪客使用同一個非個人化、可公開快取的 SSR 外殼。`AppProviders` 會在用戶端檢查工作階段；造訪 `/dashboard` 等私人路徑時，它會在掛載私人應用程式介面之前將匿名訪客重新導向至 `/_agent-native/sign-in?return=%2Fdashboard`。登入後，訪客會返回 `/dashboard`。公開或 SEO 路由請使用 `isPublicPath`；透過 MCP 內嵌權杖等其他受限機制驗證的介面請使用 `sessionBypass`。
 
 ### 幕後花絮：GoogleOAuth
 

package/corpus/core/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/corpus/core/docs/content/locales/zh-TW/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/corpus/core/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/corpus/core/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/corpus/core/docs/content/locales/zh-TW/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/corpus/core/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/corpus/core/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/corpus/core/docs/content/locales/zh-TW/security.mdx

@@ -388,6 +388,8 @@ A2A_SECRET=your-shared-secret-at-least-32-chars
 - [ ] `AGENT_NATIVE_KEYS_WORKSPACE_FALLBACK` **未**設定，除非您的組織實際上共用工作區金鑰 - 請參閱 [Cross-User Tooling Secrets](#tooling-secrets)
 - [] 在多租戶部署中，**使用者自帶 `ANTHROPIC_API_KEY`** - 框架拒絕回退到部署層級環境變數
 
+執行 `agent-native doctor`（在鷹架產生的應用程式中為 `pnpm doctor`）可自動檢查此清單中的架構、憑證和環境變數項目 — 每項發現都會標明 guard、檔案與行號。請參閱 [Doctor](/docs/doctor) 文件。
+
 ---
 
 以下部分介紹了您只能在特定部署中使用的利基環境標誌。大多數應用程式從不接觸它們。
@@ -415,3 +417,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/corpus/core/docs/content/mcp-protocol.mdx

@@ -247,7 +247,7 @@ The first unauthenticated MCP request receives:
 
 ```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"
 ```
 
 Discovery endpoints:

package/corpus/core/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.

package/corpus/core/docs/content/sandbox-adapters.mdx

@@ -106,6 +106,10 @@ The seam lives in core at `packages/core/src/coding-tools/sandbox/` — `adapter
       path: "index.ts",
       note: "selection: getSandboxAdapter() / registerSandboxAdapter()",
     },
+    {
+      path: "background.ts",
+      note: "durable queue marker and background execution lifecycle",
+    },
     {
       path: "local-child-process-adapter.ts",
       note: "the default backend — locked-down Node child process",
@@ -189,12 +193,17 @@ registerSandboxAdapter(adapter)  →  AGENT_NATIVE_SANDBOX  →  local default
 
 #### `AGENT_NATIVE_SANDBOX` env var {#env}
 
-Selects a built-in adapter by id. Currently only `local` (the default) is wired; unknown values fall back to local rather than failing the run.
+Selects a built-in adapter by id. Both `local` (the default) and `background` are wired; unknown values fall back to local rather than failing the run.
 
 ```bash
-AGENT_NATIVE_SANDBOX=local   # the default — explicit
+AGENT_NATIVE_SANDBOX=local        # the default — explicit
+AGENT_NATIVE_SANDBOX=background   # enqueue every run-code call durably
 ```
 
+`background` stores the raw code in `sandbox_executions` and returns an `executionId` with `status: "queued"` immediately. A signed self-dispatch starts a fresh serverless invocation; long-lived Node starts detached in-process work; status polling and the periodic sweep redrive lost dispatches or expired leases. Poll the execution later for its persisted result.
+
+`BackgroundQueueAdapter` is a durable queue marker, not the executor. Queued work uses a registered non-queued execution adapter when one is available; otherwise it falls back to the local child process. Selecting `background` alone does not provide remote or container isolation, and it does not make an edge runtime compatible with `node:child_process`.
+
 #### `registerSandboxAdapter()` {#register}
 
 A host process overrides the backend for all subsequent `run-code` invocations through the seam's `index.ts` — for example, to run every call in a remote container:
@@ -219,13 +228,15 @@ registerSandboxAdapter(new RemoteSandboxAdapter());
 
 ### The seam for a durable runner {#durable}
 
-This interface is deliberately the seam for a future remote/durable sandbox. A remote or durable adapter (Docker, a Vercel-Sandbox-style runner, or a queued background worker) would:
+The built-in `background` adapter already provides durable queuing and a fresh execution budget, while actual execution still uses a non-queued adapter or the local child-process fallback. A separately registered remote or isolated adapter (Docker or a Vercel-Sandbox-style runner) can provide a different execution boundary and can also execute per-call background work.
+
+Such an adapter would:
 
 1. Implement `SandboxAdapter.run` against an out-of-process runtime.
 2. Tunnel the loopback bridge (or proxy bridge calls back to the parent).
-3. Let large data jobs run to completion independently of the request lifecycle — exceeding the hosted ~40s code-exec ceiling that bounds the local child-process adapter.
+3. Supply remote or container isolation independently of the shipped durable queue lifecycle.
 
-Register it under a new `AGENT_NATIVE_SANDBOX` value (e.g. `remote`) and/or via `registerSandboxAdapter()`. The agent loop and `run-code.ts` never change.
+Register it programmatically via `registerSandboxAdapter()`. The agent loop and `run-code.ts` do not need to change.
 
 <Callout id="doc-block-adap1tip" tone="info">
 

package/corpus/core/docs/content/security.mdx

@@ -388,6 +388,8 @@ This was previously a "warn and accept" stance — set the secret you'd otherwis
 - [ ] `AGENT_NATIVE_KEYS_WORKSPACE_FALLBACK` is **not** set unless your org actually shares workspace keys — see [Cross-User Tooling Secrets](#tooling-secrets)
 - [ ] In multi-tenant deployments, **users bring their own `ANTHROPIC_API_KEY`** — the framework refuses to fall back to the deploy-level env var
 
+Run `agent-native doctor` (`pnpm doctor` in a scaffolded app) to check the schema, credential, and environment-variable items on this checklist automatically — every finding names the guard, file, and line. See the [Doctor](/docs/doctor) docs.
+
 ---
 
 The sections below cover niche environment flags you only reach for in specific deployments. Most apps never touch them.

package/corpus/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.96.0",
+  "version": "0.98.0",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {
@@ -101,6 +101,10 @@
     "./shared": "./dist/shared/index.js",
     "./voice": "./dist/voice/index.js",
     "./scripts": "./dist/scripts/index.js",
+    "./guards": {
+      "types": "./dist/guards/index.d.ts",
+      "default": "./dist/guards/index.js"
+    },
     "./application-state": "./dist/application-state/index.js",
     "./settings": "./dist/settings/index.js",
     "./localization": "./dist/localization/index.js",
@@ -180,6 +184,10 @@
       "types": "./dist/cli/skills.d.ts",
       "default": "./dist/cli/skills.js"
     },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "default": "./dist/testing.js"
+    },
     "./router": "./dist/router/index.js",
     "./collab": "./dist/collab/index.js",
     "./a2a": "./dist/a2a/index.js",
@@ -207,6 +215,10 @@
       "default": "./dist/local-artifacts/index.js"
     },
     "./workspace-files": "./dist/workspace-files/index.js",
+    "./package-lifecycle": {
+      "types": "./dist/package-lifecycle/index.d.ts",
+      "default": "./dist/package-lifecycle/index.js"
+    },
     "./code-agents": "./dist/code-agents/index.js",
     "./code-agents/transcript-normalizer": "./dist/code-agents/transcript-normalizer.js",
     "./workspace-connections": "./dist/workspace-connections/index.js",
@@ -373,7 +385,6 @@
     "react-dom": "^19.2.7",
     "react-router": "^8.1.0",
     "tailwindcss": "catalog:",
-    "typescript": "catalog:",
     "typescript-7": "catalog:",
     "vite": "catalog:",
     "vitest": "^4.1.5",