@octopi-agent/engine 0.90.11 → 0.98.4

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 (246) hide show
  1. package/dist/config-admin/agent-presets.d.ts +70 -0
  2. package/dist/config-admin/agent-presets.js +243 -0
  3. package/dist/config-admin/discover.d.ts +30 -0
  4. package/dist/config-admin/discover.js +48 -0
  5. package/dist/config-admin/env.d.ts +22 -0
  6. package/dist/config-admin/env.js +41 -0
  7. package/dist/config-admin/index.d.ts +20 -0
  8. package/dist/config-admin/index.js +15 -0
  9. package/dist/config-admin/model-presets.d.ts +75 -0
  10. package/dist/config-admin/model-presets.js +249 -0
  11. package/dist/config-admin/name-guard.d.ts +14 -0
  12. package/dist/config-admin/name-guard.js +24 -0
  13. package/dist/config-admin/patch.d.ts +56 -0
  14. package/dist/config-admin/patch.js +201 -0
  15. package/dist/config-admin/port.d.ts +68 -0
  16. package/dist/config-admin/port.js +21 -0
  17. package/dist/config-admin/redact.d.ts +39 -0
  18. package/dist/config-admin/redact.js +42 -0
  19. package/dist/config-schema/agent.d.ts +45 -1
  20. package/dist/config-schema/context.d.ts +6 -1
  21. package/dist/config-schema/context.js +8 -0
  22. package/dist/config-schema/engine.d.ts +110 -4
  23. package/dist/config-schema/governance.d.ts +45 -1
  24. package/dist/config-schema/governance.js +187 -0
  25. package/dist/config-schema/models.d.ts +5 -2
  26. package/dist/config-schema/models.js +4 -1
  27. package/dist/config-schema/observability.d.ts +9 -0
  28. package/dist/config-schema/observability.js +29 -0
  29. package/dist/config-schema/run.d.ts +3 -0
  30. package/dist/config-schema/run.js +14 -0
  31. package/dist/config.d.ts +29 -4
  32. package/dist/config.js +15 -4
  33. package/dist/harness/activation/dispatcher.d.ts +8 -2
  34. package/dist/harness/activation/dispatcher.js +33 -5
  35. package/dist/harness/activation/inbox.d.ts +87 -0
  36. package/dist/harness/activation/inbox.js +169 -0
  37. package/dist/harness/activation/runtime.d.ts +9 -8
  38. package/dist/harness/activation/runtime.js +100 -8
  39. package/dist/harness/activation/types.d.ts +19 -0
  40. package/dist/harness/activation/types.js +2 -0
  41. package/dist/harness/agent/builder.d.ts +26 -1
  42. package/dist/harness/agent/builder.js +85 -37
  43. package/dist/harness/agent/config-bridge.d.ts +5 -0
  44. package/dist/harness/agent/config-bridge.js +3 -0
  45. package/dist/harness/agent/config-integrity.d.ts +138 -0
  46. package/dist/harness/agent/config-integrity.js +235 -0
  47. package/dist/harness/agent/wire-agent-builder.js +7 -1
  48. package/dist/harness/collaboration/autonomous-subsystem/index.d.ts +2 -2
  49. package/dist/harness/collaboration/autonomous-subsystem/index.js +1 -1
  50. package/dist/harness/collaboration/autonomous-subsystem/loader.js +3 -0
  51. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +19 -2
  52. package/dist/harness/collaboration/autonomous-subsystem/think/completion-guard.d.ts +40 -0
  53. package/dist/harness/collaboration/autonomous-subsystem/think/completion-guard.js +59 -0
  54. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +3 -1
  55. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +2 -0
  56. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -0
  57. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +1 -1
  58. package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +9 -0
  59. package/dist/harness/collaboration/delegation/child-run.js +21 -5
  60. package/dist/harness/collaboration/delegation/notifier.js +4 -3
  61. package/dist/harness/collaboration/delegation/service.js +2 -3
  62. package/dist/harness/collaboration/delegation/wiring.js +6 -5
  63. package/dist/harness/collaboration/orchestration/reflector/llm-reflector.d.ts +1 -1
  64. package/dist/harness/collaboration/orchestration/reflector/llm-reflector.js +1 -1
  65. package/dist/harness/context/capabilities/compact/engine.d.ts +30 -0
  66. package/dist/harness/context/capabilities/compact/engine.js +198 -46
  67. package/dist/harness/context/capabilities/compact/handover.d.ts +78 -0
  68. package/dist/harness/context/capabilities/compact/handover.js +107 -0
  69. package/dist/harness/context/capabilities/compact/index.d.ts +3 -1
  70. package/dist/harness/context/capabilities/compact/index.js +2 -1
  71. package/dist/harness/context/capabilities/compact/types.d.ts +30 -1
  72. package/dist/harness/context/capabilities/summary/executor.js +2 -1
  73. package/dist/harness/context/capabilities/summary/policies.js +8 -5
  74. package/dist/harness/context/capabilities/summary/resolver.d.ts +1 -1
  75. package/dist/harness/context/capabilities/summary/resolver.js +4 -4
  76. package/dist/harness/context/capabilities/summary/types.d.ts +2 -2
  77. package/dist/harness/context/constitution/default-agents.md +11 -10
  78. package/dist/harness/context/default-context-engine.d.ts +34 -4
  79. package/dist/harness/context/default-context-engine.js +194 -49
  80. package/dist/harness/context/hybrid-compressor.js +6 -0
  81. package/dist/harness/context/layers.d.ts +2 -4
  82. package/dist/harness/context/layers.js +9 -11
  83. package/dist/harness/context/llm-summarizer.d.ts +2 -8
  84. package/dist/harness/context/llm-summarizer.js +69 -91
  85. package/dist/harness/context/message-selector.js +4 -3
  86. package/dist/harness/context/summarize.d.ts +3 -1
  87. package/dist/harness/context/summarize.js +9 -4
  88. package/dist/harness/context/system-prompt-assembler.d.ts +2 -0
  89. package/dist/harness/context/system-prompt-assembler.js +1 -0
  90. package/dist/harness/context/truncate-compressor.js +7 -0
  91. package/dist/harness/context/turn-envelope.d.ts +3 -2
  92. package/dist/harness/context/turn-envelope.js +3 -2
  93. package/dist/harness/context/types.d.ts +33 -1
  94. package/dist/harness/extension/execution-environment/dangerous-commands.d.ts +28 -0
  95. package/dist/harness/extension/execution-environment/dangerous-commands.js +129 -0
  96. package/dist/harness/extension/execution-environment/effect-policy.d.ts +149 -8
  97. package/dist/harness/extension/execution-environment/effect-policy.js +274 -19
  98. package/dist/harness/extension/execution-environment/index.d.ts +4 -2
  99. package/dist/harness/extension/execution-environment/index.js +2 -1
  100. package/dist/harness/extension/execution-environment/kill-switch.d.ts +34 -0
  101. package/dist/harness/extension/execution-environment/kill-switch.js +46 -0
  102. package/dist/harness/extension/execution-environment/ops-audit.d.ts +204 -0
  103. package/dist/harness/extension/execution-environment/ops-audit.js +337 -0
  104. package/dist/harness/extension/execution-environment/privileged-exec.d.ts +158 -0
  105. package/dist/harness/extension/execution-environment/privileged-exec.js +418 -0
  106. package/dist/harness/extension/execution-environment/process-info.d.ts +180 -0
  107. package/dist/harness/extension/execution-environment/process-info.js +466 -0
  108. package/dist/harness/extension/execution-environment/process-isolation.d.ts +7 -0
  109. package/dist/harness/extension/execution-environment/process-isolation.js +9 -0
  110. package/dist/harness/extension/execution-environment/sandbox.d.ts +109 -0
  111. package/dist/harness/extension/execution-environment/sandbox.js +228 -21
  112. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +1 -1
  113. package/dist/harness/extension/execution-environment/tool-capabilities.js +6 -0
  114. package/dist/harness/extension/execution-environment/types.d.ts +19 -0
  115. package/dist/harness/extension/execution-environment/undo-log.d.ts +6 -2
  116. package/dist/harness/extension/execution-environment/undo-log.js +31 -10
  117. package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +5 -0
  118. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +33 -0
  119. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +4 -5
  120. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +5 -15
  121. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +3 -0
  122. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +70 -26
  123. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +3 -9
  124. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +3 -6
  125. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +9 -5
  126. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +9 -130
  127. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +122 -14
  128. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +2 -0
  129. package/dist/harness/extension/plugin-ecosystem/tools/index.js +2 -0
  130. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +4 -13
  131. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +25 -11
  132. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +168 -62
  133. package/dist/harness/extension/plugin-ecosystem/tools/privileged-tool.d.ts +43 -0
  134. package/dist/harness/extension/plugin-ecosystem/tools/privileged-tool.js +350 -0
  135. package/dist/harness/extension/plugin-ecosystem/tools/process-tools.d.ts +30 -0
  136. package/dist/harness/extension/plugin-ecosystem/tools/process-tools.js +137 -0
  137. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +54 -4
  138. package/dist/harness/governance/human-in-the-loop/decision-cache.js +42 -16
  139. package/dist/harness/governance/security/default-risk-policy.d.ts +1 -0
  140. package/dist/harness/governance/security/default-risk-policy.js +1 -0
  141. package/dist/harness/governance/security/default-security-guard.js +9 -0
  142. package/dist/harness/governance/security/index.d.ts +1 -0
  143. package/dist/harness/governance/security/index.js +2 -0
  144. package/dist/harness/governance/security/risk-evaluator.js +13 -0
  145. package/dist/harness/governance/security/risk-types.d.ts +12 -0
  146. package/dist/harness/governance/security/shell-parser-fallback.d.ts +29 -0
  147. package/dist/harness/governance/security/shell-parser-fallback.js +410 -0
  148. package/dist/harness/governance/security/shell-parser-shared.d.ts +83 -0
  149. package/dist/harness/governance/security/shell-parser-shared.js +188 -0
  150. package/dist/harness/governance/security/shell-parser-treesitter.d.ts +52 -0
  151. package/dist/harness/governance/security/shell-parser-treesitter.js +370 -0
  152. package/dist/harness/governance/security/shell-parser.d.ts +23 -10
  153. package/dist/harness/governance/security/shell-parser.js +37 -496
  154. package/dist/harness/governance/security/temp-path.d.ts +9 -0
  155. package/dist/harness/governance/security/temp-path.js +13 -2
  156. package/dist/harness/governance/security/vendor/README.md +24 -0
  157. package/dist/harness/governance/security/vendor/tree-sitter-bash.LICENSE.txt +21 -0
  158. package/dist/harness/governance/security/vendor/tree-sitter-bash.wasm +0 -0
  159. package/dist/harness/governance/session-acl/seed-roles.js +14 -0
  160. package/dist/harness/index.d.ts +2 -0
  161. package/dist/harness/index.js +2 -0
  162. package/dist/harness/knowledge/fts.js +1 -2
  163. package/dist/harness/knowledge/index-store.js +59 -9
  164. package/dist/harness/memory/index.d.ts +6 -2
  165. package/dist/harness/memory/index.js +4 -1
  166. package/dist/harness/memory/memory-events.d.ts +25 -0
  167. package/dist/harness/memory/memory-events.js +38 -0
  168. package/dist/harness/memory/sqlite/agent-db.js +15 -0
  169. package/dist/harness/memory/sqlite/keyword-search.d.ts +1 -0
  170. package/dist/harness/memory/sqlite/keyword-search.js +4 -3
  171. package/dist/harness/memory/sqlite/wisdom-store.d.ts +7 -2
  172. package/dist/harness/memory/sqlite/wisdom-store.js +51 -2
  173. package/dist/harness/memory/steward-policy.d.ts +3 -0
  174. package/dist/harness/memory/steward-policy.js +1 -1
  175. package/dist/harness/memory/types.d.ts +41 -3
  176. package/dist/harness/memory/wisdom-attribution.d.ts +136 -0
  177. package/dist/harness/memory/wisdom-attribution.js +287 -0
  178. package/dist/harness/memory/wisdom-events.d.ts +37 -0
  179. package/dist/harness/memory/wisdom-events.js +61 -0
  180. package/dist/harness/memory/wisdom-formation.d.ts +20 -1
  181. package/dist/harness/memory/wisdom-formation.js +55 -21
  182. package/dist/harness/memory/wisdom.d.ts +7 -2
  183. package/dist/harness/memory/wisdom.js +40 -2
  184. package/dist/harness/observability/observer/hub.js +8 -0
  185. package/dist/harness/observability/observer/run-snapshot.js +1 -0
  186. package/dist/harness/observability/observer/types.d.ts +4 -0
  187. package/dist/harness/run/agent/agent.d.ts +7 -0
  188. package/dist/harness/run/agent/agent.js +23 -1
  189. package/dist/harness/run/reliability/fallback-provider.d.ts +117 -5
  190. package/dist/harness/run/reliability/fallback-provider.js +262 -22
  191. package/dist/harness/run/reliability/harness-events.d.ts +24 -1
  192. package/dist/harness/run/reliability/model-error-policy.d.ts +32 -0
  193. package/dist/harness/run/reliability/model-error-policy.js +42 -0
  194. package/dist/harness/run/reliability/provider-wrapper.js +29 -2
  195. package/dist/harness/run/reliability/refusal-guard.d.ts +20 -0
  196. package/dist/harness/run/reliability/refusal-guard.js +102 -0
  197. package/dist/harness/run/reliability/run-agent.js +231 -33
  198. package/dist/harness/run/run-guard/default-run-guard.js +1 -1
  199. package/dist/harness/run/run-scope.d.ts +35 -0
  200. package/dist/harness/run/runner.d.ts +141 -2
  201. package/dist/harness/run/runner.js +592 -42
  202. package/dist/harness/session/attachments/llm-intent.js +2 -1
  203. package/dist/harness/session/tasks/render.d.ts +4 -1
  204. package/dist/harness/session/tasks/render.js +10 -7
  205. package/dist/harness/shared/events/agent-event-map.d.ts +66 -0
  206. package/dist/harness/shared/events/agent-event-map.js +5 -0
  207. package/dist/harness/shared/paths/glob.d.ts +52 -0
  208. package/dist/harness/shared/paths/glob.js +218 -0
  209. package/dist/harness/shared/paths/index.d.ts +84 -0
  210. package/dist/harness/shared/paths/index.js +179 -0
  211. package/dist/index.d.ts +3 -3
  212. package/dist/index.js +2 -2
  213. package/dist/integration/agent-runtime/channel-message-source.js +19 -1
  214. package/dist/integration/index.d.ts +2 -0
  215. package/dist/integration/index.js +1 -0
  216. package/dist/integration/observability/loop-watchdog.d.ts +56 -0
  217. package/dist/integration/observability/loop-watchdog.js +177 -0
  218. package/dist/integration/observability/metrics.d.ts +3 -0
  219. package/dist/integration/observability/metrics.js +18 -7
  220. package/dist/integration/providers/anthropic.d.ts +23 -0
  221. package/dist/integration/providers/anthropic.js +97 -12
  222. package/dist/integration/providers/fetch-timeout.d.ts +42 -0
  223. package/dist/integration/providers/fetch-timeout.js +51 -0
  224. package/dist/integration/providers/openai.d.ts +10 -0
  225. package/dist/integration/providers/openai.js +58 -11
  226. package/dist/integration/providers/provider-diagnostics.d.ts +80 -0
  227. package/dist/integration/providers/provider-diagnostics.js +89 -0
  228. package/dist/integration/providers/timeout-coherence.d.ts +52 -0
  229. package/dist/integration/providers/timeout-coherence.js +68 -0
  230. package/dist/integration/providers/wire-dump.d.ts +62 -0
  231. package/dist/integration/providers/wire-dump.js +111 -2
  232. package/dist/integration/storage/jsonl.js +4 -1
  233. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +4 -2
  234. package/dist/subsystems/cognition-steward/conceptualize/handler.js +12 -20
  235. package/dist/subsystems/memory-steward/backfill/config.yaml +4 -2
  236. package/dist/subsystems/memory-steward/backfill/handler.js +44 -52
  237. package/dist/subsystems/wisdom-steward/attribute/SUBSYSTEM.md +24 -0
  238. package/dist/subsystems/wisdom-steward/attribute/config.yaml +60 -0
  239. package/dist/subsystems/wisdom-steward/attribute/handler.d.ts +23 -0
  240. package/dist/subsystems/wisdom-steward/attribute/handler.js +167 -0
  241. package/dist/subsystems/wisdom-steward/evaluate/handler.js +3 -1
  242. package/dist/subsystems/wisdom-steward/formation/config.yaml +12 -5
  243. package/dist/subsystems/wisdom-steward/formation/handler.js +12 -18
  244. package/dist/subsystems/wisdom-steward/govern/config.yaml +1 -1
  245. package/dist/subsystems/wisdom-steward/govern/handler.js +4 -0
  246. package/package.json +8 -2
