@alicloud/autowonder 0.3.34 → 0.3.35

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.
package/README.md CHANGED
@@ -6,10 +6,10 @@ AutoWonder 本地 agent runtime。安装后启动 daemon,持续轮询本地 as
6
6
 
7
7
  ```bash
8
8
  # Qoder CLI(模型使用 provider model ID;Context Window 使用固定档位)
9
- npx -y @alicloud/autowonder@0.3.34 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider qoder --model qmodel_latest --reasoning-effort medium --context-window 260000
9
+ npx -y @alicloud/autowonder@0.3.35 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider qoder --model qmodel_latest --reasoning-effort medium --context-window 260000
10
10
 
11
11
  # Qoder CLI CN
12
- npx -y @alicloud/autowonder@0.3.34 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider qodercn
12
+ npx -y @alicloud/autowonder@0.3.35 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider qodercn
13
13
  ```
14
14
 
15
15
  `connect` 会安装当前 npm 包内置的 daemon,并使用页面生成的 WebSocket endpoint、Token 和执行器 ID 建立连接。客户端只支持通过 Qoder 系列 CLI 启动(`qoder` 对应 `qodercli`,`qodercn` 对应 `qodercn`),其他 `--provider` 取值会在启动 daemon 前直接报错拦截并提示 `Unsupported provider`。选择 Qoder CLI 或 Qoder CLI CN 时需要 Node.js 20+;runtime 会在缺少对应 CLI 时自动通过 npm 安装,并在尚未登录时打开浏览器登录。runtime 会继承当前用户的 HOME、环境变量和 CLI 登录状态。
@@ -123,9 +123,9 @@ conversation 回合只有在其结果成功、未被取消且取得 provider 返
123
123
 
124
124
  daemon 不会自行追新:后台自动更新策略默认关闭,且没有环境变量可以重新开启,因此 daemon 不会主动查询 npm 的 `@alicloud/autowonder/latest`、下载、安装或重启。版本由平台决定,见下文的服务端指定版本升级;没有服务端升级指令时,即使本地配置了更短的检查周期也不会产生任何 npm 请求。
125
125
 
126
- 升级能力与后台策略是两件事:标准安装的正式版 daemon 仍会初始化升级器并在心跳里上报远程升级能力,因此平台可以下发指定版本的升级指令。收到 `EXECUTOR_UPGRADE`(或 `EXECUTOR_RESTART` 且 `update=true`)后,daemon 才会按指令解析 npm tarball、校验 SHA-512 SRI、包版本和平台二进制;只有在没有运行/恢复任务且结果 outbox 已收到服务端确认时,才会暂停接单、原子切换二进制并重启。启动失败会恢复上一个二进制。
126
+ 升级能力与后台策略是两件事:文件名为 `autowonder-daemon` 的稳定版 daemon 会按当前二进制的真实路径初始化升级器并在心跳里上报远程升级能力,因此平台可以下发指定版本的升级指令。收到 `EXECUTOR_UPGRADE`(或 `EXECUTOR_RESTART` 且 `update=true`)后,daemon 才会按指令解析 npm tarball、校验 SHA-512 SRI、包版本和平台二进制;只有在没有运行/恢复任务且结果 outbox 已收到服务端确认时,才会暂停接单、原子切换二进制并重启。启动失败会恢复上一个二进制。
127
127
 
128
- 源码构建、开发版本、非标准安装路径、预发布版本和 Windows 不上报升级能力,也不支持远端升级。
128
+ 自定义安装目录(例如 `~/workspace/<release>/bin/`)同样支持在线升级,无需登记固定路径。开发版本、预发布版本、其他二进制文件名和 Windows 不上报升级能力;安装目录不可写或升级状态无法恢复时,也无法初始化升级器。符号链接按其实际目标处理,目标文件名仍须为 `autowonder-daemon`。
129
129
 
