@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
@@ -7,6 +7,8 @@
7
7
  * 总开关 = `level`:off(**生产/嵌入缺省**)=关;summary/full=开。
8
8
  * message 全文只认 payload.messageFullText && retention.messagesPerRun==='full'。
9
9
  */
10
+ import { isChatReplayHidden } from '../../context/layer-types.js';
11
+ import { isTurnStartContent, messageText, parseTurnEnvelope, parseTurnIdFromContent, } from '../../context/turn-envelope.js';
10
12
  /**
11
13
  * 未写 observer 时的解析结果 = level 预设 `off`
12
14
  * (生产/嵌入缺省不采集;开发在 octopi.json 显式 summary/full)
@@ -182,10 +184,92 @@ export function shouldCaptureMessageFullText(cfg) {
182
184
  cfg.payload.messageFullText === true &&
183
185
  cfg.retention.messagesPerRun === 'full');
184
186
  }
187
+ /**
188
+ * Run message 归因(G2/G4 唯一判定处)。
189
+ *
190
+ * 判定次序:**source 优先、内容兜底**——
191
+ * ① role 二值(assistant/tool)→ ② 引擎载体 source(turnEnd / 载体插槽 / contextSummary / engineHint,
192
+ * 语义真源 `harness/context/layer-types.ts` ENGINE_CARRIER_SOURCES)→ ③ system role →
193
+ * ④ 无 source + user role + 正文以信封开标签起头 = turn_envelope → ⑤ 其余 user_speech。
194
+ *
195
+ * source 优先是审计面的可靠性要求:载体消息正文来自不可信语料(知识/grounding/附件),
196
+ * 含信封字面量也不得被内容嗅探抢走归因(否则机器插槽挂上「用户发言」徽章)。
197
+ * turn_end 的内容兜底仅作 legacy 降级:无 source 且整条正文就是闭标形状才认。
198
+ *
199
+ * @param msg - 消息(role/content/metadata)
200
+ * @returns 归因
201
+ */
202
+ export function attributeRunMessage(msg) {
203
+ const role = (msg.role ?? 'user');
204
+ const source = msg.metadata?.source;
205
+ const base = source !== undefined ? { source } : {};
206
+ // ① 模型/工具输出
207
+ if (role === 'assistant')
208
+ return { speaker: 'llm', kind: 'assistant', ...base };
209
+ if (role === 'tool')
210
+ return { speaker: 'tool', kind: 'tool', ...base };
211
+ // ② 引擎载体语义(source 是机器插槽的一等标识,先于一切内容嗅探)
212
+ if (source === 'turnEnd') {
213
+ return {
214
+ speaker: 'engine',
215
+ kind: 'turn_end',
216
+ turnId: parseTurnIdFromContent(msg.content),
217
+ ...base,
218
+ };
219
+ }
220
+ if (source === 'runtimeSnapshot' ||
221
+ source === 'knowledgeGrounding' ||
222
+ source === 'sessionAttachment') {
223
+ return { speaker: 'engine', kind: 'carrier', ...base };
224
+ }
225
+ if (source === 'contextSummary')
226
+ return { speaker: 'engine', kind: 'context_summary', ...base };
227
+ if (source === 'engineHint')
228
+ return { speaker: 'engine', kind: 'engine_hint', ...base };
229
+ // ③ system 消息
230
+ if (role === 'system') {
231
+ return {
232
+ speaker: 'engine',
233
+ kind: source === 'systemPrompt' ? 'hosted_system' : 'system',
234
+ ...base,
235
+ };
236
+ }
237
+ // ④ 内容兜底(仅无 source 的 user 消息):正文以信封开标签起头 = 已定形 turn 信封
238
+ if (isTurnStartContent(msg.content)) {
239
+ const env = parseTurnEnvelope(msg.content);
240
+ return {
241
+ speaker: 'human',
242
+ kind: 'turn_envelope',
243
+ turnId: env?.turnId,
244
+ ...base,
245
+ slots: env?.slots.map((s) => ({ tag: s.tag, chars: s.body.length })),
246
+ userChars: env && env.hasUserMessage ? env.userText.length : 0,
247
+ hasUserMessage: env?.hasUserMessage,
248
+ };
249
+ }
250
+ // legacy 降级:无 source 且整条正文就是闭标形状(用户发言中途回显闭标不算)
251
+ if (source === undefined && isTurnEndShape(msg.content)) {
252
+ return {
253
+ speaker: 'engine',
254
+ kind: 'turn_end',
255
+ turnId: parseTurnIdFromContent(msg.content),
256
+ ...base,
257
+ };
258
+ }
259
+ // ⑤ 其余 user 发言(未知 role 落 engine/system,不冒充用户)
260
+ if (role === 'user')
261
+ return { speaker: 'human', kind: 'user_speech', ...base };
262
+ return { speaker: 'engine', kind: 'system', ...base };
263
+ }
264
+ /** 整条正文就是 turn_end 闭标形状(legacy 降级用;用户发言中途回显不命中) */
265
+ function isTurnEndShape(content) {
266
+ return /^\s*<turn_end[\s/>][^<]*\/?>\s*$/.test(messageText(content));
267
+ }
185
268
  /** message 摘要统计 */
