@octopi-agent/engine 0.65.0 → 0.86.38

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 (421) hide show
  1. package/LICENSE +201 -201
  2. package/NOTICE +7 -7
  3. package/README.md +64 -26
  4. package/dist/config-schema/agent.d.ts +89 -1
  5. package/dist/config-schema/agent.js +69 -0
  6. package/dist/config-schema/context.d.ts +23 -4
  7. package/dist/config-schema/context.js +28 -1
  8. package/dist/config-schema/engine.d.ts +285 -9
  9. package/dist/config-schema/engine.js +35 -3
  10. package/dist/config-schema/governance.d.ts +95 -0
  11. package/dist/config-schema/governance.js +91 -0
  12. package/dist/config-schema/models.d.ts +1 -1
  13. package/dist/config-schema/observability.d.ts +6 -0
  14. package/dist/config-schema/observability.js +16 -0
  15. package/dist/config-schema/run.d.ts +10 -0
  16. package/dist/config-schema/run.js +18 -0
  17. package/dist/config-schema/shared.d.ts +10 -0
  18. package/dist/config-schema/shared.js +10 -0
  19. package/dist/config-schema/substrate.d.ts +87 -1
  20. package/dist/config-schema/substrate.js +114 -0
  21. package/dist/config-schema/subsystems.d.ts +1 -1
  22. package/dist/config-schema/subsystems.js +2 -1
  23. package/dist/config.d.ts +249 -7
  24. package/dist/config.js +113 -3
  25. package/dist/harness/activation/compiler.js +3 -0
  26. package/dist/harness/activation/runtime.d.ts +7 -0
  27. package/dist/harness/activation/runtime.js +60 -2
  28. package/dist/harness/activation/sources/agent-signal.d.ts +11 -0
  29. package/dist/harness/activation/sources/agent-signal.js +33 -0
  30. package/dist/harness/activation/types.d.ts +6 -1
  31. package/dist/harness/agent/builder.d.ts +48 -4
  32. package/dist/harness/agent/builder.js +206 -55
  33. package/dist/harness/agent/config-bridge.d.ts +33 -25
  34. package/dist/harness/agent/config-bridge.js +83 -280
  35. package/dist/harness/agent/index.d.ts +3 -1
  36. package/dist/harness/agent/index.js +2 -1
  37. package/dist/harness/agent/tool-purpose.d.ts +38 -0
  38. package/dist/harness/agent/tool-purpose.js +118 -0
  39. package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
  40. package/dist/harness/agent/wire-agent-builder.js +363 -0
  41. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +4 -1
  42. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +14 -8
  43. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
  44. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
  45. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
  46. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
  47. package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
  48. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
  49. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
  50. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
  51. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
  52. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
  53. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
  54. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
  55. package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
  56. package/dist/harness/collaboration/delegation/child-run.js +241 -0
  57. package/dist/harness/collaboration/delegation/index.d.ts +26 -0
  58. package/dist/harness/collaboration/delegation/index.js +25 -0
  59. package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
  60. package/dist/harness/collaboration/delegation/notifier.js +84 -0
  61. package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
  62. package/dist/harness/collaboration/delegation/registry-types.js +61 -0
  63. package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
  64. package/dist/harness/collaboration/delegation/registry.js +220 -0
  65. package/dist/harness/collaboration/delegation/service.d.ts +249 -0
  66. package/dist/harness/collaboration/delegation/service.js +499 -0
  67. package/dist/harness/collaboration/delegation/store.d.ts +155 -0
  68. package/dist/harness/collaboration/delegation/store.js +271 -0
  69. package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
  70. package/dist/harness/collaboration/delegation/transport.js +61 -0
  71. package/dist/harness/collaboration/delegation/types.d.ts +231 -0
  72. package/dist/harness/collaboration/delegation/types.js +70 -0
  73. package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
  74. package/dist/harness/collaboration/delegation/wiring.js +145 -0
  75. package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
  76. package/dist/harness/collaboration/orchestration/index.js +11 -11
  77. package/dist/harness/context/assembler.d.ts +2 -2
  78. package/dist/harness/context/assembler.js +12 -7
  79. package/dist/harness/context/capabilities/compact/engine.js +80 -38
  80. package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
  81. package/dist/harness/context/capabilities/summary/gate.js +2 -2
  82. package/dist/harness/context/capabilities/summary/policies.js +5 -5
  83. package/dist/harness/context/capabilities/summary/registry.js +39 -24
  84. package/dist/harness/context/constitution/default-agents.md +230 -228
  85. package/dist/harness/context/default-context-engine.d.ts +101 -23
  86. package/dist/harness/context/default-context-engine.js +483 -172
  87. package/dist/harness/context/hybrid-compressor.d.ts +3 -3
  88. package/dist/harness/context/hybrid-compressor.js +18 -23
  89. package/dist/harness/context/index.d.ts +5 -1
  90. package/dist/harness/context/index.js +2 -0
  91. package/dist/harness/context/layer-health.js +3 -2
  92. package/dist/harness/context/layer-snapshot.d.ts +4 -0
  93. package/dist/harness/context/layer-snapshot.js +30 -18
  94. package/dist/harness/context/layer-types.d.ts +49 -1
  95. package/dist/harness/context/layer-types.js +72 -4
  96. package/dist/harness/context/layers.d.ts +32 -15
  97. package/dist/harness/context/layers.js +87 -71
  98. package/dist/harness/context/llm-summarizer.d.ts +15 -1
  99. package/dist/harness/context/llm-summarizer.js +107 -56
  100. package/dist/harness/context/message-selector.js +6 -2
  101. package/dist/harness/context/root-instructions.d.ts +72 -0
  102. package/dist/harness/context/root-instructions.js +227 -0
  103. package/dist/harness/context/runtime-datetime.d.ts +34 -7
  104. package/dist/harness/context/runtime-datetime.js +66 -10
  105. package/dist/harness/context/smart-router.d.ts +1 -1
  106. package/dist/harness/context/smart-router.js +1 -1
  107. package/dist/harness/context/system-prompt-assembler.d.ts +33 -0
  108. package/dist/harness/context/system-prompt-assembler.js +78 -7
  109. package/dist/harness/context/token-constants.d.ts +2 -2
  110. package/dist/harness/context/token-constants.js +2 -2
  111. package/dist/harness/context/token-estimate-fns.d.ts +1 -3
  112. package/dist/harness/context/token-estimate-fns.js +2 -4
  113. package/dist/harness/context/token-estimator.d.ts +1 -1
  114. package/dist/harness/context/token-estimator.js +14 -6
  115. package/dist/harness/context/tool-result-aging.d.ts +140 -0
  116. package/dist/harness/context/tool-result-aging.js +331 -0
  117. package/dist/harness/context/tool-result-body.d.ts +10 -0
  118. package/dist/harness/context/tool-result-body.js +27 -0
  119. package/dist/harness/context/turn-envelope.d.ts +123 -0
  120. package/dist/harness/context/turn-envelope.js +188 -0
  121. package/dist/harness/context/types.d.ts +35 -47
  122. package/dist/harness/extension/execution-environment/effect-policy.d.ts +248 -0
  123. package/dist/harness/extension/execution-environment/effect-policy.js +334 -0
  124. package/dist/harness/extension/execution-environment/index.d.ts +18 -2
  125. package/dist/harness/extension/execution-environment/index.js +11 -2
  126. package/dist/harness/extension/execution-environment/memory-undo.d.ts +101 -0
  127. package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
  128. package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
  129. package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
  130. package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
  131. package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
  132. package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
  133. package/dist/harness/extension/execution-environment/sandbox.js +493 -51
  134. package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
  135. package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
  136. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
  137. package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
  138. package/dist/harness/extension/execution-environment/types.d.ts +67 -39
  139. package/dist/harness/extension/execution-environment/types.js +2 -2
  140. package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
  141. package/dist/harness/extension/execution-environment/undo-log.js +627 -0
  142. package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
  143. package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
  144. package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +4 -0
  145. package/dist/harness/extension/plugin-ecosystem/client-tools/index.js +3 -0
  146. package/dist/harness/extension/plugin-ecosystem/client-tools/invoke.d.ts +56 -0
  147. package/dist/harness/extension/plugin-ecosystem/client-tools/invoke.js +281 -0
  148. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +98 -0
  149. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +250 -0
  150. package/dist/harness/extension/plugin-ecosystem/client-tools/stream.d.ts +124 -0
  151. package/dist/harness/extension/plugin-ecosystem/client-tools/stream.js +372 -0
  152. package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +118 -0
  153. package/dist/harness/extension/plugin-ecosystem/client-tools/types.js +8 -0
  154. package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
  155. package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
  156. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
  157. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
  158. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
  159. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
  160. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
  161. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
  162. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
  163. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
  164. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
  165. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
  166. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
  167. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
  168. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
  169. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
  170. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
  171. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
  172. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
  173. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +45 -0
  174. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +136 -0
  175. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
  176. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
  177. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +278 -82
  178. package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
  179. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
  180. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
  181. package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
  182. package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
  183. package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
  184. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
  185. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
  186. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
  187. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
  188. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +239 -61
  189. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
  190. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +554 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
  192. package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
  193. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +2 -0
  194. package/dist/harness/extension/plugin-ecosystem/tools/index.js +2 -0
  195. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
  196. package/dist/harness/extension/plugin-ecosystem/tools/memory.d.ts +11 -1
  197. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +39 -1
  198. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
  199. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
  200. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
  201. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
  202. package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
  203. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
  204. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
  205. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
  206. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
  207. package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
  208. package/dist/harness/governance/credentials/index.d.ts +1 -1
  209. package/dist/harness/governance/credentials/store.d.ts +16 -4
  210. package/dist/harness/governance/credentials/store.js +33 -6
  211. package/dist/harness/governance/credentials/types.d.ts +11 -0
  212. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
  213. package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
  214. package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
  215. package/dist/harness/governance/human-in-the-loop/index.js +3 -3
  216. package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
  217. package/dist/harness/governance/human-in-the-loop/types.js +6 -2
  218. package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
  219. package/dist/harness/governance/security/capability-enforcer.js +31 -8
  220. package/dist/harness/governance/security/degradation.js +5 -7
  221. package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
  222. package/dist/harness/governance/security/risk-evaluator.js +4 -82
  223. package/dist/harness/governance/security/temp-path.d.ts +41 -0
  224. package/dist/harness/governance/security/temp-path.js +117 -0
  225. package/dist/harness/governance/session-acl/index.d.ts +1 -0
  226. package/dist/harness/governance/session-acl/index.js +1 -0
  227. package/dist/harness/governance/session-acl/rights.d.ts +12 -0
  228. package/dist/harness/governance/session-acl/rights.js +89 -7
  229. package/dist/harness/governance/session-acl/seed-roles.js +9 -1
  230. package/dist/harness/governance/session-acl/service.js +21 -29
  231. package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
  232. package/dist/harness/governance/session-acl/tool-rights.js +238 -0
  233. package/dist/harness/governance/session-acl/types.d.ts +22 -0
  234. package/dist/harness/index.d.ts +18 -15
  235. package/dist/harness/index.js +11 -7
  236. package/dist/harness/knowledge/file-index-store.js +11 -11
  237. package/dist/harness/knowledge/grounding.d.ts +2 -1
  238. package/dist/harness/knowledge/grounding.js +6 -3
  239. package/dist/harness/knowledge/index.d.ts +2 -2
  240. package/dist/harness/knowledge/index.js +1 -1
  241. package/dist/harness/knowledge/ingest.js +4 -1
  242. package/dist/harness/knowledge/job-control-state.js +4 -4
  243. package/dist/harness/knowledge/job-control.js +11 -11
  244. package/dist/harness/knowledge/membership-store.js +11 -11
  245. package/dist/harness/knowledge/network-guard.d.ts +61 -4
  246. package/dist/harness/knowledge/network-guard.js +390 -113
  247. package/dist/harness/knowledge/query-service.js +8 -8
  248. package/dist/harness/knowledge/retriever.js +1 -1
  249. package/dist/harness/knowledge/source-store.d.ts +17 -2
  250. package/dist/harness/knowledge/source-store.js +6 -5
  251. package/dist/harness/knowledge/writer-service.d.ts +2 -0
  252. package/dist/harness/knowledge/writer-service.js +14 -13
  253. package/dist/harness/memory/backfill-trigger.d.ts +2 -2
  254. package/dist/harness/memory/backfill-trigger.js +4 -4
  255. package/dist/harness/memory/cognition-decay.d.ts +36 -0
  256. package/dist/harness/memory/cognition-decay.js +55 -0
  257. package/dist/harness/memory/cognition-gates.d.ts +60 -0
  258. package/dist/harness/memory/cognition-gates.js +191 -0
  259. package/dist/harness/memory/cognition-trigger.d.ts +30 -0
  260. package/dist/harness/memory/cognition-trigger.js +41 -0
  261. package/dist/harness/memory/cognition-types.d.ts +1 -1
  262. package/dist/harness/memory/cognition.d.ts +40 -8
  263. package/dist/harness/memory/cognition.js +432 -79
  264. package/dist/harness/memory/conceptualizer.d.ts +66 -0
  265. package/dist/harness/memory/conceptualizer.js +246 -0
  266. package/dist/harness/memory/index.d.ts +17 -2
  267. package/dist/harness/memory/index.js +12 -1
  268. package/dist/harness/memory/sqlite/agent-db.d.ts +9 -0
  269. package/dist/harness/memory/sqlite/agent-db.js +120 -15
  270. package/dist/harness/memory/sqlite/cognition-store.d.ts +55 -16
  271. package/dist/harness/memory/sqlite/cognition-store.js +591 -144
  272. package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
  273. package/dist/harness/memory/sqlite/memory-store.js +14 -4
  274. package/dist/harness/memory/sqlite/wisdom-store.d.ts +33 -14
  275. package/dist/harness/memory/sqlite/wisdom-store.js +257 -44
  276. package/dist/harness/memory/store.d.ts +1 -0
  277. package/dist/harness/memory/store.js +3 -0
  278. package/dist/harness/memory/time-format.d.ts +28 -0
  279. package/dist/harness/memory/time-format.js +52 -0
  280. package/dist/harness/memory/types.d.ts +343 -16
  281. package/dist/harness/memory/types.js +49 -0
  282. package/dist/harness/memory/wisdom-formation.d.ts +101 -0
  283. package/dist/harness/memory/wisdom-formation.js +304 -0
  284. package/dist/harness/memory/wisdom-gates.d.ts +50 -0
  285. package/dist/harness/memory/wisdom-gates.js +204 -0
  286. package/dist/harness/memory/wisdom-policy.d.ts +107 -0
  287. package/dist/harness/memory/wisdom-policy.js +220 -0
  288. package/dist/harness/memory/wisdom-types.d.ts +3 -2
  289. package/dist/harness/memory/wisdom-types.js +2 -2
  290. package/dist/harness/memory/wisdom.d.ts +27 -0
  291. package/dist/harness/memory/wisdom.js +181 -0
  292. package/dist/harness/observability/observer/hub.js +23 -1
  293. package/dist/harness/observability/observer/index.d.ts +2 -2
  294. package/dist/harness/observability/observer/index.js +1 -1
  295. package/dist/harness/observability/observer/types.d.ts +57 -0
  296. package/dist/harness/observability/observer/types.js +118 -9
  297. package/dist/harness/run/agent/agent.d.ts +27 -0
  298. package/dist/harness/run/agent/agent.js +45 -0
  299. package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
  300. package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
  301. package/dist/harness/run/reliability/harness-events.d.ts +4 -0
  302. package/dist/harness/run/reliability/run-agent.js +116 -20
  303. package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
  304. package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
  305. package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
  306. package/dist/harness/run/run-guard/default-run-guard.js +104 -44
  307. package/dist/harness/run/run-scope.d.ts +52 -0
  308. package/dist/harness/run/runner.d.ts +101 -16
  309. package/dist/harness/run/runner.js +557 -158
  310. package/dist/harness/session/attachments/llm-intent.js +17 -17
  311. package/dist/harness/session/history/port.js +1 -0
  312. package/dist/harness/session/in-memory-store.d.ts +1 -0
  313. package/dist/harness/session/in-memory-store.js +22 -1
  314. package/dist/harness/session/index.d.ts +1 -0
  315. package/dist/harness/session/index.js +1 -0
  316. package/dist/harness/session/schedules/index.d.ts +10 -0
  317. package/dist/harness/session/schedules/index.js +10 -0
  318. package/dist/harness/session/schedules/render.d.ts +13 -0
  319. package/dist/harness/session/schedules/render.js +63 -0
  320. package/dist/harness/session/schedules/service.d.ts +179 -0
  321. package/dist/harness/session/schedules/service.js +695 -0
  322. package/dist/harness/session/schedules/store.d.ts +119 -0
  323. package/dist/harness/session/schedules/store.js +323 -0
  324. package/dist/harness/session/schedules/tools.d.ts +39 -0
  325. package/dist/harness/session/schedules/tools.js +442 -0
  326. package/dist/harness/session/schedules/types.d.ts +104 -0
  327. package/dist/harness/session/schedules/types.js +97 -0
  328. package/dist/harness/session/tasks/tools.js +22 -0
  329. package/dist/harness/session/title.d.ts +86 -0
  330. package/dist/harness/session/title.js +268 -0
  331. package/dist/harness/session/types.d.ts +35 -0
  332. package/dist/harness/shared/events/agent-event-map.d.ts +21 -0
  333. package/dist/harness/shared/events/agent-event-map.js +1 -0
  334. package/dist/harness/shared/types/agent-definition.d.ts +23 -0
  335. package/dist/index.d.ts +25 -9
  336. package/dist/index.js +11 -2
  337. package/dist/integration/providers/anthropic.d.ts +10 -0
  338. package/dist/integration/providers/anthropic.js +44 -1
  339. package/dist/integration/providers/openai.d.ts +10 -0
  340. package/dist/integration/providers/openai.js +58 -2
  341. package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
  342. package/dist/integration/providers/wire-dump-diff.js +351 -0
  343. package/dist/integration/providers/wire-dump.d.ts +178 -0
  344. package/dist/integration/providers/wire-dump.js +396 -0
  345. package/dist/integration/storage/jsonl.d.ts +11 -0
  346. package/dist/integration/storage/jsonl.js +148 -39
  347. package/dist/integration/storage/session-index.js +63 -8
  348. package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -0
  349. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -0
  350. package/dist/subsystems/cognition-steward/conceptualize/handler.d.ts +9 -0
  351. package/dist/subsystems/cognition-steward/conceptualize/handler.js +125 -0
  352. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -0
  353. package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -0
  354. package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +12 -0
  355. package/dist/subsystems/cognition-steward/consolidate/handler.js +93 -0
  356. package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
  357. package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -0
  358. package/dist/subsystems/wisdom-steward/evaluate/handler.d.ts +18 -0
  359. package/dist/subsystems/wisdom-steward/evaluate/handler.js +91 -0
  360. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -0
  361. package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -0
  362. package/dist/subsystems/wisdom-steward/formation/handler.d.ts +18 -0
  363. package/dist/subsystems/wisdom-steward/formation/handler.js +212 -0
  364. package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -0
  365. package/dist/subsystems/wisdom-steward/govern/handler.d.ts +17 -0
  366. package/dist/subsystems/wisdom-steward/govern/handler.js +68 -0
  367. package/package.json +115 -115
  368. package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
  369. package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
  370. package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
  371. package/dist/harness/collaboration/multi-agent/index.js +0 -15
  372. package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
  373. package/dist/harness/collaboration/multi-agent/process.js +0 -256
  374. package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
  375. package/dist/harness/collaboration/multi-agent/registry.js +0 -137
  376. package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
  377. package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
  378. package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
  379. package/dist/harness/collaboration/multi-agent/types.js +0 -15
  380. package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
  381. package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
  382. package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
  383. package/dist/harness/collaboration/orchestration/async-task.js +0 -359
  384. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
  385. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
  386. package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
  387. package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
  388. package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
  389. package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
  390. package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
  391. package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
  392. package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
  393. package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
  394. package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
  395. package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
  396. package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
  397. package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
  398. package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
  399. package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
  400. package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
  401. package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
  402. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
  403. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
  404. package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
  405. package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
  406. package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
  407. package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
  408. package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
  409. package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
  410. package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
  411. package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
  412. package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
  413. package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
  414. package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
  415. package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
  416. package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
  417. package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
  418. package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
  419. package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
  420. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
  421. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.js +0 -0
