dsh-harness-reflex 0.1.0 → 0.3.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.
Files changed (124) hide show
  1. package/README.md +20 -6
  2. package/client.js +3511 -185
  3. package/dist/attribution.d.ts +266 -0
  4. package/dist/attribution.js +238 -0
  5. package/dist/attribution.js.map +1 -0
  6. package/dist/bridge.d.ts +311 -13
  7. package/dist/bridge.js +714 -42
  8. package/dist/bridge.js.map +1 -1
  9. package/dist/client-bundle.js +4 -1
  10. package/dist/client-bundle.js.map +1 -1
  11. package/dist/command.js +10 -0
  12. package/dist/command.js.map +1 -1
  13. package/dist/config.d.ts +530 -22
  14. package/dist/config.js +808 -27
  15. package/dist/config.js.map +1 -1
  16. package/dist/delegation-dispatch.d.ts +132 -0
  17. package/dist/delegation-dispatch.js +186 -0
  18. package/dist/delegation-dispatch.js.map +1 -0
  19. package/dist/delegation-health.d.ts +131 -0
  20. package/dist/delegation-health.js +97 -0
  21. package/dist/delegation-health.js.map +1 -0
  22. package/dist/delegation.d.ts +148 -0
  23. package/dist/delegation.js +186 -0
  24. package/dist/delegation.js.map +1 -0
  25. package/dist/effort-delegation.d.ts +144 -0
  26. package/dist/effort-delegation.js +280 -0
  27. package/dist/effort-delegation.js.map +1 -0
  28. package/dist/effort.d.ts +141 -0
  29. package/dist/effort.js +251 -9
  30. package/dist/effort.js.map +1 -1
  31. package/dist/host-patch.d.ts +156 -0
  32. package/dist/host-patch.js +534 -0
  33. package/dist/host-patch.js.map +1 -0
  34. package/dist/index.d.ts +12 -3
  35. package/dist/index.js +99 -7
  36. package/dist/index.js.map +1 -1
  37. package/dist/interventions.d.ts +98 -373
  38. package/dist/interventions.js +442 -1702
  39. package/dist/interventions.js.map +1 -1
  40. package/dist/panel-api.d.ts +328 -4
  41. package/dist/panel-api.js +322 -15
  42. package/dist/panel-api.js.map +1 -1
  43. package/dist/panel-mount.d.ts +81 -22
  44. package/dist/panel-mount.js +228 -7
  45. package/dist/panel-mount.js.map +1 -1
  46. package/dist/routing.d.ts +23 -18
  47. package/dist/routing.js +471 -153
  48. package/dist/routing.js.map +1 -1
  49. package/dist/session-audit.d.ts +70 -0
  50. package/dist/session-audit.js +73 -0
  51. package/dist/session-audit.js.map +1 -1
  52. package/dist/systemone-probe.d.ts +114 -0
  53. package/dist/systemone-probe.js +383 -0
  54. package/dist/systemone-probe.js.map +1 -0
  55. package/dist/testing.d.ts +212 -7
  56. package/dist/testing.js +333 -27
  57. package/dist/testing.js.map +1 -1
  58. package/dist/tools.d.ts +109 -3
  59. package/dist/tools.js +103 -4
  60. package/dist/tools.js.map +1 -1
  61. package/dist/unconfigured-backend.d.ts +72 -0
  62. package/dist/unconfigured-backend.js +94 -0
  63. package/dist/unconfigured-backend.js.map +1 -0
  64. package/dist/vendor/harness-reflex/backend/factory.d.ts +31 -1
  65. package/dist/vendor/harness-reflex/backend/factory.js +18 -3
  66. package/dist/vendor/harness-reflex/backend/factory.js.map +1 -1
  67. package/dist/vendor/harness-reflex/backend/jev.d.ts +20 -0
  68. package/dist/vendor/harness-reflex/backend/jev.js +11 -4
  69. package/dist/vendor/harness-reflex/backend/jev.js.map +1 -1
  70. package/dist/vendor/harness-reflex/backend/simple-jev.d.ts +16 -0
  71. package/dist/vendor/harness-reflex/backend/simple-jev.js +17 -6
  72. package/dist/vendor/harness-reflex/backend/simple-jev.js.map +1 -1
  73. package/dist/vendor/harness-reflex/core/closing.d.ts +90 -0
  74. package/dist/vendor/harness-reflex/core/closing.js +111 -0
  75. package/dist/vendor/harness-reflex/core/closing.js.map +1 -0
  76. package/dist/vendor/harness-reflex/core/evidence.d.ts +119 -0
  77. package/dist/vendor/harness-reflex/core/evidence.js +209 -0
  78. package/dist/vendor/harness-reflex/core/evidence.js.map +1 -0
  79. package/dist/vendor/harness-reflex/core/judge.d.ts +221 -0
  80. package/dist/vendor/harness-reflex/core/judge.js +251 -0
  81. package/dist/vendor/harness-reflex/core/judge.js.map +1 -0
  82. package/dist/vendor/harness-reflex/core/orchestrate-closing.d.ts +237 -0
  83. package/dist/vendor/harness-reflex/core/orchestrate-closing.js +250 -0
  84. package/dist/vendor/harness-reflex/core/orchestrate-closing.js.map +1 -0
  85. package/dist/vendor/harness-reflex/core/orchestrate-correction.d.ts +209 -0
  86. package/dist/vendor/harness-reflex/core/orchestrate-correction.js +141 -0
  87. package/dist/vendor/harness-reflex/core/orchestrate-correction.js.map +1 -0
  88. package/dist/vendor/harness-reflex/core/orchestrate-host.d.ts +225 -0
  89. package/dist/vendor/harness-reflex/core/orchestrate-host.js +80 -0
  90. package/dist/vendor/harness-reflex/core/orchestrate-host.js.map +1 -0
  91. package/dist/vendor/harness-reflex/core/orchestrate-stagnation.d.ts +259 -0
  92. package/dist/vendor/harness-reflex/core/orchestrate-stagnation.js +270 -0
  93. package/dist/vendor/harness-reflex/core/orchestrate-stagnation.js.map +1 -0
  94. package/dist/vendor/harness-reflex/core/orchestrate.d.ts +357 -0
  95. package/dist/vendor/harness-reflex/core/orchestrate.js +418 -0
  96. package/dist/vendor/harness-reflex/core/orchestrate.js.map +1 -0
  97. package/dist/vendor/harness-reflex/core/policy.d.ts +122 -0
  98. package/dist/vendor/harness-reflex/core/policy.js +102 -0
  99. package/dist/vendor/harness-reflex/core/policy.js.map +1 -0
  100. package/dist/vendor/harness-reflex/core/prune-plan.d.ts +141 -0
  101. package/dist/vendor/harness-reflex/core/prune-plan.js +390 -0
  102. package/dist/vendor/harness-reflex/core/prune-plan.js.map +1 -0
  103. package/dist/vendor/harness-reflex/core/text.d.ts +36 -0
  104. package/dist/vendor/harness-reflex/core/text.js +66 -0
  105. package/dist/vendor/harness-reflex/core/text.js.map +1 -0
  106. package/dist/vendor/harness-reflex/ports/audit.d.ts +18 -0
  107. package/dist/vendor/harness-reflex/ports/audit.js +11 -0
  108. package/dist/vendor/harness-reflex/ports/audit.js.map +1 -0
  109. package/dist/vendor/harness-reflex/ports/clock.d.ts +14 -0
  110. package/dist/vendor/harness-reflex/ports/clock.js +11 -0
  111. package/dist/vendor/harness-reflex/ports/clock.js.map +1 -0
  112. package/dist/vendor/harness-reflex/ports/decision.d.ts +75 -0
  113. package/dist/vendor/harness-reflex/ports/decision.js +2 -0
  114. package/dist/vendor/harness-reflex/ports/decision.js.map +1 -0
  115. package/dist/vendor/harness-reflex/ports/index.d.ts +14 -0
  116. package/dist/vendor/harness-reflex/ports/index.js +2 -0
  117. package/dist/vendor/harness-reflex/ports/index.js.map +1 -0
  118. package/dist/vendor/harness-reflex/ports/log.d.ts +22 -0
  119. package/dist/vendor/harness-reflex/ports/log.js +12 -0
  120. package/dist/vendor/harness-reflex/ports/log.js.map +1 -0
  121. package/dist/vendor/harness-reflex/ports/state.d.ts +46 -0
  122. package/dist/vendor/harness-reflex/ports/state.js +13 -0
  123. package/dist/vendor/harness-reflex/ports/state.js.map +1 -0
  124. package/package.json +25 -13