186
269
  export function summarizeMessages(messages, opts) {
187
270
  const maxPreview = opts?.maxPreviewChars ?? 200;
188
271
  const byRole = {};
272
+ const byKind = {};
189
273
  const agentIds = new Set();
190
274
  let systemPromptCount = 0;
191
275
  let contextSummaryCount = 0;
@@ -204,6 +288,8 @@ export function summarizeMessages(messages, opts) {
204
288
  const hidden = isHiddenFromChat(m);
205
289
  if (hidden)
206
290
  hiddenFromChatCount += 1;
291
+ const attribution = attributeRunMessage(m);
292
+ byKind[attribution.kind] = (byKind[attribution.kind] ?? 0) + 1;
207
293
  const text = extractMessageText(m.content);
208
294
  chars += text.length;
209
295
  return {
@@ -215,6 +301,7 @@ export function summarizeMessages(messages, opts) {
215
301
  toolCalls: m.toolCalls,
216
302
  toolResults: m.toolResults,
217
303
  hiddenFromChat: hidden,
304
+ attribution,
218
305
  contentChars: text.length,
219
306
  contentPreview: text.slice(0, maxPreview),
220
307
  };
@@ -223,6 +310,7 @@ export function summarizeMessages(messages, opts) {
223
310
  summary: {
224
311
  count: messages.length,
225
312
  byRole,
313
+ byKind,
226
314
  systemPromptCount,
227
315
  contextSummaryCount,
228
316
  hiddenFromChatCount,
@@ -239,14 +327,13 @@ export function summarizeMessages(messages, opts) {
239
327
  * @returns 是否隐藏
240
328
  */
241
329
  export function isHiddenFromChat(msg) {
242
- if (msg.role !== 'system')
243
- return false;
244
- const source = msg.metadata?.source;
245
- if (source === 'systemPrompt')
246
- return true;
247
- const text = extractMessageText(msg.content);
248
- return (text.length > 200 &&
249
- /AGENTS\.md|Session Startup|Operating Instructions|Agent Persona/i.test(text));
330
+ // D9:判定委托共享谓词 isChatReplayHidden(layer-types),
331
+ // 与 ConversationAdapter.isHiddenSystemHistory 同源,清单不再两份手抄
332
+ return isChatReplayHidden({
333
+ role: msg.role,
334
+ source: msg.metadata?.source,
335
+ text: extractMessageText(msg.content),
336
+ });
250
337
  }
251
338
  function extractMessageText(content) {
252
339
  if (typeof content === 'string')
@@ -278,7 +365,19 @@ export function attachFullContent(views, messages) {
278
365
  const m = messages[v.index];
279
366
  if (!m)
280
367
  return v;
281
- return { ...v, content: m.content };
368
+ const next = { ...v, content: m.content };
369
+ // full 模式补 turn 信封槽位正文(审计入口:这轮模型看到了什么)
370
+ if (v.attribution?.kind === 'turn_envelope') {
371
+ const env = parseTurnEnvelope(m.content);
372
+ if (env) {
373
+ // 整组按解析顺序重建(不用 tag 当查找键:同 tag 双槽位会串正文)
374
+ next.attribution = {
375
+ ...v.attribution,
376
+ slots: env.slots.map((s) => ({ tag: s.tag, chars: s.body.length, body: s.body })),
377
+ };
378
+ }
379
+ }
380
+ return next;
282
381
  });
283
382
  }
284
383
  function cloneUnknown(value) {
@@ -320,15 +419,25 @@ export function cloneMessages(messages) {
320
419
  */
321
420
  export function summarizeLlmMessages(messages) {
322
421
  const byRole = {};
422
+ const byKind = {};
323
423
  let chars = 0;
324
424
  for (const m of messages) {
325
425
  const role = m.role || 'unknown';
326
426
  byRole[role] = (byRole[role] ?? 0) + 1;
427
+ // 归因与 workspace 视图同源(LLM 出口消息无 metadata,信封/角色仍可判定)。
428
+ // 已知局限(F10):source 型机器插槽(contextSummary/engineHint)在 LLM 出口丢失 metadata,
429
+ // 只能落 user_speech——byKind 与逐条 attribution 同用本函数,两侧口径一致不互斥
430
+ const attribution = attributeRunMessage({
431
+ role: m.role,
432
+ content: m.content,
433
+ });
434
+ byKind[attribution.kind] = (byKind[attribution.kind] ?? 0) + 1;
327
435
  chars += extractMessageText(m.content).length;
328
436
  }
329
437
  return {
330
438
  count: messages.length,
331
439
  byRole,
440
+ byKind,
332
441
  systemPromptCount: byRole.system ?? 0,
333
442
  contextSummaryCount: 0,
334
443
  // LLM 出口视图无「对话 UI 隐藏」语义;不把 system 条数冒充 hidden
@@ -67,6 +67,12 @@ export declare class Agent {
67
67
  */
68
68
  get config(): Readonly<AgentLoopConfig>;
69
69
  get harness(): ReliabilityHarness | undefined;
70
+ /**
71
+ * 同步 SecurityGuard 未注册工具硬边界名单。
72
+ * Client Tool 等动态注册会经 setTools 进入 tool 面;若不同步,会被
73
+ * DefaultSecurityGuard 以 unauthorized_tool 拦截。
74
+ */
75
+ private syncSecurityRegisteredTools;
70
76
  registerTool(tool: AgentTool): void;
71
77
  setTools(tools: AgentTool[]): void;
72
78
  /**
@@ -95,6 +101,7 @@ export declare class Agent {
95
101
  setSessionCompactState(sessionId: string, agentId: string, state: {
96
102
  summary?: string;
97
103
  lastProactiveMessageCount?: number;
104
+ lastProactiveCoverEnd?: number;
98
105
  lastProactiveTokens?: number;
99
106
  } | undefined): void;
100
107
  /**
@@ -107,6 +114,7 @@ export declare class Agent {
107
114
  getSessionCompactState(sessionId: string, agentId: string): {
108
115
  summary?: string;
109
116
  lastProactiveMessageCount?: number;
117
+ lastProactiveCoverEnd?: number;
110
118
  lastProactiveTokens?: number;
111
119
  } | undefined;
112
120
  /** 每轮结束后通知 ContextEngine(afterTurn 校准等);turn 为本轮增量消息 */
@@ -115,6 +123,16 @@ export declare class Agent {
115
123
  notifyAfterTurn(usage?: import('@octopi-agent/core/types/turn.js').TokenUsage, turn?: Message[]): Promise<void>;
116
124
  /** 动态替换 convertToLlm(ContextEngine 接线等) */
117
125
  setConvertToLlm(fn?: AgentLoopConfig['convertToLlm']): void;
126
+ /**
127
+ * 动态替换 getSteeringMessages(当前 turn 结束后注入的提示)
128
+ *
129
+ * 晚绑定入口:一个 Agent 实例服务多 session,回调必须经
130
+ * `getRunScope()` / `getRunSessionId()` 取**本 Run** 的身份,
131
+ * 不得直接闭包某个 sessionId(否则并发 session 串味,违反 I1)。
132
+ *
133
+ * @param fn - steering 消息提供者;undefined 清除
134
+ */
135
+ setSteeringMessages(fn?: AgentLoopConfig['getSteeringMessages']): void;
118
136
  /** 动态替换 transformContext */
119
137
  setTransformContext(fn?: AgentLoopConfig['transformContext']): void;
120
138
  /**
@@ -67,11 +67,24 @@ export class Agent {
67
67
  }
68
68
  get harness() { return this._harness; }
69
69
  // ── 工具管理 ──
70
+ /**
71
+ * 同步 SecurityGuard 未注册工具硬边界名单。
72
+ * Client Tool 等动态注册会经 setTools 进入 tool 面;若不同步,会被
73
+ * DefaultSecurityGuard 以 unauthorized_tool 拦截。
74
+ */
75
+ syncSecurityRegisteredTools() {
76
+ const security = this._harness?.security;
77
+ if (!security?.setRegisteredTools)
78
+ return;
79
+ security.setRegisteredTools(new Set(this.tools.map((t) => t.name)));
80
+ }
70
81
  registerTool(tool) {
71
82
  this._context.tools = [...(this._context.tools ?? []), tool];
83
+ this.syncSecurityRegisteredTools();
72
84
  }
73
85
  setTools(tools) {
74
86
  this._context.tools = [...tools];
87
+ this.syncSecurityRegisteredTools();
75
88
  }
76
89
  /**
77
90
  * 会话级 tool 面可见性(Client Tool:无 live client 则不进 LLM tool 面)。
@@ -97,6 +110,7 @@ export class Agent {
97
110
  }
98
111
  setHarness(harness) {
99
112
  this._harness = harness;
113
+ this.syncSecurityRegisteredTools();
100
114
  }
101
115
  /** 当前 ContextEngine 会话键(多 Session 时由 Runner 注入) */
102
116
  get contextSessionId() {
@@ -148,6 +162,18 @@ export class Agent {
148
162
  setConvertToLlm(fn) {
149
163
  this._config = { ...this._config, convertToLlm: fn };
150
164
  }
165
+ /**
166
+ * 动态替换 getSteeringMessages(当前 turn 结束后注入的提示)
167
+ *
168
+ * 晚绑定入口:一个 Agent 实例服务多 session,回调必须经
169
+ * `getRunScope()` / `getRunSessionId()` 取**本 Run** 的身份,
170
+ * 不得直接闭包某个 sessionId(否则并发 session 串味,违反 I1)。
171
+ *
172
+ * @param fn - steering 消息提供者;undefined 清除
173
+ */
174
+ setSteeringMessages(fn) {
175
+ this._config = { ...this._config, getSteeringMessages: fn };
176
+ }
151
177
  /** 动态替换 transformContext */
152
178
  setTransformContext(fn) {
153
179
  this._config = { ...this._config, transformContext: fn };
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Tool-call loop detection (no-progress pattern matching)
3
3
  *
4
- * 参考 OpenClaw 的 tool-loop-detection 设计:
4
+ * 设计要点:
5
5
  * - 不限制工具调用次数(多步工作是正常的)
6
6
  * - 检测"相同调用 + 相同结果"的无进展重复
7
7
  * - 使用 hash(tool_name + params + result) 作为指纹
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Tool-call loop detection (no-progress pattern matching)
3
3
  *
4
- * 参考 OpenClaw 的 tool-loop-detection 设计:
4
+ * 设计要点:
5
5
  * - 不限制工具调用次数(多步工作是正常的)
6
6
  * - 检测"相同调用 + 相同结果"的无进展重复
7
7
  * - 使用 hash(tool_name + params + result) 作为指纹
@@ -70,7 +70,11 @@ export type RunGuardMetricsEvent = {
70
70
  nominalTotalTokens: number;
71
71
  elapsedMs: number;
72
72
  consecutiveErrors: number;
73
+ /** 连续同一错误(名+参数+错误内容一致)——「卡住」的强信号 */
74
+ consecutiveIdenticalFailures?: number;
73
75
  consecutiveSameTool: number;
76
+ /** 连续相同调用(名+参数+结果一致)——无进展循环的强信号 */
77
+ consecutiveIdenticalCalls?: number;
74
78
  noopStreak: number;
75
79
  hasProgress: boolean;
76
80
  uniqueTools: string[];
@@ -25,6 +25,7 @@ import { BudgetPolicyEngine } from '../budget/budget.js';
25
25
  import { UsageLedger } from '../../governance/accounting/usage-ledger.js';
26
26
  import { nominalTotalTokens } from '@octopi-agent/core/types/turn.js';
27
27
  import { getRunScope } from '../run-scope.js';
28
+ import { resolveHitlDecision } from '../../governance/human-in-the-loop/decision-cache.js';
28
29
  export const DEFAULT_RELIABILITY_CONFIG = {
29
30
  planningRetry: {
30
31
  maxAttempts: 2,
@@ -133,29 +134,30 @@ function hasStructuredPlanningOnlyFormat(text) {
133
134
  }
134
135
  // ── high 风险确认 ──
135
136
  /**
136
- * high 风险人工确认
137
+ * high 风险人工确认(SEC-7 单模型)
137
138
  *
138
- * - 有 `harness.confirmHighRisk`:请求确认,用户拒绝/异常 → false
139
- * - 无审批通道:回退 reject(false),无人值守不放行
139
+ * - 有 `harness.confirmHighRisk`:查 HitlDecisionCache → 调钩子(返回 HitlDecision)
140
+ * - 无审批通道 / 异常 / deny:回退 reject(false),无人值守不放行
141
+ * - `approve_session` / `approve_always` 由引擎缓存,同 session/进程免再问
140
142
  */
141
143
  async function confirmHighRiskDecision(harness, toolCall, reason, severity) {
142
144
  const confirm = harness.confirmHighRisk;
143
145
  if (!confirm)
144
146
  return false;
145
- try {
146
- const scope = getRunScope();
147
- return await confirm({
147
+ const scope = getRunScope();
148
+ return resolveHitlDecision({
149
+ channel: 'high_risk',
150
+ key: toolCall.name,
151
+ sessionId: scope?.sessionId,
152
+ agentId: scope?.agentId,
153
+ ask: async () => await confirm({
148
154
  toolCall,
149
155
  reason,
150
156
  severity,
151
157
  sessionId: scope?.sessionId,
152
158
  agentId: scope?.agentId,
153
- });
154
- }
155
- catch {
156
- // 审批通道异常按拒绝处理(fail-safe);此处吞掉仅因异常不改变「不放行」结论
157
- return false;
158
- }
159
+ }),
160
+ });
159
161
  }
160
162
  // ── 核心包装函数 ──
161
163
  /**
@@ -224,13 +226,77 @@ export async function* runAgentWithReliability(context, config, harness, signal)
224
226
  role: 'user',
225
227
  content: state.wrapUp.userMessage,
226
228
  timestamp: Date.now(),
229
+ metadata: { source: 'engineHint' },
227
230
  });
228
231
  }
229
232
  // wrap-up 窗口内:允许只读工具,阻止写入工具
230
233
  // 简化实现:允许所有工具,让模型自行决策
231
234
  // 完整实现应检查工具类型(只读 vs 写入)
232
235
  }
233
- // SecurityGuard 检查
236
+ // Tool surface (untrusted degrade): strip egress/exec tools
237
+ if (harness.toolSurface === 'reduced') {
238
+ const { isToolAllowedOnSurface } = await import('../../extension/execution-environment/effect-policy.js');
239
+ if (!isToolAllowedOnSurface(ctx.toolCall.name, 'reduced')) {
240
+ const scope = getRunScope();
241
+ const reason = `tool_surface_reduced: "${ctx.toolCall.name}" is not allowed when untrusted is degraded`;
242
+ state.pendingSecurityEvents.push({
243
+ type: 'security_blocked',
244
+ timestamp: Date.now(),
245
+ data: {
246
+ sessionId: scope?.sessionId,
247
+ agentId: scope?.agentId,
248
+ reason,
249
+ toolName: ctx.toolCall.name,
250
+ action: 'reject',
251
+ severity: 'high',
252
+ violations: [
253
+ {
254
+ type: 'unauthorized_tool',
255
+ severity: 'high',
256
+ description: reason,
257
+ },
258
+ ],
259
+ },
260
+ });
261
+ return { block: true, reason, terminate: false };
262
+ }
263
+ }
264
+ // SEC-2: session toolRights ∩ agent ToolPolicy (narrow-only, deny wins).
265
+ // Read from RunScope (per-run); harness is shared across concurrent sessions.
266
+ {
267
+ const scope = getRunScope();
268
+ const sessionRights = scope?.toolRuntime?.sessionToolRights;
269
+ const agentPolicy = scope?.toolRuntime?.agentToolPolicy;
270
+ if (sessionRights || agentPolicy) {
271
+ const { isToolPermitted } = await import('../../governance/session-acl/tool-rights.js');
272
+ if (!isToolPermitted(ctx.toolCall.name, undefined, [
273
+ agentPolicy,
274
+ sessionRights,
275
+ ])) {
276
+ const reason = `tool_rights_denied: "${ctx.toolCall.name}" is not permitted for this session participant`;
277
+ state.pendingSecurityEvents.push({
278
+ type: 'security_blocked',
279
+ timestamp: Date.now(),
280
+ data: {
281
+ sessionId: scope?.sessionId,
282
+ agentId: scope?.agentId,
283
+ reason,
284
+ toolName: ctx.toolCall.name,
285
+ action: 'reject',
286
+ severity: 'high',
287
+ violations: [
288
+ {
289
+ type: 'unauthorized_tool',
290
+ severity: 'high',
291
+ description: reason,
292
+ },
293
+ ],
294
+ },
295
+ });
296
+ return { block: true, reason, terminate: false };
297
+ }
298
+ }
299
+ }
234
300
  if (harness.security) {
235
301
  const toolCheck = harness.security.checkToolCall(ctx.toolCall);
236
302
  if (!toolCheck.isClean) {
@@ -368,6 +434,7 @@ export async function* runAgentWithReliability(context, config, harness, signal)
368
434
  role: 'user',
369
435
  content: `[System: ${relConfig.planningRetry.steerInstruction}]`,
370
436
  timestamp: Date.now(),
437
+ metadata: { source: 'engineHint' },
371
438
  });
372
439
  state.planningOnlySteerInjected = true;
373
440
  }
@@ -386,6 +453,7 @@ export async function* runAgentWithReliability(context, config, harness, signal)
386
453
  role: 'user',
387
454
  content: `[System: ${relConfig.emptyResponseRetry.steerInstruction}]`,
388
455
  timestamp: Date.now(),
456
+ metadata: { source: 'engineHint' },
389
457
  });
390
458
  state.emptyResponseSteerInjected = true;
391
459
  }
@@ -406,12 +474,18 @@ export async function* runAgentWithReliability(context, config, harness, signal)
406
474
  role: 'user',
407
475
  content: '[System: Multiple tool calls produced no result. Please try a different approach.]',
408
476
  timestamp: Date.now(),
477
+ metadata: { source: 'engineHint' },
409
478
  });
410
479
  }
411
480
  else {
412
481
  // 超过阈值:标记停止 + 立即检查点
413
482
  state._noopLoopStop = true;
414
483
  state.forceCheckpoint = true;
484
+ // 停止必须可见:只置标志不发声时,用户看到的就是「跑着跑着没了」
485
+ state.runGuardStop = {
486
+ reason: `连续 ${state.consecutiveNoops} 次工具调用无任何返回(no-op 循环)`,
487
+ userMessage: `连续 ${state.consecutiveNoops} 次工具调用没有任何结果,判定为无效循环,本轮已停止。请换个做法或说明当前阻塞点。`,
488
+ };
415
489
  state.collector.noteExternalSignal({
416
490
  source: 'noop',
417
491
  level: 'critical',
@@ -425,7 +499,19 @@ export async function* runAgentWithReliability(context, config, harness, signal)
425
499
  state.consecutiveNoops = 0;
426
500
  }
427
501
  // 4. 工具循环检测
428
- if (hasToolCalls && relConfig.loopDetection.enabled !== false) {
502
+ const loopDetectionEnabled = relConfig.loopDetection.enabled !== false;
503
+ // 4a. 指标记录与 loopDetection 开关解耦:RunGuard 的 repeated/identical 判据
504
+ // 不能因为关掉 loopDetection 就永远为 0(否则 Guard 静默失效)。
505
+ for (const result of ctx.toolResults) {
506
+ const tc = ctx.message.toolCalls?.find(t => t.id === result.toolCallId);
507
+ state.collector.recordToolResult(result.name, !result.isError, !!result.noop, {
508
+ // 与旁路 loop 检测器同口径:arguments 缺失时归一为 {}
509
+ args: tc?.arguments ?? {},
510
+ result: result.isError ? undefined : result.content,
511
+ error: result.isError ? result.content : undefined,
512
+ });
513
+ }
514
+ if (hasToolCalls && loopDetectionEnabled) {
429
515
  // 记录工具调用
430
516
  for (const result of ctx.toolResults) {
431
517
  // 从 message.toolCalls 中找到对应的 toolCall
@@ -450,6 +536,11 @@ export async function* runAgentWithReliability(context, config, harness, signal)
450
536
  if (state.loopCriticalTriggered) {
451
537
  // 二次 critical:通过 shouldStopAfterTurn 停止
452
538
  state._loopCriticalTwice = true;
539
+ // 停止必须可见:与 RunGuard 走同一事件通道
540
+ state.runGuardStop = {
541
+ reason: `连续两轮检测到高危循环信号:${loopResult.message}`,
542
+ userMessage: '检测到重复的高危循环迹象,本轮已停止。请换个做法或说明当前阻塞点。',
543
+ };
453
544
  }
454
545
  else {
455
546
  state.loopCriticalTriggered = true;
@@ -457,6 +548,7 @@ export async function* runAgentWithReliability(context, config, harness, signal)
457
548
  role: 'user',
458
549
  content: `[System: ${loopResult.message} Stop calling tools and provide your final response based on the information gathered so far.]`,
459
550
  timestamp: Date.now(),
551
+ metadata: { source: 'engineHint' },
460
552
  });
461
553
  }
462
554
  }
@@ -465,14 +557,11 @@ export async function* runAgentWithReliability(context, config, harness, signal)
465
557
  role: 'user',
466
558
  content: `[System: ${loopResult.message}]`,
467
559
  timestamp: Date.now(),
560
+ metadata: { source: 'engineHint' },
468
561
  });
469
562
  }
470
563
  }
471
564
  }
472
- // 更新追踪指标
473
- for (const result of ctx.toolResults) {
474
- state.collector.recordToolResult(result.name, !result.isError, !!result.noop);
475
- }
476
565
  }
477
566
  // 5. RunGuard 检查点(周期 + 高危即时)
478
567
  if (harness.runGuard) {
@@ -900,6 +989,7 @@ function executeRecoveryActions(actions, messages) {
900
989
  role: 'user',
901
990
  content: `[System: ${removeCount} earlier messages omitted to fit context window.]`,
902
991
  timestamp: Date.now(),
992
+ metadata: { source: 'engineHint' },
903
993
  });
904
994
  }
905
995
  break;
@@ -920,6 +1010,7 @@ function executeRecoveryActions(actions, messages) {
920
1010
  role: 'user',
921
1011
  content: `[System: ${removed} recent messages cleared to recover from a stuck loop.]`,
922
1012
  timestamp: Date.now(),
1013
+ metadata: { source: 'engineHint' },
923
1014
  });
924
1015
  }
925
1016
  break;
@@ -929,6 +1020,7 @@ function executeRecoveryActions(actions, messages) {
929
1020
  role: 'user',
930
1021
  content: `[System: ${action.hint}]`,
931
1022
  timestamp: Date.now(),
1023
+ metadata: { source: 'engineHint' },
932
1024
  });
933
1025
  break;
934
1026
  }
@@ -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[];