pi-tsgw 1.0.0 → 1.1.0
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 +65 -28
- package/extensions/delegation/README.md +56 -0
- package/extensions/delegation/index.ts +215 -0
- package/extensions/delegation/policy.ts +356 -0
- package/extensions/models/gateway-catalog-recovery.ts +120 -0
- package/extensions/models/gateway-catalog-service.ts +217 -0
- package/extensions/models/gateway-catalog.ts +108 -62
- package/extensions/provider/catalog-coordinator.ts +404 -0
- package/extensions/provider/catalog-recovery.ts +107 -0
- package/extensions/provider/catalog-state.ts +175 -0
- package/extensions/provider/index.ts +96 -128
- package/extensions/provider/refresh-tool.ts +30 -20
- package/extensions/provider/status.ts +3 -2
- package/index.ts +5 -1
- package/package.json +2 -2
- package/skills/tsgw-delegate-model-selection/SKILL.md +13 -61
package/README.md
CHANGED
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
|
|
12
12
|
## 项目结构
|
|
13
13
|
|
|
14
|
-
包清单的 `pi.extensions` 指向根 `./index.ts
|
|
14
|
+
包清单的 `pi.extensions` 指向根 `./index.ts`,作为能力装配总入口;provider 注册与生命周期位于 `extensions/provider/`,模型模块位于 `extensions/models/`,图片协议实现位于该目录下的 `adapter/images/`,分类桥接位于 `adapter/classifiers/`,图片工具、参数 schema 与本地文件仍由 `extensions/images/` 承担。搜索模块及相邻测试位于 `extensions/search/`,提示词由 `extensions/prompts.ts` 的 `registerPrompts` 统一注册,正文位于 `prompts/`。宿主集成总测试为根 `index.test.ts`;provider、模型与搜索的测试与对应模块相邻,图片工具测试与 `extensions/images/` 中的实现相邻,共享测试夹具仍位于 `extensions/`。技能及其测试路径保持在 `skills/` 和 `extensions/`。
|
|
15
15
|
|
|
16
16
|
跨模块源码引用统一使用 package 子路径别名 `#tsgw/*`(映射到 `extensions/`)与 `#tsgw-prompts/*`(映射到 `prompts/`),别名不带 `.ts` 后缀;模块内部继续用相对 `.ts` 路径,由 tsc 改写为 `.js`。真实入口文件(含各 `index.ts`)继续承担实际装配职责,不为聚合再导出新增 barrel 索引。
|
|
17
17
|
|
|
@@ -30,6 +30,7 @@ extensions/models/
|
|
|
30
30
|
images/ # 图片协议实现与对应测试
|
|
31
31
|
classifiers/ # 分类桥接与对应测试
|
|
32
32
|
extensions/search/ # 搜索注册、代理与相邻测试
|
|
33
|
+
extensions/delegation/ # 子代理创建前分类选型、固定知识与相邻测试
|
|
33
34
|
extensions/images/ # 图片工具、schema、本地文件与宿主集成测试
|
|
34
35
|
extensions/prompts.ts # registerPrompts
|
|
35
36
|
prompts/memory.ts # 记忆提示词正文
|
|
@@ -83,8 +84,9 @@ pi install npm:pi-tsgw
|
|
|
83
84
|
`~/.pi/agent/auth.json` 中(推荐方式)。
|
|
84
85
|
2. **`TSGW_API_KEY` 环境变量** — 未存储凭据时由 Pi 回退使用。
|
|
85
86
|
|
|
86
|
-
|
|
87
|
-
|
|
87
|
+
初始化通过 Pi 的已存储凭据 API 校验并读取本地目录;后续刷新使用宿主提供的凭据。
|
|
88
|
+
两条解析路径不保证完全等价:仅通过环境变量认证时,初始化可能先登记零模型,
|
|
89
|
+
会话就绪后再由宿主解析凭据并恢复目录,不回退静态模型。
|
|
88
90
|
|
|
89
91
|
### 选项
|
|
90
92
|
|
|
@@ -161,27 +163,49 @@ GLM 5.3 仅支持文本。注册并不证明网关支持推理或工具调用。
|
|
|
161
163
|
请保留 `MiniMax-*` 的大小写。网关目录可用时,先与静态目录取交集,再应用过滤。
|
|
162
164
|
纳入规则无法添加未知或不可用的 ID。
|
|
163
165
|
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
166
|
+
插件初始化只读取本地缓存、完成 provider 注册,**不等待网络**:有可用缓存就先加载,
|
|
167
|
+
包括过期缓存;无有效缓存则先登记零个模型,不回退静态目录,也不阻塞宿主启动。
|
|
168
|
+
所有入口统一使用 **24 小时**新鲜窗口;内存与磁盘同时存在时选择获取时间更新的快照,
|
|
169
|
+
命中缓存和失败回退均不更新原始获取时间。
|
|
170
|
+
|
|
171
|
+
会话就绪且宿主允许联网后,缺少缓存或缓存过期时后台获取目录。单次请求超时 **5 秒**,
|
|
172
|
+
失败后间隔 **5 秒**重试;整轮请求与等待合计最多 **60 秒**。同进程的实例共用恢复轮次与重试序列,
|
|
173
|
+
后来加入不延长共享截止;每个实例仍以自身启动的一分钟窗口约束本地准备、等待与登记。
|
|
174
|
+
获取始终通过仍活跃实例的宿主服务执行,以保留联网许可和凭据解析。成功后各实例通过宿主同步自己的模型登记,
|
|
175
|
+
停止重试并清除异常状态。缺少凭据或认证失败直接提示,不等待一分钟;宿主禁止联网时不绕过许可。
|
|
176
|
+
一分钟内仍未获取成功则停止自动请求,通过 `ui.notify(..., "error")` 发出红色 Pi Web Toast,
|
|
177
|
+
同时保留红色异常状态。有旧目录时提示正在沿用缓存,无缓存时提示当前无可用模型。
|
|
178
|
+
同一轮失败只提醒一次;Toast 不代表用户已读,非 UI 模式使用安全日志提示。
|
|
179
|
+
会话退出或实例替换时取消恢复;不建立常驻轮询,不自动重试推理。
|
|
180
|
+
|
|
181
|
+
运行 `/tsgw-refresh` 可绕过缓存强制刷新,无需重启或重新加载 Pi;手动刷新不自动重试。
|
|
182
|
+
单个插件实例发起的后台恢复、命令和工具刷新共用一个登记调度器:同类请求合并;普通获取已经联网时,
|
|
183
|
+
后来的强制刷新复用同一请求,不再重复 GET;尚未决定读取缓存时,强制意图提升本轮网络阶段。
|
|
184
|
+
已命中缓存并完成的普通获取不能满足新的强制刷新。实际获取层也合并已进入插件的宿主回调,
|
|
185
|
+
一个调用方取消只退出自己的等待,仍有其他调用方等待时不取消共享任务。
|
|
186
|
+
Pi Web 多会话和后台 runtime 可分别加载插件;同一 JS 全局环境、同一 agent-dir 的实例
|
|
187
|
+
通过进程级服务共用原始目录与实际 GET,即使模块被重新导入也不重复建立获取任务。
|
|
188
|
+
各实例仍分别应用模型过滤与宿主能力、同步自己的登记和 UI;退出一个实例不取消其他实例的等待。
|
|
189
|
+
仅共享获取不代表所有宿主登记入口已全局串行。宿主在首次回调之前
|
|
190
|
+
自行进行的刷新重组不属于插件可观察的队列。
|
|
191
|
+
Pi Web 的目录刷新入口与聊天会话使用独立 runtime;并发获取在共享服务合并,
|
|
192
|
+
结果分别登记到对应 runtime,不把两者假设成同一个宿主刷新队列。
|
|
193
|
+
动态刷新失败保留原目录。旧版宿主若不转发强制刷新参数,未确认实际联网时只提示未完成刷新,
|
|
194
|
+
不误报成功;不提高聊天最低宿主版本。另一个会话更新缓存后,当前会话在下次目录检查时吸收更新,
|
|
195
|
+
不提供跨会话实时广播。
|
|
174
196
|
|
|
175
197
|
模型可通过 codemode 调用 `tools.tsgw_refresh_models({})` 自动获取,
|
|
176
198
|
或 `tools.tsgw_refresh_models({ force: true })` 强制刷新。
|
|
177
199
|
工具返回 `cacheFilePath`、`count` 与 `storedAt`,随后读取该文件的 `ids` 即为完整网关列表,
|
|
178
200
|
包括尚未静态登记的型号;不会把完整列表重复塞入工具返回值,也不会自动登记未知型号。
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
201
|
+
工具每次都经宿主刷新流程同步当前目录,缓存是否可用统一由 provider 判断。
|
|
202
|
+
返回的文件必须属于当前配置且对应已应用的完整快照;强制刷新时要求本次写入。
|
|
203
|
+
取消、获取失败或未确认落盘时,不会把旧文件报成本次刷新成功。
|
|
204
|
+
|
|
205
|
+
插件仅注册一个 `tsgw` provider,使用一个当前密钥。缓存文件固定为
|
|
206
|
+
`<agent-dir>/tsgw/models-cache.json`,不提供多配置或多槽位管理。
|
|
207
|
+
网关地址与密钥仅以 SHA-256 摘要校验,避免更换配置后误用旧缓存,不存储明文凭据。
|
|
208
|
+
旧版无摘要缓存会被忽略,并在获取成功后替换。
|
|
185
209
|
进程内请求排序可防止较晚返回的结果覆盖更新的缓存写入;这不是跨进程锁机制。
|
|
186
210
|
|
|
187
211
|
## 原生图片生成
|
|
@@ -253,7 +277,7 @@ text(result.stopReason === "stop" ? result.answers : { error: result.errorMessag
|
|
|
253
277
|
|
|
254
278
|
- **`TSGW · N`**(`/tsgw`):在同一菜单中**刷新模型目录**和**查看诊断信息**。
|
|
255
279
|
数量表示过滤后已注册的聊天、图片与分类目录条目数,而非健康推理端点的数量。
|
|
256
|
-
🟢 表示新鲜的目录结果;🟡
|
|
280
|
+
🟢 表示新鲜的目录结果;🟡 表示静态/过期目录;🔴 表示获取失败;⚠️ 表示缺少凭据或网关配置;
|
|
257
281
|
⏳ 表示正在刷新。
|
|
258
282
|
- **内置联网**(`/tsgw-search`):GPT 仅为当前会话提供 `cached / live`,默认为 `live`。
|
|
259
283
|
受支持的 Grok 模型固定使用实时搜索:此命令只显示提示,不提供选择器,也不改变 GPT
|
|
@@ -311,21 +335,34 @@ Pi Web 可能要等会话运行时启动后才显示扩展状态。
|
|
|
311
335
|
|
|
312
336
|
### 子代理编排与模型选型
|
|
313
337
|
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
338
|
+
本包附带精简的 [tsgw-delegate-model-selection](skills/tsgw-delegate-model-selection/SKILL.md)。
|
|
339
|
+
Pi 1.2+ 在兼容的 `model-only Agent` 执行前,**只对新建且未指定模型的调用分类一次**:
|
|
340
|
+
主代理直接提交任务提示词,插件使用内置选型知识补入 `Agent.model`,随后继续原工具执行。
|
|
341
|
+
不需要主代理读取长表、编写分类代码或收到分类结果后再派遣一次。
|
|
342
|
+
|
|
343
|
+
分类器从生效的 `tsgw` 文本分类目录动态选择,不固定 ID;按已知非零输入+输出参考价排序,
|
|
344
|
+
未知/零价排后,同价按 provider/ID 字典序。聊天候选取已维护模型/档位与生效目录及会话范围的交集,
|
|
345
|
+
分类后再次校验。价格只是参考,不是网关实扣价。分类增加一次请求的耗时和费用。
|
|
346
|
+
|
|
347
|
+
显式 `model`、`resume`、结果查询、补充指令及后续轮次不介入,不运行中换模型。
|
|
348
|
+
固定 Kimi+Astra 双审由主代理分别显式指定 `tsgw/kimi-k3:high`、`tsgw/gpt-6-astra:max`;
|
|
349
|
+
正式架构/设计文档独立审阅默认 Astra/max。任务拆分、依赖、并行、权限和验收仍由主代理负责。
|
|
350
|
+
分类失败、未决、取消、无候选或选定模型失效时,阻止本次自动创建并提示显式指定模型,
|
|
351
|
+
不静默使用父模型、不自动重试或换分类器;分类等待最多 15 秒,材料上限 28 KiB,超限不截断任务。
|
|
317
352
|
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
353
|
+
原 `Agent` 的调用 ID、宿主调度和子会话关联保持不变;工具结果附选型摘要,
|
|
354
|
+
`details.tsgwDelegation` 保留追踪信息,已报告分类用量合入原工具 `usage`。
|
|
355
|
+
选型知识和原参考表已迁入 [创建前选型维护说明](extensions/delegation/README.md) 与 `policy.ts`,
|
|
356
|
+
不要求主代理查榜或读取维护资料。隔离回归不证明真实选型质量或 Pi Web 展示已验收。
|
|
322
357
|
|
|
323
358
|
安装并执行 `/reload` 后,Pi 会通过包清单发现随包技能,除非宿主/包设置禁用或过滤了技能。
|
|
324
359
|
可以使用 `/skill:tsgw-git-commit` 等命令显式加载;仅加载根 `index.ts` 不会加载包内技能。
|
|
325
360
|
包设置中的 `skills: []` 可禁用全部技能,`skills: ["skills/tsgw-git-commit"]` 可仅加载指定技能,
|
|
326
361
|
或用 `skills: ["!skills/tsgw-git-commit/**"]` 排除该技能;由宿主处理,不是 `tsgw` 配置项。
|
|
327
362
|
|
|
328
|
-
|
|
363
|
+
模型选型需要兼容的子代理工具及可用的 `tsgw` 分类/聊天模型;旧宿主或无兼容工具时不挂接自动选型。
|
|
364
|
+
图片生成技能需要 Pi 1.2+、图片工具与可用的 `tsgw` 图片模型。通用开发技能不绑定模型 provider。
|
|
365
|
+
禁用随包技能不会关闭扩展中的创建前选型钩子;显式指定 `Agent.model` 可跳过选型。
|
|
329
366
|
本包不提供子代理工具,也不改变调度设置、用户规则文件或宿主权限。
|
|
330
367
|
|
|
331
368
|
### 记忆规则注入
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
# 创建前子代理选型
|
|
2
|
+
|
|
3
|
+
`index.ts` 在 Pi 1.2+ 接入兼容的 `model-only Agent`,`policy.ts` 承载固定问题、模型/思考档位候选和必要校验。主模型仍负责拆任务、权限、依赖、后台执行方式及验收;插件只补新建时的模型参数,不创建或管理子会话。
|
|
4
|
+
|
|
5
|
+
## 执行边界
|
|
6
|
+
|
|
7
|
+
- 只处理顶层 `Agent` 新建、没有非空 `model`、没有非空 `resume` 的调用。显式模型、续接、查询、steer、嵌套调用及子代理内部轮次不参与。`session_start` 通过公共 `getEntries()` 识别 Pi Web 的 `pi-web:subagent` custom 标记,子会话不注入用法或选型;普通 fork 的 `parentSession` 不作为角色证据。该标记是 Pi Web 宿主约定,不冒称适用于所有子代理宿主。
|
|
8
|
+
- 不新增工具,也不经 `ctx.executeTool` 嵌套调用 `Agent`。保留原调用 ID、任务提示词、档案、后台/隔离选项及宿主生命周期。
|
|
9
|
+
- 固定分类请求直接使用已有任务提示词和少量调用元数据;不发送会话历史,不读 `input_files` 内容,不要求主模型编写问题或代码。分类材料超过 28 KiB 时阻止自动创建,不截断原任务。
|
|
10
|
+
- 候选来自生效的 `tsgw` 聊天目录,并在配置了会话模型范围时进一步取交集;范围显式指定的思考档位同样限制候选。仅使用已维护的候选/档位,复用宿主支持档位判断。目录可用不等于端点健康。
|
|
11
|
+
- 分类器从生效的 `tsgw` 文本分类目录动态选择:已知非零输入+输出参考价较低者优先,未知/零价排后,同价按 provider/ID 字典序确定;不按目录数组顺序、不固定模型 ID。价格用于确定性选择,不代表网关实扣价。
|
|
12
|
+
- 一次分类同时给出任务类型和候选选择。不按未经校准的置信度阈值、复杂度分数或 AA 分数自动映射档位;无法判断选择 `unresolved`。
|
|
13
|
+
- 正式架构/设计文档独立审阅只接受 Astra/max。固定 Kimi+Astra 双审必须由主代理分别显式指定模型,不由一次分类发明额外子任务。自然语言类型判断仍是模型判断,不将其宣传成形式化安全保证。
|
|
14
|
+
- 分类与目录查询共享 15 秒取消窗口;无自动重试、无失败换模型。缺分类器、无候选、失败、未决、取消或选定模型已撤下时阻止本次自动创建,提示显式指定模型;不会静默使用父模型。分类成功后再次验证目录及档位。
|
|
15
|
+
- 原 `Agent` 的结果追加选型摘要,`details.tsgwDelegation` 记录分类器、目标模型、任务类型、耗时或安全错误原因;不保存原始分类响应、地址或凭据。已报告用量合入原工具 `usage`,不是重复计算子代理用量。
|
|
16
|
+
- 钩子原地修改参数后宿主不重新做 schema 验证,因此候选/档位由插件校验。后续钩子能看到选型后的参数并可阻止执行;更早的钩子不会自动重跑,不声称已经重做全部权限判断。
|
|
17
|
+
- 会话退出/重载中止本实例等待,迟到结果不能派遣;原 `Agent` 仍决定前台取消、后台任务和完成通知的语义。插件不让后台子代理随分类阶段的 signal 误停。
|
|
18
|
+
|
|
19
|
+
## 维护选型知识
|
|
20
|
+
|
|
21
|
+
以下是从原技能迁入的参考资料,不要求主代理读取。运行时使用 `policy.ts` 的提炼描述和有效候选,不逐次查榜或探测后端。更新模型目录/档位/选型依据时同步检查策略、这里的资料与简短技能说明;只给逻辑变化补测试,不锁定正文措辞或表格快照。
|
|
22
|
+
|
|
23
|
+
评分为原技能采用的 AA Intelligence Index v4.3.2 原始分;参考价格单位为美元/百万 tokens,不是订阅扣费。尚未验证这些排序能提升本地派遣质量。
|
|
24
|
+
|
|
25
|
+
| 任务等级 | 模型 | Pi 思考档位 | 参考评分 | 输入价 | 输出价 |
|
|
26
|
+
| --- | --- | --- | ---: | ---: | ---: |
|
|
27
|
+
| 轻量执行 | `MiniMax-M3` | high | 29† | 0.30 | 1.20 |
|
|
28
|
+
| 轻量执行 | `gpt-6-luna` | high | 33 | 0.10 | 0.50 |
|
|
29
|
+
| 通用工程 | `glm-5.3` | low | 34 | 1.18 | 4.13 |
|
|
30
|
+
| 通用工程 | `glm-5.3` | high | 待评 | 1.18 | 4.13 |
|
|
31
|
+
| 通用工程 | `glm-5.3` | max | 45 | 1.18 | 4.13 |
|
|
32
|
+
| 通用工程 | `gpt-6-luna` | max | 38 | 0.10 | 0.50 |
|
|
33
|
+
| 通用工程低成本备选 | `glm-5.3-flash` | max | 42 | 0.118 | 0.413 |
|
|
34
|
+
| 通用工程 | `gpt-6.1-sol` | medium | 48 | 2.00 | 10.00 |
|
|
35
|
+
| 通用工程优先候选 | `deepseek-flash` | high | 待评‡ | 0.1475–0.295 | 0.59–1.18 |
|
|
36
|
+
| 复杂实现优先候选 | `deepseek-flash` | max | 待评‡ | 0.1475–0.295 | 0.59–1.18 |
|
|
37
|
+
| 复杂任务 | `gpt-6.1-sol` | high | 50 | 2.00 | 10.00 |
|
|
38
|
+
| 高难任务 | `gpt-6.1-sol` | xhigh | 51 | 2.00 | 10.00 |
|
|
39
|
+
| 高难任务 | `gpt-6-astra` | high | 51 | 10.00 | 50.00 |
|
|
40
|
+
| 高难任务 | `gpt-6-astra` | xhigh | 52 | 10.00 | 50.00 |
|
|
41
|
+
| 极难任务 | `gpt-6.1-sol` | max | 52 | 2.00 | 10.00 |
|
|
42
|
+
| 极难任务、正式设计审阅 | `gpt-6-astra` | max | 53 | 10.00 | 50.00 |
|
|
43
|
+
| 双审专用,显式指定 | `kimi-k3` | high | 待评 | 3.00 | 15.00 |
|
|
44
|
+
|
|
45
|
+
- † MiniMax M3 的 high 映射为 adaptive;非 off 档位不代表不同能力档。29 分为模型级参考,不推广到 M3.1 Flash Preview。只派步骤明确的小任务。
|
|
46
|
+
- ‡ DeepSeek 旧 39 分不用于 1017 更新版。原资料为 2026-10-16 核对的国内价(Blinko 604):输入 1–2 元、输出 4–8 元,固定按 0.1475 USD/CNY 折算;区间为低谷/高峰价,静态目录采用高端,不按时段切换。高峰为北京时间工作日(不含法定假期)9–12、14–18。
|
|
47
|
+
- GLM 原资料为 Blinko 929,采用相同换算率。GLM 5.3 low/high/max 三档始终思考,medium 映射 high、xhigh 映射 max;FlashX 是未定档备选,不据此自动加入固定候选。FlashX 参考价 0.295/1.0325。
|
|
48
|
+
- GPT 价对应输入 ≤272K,超过后输入 ×2、输出 ×1.5;MiniMax 输入超过 512K 为 0.60/2.40。上下文大小不等于输出上限;`gpt-6.1-sol` 的网关 Codex 上下文为 500000,最大输出 128000。
|
|
49
|
+
- DeepSeek 常规工程优先 high、复杂实现优先 max。Sol 复杂任务优先 high,只有确需深入推理才选 xhigh/max,不保证升档提升。Astra 正式架构/设计文档独立审阅和最终复核默认 max,局部检查不等同正式审阅。
|
|
50
|
+
- Kimi 不承担长程执行;双模型复核固定 Kimi/high+Astra/max,独立审阅同一材料,不由自动单次选型决定是否新增第二个子任务。
|
|
51
|
+
- 原选型依据包括 [DeepSeek 官方更新日志](https://api-docs.deepseek.com/updates/)(2026-10-17)的 V4.1 Flash-1017 及 DeepSWE v1.1 77.0%(Mini-SWE-V2)。这是官方评测,既非 AA 同口径综合分,也非 Pi 或网关实测。官方别名更新不证明网关后端已同步;每任务费用不等于本表 token 单价,不承诺本地通过率/耗时。
|
|
52
|
+
- `grok-4.7`、`gemini-3.5-flash-lite`、`gemini-3.8-flash-high`、`longcat-2.5-preview` 不进入自动候选:Grok 工具往返未通过,LongCat 受额度阻塞,两款 Gemini 仅最小文本/工具往返,尚无本表同口径依据。登记不等于长期工程选型资格。
|
|
53
|
+
|
|
54
|
+
## 验证
|
|
55
|
+
|
|
56
|
+
纯策略与钩子测试使用合成注册表。宿主集成使用真实 Pi SDK/加载器/认证/分类 adapter 和模拟 HTTP、合成 `model-only Agent` 执行器;不启动付费分类或真实子会话,不读取个人配置。隔离测试不能替代真实网关选型质量、子会话创建或 Pi Web UI 验收。
|
|
@@ -0,0 +1,215 @@
|
|
|
1
|
+
import { getSupportedThinkingLevels } from "@earendil-works/pi-ai";
|
|
2
|
+
import type { Usage } from "@earendil-works/pi-ai";
|
|
3
|
+
import type {
|
|
4
|
+
ExtensionAPI, ExtensionContext, MessageEndEventResult, ToolCallEvent, ToolCallEventResult, ToolResultEvent, ToolResultEventResult,
|
|
5
|
+
} from "@earendil-works/pi-coding-agent";
|
|
6
|
+
import { isPlainObject } from "#tsgw/models/_tools";
|
|
7
|
+
import {
|
|
8
|
+
buildDelegationCandidates, buildDelegationContext, chooseClassifier, resolveDelegationChoice,
|
|
9
|
+
type DelegationCandidate,
|
|
10
|
+
} from "./policy.ts";
|
|
11
|
+
|
|
12
|
+
const TIMEOUT_MS = 15_000;
|
|
13
|
+
const MAX_CONTEXT_BYTES = 28 * 1024;
|
|
14
|
+
const GUIDANCE = "新建子代理时,直接调用 Agent,写清任务、验收标准和约束;未明确指定模型时省略 model," +
|
|
15
|
+
"由 TSGW 在创建前自动分类选型,无需读取长选型表或编写 codemode 分类脚本。" +
|
|
16
|
+
"用户指定模型或固定审阅组合时显式传 model;resume 沿用原模型,不重新选型。";
|
|
17
|
+
const EXPLICIT = "本次未创建子代理;请核对任务后显式指定 Agent.model,不自动重试或换分类模型。";
|
|
18
|
+
|
|
19
|
+
type Decision = {
|
|
20
|
+
status: "selected" | "blocked";
|
|
21
|
+
classifier?: string;
|
|
22
|
+
model?: string;
|
|
23
|
+
kind?: string;
|
|
24
|
+
reason?: string;
|
|
25
|
+
durationMs: number;
|
|
26
|
+
};
|
|
27
|
+
interface Attempt {
|
|
28
|
+
controller: AbortController;
|
|
29
|
+
completion: Promise<Decision>;
|
|
30
|
+
decision?: Decision;
|
|
31
|
+
usage?: Usage;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/** 保持原工具的执行与 UI 契约,不把其他同名但不同参数的工具当作 Pi Web Agent。 */
|
|
35
|
+
function hasAgent(pi: ExtensionAPI): boolean {
|
|
36
|
+
const tool = (pi.getAllTools?.() ?? []).find(entry => entry.name === "Agent");
|
|
37
|
+
if (!tool || tool.exposure !== "model-only" || !isPlainObject(tool.parameters)) return false;
|
|
38
|
+
const properties = tool.parameters.properties;
|
|
39
|
+
return isPlainObject(properties) && ["prompt", "model", "resume"].every(name =>
|
|
40
|
+
isPlainObject(properties[name]) && properties[name].type === "string");
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
function supplied(value: unknown): boolean {
|
|
44
|
+
return typeof value === "string" && value.trim().length > 0;
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/** 取消要中断等待;上游即使忽略 signal,迟到结果也不能创建子代理。 */
|
|
48
|
+
function abortable<T>(promise: Promise<T>, signal: AbortSignal): Promise<T> {
|
|
49
|
+
return new Promise((resolve, reject) => {
|
|
50
|
+
const abort = () => reject(new Error("分类等待已取消。"));
|
|
51
|
+
if (signal.aborted) abort();
|
|
52
|
+
else signal.addEventListener("abort", abort, { once: true });
|
|
53
|
+
promise.then(resolve, reject).finally(() => signal.removeEventListener("abort", abort));
|
|
54
|
+
});
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
function addUsage(first: Usage | undefined, second: Usage | undefined): Usage | undefined {
|
|
58
|
+
if (!first) return second;
|
|
59
|
+
if (!second) return first;
|
|
60
|
+
return {
|
|
61
|
+
input: first.input + second.input, output: first.output + second.output,
|
|
62
|
+
cacheRead: first.cacheRead + second.cacheRead, cacheWrite: first.cacheWrite + second.cacheWrite,
|
|
63
|
+
totalTokens: first.totalTokens + second.totalTokens,
|
|
64
|
+
cost: {
|
|
65
|
+
input: first.cost.input + second.cost.input, output: first.cost.output + second.cost.output,
|
|
66
|
+
cacheRead: first.cost.cacheRead + second.cost.cacheRead,
|
|
67
|
+
cacheWrite: first.cost.cacheWrite + second.cost.cacheWrite, total: first.cost.total + second.cost.total,
|
|
68
|
+
},
|
|
69
|
+
...(first.reasoning === undefined && second.reasoning === undefined ? {} :
|
|
70
|
+
{ reasoning: (first.reasoning ?? 0) + (second.reasoning ?? 0) }),
|
|
71
|
+
...(first.cacheWrite1h === undefined && second.cacheWrite1h === undefined ? {} :
|
|
72
|
+
{ cacheWrite1h: (first.cacheWrite1h ?? 0) + (second.cacheWrite1h ?? 0) }),
|
|
73
|
+
};
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/** 只接管新建 Agent 的一次选型;不拥有子会话,不接触其后续轮次或调度。 */
|
|
77
|
+
export function registerDelegation(pi: ExtensionAPI): void {
|
|
78
|
+
let active = false;
|
|
79
|
+
let lifecycle = new AbortController();
|
|
80
|
+
const attempts = new Map<string, Attempt>();
|
|
81
|
+
const clear = () => {
|
|
82
|
+
for (const attempt of attempts.values()) attempt.controller.abort();
|
|
83
|
+
attempts.clear();
|
|
84
|
+
};
|
|
85
|
+
pi.on("session_start", (_event, ctx) => {
|
|
86
|
+
active = false;
|
|
87
|
+
lifecycle.abort();
|
|
88
|
+
clear();
|
|
89
|
+
lifecycle = new AbortController();
|
|
90
|
+
// Pi Web 在 session_start 前写入该公开可读标记;普通 fork 的 parentSession 不是角色证据。
|
|
91
|
+
const entries = ctx?.sessionManager?.getEntries?.() ?? [];
|
|
92
|
+
active = !entries.some(entry => entry.type === "custom" && entry.customType === "pi-web:subagent");
|
|
93
|
+
});
|
|
94
|
+
pi.on("session_shutdown", () => {
|
|
95
|
+
active = false;
|
|
96
|
+
lifecycle.abort();
|
|
97
|
+
clear();
|
|
98
|
+
});
|
|
99
|
+
pi.on("agent_end", clear);
|
|
100
|
+
pi.on("before_agent_start", event => {
|
|
101
|
+
if (!active || !pi.getActiveTools().includes("Agent") || !hasAgent(pi)) return;
|
|
102
|
+
if (event.systemPromptOptions) event.systemPromptOptions.sections.tsgw_delegation = GUIDANCE;
|
|
103
|
+
else return { systemPrompt: `${event.systemPrompt}\n\n${GUIDANCE}` };
|
|
104
|
+
});
|
|
105
|
+
|
|
106
|
+
async function select(event: ToolCallEvent, ctx: ExtensionContext, attempt: Attempt): Promise<Decision> {
|
|
107
|
+
const started = Date.now();
|
|
108
|
+
const blocked = (reason: string): Decision => ({ status: "blocked", reason, durationMs: Date.now() - started });
|
|
109
|
+
const registry = ctx.modelRegistry;
|
|
110
|
+
const scope = ctx.scopedModels?.map(entry => ({
|
|
111
|
+
model: `${entry.model.provider}/${entry.model.id}`, level: entry.thinkingLevel,
|
|
112
|
+
})) ?? [];
|
|
113
|
+
const caller = ctx.signal;
|
|
114
|
+
const signal = AbortSignal.any([lifecycle.signal, attempt.controller.signal,
|
|
115
|
+
AbortSignal.timeout(TIMEOUT_MS), ...(caller ? [caller] : [])]);
|
|
116
|
+
const input: Record<string, unknown> = event.input;
|
|
117
|
+
const task = {
|
|
118
|
+
prompt: typeof input.prompt === "string" ? input.prompt : "",
|
|
119
|
+
...(typeof input.description === "string" ? { description: input.description } : {}),
|
|
120
|
+
...(typeof input.subagent_type === "string" ? { subagent_type: input.subagent_type } : {}),
|
|
121
|
+
...(Array.isArray(input.input_files) && input.input_files.every(path => typeof path === "string") ?
|
|
122
|
+
{ input_files: [...input.input_files] as string[] } : {}),
|
|
123
|
+
...(typeof input.run_in_background === "boolean" ? { run_in_background: input.run_in_background } : {}),
|
|
124
|
+
};
|
|
125
|
+
let classifierId: string | undefined;
|
|
126
|
+
const failure = (reason: string): Decision => ({ ...blocked(reason), ...(classifierId ? { classifier: classifierId } : {}) });
|
|
127
|
+
try {
|
|
128
|
+
signal.throwIfAborted();
|
|
129
|
+
if (!task.prompt.trim()) return failure("任务提示词为空。");
|
|
130
|
+
if (typeof registry.getAvailableOfType !== "function" || typeof registry.classify !== "function")
|
|
131
|
+
return failure("当前宿主不支持原生分类选型。");
|
|
132
|
+
const candidates = async (): Promise<DelegationCandidate[]> => {
|
|
133
|
+
const models = await abortable(registry.getAvailableOfType("chat", "tsgw", { signal }), signal);
|
|
134
|
+
return buildDelegationCandidates(models.filter(model => !scope.length ||
|
|
135
|
+
scope.some(entry => entry.model === `${model.provider}/${model.id}`)), getSupportedThinkingLevels)
|
|
136
|
+
.filter(candidate => !scope.length || scope.some(entry => entry.model === `${candidate.provider}/${candidate.id}` &&
|
|
137
|
+
(!entry.level || entry.level === candidate.level)));
|
|
138
|
+
};
|
|
139
|
+
const available = await candidates();
|
|
140
|
+
if (!available.length) return failure("没有符合选型规则和当前目录/会话范围的聊天模型。");
|
|
141
|
+
const context = buildDelegationContext(task, available);
|
|
142
|
+
if (Buffer.byteLength(JSON.stringify(context), "utf8") > MAX_CONTEXT_BYTES)
|
|
143
|
+
return failure("选型材料超过 28 KiB,请精简提示词或显式指定模型;未截断任务。");
|
|
144
|
+
const classifiers = await abortable(registry.getAvailableOfType("classifier", "tsgw", { signal }), signal);
|
|
145
|
+
const classifier = chooseClassifier(classifiers);
|
|
146
|
+
if (!classifier) return failure("没有可用的 TSGW 文本分类模型。");
|
|
147
|
+
classifierId = `${classifier.provider}/${classifier.id}`;
|
|
148
|
+
signal.throwIfAborted();
|
|
149
|
+
const result = await abortable(registry.classify(classifier, context,
|
|
150
|
+
{ signal, timeoutMs: TIMEOUT_MS, maxRetries: 0 }), signal);
|
|
151
|
+
attempt.usage = result.usage;
|
|
152
|
+
signal.throwIfAborted();
|
|
153
|
+
if (result.stopReason !== "stop") return failure(result.stopReason === "aborted" ? "分类已取消。" : "分类请求未成功。");
|
|
154
|
+
const selected = resolveDelegationChoice(result.answers, available);
|
|
155
|
+
if (!selected) return failure("分类结果无效、未决或不符合固定审阅规则。");
|
|
156
|
+
// 分类过程中目录可能刷新;必须再次校验,不能静默选另一个模型。
|
|
157
|
+
const current = await candidates();
|
|
158
|
+
signal.throwIfAborted();
|
|
159
|
+
if (!current.some(candidate => candidate.model === selected.model))
|
|
160
|
+
return failure("选定模型或思考档位已不在当前可用候选中。");
|
|
161
|
+
const kind = result.answers.kind;
|
|
162
|
+
return { status: "selected", classifier: classifierId, model: selected.model,
|
|
163
|
+
...(kind?.type === "choice" ? { kind: kind.choice } : {}), durationMs: Date.now() - started };
|
|
164
|
+
} catch {
|
|
165
|
+
return failure(signal.aborted ? "分类选型已取消或超时。" : "分类选型失败,请检查目录与宿主认证。");
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
pi.on("tool_call", async (event, ctx): Promise<ToolCallEventResult | undefined> => {
|
|
170
|
+
if (event.toolName !== "Agent" || event.parentToolCallId || supplied(event.input.resume) || supplied(event.input.model)) return;
|
|
171
|
+
if (!active || !hasAgent(pi)) return;
|
|
172
|
+
const caller = ctx.signal;
|
|
173
|
+
let attempt = attempts.get(event.toolCallId);
|
|
174
|
+
if (!attempt) {
|
|
175
|
+
attempt = { controller: new AbortController(), completion: Promise.resolve({ status: "blocked", durationMs: 0 }) };
|
|
176
|
+
attempts.set(event.toolCallId, attempt);
|
|
177
|
+
attempt.completion = select(event, ctx, attempt);
|
|
178
|
+
}
|
|
179
|
+
const decision = await attempt.completion;
|
|
180
|
+
attempt.decision = decision;
|
|
181
|
+
if (!active || attempt.controller.signal.aborted || caller?.aborted)
|
|
182
|
+
return { block: true, reason: `TSGW 分类选型已取消。${EXPLICIT}` };
|
|
183
|
+
if (decision.status !== "selected" || !decision.model)
|
|
184
|
+
return { block: true, reason: `TSGW ${decision.reason ?? "分类选型未完成。"}${EXPLICIT}` };
|
|
185
|
+
// 只补模型,不改变 prompt/profile/后台标志/隔离方式;原 Agent 继续执行。
|
|
186
|
+
event.input.model = decision.model;
|
|
187
|
+
});
|
|
188
|
+
|
|
189
|
+
const decorateResult = (event: Pick<ToolResultEvent, "toolCallId" | "toolName" | "content" | "isError"> &
|
|
190
|
+
Partial<Pick<ToolResultEvent, "details" | "structuredContent" | "usage">>
|
|
191
|
+
): ToolResultEventResult | undefined => {
|
|
192
|
+
const attempt = attempts.get(event.toolCallId);
|
|
193
|
+
if (event.toolName !== "Agent" || !attempt?.decision) return;
|
|
194
|
+
attempts.delete(event.toolCallId);
|
|
195
|
+
const decision = attempt.decision;
|
|
196
|
+
const summary = decision.status === "selected"
|
|
197
|
+
? `TSGW 创建前选型:${decision.model}(分类器 ${decision.classifier});${event.isError ? "原 Agent 调用未成功。" : "已交由原 Agent 执行。"}`
|
|
198
|
+
: `TSGW 创建前选型未完成:${decision.reason}${EXPLICIT}`;
|
|
199
|
+
return {
|
|
200
|
+
content: [...event.content, { type: "text" as const, text: summary }],
|
|
201
|
+
...(event.structuredContent === undefined ? {} : { structuredContent: event.structuredContent }),
|
|
202
|
+
details: { ...(isPlainObject(event.details) ? event.details : { originalDetails: event.details }),
|
|
203
|
+
tsgwDelegation: decision },
|
|
204
|
+
usage: addUsage(event.usage, attempt.usage),
|
|
205
|
+
};
|
|
206
|
+
};
|
|
207
|
+
pi.on("tool_result", decorateResult);
|
|
208
|
+
// Pi 的执行前阻止/取消路径不会触发 tool_result;在最终消息处补记已报告的分类用量。
|
|
209
|
+
// 正常执行已在 tool_result 消费记录,不能在 message_end 再次加账。
|
|
210
|
+
pi.on("message_end", (event): MessageEndEventResult | undefined => {
|
|
211
|
+
if (event.message.role !== "toolResult") return;
|
|
212
|
+
const result = decorateResult(event.message);
|
|
213
|
+
if (result) return { message: { ...event.message, ...result } as typeof event.message };
|
|
214
|
+
});
|
|
215
|
+
}
|