paseo-agy-acp 2.2.0 → 2.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/CHANGELOG.md +15 -0
  2. package/README.md +59 -39
  3. package/README.zh-CN.md +54 -34
  4. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -2,6 +2,21 @@
2
2
 
3
3
  All notable changes to `paseo-agy-acp` are recorded here.
4
4
 
5
+ ## 2.2.1 - 2026-08-29
6
+
7
+ ### Changed
8
+
9
+ - GitHub tags match npm 3-part semver from this release (`v2.2.1` =
10
+ `paseo-agy-acp@2.2.1`). Historical tag `v2.2.0.0` remains the 2.2.0 line.
11
+ - README (EN/ZH): `npx` launches this proxy only. Paseo, a locally installed
12
+ official kernel, and `PASEO_AGY_ACP_OFFICIAL_BIN` remain required. The npm
13
+ tarball now ships that copy.
14
+
15
+ ### Unchanged
16
+
17
+ - Same official ACP kernel, same local Claude/GPT-OSS opt-in, same Admission
18
+ defaults as 2.2.0.
19
+
5
20
  ## 2.2.0 - 2026-08-29
6
21
 
7
22
  ### Changed
package/README.md CHANGED
@@ -2,10 +2,11 @@
2
2
 
3
3
  # 🔌 paseo-agy-acp
4
4
 
5
- **Paseo × Antigravity — official ACP kernel, Paseo-ready product adapter**
5
+ **Paseo adapter in front of Google's official Antigravity ACP kernel**
6
6
 
