@agent-native/core 0.92.7 → 0.92.9

package/docs/content/locales/zh-TW/a2a-protocol.mdx

@@ -436,6 +436,18 @@ const client = new A2AClient(url, process.env.A2A_API_KEY);
 
 JWT 驗證（`server.ts` 中的 `verifyA2AToken`）接受使用全域 `A2A_SECRET` 或透過權杖的 `org_domain` 聲明從 SQL 尋找的組織範圍秘密簽名的權杖，並在存在時強制執行權杖自己的 `aud`/`iss` 聲明。
 
+### 組織密鑰同步 {#organization-secret-sync}
+
+**組織 → 跨應用程式驗證**設定會管理組織範圍的密鑰，用來驗證同一組織中個別部署的應用程式之間的委派。它不是使用者登入或 Cross-App SSO 設定。此密鑰補充部署的 `A2A_SECRET`：具有 `org_domain` 宣告的 A2A JWT 可使用相符組織的密鑰驗證。
+
+組織擁有者應為每個參與的應用程式提供相同的允許電子郵件網域與相同的組織範圍密鑰：
+
+1. 在第一個應用程式中，從**組織 → 跨應用程式驗證**產生或顯示密鑰。
+2. 在每個其他應用程式中，選擇**從另一個應用程式貼上密鑰**並貼上該值。首次連線必須進行這個手動步驟：尚未擁有該密鑰的應用程式無法驗證遠端同步要求。
+3. 應用程式共用此密鑰後，使用**同步到應用程式**將後續更新推送至已連線且已探索到的應用程式。結果會回報無法更新的應用程式。
+
+當您**重新產生**密鑰時，設定 UI 會立即同步它，並使用先前的密鑰簽署更新，讓已連線的應用程式可以驗證變更。如果某個應用程式錯過該同步，請在其中手動貼上新密鑰，然後再次同步。請像對待其他憑證一樣對待此密鑰：不要將它放入用戶端程式碼、日誌或第三方用戶端設定中。
+
 ## 繼續 {#continuations}
 
 當代理呼叫未立即返回的遠端 A2A 對等點時，框架會輪詢 `tasks/get` 直到工作解決。這是透過 `A2AClient.sendAndWait` 連線的，這是 `callAgent()` 幫助程式使用的預設模式。

package/docs/content/locales/zh-TW/pr-visual-recap.mdx

@@ -138,11 +138,11 @@ npx @agent-native/core@latest recap doctor
 
 除了後端之外，兩個儲存庫變數還可以調整代理的執行方式：
 
-- **`VISUAL_RECAP_MODEL`** 固定傳遞給 CLI (`--model`) 的模型 — 例如 `gpt-5.5` 用於 Codex，或 Claude 模型 ID。保留其未設定以使用 CLI 自己的預設模型。
+- **`VISUAL_RECAP_MODEL`** 固定傳遞給 CLI (`--model`) 的模型 — 例如 `gpt-5.6-sol` 用於 Codex，或 Claude 模型 ID。保留其未設定以使用 CLI 自己的預設模型。
 - **`VISUAL_RECAP_REASONING`** 設定推理深度：`none`、`minimal`、`low`、`medium`、`high` 或 `xhigh`。適用於Codex後端； Claude 的推理是模型驅動的，因此該變數被忽略。
 - **`VISUAL_RECAP_SKILL_SOURCE`** 控制提示新鮮度：`auto`/unset 使用最新的捆綁技能指南，而 `repo` 固定到已提交的儲存庫本機 `visual-recap` 技能資料夾。
 
-例如，要在 Codex 和 GPT-5.5 上以高推理執行回顧，請設定儲存庫變數 `VISUAL_RECAP_AGENT=codex`、`VISUAL_RECAP_MODEL=gpt-5.5` 和 `VISUAL_RECAP_REASONING=high`。
+例如，要在 Codex 和 GPT-5.6 Sol 上以高推理執行回顧，請設定儲存庫變數 `VISUAL_RECAP_AGENT=codex`、`VISUAL_RECAP_MODEL=gpt-5.6-sol` 和 `VISUAL_RECAP_REASONING=high`。
 
 ## 秘密和變數
 
