@roll-agent/client-node 0.5.0 → 0.5.2
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 +7 -7
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# `@roll-agent/client-node`
|
|
2
2
|
|
|
3
3
|
面向 Node.js、Electron 主进程和本地 Companion 的 Roll Runtime Protocol v1 客户端。
|
|
4
|
-
客户端优先协商 `"1.
|
|
4
|
+
客户端优先协商 `"1.4"`，并在 `client.capabilities.set` ACK 完成后才结束连接；旧 Runtime
|
|
5
5
|
继续精确回落到 `"1.2"` / `"1.1"` / `"1.0"`。
|
|
6
6
|
|
|
7
7
|
它负责启动或连接 Runtime、初始化协商、JSON-RPC 请求、流式事件、协议校验、未知 Turn
|
|
@@ -14,9 +14,9 @@
|
|
|
14
14
|
`RollNodeClient.start()` 默认执行 `roll runtime serve --stdio`。宿主必须确保 `roll` 命令
|
|
15
15
|
已安装，或通过 `command` 指向随应用分发的 Runtime；这仍然只建立本地 stdio 连接。
|
|
16
16
|
|
|
17
|
-
默认本地 `maxFrameBytes` 为 `17 MiB`。广告 Runtime Protocol `"1.3"` 表示 Client 能接收
|
|
17
|
+
默认本地 `maxFrameBytes` 为 `17 MiB`。广告 Runtime Protocol `"1.4"` / `"1.3"` 表示 Client 能接收
|
|
18
18
|
至少 `17 MiB` 的单个 Runtime→Client NDJSON 帧；若调用方显式配置更低上限，Client 会从
|
|
19
|
-
初始化广告中移除 `"1.3"`，但仍可协商旧版本。初始化后的 Client→Runtime 出站上限仍是
|
|
19
|
+
初始化广告中移除 `"1.4"` 与 `"1.3"`，但仍可协商旧版本。初始化后的 Client→Runtime 出站上限仍是
|
|
20
20
|
`min(client.maxFrameBytes, initialize.limits.maxFrameBytes)`；当前 Runtime 默认接收入站帧
|
|
21
21
|
上限为 `4 MiB`，不会因为 Client 的 17 MiB 入站能力而扩大。
|
|
22
22
|
|
|
@@ -73,12 +73,12 @@ try {
|
|
|
73
73
|
|
|
74
74
|
## Runtime→Client Request
|
|
75
75
|
|
|
76
|
-
- `"1.3"` / `"1.2"` 没有强制 Handler；使用默认帧预算时，即使没有 Handler 也会广告
|
|
77
|
-
`["1.3","1.2","1.0"]`，并以 revision 1 ACK 空能力集合；只有 `userInput.request` 时
|
|
76
|
+
- `"1.4"` / `"1.3"` / `"1.2"` 没有强制 Handler；使用默认帧预算时，即使没有 Handler 也会广告
|
|
77
|
+
`["1.4","1.3","1.2","1.0"]`，并以 revision 1 ACK 空能力集合；只有 `userInput.request` 时
|
|
78
78
|
仍保持该集合，存在 `approval.request` 时才同时广告要求该 Handler 的 1.1；
|
|
79
|
-
- 显式把 `maxFrameBytes` 设为低于 `17 MiB` 时不会广告 `"1.3"`，因为该预算无法保证接收
|
|
79
|
+
- 显式把 `maxFrameBytes` 设为低于 `17 MiB` 时不会广告 `"1.4"` 与 `"1.3"`，因为该预算无法保证接收
|
|
80
80
|
最大 durable event frame；`"1.2"` / `"1.1"` / `"1.0"` 的回落规则保持不变；
|
|
81
|
-
- `connect()` / `start()` 只有在 `"1.3"` / `"1.2"` 初始 capability ACK 后才 resolve，ACK 前不会把
|
|
81
|
+
- `connect()` / `start()` 只有在 `"1.4"` / `"1.3"` / `"1.2"` 初始 capability ACK 后才 resolve，ACK 前不会把
|
|
82
82
|
Runtime Server Request 投递给 Handler；
|
|
83
83
|
- ACK 的 accepted methods 可以为空或为请求集的任意子集，并按 Runtime registry 排序；Client
|
|
84
84
|
按集合语义应用结果。只有 revision 不匹配或出现未请求 method 才是协议违例；未被接受的
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@roll-agent/client-node",
|
|
3
|
-
"version": "0.5.
|
|
3
|
+
"version": "0.5.2",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -26,7 +26,7 @@
|
|
|
26
26
|
"node": ">=22.6.0"
|
|
27
27
|
},
|
|
28
28
|
"dependencies": {
|
|
29
|
-
"@roll-agent/protocol": "0.
|
|
29
|
+
"@roll-agent/protocol": "0.6.1"
|
|
30
30
|
},
|
|
31
31
|
"devDependencies": {
|
|
32
32
|
"@types/node": "^22.0.0"
|