130
130
  ```bash
131
131
  # 使用兼容的 npm registry(仅影响按平台指令解析版本时使用的源)
@@ -137,21 +137,21 @@ npx -y @alicloud/autowonder@latest connect ...
137
137
 
138
138
  支持版本的 Linux/macOS 执行器会声明 `EXECUTOR_LAUNCH_COMMAND_V1`。管理员可在平台“启动命令 → 编辑完整命令”中修改固定发布版本、`--workspace-root`、`--name`、`--debug` 及已有启动参数,保存后在线应用。连接地址、Token、执行器 ID、provider 和 Token 代理参数不可修改,不执行任意 Shell 命令。
139
139
 
140
- 同版本空闲时用新参数 exec;切换到更高稳定版本要求二进制安装在 `~/.autowonder/bin/autowonder-daemon`,复用 npm tarball SHA-512、包版本、平台二进制和候选自检,再原子切换。失败保留原程序并在支持的故障路径回滚,不支持在线降级。源码构建仅支持保持当前版本的参数应用,Windows 不声明在线应用能力。旧客户端需要先本地安装一次支持版本。
140
+ 同版本空闲时用新参数 exec;切换到更高稳定版本要求当前稳定版二进制名为 `autowonder-daemon`,其实际安装目录可写且升级器初始化成功,复用 npm tarball SHA-512、包版本、平台二进制和候选自检,再原子切换。失败保留原程序并在支持的故障路径回滚,不支持在线降级。未标记稳定版本的源码构建仅支持保持当前版本的参数应用,Windows 不声明在线应用能力。旧客户端需要先本地安装一次支持版本。
141
141
 
142
142
  启动命令可携带可选的 `restartMode`,取值为 `WHEN_IDLE` 或 `FORCE`。未提供时仅在本机完全空闲时应用,繁忙时拒绝并回执失败;`WHEN_IDLE` 会立即关闭接单入口,等待运行中任务与会话结束后再重启,等待期间每 30 秒以 `EXECUTOR_RESTART_RESULT` 的 `WAITING_IDLE` 状态回执;`FORCE` 同样立即关闭接单入口,但不等运行中任务,仍要求结果 outbox 可读后立即重启。非法取值会在产生任何重启副作用前被拒绝。Linux/macOS 执行器在心跳中通过 `EXECUTOR_RESTART_POLICY_V1` 声明支持该策略。
143
143
 
144
144
  工作目录切换前必须没有运行/恢复任务,且原目录的结果 outbox 已全部确认;默认本地队列仍有待执行或已领取任务时也会拒绝切换。目标目录必须可写;历史任务文件保留在原目录,不自动迁移或删除。未指定目录和名称时在线应用沿用当前值,仅更新其他参数不会移动本地队列。
145
145
 
146
- 候选版本缓存在 `~/.autowonder/updates/`;当前二进制和单个回滚副本位于 `~/.autowonder/bin/`。`GET /health` 会返回 `daemonVersion`、`updateState`、`updateTarget` 和 `updateError`。
146
+ 升级在当前二进制所在目录原子替换 `autowonder-daemon`,锁、事务状态和单个回滚副本也保存在该目录;候选版本缓存在该目录上一级的 `updates/` 下,因此两处都需可写。默认安装仍使用 `~/.autowonder/bin/` 和 `~/.autowonder/updates/`。共享同一二进制的多个执行器共用升级事务:磁盘文件更新不等于其他进程已经重启;同版本在线应用会校验磁盘版本,防止悄悄切换到另一执行器刚安装的版本。旧客户端仍需要先手动安装一次支持自定义路径的版本,新版不能远程解除旧进程的路径限制。`GET /health` 会返回 `daemonVersion`、`updateState`、`updateTarget` 和 `updateError`。
147
147
 
148
148
  daemon 建立连接时和每次心跳定时检查时发出的 `HEARTBEAT` 帧都带上 `version` 字段,取值为该二进制构建时注入的发布版本号(`currentReleaseIdentity().Version`,与 `--self-check` 报告的版本同源);版本为空时该字段不出现在帧里。服务端据此记录每台执行机实际运行的客户端版本并在执行器列表展示,为后续客户端批量升级提供数据基础。对执行机用户无新增参数或环境变量。
149
149
 
150
150
  同一批 `HEARTBEAT` 帧还带上 `model` 字段,取值为 daemon 当前生效的默认模型(`--model` 经 `AUTOWONDER_MODEL` 注入的 `cfg.DefaultModel`,即派单未指定模型时实际使用的取值);该值为空时字段不出现在帧里。服务端据此在执行器列表展示每台执行机当前使用的底层模型,与上面的 `version` 上报同一条通路。对执行机用户同样无新增参数或环境变量。
151
151
 
152
- 同一批 `HEARTBEAT` 帧还带上进程级固定的 `startedAt`(重连不重置)与继承自 re-exec 的 `restartRequestId`,并在能力位里声明 `EXECUTOR_RESTART_V1` 与 `EXECUTOR_RESTART_POLICY_V1`(Windows 均不声明);接入自动更新的 daemon 额外声明 `EXECUTOR_UPDATE_RESTART_V1`。服务端可据此下发 `EXECUTOR_RESTART`(带 `executorId`、`requestId`、ISO UTC `issuedAt` 与布尔 `update`)。本机只接受 `executorId` 与自身一致、未过期且未处理过的请求,不接收任何远端 shell 命令、可执行路径或下载地址,并以 `EXECUTOR_RESTART_RESULT`(`UPDATING` / `WAITING_IDLE` / `RESTARTING` / `FAILED`)回执,真正是否成功以下一次心跳为准。重启走既有的接单闸门:有运行中任务或结果 outbox 未确认可读时不重启,re-exec 失败会重新开放接单;`update=true` 复用既有的 registry、完整性校验、候选 self-check、安装事务与回滚,仅标准安装的正式版支持远端拉取新版本,已是最新版的请求仍会重启,且该操作不应用平台上保存的启动配置改动。对执行机用户同样无新增参数或环境变量。
152
+ 同一批 `HEARTBEAT` 帧还带上进程级固定的 `startedAt`(重连不重置)与继承自 re-exec 的 `restartRequestId`,并在能力位里声明 `EXECUTOR_RESTART_V1` 与 `EXECUTOR_RESTART_POLICY_V1`(Windows 均不声明);接入自动更新的 daemon 额外声明 `EXECUTOR_UPDATE_RESTART_V1`。服务端可据此下发 `EXECUTOR_RESTART`(带 `executorId`、`requestId`、ISO UTC `issuedAt` 与布尔 `update`)。本机只接受 `executorId` 与自身一致、未过期且未处理过的请求,不接收任何远端 shell 命令、可执行路径或下载地址,并以 `EXECUTOR_RESTART_RESULT`(`UPDATING` / `WAITING_IDLE` / `RESTARTING` / `FAILED`)回执,真正是否成功以下一次心跳为准。重启走既有的接单闸门:有运行中任务或结果 outbox 未确认可读时不重启,re-exec 失败会重新开放接单;`update=true` 复用既有的 registry、完整性校验、候选 self-check、安装事务与回滚,符合上述条件的稳定版支持远端拉取新版本,已是最新版的请求仍会重启,且该操作不应用平台上保存的启动配置改动。对执行机用户同样无新增参数或环境变量。
153
153
 
154
- 标准安装还支持服务端把整批执行机升级到指定的**已发布版本**(不再依赖各台机器安装时选定的版本),能力位为 `EXECUTOR_UPDATE_V1`。服务端下发 `EXECUTOR_UPGRADE`(带 `executorId`、`requestId`、ISO UTC `issuedAt` 与 `targetVersion`),本机只接受 `executorId` 与自身一致、`requestId` 非空且不超过 80 字符、`issuedAt` 在前后 1 分钟以内、且 `targetVersion` 为三段纯数字正式版的请求。升级按 `accepted` → `downloading` → `draining` → `applying` → `success` 逐阶段回执 `EXECUTOR_UPGRADE_RESULT`(含 `requestId`、`phase` 与该进程启动时的 `currentVersion`;新版本以下一个进程的首次心跳为准),失败则以 `failed` 帧带上错误原因——目标版本不受支持、请求过期、本机构建不支持远端升级等都会显式回执而不是静默丢弃。registry 按请求的版本号解析元数据并要求返回值与请求版本严格一致;请求版本低于当前版本时拒绝执行(服务端升级永不回滚整批执行机),已缓存但版本不符的候选不会被采用。`requestId` 会跨 re-exec 传递,服务端重放的同一请求不会触发第二次升级;同一 `requestId` 同时只允许一次尝试在飞,失败后可重试。升级复用既有的接单闸门、完整性校验、候选 self-check、安装事务与回滚。对执行机用户无新增参数或环境变量。
154
+ 支持升级的执行器还允许服务端把整批执行机升级到指定的**已发布版本**(不再依赖各台机器安装时选定的版本),能力位为 `EXECUTOR_UPDATE_V1`。服务端下发 `EXECUTOR_UPGRADE`(带 `executorId`、`requestId`、ISO UTC `issuedAt` 与 `targetVersion`),本机只接受 `executorId` 与自身一致、`requestId` 非空且不超过 80 字符、`issuedAt` 在前后 1 分钟以内、且 `targetVersion` 为三段纯数字正式版的请求。升级按 `accepted` → `downloading` → `draining` → `applying` → `success` 逐阶段回执 `EXECUTOR_UPGRADE_RESULT`(含 `requestId`、`phase` 与该进程启动时的 `currentVersion`;新版本以下一个进程的首次心跳为准),失败则以 `failed` 帧带上错误原因——目标版本不受支持、请求过期、本机构建不支持远端升级等都会显式回执而不是静默丢弃。registry 按请求的版本号解析元数据并要求返回值与请求版本严格一致;请求版本低于当前版本时拒绝执行(服务端升级永不回滚整批执行机),已缓存但版本不符的候选不会被采用。`requestId` 会跨 re-exec 传递,服务端重放的同一请求不会触发第二次升级;同一 `requestId` 同时只允许一次尝试在飞,失败后可重试。升级复用既有的接单闸门、完整性校验、候选 self-check、安装事务与回滚。对执行机用户无新增参数或环境变量。
155
155
 
156
156
  ## 任务环境变量快照
157
157
 
@@ -197,7 +197,7 @@ mv "$queue/.assignment.tmp" "$queue/assignment.json"
197
197
  也可以直接提交到本地 API:
198
198
 
199
199
  ```bash