@@ -21,7 +21,13 @@ export declare class RunMetricsCollector {
21
21
  private nominalTotalTokens;
22
22
  private lastToolName;
23
23
  private consecutiveSameTool;
24
+ /** 上一次调用的「名+参数+结果」指纹;用于识别真正无进展的重复 */
25
+ private lastCallFingerprint;
26
+ private consecutiveIdenticalCalls;
24
27
  private consecutiveErrors;
28
+ /** 上一次失败调用的「名+参数+错误」指纹;用于识别同一错误反复重试 */
29
+ private lastFailureFingerprint;
30
+ private consecutiveIdenticalFailures;
25
31
  private uniqueTools;
26
32
  private recentToolCalls;
27
33
  private turnSummaries;
@@ -35,8 +41,26 @@ export declare class RunMetricsCollector {
35
41
  recordTurn(summary: TurnSummary): void;
36
42
  /** 记录本轮 token 消耗(与 Budget 共用 turn_end.usage) */
37
43
  recordTokens(delta: number): void;
38
- /** 记录工具结果 */
39
- recordToolResult(name: string, success: boolean, isNoop?: boolean): void;
44
+ /**
45
+ * 记录工具结果
46
+ *
47
+ * 两套计数刻意分开:
48
+ * - `consecutiveSameTool`:只看工具名(弱信号,仅观测)
49
+ * - `consecutiveIdenticalCalls`:名 + 参数 + 结果三者一致(无进展的强信号)
50
+ *
51
+ * 编码类 run 会连续调用同一工具但参数各不相同(改一行→跑一次 typecheck),
52
+ * 只看工具名会把它误判成死循环。
53
+ *
54
+ * @param name - 工具名
55
+ * @param success - 是否成功
56
+ * @param isNoop - 是否 no-op(无实际改动)
57
+ * @param trace - 本次调用的参数与结果(用于指纹;缺省则不计入相同调用)
58
+ */
59
+ recordToolResult(name: string, success: boolean, isNoop?: boolean, trace?: {
60
+ args?: unknown;
61
+ result?: unknown;
62
+ error?: unknown;
63
+ }): void;
40
64
  /** 本轮是否实质进展(Budget 续租 + Guard 规则共用) */
41
65
  hasProgress(): boolean;
42
66
  recordRecovery(attempt: RecoveryAttempt): void;
@@ -67,7 +91,9 @@ export declare class RunMetricsCollector {
67
91
  nominalTotalTokens: number;
68
92
  elapsedMs: number;
69
93
  consecutiveErrors: number;
94
+ consecutiveIdenticalFailures: number;
70
95
  consecutiveSameTool: number;
96
+ consecutiveIdenticalCalls: number;
71
97
  noopStreak: number;
72
98
  hasProgress: boolean;
73
99
  uniqueTools: string[];
@@ -4,6 +4,36 @@
4
4
  * 归属 reliability(实现);Guard 只依赖 Core 的 CheckpointContext 类型。
5
5
  * 禁止:reliability → run-guard 实现包。
6
6
  */
7
+ import { hashToolCall, hashToolOutcome } from '../concurrency/tool-loop-detection-core.js';
8
+ /**
9
+ * 指纹前剥掉「每次必然不同」的元数据字段
10
+ *
11
+ * `shell` 的结果对象带 `durationMs`、`rawStdoutLength`、`isolation`(含随机沙箱 profile
12
+ * 路径与临时目录名)——它们让同一条命令的两次调用结果永远不相等,指纹判据会整体失效。
13
+ * 只用于「无进展重复」判据,不改动工具返回值本身,也不影响既有 loop 检测器的语义。
14
+ */
15
+ const VOLATILE_OUTCOME_KEYS = new Set([
16
+ 'durationMs',
17
+ 'elapsedMs',
18
+ 'rawStdoutLength',
19
+ 'rawLength',
20
+ 'isolation',
21
+ 'terminated',
22
+ 'terminateReason',
23
+ ]);
24
+ function stripVolatileOutcome(value, depth = 0) {
25
+ if (depth > 6 || value === null || typeof value !== 'object')
26
+ return value;
27
+ if (Array.isArray(value))
28
+ return value.map((v) => stripVolatileOutcome(v, depth + 1));
29
+ const out = {};
30
+ for (const [k, v] of Object.entries(value)) {
31
+ if (VOLATILE_OUTCOME_KEYS.has(k))
32
+ continue;
33
+ out[k] = stripVolatileOutcome(v, depth + 1);
34
+ }
35
+ return out;
36
+ }
7
37
  const SUMMARIES_MAX = 8;
8
38
  const RECENT_TOOLS_MAX = 10;
9
39
  const TOKEN_WINDOW = 10;
@@ -14,7 +44,13 @@ export class RunMetricsCollector {
14
44
  nominalTotalTokens = 0;
15
45
  lastToolName = '';
16
46
  consecutiveSameTool = 0;
47
+ /** 上一次调用的「名+参数+结果」指纹;用于识别真正无进展的重复 */
48
+ lastCallFingerprint = '';
49
+ consecutiveIdenticalCalls = 0;
17
50
  consecutiveErrors = 0;
51
+ /** 上一次失败调用的「名+参数+错误」指纹;用于识别同一错误反复重试 */
52
+ lastFailureFingerprint = '';
53
+ consecutiveIdenticalFailures = 0;
18
54
  uniqueTools = new Set();
19
55
  recentToolCalls = [];
20
56
  turnSummaries = [];
@@ -47,8 +83,22 @@ export class RunMetricsCollector {
47
83
  if (last)
48
84
  last.tokenDelta += delta;
49
85
  }
50
- /** 记录工具结果 */
51
- recordToolResult(name, success, isNoop = false) {
86
+ /**
87
+ * 记录工具结果
88
+ *
89
+ * 两套计数刻意分开:
90
+ * - `consecutiveSameTool`:只看工具名(弱信号,仅观测)
91
+ * - `consecutiveIdenticalCalls`:名 + 参数 + 结果三者一致(无进展的强信号)
92
+ *
93
+ * 编码类 run 会连续调用同一工具但参数各不相同(改一行→跑一次 typecheck),
94
+ * 只看工具名会把它误判成死循环。
95
+ *
96
+ * @param name - 工具名
97
+ * @param success - 是否成功
98
+ * @param isNoop - 是否 no-op(无实际改动)
99
+ * @param trace - 本次调用的参数与结果(用于指纹;缺省则不计入相同调用)
100
+ */
101
+ recordToolResult(name, success, isNoop = false, trace) {
52
102
  this.totalToolCalls++;
53
103
  if (name === this.lastToolName) {
54
104
  this.consecutiveSameTool++;
@@ -57,12 +107,31 @@ export class RunMetricsCollector {
57
107
  this.consecutiveSameTool = 1;
58
108
  this.lastToolName = name;
59
109
  }
110
+ if (trace) {
111
+ const fingerprint = [
112
+ hashToolCall(name, trace.args),
113
+ hashToolOutcome(name, trace.args, stripVolatileOutcome(trace.result), trace.error) ?? '',
114
+ ].join('|');
115
+ if (fingerprint === this.lastCallFingerprint) {
116
+ this.consecutiveIdenticalCalls++;
117
+ }
118
+ else {
119
+ this.consecutiveIdenticalCalls = 1;
120
+ this.lastCallFingerprint = fingerprint;
121
+ }
122
+ }
123
+ else {
124
+ this.consecutiveIdenticalCalls = 0;
125
+ this.lastCallFingerprint = '';
126
+ }
60
127
  this.uniqueTools.add(name);
61
128
  this.recentToolCalls.push({ name, success });
62
129
  if (this.recentToolCalls.length > RECENT_TOOLS_MAX)
63
130
  this.recentToolCalls.shift();
64
131
  if (success) {
65
132
  this.consecutiveErrors = 0;
133
+ this.consecutiveIdenticalFailures = 0;
134
+ this.lastFailureFingerprint = '';
66
135
  if (!isNoop) {
67
136
  this.lastSuccessAt = this.globalIteration;
68
137
  this.noopStreak = 0;
@@ -70,6 +139,22 @@ export class RunMetricsCollector {
70
139
  }
71
140
  else {
72
141
  this.consecutiveErrors++;
142
+ // 错误是否「重复」:同工具 + 同参数 + 同错误内容。
143
+ // 连续失败但每次错误不同(跑测试 A 红 → 修 → 跑测试 B 红)属于探索,
144
+ // 不是卡住;只有同一错误反复出现才说明重试没有换方法。
145
+ const failureFingerprint = trace
146
+ ? [
147
+ hashToolCall(name, trace.args),
148
+ hashToolOutcome(name, trace.args, undefined, stripVolatileOutcome(trace.error)) ?? '',
149
+ ].join('|')
150
+ : '';
151
+ if (failureFingerprint && failureFingerprint === this.lastFailureFingerprint) {
152
+ this.consecutiveIdenticalFailures++;
153
+ }
154
+ else {
155
+ this.consecutiveIdenticalFailures = failureFingerprint ? 1 : 0;
156
+ this.lastFailureFingerprint = failureFingerprint;
157
+ }
73
158
  }
74
159
  if (isNoop)
75
160
  this.noopStreak++;
@@ -144,9 +229,12 @@ export class RunMetricsCollector {
144
229
  }
145
230
  const metrics = {
146
231
  consecutiveErrors: this.consecutiveErrors,
232
+ consecutiveIdenticalFailures: this.consecutiveIdenticalFailures,
147
233
  consecutiveSameTool: this.consecutiveSameTool,
234
+ consecutiveIdenticalCalls: this.consecutiveIdenticalCalls,
148
235
  tokenGrowthRate,
149
236
  toolFailureRate,
237
+ toolCallsInWindow: this.recentToolCalls.length,
150
238
  uniqueToolsUsed: this.uniqueTools.size,
151
239
  hasProgress: this.hasProgress(),
152
240
  noopStreak: this.noopStreak,
@@ -183,7 +271,9 @@ export class RunMetricsCollector {
183
271
  nominalTotalTokens: this.nominalTotalTokens,
184
272
  elapsedMs: Date.now() - this.startTime,
185
273
  consecutiveErrors: this.consecutiveErrors,
274
+ consecutiveIdenticalFailures: this.consecutiveIdenticalFailures,
186
275
  consecutiveSameTool: this.consecutiveSameTool,
276
+ consecutiveIdenticalCalls: this.consecutiveIdenticalCalls,
187
277
  noopStreak: this.noopStreak,
188
278
  hasProgress: this.hasProgress(),
189
279
  uniqueTools: [...this.uniqueTools],
@@ -46,11 +46,6 @@ export interface RunGuardConfig {
46
46
  /** 每次检查点的回调(可用于日志、监控、用户通知) */
47
47
  onCheckpoint?: (ctx: CheckpointContext, verdict: CheckpointVerdict) => void;
48
48
  }
49
- /**
50
- * DefaultRunGuard
51
- *
52
- * 两层智能监督:规则检测 + LLM 审查
53
- */
54
49
  export declare class DefaultRunGuard implements RunGuard {
55
50
  private config;
56
51
  private model?;
@@ -30,6 +30,19 @@ const DEFAULT_CONFIG = {
30
30
  *
31
31
  * 两层智能监督:规则检测 + LLM 审查
32
32
  */
33
+ /** 指标生产者未提供 consecutiveIdenticalCalls 时只告警一次(防日志刷屏) */
34
+ let warnedMissingIdenticalMetric = false;
35
+ /** 指标生产者未提供 toolCallsInWindow 时只告警一次 */
36
+ let warnedMissingWindowMetric = false;
37
+ /** 指标生产者未提供 consecutiveIdenticalFailures 时只告警一次 */
38
+ let warnedMissingFailureMetric = false;
39
+ /**
40
+ * 连续工具失败兜底阈值(错误内容各不相同时)
41
+ *
42
+ * 取高位:正常调试节奏是「跑测试红 → 改 → 再跑」,3~5 次连续失败很常见;
43
+ * 8 次连续失败且一次都没成功,更像是工具/环境整体不可用,而不是在探索。
44
+ */
45
+ const ERROR_STREAK_SAFETY = 8;
33
46
  export class DefaultRunGuard {
34
47
  config;
35
48
  model;
@@ -183,78 +196,125 @@ export class DefaultRunGuard {
183
196
  ],
184
197
  });
185
198
  }
186
- // 规则 1: 重复工具循环
187
- if (m.consecutiveSameTool >= 5) {
199
+ // 规则 1: 无进展重复调用
200
+ //
201
+ // 判据只能是「工具名 + 参数 + 结果」三者一致(consecutiveIdenticalCalls):
202
+ // 编码类 run 会连续多次调用 shell / file_edit,但每次参数不同(改一行→跑一次
203
+ // typecheck→再改),这属于正常推进。只看工具名的旧判据会把它误判为死循环,
204
+ // 连续 3 次 recover 后升级为 stop,把正常任务静默掐断。
205
+ //
206
+ // 纯「同名不同参」不再产生规则结果:裁决只消费 high/medium(见 checkpoint),
207
+ // 造一条 low 规则是死代码。需要观测时看 run_guard_metrics 的 consecutiveSameTool。
208
+ const identicalCalls = m.consecutiveIdenticalCalls;
209
+ if (identicalCalls === undefined && !warnedMissingIdenticalMetric) {
210
+ // 指标生产者未升级时判据会静默空转;宁可漏报也不能退回「同名即循环」的误杀。
211
+ warnedMissingIdenticalMetric = true;
212
+ console.warn('[RunGuard] CheckpointMetrics.consecutiveIdenticalCalls 缺失,repeated_identical_call 判据暂不生效');
213
+ }
214
+ if ((identicalCalls ?? 0) >= 5) {
188
215
  results.push({
189
216
  triggered: true,
190
217
  severity: 'high',
191
- rule: 'repeated_tool',
192
- description: `连续 ${m.consecutiveSameTool} 次调用同一工具,疑似陷入循环`,
218
+ rule: 'repeated_identical_call',
219
+ description: `连续 ${identicalCalls} 次相同调用(同一工具、同一参数、同一结果),无进展`,
193
220
  failureKind: 'loop',
194
- suggestedRecovery: [{ type: 'inject_hint', hint: '你似乎在同一工具上反复调用。请分析当前状态,尝试不同的方法或向用户报告遇到的问题。' }],
221
+ suggestedRecovery: [{ type: 'inject_hint', hint: '你的调用参数与结果都没有变化,说明这个方法无法推进。请改变做法,或向用户报告当前阻塞点。' }],
195
222
  });
196
223
  }
197
- else if (m.consecutiveSameTool >= 3) {
198
- results.push({
199
- triggered: true,
200
- severity: 'medium',
201
- rule: 'repeated_tool',
202
- description: `连续 ${m.consecutiveSameTool} 次调用同一工具`,
203
- failureKind: 'loop',
204
- });
224
+ // 规则 2: 错误循环 —— 判「错误是否重复」,不是「失败了几次」
225
+ //
226
+ // 旧判据 `consecutiveErrors >= 3` 只看连续失败次数:跑测试 A 红 → 改 → 跑测试 B 红
227
+ // → 改 → 跑测试 C 红,三次失败但每次错误都不同,这是正常调试节奏(红-改-绿循环),
228
+ // 却被判 high/blowup → recover,同 kind 连续 3 次后升级 stop。
229
+ //
230
+ // 「卡住」的真实特征是**同一个错误反复出现**:同一工具、同一参数、同一错误内容,
231
+ // 说明重试没有换方法。故判据改为 consecutiveIdenticalFailures。
232
+ //
233
+ // 保留一条兜底:完全不同错误也可能整体失败(例如工具被全局配置坏掉),
234
+ // 用较高的阈值兜住,普通调试节奏(3 个红测试)远达不到。
235
+ const identicalFailures = m.consecutiveIdenticalFailures;
236
+ if (identicalFailures === undefined && !warnedMissingFailureMetric) {
237
+ warnedMissingFailureMetric = true;
238
+ console.warn('[RunGuard] CheckpointMetrics.consecutiveIdenticalFailures 缺失,error_loop 判据退化为连续失败兜底');
205
239
  }
206
- // 规则 2: 错误循环
207
- if (m.consecutiveErrors >= 3) {
240
+ if ((identicalFailures ?? 0) >= 3) {
208
241
  results.push({
209
242
  triggered: true,
210
243
  severity: 'high',
211
244
  rule: 'error_loop',
212
- description: `连续 ${m.consecutiveErrors} 次错误,可能遇到了无法解决的问题`,
245
+ description: `同一错误连续 ${identicalFailures} 次(工具、参数、错误内容均未变化),重试没有换方法`,
213
246
  failureKind: 'blowup',
214
- suggestedRecovery: [{ type: 'inject_hint', hint: '你已连续遇到多次错误。请停下来分析错误原因,考虑换一种方法,或向用户报告当前遇到的困难。' }],
247
+ suggestedRecovery: [{ type: 'inject_hint', hint: '你正在用同样的方式重试同一个失败。请改变做法:读完整错误信息、检查前提假设,或者换个工具/思路;确实解决不了就向用户报告。' }],
215
248
  });
216
249
  }
217
- else if (m.consecutiveErrors >= 2) {
250
+ else if ((identicalFailures ?? 0) >= 2) {
218
251
  results.push({
219
252
  triggered: true,
220
253
  severity: 'medium',
221
254
  rule: 'error_loop',
222
- description: `连续 ${m.consecutiveErrors} 次错误`,
255
+ description: `同一错误连续 ${identicalFailures} 次`,
223
256
  failureKind: 'blowup',
224
257
  });
225
258
  }
226
- // 规则 3: 工具失败率高
227
- if (m.toolFailureRate > 0.5 && ctx.recentSummaries.length >= 3) {
259
+ else if (m.consecutiveErrors >= ERROR_STREAK_SAFETY) {
260
+ // 连续失败但错误各不相同:可能是探索,也可能整体环境坏了。兜底阈值取高位。
228
261
  results.push({
229
262
  triggered: true,
230
- severity: 'medium',
231
- rule: 'high_failure_rate',
232
- description: `工具失败率 ${(m.toolFailureRate * 100).toFixed(0)}%,执行质量下降`,
233
- failureKind: 'thrash',
234
- suggestedRecovery: [{ type: 'inject_hint', hint: '最近工具调用失败率较高。请检查工具使用方式是否正确,或考虑是否需要换一种方法。' }],
263
+ severity: 'high',
264
+ rule: 'error_streak',
265
+ description: `连续 ${m.consecutiveErrors} 次工具调用失败(错误内容各不相同)`,
266
+ failureKind: 'blowup',
267
+ suggestedRecovery: [{ type: 'inject_hint', hint: '你已经连续多次工具调用失败。请先确认工具本身可用(最小示例验证),或向用户报告当前环境问题。' }],
235
268
  });
236
269
  }
237
- // 规则 4: Token 暴涨
238
- if (m.tokenGrowthRate > 0.5) {
239
- results.push({
240
- triggered: true,
241
- severity: 'medium',
242
- rule: 'token_growth',
243
- description: `Token 增长率 ${(m.tokenGrowthRate * 100).toFixed(0)}%,上下文可能膨胀`,
244
- failureKind: 'burn',
245
- suggestedRecovery: [{ type: 'truncate_context', keepRecent: 6 }],
246
- });
270
+ // 规则 3: 工具失败率高 —— 只有「高失败率 + 完全无推进」才算 thrash
271
+ //
272
+ // 失败率高本身不是行为异常:编码类 run 里跑测试/编译得红是工作的组成部分
273
+ // (先写失败用例再实现、按错误信息反复调试),失败的调用与成功的编辑交替出现,
274
+ // hasProgress 为 true。旧判据只看 `toolFailureRate > 0.5`,会把这类正常 turn
275
+ // 判成 thrash → recover;同 kind 连续 3 次 recover 时还会 `clear_recent_turns`,
276
+ // 把 agent 刚做完的进度从上下文里抹掉,比直接 stop 更隐蔽。
277
+ //
278
+ // 真正的 thrash 特征是「失败没有换来任何推进」:窗口内失败占比过半,
279
+ // 且最近三轮没有任何成功工具或实质文本。
280
+ //
281
+ // 另需样本量下限:失败率是比值,只调用 2 次且都失败也是 100%,不构成证据。
282
+ const windowCalls = m.toolCallsInWindow;
283
+ if (windowCalls === undefined && !warnedMissingWindowMetric) {
284
+ warnedMissingWindowMetric = true;
285
+ console.warn('[RunGuard] CheckpointMetrics.toolCallsInWindow 缺失,high_failure_rate 判据暂不生效');
247
286
  }
248
- // 规则 5: 无进展
249
- if (!m.hasProgress && (ctx.recentSummaries.length >= 3 || (m.noopStreak ?? 0) >= 3)) {
287
+ if (m.toolFailureRate > 0.5 &&
288
+ (windowCalls ?? 0) >= 5 &&
289
+ !m.hasProgress &&
290
+ ctx.recentSummaries.length >= 3) {
250
291
  results.push({
251
292
  triggered: true,
252
- severity: (m.noopStreak ?? 0) >= 3 ? 'medium' : 'low',
253
- rule: 'no_progress',
254
- description: '最近几轮没有实质进展',
255
- failureKind: 'stall',
293
+ severity: 'medium',
294
+ rule: 'high_failure_rate',
295
+ description: `工具失败率 ${(m.toolFailureRate * 100).toFixed(0)}%(窗口 ${windowCalls} 次)且最近无进展`,
296
+ failureKind: 'thrash',
297
+ suggestedRecovery: [{ type: 'inject_hint', hint: '最近的工具调用大量失败,且没有取得任何进展。请停下来定位失败根因(读完整错误信息、确认前提假设是否正确),或向用户报告当前阻塞点。' }],
256
298
  });
257
299
  }
300
+ // 规则 4(token_growth)与规则 5(no_progress)已移除,原因分别是判据错位与功能重复:
301
+ //
302
+ // - 旧规则 4 用 `tokenGrowthRate > 0.5` 判「上下文膨胀」,但该指标是
303
+ // 「最近半窗 token 消耗 ÷ 前一半 − 1」,衡量的是**消耗增速**而非上下文**绝对大小**。
304
+ // 实测两个长 turn 的上下文分别涨到 10 倍和 2 倍,该值仅 0.08 / 0.03 —— 真正的膨胀
305
+ // 它看不见;对「单轮读了个大文件」这种正常工作反而敏感。
306
+ // 而它想管的事已由 wrap-up 的 context 轴无条件处理(`relConfig.wrapUp.contextRatio`
307
+ // 默认 0.85,动作为进入收尾模式、让 agent 输出结论),比 `truncate_context` 更好:
308
+ // 后者用 `messages.splice()` 整段替换历史中部,会打穿前缀缓存(B0 红线)。
309
+ // `tokenGrowthRate` 指标本身保留,仅作观测(run_guard_metrics),不参与裁决。
310
+ //
311
+ // - 旧规则 5 的两个分支都不生效:`low` 没有任何消费方(裁决只取 high/medium);
312
+ // `medium` 要求 `noopStreak >= 3`,而 run-agent 在 `consecutiveNoops >= noopThreshold`
313
+ // 时已设置 `_noopLoopStop` 并发出可见停止事件,`shouldStopAfterTurn` 直接结束 turn,
314
+ // 本规则只是重复判定,还会多注入一条 hint、污染 recoveryHistory。
315
+ //
316
+ // 结论:真正需要 Guard 的异常只有三类——同参同结果(无进展循环)、同参同错误(没换方法)、
317
+ // 高失败率且无推进(thrash)。上下文压力归 wrap-up / Budget,noop 归 run-agent。
258
318
  return results;
259
319
  }
260
320
  // ── Layer 2: LLM 审查 ──
@@ -294,8 +354,8 @@ ${summaryText}${taskLine}${recoveryLine}${signalsLine}
294
354
  当前指标:
295
355
  - 迭代次数: ${ctx.iteration}
296
356
  - 连续错误: ${ctx.metrics.consecutiveErrors}
297
- - 工具失败率: ${(ctx.metrics.toolFailureRate * 100).toFixed(0)}%
298
- - Token 增长率: ${(ctx.metrics.tokenGrowthRate * 100).toFixed(0)}%
357
+ - 连续同一错误: ${ctx.metrics.consecutiveIdenticalFailures ?? '(未提供)'}
358
+ - 工具失败率: ${(ctx.metrics.toolFailureRate * 100).toFixed(0)}%(窗口 ${ctx.metrics.toolCallsInWindow ?? '?'} 次)
299
359
  - 是否有进展: ${ctx.metrics.hasProgress ? '是' : '否'}
300
360
  - 使用的不同工具数: ${ctx.metrics.uniqueToolsUsed}
301
361
 
@@ -9,6 +9,7 @@
9
9
  * @module harness/run/run-scope
10
10
  */
11
11
  import type { Message } from '@octopi-agent/core/types.js';
12
+ import type { ToolFileEffects } from '@octopi-agent/core/types/tools.js';
12
13
  import type { ToolIsolationMode } from '../extension/execution-environment/isolation.js';
13
14
  /** 工具执行时可见的 Run 运行时上下文 */
14
15
  export interface RunToolRuntime {
@@ -21,6 +22,57 @@ export interface RunToolRuntime {
21
22
  isolation?: ToolIsolationMode;
22
23
  /** 只读会话附件根(OP-15);不改变 toolIsolation 语义 */
23
24
  attachmentRoots?: string[];
25
+ /** 本轮文件效应写入口(L3 undo;ToolEffectPolicy) */
26
+ fileEffects: ToolFileEffects;
27
+ /** 本轮记忆面 journal(L3 P2) */
28
+ memoryEffects: import("@octopi-agent/core/types/tools.js").MemoryEffectJournal;
29
+ /** L2 允许根 */
30
+ pathRoots?: string[];
31
+ /** Session undo roots that file tools must not write (D6-a) */
32
+ undoRoots?: string[];
33
+ /** Jail network posture for shell/exec */
34
+ networkPolicy?: 'open' | 'deny' | 'allowlist';
35
+ /** Credential binding strict mode (SEC-3c); untrusted / config */
36
+ requireCredentialBindings?: boolean;
37
+ /** D7 require jail */
38
+ requireJail?: boolean;
39
+ /** jail $HOME write (project/host) */
40
+ homeWrite?: boolean;
41
+ /** Run-level securityDegraded hook */
42
+ noteSecurityDegraded?: (reason: string) => void;
43
+ /** L2 级别 */
44
+ pathContainment?: "strict" | "soft" | "none";
45
+ confirmEffect?: import("@octopi-agent/core/types/tools.js").ToolExecutionContext["confirmEffect"];
46
+ effectChannel?: "engine" | "host-gate";
47
+ /** L1 processLimits(false = 不强制 timeoutMs 看门狗) */
48
+ processLimits?: boolean;
49
+ /** shell 工具策略(gateEffect;deny=拒绝 shell) */
50
+ shellEscape?: "deny" | "confirm" | "allow";
51
+ /** shell 记账深度 */
52
+ shellJournal?: "snapshot" | "off";
53
+ shellJournalLimit?: {
54
+ maxFiles?: number;
55
+ maxBytes?: number;
56
+ maxFileSize?: number;
57
+ };
58
+ /** SEC-2 session participant tool surface (per-run; not on shared harness) */
59
+ sessionToolRights?: {
60
+ allow?: string[];
61
+ deny?: string[];
62
+ denyCapabilities?: string[];
63
+ };
64
+ /**
65
+ * 本 Run 的 effective session rights(E6 计算结果)。
66
+ *
67
+ * 供工具层读取以实现 D3「权限随调用传播」——委派时把**父的有效权限**
68
+ * 作为天花板传给子,子只能在父的权限内行事,不得借委派提权。
69
+ */
70
+ sessionRights?: import('../governance/session-acl/types.js').EffectiveSessionRights;
71
+ /** SEC-2 static agent tool policy (agents[].tools) */
72
+ agentToolPolicy?: {
73
+ allow?: string[];
74
+ deny?: string[];
75
+ };
24
76
  }
25
77
  /** 一次 Run 的作用域身份(I1) */
26
78
  export interface RunScope {