package/README.md CHANGED
@@ -52,7 +52,7 @@
52
52
 
53
53
  插件依赖 Host 的 `@deepseek-ai/*` 包。本机 npm registry 不可写(离线 / `EROFS`),因此**不需要**在插件目录
54
54
  里 `npm install`:仓库根目录的 `scripts/link-dsh-deps.mjs` 会把本机已安装的 DSH 依赖软链到
55
- `packages/dsh-reflex/node_modules/`(`harness-reflex` 指向仓库根,`@deepseek-ai/*` 指向 DSH 安装目录)。
55
+ `packages/dsh-harness-reflex/node_modules/`(`harness-reflex` 指向仓库根,`@deepseek-ai/*` 指向 DSH 安装目录)。
56
56
 
57
57
  ```bash
58
58
  # 仓库根目录执行:构建根包 → 链接 DSH 依赖 → 构建插件
@@ -67,20 +67,24 @@ DSH_HOST_MODULES=/path/to/dsh/node_modules npm run build:all
67
67
 
68
68
  ## 在 Host 中启用
69
69
 
70
+ 本版要求 DSH `>=0.2.2-rc.1 <0.2.3`。
71
+
70
72
  `package.json` 里的 `dsh.bundle.patch` 已指向 `cordis.patch.yml`,因此按 DSH bundle 插件的通用方式安装即可:
71
73
 
72
74
  ```bash
