@octopi-agent/engine 0.55.0

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 (705) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +7 -0
  3. package/README.md +26 -0
  4. package/dist/builtin-model-info.d.ts +30 -0
  5. package/dist/builtin-model-info.js +118 -0
  6. package/dist/config-schema/agent.d.ts +72 -0
  7. package/dist/config-schema/agent.js +38 -0
  8. package/dist/config-schema/context.d.ts +122 -0
  9. package/dist/config-schema/context.js +100 -0
  10. package/dist/config-schema/engine.d.ts +665 -0
  11. package/dist/config-schema/engine.js +55 -0
  12. package/dist/config-schema/governance.d.ts +81 -0
  13. package/dist/config-schema/governance.js +55 -0
  14. package/dist/config-schema/models.d.ts +159 -0
  15. package/dist/config-schema/models.js +92 -0
  16. package/dist/config-schema/observability.d.ts +57 -0
  17. package/dist/config-schema/observability.js +59 -0
  18. package/dist/config-schema/run.d.ts +102 -0
  19. package/dist/config-schema/run.js +99 -0
  20. package/dist/config-schema/shared.d.ts +54 -0
  21. package/dist/config-schema/shared.js +43 -0
  22. package/dist/config-schema/substrate.d.ts +156 -0
  23. package/dist/config-schema/substrate.js +191 -0
  24. package/dist/config-schema/subsystems.d.ts +11 -0
  25. package/dist/config-schema/subsystems.js +13 -0
  26. package/dist/config-schema/web-search.d.ts +32 -0
  27. package/dist/config-schema/web-search.js +38 -0
  28. package/dist/config.d.ts +840 -0
  29. package/dist/config.js +161 -0
  30. package/dist/harness/activation/coalesce.d.ts +38 -0
  31. package/dist/harness/activation/coalesce.js +80 -0
  32. package/dist/harness/activation/compiler.d.ts +15 -0
  33. package/dist/harness/activation/compiler.js +136 -0
  34. package/dist/harness/activation/dispatcher.d.ts +19 -0
  35. package/dist/harness/activation/dispatcher.js +31 -0
  36. package/dist/harness/activation/event-source-types.d.ts +63 -0
  37. package/dist/harness/activation/event-source-types.js +13 -0
  38. package/dist/harness/activation/index.d.ts +20 -0
  39. package/dist/harness/activation/index.js +14 -0
  40. package/dist/harness/activation/router.d.ts +16 -0
  41. package/dist/harness/activation/router.js +28 -0
  42. package/dist/harness/activation/runtime.d.ts +78 -0
  43. package/dist/harness/activation/runtime.js +310 -0
  44. package/dist/harness/activation/sources/agent-signal.d.ts +34 -0
  45. package/dist/harness/activation/sources/agent-signal.js +93 -0
  46. package/dist/harness/activation/sources/escalate-bridge.d.ts +43 -0
  47. package/dist/harness/activation/sources/escalate-bridge.js +85 -0
  48. package/dist/harness/activation/sources/index.d.ts +6 -0
  49. package/dist/harness/activation/sources/index.js +3 -0
  50. package/dist/harness/activation/sources/schedule.d.ts +43 -0
  51. package/dist/harness/activation/sources/schedule.js +102 -0
  52. package/dist/harness/activation/types.d.ts +166 -0
  53. package/dist/harness/activation/types.js +15 -0
  54. package/dist/harness/agent/builder.d.ts +456 -0
  55. package/dist/harness/agent/builder.js +1414 -0
  56. package/dist/harness/agent/config-bridge.d.ts +80 -0
  57. package/dist/harness/agent/config-bridge.js +424 -0
  58. package/dist/harness/agent/index.d.ts +15 -0
  59. package/dist/harness/agent/index.js +12 -0
  60. package/dist/harness/agent/persona.d.ts +52 -0
  61. package/dist/harness/agent/persona.js +166 -0
  62. package/dist/harness/collaboration/autonomous-subsystem/audit/index.d.ts +4 -0
  63. package/dist/harness/collaboration/autonomous-subsystem/audit/index.js +2 -0
  64. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.d.ts +18 -0
  65. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.js +83 -0
  66. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.d.ts +36 -0
  67. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.js +54 -0
  68. package/dist/harness/collaboration/autonomous-subsystem/boundary/index.d.ts +2 -0
  69. package/dist/harness/collaboration/autonomous-subsystem/boundary/index.js +1 -0
  70. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.d.ts +24 -0
  71. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +142 -0
  72. package/dist/harness/collaboration/autonomous-subsystem/errors.d.ts +8 -0
  73. package/dist/harness/collaboration/autonomous-subsystem/errors.js +11 -0
  74. package/dist/harness/collaboration/autonomous-subsystem/index.d.ts +25 -0
  75. package/dist/harness/collaboration/autonomous-subsystem/index.js +28 -0
  76. package/dist/harness/collaboration/autonomous-subsystem/loader.d.ts +34 -0
  77. package/dist/harness/collaboration/autonomous-subsystem/loader.js +368 -0
  78. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +131 -0
  79. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +531 -0
  80. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +116 -0
  81. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +551 -0
  82. package/dist/harness/collaboration/autonomous-subsystem/sense/index.d.ts +5 -0
  83. package/dist/harness/collaboration/autonomous-subsystem/sense/index.js +3 -0
  84. package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.d.ts +13 -0
  85. package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.js +128 -0
  86. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +46 -0
  87. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +57 -0
  88. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +48 -0
  89. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +108 -0
  90. package/dist/harness/collaboration/autonomous-subsystem/session/index.d.ts +2 -0
  91. package/dist/harness/collaboration/autonomous-subsystem/session/index.js +1 -0
  92. package/dist/harness/collaboration/autonomous-subsystem/session/manager.d.ts +26 -0
  93. package/dist/harness/collaboration/autonomous-subsystem/session/manager.js +78 -0
  94. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.d.ts +110 -0
  95. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.js +190 -0
  96. package/dist/harness/collaboration/autonomous-subsystem/signal/index.d.ts +2 -0
  97. package/dist/harness/collaboration/autonomous-subsystem/signal/index.js +1 -0
  98. package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +107 -0
  99. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +405 -0
  100. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +6 -0
  101. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +3 -0
  102. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +65 -0
  103. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +116 -0
  104. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +64 -0
  105. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +89 -0
  106. package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +559 -0
  107. package/dist/harness/collaboration/autonomous-subsystem/types.js +21 -0
  108. package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +144 -0
  109. package/dist/harness/collaboration/multi-agent/agent-registry-types.js +25 -0
  110. package/dist/harness/collaboration/multi-agent/index.d.ts +17 -0
  111. package/dist/harness/collaboration/multi-agent/index.js +15 -0
  112. package/dist/harness/collaboration/multi-agent/message-channel-types.d.ts +69 -0
  113. package/dist/harness/collaboration/multi-agent/message-channel-types.js +16 -0
  114. package/dist/harness/collaboration/multi-agent/process.d.ts +167 -0
  115. package/dist/harness/collaboration/multi-agent/process.js +256 -0
  116. package/dist/harness/collaboration/multi-agent/registry.d.ts +36 -0
  117. package/dist/harness/collaboration/multi-agent/registry.js +137 -0
  118. package/dist/harness/collaboration/multi-agent/swarm.d.ts +135 -0
  119. package/dist/harness/collaboration/multi-agent/swarm.js +317 -0
  120. package/dist/harness/collaboration/multi-agent/types.d.ts +66 -0
  121. package/dist/harness/collaboration/multi-agent/types.js +15 -0
  122. package/dist/harness/collaboration/orchestration/async-task-store.d.ts +107 -0
  123. package/dist/harness/collaboration/orchestration/async-task-store.js +12 -0
  124. package/dist/harness/collaboration/orchestration/async-task.d.ts +156 -0
  125. package/dist/harness/collaboration/orchestration/async-task.js +359 -0
  126. package/dist/harness/collaboration/orchestration/cognitive-loop.d.ts +93 -0
  127. package/dist/harness/collaboration/orchestration/cognitive-loop.js +6 -0
  128. package/dist/harness/collaboration/orchestration/index.d.ts +19 -0
  129. package/dist/harness/collaboration/orchestration/index.js +16 -0
  130. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +47 -0
  131. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +61 -0
  132. package/dist/harness/collaboration/orchestration/planner/index.d.ts +9 -0
  133. package/dist/harness/collaboration/orchestration/planner/index.js +6 -0
  134. package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +54 -0
  135. package/dist/harness/collaboration/orchestration/planner/llm-planner.js +167 -0
  136. package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +85 -0
  137. package/dist/harness/collaboration/orchestration/planner/rule-planner.js +175 -0
  138. package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +21 -0
  139. package/dist/harness/collaboration/orchestration/quality/classifier.js +235 -0
  140. package/dist/harness/collaboration/orchestration/quality/gate.d.ts +29 -0
  141. package/dist/harness/collaboration/orchestration/quality/gate.js +409 -0
  142. package/dist/harness/collaboration/orchestration/quality/index.d.ts +9 -0
  143. package/dist/harness/collaboration/orchestration/quality/index.js +8 -0
  144. package/dist/harness/collaboration/orchestration/quality/types.d.ts +159 -0
  145. package/dist/harness/collaboration/orchestration/quality/types.js +33 -0
  146. package/dist/harness/collaboration/orchestration/reflector/index.d.ts +5 -0
  147. package/dist/harness/collaboration/orchestration/reflector/index.js +4 -0
  148. package/dist/harness/collaboration/orchestration/reflector/llm-reflector.d.ts +41 -0
  149. package/dist/harness/collaboration/orchestration/reflector/llm-reflector.js +142 -0
  150. package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +5 -0
  151. package/dist/harness/collaboration/orchestration/scheduler/index.js +4 -0
  152. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +143 -0
  153. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +297 -0
  154. package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +12 -0
  155. package/dist/harness/collaboration/orchestration/strategy/classifier.js +81 -0
  156. package/dist/harness/collaboration/orchestration/strategy/index.d.ts +3 -0
  157. package/dist/harness/collaboration/orchestration/strategy/index.js +2 -0
  158. package/dist/harness/collaboration/orchestration/strategy/router.d.ts +28 -0
  159. package/dist/harness/collaboration/orchestration/strategy/router.js +105 -0
  160. package/dist/harness/collaboration/orchestration/strategy/types.d.ts +49 -0
  161. package/dist/harness/collaboration/orchestration/strategy/types.js +4 -0
  162. package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +86 -0
  163. package/dist/harness/collaboration/orchestration/workflow/engine.js +298 -0
  164. package/dist/harness/collaboration/orchestration/workflow/index.d.ts +9 -0
  165. package/dist/harness/collaboration/orchestration/workflow/index.js +7 -0
  166. package/dist/harness/collaboration/orchestration/workflow/types.d.ts +143 -0
  167. package/dist/harness/collaboration/orchestration/workflow/types.js +7 -0
  168. package/dist/harness/context/assembler.d.ts +74 -0
  169. package/dist/harness/context/assembler.js +315 -0
  170. package/dist/harness/context/budget-allocator.d.ts +41 -0
  171. package/dist/harness/context/budget-allocator.js +80 -0
  172. package/dist/harness/context/capabilities/compact/engine.d.ts +15 -0
  173. package/dist/harness/context/capabilities/compact/engine.js +320 -0
  174. package/dist/harness/context/capabilities/compact/index.d.ts +7 -0
  175. package/dist/harness/context/capabilities/compact/index.js +6 -0
  176. package/dist/harness/context/capabilities/compact/types.d.ts +78 -0
  177. package/dist/harness/context/capabilities/compact/types.js +6 -0
  178. package/dist/harness/context/capabilities/index.d.ts +10 -0
  179. package/dist/harness/context/capabilities/index.js +10 -0
  180. package/dist/harness/context/capabilities/summary/budget.d.ts +23 -0
  181. package/dist/harness/context/capabilities/summary/budget.js +26 -0
  182. package/dist/harness/context/capabilities/summary/executor.d.ts +37 -0
  183. package/dist/harness/context/capabilities/summary/executor.js +189 -0
  184. package/dist/harness/context/capabilities/summary/gate.d.ts +43 -0
  185. package/dist/harness/context/capabilities/summary/gate.js +69 -0
  186. package/dist/harness/context/capabilities/summary/index.d.ts +17 -0
  187. package/dist/harness/context/capabilities/summary/index.js +15 -0
  188. package/dist/harness/context/capabilities/summary/memory-cache.d.ts +16 -0
  189. package/dist/harness/context/capabilities/summary/memory-cache.js +42 -0
  190. package/dist/harness/context/capabilities/summary/oversized.d.ts +51 -0
  191. package/dist/harness/context/capabilities/summary/oversized.js +80 -0
  192. package/dist/harness/context/capabilities/summary/policies.d.ts +12 -0
  193. package/dist/harness/context/capabilities/summary/policies.js +139 -0
  194. package/dist/harness/context/capabilities/summary/port.d.ts +29 -0
  195. package/dist/harness/context/capabilities/summary/port.js +124 -0
  196. package/dist/harness/context/capabilities/summary/registry.d.ts +50 -0
  197. package/dist/harness/context/capabilities/summary/registry.js +182 -0
  198. package/dist/harness/context/capabilities/summary/resolver.d.ts +35 -0
  199. package/dist/harness/context/capabilities/summary/resolver.js +145 -0
  200. package/dist/harness/context/capabilities/summary/structured.d.ts +35 -0
  201. package/dist/harness/context/capabilities/summary/structured.js +163 -0
  202. package/dist/harness/context/capabilities/summary/tool-binding.d.ts +86 -0
  203. package/dist/harness/context/capabilities/summary/tool-binding.js +166 -0
  204. package/dist/harness/context/capabilities/summary/types.d.ts +171 -0
  205. package/dist/harness/context/capabilities/summary/types.js +6 -0
  206. package/dist/harness/context/compact-key.d.ts +13 -0
  207. package/dist/harness/context/compact-key.js +17 -0
  208. package/dist/harness/context/constitution/default-agents.md +227 -0
  209. package/dist/harness/context/constitution/load-constitution.d.ts +30 -0
  210. package/dist/harness/context/constitution/load-constitution.js +66 -0
  211. package/dist/harness/context/default-context-engine.d.ts +171 -0
  212. package/dist/harness/context/default-context-engine.js +836 -0
  213. package/dist/harness/context/hybrid-compressor.d.ts +41 -0
  214. package/dist/harness/context/hybrid-compressor.js +158 -0
  215. package/dist/harness/context/index.d.ts +26 -0
  216. package/dist/harness/context/index.js +17 -0
  217. package/dist/harness/context/layer-health.d.ts +58 -0
  218. package/dist/harness/context/layer-health.js +160 -0
  219. package/dist/harness/context/layer-snapshot.d.ts +69 -0
  220. package/dist/harness/context/layer-snapshot.js +133 -0
  221. package/dist/harness/context/layer-types.d.ts +184 -0
  222. package/dist/harness/context/layer-types.js +79 -0
  223. package/dist/harness/context/layers.d.ts +146 -0
  224. package/dist/harness/context/layers.js +371 -0
  225. package/dist/harness/context/llm-summarizer.d.ts +38 -0
  226. package/dist/harness/context/llm-summarizer.js +220 -0
  227. package/dist/harness/context/message-selector.d.ts +44 -0
  228. package/dist/harness/context/message-selector.js +180 -0
  229. package/dist/harness/context/runtime-datetime.d.ts +49 -0
  230. package/dist/harness/context/runtime-datetime.js +74 -0
  231. package/dist/harness/context/smart-router.d.ts +75 -0
  232. package/dist/harness/context/smart-router.js +118 -0
  233. package/dist/harness/context/summarize.d.ts +39 -0
  234. package/dist/harness/context/summarize.js +50 -0
  235. package/dist/harness/context/system-prompt-assembler.d.ts +56 -0
  236. package/dist/harness/context/system-prompt-assembler.js +122 -0
  237. package/dist/harness/context/token-constants.d.ts +24 -0
  238. package/dist/harness/context/token-constants.js +27 -0
  239. package/dist/harness/context/token-estimate-fns.d.ts +70 -0
  240. package/dist/harness/context/token-estimate-fns.js +117 -0
  241. package/dist/harness/context/token-estimator.d.ts +63 -0
  242. package/dist/harness/context/token-estimator.js +126 -0
  243. package/dist/harness/context/truncate-compressor.d.ts +28 -0
  244. package/dist/harness/context/truncate-compressor.js +100 -0
  245. package/dist/harness/context/types.d.ts +316 -0
  246. package/dist/harness/context/types.js +9 -0
  247. package/dist/harness/extension/execution-environment/index.d.ts +10 -0
  248. package/dist/harness/extension/execution-environment/index.js +8 -0
  249. package/dist/harness/extension/execution-environment/isolation.d.ts +56 -0
  250. package/dist/harness/extension/execution-environment/isolation.js +56 -0
  251. package/dist/harness/extension/execution-environment/sandbox.d.ts +12 -0
  252. package/dist/harness/extension/execution-environment/sandbox.js +87 -0
  253. package/dist/harness/extension/execution-environment/types.d.ts +157 -0
  254. package/dist/harness/extension/execution-environment/types.js +6 -0
  255. package/dist/harness/extension/execution-environment/workspace.d.ts +26 -0
  256. package/dist/harness/extension/execution-environment/workspace.js +171 -0
  257. package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +34 -0
  258. package/dist/harness/extension/plugin-ecosystem/channel-types.js +12 -0
  259. package/dist/harness/extension/plugin-ecosystem/commands/builtin.d.ts +34 -0
  260. package/dist/harness/extension/plugin-ecosystem/commands/builtin.js +185 -0
  261. package/dist/harness/extension/plugin-ecosystem/commands/index.d.ts +15 -0
  262. package/dist/harness/extension/plugin-ecosystem/commands/index.js +11 -0
  263. package/dist/harness/extension/plugin-ecosystem/commands/parse.d.ts +17 -0
  264. package/dist/harness/extension/plugin-ecosystem/commands/parse.js +41 -0
  265. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.d.ts +6 -0
  266. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.js +49 -0
  267. package/dist/harness/extension/plugin-ecosystem/commands/router.d.ts +71 -0
  268. package/dist/harness/extension/plugin-ecosystem/commands/router.js +302 -0
  269. package/dist/harness/extension/plugin-ecosystem/commands/skill-bridge.d.ts +10 -0
  270. package/dist/harness/extension/plugin-ecosystem/commands/skill-bridge.js +59 -0
  271. package/dist/harness/extension/plugin-ecosystem/commands/types.d.ts +126 -0
  272. package/dist/harness/extension/plugin-ecosystem/commands/types.js +7 -0
  273. package/dist/harness/extension/plugin-ecosystem/commands/user-source.d.ts +16 -0
  274. package/dist/harness/extension/plugin-ecosystem/commands/user-source.js +102 -0
  275. package/dist/harness/extension/plugin-ecosystem/index.d.ts +13 -0
  276. package/dist/harness/extension/plugin-ecosystem/index.js +10 -0
  277. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.d.ts +42 -0
  278. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +88 -0
  279. package/dist/harness/extension/plugin-ecosystem/mcp/discovery.d.ts +39 -0
  280. package/dist/harness/extension/plugin-ecosystem/mcp/discovery.js +117 -0
  281. package/dist/harness/extension/plugin-ecosystem/mcp/index.d.ts +10 -0
  282. package/dist/harness/extension/plugin-ecosystem/mcp/index.js +8 -0
  283. package/dist/harness/extension/plugin-ecosystem/mcp/manager.d.ts +74 -0
  284. package/dist/harness/extension/plugin-ecosystem/mcp/manager.js +146 -0
  285. package/dist/harness/extension/plugin-ecosystem/mcp/types.d.ts +149 -0
  286. package/dist/harness/extension/plugin-ecosystem/mcp/types.js +12 -0
  287. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +294 -0
  288. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +270 -0
  289. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +100 -0
  290. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +158 -0
  291. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +101 -0
  292. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +65 -0
  293. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.d.ts +7 -0
  294. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.js +7 -0
  295. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +26 -0
  296. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +26 -0
  297. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.d.ts +86 -0
  298. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.js +139 -0
  299. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +135 -0
  300. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +353 -0
  301. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +504 -0
  302. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +368 -0
  303. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +261 -0
  304. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +44 -0
  305. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +123 -0
  306. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +210 -0
  307. package/dist/harness/extension/plugin-ecosystem/skills/types.d.ts +29 -0
  308. package/dist/harness/extension/plugin-ecosystem/skills/types.js +7 -0
  309. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +34 -0
  310. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +92 -0
  311. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +101 -0
  312. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +570 -0
  313. package/dist/harness/extension/plugin-ecosystem/tools/env-info.d.ts +8 -0
  314. package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +49 -0
  315. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.d.ts +14 -0
  316. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +126 -0
  317. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +23 -0
  318. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +659 -0
  319. package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +28 -0
  320. package/dist/harness/extension/plugin-ecosystem/tools/http.js +170 -0
  321. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +14 -0
  322. package/dist/harness/extension/plugin-ecosystem/tools/index.js +12 -0
  323. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.d.ts +25 -0
  324. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +164 -0
  325. package/dist/harness/extension/plugin-ecosystem/tools/memory.d.ts +19 -0
  326. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +197 -0
  327. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +82 -0
  328. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +251 -0
  329. package/dist/harness/extension/plugin-ecosystem/tools/session-history.d.ts +21 -0
  330. package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +165 -0
  331. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +65 -0
  332. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +262 -0
  333. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +34 -0
  334. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +30 -0
  335. package/dist/harness/extension/plugin-ecosystem/tools/web-search-types.d.ts +66 -0
  336. package/dist/harness/extension/plugin-ecosystem/tools/web-search-types.js +12 -0
  337. package/dist/harness/extension/plugin-ecosystem/tools/web-search.d.ts +23 -0
  338. package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +84 -0
  339. package/dist/harness/governance/accounting/index.d.ts +5 -0
  340. package/dist/harness/governance/accounting/index.js +3 -0
  341. package/dist/harness/governance/accounting/session-ledger.d.ts +67 -0
  342. package/dist/harness/governance/accounting/session-ledger.js +84 -0
  343. package/dist/harness/governance/accounting/usage-ledger.d.ts +107 -0
  344. package/dist/harness/governance/accounting/usage-ledger.js +137 -0
  345. package/dist/harness/governance/credentials/crypto.d.ts +34 -0
  346. package/dist/harness/governance/credentials/crypto.js +79 -0
  347. package/dist/harness/governance/credentials/db.d.ts +32 -0
  348. package/dist/harness/governance/credentials/db.js +87 -0
  349. package/dist/harness/governance/credentials/index.d.ts +9 -0
  350. package/dist/harness/governance/credentials/index.js +7 -0
  351. package/dist/harness/governance/credentials/store.d.ts +47 -0
  352. package/dist/harness/governance/credentials/store.js +228 -0
  353. package/dist/harness/governance/credentials/types.d.ts +67 -0
  354. package/dist/harness/governance/credentials/types.js +30 -0
  355. package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +32 -0
  356. package/dist/harness/governance/human-in-the-loop/approval-manager.js +93 -0
  357. package/dist/harness/governance/human-in-the-loop/index.d.ts +9 -0
  358. package/dist/harness/governance/human-in-the-loop/index.js +7 -0
  359. package/dist/harness/governance/human-in-the-loop/types.d.ts +66 -0
  360. package/dist/harness/governance/human-in-the-loop/types.js +6 -0
  361. package/dist/harness/governance/index.d.ts +10 -0
  362. package/dist/harness/governance/index.js +10 -0
  363. package/dist/harness/governance/security/capability-enforcer.d.ts +56 -0
  364. package/dist/harness/governance/security/capability-enforcer.js +132 -0
  365. package/dist/harness/governance/security/default-risk-policy.d.ts +66 -0
  366. package/dist/harness/governance/security/default-risk-policy.js +75 -0
  367. package/dist/harness/governance/security/default-security-guard.d.ts +105 -0
  368. package/dist/harness/governance/security/default-security-guard.js +578 -0
  369. package/dist/harness/governance/security/degradation.d.ts +14 -0
  370. package/dist/harness/governance/security/degradation.js +208 -0
  371. package/dist/harness/governance/security/index.d.ts +10 -0
  372. package/dist/harness/governance/security/index.js +10 -0
  373. package/dist/harness/governance/security/risk-evaluator.d.ts +68 -0
  374. package/dist/harness/governance/security/risk-evaluator.js +1043 -0
  375. package/dist/harness/governance/security/risk-types.d.ts +74 -0
  376. package/dist/harness/governance/security/risk-types.js +7 -0
  377. package/dist/harness/governance/security/shell-parser.d.ts +35 -0
  378. package/dist/harness/governance/security/shell-parser.js +525 -0
  379. package/dist/harness/governance/security/tool-call-risk-policy.d.ts +6 -0
  380. package/dist/harness/governance/security/tool-call-risk-policy.js +6 -0
  381. package/dist/harness/governance/session-acl/index.d.ts +11 -0
  382. package/dist/harness/governance/session-acl/index.js +7 -0
  383. package/dist/harness/governance/session-acl/rights.d.ts +78 -0
  384. package/dist/harness/governance/session-acl/rights.js +142 -0
  385. package/dist/harness/governance/session-acl/seed-roles.d.ts +16 -0
  386. package/dist/harness/governance/session-acl/seed-roles.js +85 -0
  387. package/dist/harness/governance/session-acl/service.d.ts +136 -0
  388. package/dist/harness/governance/session-acl/service.js +407 -0
  389. package/dist/harness/governance/session-acl/types.d.ts +102 -0
  390. package/dist/harness/governance/session-acl/types.js +5 -0
  391. package/dist/harness/index.d.ts +137 -0
  392. package/dist/harness/index.js +106 -0
  393. package/dist/harness/knowledge/adapters.d.ts +68 -0
  394. package/dist/harness/knowledge/adapters.js +421 -0
  395. package/dist/harness/knowledge/catalog-index.d.ts +7 -0
  396. package/dist/harness/knowledge/catalog-index.js +7 -0
  397. package/dist/harness/knowledge/catalog-types.d.ts +33 -0
  398. package/dist/harness/knowledge/catalog-types.js +10 -0
  399. package/dist/harness/knowledge/connector-fetcher.d.ts +13 -0
  400. package/dist/harness/knowledge/connector-fetcher.js +27 -0
  401. package/dist/harness/knowledge/connectors.d.ts +55 -0
  402. package/dist/harness/knowledge/connectors.js +181 -0
  403. package/dist/harness/knowledge/db.d.ts +26 -0
  404. package/dist/harness/knowledge/db.js +235 -0
  405. package/dist/harness/knowledge/describe.d.ts +40 -0
  406. package/dist/harness/knowledge/describe.js +52 -0
  407. package/dist/harness/knowledge/fetchers.d.ts +66 -0
  408. package/dist/harness/knowledge/fetchers.js +342 -0
  409. package/dist/harness/knowledge/grounding.d.ts +98 -0
  410. package/dist/harness/knowledge/grounding.js +208 -0
  411. package/dist/harness/knowledge/hit-log.d.ts +74 -0
  412. package/dist/harness/knowledge/hit-log.js +99 -0
  413. package/dist/harness/knowledge/html.d.ts +20 -0
  414. package/dist/harness/knowledge/html.js +103 -0
  415. package/dist/harness/knowledge/index-store.d.ts +150 -0
  416. package/dist/harness/knowledge/index-store.js +394 -0
  417. package/dist/harness/knowledge/index.d.ts +38 -0
  418. package/dist/harness/knowledge/index.js +24 -0
  419. package/dist/harness/knowledge/ingest.d.ts +162 -0
  420. package/dist/harness/knowledge/ingest.js +814 -0
  421. package/dist/harness/knowledge/network-guard.d.ts +57 -0
  422. package/dist/harness/knowledge/network-guard.js +242 -0
  423. package/dist/harness/knowledge/paths.d.ts +14 -0
  424. package/dist/harness/knowledge/paths.js +17 -0
  425. package/dist/harness/knowledge/purge.d.ts +34 -0
  426. package/dist/harness/knowledge/purge.js +51 -0
  427. package/dist/harness/knowledge/retriever.d.ts +83 -0
  428. package/dist/harness/knowledge/retriever.js +184 -0
  429. package/dist/harness/knowledge/secret-scan.d.ts +11 -0
  430. package/dist/harness/knowledge/secret-scan.js +32 -0
  431. package/dist/harness/knowledge/source-store.d.ts +107 -0
  432. package/dist/harness/knowledge/source-store.js +516 -0
  433. package/dist/harness/knowledge/types.d.ts +129 -0
  434. package/dist/harness/knowledge/types.js +14 -0
  435. package/dist/harness/memory/backfill-coverage.d.ts +80 -0
  436. package/dist/harness/memory/backfill-coverage.js +146 -0
  437. package/dist/harness/memory/backfill-trigger.d.ts +83 -0
  438. package/dist/harness/memory/backfill-trigger.js +247 -0
  439. package/dist/harness/memory/cognition-types.d.ts +4 -0
  440. package/dist/harness/memory/cognition-types.js +4 -0
  441. package/dist/harness/memory/cognition.d.ts +16 -0
  442. package/dist/harness/memory/cognition.js +107 -0
  443. package/dist/harness/memory/confidence.d.ts +63 -0
  444. package/dist/harness/memory/confidence.js +157 -0
  445. package/dist/harness/memory/decay-policy.d.ts +22 -0
  446. package/dist/harness/memory/decay-policy.js +28 -0
  447. package/dist/harness/memory/gates.d.ts +39 -0
  448. package/dist/harness/memory/gates.js +176 -0
  449. package/dist/harness/memory/health-probe.d.ts +36 -0
  450. package/dist/harness/memory/health-probe.js +78 -0
  451. package/dist/harness/memory/index.d.ts +32 -0
  452. package/dist/harness/memory/index.js +26 -0
  453. package/dist/harness/memory/similarity.d.ts +33 -0
  454. package/dist/harness/memory/similarity.js +69 -0
  455. package/dist/harness/memory/sqlite/agent-db.d.ts +73 -0
  456. package/dist/harness/memory/sqlite/agent-db.js +277 -0
  457. package/dist/harness/memory/sqlite/backfill-coverage.d.ts +13 -0
  458. package/dist/harness/memory/sqlite/backfill-coverage.js +57 -0
  459. package/dist/harness/memory/sqlite/cognition-store.d.ts +34 -0
  460. package/dist/harness/memory/sqlite/cognition-store.js +188 -0
  461. package/dist/harness/memory/sqlite/embedding-from-models.d.ts +47 -0
  462. package/dist/harness/memory/sqlite/embedding-from-models.js +90 -0
  463. package/dist/harness/memory/sqlite/embedding.d.ts +93 -0
  464. package/dist/harness/memory/sqlite/embedding.js +268 -0
  465. package/dist/harness/memory/sqlite/index.d.ts +22 -0
  466. package/dist/harness/memory/sqlite/index.js +17 -0
  467. package/dist/harness/memory/sqlite/keyword-search.d.ts +37 -0
  468. package/dist/harness/memory/sqlite/keyword-search.js +113 -0
  469. package/dist/harness/memory/sqlite/knowledge-registry.d.ts +45 -0
  470. package/dist/harness/memory/sqlite/knowledge-registry.js +59 -0
  471. package/dist/harness/memory/sqlite/memory-store.d.ts +80 -0
  472. package/dist/harness/memory/sqlite/memory-store.js +548 -0
  473. package/dist/harness/memory/sqlite/sqlite-vec.d.ts +45 -0
  474. package/dist/harness/memory/sqlite/sqlite-vec.js +159 -0
  475. package/dist/harness/memory/sqlite/vector-search.d.ts +41 -0
  476. package/dist/harness/memory/sqlite/vector-search.js +72 -0
  477. package/dist/harness/memory/sqlite/wisdom-store.d.ts +23 -0
  478. package/dist/harness/memory/sqlite/wisdom-store.js +64 -0
  479. package/dist/harness/memory/steward-policy.d.ts +122 -0
  480. package/dist/harness/memory/steward-policy.js +369 -0
  481. package/dist/harness/memory/store.d.ts +33 -0
  482. package/dist/harness/memory/store.js +173 -0
  483. package/dist/harness/memory/types.d.ts +170 -0
  484. package/dist/harness/memory/types.js +7 -0
  485. package/dist/harness/memory/wisdom-types.d.ts +4 -0
  486. package/dist/harness/memory/wisdom-types.js +4 -0
  487. package/dist/harness/observability/diagnostics/index.d.ts +5 -0
  488. package/dist/harness/observability/diagnostics/index.js +4 -0
  489. package/dist/harness/observability/diagnostics/registry.d.ts +19 -0
  490. package/dist/harness/observability/diagnostics/registry.js +74 -0
  491. package/dist/harness/observability/diagnostics/types.d.ts +42 -0
  492. package/dist/harness/observability/diagnostics/types.js +6 -0
  493. package/dist/harness/observability/observer/hub.d.ts +107 -0
  494. package/dist/harness/observability/observer/hub.js +907 -0
  495. package/dist/harness/observability/observer/index.d.ts +4 -0
  496. package/dist/harness/observability/observer/index.js +3 -0
  497. package/dist/harness/observability/observer/run-snapshot.d.ts +47 -0
  498. package/dist/harness/observability/observer/run-snapshot.js +65 -0
  499. package/dist/harness/observability/observer/types.d.ts +370 -0
  500. package/dist/harness/observability/observer/types.js +379 -0
  501. package/dist/harness/observability/run-telemetry.d.ts +51 -0
  502. package/dist/harness/observability/run-telemetry.js +28 -0
  503. package/dist/harness/run/agent/agent.d.ts +142 -0
  504. package/dist/harness/run/agent/agent.js +192 -0
  505. package/dist/harness/run/agent/index.d.ts +8 -0
  506. package/dist/harness/run/agent/index.js +7 -0
  507. package/dist/harness/run/budget/budget.d.ts +94 -0
  508. package/dist/harness/run/budget/budget.js +124 -0
  509. package/dist/harness/run/budget/index.d.ts +7 -0
  510. package/dist/harness/run/budget/index.js +6 -0
  511. package/dist/harness/run/concurrency/index.d.ts +18 -0
  512. package/dist/harness/run/concurrency/index.js +14 -0
  513. package/dist/harness/run/concurrency/provider-pool.d.ts +128 -0
  514. package/dist/harness/run/concurrency/provider-pool.js +329 -0
  515. package/dist/harness/run/concurrency/rate-limiter.d.ts +109 -0
  516. package/dist/harness/run/concurrency/rate-limiter.js +233 -0
  517. package/dist/harness/run/concurrency/session-gate.d.ts +85 -0
  518. package/dist/harness/run/concurrency/session-gate.js +176 -0
  519. package/dist/harness/run/concurrency/session-lease.d.ts +79 -0
  520. package/dist/harness/run/concurrency/session-lease.js +100 -0
  521. package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +41 -0
  522. package/dist/harness/run/concurrency/tool-loop-detection-core.js +239 -0
  523. package/dist/harness/run/concurrency/tool-loop-detection.d.ts +8 -0
  524. package/dist/harness/run/concurrency/tool-loop-detection.js +7 -0
  525. package/dist/harness/run/concurrency/tool-validator.d.ts +96 -0
  526. package/dist/harness/run/concurrency/tool-validator.js +195 -0
  527. package/dist/harness/run/index.d.ts +14 -0
  528. package/dist/harness/run/index.js +14 -0
  529. package/dist/harness/run/model/index.d.ts +9 -0
  530. package/dist/harness/run/model/index.js +7 -0
  531. package/dist/harness/run/model/resolver.d.ts +111 -0
  532. package/dist/harness/run/model/resolver.js +192 -0
  533. package/dist/harness/run/model/run-scope.d.ts +43 -0
  534. package/dist/harness/run/model/run-scope.js +64 -0
  535. package/dist/harness/run/model/types.d.ts +47 -0
  536. package/dist/harness/run/model/types.js +9 -0
  537. package/dist/harness/run/reliability/circuit-breaker.d.ts +87 -0
  538. package/dist/harness/run/reliability/circuit-breaker.js +130 -0
  539. package/dist/harness/run/reliability/fallback-provider.d.ts +40 -0
  540. package/dist/harness/run/reliability/fallback-provider.js +118 -0
  541. package/dist/harness/run/reliability/harness-events.d.ts +109 -0
  542. package/dist/harness/run/reliability/harness-events.js +7 -0
  543. package/dist/harness/run/reliability/index.d.ts +12 -0
  544. package/dist/harness/run/reliability/index.js +7 -0
  545. package/dist/harness/run/reliability/model-binding.d.ts +22 -0
  546. package/dist/harness/run/reliability/model-binding.js +27 -0
  547. package/dist/harness/run/reliability/provider-wrapper.d.ts +26 -0
  548. package/dist/harness/run/reliability/provider-wrapper.js +61 -0
  549. package/dist/harness/run/reliability/run-agent.d.ts +86 -0
  550. package/dist/harness/run/reliability/run-agent.js +932 -0
  551. package/dist/harness/run/reliability/run-metrics-collector.d.ts +80 -0
  552. package/dist/harness/run/reliability/run-metrics-collector.js +194 -0
  553. package/dist/harness/run/reliability/run-model-context.d.ts +19 -0
  554. package/dist/harness/run/reliability/run-model-context.js +32 -0
  555. package/dist/harness/run/run-guard/default-run-guard.d.ts +75 -0
  556. package/dist/harness/run/run-guard/default-run-guard.js +347 -0
  557. package/dist/harness/run/run-guard/index.d.ts +9 -0
  558. package/dist/harness/run/run-guard/index.js +8 -0
  559. package/dist/harness/run/run-scope.d.ts +81 -0
  560. package/dist/harness/run/run-scope.js +58 -0
  561. package/dist/harness/run/runner.d.ts +362 -0
  562. package/dist/harness/run/runner.js +1290 -0
  563. package/dist/harness/session/attachments/extract.d.ts +35 -0
  564. package/dist/harness/session/attachments/extract.js +72 -0
  565. package/dist/harness/session/attachments/index.d.ts +11 -0
  566. package/dist/harness/session/attachments/index.js +11 -0
  567. package/dist/harness/session/attachments/inject.d.ts +71 -0
  568. package/dist/harness/session/attachments/inject.js +142 -0
  569. package/dist/harness/session/attachments/intent.d.ts +32 -0
  570. package/dist/harness/session/attachments/intent.js +69 -0
  571. package/dist/harness/session/attachments/llm-intent.d.ts +17 -0
  572. package/dist/harness/session/attachments/llm-intent.js +74 -0
  573. package/dist/harness/session/attachments/paths.d.ts +15 -0
  574. package/dist/harness/session/attachments/paths.js +18 -0
  575. package/dist/harness/session/attachments/sanitize.d.ts +23 -0
  576. package/dist/harness/session/attachments/sanitize.js +55 -0
  577. package/dist/harness/session/attachments/service.d.ts +105 -0
  578. package/dist/harness/session/attachments/service.js +320 -0
  579. package/dist/harness/session/attachments/types.d.ts +64 -0
  580. package/dist/harness/session/attachments/types.js +17 -0
  581. package/dist/harness/session/compact.d.ts +23 -0
  582. package/dist/harness/session/compact.js +53 -0
  583. package/dist/harness/session/history/index.d.ts +4 -0
  584. package/dist/harness/session/history/index.js +3 -0
  585. package/dist/harness/session/history/port.d.ts +51 -0
  586. package/dist/harness/session/history/port.js +480 -0
  587. package/dist/harness/session/history/score.d.ts +71 -0
  588. package/dist/harness/session/history/score.js +225 -0
  589. package/dist/harness/session/history/types.d.ts +157 -0
  590. package/dist/harness/session/history/types.js +29 -0
  591. package/dist/harness/session/in-memory-store.d.ts +21 -0
  592. package/dist/harness/session/in-memory-store.js +48 -0
  593. package/dist/harness/session/index.d.ts +12 -0
  594. package/dist/harness/session/index.js +12 -0
  595. package/dist/harness/session/state-machine.d.ts +18 -0
  596. package/dist/harness/session/state-machine.js +31 -0
  597. package/dist/harness/session/tasks/index.d.ts +11 -0
  598. package/dist/harness/session/tasks/index.js +9 -0
  599. package/dist/harness/session/tasks/render.d.ts +12 -0
  600. package/dist/harness/session/tasks/render.js +57 -0
  601. package/dist/harness/session/tasks/service.d.ts +69 -0
  602. package/dist/harness/session/tasks/service.js +327 -0
  603. package/dist/harness/session/tasks/tools.d.ts +17 -0
  604. package/dist/harness/session/tasks/tools.js +210 -0
  605. package/dist/harness/session/tasks/types.d.ts +29 -0
  606. package/dist/harness/session/tasks/types.js +11 -0
  607. package/dist/harness/session/types.d.ts +88 -0
  608. package/dist/harness/session/types.js +7 -0
  609. package/dist/harness/shared/events/agent-event-map.d.ts +264 -0
  610. package/dist/harness/shared/events/agent-event-map.js +51 -0
  611. package/dist/harness/shared/events/index.d.ts +6 -0
  612. package/dist/harness/shared/events/index.js +4 -0
  613. package/dist/harness/shared/events/scenario-events.d.ts +96 -0
  614. package/dist/harness/shared/events/scenario-events.js +7 -0
  615. package/dist/harness/shared/types/agent-definition.d.ts +51 -0
  616. package/dist/harness/shared/types/agent-definition.js +8 -0
  617. package/dist/harness/shared/types/hook-context.d.ts +10 -0
  618. package/dist/harness/shared/types/hook-context.js +6 -0
  619. package/dist/harness/shared/types/index.d.ts +7 -0
  620. package/dist/harness/shared/types/index.js +4 -0
  621. package/dist/harness/shared/types/queue-mode.d.ts +4 -0
  622. package/dist/harness/shared/types/queue-mode.js +1 -0
  623. package/dist/harness/shared/types/thinking-level.d.ts +4 -0
  624. package/dist/harness/shared/types/thinking-level.js +1 -0
  625. package/dist/index.d.ts +117 -0
  626. package/dist/index.js +80 -0
  627. package/dist/integration/agent-runtime/channel-message-source.d.ts +27 -0
  628. package/dist/integration/agent-runtime/channel-message-source.js +58 -0
  629. package/dist/integration/agent-runtime/file-watch-source.d.ts +31 -0
  630. package/dist/integration/agent-runtime/file-watch-source.js +63 -0
  631. package/dist/integration/agent-runtime/index.d.ts +6 -0
  632. package/dist/integration/agent-runtime/index.js +3 -0
  633. package/dist/integration/agent-runtime/webhook-source.d.ts +39 -0
  634. package/dist/integration/agent-runtime/webhook-source.js +112 -0
  635. package/dist/integration/index.d.ts +23 -0
  636. package/dist/integration/index.js +23 -0
  637. package/dist/integration/mcp/index.d.ts +6 -0
  638. package/dist/integration/mcp/index.js +6 -0
  639. package/dist/integration/mcp/sdk-client.d.ts +39 -0
  640. package/dist/integration/mcp/sdk-client.js +157 -0
  641. package/dist/integration/observability/exporters.d.ts +111 -0
  642. package/dist/integration/observability/exporters.js +167 -0
  643. package/dist/integration/observability/index.d.ts +21 -0
  644. package/dist/integration/observability/index.js +16 -0
  645. package/dist/integration/observability/log-observer.d.ts +12 -0
  646. package/dist/integration/observability/log-observer.js +59 -0
  647. package/dist/integration/observability/metrics.d.ts +116 -0
  648. package/dist/integration/observability/metrics.js +237 -0
  649. package/dist/integration/observability/noop-observer.d.ts +12 -0
  650. package/dist/integration/observability/noop-observer.js +22 -0
  651. package/dist/integration/observability/observer-bridge.d.ts +56 -0
  652. package/dist/integration/observability/observer-bridge.js +195 -0
  653. package/dist/integration/observability/run-telemetry.d.ts +28 -0
  654. package/dist/integration/observability/run-telemetry.js +83 -0
  655. package/dist/integration/observability/trace-collector.d.ts +124 -0
  656. package/dist/integration/observability/trace-collector.js +253 -0
  657. package/dist/integration/observability/trace-events.d.ts +69 -0
  658. package/dist/integration/observability/trace-events.js +83 -0
  659. package/dist/integration/observability/trace-logger.d.ts +110 -0
  660. package/dist/integration/observability/trace-logger.js +219 -0
  661. package/dist/integration/providers/anthropic.d.ts +92 -0
  662. package/dist/integration/providers/anthropic.js +432 -0
  663. package/dist/integration/providers/index.d.ts +4 -0
  664. package/dist/integration/providers/index.js +2 -0
  665. package/dist/integration/providers/openai.d.ts +120 -0
  666. package/dist/integration/providers/openai.js +429 -0
  667. package/dist/integration/providers/usage.d.ts +20 -0
  668. package/dist/integration/providers/usage.js +69 -0
  669. package/dist/integration/storage/archive-manager.d.ts +79 -0
  670. package/dist/integration/storage/archive-manager.js +223 -0
  671. package/dist/integration/storage/jsonl.d.ts +51 -0
  672. package/dist/integration/storage/jsonl.js +246 -0
  673. package/dist/integration/storage/memory.d.ts +7 -0
  674. package/dist/integration/storage/memory.js +7 -0
  675. package/dist/integration/storage/session-index.d.ts +57 -0
  676. package/dist/integration/storage/session-index.js +379 -0
  677. package/dist/integration/web-search/brave.d.ts +13 -0
  678. package/dist/integration/web-search/brave.js +64 -0
  679. package/dist/integration/web-search/duckduckgo.d.ts +12 -0
  680. package/dist/integration/web-search/duckduckgo.js +102 -0
  681. package/dist/integration/web-search/factory.d.ts +91 -0
  682. package/dist/integration/web-search/factory.js +166 -0
  683. package/dist/integration/web-search/http.d.ts +22 -0
  684. package/dist/integration/web-search/http.js +94 -0
  685. package/dist/integration/web-search/index.d.ts +16 -0
  686. package/dist/integration/web-search/index.js +9 -0
  687. package/dist/integration/web-search/mimo.d.ts +57 -0
  688. package/dist/integration/web-search/mimo.js +226 -0
  689. package/dist/integration/web-search/serper.d.ts +13 -0
  690. package/dist/integration/web-search/serper.js +59 -0
  691. package/dist/integration/web-search/tavily.d.ts +16 -0
  692. package/dist/integration/web-search/tavily.js +56 -0
  693. package/dist/paths.d.ts +14 -0
  694. package/dist/paths.js +22 -0
  695. package/dist/subsystems/memory-steward/backfill/SUBSYSTEM.md +30 -0
  696. package/dist/subsystems/memory-steward/backfill/config.yaml +51 -0
  697. package/dist/subsystems/memory-steward/backfill/handler.d.ts +18 -0
  698. package/dist/subsystems/memory-steward/backfill/handler.js +343 -0
  699. package/dist/subsystems/memory-steward/govern/SUBSYSTEM.md +12 -0
  700. package/dist/subsystems/memory-steward/govern/config.yaml +65 -0
  701. package/dist/subsystems/memory-steward/govern/handler.d.ts +19 -0
  702. package/dist/subsystems/memory-steward/govern/handler.js +79 -0
  703. package/dist/subsystems/safety-guard/SUBSYSTEM.md +60 -0
  704. package/dist/subsystems/safety-guard/config.yaml +40 -0
  705. package/package.json +110 -0