@@ -191,7 +191,7 @@ npx @agent-native/core@latest recap setup
 | ------------------------ | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
 | `OPENAI_API_KEY`         | —                               | 秘密。與 `VISUAL_RECAP_AGENT=codex` 一起設定以使用 Codex 執行回顧。                                                          |
 | `VISUAL_RECAP_AGENT`     | `claude`                        | 變數。選取編碼代理後端（`claude` 或 `codex`）。                                                                              |
-| `VISUAL_RECAP_MODEL`     | 每個 CLI 的預設值               | 變數。固定模型 - 例如`gpt-5.5` 表示 Codex，或 Claude 型號 ID。取消設定使用 CLI 自己的預設值。                                |
+| `VISUAL_RECAP_MODEL`     | 每個 CLI 的預設值               | 變數。固定模型 - 例如`gpt-5.6-sol` 表示 Codex，或 Claude 型號 ID。取消設定使用 CLI 自己的預設值。                            |
 | `VISUAL_RECAP_REASONING` | 每個模型的預設值                | 變數。推理深度：`none`、`minimal`、`low`、`medium`、`high` 或 `xhigh`。適用於Codex後端。                                     |
 | `RECAP_CLI_VERSION`      | `latest`                        | 變數。固定工作流程安裝的 `@agent-native/core` CLI 版本 - 例如`1.5.0`。參見[Version pinning](#version-pinning-copy-variant)。 |
 | `PLAN_RECAP_APP_URL`     | `https://plan.agent-native.com` | 秘密。僅當在不同來源自行託管計畫應用時。                                                                                     |

package/docs/content/locales/zh-TW/pure-agent-apps.mdx

@@ -66,6 +66,10 @@ Automation-first app 是無瀏覽器的 Agent-Native app，用於 scheduled jobs
 
 → [**Agent Surfaces — Headless agent**](/docs/agent-surfaces#headless)
 
+## 稍後新增聊天 {#add-chat-later}
+
+`--headless` 只會選擇初始 scaffold；沒有可將現有僅 actions 專案原地轉換為聊天應用程式的 `agent-native` 命令。當使用者需要瀏覽器對話時，請將 [Chat 範本](/docs/template-chat) 作為遷移參考：保留 actions、SQL 資料、instructions 和 skills，並新增瀏覽器 shell、server plugins、`<AgentChatSurface>` 與載入現有 actions 的 chat plugin。請驗證 `pnpm typecheck`，並完成一次呼叫現有 action 的聊天。`agent-native add` 用於 integration blueprints，不用於此轉換。
+
 ## 下一步是什麼
 
 - [**Agent Surfaces — Headless**](/docs/agent-surfaces#headless) — 完整的無頭決策指南和 API

package/docs/content/pr-visual-recap.mdx

@@ -138,11 +138,11 @@ If the variable is unset, the action uses `claude`.
 
 Beyond the backend, two repository variables tune _how_ the agent runs:
 
-- **`VISUAL_RECAP_MODEL`** pins the model passed to the CLI (`--model`) — for example `gpt-5.5` for Codex, or a Claude model id. Leave it unset to use the CLI's own default model.
+- **`VISUAL_RECAP_MODEL`** pins the model passed to the CLI (`--model`) — for example `gpt-5.6-sol` for Codex, or a Claude model id. Leave it unset to use the CLI's own default model.
 - **`VISUAL_RECAP_REASONING`** sets the reasoning depth: `none`, `minimal`, `low`, `medium`, `high`, or `xhigh`. It applies to the Codex backend; Claude's reasoning is model-driven, so this variable is ignored there.
 - **`VISUAL_RECAP_SKILL_SOURCE`** controls prompt freshness: `auto`/unset uses the latest bundled skill guidance, while `repo` pins to the committed repo-local `visual-recap` skill folder.
 
-For example, to run the recap on Codex with GPT-5.5 at high reasoning, set the repository variables `VISUAL_RECAP_AGENT=codex`, `VISUAL_RECAP_MODEL=gpt-5.5`, and `VISUAL_RECAP_REASONING=high`.
+For example, to run the recap on Codex with GPT-5.6 Sol at high reasoning, set the repository variables `VISUAL_RECAP_AGENT=codex`, `VISUAL_RECAP_MODEL=gpt-5.6-sol`, and `VISUAL_RECAP_REASONING=high`.
 
 ## Secrets and variables
 
@@ -191,7 +191,7 @@ real token.
 | ------------------------ | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
 | `OPENAI_API_KEY`         | —                               | Secret. Set together with `VISUAL_RECAP_AGENT=codex` to run the recap with Codex instead.                                                       |
 | `VISUAL_RECAP_AGENT`     | `claude`                        | Variable. Selects the coding-agent backend (`claude` or `codex`).                                                                               |
-| `VISUAL_RECAP_MODEL`     | each CLI's default              | Variable. Pins the model — e.g. `gpt-5.5` for Codex, or a Claude model id. Unset uses the CLI's own default.                                    |
+| `VISUAL_RECAP_MODEL`     | each CLI's default              | Variable. Pins the model — e.g. `gpt-5.6-sol` for Codex, or a Claude model id. Unset uses the CLI's own default.                                |
 | `VISUAL_RECAP_REASONING` | each model's default            | Variable. Reasoning depth: `none`, `minimal`, `low`, `medium`, `high`, or `xhigh`. Applies to the Codex backend.                                |
 | `RECAP_CLI_VERSION`      | `latest`                        | Variable. Pins the `@agent-native/core` CLI version the workflow installs — e.g. `1.5.0`. See [Version pinning](#version-pinning-copy-variant). |
 | `PLAN_RECAP_APP_URL`     | `https://plan.agent-native.com` | Secret. Only when self-hosting the Plans app at a different origin.                                                                             |

package/docs/content/pure-agent-apps.mdx

@@ -91,6 +91,28 @@ The `--headless` flag only chooses the initial scaffold. It does not choose a
 different architecture. You can later move the same `actions/`, instructions,
 skills, and SQL state into a chat app or full application surface.
 
+## Add chat later {#add-chat-later}
+
+`--headless` is not a permanent runtime mode, and there is no `agent-native`
+command that converts an existing action-only project into a chat app in place.
+When people need a browser conversation surface, use the [Chat template](/docs/template-chat)
+as the migration reference and keep the durable action and database contract:
+
+1. Scaffold a temporary Chat app with the framework version you are migrating
+   to: `npx @agent-native/core@latest create my-chat-reference --template chat`.
+2. Bring its browser shell, server plugins, and UI dependencies into the
+   existing project. In particular, add the full-page `<AgentChatSurface>` and
+   an `agent-chat` plugin that loads the existing action registry.
+3. Keep your action names, Zod schemas, SQL data, instructions, and skills.
+   Chat calls those same actions; it does not replace them.
+4. Verify both surfaces: run `pnpm typecheck`, start the browser app with
+   `pnpm dev`, then complete one chat turn that calls an existing action.
+
+Use `agent-native add` for integration blueprints, not for this conversion.
+Choose chat when people need conversational steering, approvals, or durable
+thread history; add app pages when they need to browse, compare, edit, or share
+persistent objects.
+
 ## What to add next {#whats-next}
 
 - [**Getting Started**](/docs/getting-started) — the chat-first tutorial from action to inline result to durable page

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.92.7",
+  "version": "0.92.9",
   "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": {
@@ -315,7 +315,7 @@
     "y-protocols": "^1.0.7",
     "yjs": "^13.6.31",
     "zod": "^4.3.6",
-    "@agent-native/toolkit": "^0.4.4"
+    "@agent-native/toolkit": "^0.4.5"
   },
   "devDependencies": {
     "@ai-sdk/anthropic": "^3.0.71",