@@ -181,36 +181,49 @@ export async function formAndAdmit(llmText, store, options) {
181
181
  }
182
182
  // ── 场景匹配(P0 keyword;embedding/llm 留给后续,不假装已实现) ──
183
183
  /**
184
- * 关键词/字面场景匹配分。
184
+ * 关键词/字面场景匹配分 + 全字面命中标记。
185
185
  *
186
186
  * @param entry - 条目
187
187
  * @param text - 本轮查询/任务文本
188
- * @returns [0,1];无命中为 0
188
+ * @returns score∈[0,1](无命中为 0);fullHit=problemTypes/signals 任一词全字面命中
189
189
  */
190
- export function scenarioMatchScore(entry, text) {
190
+ export function scenarioMatchDetail(entry, text) {
191
191
  const q = text.toLowerCase();
192
192
  if (!q.trim())
193
- return 0;
193
+ return { score: 0, fullHit: false };
194
194
  const anti = (entry.scenario.antiScenarios ?? []).map((s) => s.toLowerCase());
195
195
  if (anti.some((a) => a && q.includes(a)))
196
- return 0;
196
+ return { score: 0, fullHit: false };
197
197
  const types = entry.scenario.problemTypes.map((s) => s.toLowerCase());
198
198
  const signals = (entry.scenario.signals ?? []).map((s) => s.toLowerCase());
199
199
  const words = types.concat(signals);
200
200
  if (words.length === 0)
201
- return 0;
201
+ return { score: 0, fullHit: false };
202
202
  let hit = 0;
203
+ let fullHit = false;
203
204
  for (const w of words) {
204
205
  if (!w)
205
206
  continue;
206
- if (q.includes(w))
207
+ if (q.includes(w)) {
207
208
  hit += 2;
209
+ fullHit = true;
210
+ }
208
211
  else if (overlapChars(q, w))
209
212
  hit += 1;
210
213
  }
211
214
  if (hit === 0)
212
- return 0;
213
- return Math.min(1, hit / (words.length * 2));
215
+ return { score: 0, fullHit: false };
216
+ return { score: Math.min(1, hit / (words.length * 2)), fullHit };
217
+ }
218
+ /**
219
+ * 关键词/字面场景匹配分。
220
+ *
221
+ * @param entry - 条目
222
+ * @param text - 本轮查询/任务文本
223
+ * @returns [0,1];无命中为 0
224
+ */
225
+ export function scenarioMatchScore(entry, text) {
226
+ return scenarioMatchDetail(entry, text).score;
214
227
  }
215
228
  function overlapChars(q, w) {
216
229
  // CJK 友好:词全字面出现在 q 已由 includes 覆盖;此处做 2-gram 弱重叠
@@ -223,18 +236,32 @@ function overlapChars(q, w) {
223
236
  }
224
237
  return false;
225
238
  }
239
+ /**
240
+ * core 桶资格:宽覆盖(多 problemTypes 或 strengthened/factory);
241
+ * trial 永不进 core——未验证的假设只走场景匹配命中,不常驻刷屏。
242
+ *
243
+ * @param entry - 条目(状态已过 usable 过滤或可独立断言)
244
+ * @returns 是否可进 core 桶
245
+ */
246
+ export function isCoreEligible(entry) {
247
+ if (entry.status === 'trial')
248
+ return false;
249
+ return (entry.origin === 'factory' ||
250
+ entry.status === 'strengthened' ||
251
+ entry.scenario.problemTypes.length >= 2);
252
+ }
226
253
  /**
227
254
  * 选择注入集:小核心 + 场景匹配。
228
255
  *
229
256
  * @param entries - 可注入条目(store 已滤状态)
230
257
  * @param text - 本轮文本
231
- * @param options - 条数硬顶
258
+ * @param options - 条数硬顶;includeTrial 缺省 true(trial 的意义就是被试用)
232
259
  * @returns 排序后的注入选择
233
260
  */
234
261
  export function pickForInjection(entries, text, options) {
235
262
  const coreMax = options?.coreMaxItems ?? 8;
236
263
  const scenarioMax = options?.scenarioMaxItems ?? 8;
237
- const includeTrial = options?.includeTrial ?? false;
264
+ const includeTrial = options?.includeTrial ?? true;
238
265
  const usable = entries.filter((e) => {
239
266
  if (e.status === 'retired' || e.status === 'superseded' || e.status === 'candidate')
240
267
  return false;
@@ -244,21 +271,27 @@ export function pickForInjection(entries, text, options) {
244
271
  return false;
245
272
  return true;
246
273
  });
247
- const scored = usable.map((e) => ({
248
- entry: e,
249
- match: scenarioMatchScore(e, text),
250
- score: wisdomInjectScore(e, 1),
251
- scenarioScore: wisdomInjectScore(e, scenarioMatchScore(e, text)),
252
- }));
253
- // core:宽覆盖(多 problemTypes 或 strengthened/factory)优先
274
+ const scored = usable.map((e) => {
275
+ const m = scenarioMatchDetail(e, text);
276
+ return {
277
+ entry: e,
278
+ match: m.score,
279
+ fullHit: m.fullHit,
280
+ score: wisdomInjectScore(e, 1),
281
+ scenarioScore: wisdomInjectScore(e, m.score),
282
+ };
283
+ });
254
284
  const coreCandidates = scored
255
- .filter((s) => s.entry.origin === 'factory' || s.entry.status === 'strengthened' || s.entry.scenario.problemTypes.length >= 2)
285
+ .filter((s) => isCoreEligible(s.entry))
256
286
  .sort((a, b) => b.score - a.score)
257
287
  .slice(0, coreMax)
258
288
  .map((s) => ({ entry: s.entry, bucket: 'core', score: 1 }));
259
289
  const coreIds = new Set(coreCandidates.map((c) => c.entry.id));
290
+ // scenario:trial 须全字面命中(bigram 弱重叠不算数——未验证假设不给模糊入场券)
260
291
  const scenario = scored
261
- .filter((s) => s.match > 0 && !coreIds.has(s.entry.id))
292
+ .filter((s) => s.match > 0 &&
293
+ (s.entry.status !== 'trial' || s.fullHit) &&
294
+ !coreIds.has(s.entry.id))
262
295
  .sort((a, b) => b.scenarioScore - a.scenarioScore)
263
296
  .slice(0, scenarioMax)
264
297
  .map((s) => ({ entry: s.entry, bucket: 'scenario', score: s.match }));
@@ -282,6 +315,7 @@ export function formatWisdomBody(picks) {
282
315
  byType.set(key, list);
283
316
  }
284
317
  const blocks = [];
318
+ blocks.push('> 归因:若某条范式实质影响了你的决策,可在回复中引用其 id(如 [wis_xxx])以便事后验证。');
285
319
  for (const [type, list] of byType) {
286
320
  const lines = list.map((e) => formatWisdomBullet(e));
287
321
  blocks.push(`## 面对「${type}」\n\n${lines.join('\n\n')}`);
@@ -289,7 +323,7 @@ export function formatWisdomBody(picks) {
289
323
  return blocks.join('\n\n');
290
324
  }
291
325
  function formatWisdomBullet(e) {
292
- const parts = [`- ${e.statement}`];
326
+ const parts = [`- [${e.id}] ${e.statement}`];
293
327
  const effectBits = [];
294
328
  if (e.effect.posture)
295
329
  effectBits.push(`推理姿态:${e.effect.posture}`);
@@ -3,10 +3,11 @@
3
3
  *
4
4
  * @module harness/memory/wisdom
5
5
  */
6
- import type { AdmitWisdomInput, AdmitWisdomResult, WisdomEntry, WisdomInjectPick, WisdomInjectQuery, WisdomRetireReason, WisdomStats, WisdomStore, WisdomOutcomeEvent } from './types.js';
6
+ import type { AdmitWisdomInput, AdmitWisdomResult, WisdomAttributionWindow, WisdomAttributionWindowInput, WisdomEntry, WisdomInjectPick, WisdomInjectQuery, WisdomRetireReason, WisdomStats, WisdomStore, WisdomOutcomeEvent } from './types.js';
7
7
  export declare class InMemoryWisdomStore implements WisdomStore {
8
8
  readonly name = "in-memory-wisdom";
9
9
  private entries;
10
+ private windows;
10
11
  private seq;
11
12
  admit(input: AdmitWisdomInput, options?: {
12
13
  allowedMemoryIds?: ReadonlySet<string>;
@@ -21,7 +22,11 @@ export declare class InMemoryWisdomStore implements WisdomStore {
21
22
  by: string;
22
23
  reason: WisdomRetireReason | string;
23
24
  }): Promise<void>;
24
- recordOutcomes(events: WisdomOutcomeEvent[]): Promise<void>;
25
+ recordOutcomes(events: WisdomOutcomeEvent[], config?: import('./wisdom-policy.js').WisdomEvaluationConfig): Promise<void>;
25
26
  touchApplied(ids: string[]): Promise<void>;
27
+ recordAttributionWindow(input: WisdomAttributionWindowInput): Promise<string>;
28
+ listPendingWindows(limit?: number): Promise<WisdomAttributionWindow[]>;
29
+ markWindowsJudged(ids: string[], at?: number): Promise<string[]>;
30
+ pruneWindows(before: number): Promise<void>;
26
31
  stats(): Promise<WisdomStats>;
27
32
  }
@@ -10,6 +10,7 @@ import { pickForInjection } from './wisdom-formation.js';
10
10
  export class InMemoryWisdomStore {
11
11
  name = 'in-memory-wisdom';
12
12
  entries = new Map();
13
+ windows = new Map();
13
14
  seq = 0;
14
15
  async admit(input, options) {
15
16
  const existing = [...this.entries.values()]
@@ -97,7 +98,7 @@ export class InMemoryWisdomStore {
97
98
  exceptions: [...(cur.exceptions ?? []), `retired:${meta.reason}:${meta.by}`],
98
99
  });
99
100
  }
100
- async recordOutcomes(events) {
101
+ async recordOutcomes(events, config) {
101
102
  const byId = new Map();
102
103
  for (const e of events) {
103
104
  const list = byId.get(e.wisdomId) ?? [];
@@ -110,7 +111,7 @@ export class InMemoryWisdomStore {
110
111
  continue;
111
112
  const folded = foldOutcomeEvents(cur, evs);
112
113
  let next = { ...cur, ...folded, updatedAt: Date.now() };
113
- const plan = planConfidenceUpdate(next);
114
+ const plan = planConfidenceUpdate(next, config);
114
115
  if (plan) {
115
116
  next = {
116
117
  ...next,
@@ -151,6 +152,43 @@ export class InMemoryWisdomStore {
151
152
  });
152
153
  }
153
154
  }
155
+ async recordAttributionWindow(input) {
156
+ const id = `waw_${++this.seq}`;
157
+ this.windows.set(id, {
158
+ ...input,
159
+ injectedIds: [...input.injectedIds],
160
+ citations: input.citations.map((c) => ({ ...c })),
161
+ id,
162
+ createdAt: Date.now(),
163
+ });
164
+ return id;
165
+ }
166
+ async listPendingWindows(limit) {
167
+ const pending = [...this.windows.values()]
168
+ .filter((w) => w.judgedAt === undefined)
169
+ .sort((a, b) => a.createdAt - b.createdAt);
170
+ // 缺省上限 500(与 Sqlite 对齐,防 pending 无界增长拖垮判官)
171
+ return pending.slice(0, limit && limit > 0 ? limit : 500);
172
+ }
173
+ async markWindowsJudged(ids, at) {
174
+ const now = at ?? Date.now();
175
+ const newlyJudged = [];
176
+ for (const id of ids) {
177
+ const w = this.windows.get(id);
178
+ // 只有真正置上的才算本次标记(跨进程幂等:他方先标则不发事件)
179
+ if (!w || w.judgedAt !== undefined)
180
+ continue;
181
+ w.judgedAt = now;
182
+ newlyJudged.push(id);
183
+ }
184
+ return newlyJudged;
185
+ }
186
+ async pruneWindows(before) {
187
+ for (const [id, w] of this.windows) {
188
+ if (w.judgedAt !== undefined && w.judgedAt < before)
189
+ this.windows.delete(id);
190
+ }
191
+ }
154
192
  async stats() {
155
193
  const list = [...this.entries.values()];
156
194
  const byStatus = Object.fromEntries(WISDOM_STATUSES.map((s) => [s, 0]));
@@ -50,6 +50,8 @@ const TIMELINE_TYPES = new Set([
50
50
  'engine.start',
51
51
  'engine.end',
52
52
  'engine.error',
53
+ // 模型重试:排查「为什么等了这么久」时,时间线必须能看出重试发生与次数
54
+ 'engine.model_retry',
53
55
  'iteration.start',
54
56
  'turn.end',
55
57
  'tool.exec.start',
@@ -60,6 +62,7 @@ const TIMELINE_TYPES = new Set([
60
62
  'context.compact.start',
61
63
  'context.compact.end',
62
64
  'context.compact.error',
65
+ 'context.compact.summarize_fallback',
63
66
  'context.layers.assembled',
64
67
  'persona.resolve.failed',
65
68
  'injection.detected',
@@ -68,6 +71,10 @@ const TIMELINE_TYPES = new Set([
68
71
  'security.blocked',
69
72
  'security.behavior_blocked',
70
73
  'run.timing',
74
+ // ops P0/P2:jail 意图、降级申报、配置漂移——安全事件必须落 run timeline
75
+ 'ops.jail.state',
76
+ 'ops.policy.degraded',
77
+ 'ops.config.security_changed',
71
78
  ]);
72
79
  let runSeq = 0;
73
80
  /** Hub 兜底:scope 未带 runId 时使用(生产路径应由 Runner/createRunId 提供) */
@@ -525,6 +532,7 @@ export class ObserverHub {
525
532
  const effect = record.toolEffect;
526
533
  effect.cwd = effect.cwd ?? record.scope.toolRuntime?.cwd;
527
534
  effect.isolation = effect.isolation ?? record.scope.toolRuntime?.isolation;
535
+ effect.privileged = effect.privileged ?? record.scope.toolRuntime?.privileged;
528
536
  let row = effect.tools.find((t) => t.name === toolName);
529
537
  if (!row) {
530
538
  row = { name: toolName, calls: 0, errors: 0 };
@@ -29,6 +29,7 @@ export function buildRunScopeView(input) {
29
29
  messagesCount: scope.toolRuntime.messages?.length ?? 0,
30
30
  cwd: scope.toolRuntime.cwd,
31
31
  isolation: scope.toolRuntime.isolation,
32
+ privileged: scope.toolRuntime.privileged,
32
33
  }
33
34
  : undefined,
34
35
  resolvedModel: input.resolvedModel,
@@ -236,6 +236,8 @@ export interface RunToolRuntimeView {
236
236
  messagesCount: number;
237
237
  cwd?: string;
238
238
  isolation?: string;
239
+ /** ops P4:特权部署标记(jail=none / full 档 / root·elevated)——UI 常驻 `PRIVILEGED` */
240
+ privileged?: boolean;
239
241
  }
240
242
  export interface RunScopeView {
241
243
  sessionId: string;
@@ -339,6 +341,8 @@ export interface RunToolEffectView {
339
341
  runId?: string;
340
342
  cwd?: string;
341
343
  isolation?: string;
344
+ /** ops P4:特权部署标记(同 RunToolRuntimeView.privileged) */
345
+ privileged?: boolean;
342
346
  tools: Array<{
343
347
  name: string;
344
348
  calls: number;
@@ -35,6 +35,7 @@ export interface AgentOptions {
35
35
  shouldStopAfterTurn?: AgentLoopConfig['shouldStopAfterTurn'];
36
36
  onTurnComplete?: AgentLoopConfig['onTurnComplete'];
37
37
  prepareNextTurn?: AgentLoopConfig['prepareNextTurn'];
38
+ onToolUpdate?: AgentLoopConfig['onToolUpdate'];
38
39
  onError?: AgentLoopConfig['onError'];
39
40
  getSteeringMessages?: AgentLoopConfig['getSteeringMessages'];
40
41
  getFollowUpMessages?: AgentLoopConfig['getFollowUpMessages'];
@@ -159,6 +160,12 @@ export declare class Agent {
159
160
  context?: AgentContext;
160
161
  /** 本 Run 身份(sessionId/agentId/systemPrompt/toolRuntime) */
161
162
  runScope?: import('../run-scope.js').RunScope;
163
+ /** 本 Run 的 steering/followUp 接续;与实例回调组合,不改共享配置。 */
164
+ consumeMessages?: () => Promise<Message[]>;
165
+ /** 只读运行期提示(如委派状态):只进 steering 接缝,绝不经 followUp 续命。 */
166
+ steeringExtras?: () => Promise<Message[]>;
167
+ /** 本 Run 的工具部分输出通道(tool.exec.update 展示事件的发射端) */
168
+ onToolUpdate?: AgentLoopConfig['onToolUpdate'];
162
169
  /** @deprecated 旧路径:仅绑定 provider */
163
170
  model?: ModelProvider;
164
171
  /** @deprecated 旧路径:仅窗口 */
@@ -41,6 +41,7 @@ export class Agent {
41
41
  transformContext: options.transformContext,
42
42
  beforeToolCall: options.beforeToolCall,
43
43
  afterToolCall: options.afterToolCall,
44
+ onToolUpdate: options.onToolUpdate,
44
45
  shouldStopAfterTurn: options.shouldStopAfterTurn,
45
46
  onTurnComplete: options.onTurnComplete,
46
47
  prepareNextTurn: options.prepareNextTurn,
@@ -202,7 +203,28 @@ export class Agent {
202
203
  }
203
204
  const resolved = options?.resolvedModel;
204
205
  const loopModel = resolved?.provider ?? options?.model;
205
- const config = loopModel ? { ...this._config, model: loopModel } : this._config;
206
+ const config = {
207
+ ...this._config,
208
+ ...(loopModel ? { model: loopModel } : {}),
209
+ ...(options?.onToolUpdate ? { onToolUpdate: options.onToolUpdate } : {}),
210
+ ...(options?.consumeMessages || options?.steeringExtras ? (() => {
211
+ const consume = options.consumeMessages;
212
+ const extras = options.steeringExtras;
213
+ return {
214
+ getSteeringMessages: async () => [
215
+ ...(consume ? await consume() : []),
216
+ ...(extras ? await extras() : []),
217
+ ...(this._config.getSteeringMessages ? await this._config.getSteeringMessages() : []),
218
+ ],
219
+ getFollowUpMessages: async () => [
220
+ // followUp 是「续命」接缝:只喂真实输入;只读提示(ephemeral)
221
+ // 绝不能出现在这里——否则 run 会被状态快照无限续命(评审 F1)
222
+ ...((consume ? await consume() : [])).filter((m) => m.ephemeral !== true),
223
+ ...(this._config.getFollowUpMessages ? await this._config.getFollowUpMessages() : []),
224
+ ],
225
+ };
226
+ })() : {}),
227
+ };
206
228
  const context = options?.context ?? this._context;
207
229
  const runScope = {
208
230
  sessionId: options?.runScope?.sessionId ?? this._contextSessionId,
@@ -1,40 +1,152 @@
1
1
  /**
2
2
  * FallbackProvider — 模型回退提供器
3
3
  *
4
- * 包装多个 ModelProvider,按顺序尝试。
5
- * 主 provider 失败时自动切换到下一个回退 provider。
4
+ * 包装多个 ModelProvider,按顺序尝试。主 provider 失败时自动切换到下一个回退 provider。
6
5
  *
7
6
  * 使用场景:
8
7
  * - 主模型不可用(circuit breaker open、限流、超时)
9
8
  * - 主模型返回错误
10
9
  * - 跨 provider 灾备(如 OpenAI -> Anthropic)
10
+ *
11
+ * ## 单节点首块预算(2026-10-27 修复)
12
+ *
13
+ * 引擎 watchdog(core/loop/call-model.ts)把**整条链**当作一次调用计时,只认内容 chunk。
14
+ * 于是主 provider 若「连上了但长期不产首块」(上游排队 / 长 prefill,期间只发 SSE ping),
15
+ * 会独占整个 watchdog 窗口,备选模型一次机会都拿不到——实测一次 52 分钟停滞即由此而来。
16
+ *
17
+ * 因此链内每个节点各有自己的「等首个内容 chunk」预算(`attemptTtftTimeoutMs`):
18
+ * - 仅在**还有下一个候选**时生效(最后一棒没有备选可切,交给外层 watchdog 兜底)
19
+ * - 超时即 abort 该次尝试(子 AbortController,不波及父 signal),切下一节点
20
+ * - 一旦首个 chunk 产出,本次调用完全委托该节点,预算不再起作用
21
+ * (流中途的静默由外层 idle watchdog 负责,见 stream() 注释)
22
+ *
23
+ * ## 失败节点降级
24
+ *
25
+ * 超时/失败过的节点进入降级窗口(`degradeTtlMs`,缺省等于首块预算),
26
+ * 后续调用把它排到最后。这使「重试」不再是原地重撞同一节点——
27
+ * 这也是条件化重试的落地方式:重试时条件(节点顺序)确实变了。
11
28
  */
12
29
  import type { ModelProvider, LLMRequest, LLMResponse, LLMStreamChunk } from '@octopi-agent/core/interfaces/model-provider.js';
13
30
  import type { ModelInfo } from '@octopi-agent/core/types/agent-definition.js';
14
31
  import type { ModelConfig } from '../../shared/types/agent-definition.js';
32
+ /**
33
+ * 单节点等待首个内容 chunk 的默认预算(毫秒)
34
+ *
35
+ * 依据:同一时段实测备选 provider 处理同体积请求 1–16s;
36
+ * 主 provider 出现 271s / 383s 级首块延迟。90s 足以放过正常抖动,
37
+ * 又不至于让一次用户提问白白等满 watchdog 窗口。
38
+ */
39
+ export declare const DEFAULT_FALLBACK_ATTEMPT_TTFT_MS = 90000;
40
+ /**
41
+ * 单节点非流式(chat)尝试的默认预算(毫秒)
42
+ *
43
+ * chat 没有「首块」概念,预算覆盖的是**整段响应**;复用 90s 的 TTFT 值会把
44
+ * 合法的长响应(推理型模型、长输出)误判为节点故障并降级。
45
+ * 取 240s:低于 undici `bodyTimeout` 的 300s,从而能在被 undici 以
46
+ * 含糊的 `terminated` 掐断之前把控制权交回引擎、切换下一节点。
47
+ */
48
+ export declare const DEFAULT_FALLBACK_CHAT_ATTEMPT_MS = 240000;
49
+ /** 构造选项 */
50
+ export interface FallbackProviderOptions {
51
+ /** 单节点等待首个内容 chunk 的上限(仅 stream);<=0 或未提供时用 DEFAULT_FALLBACK_ATTEMPT_TTFT_MS */
52
+ attemptTtftTimeoutMs?: number;
53
+ /** 单节点非流式整响应的上限(仅 chat);<=0 或未提供时用 DEFAULT_FALLBACK_CHAT_ATTEMPT_MS */
54
+ attemptChatTimeoutMs?: number;
55
+ /** 失败节点降级窗口;缺省等于 attemptTtftTimeoutMs */
56
+ degradeTtlMs?: number;
57
+ /** 时钟注入(测试用) */
58
+ now?: () => number;
59
+ }
15
60
  /**
16
61
  * 回退感知的 ModelProvider
17
62
  *
18
63
  * 尝试主 provider,失败后按 fallbackModels 顺序尝试备选。
19
- * 每次调用独立决策,不持久化状态。
64
+ * 每个节点有独立首块预算,失败节点在降级窗口内被排到最后。
20
65
  */
21
66
  export declare class FallbackProvider implements ModelProvider {
22
67
  readonly name: string;
23
68
  readonly defaultModel?: string;
24
69
  private chain;
25
- constructor(mainProvider: ModelProvider, mainModel: string, fallbackModels: ModelConfig[], providerMap: Map<string, ModelProvider>);
70
+ private readonly attemptTtftTimeoutMs;
71
+ private readonly attemptChatTimeoutMs;
72
+ private readonly degradeTtlMs;
73
+ private readonly now;
74
+ /** 节点下标 → 降级截止时间戳 */
75
+ private readonly degradedUntil;
76
+ constructor(mainProvider: ModelProvider, mainModel: string, fallbackModels: ModelConfig[], providerMap: Map<string, ModelProvider>, options?: FallbackProviderOptions);
77
+ /**
78
+ * 本次调用的尝试顺序:未降级节点保持原相对顺序在前,降级节点在后。
79
+ *
80
+ * @returns 带原下标与「是否仍有下一候选」的尝试序列
81
+ */
82
+ private attemptOrder;
83
+ /** 标记节点失败(进入降级窗口) */
84
+ private markDegraded;
85
+ /** 标记节点恢复(成功一次即解除降级) */
86
+ private markHealthy;
87
+ /**
88
+ * 仅在「节点健康类」错误上降级
89
+ *
90
+ * 401/403(鉴权)、400(上下文超长/请求非法)、billing 等是**请求级**问题,
91
+ * 换节点不会变好;把它们算作节点故障会让主节点被无谓地排后,
92
+ * 并在下一次调用里静默换到别的模型(计费/缓存口径随之错位)。
93
+ *
94
+ * @param index - 节点下标
95
+ * @param err - 该节点的错误
96
+ */
97
+ private degradeIfNodeUnhealthy;
98
+ /**
99
+ * 由备选节点服务时留下一行可检索的提示
100
+ *
101
+ * 换模型对调用方不可见(响应里的 model 由各 provider 自填,用量/计费口径仍在主模型名下),
102
+ * 若不显式记一笔,「为什么这次的回答风格/质量变了」将无从追查。
103
+ *
104
+ * @param entry - 实际服务的节点
105
+ * @param pos - 其在本次尝试顺序中的位置(0 = 主节点)
106
+ */
107
+ private warnIfServedByFallback;
108
+ /**
109
+ * 在预算内等待一个 promise;超时则 reject 预算耗尽标记
110
+ *
111
+ * @param work - 待等待的 promise
112
+ * @param budgetMs - 预算;undefined 表示不限(最后一个候选)
113
+ * @param onTimeout - 预算耗尽时的清理动作(abort 子 signal)
114
+ * @returns work 的结果
115
+ */
116
+ private withBudget;
26
117
  chat(request: LLMRequest): Promise<LLMResponse>;
27
118
  /**
28
119
  * 流式生成回复
29
120
  *
30
- * 尝试主 provider 的 stream(),失败则按 fallbackModels 顺序尝试备选。
121
+ * 每个节点在独立首块预算内等待首个 chunk;超时切下一节点。
31
122
  *
32
123
  * 注意:一旦某个 provider 成功产出第一个 chunk,后续就完全委托给该 provider。
33
124
  * 如果该 provider 在流中途抛异常,错误会直接传递给调用方,不会触发回退。
34
125
  * 这是流式生成的固有限制——已产出的内容无法撤回。
126
+ * 流中途的静默由外层 idle watchdog 负责(它会 abort 父 signal)。
35
127
  */
36
128
  stream(request: LLMRequest): AsyncGenerator<LLMStreamChunk>;
37
129
  isAvailable(): Promise<boolean>;
38
130
  getModelInfo(modelName: string): ModelInfo | null;
39
131
  getModelInfos(): ModelInfo[];
40
132
  }
133
+ /**
134
+ * 「单节点预算耗尽」标记(观测用,与 STREAM_DIAG 同属 Symbol 通道,不影响错误分类)
135
+ *
136
+ * 定义在 harness(产生方);`integration/providers/wire-dump` 作为外层读取它落盘。
137
+ */
138
+ export declare const ATTEMPT_BUDGET_EXHAUSTED_DIAG: unique symbol;
139
+ /**
140
+ * 在错误对象上标记「单节点预算耗尽」
141
+ *
142
+ * @param err - 待标记错误
143
+ * @param budgetMs - 被耗尽的预算
144
+ */
145
+ export declare function attachAttemptBudgetExhausted(err: unknown, budgetMs: number): void;
146
+ /**
147
+ * 读取「单节点预算耗尽」标记
148
+ *
149
+ * @param err - 任意错误
150
+ * @returns 被耗尽的预算毫秒数;未标记时 undefined
151
+ */
152
+ export declare function readAttemptBudgetExhausted(err: unknown): number | undefined;