paseo-agy-acp 2.4.2 → 2.5.0

package/CHANGELOG.md

@@ -2,6 +2,43 @@
 
 All notable changes to `paseo-agy-acp` are recorded here.
 
+## 2.5.0 - 2026-10-10
+
+### Changed
+
+- Use the Paseo provider id `paseo-agy-acp` with display name **Antigravity
+  Pro** instead of `antigravity`. Paseo v0.11.2 added its own built-in agy
+  provider (id `antigravity`, display name Antigravity) that starts the host
+  `agy` CLI (`/home/tiezbro/.local/bin/agy`); its login lives in
+  `~/.gemini/antigravity-cli`. This adapter does not start that `agy` CLI; it
+  starts `agy-acp`, which runs the official ACP kernel `agy_acp_server`, and
+  its login lives in `~/.gemini/antigravity-acp`.
+- The built-in provider and this adapter can run at the same time: the built-in
+  provider runs its `agy` processes, and this adapter runs its `agy_acp_server`
+  processes. Separate logins mean two Antigravity accounts, so both accounts'
+  Gemini Pro quotas can be used at the same time. Admission only limits
+  `agy_acp_server`; it does not limit the built-in provider's `agy` processes.
+- Configure the custom provider with the Paseo v0.11.2 shape
+  `extends: "acp"` plus `label: "Antigravity Pro"` under `agents.providers`.
+  README (EN/ZH) examples, version pins, the version badge, tests, and the
+  official-kernel smoke now expect `2.5.0`.
+- Existing users who keyed this adapter as `antigravity` must rename that key
+  to `paseo-agy-acp`. While the old key remains, Paseo hides the built-in agy
+  provider and routes the id `antigravity` to this adapter.
+
+### Unchanged
+
+- Admission keeps the internal partition string `provider: "antigravity"`; the
+  live state directory keys seats with it, so changing it would split the
+  queue.
+- ACP `agentInfo` name stays `agy-acp`, and the npm keyword stays
+  `antigravity`.
+
+### Verification
+
+- Complete validation: 43 test files, 257 passed, 1 skipped; architecture and
+  secret checks passed.
+
 ## 2.4.2 - 2026-10-10
 
 ### Fixed

package/README.md

