@octopi-agent/engine 0.70.7 → 0.90.11

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 (390) 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 +81 -5
  6. package/dist/config-schema/context.d.ts +24 -5
  7. package/dist/config-schema/context.js +28 -1
  8. package/dist/config-schema/engine.d.ts +205 -13
  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 +93 -1
  12. package/dist/config-schema/models.d.ts +3 -3
  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 +13 -0
  18. package/dist/config-schema/shared.js +22 -0
  19. package/dist/config-schema/substrate.d.ts +2 -2
  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 +201 -8
  23. package/dist/config.js +105 -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 +50 -5
  31. package/dist/harness/agent/builder.js +189 -59
  32. package/dist/harness/agent/config-bridge.d.ts +33 -25
  33. package/dist/harness/agent/config-bridge.js +84 -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 +46 -0
  37. package/dist/harness/agent/tool-purpose.js +127 -0
  38. package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
  39. package/dist/harness/agent/wire-agent-builder.js +370 -0
  40. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.d.ts +11 -1
  41. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +11 -1
  42. package/dist/harness/collaboration/autonomous-subsystem/loader.d.ts +13 -0
  43. package/dist/harness/collaboration/autonomous-subsystem/loader.js +16 -1
  44. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +8 -1
  45. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -9
  46. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
  47. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
  48. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
  49. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
  50. package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
  51. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
  52. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
  53. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
  54. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
  55. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
  56. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
  57. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
  58. package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
  59. package/dist/harness/collaboration/delegation/child-run.js +241 -0
  60. package/dist/harness/collaboration/delegation/index.d.ts +26 -0
  61. package/dist/harness/collaboration/delegation/index.js +25 -0
  62. package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
  63. package/dist/harness/collaboration/delegation/notifier.js +84 -0
  64. package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
  65. package/dist/harness/collaboration/delegation/registry-types.js +61 -0
  66. package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
  67. package/dist/harness/collaboration/delegation/registry.js +220 -0
  68. package/dist/harness/collaboration/delegation/service.d.ts +249 -0
  69. package/dist/harness/collaboration/delegation/service.js +499 -0
  70. package/dist/harness/collaboration/delegation/store.d.ts +155 -0
  71. package/dist/harness/collaboration/delegation/store.js +271 -0
  72. package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
  73. package/dist/harness/collaboration/delegation/transport.js +61 -0
  74. package/dist/harness/collaboration/delegation/types.d.ts +231 -0
  75. package/dist/harness/collaboration/delegation/types.js +70 -0
  76. package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
  77. package/dist/harness/collaboration/delegation/wiring.js +145 -0
  78. package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
  79. package/dist/harness/collaboration/orchestration/index.js +11 -11
  80. package/dist/harness/context/assembler.d.ts +2 -2
  81. package/dist/harness/context/assembler.js +12 -7
  82. package/dist/harness/context/capabilities/compact/engine.js +80 -38
  83. package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
  84. package/dist/harness/context/capabilities/summary/registry.js +10 -0
  85. package/dist/harness/context/constitution/default-agents.md +230 -228
  86. package/dist/harness/context/default-context-engine.d.ts +101 -23
  87. package/dist/harness/context/default-context-engine.js +483 -172
  88. package/dist/harness/context/hybrid-compressor.d.ts +3 -3
  89. package/dist/harness/context/hybrid-compressor.js +18 -23
  90. package/dist/harness/context/index.d.ts +5 -1
  91. package/dist/harness/context/index.js +2 -0
  92. package/dist/harness/context/layer-snapshot.d.ts +4 -0
  93. package/dist/harness/context/layer-snapshot.js +30 -18
  94. package/dist/harness/context/layer-types.d.ts +85 -1
  95. package/dist/harness/context/layer-types.js +110 -4
  96. package/dist/harness/context/layers.d.ts +5 -2
  97. package/dist/harness/context/layers.js +11 -5
  98. package/dist/harness/context/llm-summarizer.d.ts +15 -1
  99. package/dist/harness/context/llm-summarizer.js +107 -56
  100. package/dist/harness/context/message-selector.js +6 -2
  101. package/dist/harness/context/root-instructions.d.ts +72 -0
  102. package/dist/harness/context/root-instructions.js +227 -0
  103. package/dist/harness/context/runtime-datetime.d.ts +34 -7
  104. package/dist/harness/context/runtime-datetime.js +66 -10
  105. package/dist/harness/context/smart-router.d.ts +1 -1
  106. package/dist/harness/context/smart-router.js +1 -1
  107. package/dist/harness/context/system-prompt-assembler.d.ts +30 -0
  108. package/dist/harness/context/system-prompt-assembler.js +73 -6
  109. package/dist/harness/context/token-constants.d.ts +2 -2
  110. package/dist/harness/context/token-constants.js +2 -2
  111. package/dist/harness/context/token-estimate-fns.d.ts +1 -3
  112. package/dist/harness/context/token-estimate-fns.js +2 -4
  113. package/dist/harness/context/token-estimator.d.ts +1 -1
  114. package/dist/harness/context/token-estimator.js +14 -6
  115. package/dist/harness/context/tool-result-aging.d.ts +140 -0
  116. package/dist/harness/context/tool-result-aging.js +331 -0
  117. package/dist/harness/context/tool-result-body.d.ts +10 -0
  118. package/dist/harness/context/tool-result-body.js +27 -0
  119. package/dist/harness/context/turn-envelope.d.ts +123 -0
  120. package/dist/harness/context/turn-envelope.js +188 -0
  121. package/dist/harness/context/types.d.ts +35 -47
  122. package/dist/harness/extension/execution-environment/effect-policy.d.ts +258 -0
  123. package/dist/harness/extension/execution-environment/effect-policy.js +358 -0
  124. package/dist/harness/extension/execution-environment/index.d.ts +18 -2
  125. package/dist/harness/extension/execution-environment/index.js +11 -2
  126. package/dist/harness/extension/execution-environment/isolation.js +5 -1
  127. package/dist/harness/extension/execution-environment/memory-undo.d.ts +101 -0
  128. package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
  129. package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
  130. package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
  131. package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
  132. package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
  133. package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
  134. package/dist/harness/extension/execution-environment/sandbox.js +521 -51
  135. package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
  136. package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
  137. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
  138. package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
  139. package/dist/harness/extension/execution-environment/types.d.ts +67 -39
  140. package/dist/harness/extension/execution-environment/types.js +2 -2
  141. package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
  142. package/dist/harness/extension/execution-environment/undo-log.js +627 -0
  143. package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
  144. package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
  145. package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +1 -1
  146. package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +9 -0
  147. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
  148. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
  149. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
  150. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
  151. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
  152. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
  153. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
  154. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
  155. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
  156. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
  157. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
  158. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
  159. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
  160. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
  161. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
  162. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
  163. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
  164. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +51 -0
  165. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +153 -0
  166. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
  167. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
  168. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +277 -81
  169. package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
  170. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
  171. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
  172. package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
  173. package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
  174. package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
  175. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
  176. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
  177. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
  178. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
  179. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +241 -70
  180. package/dist/harness/extension/plugin-ecosystem/tools/git-runner.d.ts +31 -0
  181. package/dist/harness/extension/plugin-ecosystem/tools/git-runner.js +104 -0
  182. package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.d.ts +111 -0
  183. package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.js +197 -0
  184. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
  185. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +463 -0
  186. package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
  187. package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
  188. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +6 -0
  189. package/dist/harness/extension/plugin-ecosystem/tools/index.js +4 -0
  190. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +25 -1
  192. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
  193. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
  194. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
  195. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
  196. package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
  197. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
  198. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
  199. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
  200. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
  201. package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
  202. package/dist/harness/governance/credentials/index.d.ts +1 -1
  203. package/dist/harness/governance/credentials/store.d.ts +16 -4
  204. package/dist/harness/governance/credentials/store.js +33 -6
  205. package/dist/harness/governance/credentials/types.d.ts +11 -0
  206. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
  207. package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
  208. package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
  209. package/dist/harness/governance/human-in-the-loop/index.js +3 -3
  210. package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
  211. package/dist/harness/governance/human-in-the-loop/types.js +6 -2
  212. package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
  213. package/dist/harness/governance/security/capability-enforcer.js +31 -8
  214. package/dist/harness/governance/security/degradation.js +5 -7
  215. package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
  216. package/dist/harness/governance/security/risk-evaluator.js +4 -82
  217. package/dist/harness/governance/security/temp-path.d.ts +41 -0
  218. package/dist/harness/governance/security/temp-path.js +117 -0
  219. package/dist/harness/governance/session-acl/index.d.ts +1 -0
  220. package/dist/harness/governance/session-acl/index.js +1 -0
  221. package/dist/harness/governance/session-acl/rights.d.ts +12 -0
  222. package/dist/harness/governance/session-acl/rights.js +89 -7
  223. package/dist/harness/governance/session-acl/seed-roles.js +9 -1
  224. package/dist/harness/governance/session-acl/service.js +21 -29
  225. package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
  226. package/dist/harness/governance/session-acl/tool-rights.js +238 -0
  227. package/dist/harness/governance/session-acl/types.d.ts +22 -0
  228. package/dist/harness/index.d.ts +16 -12
  229. package/dist/harness/index.js +10 -6
  230. package/dist/harness/knowledge/file-identity.d.ts +8 -0
  231. package/dist/harness/knowledge/file-identity.js +26 -1
  232. package/dist/harness/knowledge/file-index-store.js +11 -11
  233. package/dist/harness/knowledge/grounding.d.ts +2 -1
  234. package/dist/harness/knowledge/grounding.js +8 -5
  235. package/dist/harness/knowledge/index-store.d.ts +31 -4
  236. package/dist/harness/knowledge/index-store.js +121 -39
  237. package/dist/harness/knowledge/index.d.ts +2 -2
  238. package/dist/harness/knowledge/index.js +1 -1
  239. package/dist/harness/knowledge/ingest.d.ts +115 -115
  240. package/dist/harness/knowledge/ingest.js +154 -151
  241. package/dist/harness/knowledge/job-control-state.js +4 -4
  242. package/dist/harness/knowledge/job-control.js +11 -11
  243. package/dist/harness/knowledge/knowledge-serve-child.js +1 -1
  244. package/dist/harness/knowledge/membership-store.js +11 -11
  245. package/dist/harness/knowledge/network-guard.d.ts +61 -4
  246. package/dist/harness/knowledge/network-guard.js +390 -113
  247. package/dist/harness/knowledge/purge.js +4 -1
  248. package/dist/harness/knowledge/query-service.js +3 -3
  249. package/dist/harness/knowledge/writer-service.d.ts +2 -0
  250. package/dist/harness/knowledge/writer-service.js +14 -13
  251. package/dist/harness/memory/backfill-coverage.js +3 -1
  252. package/dist/harness/memory/backfill-trigger.d.ts +2 -2
  253. package/dist/harness/memory/backfill-trigger.js +4 -4
  254. package/dist/harness/memory/index.d.ts +1 -0
  255. package/dist/harness/memory/index.js +1 -0
  256. package/dist/harness/memory/sqlite/agent-db.js +2 -0
  257. package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
  258. package/dist/harness/memory/sqlite/memory-store.js +14 -4
  259. package/dist/harness/memory/sqlite/wisdom-store.js +9 -9
  260. package/dist/harness/memory/store.d.ts +1 -0
  261. package/dist/harness/memory/store.js +3 -0
  262. package/dist/harness/memory/time-format.d.ts +28 -0
  263. package/dist/harness/memory/time-format.js +52 -0
  264. package/dist/harness/memory/types.d.ts +12 -0
  265. package/dist/harness/observability/observer/hub.js +53 -2
  266. package/dist/harness/observability/observer/index.d.ts +2 -2
  267. package/dist/harness/observability/observer/index.js +1 -1
  268. package/dist/harness/observability/observer/types.d.ts +80 -0
  269. package/dist/harness/observability/observer/types.js +118 -9
  270. package/dist/harness/run/agent/agent.d.ts +18 -0
  271. package/dist/harness/run/agent/agent.js +26 -0
  272. package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
  273. package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
  274. package/dist/harness/run/reliability/harness-events.d.ts +4 -0
  275. package/dist/harness/run/reliability/run-agent.js +110 -18
  276. package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
  277. package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
  278. package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
  279. package/dist/harness/run/run-guard/default-run-guard.js +104 -44
  280. package/dist/harness/run/run-scope.d.ts +52 -0
  281. package/dist/harness/run/runner.d.ts +117 -16
  282. package/dist/harness/run/runner.js +668 -157
  283. package/dist/harness/session/attachments/llm-intent.js +17 -17
  284. package/dist/harness/session/history/port.js +16 -5
  285. package/dist/harness/session/in-memory-store.d.ts +6 -0
  286. package/dist/harness/session/in-memory-store.js +55 -3
  287. package/dist/harness/session/schedules/index.d.ts +10 -0
  288. package/dist/harness/session/schedules/index.js +10 -0
  289. package/dist/harness/session/schedules/render.d.ts +13 -0
  290. package/dist/harness/session/schedules/render.js +63 -0
  291. package/dist/harness/session/schedules/service.d.ts +179 -0
  292. package/dist/harness/session/schedules/service.js +695 -0
  293. package/dist/harness/session/schedules/store.d.ts +119 -0
  294. package/dist/harness/session/schedules/store.js +323 -0
  295. package/dist/harness/session/schedules/tools.d.ts +39 -0
  296. package/dist/harness/session/schedules/tools.js +442 -0
  297. package/dist/harness/session/schedules/types.d.ts +104 -0
  298. package/dist/harness/session/schedules/types.js +97 -0
  299. package/dist/harness/session/tasks/tools.js +22 -0
  300. package/dist/harness/session/title.js +25 -9
  301. package/dist/harness/session/types.d.ts +35 -0
  302. package/dist/harness/shared/events/agent-event-map.d.ts +39 -0
  303. package/dist/harness/shared/events/agent-event-map.js +2 -0
  304. package/dist/harness/shared/types/agent-definition.d.ts +23 -0
  305. package/dist/index.d.ts +25 -9
  306. package/dist/index.js +11 -2
  307. package/dist/integration/observability/run-telemetry.d.ts +8 -0
  308. package/dist/integration/observability/run-telemetry.js +31 -8
  309. package/dist/integration/observability/trace-collector.js +26 -4
  310. package/dist/integration/observability/trace-events.d.ts +1 -0
  311. package/dist/integration/observability/trace-events.js +2 -0
  312. package/dist/integration/observability/trace-logger.js +27 -17
  313. package/dist/integration/providers/anthropic.d.ts +10 -0
  314. package/dist/integration/providers/anthropic.js +44 -1
  315. package/dist/integration/providers/openai.d.ts +10 -0
  316. package/dist/integration/providers/openai.js +58 -2
  317. package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
  318. package/dist/integration/providers/wire-dump-diff.js +351 -0
  319. package/dist/integration/providers/wire-dump.d.ts +178 -0
  320. package/dist/integration/providers/wire-dump.js +396 -0
  321. package/dist/integration/storage/jsonl.d.ts +29 -0
  322. package/dist/integration/storage/jsonl.js +243 -41
  323. package/dist/integration/storage/session-index.js +63 -8
  324. package/dist/paths.d.ts +19 -0
  325. package/dist/paths.js +38 -1
  326. package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -43
  327. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -50
  328. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -6
  329. package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -54
  330. package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
  331. package/dist/subsystems/safety-guard/config.yaml +3 -1
  332. package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -50
  333. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -42
  334. package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -54
  335. package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -55
  336. package/package.json +115 -115
  337. package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
  338. package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
  339. package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
  340. package/dist/harness/collaboration/multi-agent/index.js +0 -15
  341. package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
  342. package/dist/harness/collaboration/multi-agent/process.js +0 -256
  343. package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
  344. package/dist/harness/collaboration/multi-agent/registry.js +0 -137
  345. package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
  346. package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
  347. package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
  348. package/dist/harness/collaboration/multi-agent/types.js +0 -15
  349. package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
  350. package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
  351. package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
  352. package/dist/harness/collaboration/orchestration/async-task.js +0 -359
  353. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
  354. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
  355. package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
  356. package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
  357. package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
  358. package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
  359. package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
  360. package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
  361. package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
  362. package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
  363. package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
  364. package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
  365. package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
  366. package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
  367. package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
  368. package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
  369. package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
  370. package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
  371. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
  372. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
  373. package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
  374. package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
  375. package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
  376. package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
  377. package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
  378. package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
  379. package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
  380. package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
  381. package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
  382. package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
  383. package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
  384. package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
  385. package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
  386. package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
  387. package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
  388. package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
  389. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
  390. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.js +0 -0
