@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,1414 @@
1
+ /**
2
+ * AgentBuilder — Fluent API 组装器
3
+ *
4
+ * 集成方的主要入口。一行代码启动 Agent。
5
+ *
6
+ * 使用示例:
7
+ * ```ts
8
+ * const { engine, runner } = new AgentBuilder()
9
+ * .model('gpt-5.5')
10
+ * .persona('./personas/my-agent')
11
+ * .tool(myTool)
12
+ * .budget({ maxIterations: 15 })
13
+ * .build();
14
+ * ```
15
+ */
16
+ import { DefaultToolBus } from '../extension/plugin-ecosystem/tools/tool-bus.js';
17
+ import { Agent } from '../run/agent/index.js';
18
+ import { DEFAULT_RELIABILITY_CONFIG } from '../run/reliability/run-agent.js';
19
+ import { DefaultRunGuard } from '../run/run-guard/default-run-guard.js';
20
+ import { summarizeLlmMessages } from '../observability/observer/types.js';
21
+ import { SessionTaskService } from '../session/tasks/service.js';
22
+ import { createSessionTaskTools } from '../session/tasks/tools.js';
23
+ import { InMemorySessionStore } from '../session/in-memory-store.js';
24
+ import { DefaultEventBus, } from '@octopi-agent/core/primitives/event-bus.js';
25
+ import { DefaultSecurityGuard, } from '../governance/security/default-security-guard.js';
26
+ import { BudgetPolicyEngine, } from '../run/budget/budget.js';
27
+ import { PersonaSource } from './persona.js';
28
+ import { getRunScope } from '../run/run-scope.js';
29
+ import { DefaultContextEngine } from '../context/default-context-engine.js';
30
+ import { createProviderSummarize } from '../context/summarize.js';
31
+ import { createDefaultSystemPromptAssembler } from '../context/system-prompt-assembler.js';
32
+ import { SessionAwareRunner } from '../run/runner.js';
33
+ import { DefaultMcpManager } from '../extension/plugin-ecosystem/mcp/manager.js';
34
+ // ── 默认实现 ──
35
+ /** 默认错误策略(简单重试 + 中止) */
36
+ class DefaultErrorStrategy {
37
+ onModelError(error, attempt) {
38
+ // ── 可重试错误:限流、超时、网络、服务端 ──
39
+ if (error.reason === 'rate_limit' && attempt < 3) {
40
+ const delayMs = error.retryAfterMs ?? (attempt + 1) * 1000;
41
+ return { action: 'retry', delayMs };
42
+ }
43
+ if (error.reason === 'timeout' && attempt < 3) {
44
+ return { action: 'retry', delayMs: (attempt + 1) * 1000 };
45
+ }
46
+ if (error.reason === 'network' && attempt < 3) {
47
+ return { action: 'retry', delayMs: (attempt + 1) * 1500 };
48
+ }
49
+ if (error.reason === 'server' && attempt < 2) {
50
+ return { action: 'retry', delayMs: (attempt + 1) * 2000 };
51
+ }
52
+ // ── context_length:由引擎尝试 compact,这里返回 abort 让引擎决定 ──
53
+ if (error.reason === 'context_length') {
54
+ return { action: 'abort', reason: `Context length exceeded: ${error.message}` };
55
+ }
56
+ // ── 不可重试错误:认证、计费 ──
57
+ if (error.reason === 'auth') {
58
+ return { action: 'abort', reason: `Authentication failed: ${error.message}` };
59
+ }
60
+ if (error.reason === 'billing') {
61
+ return { action: 'abort', reason: `Billing issue: ${error.message}` };
62
+ }
63
+ // ── 默认:终止 ──
64
+ return { action: 'abort', reason: error.message };
65
+ }
66
+ onToolError(error, _call) {
67
+ // 工具错误默认跳过,让 LLM 看到错误信息后自行调整
68
+ return { action: 'skip', reason: error.message || 'Tool execution failed' };
69
+ }
70
+ onContextOverflow(_tokenCount, _limit) {
71
+ return { action: 'compact' };
72
+ }
73
+ onSecurityViolation(violation) {
74
+ if (violation.severity === 'critical') {
75
+ return { action: 'block', reason: violation.description };
76
+ }
77
+ return { action: 'warn', reason: violation.description };
78
+ }
79
+ }
80
+ class RuntimeToolContextProvider {
81
+ sessionId = '';
82
+ agentId = '';
83
+ messages = [];
84
+ cwd;
85
+ constructor(defaults) {
86
+ this.cwd = defaults?.cwd?.trim() ? defaults.cwd : undefined;
87
+ }
88
+ setRuntime(sessionId, agentId, messages) {
89
+ this.sessionId = sessionId;
90
+ this.agentId = agentId;
91
+ this.messages = messages;
92
+ }
93
+ get() {
94
+ // I1:优先 RunScope ALS(并发 session 下不可依赖单槽 setRuntime)
95
+ const scope = getRunScope();
96
+ if (scope?.toolRuntime) {
97
+ return {
98
+ sessionId: scope.toolRuntime.sessionId,
99
+ agentId: scope.toolRuntime.agentId,
100
+ messages: scope.toolRuntime.messages,
101
+ cwd: scope.toolRuntime.cwd ?? this.cwd,
102
+ attachmentRoots: scope.toolRuntime.attachmentRoots,
103
+ };
104
+ }
105
+ if (scope) {
106
+ return {
107
+ sessionId: scope.sessionId,
108
+ agentId: scope.agentId,
109
+ messages: this.messages,
110
+ cwd: this.cwd,
111
+ };
112
+ }
113
+ return { sessionId: this.sessionId, agentId: this.agentId, messages: this.messages, cwd: this.cwd };
114
+ }
115
+ }
116
+ /**
117
+ * 将 RegisteredTool 转换为 AgentTool(新循环格式)
118
+ */
119
+ function convertToAgentTool(tool, contextProvider) {
120
+ return {
121
+ name: tool.definition.name,
122
+ description: tool.definition.description,
123
+ parameters: {
124
+ type: 'object',
125
+ properties: Object.fromEntries(Object.entries(tool.definition.parameters).map(([key, param]) => [
126
+ key,
127
+ { type: param.type, description: param.description, ...(param.enum && { enum: param.enum }) },
128
+ ])),
129
+ required: Object.entries(tool.definition.parameters)
130
+ .filter(([, param]) => param.required)
131
+ .map(([key]) => key),
132
+ },
133
+ execute: async (toolCallId, args, signal) => {
134
+ const startTime = Date.now();
135
+ try {
136
+ const context = contextProvider.get();
137
+ const result = await tool.handler(args, { ...context, abortSignal: signal });
138
+ return {
139
+ toolCallId,
140
+ name: tool.definition.name,
141
+ content: result,
142
+ durationMs: Date.now() - startTime,
143
+ };
144
+ }
145
+ catch (error) {
146
+ return {
147
+ toolCallId,
148
+ name: tool.definition.name,
149
+ content: `Error: ${error instanceof Error ? error.message : String(error)}`,
150
+ isError: true,
151
+ durationMs: Date.now() - startTime,
152
+ };
153
+ }
154
+ },
155
+ };
156
+ }
157
+ // ── Builder ──
158
+ /** ModelProvider 未声明 contextWindow 时的默认窗口(产品默认 200k) */
159
+ /**
160
+ * 配置层历史常量。禁止用作引擎运行时 contextWindow 预算(未声明 = 未知)。
161
+ */
162
+ import { DEFAULT_CONTEXT_WINDOW } from '@octopi-agent/core/types/model-info.js';
163
+ export { DEFAULT_CONTEXT_WINDOW };
164
+ /** 按允许/禁止列表判断子系统是否可注册;deny 优先;支持 packageId 与 `id`/`id.*` 前缀 */
165
+ export function isSubsystemAllowed(id, allowlist, denylist, packageId) {
166
+ const match = (list, key, pkg) => {
167
+ if (!list || list.length === 0)
168
+ return false;
169
+ return list.some((entry) => {
170
+ if (!entry)
171
+ return false;
172
+ if (entry === key)
173
+ return true;
174
+ if (pkg && entry === pkg)
175
+ return true;
176
+ if (entry.endsWith('.*') && key.startsWith(entry.slice(0, -1)))
177
+ return true;
178
+ if (entry.endsWith('*') && !entry.endsWith('.*') && key.startsWith(entry.slice(0, -1)))
179
+ return true;
180
+ return false;
181
+ });
182
+ };
183
+ if (match(denylist, id, packageId))
184
+ return false;
185
+ if (allowlist && allowlist.length > 0 && !match(allowlist, id, packageId))
186
+ return false;
187
+ return true;
188
+ }
189
+ /** 缺省子系统搜索:cwd + 包根(兼容 src 开发态与 dist 发布态) */
190
+ async function defaultSubsystemSearchDirs(override) {
191
+ const { existsSync } = await import('node:fs');
192
+ const { join, resolve, dirname } = await import('node:path');
193
+ const { fileURLToPath } = await import('node:url');
194
+ const { homedir } = await import('node:os');
195
+ const here = dirname(fileURLToPath(import.meta.url));
196
+ // builder 在 <root>/src|dist/harness/agent/
197
+ const pkgRoot = resolve(here, '../../..');
198
+ const cwd = process.cwd();
199
+ const sep = here.includes('\\') ? '\\' : '/';
200
+ const runningFromDist = here.includes(`${sep}dist${sep}`) || here.endsWith(`${sep}dist`);
201
+ const { readdirSync } = await import('node:fs');
202
+ const hasLoadableSubsystem = (dir) => {
203
+ try {
204
+ if (!existsSync(dir))
205
+ return false;
206
+ return readdirSync(dir, { withFileTypes: true }).some((e) => {
207
+ if (!e.isDirectory() || e.name.startsWith('.'))
208
+ return false;
209
+ const pkg = join(dir, e.name);
210
+ if (existsSync(join(pkg, 'config.yaml')) || existsSync(join(pkg, 'SUBSYSTEM.md'))) {
211
+ return true;
212
+ }
213
+ // 多 spec 包:子目录含 config/SUBSYSTEM.md
214
+ try {
215
+ return readdirSync(pkg, { withFileTypes: true }).some((c) => {
216
+ if (!c.isDirectory() || c.name.startsWith('.') || c.name === 'shared' || c.name === 'lib') {
217
+ return false;
218
+ }
219
+ const child = join(pkg, c.name);
220
+ return existsSync(join(child, 'config.yaml')) || existsSync(join(child, 'SUBSYSTEM.md'));
221
+ });
222
+ }
223
+ catch {
224
+ return false;
225
+ }
226
+ });
227
+ }
228
+ catch {
229
+ return false;
230
+ }
231
+ };
232
+ const builtinCandidates = override?.builtin
233
+ ? [override.builtin]
234
+ : runningFromDist
235
+ ? [
236
+ resolve(pkgRoot, 'dist', 'subsystems'),
237
+ join(here, '..', '..', 'subsystems'),
238
+ resolve(cwd, 'dist', 'subsystems'),
239
+ resolve(pkgRoot, 'src', 'subsystems'),
240
+ resolve(cwd, 'src', 'subsystems'),
241
+ ]
242
+ : [
243
+ resolve(cwd, 'src', 'subsystems'),
244
+ resolve(pkgRoot, 'src', 'subsystems'),
245
+ join(here, '..', '..', 'subsystems'),
246
+ resolve(pkgRoot, 'dist', 'subsystems'),
247
+ resolve(cwd, 'dist', 'subsystems'),
248
+ ];
249
+ // 选第一个「目录下至少有一个含 config.yaml / SUBSYSTEM.md 的子系统包」的路径
250
+ let builtin;
251
+ for (const candidate of builtinCandidates) {
252
+ if (hasLoadableSubsystem(candidate)) {
253
+ builtin = candidate;
254
+ break;
255
+ }
256
+ }
257
+ return {
258
+ builtin,
259
+ user: override?.user ?? join(homedir(), '.octopi', 'subsystems'),
260
+ project: override?.project ?? join(cwd, '.octopi', 'subsystems'),
261
+ npm: override?.npm ?? join(cwd, 'node_modules'),
262
+ };
263
+ }
264
+ /** 缺省子系统搜索并加载 spec(供 build 自动发现与 serve 启动日志共用) */
265
+ export async function discoverSubsystemSpecs(override) {
266
+ const dirs = await defaultSubsystemSearchDirs(override);
267
+ const { SubsystemLoader } = await import('../collaboration/autonomous-subsystem/loader.js');
268
+ const loader = new SubsystemLoader({
269
+ builtinDir: dirs.builtin,
270
+ userDir: dirs.user,
271
+ projectDir: dirs.project,
272
+ npmDir: dirs.npm,
273
+ });
274
+ return loader.loadAll();
275
+ }
276
+ import { getRunTelemetryFactory } from '../observability/run-telemetry.js';
277
+ /**
278
+ * AgentBuilder — Fluent API
279
+ */
280
+ export class AgentBuilder {
281
+ // Core 组件
282
+ _model;
283
+ _toolBus = new DefaultToolBus();
284
+ _contextEngine;
285
+ _summarize;
286
+ /** 最新的 context 压力信息(由 convertToLlm 更新) */
287
+ _lastContextPressure;
288
+ /** 为 true 时禁止自动挂默认 summarize(测试/特殊场景) */
289
+ _disableAutoSummarize = false;
290
+ _events;
291
+ _security;
292
+ _riskPolicy;
293
+ _budget;
294
+ _errorStrategy;
295
+ _confirmHighRisk;
296
+ _observer;
297
+ _runGuard;
298
+ _runGuardConfig;
299
+ _checkpointInterval;
300
+ _reliabilityConfig;
301
+ // Harness 组件
302
+ _personaWorkspaces = [];
303
+ _systemPrompt;
304
+ /** Skill 目录(SKILL.md);build 时 discover 并注入 system prompt 索引 */
305
+ _skillDirectory;
306
+ _skillManager;
307
+ /** 记忆检索(注入 system prompt MemoryLayer) */
308
+ _memoryStore;
309
+ _backfillCoverage;
310
+ _constitutionConfig;
311
+ _memoryConfig;
312
+ /** Knowledge Tier 0 catalog(system 注入「有哪些源」) */
313
+ _knowledgeCatalog;
314
+ _knowledgeCatalogOpts;
315
+ /** Knowledge 检索(P4 grounding + 工具) */
316
+ _knowledgeRetriever;
317
+ _knowledgeIndexStore;
318
+ _knowledgeSourceStore;
319
+ _knowledgeHitLog;
320
+ _knowledgeGrounding;
321
+ /** 智慧(注入 system prompt WisdomLayer) */
322
+ _wisdomStore;
323
+ /** 认知图谱(注入 system prompt CognitionLayer) */
324
+ _cognitionStore;
325
+ /** system prompt 装配器调参 */
326
+ _contextAssemblerConfig;
327
+ /** 文件式 persona 的 run 时解析器(指纹缓存,改文件下一轮生效) */
328
+ _personaResolver;
329
+ /** build 时从磁盘读到的纯 persona(可能为空;不含默认 tools prompt) */
330
+ _initialPersonaContent;
331
+ _securityConfig;
332
+ /** 产品级观测采集意图(具体后端用 .observer() 或已注册 RunTelemetryFactory) */
333
+ _traceOptions;
334
+ /** 观测装配工厂(宿主注入;`octopi` 入口默认注册) */
335
+ _telemetryFactory;
336
+ /** build 时装配出的观测句柄 */
337
+ _telemetry;
338
+ // Runner 配置
339
+ _store;
340
+ _runnerConfig;
341
+ /** 产品 Observer Hub(ContextEngine 出口 → LLM 视图) */
342
+ _observerHub;
343
+ /** 工具效应隔离(I5);Runner 解析 toolRuntime.cwd */
344
+ _toolIsolation;
345
+ // MCP 配置
346
+ _mcpConfigs = [];
347
+ /** MCP client 工厂(Integration 适配器由宿主注入) */
348
+ _mcpClientFactory;
349
+ // 自主子系统配置
350
+ _subsystemSpecs = [];
351
+ _subsystemAuditDir;
352
+ _modelLevels;
353
+ _subsystemDir;
354
+ _subsystemAllowlist;
355
+ _subsystemDenylist;
356
+ // 注册的 named providers(用于 ProviderPool)
357
+ _namedProviders = new Map();
358
+ // 并发控制配置
359
+ _concurrencyConfig;
360
+ /** Agent 沙箱工作目录(工具 cwd 注入) */
361
+ _workspace;
362
+ /** agent 文件态 home(persona 可不同;extract / agent.db 用此路径) */
363
+ _agentHome;
364
+ /** 逻辑 agentId(观测 / 子系统审计用) */
365
+ _agentId;
366
+ model(providerOrName) {
367
+ if (typeof providerOrName === 'string') {
368
+ // 字符串形式:创建一个简单的 wrapper(需要外部注册实际 provider)
369
+ this._model = {
370
+ name: providerOrName,
371
+ chat: async () => { throw new Error(`Model provider "${providerOrName}" not configured`); },
372
+ stream: async function* () { throw new Error(`Model provider "${providerOrName}" not configured`); },
373
+ isAvailable: async () => false,
374
+ getModelInfo: () => null,
375
+ getModelInfos: () => [],
376
+ };
377
+ }
378
+ else {
379
+ this._model = providerOrName;
380
+ }
381
+ return this;
382
+ }
383
+ /** 注册工具 */
384
+ tool(tool) {
385
+ this._toolBus.register(tool);
386
+ return this;
387
+ }
388
+ /** 批量注册工具 */
389
+ tools(...tools) {
390
+ for (const t of tools)
391
+ this.tool(t);
392
+ return this;
393
+ }
394
+ _contextProvider = new RuntimeToolContextProvider();
395
+ /** 获取运行时上下文提供者 */
396
+ getContextProvider() {
397
+ return this._contextProvider;
398
+ }
399
+ /**
400
+ * 配置 MCP Server 连接
401
+ *
402
+ * 构建时自动连接,工具注册到 ToolBus。
403
+ * 支持多次调用,连接多个 MCP Server。
404
+ * 需同时注入 `mcpClientFactory`(Integration 的 `createSdkMcpClient` 或自定义实现)。
405
+ *
406
+ * @example
407
+ * ```ts
408
+ * const { engine, runner } = await new AgentBuilder()
409
+ * .model('gpt-5.5')
410
+ * .mcpClientFactory(createSdkMcpClient)
411
+ * .mcp({
412
+ * id: 'filesystem',
413
+ * transport: 'stdio',
414
+ * command: 'npx',
415
+ * args: ['-y', '@modelcontextprotocol/server-filesystem', '/data'],
416
+ * })
417
+ * .build();
418
+ * ```
419
+ */
420
+ mcp(config) {
421
+ this._mcpConfigs.push(config);
422
+ return this;
423
+ }
424
+ /** 注入 MCP client 工厂(Integration 适配;Harness 不 import Integration) */
425
+ mcpClientFactory(factory) {
426
+ this._mcpClientFactory = factory;
427
+ return this;
428
+ }
429
+ /** 注册自主子系统(仍受 allow/deny 列表约束) */
430
+ withSubsystem(spec) {
431
+ this._subsystemSpecs.push(spec);
432
+ return this;
433
+ }
434
+ /** 设置子系统目录(用于自动加载) */
435
+ withSubsystemDir(dir) {
436
+ this._subsystemDir = dir;
437
+ return this;
438
+ }
439
+ /**
440
+ * 子系统允许列表:仅这些 id 可注册。
441
+ * 可多次调用(追加);build(options.subsystemAllowlist) 时整体覆盖。
442
+ */
443
+ subsystemAllowlist(...ids) {
444
+ this._subsystemAllowlist = [...(this._subsystemAllowlist ?? []), ...ids];
445
+ return this;
446
+ }
447
+ /**
448
+ * 子系统禁止列表:这些 id 不注册(优先于允许列表)。
449
+ * 可多次调用(追加);build(options.subsystemDenylist) 时整体覆盖。
450
+ */
451
+ subsystemDenylist(...ids) {
452
+ this._subsystemDenylist = [...(this._subsystemDenylist ?? []), ...ids];
453
+ return this;
454
+ }
455
+ /** 设置子系统审计日志目录 */
456
+ withSubsystemAuditDir(dir) {
457
+ this._subsystemAuditDir = dir;
458
+ return this;
459
+ }
460
+ /**
461
+ * 设置模型级别映射(来自 config.models.level)
462
+ *
463
+ * 子系统通过 think.model: 'mini' 引用,运行时自动解析到具体 provider/model。
464
+ */
465
+ withModelLevels(levels) {
466
+ this._modelLevels = levels;
467
+ return this;
468
+ }
469
+ /** 设置上下文引擎 */
470
+ contextEngine(engine) {
471
+ this._contextEngine = engine;
472
+ return this;
473
+ }
474
+ /**
475
+ * 设置 Skill 目录(子目录内含 SKILL.md)
476
+ *
477
+ * build 时 discover,每轮以索引形式注入 system prompt(formatForPrompt)。
478
+ */
479
+ skillDirectory(dir) {
480
+ this._skillDirectory = dir;
481
+ return this;
482
+ }
483
+ /** 直接注入 SkillManager(跳过目录 discover) */
484
+ skills(manager) {
485
+ this._skillManager = manager;
486
+ return this;
487
+ }
488
+ /** 注入 MemoryStore(每轮按 query 召回进 system prompt) */
489
+ memoryStore(store) {
490
+ this._memoryStore = store;
491
+ return this;
492
+ }
493
+ /** 注入补录覆盖表(默认:SqliteMemoryStore→agent.db,否则内存) */
494
+ backfillCoverage(store) {
495
+ this._backfillCoverage = store;
496
+ return this;
497
+ }
498
+ /** 全局宪法(product | custom | off) */
499
+ constitution(config) {
500
+ this._constitutionConfig = config;
501
+ return this;
502
+ }
503
+ /** Memory 策略配置(profile / backfill / decay / health / confidence / gates) */
504
+ memoryConfig(config) {
505
+ this._memoryConfig = config;
506
+ return this;
507
+ }
508
+ /** 注入 Knowledge catalog(Tier 0;内容命中不进 system) */
509
+ knowledgeCatalog(provider, opts) {
510
+ this._knowledgeCatalog = provider;
511
+ this._knowledgeCatalogOpts = opts;
512
+ return this;
513
+ }
514
+ /**
515
+ * 注入 Knowledge 检索(grounding + knowledge_search/read)
516
+ */
517
+ knowledgeRetriever(deps) {
518
+ this._knowledgeRetriever = deps.retriever;
519
+ this._knowledgeIndexStore = deps.indexStore;
520
+ this._knowledgeSourceStore = deps.sourceStore;
521
+ this._knowledgeHitLog = deps.hitLog;
522
+ this._knowledgeGrounding = deps.grounding;
523
+ return this;
524
+ }
525
+ /** 注入 WisdomStore(半静态思维范式,进 system prompt WisdomLayer) */
526
+ wisdomStore(store) {
527
+ this._wisdomStore = store;
528
+ return this;
529
+ }
530
+ /** 注入 ConceptGraphStore(按 query 召回概念边,进 system prompt CognitionLayer) */
531
+ cognitionStore(store) {
532
+ this._cognitionStore = store;
533
+ return this;
534
+ }
535
+ /**
536
+ * system prompt 装配器调参
537
+ *
538
+ * @param config.systemBudgetRatio - system 预算占 contextWindow 比例
539
+ * @param config.layerShares - 单层硬顶(仅配置的层生效;默认不配额)
540
+ * @param config.includeLayerPreview - 是否在 manifest 写入层 preview
541
+ * @param config.layerPreviewChars - preview 最大字符数
542
+ * @param config.includeLayerContent - 是否在 manifest 写入层正文全文
543
+ */
544
+ contextAssembler(config) {
545
+ this._contextAssemblerConfig = { ...this._contextAssemblerConfig, ...config };
546
+ return this;
547
+ }
548
+ /** 设置摘要函数(用于 LLM 摘要压缩) */
549
+ summarize(fn) {
550
+ this._summarize = fn;
551
+ return this;
552
+ }
553
+ /**
554
+ * 关闭「未显式 summarize 时用主模型自动挂接」
555
+ *
556
+ * 默认开启自动挂接,保证长会话能走 LLM 摘要而非纯截断。
557
+ */
558
+ disableAutoSummarize(disabled = true) {
559
+ this._disableAutoSummarize = disabled;
560
+ return this;
561
+ }
562
+ /** 设置事件总线 */
563
+ events(bus) {
564
+ this._events = bus;
565
+ return this;
566
+ }
567
+ /** 设置安全守卫 */
568
+ security(guard) {
569
+ this._security = guard;
570
+ return this;
571
+ }
572
+ /** 设置安全策略配置 */
573
+ securityPolicy(config) {
574
+ this._securityConfig = config;
575
+ return this;
576
+ }
577
+ /** 注入工具调用风险策略(由 Harness 层实现,注入到 Core 的 SecurityGuard) */
578
+ withRiskPolicy(policy) {
579
+ this._riskPolicy = policy;
580
+ return this;
581
+ }
582
+ /**
583
+ * high 风险人工确认通道
584
+ *
585
+ * 未设置时 high 回退 reject(无人值守 fail-safe)。
586
+ * Gateway 可接到 ask_user / pendingApproval UI。
587
+ */
588
+ confirmHighRisk(fn) {
589
+ this._confirmHighRisk = fn;
590
+ return this;
591
+ }
592
+ /** 设置迭代预算 */
593
+ budget(config) {
594
+ this._budget = new BudgetPolicyEngine(config);
595
+ return this;
596
+ }
597
+ /** 设置错误策略 */
598
+ errorStrategy(strategy) {
599
+ this._errorStrategy = strategy;
600
+ return this;
601
+ }
602
+ // ── 并发控制 ──
603
+ /** 注册 named provider(用于 ProviderPool 多 key 路由) */
604
+ provider(name, instance) {
605
+ this._namedProviders.set(name, instance);
606
+ return this;
607
+ }
608
+ /** 批量注册 named providers */
609
+ providers(map) {
610
+ for (const [name, instance] of map) {
611
+ this._namedProviders.set(name, instance);
612
+ }
613
+ return this;
614
+ }
615
+ /** 设置并发控制配置(ProviderPool + SessionGate) */
616
+ concurrency(config) {
617
+ this._concurrencyConfig = config;
618
+ return this;
619
+ }
620
+ /** 设置观测器 */
621
+ observer(observer) {
622
+ this._observer = observer;
623
+ return this;
624
+ }
625
+ /** 设置可靠性配置(用于 buildAgent()) */
626
+ reliability(config) {
627
+ this._reliabilityConfig = { ...DEFAULT_RELIABILITY_CONFIG, ...config };
628
+ return this;
629
+ }
630
+ /**
631
+ * 启用可观测性采集
632
+ *
633
+ * 需要其一才能生效:
634
+ * - 已注册 `RunTelemetryFactory`(`import 'octopi'` 会默认注册 createRunTelemetry)
635
+ * - 或手动 `.telemetryFactory(...)` / `.observer(...)`
636
+ *
637
+ * @param options - 采集意图(tool args / stream deltas / metrics…)
638
+ */
639
+ trace(options) {
640
+ this._traceOptions = {
641
+ captureStreamDeltas: false,
642
+ captureModelRequest: false,
643
+ captureToolArgs: true,
644
+ captureToolResults: false,
645
+ enableMetrics: true,
646
+ ...options,
647
+ };
648
+ return this;
649
+ }
650
+ /** 注入观测装配工厂(Integration 的 createRunTelemetry 或自定义) */
651
+ telemetryFactory(factory) {
652
+ this._telemetryFactory = factory;
653
+ return this;
654
+ }
655
+ /** 读取采集意图 */
656
+ getTraceOptions() {
657
+ return this._traceOptions;
658
+ }
659
+ runGuard(guardOrConfig, checkpointInterval) {
660
+ if (!guardOrConfig) {
661
+ // 无参调用:使用默认配置自动创建,延迟到 buildAgent 时注入 model
662
+ this._runGuardConfig = {};
663
+ }
664
+ else if (typeof guardOrConfig.checkpoint === 'function') {
665
+ // RunGuard 实例(含自定义实现)
666
+ this._runGuard = guardOrConfig;
667
+ }
668
+ else {
669
+ // RunGuardConfig 对象:延迟到 buildAgent 时注入 model
670
+ this._runGuardConfig = guardOrConfig;
671
+ }
672
+ if (checkpointInterval !== undefined)
673
+ this._checkpointInterval = checkpointInterval;
674
+ return this;
675
+ }
676
+ persona(...workspaces) {
677
+ this._personaWorkspaces.push(...workspaces);
678
+ return this;
679
+ }
680
+ /** 设置 Agent 沙箱工作目录(注入到内置工具的 cwd) */
681
+ workspace(dir) {
682
+ this._workspace = dir;
683
+ return this;
684
+ }
685
+ /** agent 文件态 home:extract 落盘、与 persona 目录解耦 */
686
+ agentHome(dir) {
687
+ this._agentHome = dir;
688
+ return this;
689
+ }
690
+ /** 逻辑 agentId(extract pending 扫描 / 观测) */
691
+ agentId(id) {
692
+ this._agentId = id;
693
+ return this;
694
+ }
695
+ /** 直接设置 systemPrompt(优先于 persona 目录) */
696
+ systemPrompt(prompt) {
697
+ this._systemPrompt = prompt;
698
+ return this;
699
+ }
700
+ // ── Runner 配置 ──
701
+ /** 设置 Session 存储 */
702
+ store(store) {
703
+ this._store = store;
704
+ return this;
705
+ }
706
+ /** 设置 Runner 配置 */
707
+ runnerConfig(config) {
708
+ this._runnerConfig = config;
709
+ if (config.observerHub) {
710
+ this._observerHub = config.observerHub;
711
+ }
712
+ return this;
713
+ }
714
+ /** 注入产品 Observer Hub(LLM 视图等) */
715
+ observerHub(hub) {
716
+ this._observerHub = hub;
717
+ return this;
718
+ }
719
+ /**
720
+ * 工具效应隔离策略(I5)
721
+ *
722
+ * @param mode - `none` | `session-subdir` | `session-lock`
723
+ */
724
+ toolIsolation(mode) {
725
+ this._toolIsolation = mode;
726
+ return this;
727
+ }
728
+ async build(options) {
729
+ const mode = options?.mode ?? 'full';
730
+ const events = this._events ?? new DefaultEventBus();
731
+ this._events = events;
732
+ // 并发控制:ProviderPool
733
+ if (this._concurrencyConfig?.providerPool && this._namedProviders.size > 0) {
734
+ const { ProviderPool } = await import('../run/concurrency/provider-pool.js');
735
+ this._model = new ProviderPool(this._concurrencyConfig.providerPool, this._namedProviders);
736
+ }
737
+ // 并发控制:SessionGate
738
+ if (this._concurrencyConfig?.sessionGate) {
739
+ const { SessionGate } = await import('../run/concurrency/session-gate.js');
740
+ const gateConfig = this._concurrencyConfig.sessionGate;
741
+ this._runnerConfig = {
742
+ ...this._runnerConfig,
743
+ sessionGate: new SessionGate({
744
+ maxConcurrent: gateConfig.maxConcurrent,
745
+ waitTimeoutMs: gateConfig.waitTimeoutMs,
746
+ }),
747
+ };
748
+ }
749
+ // 创建 SessionStore(须在 buildAgent 之前,以便 task_* 工具进入 Agent 的工具快照)
750
+ const store = this._store ?? new InMemorySessionStore();
751
+ this._store = store;
752
+ // 会话任务:默认创建 Service;注册 task_* 工具后再 buildAgent
753
+ const sessionTaskService = this._runnerConfig?.sessionTaskService ?? new SessionTaskService(store, events);
754
+ this._runnerConfig = {
755
+ ...this._runnerConfig,
756
+ sessionTaskService,
757
+ };
758
+ if (!this._toolBus.getTool('task_list')) {
759
+ for (const t of createSessionTaskTools(sessionTaskService)) {
760
+ this._toolBus.register(t);
761
+ }
762
+ }
763
+ // memory 工具必须在 buildCore 之前注册:Agent 构造时从 ToolBus 快照 tools
764
+ if (this._memoryStore && !this._toolBus.getTool('memory_store')) {
765
+ const { createMemoryTools } = await import('../extension/plugin-ecosystem/tools/memory.js');
766
+ const { profileToConfidenceConfig } = await import('../memory/confidence.js');
767
+ const memCfg = this._memoryConfig;
768
+ const confidence = profileToConfidenceConfig(memCfg?.profile, {
769
+ injectMinScore: memCfg?.confidence?.injectMinScore,
770
+ channelPriors: memCfg?.confidence?.channelPriors,
771
+ });
772
+ for (const tool of createMemoryTools(this._memoryStore, {
773
+ confidence,
774
+ gates: memCfg?.gates?.maxLength
775
+ ? { maxLength: memCfg.gates.maxLength }
776
+ : undefined,
777
+ })) {
778
+ this._toolBus.register(tool);
779
+ }
780
+ console.log('[AgentBuilder] memory tools registered: memory_store, memory_search');
781
+ }
782
+ else if (!this._memoryStore) {
783
+ console.warn('[AgentBuilder] memory tools skipped: no memoryStore injected');
784
+ }
785
+ // knowledge 工具(P4):knowledge_search / knowledge_read
786
+ if (this._knowledgeRetriever &&
787
+ this._knowledgeIndexStore &&
788
+ this._knowledgeSourceStore &&
789
+ !this._toolBus.getTool('knowledge_search')) {
790
+ const { createKnowledgeTools } = await import('../extension/plugin-ecosystem/tools/knowledge.js');
791
+ for (const tool of createKnowledgeTools({
792
+ retriever: this._knowledgeRetriever,
793
+ indexStore: this._knowledgeIndexStore,
794
+ sourceStore: this._knowledgeSourceStore,
795
+ hitLog: this._knowledgeHitLog,
796
+ })) {
797
+ this._toolBus.register(tool);
798
+ }
799
+ console.log('[AgentBuilder] knowledge tools registered: knowledge_search, knowledge_read');
800
+ }
801
+ // 核心组件(Agent 门面);full 模式继续装配 runner / 子系统 / 提取栈
802
+ const core = await this.buildCore();
803
+ const { agent, harness, mcpManager, contextEngine } = core;
804
+ if (mode === 'core') {
805
+ return {
806
+ agent,
807
+ harness,
808
+ mcpManager,
809
+ events,
810
+ contextHealth: async (agentId) => {
811
+ const { probeContextLayerHealth } = await import('../context/layer-health.js');
812
+ return probeContextLayerHealth({
813
+ agentId: agentId ?? 'default',
814
+ skillCount: this._skillManager?.list().length,
815
+ memoryStore: this._memoryStore,
816
+ knowledgeCatalog: this._knowledgeCatalog,
817
+ wisdomStore: this._wisdomStore,
818
+ cognitionStore: this._cognitionStore,
819
+ personaLoaded: Boolean((this._systemPrompt ?? '').trim() ||
820
+ (this._initialPersonaContent ?? '').trim() ||
821
+ this._personaResolver),
822
+ });
823
+ },
824
+ };
825
+ }
826
+ const runner = new SessionAwareRunner(agent, harness, store, {
827
+ ...this._runnerConfig,
828
+ toolIsolation: this._toolIsolation ?? this._runnerConfig?.toolIsolation,
829
+ agentWorkspace: this._workspace?.trim() ? this._workspace : this._runnerConfig?.agentWorkspace,
830
+ sessionLease: this._runnerConfig?.sessionLease,
831
+ sessionAcl: this._runnerConfig?.sessionAcl,
832
+ agentMaxSessionRights: this._runnerConfig?.agentMaxSessionRights,
833
+ observerHub: this._observerHub ?? this._runnerConfig?.observerHub,
834
+ sessionTaskService,
835
+ events,
836
+ eventSink: this._telemetry?.onEvent
837
+ ? (event, ctx) => this._telemetry?.onEvent?.(event, ctx)
838
+ : this._runnerConfig?.eventSink,
839
+ });
840
+ runner.setToolContextProvider(this._contextProvider);
841
+ if (this._personaResolver) {
842
+ // 传入磁盘 persona 真实内容(可能为 ''),供 runner 区分「从未有人格」与「热删除」
843
+ runner.setSystemPromptResolver(this._personaResolver, this._initialPersonaContent ?? '');
844
+ }
845
+ // 层契约装配:persona + skill 索引 + wisdom/cognition/memory 召回 + knowledge catalog + runtime
846
+ const skillManager = this._skillManager;
847
+ const memoryStore = this._memoryStore;
848
+ const knowledgeCatalog = this._knowledgeCatalog;
849
+ const wisdomStore = this._wisdomStore;
850
+ const cognitionStore = this._cognitionStore;
851
+ const assemblerCfg = this._contextAssemblerConfig;
852
+ const constitutionCfg = this._constitutionConfig;
853
+ const systemPromptAssembler = createDefaultSystemPromptAssembler({
854
+ getSkillPromptText: skillManager
855
+ ? () => skillManager.formatForPrompt()
856
+ : undefined,
857
+ memoryStore,
858
+ knowledgeCatalog,
859
+ knowledgeMaxEntries: this._knowledgeCatalogOpts?.maxEntries,
860
+ knowledgeGroupByScope: this._knowledgeCatalogOpts?.groupByScope,
861
+ knowledgeShowProgress: this._knowledgeCatalogOpts?.showProgress,
862
+ wisdomStore,
863
+ cognitionStore,
864
+ systemBudgetRatio: assemblerCfg?.systemBudgetRatio,
865
+ systemBudgetTokens: assemblerCfg?.systemBudgetTokens,
866
+ constitution: constitutionCfg,
867
+ assemblerConfig: {
868
+ layerShares: assemblerCfg?.layerShares,
869
+ includeLayerPreview: assemblerCfg?.includeLayerPreview,
870
+ layerPreviewChars: assemblerCfg?.layerPreviewChars,
871
+ includeLayerContent: assemblerCfg?.includeLayerContent,
872
+ },
873
+ });
874
+ runner.setSystemPromptAssembler((input) => systemPromptAssembler.assemble(input), (sid) => systemPromptAssembler.clearSession(sid));
875
+ // turn 级 Knowledge grounding(消息插槽 knowledgeGrounding;不进 system)
876
+ if (this._knowledgeRetriever) {
877
+ const { GroundingAssembler } = await import('../knowledge/grounding.js');
878
+ const grounding = new GroundingAssembler({
879
+ retriever: this._knowledgeRetriever,
880
+ hitLog: this._knowledgeHitLog,
881
+ budgetTokens: this._knowledgeGrounding?.budgetTokens,
882
+ budgetRatio: this._knowledgeGrounding?.budgetRatio,
883
+ maxBudgetTokens: this._knowledgeGrounding?.maxBudgetTokens,
884
+ maxChunks: this._knowledgeGrounding?.maxChunks,
885
+ skipIfUserTokensBelow: this._knowledgeGrounding?.skipIfUserTokensBelow,
886
+ includePriorUserTurns: this._knowledgeGrounding?.includePriorUserTurns,
887
+ });
888
+ runner.setGroundingAssembler(async (input) => {
889
+ const pack = await grounding.assemble(input);
890
+ return {
891
+ query: pack.query,
892
+ mode: pack.mode,
893
+ hits: pack.hits.map((h) => ({
894
+ path: h.path,
895
+ startLine: h.startLine,
896
+ endLine: h.endLine,
897
+ text: h.text,
898
+ })),
899
+ hint: pack.hint,
900
+ coverage: pack.coverage,
901
+ tokens: pack.tokens,
902
+ text: pack.text,
903
+ };
904
+ });
905
+ }
906
+ // 子系统装配:自动发现 + allow/deny 过滤 + 注册
907
+ const allowlist = options?.subsystemAllowlist ?? this._subsystemAllowlist;
908
+ const denylist = options?.subsystemDenylist ?? this._subsystemDenylist;
909
+ const allowed = (id, packageId) => isSubsystemAllowed(id, allowlist, denylist, packageId);
910
+ const autoLoad = options?.autoLoadSubsystems ?? true;
911
+ if (autoLoad && !this._subsystemDir) {
912
+ const discovered = await discoverSubsystemSpecs(options?.subsystemDirs);
913
+ for (const spec of discovered.specs) {
914
+ if (this._subsystemSpecs.some((s) => s.id === spec.id))
915
+ continue;
916
+ this._subsystemSpecs.push(spec);
917
+ }
918
+ for (const err of discovered.errors) {
919
+ console.warn(`[AgentBuilder] subsystem load error at ${err.path}: ${err.error}`);
920
+ }
921
+ }
922
+ // 创建 SubsystemRuntime(过滤后仍有子系统,或指定了目录)
923
+ // allowed 必须带 packageId:否则 allowlist: ["memory-steward"] 会在预滤阶段被丢掉
924
+ const candidateSpecs = this._subsystemSpecs.filter((s) => allowed(s.id, s.packageId));
925
+ const skipped = this._subsystemSpecs.filter((s) => !allowed(s.id, s.packageId));
926
+ let subsystemRuntime;
927
+ if (candidateSpecs.length > 0 || this._subsystemDir) {
928
+ const { SubsystemRuntime } = await import('../collaboration/autonomous-subsystem/runtime.js');
929
+ subsystemRuntime = new SubsystemRuntime({
930
+ deps: {
931
+ model: agent.model,
932
+ events,
933
+ errorStrategy: this._errorStrategy ?? new DefaultErrorStrategy(),
934
+ mainTools: this._toolBus,
935
+ modelLevels: this._modelLevels,
936
+ },
937
+ auditDir: this._subsystemAuditDir,
938
+ });
939
+ const registeredIds = new Set();
940
+ const tryRegister = (spec) => {
941
+ if (!allowed(spec.id, spec.packageId))
942
+ return;
943
+ const regErrors = subsystemRuntime.register(spec);
944
+ if (regErrors.length > 0) {
945
+ console.warn(`[octopi] subsystem "${spec.id}" rejected: ${regErrors.join('; ')}`);
946
+ }
947
+ else {
948
+ registeredIds.add(spec.id);
949
+ }
950
+ };
951
+ for (const spec of candidateSpecs) {
952
+ tryRegister(spec);
953
+ }
954
+ if (this._subsystemDir) {
955
+ const { SubsystemLoader } = await import('../collaboration/autonomous-subsystem/loader.js');
956
+ const loader = new SubsystemLoader({ builtinDir: this._subsystemDir });
957
+ const loadResult = await loader.loadAll();
958
+ for (const err of loadResult.errors) {
959
+ console.warn(`[octopi] subsystem load failed ${err.path}: ${err.error}`);
960
+ }
961
+ for (const spec of loadResult.specs) {
962
+ tryRegister(spec);
963
+ }
964
+ }
965
+ // 依赖注入:memoryStore / sessionStore / constitution / backfillCoverage
966
+ if (this._memoryStore) {
967
+ subsystemRuntime.registerDependency('memoryStore', this._memoryStore);
968
+ }
969
+ {
970
+ const { InMemoryBackfillCoverageStore } = await import('../memory/backfill-coverage.js');
971
+ let coverage = this._backfillCoverage;
972
+ if (!coverage) {
973
+ const mem = this._memoryStore;
974
+ if (mem?.database) {
975
+ const { SqliteBackfillCoverageStore } = await import('../memory/sqlite/backfill-coverage.js');
976
+ coverage = new SqliteBackfillCoverageStore(mem.database);
977
+ }
978
+ else {
979
+ coverage = new InMemoryBackfillCoverageStore();
980
+ }
981
+ this._backfillCoverage = coverage;
982
+ }
983
+ subsystemRuntime.registerDependency('backfillCoverage', coverage);
984
+ if (this._memoryConfig?.decay?.typeParams) {
985
+ subsystemRuntime.registerDependency('memoryDecayParams', this._memoryConfig.decay.typeParams);
986
+ }
987
+ }
988
+ if (this._store) {
989
+ subsystemRuntime.registerDependency('sessionStore', this._store);
990
+ }
991
+ try {
992
+ const { loadConstitution } = await import('../context/constitution/load-constitution.js');
993
+ const loaded = loadConstitution(this._constitutionConfig ?? { mode: 'product' });
994
+ subsystemRuntime.registerDependency('constitution', loaded.text);
995
+ }
996
+ catch {
997
+ // custom path invalid already fails build elsewhere; steward may proceed without prompt text
998
+ }
999
+ const loadedIds = Array.from(registeredIds);
1000
+ console.log(loadedIds.length > 0
1001
+ ? `[AgentBuilder] subsystems registered: ${loadedIds.join(', ')}`
1002
+ : '[AgentBuilder] subsystems registered: (none)');
1003
+ if (skipped.length > 0) {
1004
+ console.log(`[AgentBuilder] subsystems skipped by allowlist/denylist: ${skipped.map((s) => s.id).join(', ')}`);
1005
+ }
1006
+ if (registeredIds.size > 0 || candidateSpecs.length > 0 || this._subsystemDir) {
1007
+ runner.setSubsystemRuntime(subsystemRuntime);
1008
+ }
1009
+ // 补录脉搏:硬收敛 / idle 漂移 / 覆盖差
1010
+ // `memory.backfill.enabled=false` 时不启动 Trigger(省 LLM);denylist 不注册子系统时同样不启动
1011
+ const backfillCfg = this._memoryConfig?.backfill;
1012
+ const backfillEnabled = backfillCfg?.enabled !== false;
1013
+ if (backfillEnabled && registeredIds.has('memory.steward.backfill') && this._backfillCoverage) {
1014
+ const { BackfillTrigger } = await import('../memory/backfill-trigger.js');
1015
+ const trigger = new BackfillTrigger({
1016
+ events,
1017
+ coverage: this._backfillCoverage,
1018
+ sessionStore: store,
1019
+ idleDelayMs: backfillCfg?.idleDelayMs,
1020
+ gapScanMs: backfillCfg?.gapScanMs,
1021
+ prefilter: {
1022
+ minUserTurns: backfillCfg?.minUserTurns,
1023
+ minTotalChars: backfillCfg?.minTotalChars,
1024
+ },
1025
+ });
1026
+ trigger.start();
1027
+ runner.setBackfillTrigger(trigger);
1028
+ }
1029
+ else if (!backfillEnabled && registeredIds.has('memory.steward.backfill')) {
1030
+ console.log('[AgentBuilder] memory.backfill.enabled=false — auto backfill trigger off');
1031
+ }
1032
+ // health 双脉搏补充:高水位 / shadow 积压 → emit memory.health.*(govern 可监听)
1033
+ if (memoryStore && registeredIds.has('memory.steward.govern')) {
1034
+ const { MemoryHealthProbe } = await import('../memory/health-probe.js');
1035
+ const healthCfg = this._memoryConfig?.health;
1036
+ const probe = new MemoryHealthProbe({
1037
+ events,
1038
+ memoryStore,
1039
+ intervalMs: healthCfg?.intervalMs,
1040
+ shadowBacklogLimit: healthCfg?.shadowBacklogLimit,
1041
+ limits: healthCfg?.limits,
1042
+ });
1043
+ probe.start();
1044
+ runner.setMemoryHealthProbe(probe);
1045
+ }
1046
+ }
1047
+ const skillManagerForHealth = skillManager;
1048
+ const memoryStoreForHealth = memoryStore;
1049
+ const knowledgeCatalogForHealth = knowledgeCatalog;
1050
+ const wisdomStoreForHealth = wisdomStore;
1051
+ const cognitionStoreForHealth = cognitionStore;
1052
+ const personaLoadedForHealth = Boolean((this._systemPrompt ?? '').trim() ||
1053
+ (this._initialPersonaContent ?? '').trim() ||
1054
+ this._personaResolver);
1055
+ return {
1056
+ agent,
1057
+ harness,
1058
+ runner,
1059
+ mcpManager,
1060
+ runtime: subsystemRuntime,
1061
+ events,
1062
+ contextEngine,
1063
+ contextHealth: async (agentId) => {
1064
+ const { probeContextLayerHealth } = await import('../context/layer-health.js');
1065
+ return probeContextLayerHealth({
1066
+ agentId: agentId ?? 'default',
1067
+ skillCount: skillManagerForHealth?.list().length,
1068
+ memoryStore: memoryStoreForHealth,
1069
+ knowledgeCatalog: knowledgeCatalogForHealth,
1070
+ wisdomStore: wisdomStoreForHealth,
1071
+ cognitionStore: cognitionStoreForHealth,
1072
+ personaLoaded: personaLoadedForHealth,
1073
+ });
1074
+ },
1075
+ };
1076
+ }
1077
+ /**
1078
+ * 构建 Agent 类(Harness 门面 + reliability)
1079
+ *
1080
+ * 返回已绑定 harness 的 Agent;集成方应使用 `agent.run()`。
1081
+ *
1082
+ * @deprecated 请使用 `build({ mode: 'core' })`。本方法仅为兼容保留,不再扩展。
1083
+ */
1084
+ async buildAgent() {
1085
+ return this.buildCore();
1086
+ }
1087
+ /**
1088
+ * 核心构建:仅产出 Agent 门面 + ReliabilityHarness + McpManager。
1089
+ * 不创建 Runner / SubsystemRuntime / memory extraction。
1090
+ */
1091
+ async buildCore() {
1092
+ if (!this._model) {
1093
+ throw new Error('ModelProvider is required. Call .model() before build()');
1094
+ }
1095
+ // 单独 buildAgent() 时也保证有 bus,压缩事件不会静默丢失
1096
+ if (!this._events) {
1097
+ this._events = new DefaultEventBus();
1098
+ }
1099
+ // 观测装配:.trace() → RunTelemetry(工厂由宿主/包入口注入)
1100
+ let loopObserver;
1101
+ if (this._traceOptions) {
1102
+ const factory = this._telemetryFactory ?? getRunTelemetryFactory();
1103
+ if (factory) {
1104
+ this._telemetry = factory(this._traceOptions);
1105
+ loopObserver = this._telemetry.createLoopObserver(this._traceOptions);
1106
+ }
1107
+ else if (!this._observer) {
1108
+ throw new Error('trace() requires a RunTelemetryFactory. `import { AgentBuilder } from "octopi-agent"` (or @octopi-agent/engine) registers createRunTelemetry, or call .telemetryFactory(...) / .observer(...).');
1109
+ }
1110
+ }
1111
+ // 加载 systemPrompt:文件式 persona 走 PersonaSource(run 时热更新)
1112
+ let systemPrompt = this._systemPrompt ?? '';
1113
+ this._personaResolver = undefined;
1114
+ this._initialPersonaContent = undefined;
1115
+ if (!systemPrompt && this._personaWorkspaces.length > 0) {
1116
+ const source = new PersonaSource();
1117
+ const dirs = [...this._personaWorkspaces];
1118
+ this._personaResolver = () => source.load(...dirs);
1119
+ this._initialPersonaContent = await this._personaResolver();
1120
+ systemPrompt = this._initialPersonaContent;
1121
+ }
1122
+ if (!systemPrompt && this._toolBus.listForAgent('default').length > 0) {
1123
+ systemPrompt = this.buildDefaultSystemPrompt();
1124
+ }
1125
+ // Skill:目录 discover(或外部注入的 manager)
1126
+ if (!this._skillManager && this._skillDirectory) {
1127
+ const { DefaultSkillManager } = await import('../extension/plugin-ecosystem/skills/manager.js');
1128
+ const mgr = new DefaultSkillManager(this._skillDirectory);
1129
+ try {
1130
+ await mgr.discover(this._skillDirectory);
1131
+ this._skillManager = mgr;
1132
+ }
1133
+ catch (err) {
1134
+ console.warn(`[octopi] skill discover failed (${this._skillDirectory}): ${err instanceof Error ? err.message : String(err)}`);
1135
+ }
1136
+ }
1137
+ // 构建 McpManager
1138
+ const mcpManager = await this.buildMcpManager();
1139
+ // 转换 RegisteredTool → AgentTool
1140
+ this._contextProvider = new RuntimeToolContextProvider({
1141
+ cwd: this._workspace?.trim() ? this._workspace : undefined,
1142
+ });
1143
+ const agentTools = this._toolBus.listForAgent('default').map(t => convertToAgentTool(t, this._contextProvider));
1144
+ // 创建 Agent
1145
+ const agentOptions = {
1146
+ model: this._model,
1147
+ systemPrompt,
1148
+ tools: agentTools,
1149
+ observer: loopObserver ?? (this._observer ? {
1150
+ onLLMStart: (p) => this._observer?.log('info', 'llm.start', p),
1151
+ onLLMEnd: (p) => this._observer?.log('info', 'llm.end', p),
1152
+ onToolStart: (p) => this._observer?.log('info', 'tool.start', p),
1153
+ onToolEnd: (p) => this._observer?.log('info', 'tool.end', p),
1154
+ } : undefined),
1155
+ };
1156
+ const agent = new Agent(agentOptions);
1157
+ // ContextEngine 接线:经 convertToLlm 调用 assemble
1158
+ // 模型快照只读 ALS(Runner 每 run resolve 一次);无 snapshot 时才回退 agent.model
1159
+ const contextEngine = this._contextEngine ?? new DefaultContextEngine();
1160
+ const { getResolvedModel } = await import('../run/model/run-scope.js');
1161
+ const summarizeFn = this._summarize ??
1162
+ (!this._disableAutoSummarize && this._model
1163
+ ? async (messages, opts) => {
1164
+ const provider = getResolvedModel()?.provider ?? this._model;
1165
+ return createProviderSummarize(provider)(messages, opts);
1166
+ }
1167
+ : undefined);
1168
+ agent.setConvertToLlm(async (messages) => {
1169
+ // I1:身份与 systemPrompt 优先读 RunScope ALS,避免共享 Agent 单例竞态
1170
+ const scope = getRunScope();
1171
+ const sessionId = scope?.sessionId ?? agent.contextSessionId;
1172
+ const agentId = scope?.agentId ?? 'default';
1173
+ const systemPrompt = scope?.systemPrompt ?? agent.context.systemPrompt;
1174
+ const tools = (agent.context.tools ?? []).map((t) => ({
1175
+ type: 'function',
1176
+ function: {
1177
+ name: t.name,
1178
+ description: t.description,
1179
+ parameters: t.parameters ?? { type: 'object', properties: {} },
1180
+ },
1181
+ }));
1182
+ // 方案 B:只读 snapshot.contextWindow;未知则 undefined(跳过自动压缩)
1183
+ // 禁止再调 getModelInfo —— FallbackProvider 可能返回 chain[0] 的窗口
1184
+ const snapshot = getResolvedModel();
1185
+ const provider = snapshot?.provider ?? agent.model;
1186
+ const contextWindow = snapshot?.contextWindow != null && snapshot.contextWindow > 0
1187
+ ? snapshot.contextWindow
1188
+ : undefined;
1189
+ const result = await contextEngine.assemble({
1190
+ sessionId,
1191
+ agentId,
1192
+ messages,
1193
+ systemPrompt,
1194
+ tools,
1195
+ tokenBudget: contextWindow,
1196
+ contextWindow,
1197
+ compactTargetTokens: this._contextAssemblerConfig?.compactTargetTokens,
1198
+ summarize: summarizeFn,
1199
+ loadCompactState: () => agent.getSessionCompactState(sessionId, agentId),
1200
+ // 惰性读 bus:覆盖 buildAgent 之后才 setEvents 的场景
1201
+ // Observer:ContextEngine 侧事件(context.compact.* 等)不经过 Runner emitObserved,
1202
+ // 必须在此直采 Hub,否则 timeline 永远看不到 compact。
1203
+ emit: (e) => {
1204
+ const { type, sessionId, ...data } = e;
1205
+ const event = {
1206
+ type,
1207
+ timestamp: Date.now(),
1208
+ sessionId,
1209
+ data,
1210
+ };
1211
+ try {
1212
+ this._observerHub?.ingestEvent(event);
1213
+ }
1214
+ catch {
1215
+ // 观测 fail-open
1216
+ }
1217
+ const bus = this._events;
1218
+ if (!bus)
1219
+ return;
1220
+ bus.emit(event);
1221
+ },
1222
+ });
1223
+ // 压缩状态回写 Agent 内存桥(E4 键 = sessionId × agentId)
1224
+ if (result.compactState) {
1225
+ agent.setSessionCompactState(sessionId, agentId, result.compactState);
1226
+ }
1227
+ // Observer P1:LLM 实际输入视图(ContextEngine 出口)
1228
+ // 真源 = hub.recordLlmMessages;事件只带 summarizeLlmMessages,避免双套统计/覆盖全文
1229
+ if (this._observerHub?.isEnabled() && this._observerHub.getConfig().channels['context.llm']) {
1230
+ const llmInput = result.messages.map((m) => ({
1231
+ role: m.role,
1232
+ content: m.content,
1233
+ }));
1234
+ this._observerHub.recordLlmMessages({
1235
+ sessionId,
1236
+ agentId,
1237
+ messages: llmInput,
1238
+ estimatedTokens: result.estimatedTokens,
1239
+ });
1240
+ this._events?.emit({
1241
+ type: 'run.scope.llm',
1242
+ timestamp: Date.now(),
1243
+ sessionId,
1244
+ agentId,
1245
+ data: {
1246
+ sessionId,
1247
+ agentId,
1248
+ summary: summarizeLlmMessages(llmInput),
1249
+ estimatedTokens: result.estimatedTokens,
1250
+ },
1251
+ });
1252
+ }
1253
+ // 保存最新的 context 压力信息(供 harness.getContextPressure 使用)
1254
+ this._lastContextPressure = {
1255
+ estimatedTokens: result.estimatedTokens,
1256
+ contextWindow,
1257
+ };
1258
+ // droppedSummary:并入已有 system,避免连续两条 system(严格网关)
1259
+ const llmMessages = [...result.messages];
1260
+ if (result.droppedSummary) {
1261
+ const note = `[Context compacted] ${result.droppedSummary}`;
1262
+ const sysIdx = llmMessages.findIndex((m) => m.role === 'system');
1263
+ if (sysIdx >= 0) {
1264
+ const sys = llmMessages[sysIdx];
1265
+ const prev = typeof sys.content === 'string' ? sys.content : '';
1266
+ llmMessages[sysIdx] = {
1267
+ ...sys,
1268
+ content: prev ? `${prev}\n\n${note}` : note,
1269
+ };
1270
+ }
1271
+ else {
1272
+ llmMessages.unshift({ role: 'system', content: note });
1273
+ }
1274
+ }
1275
+ return llmMessages;
1276
+ });
1277
+ agent.setOnAfterTurn(async (usage, turn) => {
1278
+ const scope = getRunScope();
1279
+ const sessionId = scope?.sessionId ?? agent.contextSessionId;
1280
+ const agentId = scope?.agentId ?? 'default';
1281
+ await contextEngine.afterTurn?.({
1282
+ sessionId,
1283
+ agentId,
1284
+ turn: turn ?? [],
1285
+ usage: usage,
1286
+ });
1287
+ });
1288
+ // 构建可靠性 harness(systemPrompt 用于泄露检测;文件式 persona 每轮由 runner 同步)
1289
+ // 统一 EventBus 实例(security / budget 共用)
1290
+ const events = this._events ?? new DefaultEventBus();
1291
+ this._events = events;
1292
+ const security = this._security ?? new DefaultSecurityGuard(events, {
1293
+ ...this._securityConfig,
1294
+ systemPrompt: this._securityConfig?.systemPrompt ?? systemPrompt,
1295
+ });
1296
+ // 风险策略永远接线(安全不可绕过):未显式注入时用 workspace cwd 的默认实现
1297
+ if (security.setToolCallRiskPolicy) {
1298
+ const riskPolicy = this._riskPolicy ?? new (await import('../governance/security/default-risk-policy.js')).DefaultToolCallRiskPolicy({
1299
+ cwd: this._workspace?.trim() ? this._workspace : undefined,
1300
+ });
1301
+ security.setToolCallRiskPolicy(riskPolicy);
1302
+ }
1303
+ // 未注册工具硬边界:灌入工具面快照(空集 = 不校验,必须在 build 时接线)
1304
+ if (security.setRegisteredTools) {
1305
+ security.setRegisteredTools(new Set(this._toolBus.listForAgent('default').map((t) => t.definition.name)));
1306
+ }
1307
+ const errorStrategy = this._errorStrategy ?? new DefaultErrorStrategy();
1308
+ // 自动创建 RunGuard(如果通过 config 配置但未手动传入实例)
1309
+ const runGuard = this._runGuard
1310
+ ?? (this._runGuardConfig !== undefined
1311
+ ? new DefaultRunGuard(this._runGuardConfig, this._model)
1312
+ : undefined);
1313
+ // ResourceBudget:始终挂默认实例(可被 .budget() 覆盖),保证主路径硬停生效
1314
+ const budget = this._budget ?? new BudgetPolicyEngine({});
1315
+ // checkpointInterval:builder.runGuard(guard, n) 或默认
1316
+ if (this._checkpointInterval !== undefined) {
1317
+ this._reliabilityConfig = {
1318
+ ...(this._reliabilityConfig ?? DEFAULT_RELIABILITY_CONFIG),
1319
+ checkpointInterval: this._checkpointInterval,
1320
+ };
1321
+ }
1322
+ // 保存 builder 引用,用于 getContextPressure 回调
1323
+ const builderRef = this;
1324
+ const harness = {
1325
+ config: this._reliabilityConfig ?? DEFAULT_RELIABILITY_CONFIG,
1326
+ security,
1327
+ errorStrategy,
1328
+ runGuard,
1329
+ budget,
1330
+ // P5: Context 压力回调(从 ContextEngine assemble 获取)
1331
+ getContextPressure: () => builderRef._lastContextPressure,
1332
+ // high 风险确认:有则走人工审批,无则 run-agent 回退 reject
1333
+ confirmHighRisk: this._confirmHighRisk,
1334
+ };
1335
+ // Agent.run() 需要 harness;Builder 组装期绑定
1336
+ agent.setHarness(harness);
1337
+ return { agent, harness, mcpManager, events, contextEngine };
1338
+ }
1339
+ /**
1340
+ * 构建 McpManager 并连接所有配置的 MCP Server
1341
+ */
1342
+ async buildMcpManager() {
1343
+ // 创建回调,桥接到 this._toolBus
1344
+ // MCP 工具全局注册(外部 server 发现的工具天然跨 agent 共享)
1345
+ // Agent 级过滤通过 ToolPolicy.deny 实现
1346
+ const callbacks = {
1347
+ registerTool: (tool) => this._toolBus.register(tool),
1348
+ unregisterTool: (name) => this._toolBus.unregister(name),
1349
+ getTool: (name) => this._toolBus.getTool(name),
1350
+ };
1351
+ const factory = this._mcpClientFactory;
1352
+ const clientFactory = (config) => {
1353
+ if (!factory) {
1354
+ throw new Error('McpClientFactory not injected. Call .mcpClientFactory(createSdkMcpClient) (from @octopi-agent/engine/integration) before .mcp().');
1355
+ }
1356
+ return factory(config);
1357
+ };
1358
+ const manager = new DefaultMcpManager(callbacks, clientFactory);
1359
+ // 连接所有配置的 MCP Server
1360
+ for (const config of this._mcpConfigs) {
1361
+ try {
1362
+ await manager.connectServer(config);
1363
+ }
1364
+ catch (err) {
1365
+ console.error(`[AgentBuilder] Failed to connect MCP Server "${config.id}": ${err instanceof Error ? err.message : String(err)}`);
1366
+ throw err;
1367
+ }
1368
+ }
1369
+ return manager;
1370
+ }
1371
+ /**
1372
+ * 生成默认 systemPrompt,包含可用工具说明
1373
+ */
1374
+ buildDefaultSystemPrompt() {
1375
+ const toolList = this._toolBus.listForAgent('default')
1376
+ .map(t => `- ${t.definition.name}: ${t.definition.description}`)
1377
+ .join('\n');
1378
+ return `You are a helpful AI assistant with access to the following tools:
1379
+
1380
+ ${toolList}
1381
+
1382
+ Tool selection (strict):
1383
+ 1. Prefer a dedicated tool when one covers the job (file_read / file_list / file_write / file_edit / file_search / env_info, and any task-specific tool).
1384
+ 2. If a dedicated-tool call fails because your arguments were wrong (bad path, bad params), fix the call and retry that tool — do not switch to shell for a call you can fix.
1385
+ 3. Use shell only when: (a) no dedicated tool covers the operation, or (b) the dedicated tool is unavailable, or (c) it still fails after a correct retry and shell is the only remaining way to make progress.
1386
+ 4. Do not prefer shell over a working dedicated tool for the same job.
1387
+
1388
+ Examples:
1389
+ - Read a file → file_read first (shell cat only if file_read is unavailable or still fails after a correct retry)
1390
+ - List directory → file_list first
1391
+ - Write/edit a file → file_write / file_edit first
1392
+ - Search file contents → file_search first
1393
+ - Operation with no dedicated tool → shell is acceptable`;
1394
+ }
1395
+ }
1396
+ export async function createAgent(config) {
1397
+ const builder = new AgentBuilder()
1398
+ .model(config.model);
1399
+ if (config.persona)
1400
+ builder.persona(config.persona);
1401
+ if (config.tools)
1402
+ builder.tools(...config.tools);
1403
+ if (config.store)
1404
+ builder.store(config.store);
1405
+ if (config.budget)
1406
+ builder.budget(config.budget);
1407
+ if (config.mcpClientFactory)
1408
+ builder.mcpClientFactory(config.mcpClientFactory);
1409
+ if (config.mcp) {
1410
+ for (const mcpConfig of config.mcp)
1411
+ builder.mcp(mcpConfig);
1412
+ }
1413
+ return builder.build();
1414
+ }