73
75
  # 从发布 tarball 安装(同版本重装必须 --force)
74
- dsh plugin --profile web add --force ./release/dsh-harness-reflex-0.1.0.tgz
76
+ dsh plugin --profile web add --force ./release/dsh-harness-reflex-0.3.0.tgz
77
+ # 0.3.0 上架 npm 后也可按包名安装
78
+ dsh plugin --profile web add dsh-harness-reflex@0.3.0
75
79
  # 开发时也可以直接装目录(会链接当前构建)
76
- dsh plugin --profile web add ./packages/dsh-reflex
80
+ dsh plugin --profile web add ./packages/dsh-harness-reflex
77
81
  ```
78
82
 
79
83
  插件的配置项(全部可选,schemastery 提供默认值):
80
84
 
81
85
  | 配置 | 默认 | 说明 |
82
86
  | --- | --- | --- |
83
- | `backend` | `auto` | `auto` 按环境变量选择 backend;也可强制 `mock` / `jev` / `vllm`。无任何环境变量时 `auto` 落到**离线 mock**(确定性、无网络) |
87
+ | `backend` | `auto` | 连接未指定实现时使用的选择器。全新配置的 `JEV official` 连接指定 `jev`,只读取 `JEV_API_KEY`;显式设为 `mock` 可使用离线模拟后端。 |
84
88
  | `toolPrefix` | `reflex_` | 工具名前缀,例如配成 `rv_` 就是 `rv_choice` |
85
89
  | `ledgerPath` | 省略 | 省略 = 台账**只留内存**(不写用户项目);填路径则追加 JSONL 并可回放 |
86
90
  | `pruneThreshold` | `500` | 字符数阈值,低于此长度的输出不剪枝 |
@@ -144,6 +148,16 @@ dsh plugin --profile web add ./packages/dsh-reflex
144
148
  | `reflex_screen` | `content`, `source?`, `strict?` | 提示注入/指令劫持筛查,命中时附数据围栏 |
145
149
  | `reflex_gate` | `assertions[{statement,criteria?}]`, `evidence`, `strictness?` | 声明-证据核对门禁(Fail-Closed) |
146
150
  | `reflex_route`(默认关闭) | `goal`, `candidates[{name,description}]`, `topK?` | 候选工具/技能概率排序(只排序不卡阈值) |
151
+ | `reflex_delegate`(需先授权,默认关闭) | `prompt`, `description`, `provider?`, `model?`, `cwd?` | 委派子代理,由 System One 判定思考档位;无档位参数,**仅在设置面板勾选「子代理委派」且宿主 `modelSelection` 开启时注册** |
152
+
153
+ ### `reflex_delegate` 为什么要单独授权
154
+
155
+ 宿主的 `tool-subagent` 只有在配置 `modelSelection: true` 时才会发布 `reasoning_effort` 参数,没有这个参数,System One 判定的档位就传不进子代理。因此:
156
+
157
+ 1. 设置面板「工具开关」页有 **子代理委派** 开关,默认关闭;勾选=明确同意开启宿主的 `modelSelection`。
158
+ 2. 勾选后插件把 `tool-subagent` 的 `modelSelection: true` **合并**进 profile patch(`~/.dsh/profiles/<profile>/cordis.patch.yml`):只动这一处,注释、顺序、`!!js` 表达式与其它条目**逐字节保留**,写入前先备份 `.bak-dsh-reflex-*`。遇到同名多条、`disabled: true`、或无法确切读取的写法时**拒绝写入并说明原因**,不猜。
159
+ 3. 宿主的 `tool-subagent` 配置是启动时读的,所以面板明确提示 **「已保存,重启 DSH 后生效」**,不假装即时生效。
160
+ 4. 运行期若检测到 `reasoning_effort` 消失(宿主能力又关了),插件**输出 warning、自动摘掉 `reflex_delegate`、在面板显示原因**,但**绝不改写你的配置文件**——那可能是你自己刚关掉的。重新勾选才是新的同意与新的写入。
147
161
 
148
162
  另外三项能力**不在工具清单里**:
149
163
 
@@ -189,7 +203,7 @@ ctx.effect(() => {
189
203
  ```bash
