@agent-native/core 0.96.0 → 0.98.0

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

@@ -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/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/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/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/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-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/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-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

@@ -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/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/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/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/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/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",
@@ -321,7 +333,7 @@
     "y-protocols": "^1.0.7",
     "yjs": "^13.6.31",
     "zod": "^4.3.6",
-    "@agent-native/toolkit": "^0.4.5"
+    "@agent-native/toolkit": "^0.4.7"
   },
   "devDependencies": {
     "@ai-sdk/anthropic": "^3.0.71",
@@ -365,7 +377,6 @@
     "react-dom": "^19.2.7",
     "react-router": "^8.1.0",
     "tailwindcss": "^4.2.4",
-    "typescript": "npm:@typescript/typescript6@^6.0.2",
     "typescript-7": "npm:typescript@^7.0.2",
     "vite": "8.1.0",
     "vitest": "^4.1.5",

package/src/templates/default/.agents/skills/frontend-design/SKILL.md

@@ -48,7 +48,7 @@ Default to Apple/Linear-level restraint: make the primary workflow obvious, then
 
 - **Typography**: Use the product's existing type system first. For net-new public pages, choose characterful but readable type and keep sizing appropriate to the surface.
 - **Color and theme**: Use semantic tokens and CSS variables. Avoid one-note palettes and default purple/blue gradients unless the brand demands them.
-- **Motion**: Prefer purposeful transitions and small state changes. Use CSS transitions/keyframes unless the app already uses a motion library.
+- **Motion**: Prefer purposeful transitions and small state changes. Use CSS transitions/keyframes unless the app already uses a motion library. Never `transition-all` — list the properties that actually change (e.g. `transition-[opacity,transform]`). Use the shared easing tokens defined in `packages/core/src/styles/agent-native.css` instead of hand-typing curves: `var(--ease-drawer)` (260ms, drawers/app chrome), `var(--ease-collapse)` (200ms, expand/collapse), `var(--ease-out-strong)` (snappy entrances) — in Tailwind, `ease-[var(--ease-collapse)]`. Enter/exit with ease-out, never `ease-in`. Overlays that zoom in must set the Radix origin var (e.g. `origin-[--radix-popover-content-transform-origin]`). Animate `transform`/`opacity`, not width/height/padding/box-shadow. Gate looping or large-movement animations with `motion-reduce:`. Command palettes and keyboard-triggered actions get no animation.
 - **Composition**: Match the workflow. Operational apps should be dense and scannable; marketing or portfolio pages can be more immersive.
 - **Visual assets**: Websites, games, and object-focused pages need real or generated media when images help users understand the subject.
 - **Responsive fit**: Text must not overflow buttons, cards, tabs, sidebars, or fixed-format tools. Use stable dimensions for boards, grids, toolbars, and counters.

package/src/templates/default/app/i18n/ar-SA.ts

@@ -391,6 +391,12 @@ const messages = {
     contentLabel: "المحتوى",
     previewTitle: "معاينة الامتداد",
     previewEmpty: "ستظهر المعاينة هنا",
+    loadError: "تعذر تحميل الإضافات.",
+    widgetsLoadError: "تعذر تحميل الأدوات.",
+    widgetAreasLoadError: "تعذر تحميل مناطق الأدوات.",
+    historyLoadError: "تعذر تحميل سجل الإضافة.",
+    versionLoadError: "تعذر تحميل إصدار الإضافة هذا.",
+    retry: "إعادة المحاولة",
   },
   org: {
     createTitle: "قم بإنشاء مؤسستك",

package/src/templates/default/app/i18n/de-DE.ts

@@ -378,6 +378,12 @@ const messages = {
     contentLabel: "Inhalt",
     previewTitle: "Erweiterungsvorschau",
     previewEmpty: "Hier wird eine Vorschau angezeigt",
+    loadError: "Erweiterungen konnten nicht geladen werden.",
+    widgetsLoadError: "Widgets konnten nicht geladen werden.",
+    widgetAreasLoadError: "Widget-Bereiche konnten nicht geladen werden.",
+    historyLoadError: "Der Erweiterungsverlauf konnte nicht geladen werden.",
+    versionLoadError: "Diese Erweiterungsversion konnte nicht geladen werden.",
+    retry: "Erneut versuchen",
   },
   org: {
     createTitle: "Erstellen Sie Ihre Organisation",

package/src/templates/default/app/i18n/en-US.ts

@@ -369,6 +369,12 @@ const messages = {
     contentLabel: "Content",
     previewTitle: "Extension preview",
     previewEmpty: "Preview will appear here",
+    loadError: "Couldn't load extensions.",
+    widgetsLoadError: "Couldn't load widgets.",
+    widgetAreasLoadError: "Couldn't load widget areas.",
+    historyLoadError: "Couldn't load extension history.",
+    versionLoadError: "Couldn't load this extension version.",
+    retry: "Retry",
   },
   org: {
     createTitle: "Create your organization",

package/src/templates/default/app/i18n/es-ES.ts

@@ -385,6 +385,12 @@ const messages = {
     contentLabel: "Contenido",
     previewTitle: "Vista previa de la extensión",
     previewEmpty: "La vista previa aparecerá aquí",
+    loadError: "No se pudieron cargar las extensiones.",
+    widgetsLoadError: "No se pudieron cargar los widgets.",
+    widgetAreasLoadError: "No se pudieron cargar las áreas de widgets.",
+    historyLoadError: "No se pudo cargar el historial de la extensión.",
+    versionLoadError: "No se pudo cargar esta versión de la extensión.",
+    retry: "Reintentar",
   },
   org: {
     createTitle: "Crea tu organización",

package/src/templates/default/app/i18n/fr-FR.ts

@@ -383,6 +383,12 @@ const messages = {
     contentLabel: "Contenu",
     previewTitle: "Aperçu des extensions",
     previewEmpty: "L'aperçu apparaîtra ici",
+    loadError: "Impossible de charger les extensions.",
+    widgetsLoadError: "Impossible de charger les widgets.",
+    widgetAreasLoadError: "Impossible de charger les zones de widgets.",
+    historyLoadError: "Impossible de charger l'historique de l'extension.",
+    versionLoadError: "Impossible de charger cette version de l'extension.",
+    retry: "Réessayer",
   },
   org: {
     createTitle: "Créez votre organisation",

package/src/templates/default/app/i18n/hi-IN.ts

@@ -365,6 +365,12 @@ const messages = {
     contentLabel: "कॉन्टेंट",
     previewTitle: "एक्सटेंशन पूर्वावलोकन",
     previewEmpty: "पूर्वावलोकन यहां दिखाई देगा",
+    loadError: "एक्सटेंशन लोड नहीं हो सके।",
+    widgetsLoadError: "विजेट लोड नहीं हो सके।",
+    widgetAreasLoadError: "विजेट क्षेत्र लोड नहीं हो सके।",
+    historyLoadError: "एक्सटेंशन इतिहास लोड नहीं हो सका।",
+    versionLoadError: "यह एक्सटेंशन संस्करण लोड नहीं हो सका।",
+    retry: "पुनः प्रयास करें",
   },
   org: {
     createTitle: "अपना संगठन बनाएं",

package/src/templates/default/app/i18n/ja-JP.ts

@@ -370,6 +370,12 @@ const messages = {
     contentLabel: "コンテンツ",
     previewTitle: "拡張機能のプレビュー",
     previewEmpty: "ここにプレビューが表示されます",
+    loadError: "拡張機能を読み込めませんでした。",
+    widgetsLoadError: "ウィジェットを読み込めませんでした。",
+    widgetAreasLoadError: "ウィジェット領域を読み込めませんでした。",
+    historyLoadError: "拡張機能の履歴を読み込めませんでした。",
+    versionLoadError: "この拡張機能のバージョンを読み込めませんでした。",
+    retry: "再試行",
   },
   org: {
     createTitle: "組織を作成する",

package/src/templates/default/app/i18n/ko-KR.ts

@@ -363,6 +363,12 @@ const messages = {
     contentLabel: "콘텐츠",
     previewTitle: "확장 프로그램 미리보기",
     previewEmpty: "미리보기가 여기에 표시됩니다.",
+    loadError: "확장 프로그램을 불러올 수 없습니다.",
+    widgetsLoadError: "위젯을 불러올 수 없습니다.",
+    widgetAreasLoadError: "위젯 영역을 불러올 수 없습니다.",
+    historyLoadError: "확장 프로그램 기록을 불러올 수 없습니다.",
+    versionLoadError: "이 확장 프로그램 버전을 불러올 수 없습니다.",
+    retry: "다시 시도",
   },
   org: {
     createTitle: "조직 만들기",

package/src/templates/default/app/i18n/pt-BR.ts

@@ -382,6 +382,12 @@ const messages = {
     contentLabel: "Conteúdo",
     previewTitle: "Visualização da extensão",
     previewEmpty: "A visualização aparecerá aqui",
+    loadError: "Não foi possível carregar as extensões.",
+    widgetsLoadError: "Não foi possível carregar os widgets.",
+    widgetAreasLoadError: "Não foi possível carregar as áreas de widgets.",
+    historyLoadError: "Não foi possível carregar o histórico da extensão.",
+    versionLoadError: "Não foi possível carregar esta versão da extensão.",
+    retry: "Tentar novamente",
   },
   org: {
     createTitle: "Crie sua organização",