@@ -0,0 +1,932 @@
1
+ /**
2
+ * Harness 层可靠性包装
3
+ *
4
+ * 包装 agentLoop(),注入所有可靠性行为:
5
+ * - Planning-only 检测与重试
6
+ * - 空响应重试
7
+ * - 工具循环检测
8
+ * - No-op 检测
9
+ * - RunGuard 检查点
10
+ * - SecurityGuard 安全检查(通过 beforeToolCall 注入)
11
+ * - ErrorStrategy 重试策略(通过 onError 注入)
12
+ *
13
+ * 设计原则:
14
+ * - 使用 onTurnComplete 做副作用(注入 steer 指令),不直接控制停止
15
+ * - 使用 shouldStopAfterTurn 做停止决策(critical 循环、RunGuard)
16
+ * - 两层分离,不互相覆盖
17
+ */
18
+ import { getTextContent } from '@octopi-agent/core/types.js';
19
+ import { classifyError } from '@octopi-agent/core/loop/error-classifier.js';
20
+ import { agentLoop } from '@octopi-agent/core/loop/agent-loop.js';
21
+ import { recordToolCall, detectNoProgressLoop, } from '../concurrency/tool-loop-detection.js';
22
+ import { severityToAction } from '@octopi-agent/core/security-guard.js';
23
+ import { RunMetricsCollector } from './run-metrics-collector.js';
24
+ import { BudgetPolicyEngine } from '../budget/budget.js';
25
+ import { UsageLedger } from '../../governance/accounting/usage-ledger.js';
26
+ import { nominalTotalTokens } from '@octopi-agent/core/types/turn.js';
27
+ import { getRunScope } from '../run-scope.js';
28
+ export const DEFAULT_RELIABILITY_CONFIG = {
29
+ planningRetry: {
30
+ maxAttempts: 2,
31
+ steerInstruction: 'Continue with the task using available tools.',
32
+ },
33
+ emptyResponseRetry: {
34
+ maxAttempts: 2,
35
+ steerInstruction: 'You have not provided a response. Please summarize your findings and respond to the user.',
36
+ },
37
+ noopThreshold: 3,
38
+ loopDetection: {
39
+ enabled: true,
40
+ historySize: 30,
41
+ warningThreshold: 10,
42
+ criticalThreshold: 20,
43
+ globalCircuitBreakerThreshold: 30,
44
+ },
45
+ };
46
+ // ── Policy 辅助函数 ──
47
+ /**
48
+ * 估算花费
49
+ *
50
+ * @param snapshot - UsageLedger 快照
51
+ * @param pricing - 模型定价(按模型名查询,fallback 到 'default')
52
+ * @returns 估算的花费(币种由 pricing 决定)
53
+ */
54
+ function estimateCost(snapshot, pricing) {
55
+ // 默认定价(如果未配置 'default' key)
56
+ const defaultPricing = pricing['default'] ?? { inputPer1M: 3, outputPer1M: 15 };
57
+ const inputCost = (snapshot.inputUncachedTokens / 1_000_000) * defaultPricing.inputPer1M;
58
+ const cachedCost = snapshot.cacheAware && defaultPricing.cachedInputPer1M
59
+ ? (snapshot.inputCachedTokens / 1_000_000) * defaultPricing.cachedInputPer1M
60
+ : 0;
61
+ const outputCost = (snapshot.outputTokens / 1_000_000) * defaultPricing.outputPer1M;
62
+ return inputCost + cachedCost + outputCost;
63
+ }
64
+ function createInitialState(checkpointInterval = 15) {
65
+ return {
66
+ planningOnlyAttempts: 0,
67
+ planningOnlySteerInjected: false,
68
+ emptyResponseAttempts: 0,
69
+ emptyResponseSteerInjected: false,
70
+ consecutiveNoops: 0,
71
+ toolCallHistory: [],
72
+ loopCriticalTriggered: false,
73
+ collector: new RunMetricsCollector(),
74
+ checkpointIterationCount: 0,
75
+ currentCheckpointInterval: checkpointInterval,
76
+ lastCheckpointIteration: 0,
77
+ budgetStop: false,
78
+ runGuardStop: false,
79
+ runGuardRecovered: false,
80
+ hasProgress: true,
81
+ forceCheckpoint: false,
82
+ modelErrorAttempt: 0,
83
+ pendingBudgetHardYield: false,
84
+ pendingSecurityEvents: [],
85
+ wrapUp: false,
86
+ advisoryTriggered: new Set(),
87
+ };
88
+ }
89
+ // ── Planning-only 检测(从 engine.ts 提取) ──
90
+ const PLANNING_ONLY_PROMISE_RE = /\b(?:i(?:'ll| will)|let me|i(?:'m| am)\s+going to|first[, ]+i(?:'ll| will)|next[, ]+i(?:'ll| will)|i can do that)\b/i;
91
+ const PLANNING_ONLY_COMPLETION_RE = /\b(?:done|finished|implemented|updated|fixed|changed|ran|verified|found|here(?:'s| is) what|blocked by|the blocker is)\b/i;
92
+ const PLANNING_ONLY_HEADING_RE = /^(?:plan|steps?|next steps?)\s*:/i;
93
+ const PLANNING_ONLY_BULLET_RE = /^(?:[-*•]\s+|\d+[.)]\s+)/u;
94
+ const PLANNING_ONLY_MAX_VISIBLE_TEXT = 700;
95
+ const PLANNING_ONLY_ACTION_VERB_RE = /\b(?:inspect|investigate|check|look(?:\s+into|\s+at)?|read|search|find|debug|fix|patch|update|change|edit|write|implement|run|test|verify|review|analy(?:s|z)e|summari(?:s|z)e|explain|answer|show|share|report|prepare|capture|take|refactor|restart|deploy|ship)\b/i;
96
+ const PLANNING_ONLY_PROMISE_ZH_RE = /(?:我会|让我|接下来我|我将|我需要|首先我|下一步我)/;
97
+ const PLANNING_ONLY_ACTION_VERB_ZH_RE = /(?:查看|分析|检查|读取|列出|搜索|研究|执行|运行|测试|验证|审查|总结|解释|回答|展示|分享|报告|准备|捕获|获取|重构|重启|部署)/;
98
+ const PLANNING_ONLY_COMPLETION_ZH_RE = /(?:完成|已完成|已实现|已更新|已修复|已更改|已运行|已验证|已找到|以下是|结果是|被阻塞|阻塞原因)/;
99
+ function isPlanningOnlyResponse(content, hasToolCalls) {
100
+ if (!content || content.trim().length === 0)
101
+ return false;
102
+ if (hasToolCalls)
103
+ return false;
104
+ const text = content.trim();
105
+ if (text.length < 20)
106
+ return false;
107
+ if (text.length > PLANNING_ONLY_MAX_VISIBLE_TEXT)
108
+ return false;
109
+ if (text.includes('```'))
110
+ return false;
111
+ const hasStructuredFormat = hasStructuredPlanningOnlyFormat(text);
112
+ const hasPromise = PLANNING_ONLY_PROMISE_RE.test(text) || PLANNING_ONLY_PROMISE_ZH_RE.test(text);
113
+ if (!hasPromise && !hasStructuredFormat)
114
+ return false;
115
+ if (!hasStructuredFormat) {
116
+ const hasActionVerb = PLANNING_ONLY_ACTION_VERB_RE.test(text) || PLANNING_ONLY_ACTION_VERB_ZH_RE.test(text);
117
+ if (!hasActionVerb)
118
+ return false;
119
+ }
120
+ const isCompletion = PLANNING_ONLY_COMPLETION_RE.test(text) || PLANNING_ONLY_COMPLETION_ZH_RE.test(text);
121
+ if (isCompletion)
122
+ return false;
123
+ return true;
124
+ }
125
+ function hasStructuredPlanningOnlyFormat(text) {
126
+ const lines = text.split(/\r?\n/).map(l => l.trim()).filter(l => l.length > 0);
127
+ if (lines.length === 0)
128
+ return false;
129
+ const bulletLineCount = lines.filter(line => PLANNING_ONLY_BULLET_RE.test(line)).length;
130
+ const hasPlanningCueLine = lines.some(line => PLANNING_ONLY_PROMISE_RE.test(line) || PLANNING_ONLY_PROMISE_ZH_RE.test(line));
131
+ return (PLANNING_ONLY_HEADING_RE.test(lines[0] ?? '') && hasPlanningCueLine) ||
132
+ (bulletLineCount >= 2 && hasPlanningCueLine);
133
+ }
134
+ // ── high 风险确认 ──
135
+ /**
136
+ * high 风险人工确认
137
+ *
138
+ * - 有 `harness.confirmHighRisk`:请求确认,用户拒绝/异常 → false
139
+ * - 无审批通道:回退 reject(false),无人值守不放行
140
+ */
141
+ async function confirmHighRiskDecision(harness, toolCall, reason, severity) {
142
+ const confirm = harness.confirmHighRisk;
143
+ if (!confirm)
144
+ return false;
145
+ try {
146
+ const scope = getRunScope();
147
+ return await confirm({
148
+ toolCall,
149
+ reason,
150
+ severity,
151
+ sessionId: scope?.sessionId,
152
+ agentId: scope?.agentId,
153
+ });
154
+ }
155
+ catch {
156
+ // 审批通道异常按拒绝处理(fail-safe);此处吞掉仅因异常不改变「不放行」结论
157
+ return false;
158
+ }
159
+ }
160
+ // ── 核心包装函数 ──
161
+ /**
162
+ * 带可靠性的 Agent 循环
163
+ *
164
+ * 包装 agentLoop(),注入所有可靠性行为。
165
+ */
166
+ export async function* runAgentWithReliability(context, config, harness, signal) {
167
+ const state = createInitialState(harness.config?.checkpointInterval ?? 15);
168
+ const relConfig = { ...DEFAULT_RELIABILITY_CONFIG, ...harness.config };
169
+ // per-run Budget:从 harness 模板克隆,避免长驻进程 / 并发 session 共享计数
170
+ let budget = harness.budget;
171
+ if (budget) {
172
+ budget = new BudgetPolicyEngine(budget.getConfig());
173
+ }
174
+ /** P1:run 级用量账本(只记账,不 kill) */
175
+ const ledger = new UsageLedger();
176
+ // ── 用于空响应/planning-only 重试的消息缓冲 ──
177
+ // onTurnComplete 将 steer 消息推入此数组,getFollowUpMessages 返回给 agentLoop
178
+ // 使循环在无 tool_calls 时也能继续执行重试
179
+ const pendingFollowUps = [];
180
+ // ── 注入安全检查到 beforeToolCall ──
181
+ const originalBeforeToolCall = config.beforeToolCall;
182
+ const wrappedConfig = {
183
+ ...config,
184
+ // getFollowUpMessages:返回 reliability 层注入的 steer 消息
185
+ getFollowUpMessages: async () => {
186
+ const msgs = [...pendingFollowUps];
187
+ pendingFollowUps.length = 0;
188
+ if (config.getFollowUpMessages) {
189
+ const callerMsgs = await config.getFollowUpMessages();
190
+ msgs.push(...callerMsgs);
191
+ }
192
+ return msgs;
193
+ },
194
+ // beforeToolCall:Budget hard 闸 + wrap-up 控制 + SecurityGuard 检查 + 原始回调
195
+ beforeToolCall: async (ctx, signal) => {
196
+ // Budget hard:阻止本批工具继续执行(turn_end 在工具之前 yield)
197
+ if (budget && !state.budgetStop) {
198
+ const hard = budget.checkHardOnly();
199
+ if (hard.status === 'hard') {
200
+ state.budgetStop = {
201
+ reason: hard.reason ?? 'wall_clock',
202
+ report: hard.report,
203
+ };
204
+ state.pendingBudgetHardYield = {
205
+ reason: (hard.reason ?? 'wall_clock'),
206
+ report: hard.report,
207
+ };
208
+ }
209
+ }
210
+ if (state.budgetStop) {
211
+ return {
212
+ block: true,
213
+ reason: `Budget exceeded (${typeof state.budgetStop === 'object' ? state.budgetStop.reason : 'wall_clock'})`,
214
+ terminate: true,
215
+ };
216
+ }
217
+ // P2 wrap-up:在 wrap-up 窗口内注入提示,阻止探索性工具调用
218
+ if (state.wrapUp) {
219
+ // 注入 wrap-up 提示(仅一次)
220
+ if (!state.wrapUp.hintInjected) {
221
+ state.wrapUp.hintInjected = true;
222
+ // 通过 getFollowUpMessages 注入提示
223
+ pendingFollowUps.push({
224
+ role: 'user',
225
+ content: state.wrapUp.userMessage,
226
+ timestamp: Date.now(),
227
+ });
228
+ }
229
+ // wrap-up 窗口内:允许只读工具,阻止写入工具
230
+ // 简化实现:允许所有工具,让模型自行决策
231
+ // 完整实现应检查工具类型(只读 vs 写入)
232
+ }
233
+ // SecurityGuard 检查
234
+ if (harness.security) {
235
+ const toolCheck = harness.security.checkToolCall(ctx.toolCall);
236
+ if (!toolCheck.isClean) {
237
+ const worst = toolCheck.violations.reduce((worst, v) => {
238
+ const order = { critical: 4, high: 3, medium: 2, low: 1 };
239
+ return order[v.severity] > order[worst.severity] ? v : worst;
240
+ }, toolCheck.violations[0]);
241
+ const action = severityToAction(worst.severity);
242
+ if (action === 'block' || action === 'reject' || action === 'confirm') {
243
+ // high:优先走人工确认;无审批通道或用户拒绝时回退 reject
244
+ if (action === 'confirm') {
245
+ const confirmed = await confirmHighRiskDecision(harness, ctx.toolCall, worst.description, worst.severity);
246
+ if (confirmed) {
247
+ // 确认放行:继续原始 beforeToolCall
248
+ if (originalBeforeToolCall) {
249
+ return originalBeforeToolCall(ctx, signal);
250
+ }
251
+ return undefined;
252
+ }
253
+ }
254
+ const scope = getRunScope();
255
+ state.pendingSecurityEvents.push({
256
+ type: 'security_blocked',
257
+ timestamp: Date.now(),
258
+ data: {
259
+ sessionId: scope?.sessionId,
260
+ agentId: scope?.agentId,
261
+ reason: worst.description,
262
+ toolName: ctx.toolCall.name,
263
+ action: action === 'confirm' ? 'reject' : action,
264
+ severity: worst.severity,
265
+ violations: toolCheck.violations.map((v) => ({
266
+ type: v.type,
267
+ severity: v.severity,
268
+ description: v.description,
269
+ })),
270
+ },
271
+ });
272
+ return {
273
+ block: true,
274
+ reason: worst.description,
275
+ terminate: action === 'block',
276
+ };
277
+ }
278
+ }
279
+ }
280
+ // 原始 beforeToolCall
281
+ if (originalBeforeToolCall) {
282
+ return originalBeforeToolCall(ctx, signal);
283
+ }
284
+ return undefined;
285
+ },
286
+ // afterToolCall:SecurityGuard 输出检查 + no-op 检测 + 原始回调
287
+ afterToolCall: async (ctx, signal) => {
288
+ // SecurityGuard 检查工具输出(字符串直扫;结构化结果序列化后扫,防 MCP/对象结果绕过)
289
+ if (harness.security && ctx.result.content != null) {
290
+ const raw = ctx.result.content;
291
+ const scanText = typeof raw === 'string'
292
+ ? raw
293
+ : (() => {
294
+ try {
295
+ return JSON.stringify(raw);
296
+ }
297
+ catch {
298
+ return String(raw);
299
+ }
300
+ })();
301
+ // 超大 payload 截断扫描,避免序列化字符串拖垮 checkToolOutput
302
+ const outputCheck = harness.security.checkToolOutput(scanText.length > 100_000 ? scanText.slice(0, 100_000) : scanText);
303
+ if (!outputCheck.isClean) {
304
+ const action = severityToAction(outputCheck.violations.reduce((worst, v) => {
305
+ const order = { critical: 4, high: 3, medium: 2, low: 1 };
306
+ return order[v.severity] > order[worst.severity] ? v : worst;
307
+ }, outputCheck.violations[0]).severity);
308
+ // 输出侧无「事前确认」语义:confirm/high 一律拦截该输出
309
+ if (action === 'block' || action === 'reject' || action === 'confirm') {
310
+ const reason = outputCheck.violations
311
+ .map((v) => v.description)
312
+ .filter(Boolean)
313
+ .join('; ');
314
+ return {
315
+ content: reason
316
+ ? `Blocked by SecurityGuard: ${reason}`
317
+ : 'Blocked by SecurityGuard: policy violation',
318
+ isError: true,
319
+ };
320
+ }
321
+ }
322
+ }
323
+ // 原始 afterToolCall
324
+ if (config.afterToolCall) {
325
+ return config.afterToolCall(ctx, signal);
326
+ }
327
+ return undefined;
328
+ },
329
+ // onTurnComplete:可靠性副作用(注入 steer 指令,不控制停止)
330
+ onTurnComplete: async (ctx) => {
331
+ // 一轮成功走到这里:重置模型错误 attempt
332
+ state.modelErrorAttempt = 0;
333
+ const hasToolCalls = ctx.toolResults.length > 0;
334
+ const contentText = getTextContent(ctx.message.content);
335
+ const hasContent = contentText.trim().length > 0;
336
+ const hasToolCallInMessage = ctx.message.toolCalls && ctx.message.toolCalls.length > 0;
337
+ // 0. 记录本轮摘要(token 在 generator 层从 turn_end.usage 累加)
338
+ const summary = {
339
+ role: 'assistant',
340
+ contentPreview: contentText.slice(0, 200),
341
+ toolCalls: ctx.message.toolCalls?.map(t => t.name),
342
+ toolErrors: ctx.toolResults.filter(r => r.isError).map(r => r.name),
343
+ tokenDelta: 0,
344
+ timestamp: Date.now(),
345
+ };
346
+ state.collector.recordTurn(summary);
347
+ state.hasProgress = state.collector.hasProgress();
348
+ // 0b. Budget hard(P0:无 soft 续租;nominal tokens 仅诊断)
349
+ if (budget && !state.budgetStop) {
350
+ const hardEval = budget.checkHardOnly();
351
+ if (hardEval.status === 'hard') {
352
+ state.budgetStop = {
353
+ reason: hardEval.reason ?? 'wall_clock',
354
+ report: hardEval.report,
355
+ };
356
+ state.pendingBudgetHardYield = {
357
+ reason: (hardEval.reason ?? 'wall_clock'),
358
+ report: hardEval.report,
359
+ };
360
+ }
361
+ }
362
+ // 1. Planning-only 检测
363
+ if (!hasToolCalls && isPlanningOnlyResponse(contentText, !!hasToolCallInMessage)) {
364
+ if (state.planningOnlyAttempts < relConfig.planningRetry.maxAttempts) {
365
+ state.planningOnlyAttempts++;
366
+ if (!state.planningOnlySteerInjected) {
367
+ pendingFollowUps.push({
368
+ role: 'user',
369
+ content: `[System: ${relConfig.planningRetry.steerInstruction}]`,
370
+ timestamp: Date.now(),
371
+ });
372
+ state.planningOnlySteerInjected = true;
373
+ }
374
+ }
375
+ }
376
+ else {
377
+ state.planningOnlyAttempts = 0;
378
+ state.planningOnlySteerInjected = false;
379
+ }
380
+ // 2. 空响应检测
381
+ if (!hasToolCalls && (!hasContent || contentText.trim().length === 0)) {
382
+ if (state.emptyResponseAttempts < relConfig.emptyResponseRetry.maxAttempts) {
383
+ state.emptyResponseAttempts++;
384
+ if (!state.emptyResponseSteerInjected) {
385
+ pendingFollowUps.push({
386
+ role: 'user',
387
+ content: `[System: ${relConfig.emptyResponseRetry.steerInstruction}]`,
388
+ timestamp: Date.now(),
389
+ });
390
+ state.emptyResponseSteerInjected = true;
391
+ }
392
+ }
393
+ }
394
+ else {
395
+ state.emptyResponseAttempts = 0;
396
+ state.emptyResponseSteerInjected = false;
397
+ }
398
+ // 3. No-op 检测
399
+ const noopCount = ctx.toolResults.filter(r => r.noop).length;
400
+ if (noopCount > 0) {
401
+ state.consecutiveNoops += noopCount;
402
+ if (state.consecutiveNoops >= relConfig.noopThreshold) {
403
+ // 第一次达到阈值:注入 hint
404
+ if (state.consecutiveNoops === relConfig.noopThreshold) {
405
+ ctx.context.messages.push({
406
+ role: 'user',
407
+ content: '[System: Multiple tool calls produced no result. Please try a different approach.]',
408
+ timestamp: Date.now(),
409
+ });
410
+ }
411
+ else {
412
+ // 超过阈值:标记停止 + 立即检查点
413
+ state._noopLoopStop = true;
414
+ state.forceCheckpoint = true;
415
+ state.collector.noteExternalSignal({
416
+ source: 'noop',
417
+ level: 'critical',
418
+ detail: `连续 ${state.consecutiveNoops} 次 noop`,
419
+ timestamp: Date.now(),
420
+ });
421
+ }
422
+ }
423
+ }
424
+ else {
425
+ state.consecutiveNoops = 0;
426
+ }
427
+ // 4. 工具循环检测
428
+ if (hasToolCalls && relConfig.loopDetection.enabled !== false) {
429
+ // 记录工具调用
430
+ for (const result of ctx.toolResults) {
431
+ // 从 message.toolCalls 中找到对应的 toolCall
432
+ const tc = ctx.message.toolCalls?.find(t => t.id === result.toolCallId);
433
+ state.toolCallHistory = recordToolCall(state.toolCallHistory, result.name, tc?.arguments ?? {}, result.isError ? null : result.content, result.isError ? result.content : undefined, { enabled: true, ...relConfig.loopDetection });
434
+ }
435
+ // 检测循环
436
+ const firstResult = ctx.toolResults[0];
437
+ if (firstResult) {
438
+ const tc = ctx.message.toolCalls?.find(t => t.id === firstResult.toolCallId);
439
+ const loopResult = detectNoProgressLoop(state.toolCallHistory, firstResult.name, tc?.arguments ?? {}, { enabled: true, ...relConfig.loopDetection });
440
+ if (loopResult.stuck) {
441
+ state.collector.noteExternalSignal({
442
+ source: 'tool_loop',
443
+ level: loopResult.level,
444
+ detail: loopResult.message,
445
+ timestamp: Date.now(),
446
+ });
447
+ if (loopResult.level === 'critical') {
448
+ // 高危信号:立即触发检查点(不等固定 interval)
449
+ state.forceCheckpoint = true;
450
+ if (state.loopCriticalTriggered) {
451
+ // 二次 critical:通过 shouldStopAfterTurn 停止
452
+ state._loopCriticalTwice = true;
453
+ }
454
+ else {
455
+ state.loopCriticalTriggered = true;
456
+ ctx.context.messages.push({
457
+ role: 'user',
458
+ content: `[System: ${loopResult.message} Stop calling tools and provide your final response based on the information gathered so far.]`,
459
+ timestamp: Date.now(),
460
+ });
461
+ }
462
+ }
463
+ else if (loopResult.level === 'warning') {
464
+ ctx.context.messages.push({
465
+ role: 'user',
466
+ content: `[System: ${loopResult.message}]`,
467
+ timestamp: Date.now(),
468
+ });
469
+ }
470
+ }
471
+ }
472
+ // 更新追踪指标
473
+ for (const result of ctx.toolResults) {
474
+ state.collector.recordToolResult(result.name, !result.isError, !!result.noop);
475
+ }
476
+ }
477
+ // 5. RunGuard 检查点(周期 + 高危即时)
478
+ if (harness.runGuard) {
479
+ state.checkpointIterationCount++;
480
+ const due = state.forceCheckpoint ||
481
+ state.checkpointIterationCount >= state.currentCheckpointInterval;
482
+ if (due) {
483
+ state.checkpointIterationCount = 0;
484
+ state.forceCheckpoint = false;
485
+ try {
486
+ // I1:checkpoint 身份优先 RunScope ALS(harness.sessionId 仅为回退)
487
+ const scope = getRunScope();
488
+ const ctxForGuard = state.collector.buildContext({
489
+ sessionId: scope?.sessionId ?? harness.sessionId,
490
+ agentId: scope?.agentId ?? harness.agentId,
491
+ });
492
+ const verdict = await harness.runGuard.checkpoint(ctxForGuard);
493
+ if (verdict.action === 'stop') {
494
+ state.runGuardStop = {
495
+ reason: verdict.reason,
496
+ userMessage: verdict.userMessage,
497
+ };
498
+ }
499
+ else if (verdict.action === 'recover') {
500
+ // 一次 checkpoint 只记 1 条 recovery(避免多 action 放大升级计数)
501
+ const primary = verdict.recoveryActions?.[0]?.type ?? 'inject_hint';
502
+ if (verdict.recoveryActions?.length) {
503
+ executeRecoveryActions(verdict.recoveryActions, ctx.context.messages);
504
+ }
505
+ state.collector.recordRecovery({
506
+ iteration: ctxForGuard.iteration,
507
+ actionType: primary,
508
+ reason: verdict.reason,
509
+ failureKind: verdict.failureKind,
510
+ timestamp: Date.now(),
511
+ });
512
+ state.runGuardRecovered = {
513
+ reason: verdict.reason,
514
+ actions: (verdict.recoveryActions ?? []).map(a => a.type),
515
+ };
516
+ }
517
+ if (verdict.nextCheckpointIn && verdict.nextCheckpointIn > 0) {
518
+ state.currentCheckpointInterval = verdict.nextCheckpointIn;
519
+ }
520
+ state.lastCheckpointIteration = ctxForGuard.iteration;
521
+ // 检查点后清空已消费的 external signals
522
+ state.collector.drainExternalSignals();
523
+ }
524
+ catch {
525
+ // 监督节点出错不影响主循环
526
+ }
527
+ }
528
+ }
529
+ else {
530
+ state.checkpointIterationCount++;
531
+ }
532
+ // 调用用户的 onTurnComplete(如果有)
533
+ if (config.onTurnComplete) {
534
+ await config.onTurnComplete(ctx);
535
+ }
536
+ },
537
+ // shouldStopAfterTurn:停止决策
538
+ shouldStopAfterTurn: async (ctx) => {
539
+ // 0. Budget hard
540
+ if (state.budgetStop) {
541
+ return true;
542
+ }
543
+ // 1. 二次循环 critical → 停止
544
+ if (state._loopCriticalTwice) {
545
+ return true;
546
+ }
547
+ // 2. RunGuard 要求停止
548
+ if (state.runGuardStop) {
549
+ return true;
550
+ }
551
+ // 3. No-op 循环超限 → 停止
552
+ if (state._noopLoopStop) {
553
+ return true;
554
+ }
555
+ // 4. 用户的停止条件
556
+ if (config.shouldStopAfterTurn) {
557
+ return config.shouldStopAfterTurn(ctx);
558
+ }
559
+ return false;
560
+ },
561
+ // onError:错误分类 + ErrorStrategy
562
+ // Loop 契约:只允许 'retry' | 'abort';业务错误永不 throw
563
+ onError: async (error) => {
564
+ const classified = classifyError(error);
565
+ const attempt = state.modelErrorAttempt;
566
+ state.modelErrorAttempt++;
567
+ // ErrorStrategy 决策(attempt 从 0 起,与 DefaultErrorStrategy 的 attempt < N 对齐)
568
+ // skip 在 Loop 层无对应动作,映射为 abort;模型灾备用 FallbackProvider,不在此切换
569
+ if (harness.errorStrategy) {
570
+ const action = harness.errorStrategy.onModelError(classified, attempt);
571
+ if (action.action === 'retry') {
572
+ if (action.delayMs > 0) {
573
+ await new Promise(resolve => setTimeout(resolve, action.delayMs));
574
+ }
575
+ return 'retry';
576
+ }
577
+ return 'abort';
578
+ }
579
+ // 默认:重试 rate_limit / timeout / server(最多 3 次,避免无界重试)
580
+ if (classified.reason === 'rate_limit' || classified.reason === 'timeout' || classified.reason === 'server') {
581
+ if (attempt < 3) {
582
+ const delayMs = classified.retryAfterMs ?? (attempt + 1) * 1000;
583
+ if (delayMs > 0) {
584
+ await new Promise(resolve => setTimeout(resolve, delayMs));
585
+ }
586
+ return 'retry';
587
+ }
588
+ return 'abort';
589
+ }
590
+ return 'abort';
591
+ },
592
+ };
593
+ // 运行核心循环:拦截事件以计量 token / 注入 budget & run_guard 用户可见事件(不变量 #6)
594
+ for await (const event of agentLoop(context, wrappedConfig, signal)) {
595
+ // SecurityGuard 拦截(beforeToolCall 推入 pending,此处 yield)
596
+ while (state.pendingSecurityEvents.length > 0) {
597
+ const sec = state.pendingSecurityEvents.shift();
598
+ yield sec;
599
+ }
600
+ // Observer:run 结束前附带 RunMetricsCollector 快照(P1 Guard 面板)
601
+ if (event.type === 'agent_end') {
602
+ const scope = getRunScope();
603
+ const runSnapshot = ledger.snapshot({
604
+ scope: 'run',
605
+ sessionId: scope?.sessionId,
606
+ agentId: scope?.agentId,
607
+ });
608
+ // P4: 合并 run 级快照到 session 级账本
609
+ const sessionLedger = harness.sessionLedger;
610
+ if (sessionLedger) {
611
+ sessionLedger.mergeRunSnapshot(runSnapshot);
612
+ }
613
+ yield {
614
+ type: 'run_guard_metrics',
615
+ timestamp: Date.now(),
616
+ data: {
617
+ ...state.collector.toObserverSnapshot({
618
+ sessionId: scope?.sessionId,
619
+ agentId: scope?.agentId,
620
+ }),
621
+ usageLedger: runSnapshot,
622
+ sessionLedger: sessionLedger?.snapshot(),
623
+ },
624
+ };
625
+ }
626
+ if (event.type === 'tool_end') {
627
+ // maxToolCalls 计量(显式配置时才硬停)
628
+ budget?.recordToolCall(1);
629
+ ledger.recordToolCall(1);
630
+ // Summary LLM usage 归因(capabilities/summary 产生的 LLM 调用)
631
+ const toolResult = event.result;
632
+ if (toolResult.summaryUsage) {
633
+ ledger.recordUsage(toolResult.summaryUsage, { summary: true });
634
+ }
635
+ }
636
+ if (event.type === 'turn_end') {
637
+ // P0/P1:nominal tokens 入账诊断 + UsageLedger;不触发 spend hard
638
+ if (event.usage && !event.error) {
639
+ const nominal = nominalTotalTokens(event.usage);
640
+ state.collector.recordTokens(nominal);
641
+ budget?.consumeTokens(nominal);
642
+ ledger.recordUsage(event.usage);
643
+ }
644
+ budget?.recordIteration();
645
+ // P5: 更新 context 压力信息
646
+ if (harness.getContextPressure) {
647
+ const pressure = harness.getContextPressure();
648
+ if (pressure) {
649
+ ledger.updateContextPressure(pressure.estimatedTokens, pressure.contextWindow);
650
+ }
651
+ }
652
+ // P3 Advisory 告警(接近阈值时告警,不终止)
653
+ if (!state.budgetStop) {
654
+ const advisory = relConfig.advisory;
655
+ const snapshot = ledger.snapshot({ scope: 'run' });
656
+ if (advisory && !state.advisoryTriggered.has(advisory.unit)) {
657
+ let currentValue = 0;
658
+ if (advisory.unit === 'wall_clock_ms' && budget) {
659
+ currentValue = budget.report().elapsedMs;
660
+ }
661
+ else if (advisory.unit === 'uncached_input_tokens') {
662
+ currentValue = snapshot.inputUncachedTokens;
663
+ }
664
+ else if (advisory.unit === 'output_tokens') {
665
+ currentValue = snapshot.outputTokens;
666
+ }
667
+ else if (advisory.unit === 'llm_calls') {
668
+ currentValue = snapshot.llmCalls;
669
+ }
670
+ else if (advisory.unit === 'cost' && relConfig.policyPricing) {
671
+ currentValue = estimateCost(snapshot, relConfig.policyPricing);
672
+ }
673
+ if (currentValue >= advisory.threshold) {
674
+ state.advisoryTriggered.add(advisory.unit);
675
+ yield {
676
+ type: 'usage.advisory',
677
+ timestamp: Date.now(),
678
+ metric: 'policy',
679
+ unit: advisory.unit,
680
+ used: currentValue,
681
+ hard: advisory.threshold,
682
+ userMessage: `[Advisory] ${advisory.unit} 接近阈值(${currentValue} / ${advisory.threshold})`,
683
+ };
684
+ }
685
+ }
686
+ }
687
+ // P3 Policy 单位评估
688
+ if (!state.wrapUp && !state.budgetStop) {
689
+ const policyUnits = relConfig.policyUnits;
690
+ const snapshot = ledger.snapshot({ scope: 'run' });
691
+ const onPolicyHit = relConfig.wrapUp?.onPolicyHit ?? 'wrap_up_then_stop';
692
+ const wrapUpTurns = relConfig.wrapUp?.turns ?? 3;
693
+ if (policyUnits) {
694
+ // 检查所有 policy 单位,找到第一个超限的
695
+ let exceededUnit;
696
+ let exceededUsed = 0;
697
+ let exceededHard = 0;
698
+ if (policyUnits.maxUncachedInputTokens && snapshot.inputUncachedTokens >= policyUnits.maxUncachedInputTokens) {
699
+ exceededUnit = 'uncached_input_tokens';
700
+ exceededUsed = snapshot.inputUncachedTokens;
701
+ exceededHard = policyUnits.maxUncachedInputTokens;
702
+ }
703
+ else if (policyUnits.maxOutputTokens && snapshot.outputTokens >= policyUnits.maxOutputTokens) {
704
+ exceededUnit = 'output_tokens';
705
+ exceededUsed = snapshot.outputTokens;
706
+ exceededHard = policyUnits.maxOutputTokens;
707
+ }
708
+ else if (policyUnits.maxLlmCalls && snapshot.llmCalls >= policyUnits.maxLlmCalls) {
709
+ exceededUnit = 'llm_calls';
710
+ exceededUsed = snapshot.llmCalls;
711
+ exceededHard = policyUnits.maxLlmCalls;
712
+ }
713
+ else if (policyUnits.maxCost && relConfig.policyPricing) {
714
+ const estimatedCost = estimateCost(snapshot, relConfig.policyPricing);
715
+ if (estimatedCost >= policyUnits.maxCost) {
716
+ exceededUnit = 'cost';
717
+ exceededUsed = estimatedCost;
718
+ exceededHard = policyUnits.maxCost;
719
+ }
720
+ }
721
+ // 根据 onPolicyHit 配置决定行为
722
+ if (exceededUnit) {
723
+ const userMessage = `[Resource] ${exceededUnit} 超限(${exceededUsed.toFixed?.(2) ?? exceededUsed} / ${exceededHard})`;
724
+ if (onPolicyHit === 'wrap_up_then_stop') {
725
+ // 先 wrap-up,再 stop
726
+ state.wrapUp = {
727
+ reason: 'policy',
728
+ turnsRemaining: wrapUpTurns,
729
+ userMessage: `${userMessage}。停止新的探索性工具调用;基于已有信息输出结论、证据与未完成项。`,
730
+ hintInjected: false,
731
+ };
732
+ yield {
733
+ type: 'budget.wrap_up',
734
+ timestamp: Date.now(),
735
+ metric: 'policy',
736
+ unit: exceededUnit,
737
+ used: exceededUsed,
738
+ hard: exceededHard,
739
+ userMessage: state.wrapUp.userMessage,
740
+ resumeHint: 'Run 已因 policy 超限进入 wrap-up 模式,请输出阶段性结论。',
741
+ };
742
+ }
743
+ else {
744
+ // 直接 stop
745
+ state.budgetStop = {
746
+ reason: 'policy',
747
+ report: { unit: exceededUnit, used: exceededUsed, hard: exceededHard },
748
+ };
749
+ yield {
750
+ type: 'budget.exceeded',
751
+ timestamp: Date.now(),
752
+ metric: 'policy',
753
+ unit: exceededUnit,
754
+ used: exceededUsed,
755
+ hard: exceededHard,
756
+ userMessage,
757
+ resumeHint: `Run 已因 ${exceededUnit} 超限而停止。`,
758
+ };
759
+ }
760
+ }
761
+ }
762
+ }
763
+ // P2 wrap-up 控制梯:检查是否需要进入 wrap-up
764
+ if (!state.wrapUp && !state.budgetStop) {
765
+ const wrapUpConfig = relConfig.wrapUp;
766
+ const wrapUpTurns = wrapUpConfig?.turns ?? 3;
767
+ const contextRatio = wrapUpConfig?.contextRatio ?? 0.85;
768
+ // 检查 context 轴 wrap-up(contextEstTokens / contextWindowTokens)
769
+ const snapshot = ledger.snapshot({ scope: 'run' });
770
+ if (snapshot.contextEstTokens && snapshot.contextWindowTokens) {
771
+ const contextPressure = snapshot.contextEstTokens / snapshot.contextWindowTokens;
772
+ if (contextPressure >= contextRatio) {
773
+ state.wrapUp = {
774
+ reason: 'context',
775
+ turnsRemaining: wrapUpTurns,
776
+ userMessage: `[Context] 上下文压力接近上限(${Math.round(contextPressure * 100)}%)。停止新的探索性工具调用;基于已有信息输出结论、证据与未完成项。`,
777
+ hintInjected: false,
778
+ };
779
+ yield {
780
+ type: 'budget.wrap_up',
781
+ timestamp: Date.now(),
782
+ metric: 'context',
783
+ contextEst: snapshot.contextEstTokens,
784
+ contextWindow: snapshot.contextWindowTokens,
785
+ userMessage: state.wrapUp.userMessage,
786
+ resumeHint: 'Run 已因 context 压力进入 wrap-up 模式,请输出阶段性结论。',
787
+ };
788
+ }
789
+ }
790
+ // 检查 wall-clock wrap-up 阈值(默认 85% of maxWallClockMs)
791
+ if (!state.wrapUp && budget) {
792
+ const report = budget.report();
793
+ const maxWallClock = report.hard.wallClockMs;
794
+ const wrapUpThreshold = maxWallClock * contextRatio;
795
+ if (report.elapsedMs >= wrapUpThreshold) {
796
+ state.wrapUp = {
797
+ reason: 'policy',
798
+ turnsRemaining: wrapUpTurns,
799
+ userMessage: `[Resource] 预算策略接近上限(wall_clock: ${Math.round(report.elapsedMs / 1000)}s / ${Math.round(maxWallClock / 1000)}s)。停止新的探索性工具调用;基于已有信息输出结论、证据与未完成项。`,
800
+ hintInjected: false,
801
+ };
802
+ yield {
803
+ type: 'budget.wrap_up',
804
+ timestamp: Date.now(),
805
+ metric: 'policy',
806
+ unit: 'wall_clock_ms',
807
+ used: report.elapsedMs,
808
+ hard: maxWallClock,
809
+ userMessage: state.wrapUp.userMessage,
810
+ resumeHint: 'Run 已进入 wrap-up 模式,请输出阶段性结论。',
811
+ };
812
+ }
813
+ }
814
+ }
815
+ // wrap-up 窗口倒计时
816
+ if (state.wrapUp) {
817
+ state.wrapUp.turnsRemaining--;
818
+ if (state.wrapUp.turnsRemaining <= 0) {
819
+ // wrap-up 窗口结束,触发 stop
820
+ state.budgetStop = {
821
+ reason: state.wrapUp.reason,
822
+ report: { wrapUp: true },
823
+ };
824
+ yield {
825
+ type: 'budget.exceeded',
826
+ timestamp: Date.now(),
827
+ metric: state.wrapUp.reason === 'context' ? 'context' : 'policy',
828
+ userMessage: state.wrapUp.userMessage,
829
+ resumeHint: 'Run 已因 wrap-up 窗口结束而停止。',
830
+ };
831
+ }
832
+ }
833
+ if (budget && !state.budgetStop && !state.wrapUp) {
834
+ const hardResult = budget.checkHardOnly();
835
+ if (hardResult.status === 'hard') {
836
+ state.budgetStop = {
837
+ reason: hardResult.reason ?? 'wall_clock',
838
+ report: hardResult.report,
839
+ };
840
+ yield {
841
+ type: 'budget_exceeded',
842
+ timestamp: Date.now(),
843
+ data: {
844
+ reason: (hardResult.reason ?? 'wall_clock'),
845
+ report: hardResult.report,
846
+ },
847
+ };
848
+ }
849
+ }
850
+ }
851
+ // onTurnComplete 补判的 hard
852
+ if (state.pendingBudgetHardYield) {
853
+ const hard = state.pendingBudgetHardYield;
854
+ state.pendingBudgetHardYield = false;
855
+ yield {
856
+ type: 'budget_exceeded',
857
+ timestamp: Date.now(),
858
+ data: { reason: hard.reason, report: hard.report },
859
+ };
860
+ }
861
+ // RunGuard 裁决的用户可见事件
862
+ if (state.runGuardStop) {
863
+ const stop = state.runGuardStop;
864
+ state.runGuardStop = false;
865
+ yield {
866
+ type: 'run_guard_stopped',
867
+ timestamp: Date.now(),
868
+ data: { reason: stop.reason, userMessage: stop.userMessage },
869
+ };
870
+ }
871
+ else if (state.runGuardRecovered) {
872
+ const rec = state.runGuardRecovered;
873
+ state.runGuardRecovered = false;
874
+ yield {
875
+ type: 'run_guard_recovered',
876
+ timestamp: Date.now(),
877
+ data: { reason: rec.reason, actions: rec.actions },
878
+ };
879
+ }
880
+ yield event;
881
+ }
882
+ }
883
+ // ── 辅助函数 ──
884
+ function executeRecoveryActions(actions, messages) {
885
+ for (const action of actions) {
886
+ switch (action.type) {
887
+ case 'truncate_context': {
888
+ const keepRecent = action.keepRecent ?? 8;
889
+ let systemEnd = 0;
890
+ while (systemEnd < messages.length && messages[systemEnd].role === 'system')
891
+ systemEnd++;
892
+ const nonSystemCount = messages.length - systemEnd;
893
+ const removeCount = nonSystemCount - Math.min(keepRecent, nonSystemCount);
894
+ if (removeCount > 0) {
895
+ messages.splice(systemEnd, removeCount, {
896
+ role: 'user',
897
+ content: `[System: ${removeCount} earlier messages omitted to fit context window.]`,
898
+ timestamp: Date.now(),
899
+ });
900
+ }
901
+ break;
902
+ }
903
+ case 'clear_recent_turns': {
904
+ const count = action.count ?? 2;
905
+ // 从末尾回删 count 条非 system 消息(每条可能是一轮 assistant 或 tool)
906
+ let removed = 0;
907
+ while (removed < count && messages.length > 0) {
908
+ const last = messages[messages.length - 1];
909
+ if (last.role === 'system')
910
+ break;
911
+ messages.pop();
912
+ removed++;
913
+ }
914
+ if (removed > 0) {
915
+ messages.push({
916
+ role: 'user',
917
+ content: `[System: ${removed} recent messages cleared to recover from a stuck loop.]`,
918
+ timestamp: Date.now(),
919
+ });
920
+ }
921
+ break;
922
+ }
923
+ case 'inject_hint':
924
+ messages.push({
925
+ role: 'user',
926
+ content: `[System: ${action.hint}]`,
927
+ timestamp: Date.now(),
928
+ });
929
+ break;
930
+ }
931
+ }
932
+ }