7
7
  [![License](https://img.shields.io/badge/license-Apache%202.0-blue?style=flat-square)](./LICENSE)
8
- [![Version](https://img.shields.io/badge/version-2.2.0-blue?style=flat-square)](./package.json)
8
+ [![Version](https://img.shields.io/badge/version-2.2.1-blue?style=flat-square)](./package.json)
9
+ [![npm](https://img.shields.io/npm/v/paseo-agy-acp?style=flat-square)](https://www.npmjs.com/package/paseo-agy-acp)
9
10
  [![Node](https://img.shields.io/badge/node-%3E%3D22-brightgreen?style=flat-square)](#)
10
11
  [![ACP](https://img.shields.io/badge/ACP-NDJSON%20v1-8A2BE2?style=flat-square)](https://agentclientprotocol.com)
11
12
 
@@ -27,11 +28,15 @@ mode mapping, MCP rewrite, product identity, and an account-wide Admission
27
28
  queue so the Paseo main controller can delegate many Antigravity agents without
28
29
  a startup stampede.
29
30
 
30
- **2.2.0** (GitHub tag `v2.2.0.0`) still uses the same official ACP kernel. It only adds an explicit
31
+ **2.2** still uses the same official ACP kernel. It only adds an explicit
31
32
  **local opt-in** compatibility layer: entitled Claude 4.6 and GPT-OSS 120B can
32
33
  complete turns on this path. If you do not opt in, the official path supports
33
34
  Gemini-family models only by default.
34
35
 
36
+ **2.2.1** is the same product as 2.2.0: GitHub tags now match npm (`v2.2.1` =
37
+ `paseo-agy-acp@2.2.1`). This README states that `npx` launches this proxy only.
38
+ The older GitHub tag `v2.2.0.0` remains the 2.2.0 line.
39
+
35
40
  > **Not official Paseo support. Not official Google support.**
36
41
  > Community-maintained product. Use at your own risk.
37
42
 
@@ -67,41 +72,47 @@ This is probably not for you if:
67
72
 
68
73
  ## Quickstart
69
74
 
70
- Prerequisites: **Node.js >= 22** and a locally installed official Antigravity
71
- ACP kernel. The `--login` step below completes official OAuth (`authenticate` /
72
- `oauth-personal`). Set `PASEO_AGY_ACP_OFFICIAL_BIN` when your official kernel is
73
- not at the maintainer host's pinned default path.
75
+ Prerequisites: **Paseo**, **Node.js >= 22**, and a **locally installed** official
76
+ Antigravity ACP kernel (this package does **not** install Google's `.par`).
77
+ `--login` completes official OAuth (`authenticate` / `oauth-personal`). Set
78
+ `PASEO_AGY_ACP_OFFICIAL_BIN` to your kernel wrapper or `.par` (required unless
79
+ it already sits at the maintainer-host default pin).
74
80
 
75
- The npm package is `paseo-agy-acp@2.2.0` (same product as GitHub `v2.2.0.0`;
76
- npm requires 3-part semver). It does **not** ship Google's `.par`.
81
+ The npm package `paseo-agy-acp@2.2.1` is the **proxy**. `npx` launches that
82
+ proxy; it does not replace Antigravity or Paseo.
77
83
 
78
84
  ```bash
79
85
  export PASEO_AGY_ACP_OFFICIAL_BIN="/absolute/path/to/agy_acp_server.par-or-wrapper"
80
- npx -y paseo-agy-acp@2.2.0 --login
86
+ npx -y paseo-agy-acp@2.2.1 --login
81
87
 
82
88
  export AGY_ACP_STATE_DIR="$HOME/.local/state/paseo-agy-acp/default"
83
89
  install -d -m 700 "$AGY_ACP_STATE_DIR"
84
- npx -y --package=paseo-agy-acp@2.2.0 agy-acp-prepare-state "$AGY_ACP_STATE_DIR"
90
+ npx -y --package=paseo-agy-acp@2.2.1 agy-acp-prepare-state "$AGY_ACP_STATE_DIR"
85
91
  export AGY_ACP_ADMISSION_ENABLED=true
92
+ ```
86
93
 
87
- npx -y paseo-agy-acp@2.2.0
94
+ Then point Paseo's Generic ACP `command` at npx (see
95
+ [Paseo provider config](#paseo-provider-config)). Do **not** treat the next
96
+ line as a standalone chat app: it is the stdio ACP server Paseo spawns.
97
+
98
+ ```bash
99
+ npx -y paseo-agy-acp@2.2.1
88
100
  ```
89
101
 
90
- Point Paseo's Generic ACP provider at `npx` (see [Paseo provider config](#paseo-provider-config)).
91
- Claude / GPT-OSS: see [§1](#1-official-agy-acp-kernel-capabilities) and the
102
+ Claude / GPT-OSS: [§1](#1-official-agy-acp-kernel-capabilities) and the
92
103
  [runbook](docs/operations/official-kernel-compat-runbook.md). Source checkout
93
- (`git clone` + `npm ci` + `npm run build`) remains available under
94
- [Install](#install).
104
+ (`git clone` + `npm ci` + `npm run build`) is under [Install](#install).
95
105
 
96
106
  ## About
97
107
 
98
108
  This repository is a **product adapter**, not a second Antigravity. The kernel
99
- does the model work; this repo makes that kernel **safe and complete for Paseo**.
109
+ does the model work; this repo adds the Paseo-side behavior a Generic ACP bridge
110
+ does not provide on its own.
100
111
 
101
112
  | Highlight | Why it matters |
102
113
  |---|---|
103
114
  | **Official ACP kernel** | Native ACP over NDJSON. Without opt-in the official path supports Gemini only. Local opt-in adds entitled Claude 4.6 and GPT-OSS 120B. |
104
- | **Paseo-ready out of the box** | Daemon `appendSystemPrompt`, mode ids Paseo already sends, and MCP `http` servers are rewritten so Generic ACP agents can talk to Antigravity without extra glue. |
115
+ | **Paseo-side glue** | Daemon `appendSystemPrompt`, mode ids Paseo already sends, and MCP `http` servers are rewritten so Generic ACP agents can talk to Antigravity without extra adapter code. You still install Paseo, the official kernel, and point `command` at this proxy. |
105
116
  | **Burst-safe delegation** | An account-wide durable Admission queue paces `session/prompt` so Paseo's main controller can dispatch many Antigravity agents without every turn hitting the kernel at once. |
106
117
  | **Production-tested defaults** | Default **8 shared seats / 8 concurrent starts / 2s interval**, from live Paseo dispatch (including a 10-agent burst) plus isolated stress. Integers **≥ 1** can probe higher; this repo does **not** invent a product ceiling. |
107
118
  | **Fail-closed operations** | Bad env, policy splits, and unprovable writes fail closed. Queue timeout, cancel, and kernel errors stay distinguishable. |
@@ -180,7 +191,7 @@ provider processes.
180
191
 
181
192
  ### Local opt-in: Claude 4.6 and GPT-OSS 120B
182
193
 
183
- **2.2.0 still uses the same official ACP kernel.** It only adds this layer.
194
+ **2.2 still uses the same official ACP kernel.** It only adds this layer.
184
195
  If you do not opt in, the official path supports Gemini-family models only.
185
196
 
186
197
  Opt-in is **local** and **explicit**:
@@ -382,17 +393,19 @@ capacity cooldown. Package entrypoints stay inside `ACP Connector/`.
382
393
 
383
394
  ## Install
384
395
 
385
- Preferred (after this version is on npmjs):
396
+ `npx` installs and runs **this proxy**. It does not install Paseo or Google's
397
+ kernel. Prefer npm over `git clone` for the adapter only.
386
398
 
387
399
  ```bash
388
- npx -y paseo-agy-acp@2.2.0 --login
400
+ # Official OAuth through the proxy (kernel must already be on this machine)
401
+ npx -y paseo-agy-acp@2.2.1 --login
389
402
  ```
390
403
 
391
404
  Bins: `paseo-agy-acp` / `agy-acp` (ACP proxy), `agy-acp-prepare-state`,
392
405
  `agy-acp-prepare-official-kernel-compat`. First `npx` may compile
393
406
  `better-sqlite3` (needs a local C++ toolchain).
394
407
 
395
- Source checkout:
408
+ Source checkout (development):
396
409
 
397
410
  ```bash
398
411
  git clone https://github.com/tiezbro/paseo-agy-acp.git
@@ -405,13 +418,13 @@ npm test
405
418
  ```bash
406
419
  # ACP initialize smoke (requires the official binary)
407
420
  printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":1}}' \
408
- | npx -y paseo-agy-acp@2.2.0
421
+ | npx -y paseo-agy-acp@2.2.1
409
422
  ```
410
423
 
411
424
  Login (official kernel OAuth):
412
425
 
413
426
  ```bash
414
- npx -y paseo-agy-acp@2.2.0 --login
427
+ npx -y paseo-agy-acp@2.2.1 --login
415
428
  ```
416
429
 
417
430
  ## Environment
@@ -452,7 +465,7 @@ One official kernel child per connector process. Admission coordinates
452
465
  "providers": {
453
466
  "antigravity": {
454
467
  "type": "acp",
455
- "command": ["npx", "-y", "paseo-agy-acp@2.2.0"],
468
+ "command": ["npx", "-y", "paseo-agy-acp@2.2.1"],
456
469
  "env": {
457
470
  "PASEO_AGY_ACP_OFFICIAL_BIN": "/home/YOU/.local/opt/agy-acp-server-agy_acp_server_20260818_01_RC01/agy-acp-server-canary",
458
471
  "AGY_ACP_ADMISSION_ENABLED": "true",
@@ -463,8 +476,9 @@ One official kernel child per connector process. Admission coordinates
463
476
  }
464
477
  ```
465
478
 
466
- When `command` is `node`, pass
467
- `["/path/to/paseo-agy-acp/dist/ACP Connector/main.js"]` as `args`.
479
+ `command` is how Paseo **spawns this proxy**. `PASEO_AGY_ACP_OFFICIAL_BIN` must
480
+ point at a kernel already installed on the machine. When `command` is `node`,
481
+ pass `["/path/to/paseo-agy-acp/dist/ACP Connector/main.js"]` as `args`.
468
482
  Paseo supplies `PASEO_AGENT_ID` to the provider process.
469
483
 
470
484
  Restart the Paseo daemon after changing the provider so idle Antigravity
@@ -477,17 +491,18 @@ Paste into any Paseo agent to install or repair the Antigravity provider:
477
491
  ~~~
478
492
  Configure the Paseo daemon to add an ACP provider for Google Antigravity.
479
493
 
480
- 1. Read Paseo config ($PASEO_HOME/config.json or ~/.paseo/config.json).
481
- 2. Add or update providers.antigravity:
494
+ 1. Confirm a local official Antigravity ACP kernel is installed (this package does not vendor it).
495
+ 2. Read Paseo config ($PASEO_HOME/config.json or ~/.paseo/config.json).
496
+ 3. Add or update providers.antigravity:
482
497
  - type: "acp"
483
- - command: ["npx", "-y", "paseo-agy-acp@2.2.0"]
498
+ - command: ["npx", "-y", "paseo-agy-acp@2.2.1"] (spawns the proxy, not the Google kernel)
484
499
  - env.PASEO_AGY_ACP_OFFICIAL_BIN: local official kernel wrapper (agy-acp-server-canary or agy_acp_server.par)
485
500
  - env.AGY_ACP_ADMISSION_ENABLED: "true"
486
501
  - env.AGY_ACP_STATE_DIR: absolute owner-only directory (mode 0700)
487
- 3. Prepare Admission state: npx -y --package=paseo-agy-acp@2.2.0 agy-acp-prepare-state "$AGY_ACP_STATE_DIR"
488
- 4. Login once: npx -y paseo-agy-acp@2.2.0 --login
489
- 5. Restart the Paseo daemon.
490
- 6. Verify: create a test agent with provider "antigravity", send a simple prompt.
502
+ 4. Prepare Admission state: npx -y --package=paseo-agy-acp@2.2.1 agy-acp-prepare-state "$AGY_ACP_STATE_DIR"
503
+ 5. Login once: npx -y paseo-agy-acp@2.2.1 --login
504
+ 6. Restart the Paseo daemon.
505
+ 7. Verify: create a test agent with provider "antigravity", send a simple prompt.
491
506
  ~~~
492
507
 
493
508
  ## Verification
@@ -516,7 +531,7 @@ official kernel + daemon context.
516
531
  - Official RC01 active cancel was not confirmed in our harness; live 503/quota
517
532
  was not induced against real backends.
518
533
  - The official kernel binary must already be installed; this package does not
519
- vendor it.
534
+ vendor it. `npx` only launches the proxy.
520
535
  - Admission is off until `AGY_ACP_ADMISSION_ENABLED`, `AGY_ACP_STATE_DIR`, and
521
536
  `PASEO_AGENT_ID` are all valid. Discovery/`--login` without an agent id does
522
537
  not open the ledger.
@@ -532,6 +547,12 @@ env -u PASEO_AGENT_ID -u PASEO_HOME npm test
532
547
 
533
548
  ## Upgrade / Rollback
534
549
 
550
+ If Paseo `command` uses npx, bump or pin the npm tag (for example
551
+ `paseo-agy-acp@2.2.1`) and restart the daemon. That is the upgrade/rollback
552
+ path for packaged installs.
553
+
554
+ Source checkout:
555
+
535
556
  ```bash
536
557
  # Upgrade
537
558
  git pull && npm ci && npm run build && npm test
@@ -540,10 +561,9 @@ git pull && npm ci && npm run build && npm test
540
561
  git checkout <rev> && npm ci && npm run build && npm test
541
562
  ```
542
563
 
543
- Point the daemon at the desired `agy-acp` binary or
544
- `dist/ACP Connector/main.js` entrypoint and restart. After an Admission policy
545
- change (for example 3+1 → 8/8), use a **fresh** `AGY_ACP_STATE_DIR` if the
546
- durable fingerprint would fail-close the new policy.
564
+ Restart the daemon after changing `command` or the kernel path. After an
565
+ Admission policy change (for example 3+1 → 8/8), use a **fresh**
566
+ `AGY_ACP_STATE_DIR` if the durable fingerprint would fail-close the new policy.
547
567
 
548
568
  ## Authority documents (v2.0.0.0 closeout)
549
569
 
package/README.zh-CN.md CHANGED
@@ -2,10 +2,11 @@
2
2
 
3
3
  # 🔌 paseo-agy-acp
4
4
 
5
- **Paseo × Antigravity — 官方 ACP 内核，面向 Paseo 的产品适配器**
5
+ **面向 Paseo 的适配器，跑在 Google 官方 Antigravity ACP 内核前面**
6
6
 
7
7
  [![License](https://img.shields.io/badge/license-Apache%202.0-blue?style=flat-square)](./LICENSE)
8
- [![Version](https://img.shields.io/badge/version-2.2.0-blue?style=flat-square)](./package.json)
8
+ [![Version](https://img.shields.io/badge/version-2.2.1-blue?style=flat-square)](./package.json)
9
+ [![npm](https://img.shields.io/npm/v/paseo-agy-acp?style=flat-square)](https://www.npmjs.com/package/paseo-agy-acp)
9
10
  [![Node](https://img.shields.io/badge/node-%3E%3D22-brightgreen?style=flat-square)](#)
10
11
  [![ACP](https://img.shields.io/badge/ACP-NDJSON%20v1-8A2BE2?style=flat-square)](https://agentclientprotocol.com)
11
12
 
@@ -25,10 +26,14 @@ Registry id `antigravity-acp`），再补上 Generic ACP 本身给不了的 Pase
25
26
  daemon 上下文、session 模式映射、MCP 改写、产品身份，以及账户级 Admission
26
27
  队列——让 Paseo 主控可以一次委派多个 Antigravity agent，而不把启动打成风暴。
27
28
 
28
- **2.2.0**（GitHub tag `v2.2.0.0`）仍使用同一套官方 ACP 内核。它只增加一层明确的 **本机 opt-in**
29
+ **2.2** 仍使用同一套官方 ACP 内核。它只增加一层明确的 **本机 opt-in**
29
30
  兼容：有资格的 Claude 4.6 与 GPT-OSS 120B 可以在这条路径上跑完回合。
30
31
  如果未 opt-in，官方路径默认只支持 Gemini 系模型。
31
32
 
33
+ **2.2.1** 与 2.2.0 是同一产品：GitHub tag 从此与 npm 对齐（`v2.2.1` =
34
+ `paseo-agy-acp@2.2.1`）。本文说明 `npx` 只拉起本代理。旧 GitHub tag
35
+ `v2.2.0.0` 仍是 2.2.0 那条线。
36
+
32
37
  > **非 Paseo 官方支持。非 Google 官方支持。** 社区维护产品，使用风险自负。
33
38
 
34
39
  ## 30 秒摘要
@@ -62,39 +67,45 @@ daemon 上下文、session 模式映射、MCP 改写、产品身份，以及账
62
67
 
63
68
  ## 快速开始
64
69
 
65
- 前提：**Node.js >= 22**，并且本机已安装官方 Antigravity ACP 内核。下面的
66
- `--login` 步骤会完成官方 OAuth（`authenticate` / `oauth-personal`）。如果官方内核
67
- 不在维护者主机的默认 pin 路径，请设置 `PASEO_AGY_ACP_OFFICIAL_BIN`。
70
+ 前提：**Paseo**、**Node.js >= 22**，以及本机已安装的官方 Antigravity ACP 内核
71
+ （本包装 **不会** 安装 Google 的 `.par`）。`--login` 完成官方 OAuth
72
+ （`authenticate` / `oauth-personal`）。把 `PASEO_AGY_ACP_OFFICIAL_BIN` 指到你的
73
+ 内核 wrapper 或 `.par`（除非已在维护者主机默认 pin 路径，否则必填）。
68
74
 
69
- npm 包是 `paseo-agy-acp@2.2.0`（与 GitHub `v2.2.0.0` 同一产品；npm 要求三段
70
- semver）。**不**分发 Google 的 `.par`。
75
+ npm 包 `paseo-agy-acp@2.2.1` 是 **代理**。`npx` 只拉起这个代理，**不能**代替
76
+ Antigravity 或 Paseo。
71
77
 
72
78
  ```bash
73
79
  export PASEO_AGY_ACP_OFFICIAL_BIN="/absolute/path/to/agy_acp_server.par-or-wrapper"
74
- npx -y paseo-agy-acp@2.2.0 --login
80
+ npx -y paseo-agy-acp@2.2.1 --login
75
81
 
76
82
  export AGY_ACP_STATE_DIR="$HOME/.local/state/paseo-agy-acp/default"
77
83
  install -d -m 700 "$AGY_ACP_STATE_DIR"
78
- npx -y --package=paseo-agy-acp@2.2.0 agy-acp-prepare-state "$AGY_ACP_STATE_DIR"
84
+ npx -y --package=paseo-agy-acp@2.2.1 agy-acp-prepare-state "$AGY_ACP_STATE_DIR"
79
85
  export AGY_ACP_ADMISSION_ENABLED=true
86
+ ```
80
87
 
81
- npx -y paseo-agy-acp@2.2.0
88
+ 再把 Paseo Generic ACP 的 `command` 指到 npx（见
89
+ [Paseo Provider 配置](#paseo-provider-配置)）。下面这一行 **不是** 独立聊天程序，
90
+ 而是 Paseo spawn 的 stdio ACP 服务：
91
+
92
+ ```bash
93
+ npx -y paseo-agy-acp@2.2.1
82
94
  ```
83
95
 
84
- 把 Paseo Generic ACP provider 指到 `npx`（见 [Paseo Provider 配置](#paseo-provider-配置)）。
85
96
  Claude / GPT-OSS 见 [§1](#1-官方-agy-acp-内核能力) 和
86
97
  [runbook](docs/operations/official-kernel-compat-runbook.md)。源码 checkout
87
- （`git clone` + `npm ci` + `npm run build`）仍在 [安装](#安装)。
98
+ （`git clone` + `npm ci` + `npm run build`）见 [安装](#安装)。
88
99
 
89
100
  ## 关于
90
101
 
91
102
  本仓库是 **产品适配器**，不是第二个 Antigravity。模型工作由内核完成；本仓库
92
- 让这套内核 **对 Paseo 可用、可并发、可运维**。
103
+ 补上 Generic ACP 桥本身不提供的 Paseo 侧行为。
93
104
 
94
105
  | 亮点 | 为什么重要 |
95
106
  |---|---|
96
107
  | **官方 ACP 内核** | 原生 ACP / NDJSON。未 opt-in 时官方路径只支持 Gemini；本机 opt-in 后，有资格的 Claude 4.6 与 GPT-OSS 120B 可以跑完回合。 |
97
- | **开箱即用的 Paseo 适配** | daemon `appendSystemPrompt`、Paseo 已在用的 mode id、以及 MCP `http` server，都会改写成官方内核认识的形态，Generic ACP agent 不用再贴一层胶水。 |
108
+ | **Paseo 侧胶水** | daemon `appendSystemPrompt`、Paseo 已在用的 mode id、以及 MCP `http` server，都会改写成官方内核认识的形态，Generic ACP agent 不用再写一层适配。仍须安装 Paseo、官方内核，并把 `command` 指到本代理。 |
98
109
  | **突发委派更稳健** | 账户级持久 Admission 队列给 `session/prompt` 限速，Paseo 主控可以一次派出很多 Antigravity agent，不会让每个 turn 同时砸到内核上。 |
99
110
  | **生产实测默认值** | 默认 **8 个共享席位 / 8 路同时启动 / 2 秒间隔**，来自真实 Paseo 派发（含 10 agent 突发）和隔离压测。整数 **≥ 1** 可以继续试更高并发；本仓库 **不编** 一个产品上限。 |
100
111
  | **失败即关闭** | 非法环境变量、policy 分叉、无法证明的写入一律 fail closed。排队超时、取消、内核错误仍然能区分。 |
@@ -169,7 +180,7 @@ provider 进程提供 `PASEO_AGENT_ID`（以及 `PASEO_AGENT_CWD`）。
169
180
 
170
181
  ### 本机 opt-in：Claude 4.6 与 GPT-OSS 120B
171
182
 
172
- **2.2.0 仍使用同一套官方 ACP 内核。** 它只增加这一层。如果未 opt-in，
183
+ **2.2 仍使用同一套官方 ACP 内核。** 它只增加这一层。如果未 opt-in，
173
184
  官方路径默认只支持 Gemini 系模型。
174
185
 
175
186
  opt-in 是 **本机、显式** 的：
@@ -358,17 +369,19 @@ paseo-agy-acp/
358
369
 
359
370
  ## 安装
360
371
 
361
- 推荐（本版本上架 npmjs 之后）：
372
+ `npx` 安装并运行 **本代理**。它不会安装 Paseo，也不会安装 Google 内核。适配器
373
+ 请用 npm，不要默认 `git clone`。
362
374
 
363
375
  ```bash
364
- npx -y paseo-agy-acp@2.2.0 --login
376
+ # 经代理做官方 OAuth（本机必须已有官方内核）
377
+ npx -y paseo-agy-acp@2.2.1 --login
365
378
  ```
366
379
 
367
380
  命令：`paseo-agy-acp` / `agy-acp`（ACP 代理）、`agy-acp-prepare-state`、
368
381
  `agy-acp-prepare-official-kernel-compat`。第一次 `npx` 可能要编译
369
382
  `better-sqlite3`（本机需要 C++ 工具链）。
370
383
 
371
- 源码 checkout：
384
+ 源码 checkout（开发用）：
372
385
 
373
386
  ```bash
374
387
  git clone https://github.com/tiezbro/paseo-agy-acp.git
@@ -381,13 +394,13 @@ npm test
381
394
  ```bash
382
395
  # ACP initialize 冒烟（需要官方二进制）
383
396
  printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":1}}' \
384
- | npx -y paseo-agy-acp@2.2.0
397
+ | npx -y paseo-agy-acp@2.2.1
385
398
  ```
386
399
 
387
400
  登录（官方内核 OAuth）：
388
401
 
389
402
  ```bash
390
- npx -y paseo-agy-acp@2.2.0 --login
403
+ npx -y paseo-agy-acp@2.2.1 --login
391
404
  ```
392
405
 
393
406
  ## 环境变量
@@ -428,7 +441,7 @@ Paseo / Generic ACP 客户端
428
441
  "providers": {
429
442
  "antigravity": {
430
443
  "type": "acp",
431
- "command": ["npx", "-y", "paseo-agy-acp@2.2.0"],
444
+ "command": ["npx", "-y", "paseo-agy-acp@2.2.1"],
432
445
  "env": {
433
446
  "PASEO_AGY_ACP_OFFICIAL_BIN": "/home/YOU/.local/opt/agy-acp-server-agy_acp_server_20260818_01_RC01/agy-acp-server-canary",
434
447
  "AGY_ACP_ADMISSION_ENABLED": "true",
@@ -439,7 +452,8 @@ Paseo / Generic ACP 客户端
439
452
  }
440
453
  ```
441
454
 
442
- `command` 为 `node` 时，`args` 传
455
+ `command` 是 Paseo **拉起本代理** 的方式。`PASEO_AGY_ACP_OFFICIAL_BIN` 必须指向
456
+ 本机已安装的内核。`command` 为 `node` 时，`args` 传
443
457
  `["/path/to/paseo-agy-acp/dist/ACP Connector/main.js"]`。
444
458
  Paseo 会给 provider 进程提供 `PASEO_AGENT_ID`。
445
459
 
@@ -452,17 +466,18 @@ Paseo 会给 provider 进程提供 `PASEO_AGENT_ID`。
452
466
  ~~~
453
467
  Configure the Paseo daemon to add an ACP provider for Google Antigravity.
454
468
 
455
- 1. Read Paseo config ($PASEO_HOME/config.json or ~/.paseo/config.json).
456
- 2. Add or update providers.antigravity:
469
+ 1. Confirm a local official Antigravity ACP kernel is installed (this package does not vendor it).
470
+ 2. Read Paseo config ($PASEO_HOME/config.json or ~/.paseo/config.json).
471
+ 3. Add or update providers.antigravity:
457
472
  - type: "acp"
458
- - command: ["npx", "-y", "paseo-agy-acp@2.2.0"]
473
+ - command: ["npx", "-y", "paseo-agy-acp@2.2.1"] (spawns the proxy, not the Google kernel)
459
474
  - env.PASEO_AGY_ACP_OFFICIAL_BIN: local official kernel wrapper (agy-acp-server-canary or agy_acp_server.par)
460
475
  - env.AGY_ACP_ADMISSION_ENABLED: "true"
461
476
  - env.AGY_ACP_STATE_DIR: absolute owner-only directory (mode 0700)
462
- 3. Prepare Admission state: npx -y --package=paseo-agy-acp@2.2.0 agy-acp-prepare-state "$AGY_ACP_STATE_DIR"
463
- 4. Login once: npx -y paseo-agy-acp@2.2.0 --login
464
- 5. Restart the Paseo daemon.
465
- 6. Verify: create a test agent with provider "antigravity", send a simple prompt.
477
+ 4. Prepare Admission state: npx -y --package=paseo-agy-acp@2.2.1 agy-acp-prepare-state "$AGY_ACP_STATE_DIR"
478
+ 5. Login once: npx -y paseo-agy-acp@2.2.1 --login
479
+ 6. Restart the Paseo daemon.
480
+ 7. Verify: create a test agent with provider "antigravity", send a simple prompt.
466
481
  ~~~
467
482
 
468
483
  ## 验证
@@ -489,7 +504,7 @@ server、模式 `dangerously-skip-permissions` → 官方 `yolo`、小席位下
489
504
  [开 Issue](https://github.com/tiezbro/paseo-agy-acp/issues)，我们据此优化和修复。
490
505
  - 官方 RC01 的 active cancel 在我们的 harness 里未确认；真实 503/配额未对
491
506
  线上后端做诱导验证。
492
- - 官方内核二进制必须本机已安装；本包装不会随包分发它。
507
+ - 官方内核二进制必须本机已安装；本包装不会随包分发它。`npx` 只拉起代理。
493
508
  - 在 `AGY_ACP_ADMISSION_ENABLED`、`AGY_ACP_STATE_DIR`、`PASEO_AGENT_ID` 都合法
494
509
  之前，Admission 保持关闭。没有 agent id 的 discovery / `--login` 不会打开账本。
495
510
  - 官方 ACP 没有 plan 模式；Paseo 的 `plan` 映射到 `default`。
@@ -503,6 +518,11 @@ env -u PASEO_AGENT_ID -u PASEO_HOME npm test
503
518
 
504
519
  ## 升级 / 回滚
505
520
 
521
+ 若 Paseo `command` 走 npx，改 npm 版本钉（例如 `paseo-agy-acp@2.2.1`）并重启
522
+ daemon。这是打包安装的升级/回滚路径。
523
+
524
+ 源码 checkout：
525
+
506
526
  ```bash
507
527
  # 升级
508
528
  git pull && npm ci && npm run build && npm test
@@ -511,9 +531,9 @@ git pull && npm ci && npm run build && npm test
511
531
  git checkout <rev> && npm ci && npm run build && npm test
512
532
  ```
513
533
 
514
- 把 daemon 指到目标 `agy-acp` 二进制或 `dist/ACP Connector/main.js` 入口后重启。
515
- Admission policy 变更（例如 3+1 → 8/8）时，如果持久 fingerprint 会把新 policy
516
- 失败关闭，请换一个 **全新** 的 `AGY_ACP_STATE_DIR`。
534
+ 改 `command` 或内核路径后重启 daemon。Admission policy 变更（例如 3+1 → 8/8）
535
+ 时，如果持久 fingerprint 会把新 policy 失败关闭，请换一个 **全新** 的
536
+ `AGY_ACP_STATE_DIR`。
517
537
 
518
538
  ## 权威文档（v2.0.0.0 closeout）
519
539
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "paseo-agy-acp",
3
- "version": "2.2.0",
3
+ "version": "2.2.1",
4
4
  "description": "Paseo product ACP adapter that proxies the official Google Antigravity ACP kernel (NDJSON) with Admission and daemon context",
5
5
  "type": "module",
6
6
  "author": {