@octopi-agent/engine 0.70.7 → 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 (362) 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 +201 -9
  9. package/dist/config-schema/engine.js +31 -2
  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 +1 -1
  20. package/dist/config-schema/subsystems.d.ts +1 -1
  21. package/dist/config-schema/subsystems.js +2 -1
  22. package/dist/config.d.ts +178 -7
  23. package/dist/config.js +113 -3
  24. package/dist/harness/activation/compiler.js +3 -0
  25. package/dist/harness/activation/runtime.d.ts +7 -0
  26. package/dist/harness/activation/runtime.js +60 -2
  27. package/dist/harness/activation/sources/agent-signal.d.ts +11 -0
  28. package/dist/harness/activation/sources/agent-signal.js +33 -0
  29. package/dist/harness/activation/types.d.ts +6 -1
  30. package/dist/harness/agent/builder.d.ts +47 -3
  31. package/dist/harness/agent/builder.js +180 -54
  32. package/dist/harness/agent/config-bridge.d.ts +33 -25
  33. package/dist/harness/agent/config-bridge.js +81 -291
  34. package/dist/harness/agent/index.d.ts +3 -1
  35. package/dist/harness/agent/index.js +2 -1
  36. package/dist/harness/agent/tool-purpose.d.ts +38 -0
  37. package/dist/harness/agent/tool-purpose.js +118 -0
  38. package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
  39. package/dist/harness/agent/wire-agent-builder.js +363 -0
  40. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +4 -1
  41. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +14 -8
  42. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
  43. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
  44. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
  45. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
  46. package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
  47. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
  48. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
  49. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
  50. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
  51. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
  52. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
  53. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
  54. package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
  55. package/dist/harness/collaboration/delegation/child-run.js +241 -0
  56. package/dist/harness/collaboration/delegation/index.d.ts +26 -0
  57. package/dist/harness/collaboration/delegation/index.js +25 -0
  58. package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
  59. package/dist/harness/collaboration/delegation/notifier.js +84 -0
  60. package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
  61. package/dist/harness/collaboration/delegation/registry-types.js +61 -0
  62. package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
  63. package/dist/harness/collaboration/delegation/registry.js +220 -0
  64. package/dist/harness/collaboration/delegation/service.d.ts +249 -0
  65. package/dist/harness/collaboration/delegation/service.js +499 -0
  66. package/dist/harness/collaboration/delegation/store.d.ts +155 -0
  67. package/dist/harness/collaboration/delegation/store.js +271 -0
  68. package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
  69. package/dist/harness/collaboration/delegation/transport.js +61 -0
  70. package/dist/harness/collaboration/delegation/types.d.ts +231 -0
  71. package/dist/harness/collaboration/delegation/types.js +70 -0
  72. package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
  73. package/dist/harness/collaboration/delegation/wiring.js +145 -0
  74. package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
  75. package/dist/harness/collaboration/orchestration/index.js +11 -11
  76. package/dist/harness/context/assembler.d.ts +2 -2
  77. package/dist/harness/context/assembler.js +12 -7
  78. package/dist/harness/context/capabilities/compact/engine.js +80 -38
  79. package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
  80. package/dist/harness/context/capabilities/summary/registry.js +10 -0
  81. package/dist/harness/context/constitution/default-agents.md +230 -228
  82. package/dist/harness/context/default-context-engine.d.ts +101 -23
  83. package/dist/harness/context/default-context-engine.js +483 -172
  84. package/dist/harness/context/hybrid-compressor.d.ts +3 -3
  85. package/dist/harness/context/hybrid-compressor.js +18 -23
  86. package/dist/harness/context/index.d.ts +5 -1
  87. package/dist/harness/context/index.js +2 -0
  88. package/dist/harness/context/layer-snapshot.d.ts +4 -0
  89. package/dist/harness/context/layer-snapshot.js +30 -18
  90. package/dist/harness/context/layer-types.d.ts +49 -1
  91. package/dist/harness/context/layer-types.js +72 -4
  92. package/dist/harness/context/layers.d.ts +5 -2
  93. package/dist/harness/context/layers.js +11 -5
  94. package/dist/harness/context/llm-summarizer.d.ts +15 -1
  95. package/dist/harness/context/llm-summarizer.js +107 -56
  96. package/dist/harness/context/message-selector.js +6 -2
  97. package/dist/harness/context/root-instructions.d.ts +72 -0
  98. package/dist/harness/context/root-instructions.js +227 -0
  99. package/dist/harness/context/runtime-datetime.d.ts +34 -7
  100. package/dist/harness/context/runtime-datetime.js +66 -10
  101. package/dist/harness/context/smart-router.d.ts +1 -1
  102. package/dist/harness/context/smart-router.js +1 -1
  103. package/dist/harness/context/system-prompt-assembler.d.ts +30 -0
  104. package/dist/harness/context/system-prompt-assembler.js +67 -6
  105. package/dist/harness/context/token-constants.d.ts +2 -2
  106. package/dist/harness/context/token-constants.js +2 -2
  107. package/dist/harness/context/token-estimate-fns.d.ts +1 -3
  108. package/dist/harness/context/token-estimate-fns.js +2 -4
  109. package/dist/harness/context/token-estimator.d.ts +1 -1
  110. package/dist/harness/context/token-estimator.js +14 -6
  111. package/dist/harness/context/tool-result-aging.d.ts +140 -0
  112. package/dist/harness/context/tool-result-aging.js +331 -0
  113. package/dist/harness/context/tool-result-body.d.ts +10 -0
  114. package/dist/harness/context/tool-result-body.js +27 -0
  115. package/dist/harness/context/turn-envelope.d.ts +123 -0
  116. package/dist/harness/context/turn-envelope.js +188 -0
  117. package/dist/harness/context/types.d.ts +35 -47
  118. package/dist/harness/extension/execution-environment/effect-policy.d.ts +248 -0
  119. package/dist/harness/extension/execution-environment/effect-policy.js +334 -0
  120. package/dist/harness/extension/execution-environment/index.d.ts +18 -2
  121. package/dist/harness/extension/execution-environment/index.js +11 -2
  122. package/dist/harness/extension/execution-environment/memory-undo.d.ts +101 -0
  123. package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
  124. package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
  125. package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
  126. package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
  127. package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
  128. package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
  129. package/dist/harness/extension/execution-environment/sandbox.js +493 -51
  130. package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
  131. package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
  132. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
  133. package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
  134. package/dist/harness/extension/execution-environment/types.d.ts +67 -39
  135. package/dist/harness/extension/execution-environment/types.js +2 -2
  136. package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
  137. package/dist/harness/extension/execution-environment/undo-log.js +627 -0
  138. package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
  139. package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
  140. package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +1 -1
  141. package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +9 -0
  142. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
  143. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
  144. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
  145. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
  146. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
  147. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
  148. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
  149. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
  150. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
  151. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
  152. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
  153. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
  154. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
  155. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
  156. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
  157. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
  158. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
  159. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +45 -0
  160. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +136 -0
  161. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
  162. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
  163. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +277 -81
  164. package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
  165. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
  166. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
  167. package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
  168. package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
  169. package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
  170. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
  171. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
  172. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
  173. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
  174. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +239 -61
  175. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
  176. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +554 -0
  177. package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
  178. package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
  179. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +2 -0
  180. package/dist/harness/extension/plugin-ecosystem/tools/index.js +2 -0
  181. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
  182. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +25 -1
  183. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
  184. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
  185. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
  186. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
  187. package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
  188. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
  189. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
  190. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
  192. package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
  193. package/dist/harness/governance/credentials/index.d.ts +1 -1
  194. package/dist/harness/governance/credentials/store.d.ts +16 -4
  195. package/dist/harness/governance/credentials/store.js +33 -6
  196. package/dist/harness/governance/credentials/types.d.ts +11 -0
  197. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
  198. package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
  199. package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
  200. package/dist/harness/governance/human-in-the-loop/index.js +3 -3
  201. package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
  202. package/dist/harness/governance/human-in-the-loop/types.js +6 -2
  203. package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
  204. package/dist/harness/governance/security/capability-enforcer.js +31 -8
  205. package/dist/harness/governance/security/degradation.js +5 -7
  206. package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
  207. package/dist/harness/governance/security/risk-evaluator.js +4 -82
  208. package/dist/harness/governance/security/temp-path.d.ts +41 -0
  209. package/dist/harness/governance/security/temp-path.js +117 -0
  210. package/dist/harness/governance/session-acl/index.d.ts +1 -0
  211. package/dist/harness/governance/session-acl/index.js +1 -0
  212. package/dist/harness/governance/session-acl/rights.d.ts +12 -0
  213. package/dist/harness/governance/session-acl/rights.js +89 -7
  214. package/dist/harness/governance/session-acl/seed-roles.js +9 -1
  215. package/dist/harness/governance/session-acl/service.js +21 -29
  216. package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
  217. package/dist/harness/governance/session-acl/tool-rights.js +238 -0
  218. package/dist/harness/governance/session-acl/types.d.ts +22 -0
  219. package/dist/harness/index.d.ts +14 -12
  220. package/dist/harness/index.js +9 -6
  221. package/dist/harness/knowledge/file-index-store.js +11 -11
  222. package/dist/harness/knowledge/grounding.d.ts +2 -1
  223. package/dist/harness/knowledge/grounding.js +6 -3
  224. package/dist/harness/knowledge/index.d.ts +2 -2
  225. package/dist/harness/knowledge/index.js +1 -1
  226. package/dist/harness/knowledge/ingest.js +4 -1
  227. package/dist/harness/knowledge/job-control-state.js +4 -4
  228. package/dist/harness/knowledge/job-control.js +11 -11
  229. package/dist/harness/knowledge/membership-store.js +11 -11
  230. package/dist/harness/knowledge/network-guard.d.ts +61 -4
  231. package/dist/harness/knowledge/network-guard.js +390 -113
  232. package/dist/harness/knowledge/query-service.js +3 -3
  233. package/dist/harness/knowledge/writer-service.d.ts +2 -0
  234. package/dist/harness/knowledge/writer-service.js +14 -13
  235. package/dist/harness/memory/backfill-trigger.d.ts +2 -2
  236. package/dist/harness/memory/backfill-trigger.js +4 -4
  237. package/dist/harness/memory/index.d.ts +1 -0
  238. package/dist/harness/memory/index.js +1 -0
  239. package/dist/harness/memory/sqlite/agent-db.js +2 -0
  240. package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
  241. package/dist/harness/memory/sqlite/memory-store.js +14 -4
  242. package/dist/harness/memory/sqlite/wisdom-store.js +9 -9
  243. package/dist/harness/memory/store.d.ts +1 -0
  244. package/dist/harness/memory/store.js +3 -0
  245. package/dist/harness/memory/time-format.d.ts +28 -0
  246. package/dist/harness/memory/time-format.js +52 -0
  247. package/dist/harness/memory/types.d.ts +12 -0
  248. package/dist/harness/observability/observer/hub.js +23 -1
  249. package/dist/harness/observability/observer/index.d.ts +2 -2
  250. package/dist/harness/observability/observer/index.js +1 -1
  251. package/dist/harness/observability/observer/types.d.ts +57 -0
  252. package/dist/harness/observability/observer/types.js +118 -9
  253. package/dist/harness/run/agent/agent.d.ts +18 -0
  254. package/dist/harness/run/agent/agent.js +26 -0
  255. package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
  256. package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
  257. package/dist/harness/run/reliability/harness-events.d.ts +4 -0
  258. package/dist/harness/run/reliability/run-agent.js +110 -18
  259. package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
  260. package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
  261. package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
  262. package/dist/harness/run/run-guard/default-run-guard.js +104 -44
  263. package/dist/harness/run/run-scope.d.ts +52 -0
  264. package/dist/harness/run/runner.d.ts +101 -16
  265. package/dist/harness/run/runner.js +556 -158
  266. package/dist/harness/session/attachments/llm-intent.js +17 -17
  267. package/dist/harness/session/history/port.js +1 -0
  268. package/dist/harness/session/in-memory-store.d.ts +1 -0
  269. package/dist/harness/session/in-memory-store.js +22 -1
  270. package/dist/harness/session/schedules/index.d.ts +10 -0
  271. package/dist/harness/session/schedules/index.js +10 -0
  272. package/dist/harness/session/schedules/render.d.ts +13 -0
  273. package/dist/harness/session/schedules/render.js +63 -0
  274. package/dist/harness/session/schedules/service.d.ts +179 -0
  275. package/dist/harness/session/schedules/service.js +695 -0
  276. package/dist/harness/session/schedules/store.d.ts +119 -0
  277. package/dist/harness/session/schedules/store.js +323 -0
  278. package/dist/harness/session/schedules/tools.d.ts +39 -0
  279. package/dist/harness/session/schedules/tools.js +442 -0
  280. package/dist/harness/session/schedules/types.d.ts +104 -0
  281. package/dist/harness/session/schedules/types.js +97 -0
  282. package/dist/harness/session/tasks/tools.js +22 -0
  283. package/dist/harness/session/types.d.ts +35 -0
  284. package/dist/harness/shared/events/agent-event-map.d.ts +13 -0
  285. package/dist/harness/shared/types/agent-definition.d.ts +23 -0
  286. package/dist/index.d.ts +23 -9
  287. package/dist/index.js +10 -2
  288. package/dist/integration/providers/anthropic.d.ts +10 -0
  289. package/dist/integration/providers/anthropic.js +44 -1
  290. package/dist/integration/providers/openai.d.ts +10 -0
  291. package/dist/integration/providers/openai.js +58 -2
  292. package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
  293. package/dist/integration/providers/wire-dump-diff.js +351 -0
  294. package/dist/integration/providers/wire-dump.d.ts +178 -0
  295. package/dist/integration/providers/wire-dump.js +396 -0
  296. package/dist/integration/storage/jsonl.d.ts +11 -0
  297. package/dist/integration/storage/jsonl.js +148 -39
  298. package/dist/integration/storage/session-index.js +63 -8
  299. package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -43
  300. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -50
  301. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -6
  302. package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -54
  303. package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
  304. package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -50
  305. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -42
  306. package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -54
  307. package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -55
  308. package/package.json +115 -115
  309. package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
  310. package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
  311. package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
  312. package/dist/harness/collaboration/multi-agent/index.js +0 -15
  313. package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
  314. package/dist/harness/collaboration/multi-agent/process.js +0 -256
  315. package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
  316. package/dist/harness/collaboration/multi-agent/registry.js +0 -137
  317. package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
  318. package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
  319. package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
  320. package/dist/harness/collaboration/multi-agent/types.js +0 -15
  321. package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
  322. package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
  323. package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
  324. package/dist/harness/collaboration/orchestration/async-task.js +0 -359
  325. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
  326. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
  327. package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
  328. package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
  329. package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
  330. package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
  331. package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
  332. package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
  333. package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
  334. package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
  335. package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
  336. package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
  337. package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
  338. package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
  339. package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
  340. package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
  341. package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
  342. package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
  343. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
  344. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
  345. package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
  346. package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
  347. package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
  348. package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
  349. package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
  350. package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
  351. package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
  352. package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
  353. package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
  354. package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
  355. package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
  356. package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
  357. package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
  358. package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
  359. package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
  360. package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
  361. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
  362. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.js +0 -0