200
- npx -y @alicloud/autowonder@0.3.34 dispatch ./assignment.json
200
+ npx -y @alicloud/autowonder@0.3.35 dispatch ./assignment.json
201
201
  ```
202
202
 
203
203
  ## 上传工单附件
@@ -205,7 +205,7 @@ npx -y @alicloud/autowonder@0.3.34 dispatch ./assignment.json
205
205
  把本地需求/设计文档直接上传到工单,避免在会话里传递大文件:
206
206
 
207
207
  ```bash
208
- npx -y @alicloud/autowonder@0.3.34 workitem upload --server-url <autowonder-server-url> --workitem-id <id> --file <filepath-1> --file <filepath-2> --json
208
+ npx -y @alicloud/autowonder@0.3.35 workitem upload --server-url <autowonder-server-url> --workitem-id <id> --file <filepath-1> --file <filepath-2> --json
209
209
  ```
210
210
 
211
211
  上传令牌通过 MCP 工具 `autowonder.workitem_cli_upload_token` 签发,经 `--token` 或 `AUTOWONDER_UPLOAD_TOKEN` 环境变量传入。`--file` 可重复指定多个文件;`--json` 输出机器可读结果。失败时按错误类型返回不同退出码(401→3、403→4、404→5、409→6、413→7、其他 4xx→8、网络/重定向→9)。
@@ -215,7 +215,7 @@ npx -y @alicloud/autowonder@0.3.34 workitem upload --server-url <autowonder-serv
215
215
  把工单上已有的需求/设计文档下载到本地目录,再用本地文件工具阅读,避免把大文件或二进制附件搬进会话上下文:
216
216
 
217
217
  ```bash