@@ -5,7 +5,7 @@
 **Reliable Paseo adapter for Google's official Antigravity ACP kernel**
 
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue?style=flat-square)](./LICENSE)
-[![Version](https://img.shields.io/badge/version-2.4.2-blue?style=flat-square)](./package.json)
+[![Version](https://img.shields.io/badge/version-2.5.0-blue?style=flat-square)](./package.json)
 [![npm](https://img.shields.io/npm/v/paseo-agy-acp?style=flat-square)](https://www.npmjs.com/package/paseo-agy-acp)
 [![Node](https://img.shields.io/badge/node-%3E%3D22-brightgreen?style=flat-square)](./package.json)
 [![ACP](https://img.shields.io/badge/ACP-NDJSON%20v1-8A2BE2?style=flat-square)](https://agentclientprotocol.com)
@@ -102,7 +102,7 @@ Paseo agents.
 <!-- readme:requirements -->
 ## Requirements
 
-- **Paseo** with Generic ACP provider support
+- **Paseo** v0.11.2 or newer with custom ACP provider support
 - **Node.js 22 or newer**
 - An Antigravity account able to complete official `oauth-personal`
 - Linux filesystem ownership and mode support when Admission is enabled
@@ -119,7 +119,7 @@ wrapper. A different existing path is used as-is.
 ### 1. Authenticate
 
 ```bash
-npx -y paseo-agy-acp@2.4.2 --login
+npx -y paseo-agy-acp@2.5.0 --login
 ```
 
 The first run downloads and configures official kernel 1.2.1. That download is
@@ -136,7 +136,7 @@ delegation.
 ```bash
 export AGY_ACP_STATE_DIR="$HOME/.local/state/paseo-agy-acp/account-name"
 install -d -m 700 "$AGY_ACP_STATE_DIR"
-npx -y --package=paseo-agy-acp@2.4.2 \
+npx -y --package=paseo-agy-acp@2.5.0 \
   agy-acp-prepare-state "$AGY_ACP_STATE_DIR"
 ```
 
@@ -146,32 +146,61 @@ creates or validates the directory and refuses an existing permissive path.
 ### 3. Configure the Paseo provider
 
 Add or update the provider in `$PASEO_HOME/config.json` or
-`~/.paseo/config.json`:
+`~/.paseo/config.json`. The provider id is the key under `agents.providers`:
 
 ```json
 {
-  "providers": {
-    "antigravity": {
-      "type": "acp",
-      "command": ["npx", "-y", "paseo-agy-acp@2.4.2"],
-      "env": {
-        "AGY_ACP_ADMISSION_ENABLED": "true",
-        "AGY_ACP_STATE_DIR": "/home/YOU/.local/state/paseo-agy-acp/account-name"
+  "agents": {
+    "providers": {
+      "paseo-agy-acp": {
+        "extends": "acp",
+        "label": "Antigravity Pro",
+        "command": ["npx", "-y", "paseo-agy-acp@2.5.0"],
+        "env": {
+          "AGY_ACP_ADMISSION_ENABLED": "true",
+          "AGY_ACP_STATE_DIR": "/home/YOU/.local/state/paseo-agy-acp/account-name"
+        }
       }
     }
   }
 }
 ```
 
+Paseo v0.11.2 requires `extends: "acp"` and a `label` for a custom ACP
+provider. Provider ids must match `^[a-z][a-z0-9-]*$`; `paseo-agy-acp` does.
+
 Paseo supplies `PASEO_AGENT_ID` and `PASEO_AGENT_CWD` to the provider process.
 Omit the two Admission variables only when you intentionally want unfenced
 single-agent operation.
 
+#### Coexistence with Paseo's built-in agy provider
+
+Paseo v0.11.2 added its own built-in Antigravity provider. The two providers
+are separate programs:
+
+- Paseo's built-in agy provider (id `antigravity`, display name **Antigravity**)
+  starts the host `agy` CLI (resolved from `PATH`). Its login lives in
+  `~/.gemini/antigravity-cli`.
+- `paseo-agy-acp` (id `paseo-agy-acp`, display name **Antigravity Pro**) does
+  not start that `agy` CLI. It starts `agy-acp`, which runs the official ACP
+  kernel `agy_acp_server`. Its login lives in `~/.gemini/antigravity-acp`.
+
+Both can be enabled at the same time: Paseo's built-in provider runs its `agy`
+processes, and this adapter runs its `agy_acp_server` processes. Because the
+logins are separate, they can be signed into two Antigravity accounts, so each
+account's Gemini Pro quota can be used at the same time. The adapter's
+Admission queue only limits `agy_acp_server`; it does not limit the built-in
+provider's `agy` processes.
+
+Existing users who configured this adapter under the key `antigravity` must
+rename that key to `paseo-agy-acp`. While the old key remains, Paseo hides the
+built-in agy provider and routes the id `antigravity` to this adapter.
+
 ### 4. Restart and verify
 
-Restart the Paseo daemon, create an agent with provider `antigravity`, select a
-supported mode, and send a simple prompt. `npx` starts a stdio ACP server for
-Paseo; it is not a standalone chat application.
+Restart the Paseo daemon, create an agent with provider `paseo-agy-acp`,
+select a supported mode, and send a simple prompt. `npx` starts a stdio ACP
+server for Paseo; it is not a standalone chat application.
 
 <!-- readme:configuration -->
 ## Configuration

package/README.zh-CN.md

@@ -5,7 +5,7 @@
 **Google 官方 Antigravity ACP 内核面向 Paseo 的可靠产品适配器**
 
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue?style=flat-square)](./LICENSE)
-[![Version](https://img.shields.io/badge/version-2.4.2-blue?style=flat-square)](./package.json)
+[![Version](https://img.shields.io/badge/version-2.5.0-blue?style=flat-square)](./package.json)
 [![npm](https://img.shields.io/npm/v/paseo-agy-acp?style=flat-square)](https://www.npmjs.com/package/paseo-agy-acp)
 [![Node](https://img.shields.io/badge/node-%3E%3D22-brightgreen?style=flat-square)](./package.json)
 [![ACP](https://img.shields.io/badge/ACP-NDJSON%20v1-8A2BE2?style=flat-square)](https://agentclientprotocol.com)
@@ -91,7 +91,7 @@ Antigravity 账号服务多个并发 Paseo agent 时建议启用。
 <!-- readme:requirements -->
 ## 环境要求
 
-- 支持 Generic ACP provider 的 **Paseo**
+- **Paseo** v0.11.2 或更新版本，支持自定义 ACP provider
 - **Node.js 22 或更新版本**
 - 可以完成官方 `oauth-personal` 的 Antigravity 账号
 - 启用 Admission 时，系统需支持 Linux 文件 owner 与 mode
@@ -107,7 +107,7 @@ Antigravity 账号服务多个并发 Paseo agent 时建议启用。
 ### 1. 完成认证
 
 ```bash
-npx -y paseo-agy-acp@2.4.2 --login
+npx -y paseo-agy-acp@2.5.0 --login
 ```
 
 第一次运行会下载并配置官方内核 1.2.1。下载约 320 MiB，放在 `~/.local/opt/`。
@@ -121,7 +121,7 @@ OAuth 由官方内核完成。Token 保留在内核自己的状态中，本适
 ```bash
 export AGY_ACP_STATE_DIR="$HOME/.local/state/paseo-agy-acp/account-name"
 install -d -m 700 "$AGY_ACP_STATE_DIR"
-npx -y --package=paseo-agy-acp@2.4.2 \
+npx -y --package=paseo-agy-acp@2.5.0 \
   agy-acp-prepare-state "$AGY_ACP_STATE_DIR"
 ```
 
@@ -130,30 +130,56 @@ npx -y --package=paseo-agy-acp@2.4.2 \
 
 ### 3. 配置 Paseo provider
 
-在 `$PASEO_HOME/config.json` 或 `~/.paseo/config.json` 中增加或更新 provider：
+在 `$PASEO_HOME/config.json` 或 `~/.paseo/config.json` 中增加或更新 provider。
+provider id 是 `agents.providers` 下的键：
 
 ```json
 {
-  "providers": {
-    "antigravity": {
-      "type": "acp",
-      "command": ["npx", "-y", "paseo-agy-acp@2.4.2"],
-      "env": {
-        "AGY_ACP_ADMISSION_ENABLED": "true",
-        "AGY_ACP_STATE_DIR": "/home/YOU/.local/state/paseo-agy-acp/account-name"
+  "agents": {
+    "providers": {
+      "paseo-agy-acp": {
+        "extends": "acp",
+        "label": "Antigravity Pro",
+        "command": ["npx", "-y", "paseo-agy-acp@2.5.0"],
+        "env": {
+          "AGY_ACP_ADMISSION_ENABLED": "true",
+          "AGY_ACP_STATE_DIR": "/home/YOU/.local/state/paseo-agy-acp/account-name"
+        }
       }
     }
   }
 }
 ```
 
+Paseo v0.11.2 要求自定义 ACP provider 声明 `extends: "acp"` 和 `label`。
+provider id 必须匹配 `^[a-z][a-z0-9-]*$`，`paseo-agy-acp` 符合。
+
 Paseo 会向 provider 进程提供 `PASEO_AGENT_ID` 和 `PASEO_AGENT_CWD`。只有在明确
 需要不受 Admission 约束的单 agent 运行时，才省略两个 Admission 变量。
 
+#### 与 Paseo 内置 agy provider 共存
+
+Paseo v0.11.2 新增了内置的 agy provider，两者是两个不同的程序：
+
+- Paseo 内置 agy provider（id `antigravity`，显示名 **Antigravity**）走宿主机的
+  `agy` CLI（从 `PATH` 查找），登录保存在 `~/.gemini/antigravity-cli`。
+- `paseo-agy-acp`（id `paseo-agy-acp`，显示名 **Antigravity Pro**）不启动该
+  `agy` CLI，而是启动 `agy-acp`，由它运行官方 ACP 内核 `agy_acp_server`，
+  登录保存在 `~/.gemini/antigravity-acp`。
+
+两者可以同时启用：内置 provider 运行自己的 `agy` 进程，本适配器运行自己的
+`agy_acp_server` 进程。登录互相独立，因此可以分别登录两个 Antigravity 账号，
+同时使用两个账号各自的 Gemini Pro 配额。适配器的 Admission 队列只限制
+`agy_acp_server`，不限制内置 provider 的 `agy` 进程。
+
+如果本适配器原先配置在 `antigravity` 键下，必须把该键改名为
+`paseo-agy-acp`。旧键仍然存在时，Paseo 会隐藏内置 agy provider，并把
+`antigravity` 这个 id 路由给本适配器。
+
 ### 4. 重启并验证
 
-重启 Paseo daemon，创建 provider 为 `antigravity` 的 agent，选择受支持模式并
-发送一个简单 prompt。`npx` 启动的是 Paseo 使用的 stdio ACP server，不是独立
+重启 Paseo daemon，创建 provider 为 `paseo-agy-acp` 的 agent，选择受支持模式
+并发送一个简单 prompt。`npx` 启动的是 Paseo 使用的 stdio ACP server，不是独立
 聊天程序。
 
 <!-- readme:configuration -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paseo-agy-acp",
-  "version": "2.4.2",
+  "version": "2.5.0",
   "description": "Paseo product ACP adapter that proxies the official Google Antigravity ACP kernel (NDJSON) with Admission and daemon context",
   "type": "module",
   "author": {