@@ -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 {
@@ -2,9 +2,10 @@
2
2
  * SessionAwareRunner — Session 感知的运行器
3
3
  *
4
4
  * Harness 层组件。在 Agent.run()(自带 reliability)之上管理 Session 生命周期:
5
- * - 消息持久化
5
+ * - 消息持久化(Discourse 追加日志;不因 idle/跨日清空)
6
6
  * - Session 锁(同一 session 同时只有一个运行)
7
- * - Daily reset / Idle reset
7
+ * - 上下文租约(`idleExpiryMs` opt-in:只截 LLM 默认窗口)
8
+ * - 中止轮标记(`abortedTurn`,供 UI 编辑重发)
8
9
  * - 并发控制
9
10
  *
10
11
  * Agent 是 Harness 运行时门面;不要再手拼 runAgentWithReliability。
@@ -22,12 +23,13 @@ import { type ToolIsolationMode } from '../extension/execution-environment/isola
22
23
  import { type SessionLease } from './concurrency/session-lease.js';
23
24
  /** 运行器配置 */
24
25
  export interface SessionAwareRunnerConfig {
25
- /** Session 过期时间(毫秒,默认 24 小时) */
26
- sessionExpiryMs?: number;
27
- /** 空闲过期时间(毫秒,默认 2 小时) */
26
+ /**
27
+ * 上下文租约(毫秒)。**显式配置才生效**;缺省 / 0 = 关闭。
28
+ *
29
+ * 闲置超过本值后,下一轮 LLM 默认消息窗口从租约点截断(Discourse 全量保留)。
30
+ * 需要旧内容时走 session_search / session_read。与 memory 冷沉淀解耦。
31
+ */
28
32
  idleExpiryMs?: number;
29
- /** 是否启用 daily reset */
30
- enableDailyReset?: boolean;
31
33
  /**
32
34
  * 并发 session 门控(可选)
33
35
  *
@@ -42,6 +44,12 @@ export interface SessionAwareRunnerConfig {
42
44
  * 与 task_* 工具共用同一实例。
43
45
  */
44
46
  sessionTaskService?: SessionTaskService;
47
+ /**
48
+ * 会话日程服务(Agent 自发起定时)
49
+ *
50
+ * handle() 每轮注入未闭合 schedule;与 schedule_* 工具共用同一实例。
51
+ */
52
+ sessionScheduleService?: import('../session/schedules/service.js').SessionScheduleService;
45
53
  /**
46
54
  * 解析 run 级模型快照(Gateway 注入;每 run 调用一次)
47
55
  *
@@ -79,13 +87,23 @@ export interface SessionAwareRunnerConfig {
79
87
  * 来自 AgentDefinition.maxSessionRights;authorizeRun 时取交集。
80
88
  */
81
89
  agentMaxSessionRights?: import('../governance/session-acl/types.js').SessionRights;
90
+ /**
91
+ * Agent 静态工具策略(agents[].tools allow/deny)。
92
+ * 与 sessionToolRights 求交;deny 优先(SEC-2)。
93
+ */
94
+ agentToolPolicy?: import('@octopi-agent/core/types.js').ToolPolicy;
82
95
  /** 产品 Observer 通道(Run 现场快照;缺省不采集) */
83
96
  observerHub?: import('../observability/observer/hub.js').ObserverHub;
84
97
  /**
85
- * 会话附件根基路径(OP-15)。通常 `OCTOPI_HOME/sessions`。
86
- * 设置后 RunScope.toolRuntime.attachmentRoots = `<base>/<sid>/attachments`(只读)。
98
+ * 会话数据根目录(`OCTOPI_HOME/sessions`)。附件根 = `<sessionsDir>/<sid>/attachments`;
99
+ * turn 文件 undo = `<sessionsDir>/<sid>/undo`(ToolEffectPolicy L3)。
87
100
  */
88
- sessionAttachmentsBaseDir?: string;
101
+ sessionsDir?: string;
102
+ /** ToolEffectPolicy(P3);展开后驱动 toolIsolation / L2 */
103
+ effectPolicy?: import("../extension/execution-environment/effect-policy.js").EffectPolicyConfig;
104
+ /** credentials.requireBindings(SEC-3c):无绑定凭证不可 resolve */
105
+ requireCredentialBindings?: boolean;
106
+ confirmEffect?: import("../extension/execution-environment/effect-policy.js").ConfirmEffect;
89
107
  /** 附件注入参数(knowledge.attachments.inject;缺省用内建默认) */
90
108
  sessionAttachmentInject?: {
91
109
  fullTextMaxChars?: number;
@@ -121,6 +139,13 @@ export interface RunConfig {
121
139
  agentRevision?: string;
122
140
  contextWindow?: number;
123
141
  injectedContext?: string;
142
+ /**
143
+ * 本 Run 的权利天花板(`arch/delegation.md` D3:只能收紧不能放宽)。
144
+ *
145
+ * 与 Runner 的 `agentMaxSessionRights` **取交集**后进 `authorizeRun`;
146
+ * 委派子 Run 用它传 `DelegateRequest.rightsCeiling`。
147
+ */
148
+ rightsCeiling?: import('../governance/session-acl/types.js').SessionRights;
124
149
  }
125
150
  /**
126
151
  * 适配 HarnessLoopEvent → AgentEvent(向后兼容)
@@ -146,11 +171,38 @@ export declare function adaptLoopEvent(event: HarnessLoopEvent, meta: {
146
171
  assistantContent: string;
147
172
  lastUserContent?: string;
148
173
  stopReason?: string;
174
+ /** 引擎为何终止(人类可读);收口落一条 runStopped 消息,禁止静默停止 */
175
+ stopMessage?: string;
176
+ /** 判定细节(规则名/指标),供审计与日志 */
177
+ stopDetail?: string;
178
+ /**
179
+ * loop 的 `agent_end.reason`(completed / should_stop / aborted / error)。
180
+ *
181
+ * 是否真的「提前停止」只能看这里:`security_blocked` 单次拦截后 run 会继续,
182
+ * 只看它会把正常完成的 run 误报成停止。
183
+ */
184
+ loopEndReason?: string;
149
185
  }): import('@octopi-agent/core/primitives/event-bus.js').AgentEvent | null;
150
186
  /**
151
187
  * SessionAwareRunner
152
188
  */
153
189
  export declare class SessionAwareRunner {
190
+ /** 本 Runner 生效的 L2 级别(由 effectPolicy 展开) */
191
+ private effectPathContainment;
192
+ private effectChannel;
193
+ private effectAllowRoots;
194
+ /** Effective effectPolicy.mode (for Runtime injection / UI) */
195
+ private effectMode;
196
+ private effectCommitManual;
197
+ private effectProcessLimits;
198
+ private effectNetwork;
199
+ private effectRequireJail;
200
+ private effectRequireCredentialBindings;
201
+ private effectHomeWrite;
202
+ private effectShellEscape;
203
+ private effectShellJournal;
204
+ private effectShellJournalLimit?;
205
+ private effectUndoLimit?;
154
206
  private agent;
155
207
  private harness;
156
208
  private store;
@@ -175,7 +227,7 @@ export declare class SessionAwareRunner {
175
227
  private lastCleanPersonaPrompt?;
176
228
  /** 按层契约组装 system prompt(persona + runtime);未设置时退回字符串拼接 */
177
229
  private systemPromptAssembler?;
178
- /** 会话重置时清理 Assembler 层缓存 */
230
+ /** Assembler 层缓存清理钩子(可选接线;与 contextDetachIndex 无关) */
179
231
  private systemPromptAssemblerClear?;
180
232
  /** turn 级 Knowledge grounding(可选;arch/knowledge-layer.md §4.4) */
181
233
  private groundingAssembler?;
@@ -240,6 +292,10 @@ export declare class SessionAwareRunner {
240
292
  *
241
293
  * 每轮在 persona resolve 与 injectedContext 计算完成后调用,
242
294
  * 替代原先的字符串拼接。未设置时保持旧路径(兼容)。
295
+ *
296
+ * E8 契约:`injectedContext` 保持合并形态(兼容旧 assembler,零能力丢失);
297
+ * 拆分字段 `volatileContext`(易变份→快照)与 `runtimeAnchors`(稳定份→system)同时传入,
298
+ * 默认 assembler 优先用拆分字段;降级/无 assembler 路径同样产出快照(E8 形态不破)。
243
299
  */
244
300
  setSystemPromptAssembler(assembler: (input: {
245
301
  sessionId: string;
@@ -247,11 +303,17 @@ export declare class SessionAwareRunner {
247
303
  messages: Message[];
248
304
  persona: string;
249
305
  injectedContext?: string;
306
+ /** E8:易变注入份(datetime/tasks/guidance);优先于 injectedContext */
307
+ volatileContext?: string;
308
+ /** E8:稳定运行时锚点(留 system prompt) */
309
+ runtimeAnchors?: string;
250
310
  contextWindow?: number;
251
311
  topicHints?: string;
252
312
  signal?: AbortSignal;
253
313
  }) => Promise<{
254
314
  systemPrompt: string;
315
+ /** E8:本轮易变快照(消息尾部插槽送达) */
316
+ runtimeSnapshot?: string;
255
317
  manifest?: import('../context/layer-types.js').AssembleManifest;
256
318
  }>, clearSession?: (sessionId: string) => void): void;
257
319
  /**
@@ -313,6 +375,8 @@ export declare class SessionAwareRunner {
313
375
  tokensBefore: number;
314
376
  tokensAfter?: number;
315
377
  summary?: string;
378
+ /** 摘要覆盖终点(tailStart,不含) */
379
+ coveredMessageCount?: number;
316
380
  }>;
317
381
  summarize?: (messages: import('@octopi-agent/core/interfaces/model-provider.js').LLMMessage[], opts?: {
318
382
  maxTokens?: number;
@@ -334,6 +398,12 @@ export declare class SessionAwareRunner {
334
398
  * 分布式:注入 DistributedSessionLease;勿假设 in-process 锁全局有效(E7)。
335
399
  */
336
400
  private acquireLock;
401
+ /**
402
+ * SEC-2: strip tools by agent ToolPolicy ∩ sessionToolRights (narrow-only).
403
+ * Listing filter; beforeToolCall repeats the same check as defense-in-depth.
404
+ * Rights are passed per-run (harness is shared across concurrent sessions).
405
+ */
406
+ private filterToolsForSessionRights;
337
407
  /**
338
408
  * 创建新 Session
339
409
  *
@@ -341,6 +411,21 @@ export declare class SessionAwareRunner {
341
411
  * 存储主键 = sessionId;agentId 只作归属/参与投影。
342
412
  */
343
413
  private createSession;
414
+ /**
415
+ * 补闭上一 turn(崩溃/中止后无 turn_end 时 write-once 追加)。
416
+ * 新 turn 禁止在 open 未闭时叠加。
417
+ */
418
+ private ensurePreviousTurnClosed;
419
+ /**
420
+ * user 消息一次定形为 `<turn_start>…</turn_start>`(write-once)。
421
+ * @param userMessage - 本 turn 用户消息对象(session.messages 中的同一引用)
422
+ * @param turnId - 会话内单调 turn id
423
+ * @param turnContextXml - `<turn_context>…</turn_context>` 整段
424
+ * @throws 若已定形(禁止二次改写)
425
+ */
426
+ private bakeTurnStart;
427
+ /** 追加 turn 闭标(write-once;同 id 重复 → throw) */
428
+ private appendTurnEnd;
344
429
  /** 旧路径:persona + injectedContext 字符串拼接;结果返回给 runContext,不写共享 Agent */
345
430
  private concatSystemPrompt;
346
431
  /**
@@ -352,12 +437,12 @@ export declare class SessionAwareRunner {
352
437
  /**
353
438
  * 检查 Session 是否需要重置
354
439
  */
355
- private checkSessionReset;
356
440
  /**
357
- * 将 session 生命周期落到 recent + endedAt,并广播事件。
358
- * 状态在 SessionData.lifecycle;由后续 save 持久化(meta 索引投影)。
359
- * 不写 memoryExtraction(进度归 memory.steward);事件仍带 extractionStatus 供 Sense 感知。
441
+ * 上下文租约(opt-in):闲置超时后仅记录截断点,供 LLM 默认窗口裁剪。
442
+ *
443
+ * 不删 Discourse、不碰 compact/memory。冷沉淀归 memory.steward 的 idle 扫描。
444
+ * 在 push 本轮 input 之前调用,保证新消息落在租约点之后。
360
445
  */
361
- private markSessionRecent;
446
+ private applyContextLease;
362
447
  }
363
448
  export {};