190
204
  npm test # 根包测试(ledger / score / route / route-prompt / MCP 表面 / 打包清单)
191
205
  npm run test:plugin # 插件测试(工具面 / 命令 / 校验 / 生命周期 / 路由 / 面板 / 使用说明)
192
- npm run test:all # 构建 + 两套测试
206
+ npm run test:all # 构建 + 七套测试
193
207
  npm run test:mutation # 负向对照:注入故障,要求被测试或编译器抓住
194
208
  ```
195
209
 
@@ -222,7 +236,7 @@ npm run test:mutation # 负向对照:注入故障,要求被测试或编
222
236
  ## 已知边界
223
237
 
224
238
  - 仓库内开发时,`scripts/link-dsh-deps.mjs` 把 `harness-reflex` 与 Host 模块软链进
225
- `packages/dsh-reflex/node_modules/`(`--check` 在未就绪时退出码 1,不触碰 registry);**发布形态不依赖任何
239
+ `packages/dsh-harness-reflex/node_modules/`(`--check` 在未就绪时退出码 1,不触碰 registry);**发布形态不依赖任何
226
240
  `harness-reflex` 版本范围**:`npm run build:all` 会把根包源码编译进 `dist/vendor/harness-reflex`,tarball
227
241
  自包含,安装时只需 Host 提供的 peer 模块。插件 tarball 采用 npm 标准命名
228
242
  `release/dsh-harness-reflex-<version>.tgz`(见根 [`README.md`](../../README.md) 的发布产物一节)。