@@ -108,6 +108,32 @@ export declare function isChannelEnabled(cfg: ResolvedObserverConfig, channel: O
108
108
  */
109
109
  export declare function shouldCaptureMessageFullText(cfg: ResolvedObserverConfig): boolean;
110
110
  export type RunMessageViewRole = 'user' | 'assistant' | 'system' | 'tool';
111
+ /**
112
+ * Run message 归因(G2/G4):区分用户真实发言与引擎载体机器插槽。
113
+ *
114
+ * 机器插槽(turn 信封槽位 / 载体消息 / 摘要 / 引擎提示 / turn 闭标)**不是用户发言**——
115
+ * 本字段是检查器归因的唯一真源,UI 只渲染不自行判定。
116
+ */
117
+ export interface RunMessageAttribution {
118
+ /** 发言方:human=用户真实发言(含 turn 信封内的用户原文);engine=机器生成;llm=模型输出;tool=工具结果 */
119
+ speaker: 'human' | 'engine' | 'llm' | 'tool';
120
+ /** 细类 */
121
+ kind: 'user_speech' | 'turn_envelope' | 'carrier' | 'context_summary' | 'engine_hint' | 'turn_end' | 'hosted_system' | 'system' | 'assistant' | 'tool';
122
+ /** 信封/闭标的 turn id(可解析出时) */
123
+ turnId?: string;
124
+ /** `metadata.source` 原值(carrier / summary / hint 等溯源) */
125
+ source?: string;
126
+ /** turn_envelope 内嵌槽位(机器生成块);摘要视图只带 chars,正文由 attachFullContent 补 */
127
+ slots?: Array<{
128
+ tag: string;
129
+ chars: number;
130
+ body?: string;
131
+ }>;
132
+ /** turn_envelope 中真实用户正文字符数(无 user_message 块 = 0) */
133
+ userChars?: number;
134
+ /** turn_envelope 是否含 `<user_message>` 块(false = 信封不完整,UI 应标注而非把整封当用户原文) */
135
+ hasUserMessage?: boolean;
136
+ }
111
137
  /** 单条 Run message 的 UI 视图 */
112
138
  export interface RunMessageView {
113
139
  index: number;
@@ -120,6 +146,8 @@ export interface RunMessageView {
120
146
  metadata?: Record<string, unknown>;
121
147
  /** 中栏对话是否会隐藏本条 */
122
148
  hiddenFromChat?: boolean;
149
+ /** 归因(机器插槽 vs 用户发言;见 RunMessageAttribution) */
150
+ attribution?: RunMessageAttribution;
123
151
  contentChars?: number;
124
152
  /** 摘要模式下的截断预览 */
125
153
  contentPreview?: string;
@@ -129,6 +157,8 @@ export type RunMessagesView = 'workspace' | 'llm';
129
157
  export interface RunMessagesSummary {
130
158
  count: number;
131
159
  byRole: Record<string, number>;
160
+ /** 按归因 kind 计数(RunMessageAttribution.kind)——机器插槽与用户发言在汇总层即分开 */
161
+ byKind: Record<string, number>;
132
162
  systemPromptCount: number;
133
163
  contextSummaryCount: number;
134
164
  hiddenFromChatCount: number;
@@ -145,7 +175,11 @@ export interface RunGuardMetricsView {
145
175
  nominalTotalTokens: number;
146
176
  elapsedMs: number;
147
177
  consecutiveErrors: number;
178
+ /** 连续同一错误(名+参数+错误内容一致)——「卡住」的强信号 */
179
+ consecutiveIdenticalFailures?: number;
148
180
  consecutiveSameTool: number;
181
+ /** 连续相同调用(名+参数+结果一致)——无进展循环的强信号 */
182
+ consecutiveIdenticalCalls?: number;
149
183
  noopStreak: number;
150
184
  hasProgress: boolean;
151
185
  uniqueTools: string[];
@@ -230,6 +264,29 @@ export interface RunTimelineEventView {
230
264
  durationMs?: number;
231
265
  reason?: string;
232
266
  usage?: import('@octopi-agent/core/types/turn.js').TokenUsage;
267
+ /** F3 计时段(turn.end 的 LLM 计时 / run.timing 的 wait/build/run_end 分段) */
268
+ timing?: {
269
+ stage?: string;
270
+ waitMs?: number;
271
+ buildMs?: number;
272
+ durMs?: number;
273
+ /** LLM 调用总耗时(turn.end.llmTiming) */
274
+ durationMs?: number;
275
+ /** LLM 调用标识(可关联 model.call.end 行) */
276
+ callId?: string;
277
+ ttftMs?: number;
278
+ reqChars?: number;
279
+ toolChars?: number;
280
+ outChars?: number;
281
+ finishReason?: string;
282
+ /** run.timing=run_end 附带 */
283
+ loopEnd?: string;
284
+ stopReason?: string;
285
+ /** run.timing=context_ready 附带(sysChars 为稳定前缀规模,E8 后不含易变快照) */
286
+ msgs?: number;
287
+ sysChars?: number;
288
+ groundingTokens?: number;
289
+ };
233
290
  }
234
291
  export interface RunLifecycleView {
235
292
  startedAt?: number;
@@ -288,6 +345,13 @@ export interface RunToolEffectView {
288
345
  errors: number;
289
346
  lastDurationMs?: number;
290
347
  }>;
348
+ /** L3 效应账本(§5.6) */
349
+ undo?: {
350
+ entries: number;
351
+ truncated?: boolean;
352
+ notReversedReason?: string;
353
+ notReversedPaths?: number;
354
+ };
291
355
  notes?: string[];
292
356
  }
293
357
  /** 单次 Run 的观测投影(WS/REST 摘要;全文经 messages REST) */
@@ -319,6 +383,22 @@ export interface RunObservatorySnapshot {
319
383
  webPanel: boolean;
320
384
  };
321
385
  }
386
+ /**
387
+ * Run message 归因(G2/G4 唯一判定处)。
388
+ *
389
+ * 判定次序:**source 优先、内容兜底**——
390
+ * ① role 二值(assistant/tool)→ ② 引擎载体 source(turnEnd / 载体插槽 / contextSummary / engineHint,
391
+ * 语义真源 `harness/context/layer-types.ts` ENGINE_CARRIER_SOURCES)→ ③ system role →
392
+ * ④ 无 source + user role + 正文以信封开标签起头 = turn_envelope → ⑤ 其余 user_speech。
393
+ *
394
+ * source 优先是审计面的可靠性要求:载体消息正文来自不可信语料(知识/grounding/附件),
395
+ * 含信封字面量也不得被内容嗅探抢走归因(否则机器插槽挂上「用户发言」徽章)。
396
+ * turn_end 的内容兜底仅作 legacy 降级:无 source 且整条正文就是闭标形状才认。
397
+ *
398
+ * @param msg - 消息(role/content/metadata)
399
+ * @returns 归因
400
+ */
401
+ export declare function attributeRunMessage(msg: Pick<Message, 'role' | 'content' | 'metadata'>): RunMessageAttribution;
322
402
  /** message 摘要统计 */
323
403
  export declare function summarizeMessages(messages: Message[], opts?: {
324
404
  maxPreviewChars?: number;
@@ -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[];