218
- npx -y @alicloud/autowonder@0.3.34 workitem download --server-url <autowonder-server-url> --workitem-id <id> --file <name-or-id> --output-dir <dir> --json
218
+ npx -y @alicloud/autowonder@0.3.35 workitem download --server-url <autowonder-server-url> --workitem-id <id> --file <name-or-id> --output-dir <dir> --json
219
219
  ```
220
220
 
221
221
  下载令牌通过 MCP 工具 `autowonder.workitem_cli_download_token` 签发(与上传令牌相互独立),经 `--token` 或 `AUTOWONDER_DOWNLOAD_TOKEN` 环境变量传入。`--file` 可重复指定文档名或 artifact id,省略则下载该工单的全部附件;`--output-dir` 默认为当前目录;`--json` 输出机器可读结果,含每个文件的 `id`、`name`、`path`、`size`。退出码约定与 `workitem upload` 相同(401→3、403→4、404→5、409→6、413→7、其他 4xx→8、网络/重定向→9)。
@@ -225,7 +225,7 @@ npx -y @alicloud/autowonder@0.3.34 workitem download --server-url <autowonder-se
225
225
  把需求/设计文档上传到 7x24 定时任务,用法与工单附件一致(同一套上传令牌与预检规则):
226
226
 
227
227
  ```bash
228
- npx -y @alicloud/autowonder@0.3.34 scheduled-task upload --server-url <autowonder-server-url> --scheduled-task-id <id> --file <filepath-1> --file <filepath-2> --json
228
+ npx -y @alicloud/autowonder@0.3.35 scheduled-task upload --server-url <autowonder-server-url> --scheduled-task-id <id> --file <filepath-1> --file <filepath-2> --json
229
229
  ```
230
230
 
231
231
  上传令牌同样通过 `autowonder.workitem_cli_upload_token` 签发(令牌为用户级,对当前可修改的任意定时任务生效),经 `--token` 或 `AUTOWONDER_UPLOAD_TOKEN` 传入;退出码约定与 `workitem upload` 相同。
@@ -233,8 +233,8 @@ npx -y @alicloud/autowonder@0.3.34 scheduled-task upload --server-url <autowonde
233
233
  ## 管理 daemon
234
234
 
235
235
  ```bash
236
- npx -y @alicloud/autowonder@0.3.34 status
237
- npx -y @alicloud/autowonder@0.3.34 stop
236
+ npx -y @alicloud/autowonder@0.3.35 status
237
+ npx -y @alicloud/autowonder@0.3.35 stop
238
238
  ```
239
239
 
240
240
  默认 API 是 `http://127.0.0.1:34989`,日志位于 `~/.autowonder/daemon.log`。npm 包不包含任何 agent、MCP 或服务端凭证。
@@ -257,7 +257,7 @@ daemon 内置独立于工作区 GC 的保留清扫:默认每小时运行一次
257
257
  ## 调试
258
258
 
259
259
  ```bash
260
- npx -y @alicloud/autowonder@0.3.34 connect ... --debug
260
+ npx -y @alicloud/autowonder@0.3.35 connect ... --debug
261
261
  ```
262
262
 
263
263
  `--debug` 会让 CLI 以 `AUTOWONDER_DEBUG=1` 启动 daemon,把完整的 daemon 与 agent 活动(runtime 事件流、provider 事件解码、重试退避与会话门等待、空闲时的阻塞点)同时输出到控制台和会话调试日志。调试日志不做脱敏,仅用于本机排障;不传 `--debug` 时该环境变量不会注入。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@alicloud/autowonder",
3
- "version": "0.3.34",
3
+ "version": "0.3.35",
4
4
  "description": "AutoWonder local runtime — execute AI agent dispatch packages on your machine",
5
5
  "bin": {
6
6
  "autowonder": "bin/cli.js"