@octopi-agent/engine 0.65.0 → 0.86.38

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (421) hide show
  1. package/LICENSE +201 -201
  2. package/NOTICE +7 -7
  3. package/README.md +64 -26
  4. package/dist/config-schema/agent.d.ts +89 -1
  5. package/dist/config-schema/agent.js +69 -0
  6. package/dist/config-schema/context.d.ts +23 -4
  7. package/dist/config-schema/context.js +28 -1
  8. package/dist/config-schema/engine.d.ts +285 -9
  9. package/dist/config-schema/engine.js +35 -3
  10. package/dist/config-schema/governance.d.ts +95 -0
  11. package/dist/config-schema/governance.js +91 -0
  12. package/dist/config-schema/models.d.ts +1 -1
  13. package/dist/config-schema/observability.d.ts +6 -0
  14. package/dist/config-schema/observability.js +16 -0
  15. package/dist/config-schema/run.d.ts +10 -0
  16. package/dist/config-schema/run.js +18 -0
  17. package/dist/config-schema/shared.d.ts +10 -0
  18. package/dist/config-schema/shared.js +10 -0
  19. package/dist/config-schema/substrate.d.ts +87 -1
  20. package/dist/config-schema/substrate.js +114 -0
  21. package/dist/config-schema/subsystems.d.ts +1 -1
  22. package/dist/config-schema/subsystems.js +2 -1
  23. package/dist/config.d.ts +249 -7
  24. package/dist/config.js +113 -3
  25. package/dist/harness/activation/compiler.js +3 -0
  26. package/dist/harness/activation/runtime.d.ts +7 -0
  27. package/dist/harness/activation/runtime.js +60 -2
  28. package/dist/harness/activation/sources/agent-signal.d.ts +11 -0
  29. package/dist/harness/activation/sources/agent-signal.js +33 -0
  30. package/dist/harness/activation/types.d.ts +6 -1
  31. package/dist/harness/agent/builder.d.ts +48 -4
  32. package/dist/harness/agent/builder.js +206 -55
  33. package/dist/harness/agent/config-bridge.d.ts +33 -25
  34. package/dist/harness/agent/config-bridge.js +83 -280
  35. package/dist/harness/agent/index.d.ts +3 -1
  36. package/dist/harness/agent/index.js +2 -1
  37. package/dist/harness/agent/tool-purpose.d.ts +38 -0
  38. package/dist/harness/agent/tool-purpose.js +118 -0
  39. package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
  40. package/dist/harness/agent/wire-agent-builder.js +363 -0
  41. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +4 -1
  42. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +14 -8
  43. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
  44. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
  45. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
  46. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
  47. package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
  48. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
  49. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
  50. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
  51. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
  52. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
  53. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
  54. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
  55. package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
  56. package/dist/harness/collaboration/delegation/child-run.js +241 -0
  57. package/dist/harness/collaboration/delegation/index.d.ts +26 -0
  58. package/dist/harness/collaboration/delegation/index.js +25 -0
  59. package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
  60. package/dist/harness/collaboration/delegation/notifier.js +84 -0
  61. package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
  62. package/dist/harness/collaboration/delegation/registry-types.js +61 -0
  63. package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
  64. package/dist/harness/collaboration/delegation/registry.js +220 -0
  65. package/dist/harness/collaboration/delegation/service.d.ts +249 -0
  66. package/dist/harness/collaboration/delegation/service.js +499 -0
  67. package/dist/harness/collaboration/delegation/store.d.ts +155 -0
  68. package/dist/harness/collaboration/delegation/store.js +271 -0
  69. package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
  70. package/dist/harness/collaboration/delegation/transport.js +61 -0
  71. package/dist/harness/collaboration/delegation/types.d.ts +231 -0
  72. package/dist/harness/collaboration/delegation/types.js +70 -0
  73. package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
  74. package/dist/harness/collaboration/delegation/wiring.js +145 -0
  75. package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
  76. package/dist/harness/collaboration/orchestration/index.js +11 -11
  77. package/dist/harness/context/assembler.d.ts +2 -2
  78. package/dist/harness/context/assembler.js +12 -7
  79. package/dist/harness/context/capabilities/compact/engine.js +80 -38
  80. package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
  81. package/dist/harness/context/capabilities/summary/gate.js +2 -2
  82. package/dist/harness/context/capabilities/summary/policies.js +5 -5
  83. package/dist/harness/context/capabilities/summary/registry.js +39 -24
  84. package/dist/harness/context/constitution/default-agents.md +230 -228
  85. package/dist/harness/context/default-context-engine.d.ts +101 -23
  86. package/dist/harness/context/default-context-engine.js +483 -172
  87. package/dist/harness/context/hybrid-compressor.d.ts +3 -3
  88. package/dist/harness/context/hybrid-compressor.js +18 -23
  89. package/dist/harness/context/index.d.ts +5 -1
  90. package/dist/harness/context/index.js +2 -0
  91. package/dist/harness/context/layer-health.js +3 -2
  92. package/dist/harness/context/layer-snapshot.d.ts +4 -0
  93. package/dist/harness/context/layer-snapshot.js +30 -18
  94. package/dist/harness/context/layer-types.d.ts +49 -1
  95. package/dist/harness/context/layer-types.js +72 -4
  96. package/dist/harness/context/layers.d.ts +32 -15
  97. package/dist/harness/context/layers.js +87 -71
  98. package/dist/harness/context/llm-summarizer.d.ts +15 -1
  99. package/dist/harness/context/llm-summarizer.js +107 -56
  100. package/dist/harness/context/message-selector.js +6 -2
  101. package/dist/harness/context/root-instructions.d.ts +72 -0
  102. package/dist/harness/context/root-instructions.js +227 -0
  103. package/dist/harness/context/runtime-datetime.d.ts +34 -7
  104. package/dist/harness/context/runtime-datetime.js +66 -10
  105. package/dist/harness/context/smart-router.d.ts +1 -1
  106. package/dist/harness/context/smart-router.js +1 -1
  107. package/dist/harness/context/system-prompt-assembler.d.ts +33 -0
  108. package/dist/harness/context/system-prompt-assembler.js +78 -7
  109. package/dist/harness/context/token-constants.d.ts +2 -2
  110. package/dist/harness/context/token-constants.js +2 -2
  111. package/dist/harness/context/token-estimate-fns.d.ts +1 -3
  112. package/dist/harness/context/token-estimate-fns.js +2 -4
  113. package/dist/harness/context/token-estimator.d.ts +1 -1
  114. package/dist/harness/context/token-estimator.js +14 -6
  115. package/dist/harness/context/tool-result-aging.d.ts +140 -0
  116. package/dist/harness/context/tool-result-aging.js +331 -0
  117. package/dist/harness/context/tool-result-body.d.ts +10 -0
  118. package/dist/harness/context/tool-result-body.js +27 -0
  119. package/dist/harness/context/turn-envelope.d.ts +123 -0
  120. package/dist/harness/context/turn-envelope.js +188 -0
  121. package/dist/harness/context/types.d.ts +35 -47
  122. package/dist/harness/extension/execution-environment/effect-policy.d.ts +248 -0
  123. package/dist/harness/extension/execution-environment/effect-policy.js +334 -0
  124. package/dist/harness/extension/execution-environment/index.d.ts +18 -2
  125. package/dist/harness/extension/execution-environment/index.js +11 -2
  126. package/dist/harness/extension/execution-environment/memory-undo.d.ts +101 -0
  127. package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
  128. package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
  129. package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
  130. package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
  131. package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
  132. package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
  133. package/dist/harness/extension/execution-environment/sandbox.js +493 -51
  134. package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
  135. package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
  136. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
  137. package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
  138. package/dist/harness/extension/execution-environment/types.d.ts +67 -39
  139. package/dist/harness/extension/execution-environment/types.js +2 -2
  140. package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
  141. package/dist/harness/extension/execution-environment/undo-log.js +627 -0
  142. package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
  143. package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
  144. package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +4 -0
  145. package/dist/harness/extension/plugin-ecosystem/client-tools/index.js +3 -0
  146. package/dist/harness/extension/plugin-ecosystem/client-tools/invoke.d.ts +56 -0
  147. package/dist/harness/extension/plugin-ecosystem/client-tools/invoke.js +281 -0
  148. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +98 -0
  149. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +250 -0
  150. package/dist/harness/extension/plugin-ecosystem/client-tools/stream.d.ts +124 -0
  151. package/dist/harness/extension/plugin-ecosystem/client-tools/stream.js +372 -0
  152. package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +118 -0
  153. package/dist/harness/extension/plugin-ecosystem/client-tools/types.js +8 -0
  154. package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
  155. package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
  156. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
  157. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
  158. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
  159. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
  160. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
  161. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
  162. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
  163. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
  164. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
  165. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
  166. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
  167. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
  168. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
  169. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
  170. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
  171. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
  172. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
  173. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +45 -0
  174. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +136 -0
  175. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
  176. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
  177. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +278 -82
  178. package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
  179. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
  180. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
  181. package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
  182. package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
  183. package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
  184. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
  185. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
  186. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
  187. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
  188. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +239 -61
  189. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
  190. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +554 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
  192. package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
  193. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +2 -0
  194. package/dist/harness/extension/plugin-ecosystem/tools/index.js +2 -0
  195. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
  196. package/dist/harness/extension/plugin-ecosystem/tools/memory.d.ts +11 -1
  197. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +39 -1
  198. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
  199. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
  200. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
  201. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
  202. package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
  203. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
  204. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
  205. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
  206. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
  207. package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
  208. package/dist/harness/governance/credentials/index.d.ts +1 -1
  209. package/dist/harness/governance/credentials/store.d.ts +16 -4
  210. package/dist/harness/governance/credentials/store.js +33 -6
  211. package/dist/harness/governance/credentials/types.d.ts +11 -0
  212. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
  213. package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
  214. package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
  215. package/dist/harness/governance/human-in-the-loop/index.js +3 -3
  216. package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
  217. package/dist/harness/governance/human-in-the-loop/types.js +6 -2
  218. package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
  219. package/dist/harness/governance/security/capability-enforcer.js +31 -8
  220. package/dist/harness/governance/security/degradation.js +5 -7
  221. package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
  222. package/dist/harness/governance/security/risk-evaluator.js +4 -82
  223. package/dist/harness/governance/security/temp-path.d.ts +41 -0
  224. package/dist/harness/governance/security/temp-path.js +117 -0
  225. package/dist/harness/governance/session-acl/index.d.ts +1 -0
  226. package/dist/harness/governance/session-acl/index.js +1 -0
  227. package/dist/harness/governance/session-acl/rights.d.ts +12 -0
  228. package/dist/harness/governance/session-acl/rights.js +89 -7
  229. package/dist/harness/governance/session-acl/seed-roles.js +9 -1
  230. package/dist/harness/governance/session-acl/service.js +21 -29
  231. package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
  232. package/dist/harness/governance/session-acl/tool-rights.js +238 -0
  233. package/dist/harness/governance/session-acl/types.d.ts +22 -0
  234. package/dist/harness/index.d.ts +18 -15
  235. package/dist/harness/index.js +11 -7
  236. package/dist/harness/knowledge/file-index-store.js +11 -11
  237. package/dist/harness/knowledge/grounding.d.ts +2 -1
  238. package/dist/harness/knowledge/grounding.js +6 -3
  239. package/dist/harness/knowledge/index.d.ts +2 -2
  240. package/dist/harness/knowledge/index.js +1 -1
  241. package/dist/harness/knowledge/ingest.js +4 -1
  242. package/dist/harness/knowledge/job-control-state.js +4 -4
  243. package/dist/harness/knowledge/job-control.js +11 -11
  244. package/dist/harness/knowledge/membership-store.js +11 -11
  245. package/dist/harness/knowledge/network-guard.d.ts +61 -4
  246. package/dist/harness/knowledge/network-guard.js +390 -113
  247. package/dist/harness/knowledge/query-service.js +8 -8
  248. package/dist/harness/knowledge/retriever.js +1 -1
  249. package/dist/harness/knowledge/source-store.d.ts +17 -2
  250. package/dist/harness/knowledge/source-store.js +6 -5
  251. package/dist/harness/knowledge/writer-service.d.ts +2 -0
  252. package/dist/harness/knowledge/writer-service.js +14 -13
  253. package/dist/harness/memory/backfill-trigger.d.ts +2 -2
  254. package/dist/harness/memory/backfill-trigger.js +4 -4
  255. package/dist/harness/memory/cognition-decay.d.ts +36 -0
  256. package/dist/harness/memory/cognition-decay.js +55 -0
  257. package/dist/harness/memory/cognition-gates.d.ts +60 -0
  258. package/dist/harness/memory/cognition-gates.js +191 -0
  259. package/dist/harness/memory/cognition-trigger.d.ts +30 -0
  260. package/dist/harness/memory/cognition-trigger.js +41 -0
  261. package/dist/harness/memory/cognition-types.d.ts +1 -1
  262. package/dist/harness/memory/cognition.d.ts +40 -8
  263. package/dist/harness/memory/cognition.js +432 -79
  264. package/dist/harness/memory/conceptualizer.d.ts +66 -0
  265. package/dist/harness/memory/conceptualizer.js +246 -0
  266. package/dist/harness/memory/index.d.ts +17 -2
  267. package/dist/harness/memory/index.js +12 -1
  268. package/dist/harness/memory/sqlite/agent-db.d.ts +9 -0
  269. package/dist/harness/memory/sqlite/agent-db.js +120 -15
  270. package/dist/harness/memory/sqlite/cognition-store.d.ts +55 -16
  271. package/dist/harness/memory/sqlite/cognition-store.js +591 -144
  272. package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
  273. package/dist/harness/memory/sqlite/memory-store.js +14 -4
  274. package/dist/harness/memory/sqlite/wisdom-store.d.ts +33 -14
  275. package/dist/harness/memory/sqlite/wisdom-store.js +257 -44
  276. package/dist/harness/memory/store.d.ts +1 -0
  277. package/dist/harness/memory/store.js +3 -0
  278. package/dist/harness/memory/time-format.d.ts +28 -0
  279. package/dist/harness/memory/time-format.js +52 -0
  280. package/dist/harness/memory/types.d.ts +343 -16
  281. package/dist/harness/memory/types.js +49 -0
  282. package/dist/harness/memory/wisdom-formation.d.ts +101 -0
  283. package/dist/harness/memory/wisdom-formation.js +304 -0
  284. package/dist/harness/memory/wisdom-gates.d.ts +50 -0
  285. package/dist/harness/memory/wisdom-gates.js +204 -0
  286. package/dist/harness/memory/wisdom-policy.d.ts +107 -0
  287. package/dist/harness/memory/wisdom-policy.js +220 -0
  288. package/dist/harness/memory/wisdom-types.d.ts +3 -2
  289. package/dist/harness/memory/wisdom-types.js +2 -2
  290. package/dist/harness/memory/wisdom.d.ts +27 -0
  291. package/dist/harness/memory/wisdom.js +181 -0
  292. package/dist/harness/observability/observer/hub.js +23 -1
  293. package/dist/harness/observability/observer/index.d.ts +2 -2
  294. package/dist/harness/observability/observer/index.js +1 -1
  295. package/dist/harness/observability/observer/types.d.ts +57 -0
  296. package/dist/harness/observability/observer/types.js +118 -9
  297. package/dist/harness/run/agent/agent.d.ts +27 -0
  298. package/dist/harness/run/agent/agent.js +45 -0
  299. package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
  300. package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
  301. package/dist/harness/run/reliability/harness-events.d.ts +4 -0
  302. package/dist/harness/run/reliability/run-agent.js +116 -20
  303. package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
  304. package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
  305. package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
  306. package/dist/harness/run/run-guard/default-run-guard.js +104 -44
  307. package/dist/harness/run/run-scope.d.ts +52 -0
  308. package/dist/harness/run/runner.d.ts +101 -16
  309. package/dist/harness/run/runner.js +557 -158
  310. package/dist/harness/session/attachments/llm-intent.js +17 -17
  311. package/dist/harness/session/history/port.js +1 -0
  312. package/dist/harness/session/in-memory-store.d.ts +1 -0
  313. package/dist/harness/session/in-memory-store.js +22 -1
  314. package/dist/harness/session/index.d.ts +1 -0
  315. package/dist/harness/session/index.js +1 -0
  316. package/dist/harness/session/schedules/index.d.ts +10 -0
  317. package/dist/harness/session/schedules/index.js +10 -0
  318. package/dist/harness/session/schedules/render.d.ts +13 -0
  319. package/dist/harness/session/schedules/render.js +63 -0
  320. package/dist/harness/session/schedules/service.d.ts +179 -0
  321. package/dist/harness/session/schedules/service.js +695 -0
  322. package/dist/harness/session/schedules/store.d.ts +119 -0
  323. package/dist/harness/session/schedules/store.js +323 -0
  324. package/dist/harness/session/schedules/tools.d.ts +39 -0
  325. package/dist/harness/session/schedules/tools.js +442 -0
  326. package/dist/harness/session/schedules/types.d.ts +104 -0
  327. package/dist/harness/session/schedules/types.js +97 -0
  328. package/dist/harness/session/tasks/tools.js +22 -0
  329. package/dist/harness/session/title.d.ts +86 -0
  330. package/dist/harness/session/title.js +268 -0
  331. package/dist/harness/session/types.d.ts +35 -0
  332. package/dist/harness/shared/events/agent-event-map.d.ts +21 -0
  333. package/dist/harness/shared/events/agent-event-map.js +1 -0
  334. package/dist/harness/shared/types/agent-definition.d.ts +23 -0
  335. package/dist/index.d.ts +25 -9
  336. package/dist/index.js +11 -2
  337. package/dist/integration/providers/anthropic.d.ts +10 -0
  338. package/dist/integration/providers/anthropic.js +44 -1
  339. package/dist/integration/providers/openai.d.ts +10 -0
  340. package/dist/integration/providers/openai.js +58 -2
  341. package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
  342. package/dist/integration/providers/wire-dump-diff.js +351 -0
  343. package/dist/integration/providers/wire-dump.d.ts +178 -0
  344. package/dist/integration/providers/wire-dump.js +396 -0
  345. package/dist/integration/storage/jsonl.d.ts +11 -0
  346. package/dist/integration/storage/jsonl.js +148 -39
  347. package/dist/integration/storage/session-index.js +63 -8
  348. package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -0
  349. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -0
  350. package/dist/subsystems/cognition-steward/conceptualize/handler.d.ts +9 -0
  351. package/dist/subsystems/cognition-steward/conceptualize/handler.js +125 -0
  352. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -0
  353. package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -0
  354. package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +12 -0
  355. package/dist/subsystems/cognition-steward/consolidate/handler.js +93 -0
  356. package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
  357. package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -0
  358. package/dist/subsystems/wisdom-steward/evaluate/handler.d.ts +18 -0
  359. package/dist/subsystems/wisdom-steward/evaluate/handler.js +91 -0
  360. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -0
  361. package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -0
  362. package/dist/subsystems/wisdom-steward/formation/handler.d.ts +18 -0
  363. package/dist/subsystems/wisdom-steward/formation/handler.js +212 -0
  364. package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -0
  365. package/dist/subsystems/wisdom-steward/govern/handler.d.ts +17 -0
  366. package/dist/subsystems/wisdom-steward/govern/handler.js +68 -0
  367. package/package.json +115 -115
  368. package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
  369. package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
  370. package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
  371. package/dist/harness/collaboration/multi-agent/index.js +0 -15
  372. package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
  373. package/dist/harness/collaboration/multi-agent/process.js +0 -256
  374. package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
  375. package/dist/harness/collaboration/multi-agent/registry.js +0 -137
  376. package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
  377. package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
  378. package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
  379. package/dist/harness/collaboration/multi-agent/types.js +0 -15
  380. package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
  381. package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
  382. package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
  383. package/dist/harness/collaboration/orchestration/async-task.js +0 -359
  384. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
  385. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
  386. package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
  387. package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
  388. package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
  389. package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
  390. package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
  391. package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
  392. package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
  393. package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
  394. package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
  395. package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
  396. package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
  397. package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
  398. package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
  399. package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
  400. package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
  401. package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
  402. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
  403. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
  404. package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
  405. package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
  406. package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
  407. package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
  408. package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
  409. package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
  410. package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
  411. package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
  412. package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
  413. package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
  414. package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
  415. package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
  416. package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
  417. package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
  418. package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
  419. package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
  420. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
  421. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.js +0 -0
@@ -10,6 +10,21 @@ import { CoalesceBuffer } from './coalesce.js';
10
10
  import { buildRunRequest, resolveSessionId } from './compiler.js';
11
11
  import { ExplicitRouter } from './router.js';
12
12
  import { RuntimeEvents } from './types.js';
13
+ /**
14
+ * Trigger → 事件回执用裁剪引用(不含 payload 正文)
15
+ *
16
+ * @param trigger - 完整 trigger
17
+ * @returns 裁剪引用(id/type/agentId/sessionId/metadata)
18
+ */
19
+ function toTriggerRef(trigger) {
20
+ return {
21
+ id: trigger.id,
22
+ type: trigger.type,
23
+ agentId: trigger.agentId,
24
+ sessionId: trigger.sessionId,
25
+ metadata: trigger.metadata,
26
+ };
27
+ }
13
28
  export class AgentRuntime {
14
29
  events;
15
30
  router;
@@ -102,6 +117,19 @@ export class AgentRuntime {
102
117
  }
103
118
  return false;
104
119
  }
120
+ /**
121
+ * 是否存在该会话的活跃 Run(不看 agent 归属)。
122
+ *
123
+ * @param sessionId - 会话 id
124
+ * @returns 该会话下任一 Run 在途即 true
125
+ */
126
+ hasActiveRunForSession(sessionId) {
127
+ for (const run of this.activeRuns.values()) {
128
+ if (run.sessionId === sessionId)
129
+ return true;
130
+ }
131
+ return false;
132
+ }
105
133
  on(typeOrListener, maybeListener) {
106
134
  if (typeof typeOrListener === 'function') {
107
135
  this.listeners.add(typeOrListener);
@@ -134,6 +162,7 @@ export class AgentRuntime {
134
162
  async dispatch(trigger, options) {
135
163
  if (!this.started) {
136
164
  this.emitRuntime(RuntimeEvents.TRIGGER_DROPPED, {
165
+ triggerRef: toTriggerRef(trigger),
137
166
  triggerId: trigger.id,
138
167
  reason: 'runtime_stopped',
139
168
  });
@@ -148,13 +177,26 @@ export class AgentRuntime {
148
177
  const targets = await this.router.resolve(trigger, this.agents);
149
178
  if (targets.length === 0) {
150
179
  this.emitRuntime(RuntimeEvents.TRIGGER_DROPPED, {
180
+ triggerRef: toTriggerRef(trigger),
151
181
  triggerId: trigger.id,
152
182
  reason: 'no_agent',
153
183
  });
154
184
  return { status: 'skipped', reason: 'no_agent' };
155
185
  }
156
186
  if (targets.length === 1) {
157
- return this.dispatchToTarget(trigger, targets[0], options);
187
+ const result = await this.dispatchToTarget(trigger, targets[0], options);
188
+ // 单目标丢弃也必须留下 TRIGGER_DROPPED(与 fan-out 对称):
189
+ // 「trigger 未被受理必有 dropped 事件」是委派送达回执(delegation §7.1)
190
+ // 依赖的不变量,缺事件 = 送达回执无法证伪。受理后 run 失败走 RUN_FAILED
191
+ // (消息可能已进父上下文,按已送达处理,不回执)
192
+ if (result.status === 'skipped') {
193
+ this.emitRuntime(RuntimeEvents.TRIGGER_DROPPED, {
194
+ triggerRef: toTriggerRef(trigger),
195
+ triggerId: trigger.id,
196
+ reason: result.reason,
197
+ });
198
+ }
199
+ return result;
158
200
  }
159
201
  // fan-out:串行;聚合为 FanoutDispatchResult(ran/aborted/failed 均不静默丢弃)
160
202
  const results = [];
@@ -167,6 +209,7 @@ export class AgentRuntime {
167
209
  const allSkipped = results.every((r) => r.result.status === 'skipped');
168
210
  if (anyFailed) {
169
211
  this.emitRuntime(RuntimeEvents.TRIGGER_DROPPED, {
212
+ triggerRef: toTriggerRef(trigger),
170
213
  triggerId: trigger.id,
171
214
  reason: 'fanout_partial_failure',
172
215
  results: results.map((r) => ({ agentId: r.agentId, status: r.result.status })),
@@ -177,6 +220,12 @@ export class AgentRuntime {
177
220
  const reason = results[0]?.result.status === 'skipped'
178
221
  ? results[0].result.reason
179
222
  : 'no_agent';
223
+ this.emitRuntime(RuntimeEvents.TRIGGER_DROPPED, {
224
+ triggerRef: toTriggerRef(trigger),
225
+ triggerId: trigger.id,
226
+ reason,
227
+ results: results.map((r) => ({ agentId: r.agentId, status: r.result.status })),
228
+ });
180
229
  return { status: 'skipped', reason };
181
230
  }
182
231
  // anyRan(含 mixed ran + aborted/skipped)→ ran + 明细
@@ -219,7 +268,13 @@ export class AgentRuntime {
219
268
  if (!this.started) {
220
269
  return { status: 'skipped', reason: 'runtime_stopped' };
221
270
  }
222
- const request = buildRunRequest(agent, triggers, sessionId);
271
+ // I6:schedule 点火以 timer 主体入审计(arch/session-schedules.md)
272
+ const isScheduleWake = triggers.some((t) => t.type === 'schedule');
273
+ const request = buildRunRequest(agent, triggers, sessionId, {
274
+ actorType: isScheduleWake ? 'timer' : undefined,
275
+ actorId: isScheduleWake ? (triggers[0]?.metadata?.reason ?? triggers[0]?.id) : undefined,
276
+ intent: isScheduleWake ? 'schedule_wake' : undefined,
277
+ });
223
278
  const controller = new AbortController();
224
279
  const run = {
225
280
  requestId: request.requestId,
@@ -272,6 +327,9 @@ export class AgentRuntime {
272
327
  requestId: request.requestId,
273
328
  agentId: agent.agentId,
274
329
  sessionId,
330
+ // 回执关联:已受理的 trigger(run 失败但消息可能已进父上下文,
331
+ // 送达语义视为已送达,订阅方自行判定)
332
+ triggerRefs: request.triggers.map(toTriggerRef),
275
333
  error: message,
276
334
  });
277
335
  return { status: 'failed', error: message };
@@ -6,12 +6,21 @@
6
6
  import type { EventBus } from '@octopi-agent/core/index.js';
7
7
  import type { Trigger, TriggerPayload, TriggerSource } from '../types.js';
8
8
  export declare const AGENT_SIGNAL_EVENT_TYPE = "runtime.agent_signal";
9
+ /**
10
+ * 查询总线上是否有存活的 `AgentSignalSource` 接收端。
11
+ *
12
+ * @param events - 事件总线
13
+ * @returns 有接收端返回 true;投递器应据此拒绝把通知判为已送达
14
+ */
15
+ export declare function hasAgentSignalReceiver(events: EventBus): boolean;
9
16
  export interface AgentSignal {
10
17
  fromAgentId: string;
11
18
  toAgentId: string;
12
19
  sessionId?: string;
13
20
  payload: TriggerPayload;
14
21
  reason?: string;
22
+ /** 委派单 ID(collaboration/delegation);透传到消息 metadata */
23
+ delegationId?: string;
15
24
  }
16
25
  export interface AgentSignalSourceConfig {
17
26
  id?: string;
@@ -23,6 +32,8 @@ export declare class AgentSignalSource implements TriggerSource {
23
32
  readonly type: "agent_signal";
24
33
  private disposables;
25
34
  private running;
35
+ /** 本实例是否已计入 receiverBuses(防未 start 的 stop / 二次 stop 误删兄弟登记) */
36
+ private receiverCounted;
26
37
  constructor(config?: AgentSignalSourceConfig);
27
38
  start(emit: (t: Trigger) => void): Promise<void>;
28
39
  stop(): Promise<void>;
@@ -6,12 +6,30 @@
6
6
  import { randomUUID } from 'node:crypto';
7
7
  import { RuntimeEvents } from '../types.js';
8
8
  export const AGENT_SIGNAL_EVENT_TYPE = 'runtime.agent_signal';
9
+ /**
10
+ * 已挂载 `AgentSignalSource` 的总线登记表(引用计数)。
11
+ *
12
+ * notify 投递器据此判断「总线上有没有接收端」——`bus.emit` 对有无监听者
13
+ * 零反馈,若不校验,发进空总线的通知会被误标已送达(2026-10-22 断链根因)。
14
+ */
15
+ const receiverBuses = new WeakMap();
16
+ /**
17
+ * 查询总线上是否有存活的 `AgentSignalSource` 接收端。
18
+ *
19
+ * @param events - 事件总线
20
+ * @returns 有接收端返回 true;投递器应据此拒绝把通知判为已送达
21
+ */
22
+ export function hasAgentSignalReceiver(events) {
23
+ return (receiverBuses.get(events) ?? 0) > 0;
24
+ }
9
25
  export class AgentSignalSource {
10
26
  config;
11
27
  id;
12
28
  type = 'agent_signal';
13
29
  disposables = [];
14
30
  running = false;
31
+ /** 本实例是否已计入 receiverBuses(防未 start 的 stop / 二次 stop 误删兄弟登记) */
32
+ receiverCounted = false;
15
33
  constructor(config = {}) {
16
34
  this.config = config;
17
35
  this.id = config.id ?? `agent-signal-${randomUUID().slice(0, 8)}`;
@@ -21,6 +39,8 @@ export class AgentSignalSource {
21
39
  return;
22
40
  this.running = true;
23
41
  if (this.config.events) {
42
+ receiverBuses.set(this.config.events, (receiverBuses.get(this.config.events) ?? 0) + 1);
43
+ this.receiverCounted = true;
24
44
  this.disposables.push(this.config.events.on(AGENT_SIGNAL_EVENT_TYPE, (event) => {
25
45
  if (!this.running)
26
46
  return;
@@ -33,6 +53,7 @@ export class AgentSignalSource {
33
53
  sessionId: data.sessionId,
34
54
  payload: { kind: 'system_note', content: data.content ?? data.reason ?? 'agent signal' },
35
55
  reason: data.reason,
56
+ delegationId: data.delegationId,
36
57
  });
37
58
  this.config.events?.emit({
38
59
  type: RuntimeEvents.AGENT_SIGNAL_EMITTED,
@@ -51,6 +72,16 @@ export class AgentSignalSource {
51
72
  }
52
73
  async stop() {
53
74
  this.running = false;
75
+ // 只回收本实例的计数(未 start / 二次 stop 不得误删兄弟 source 的登记)
76
+ if (this.config.events && this.receiverCounted) {
77
+ this.receiverCounted = false;
78
+ const key = this.config.events;
79
+ const left = (receiverBuses.get(key) ?? 1) - 1;
80
+ if (left > 0)
81
+ receiverBuses.set(key, left);
82
+ else
83
+ receiverBuses.delete(key);
84
+ }
54
85
  for (const d of this.disposables)
55
86
  d.dispose();
56
87
  this.disposables = [];
@@ -69,6 +100,7 @@ export class AgentSignalSource {
69
100
  source: this.id,
70
101
  reason: signal.reason,
71
102
  parentAgentId: signal.fromAgentId,
103
+ delegationId: signal.delegationId,
72
104
  },
73
105
  };
74
106
  }
@@ -88,6 +120,7 @@ export function emitAgentSignal(events, signal) {
88
120
  ? signal.payload.content
89
121
  : JSON.stringify(signal.payload)),
90
122
  reason: signal.reason,
123
+ delegationId: signal.delegationId,
91
124
  },
92
125
  });
93
126
  }
@@ -17,6 +17,8 @@ export type TriggerPayload = {
17
17
  kind: 'structured';
18
18
  data: unknown;
19
19
  };
20
+ /** Trigger 的裁剪引用:用于事件回执等「只要关联、不要正文」的场合(dropped 事件) */
21
+ export type TriggerRef = Omit<Trigger, 'payload'>;
20
22
  export interface Trigger {
21
23
  id: string;
22
24
  type: TriggerType;
@@ -36,6 +38,8 @@ export interface Trigger {
36
38
  reason?: string;
37
39
  parentAgentId?: string;
38
40
  causalRunId?: string;
41
+ /** 委派单 ID(`collaboration/delegation`);notify 通道透传,供 UI/下游过滤 */
42
+ delegationId?: string;
39
43
  /** 消息级模型覆盖(`provider/model` 或裸名) */
40
44
  modelOverride?: string;
41
45
  /** modelOverride 为裸名时的 provider */
@@ -105,7 +109,8 @@ export interface RuntimeAgent {
105
109
  /** Trigger → sessionId;缺省用 trigger.sessionId 或 `${agentId}:main` */
106
110
  resolveSession?: (trigger: Trigger) => string;
107
111
  discoverable?: boolean;
108
- capabilities?: string[];
112
+ /** 特质标签(委派/路由发现用;无权限语义) */
113
+ traits?: string[];
109
114
  }
110
115
  /**
111
116
  * emit 必须同步、非阻塞(arch/agent-runtime.md §5.1)。
@@ -36,9 +36,24 @@ export interface ToolContextProvider {
36
36
  get(): {
37
37
  sessionId: string;
38
38
  agentId: string;
39
+ runId?: string;
39
40
  messages: import('@octopi-agent/core/types.js').Message[];
40
41
  cwd?: string;
41
42
  attachmentRoots?: string[];
43
+ fileEffects: import('@octopi-agent/core/types/tools.js').ToolFileEffects;
44
+ memoryEffects: import('@octopi-agent/core/types/tools.js').MemoryEffectJournal;
45
+ pathRoots?: string[];
46
+ pathContainment?: 'strict' | 'soft' | 'none';
47
+ confirmEffect?: import('@octopi-agent/core/types/tools.js').ToolExecutionContext['confirmEffect'];
48
+ effectChannel?: 'engine' | 'host-gate';
49
+ processLimits?: boolean;
50
+ shellEscape?: 'deny' | 'confirm' | 'allow';
51
+ shellJournal?: 'snapshot' | 'off';
52
+ shellJournalLimit?: {
53
+ maxFiles?: number;
54
+ maxBytes?: number;
55
+ maxFileSize?: number;
56
+ };
42
57
  };
43
58
  setRuntime(sessionId: string, agentId: string, messages: import('@octopi-agent/core/types.js').Message[]): void;
44
59
  }
@@ -94,6 +109,16 @@ export interface AgentBuildResult {
94
109
  /** 子系统运行时(memory.steward.* 等);无子系统时为 undefined */
95
110
  runtime?: import('../collaboration/autonomous-subsystem/runtime.js').SubsystemRuntime;
96
111
  events: EventBus;
112
+ /** SessionStore(委派子 Run 预创建 child session 用;`arch/delegation.md` D7) */
113
+ store: SessionStore<SessionData>;
114
+ /**
115
+ * 后置注册工具(build 之后追加)。
116
+ *
117
+ * 走 `convertToAgentTool` + `Agent.registerTool`,后者会同步
118
+ * SecurityGuard 的未注册工具硬边界名单,安全面保持一致。
119
+ * 供委派 `delegate_*` 等运行期才可构造的工具使用。
120
+ */
121
+ registerTools: (tools: RegisteredTool[]) => void;
97
122
  /** ContextEngine 实例(手动压缩入口) */
98
123
  contextEngine?: import('../context/types.js').ContextEngine;
99
124
  contextHealth: (agentId?: string) => Promise<import('../context/layer-health.js').ContextLayerHealth>;
@@ -130,6 +155,8 @@ export declare class AgentBuilder {
130
155
  private _runGuard?;
131
156
  private _runGuardConfig?;
132
157
  private _checkpointInterval?;
158
+ /** 模型调用 watchdog 超时(undefined = 引擎默认) */
159
+ private _modelCallTimeouts?;
133
160
  private _reliabilityConfig?;
134
161
  private _personaWorkspaces;
135
162
  private _systemPrompt?;
@@ -175,6 +202,8 @@ export declare class AgentBuilder {
175
202
  private _observerHub?;
176
203
  /** 工具效应隔离(I5);Runner 解析 toolRuntime.cwd */
177
204
  private _toolIsolation?;
205
+ private _effectPolicy?;
206
+ private _confirmEffect?;
178
207
  private _mcpConfigs;
179
208
  /** MCP client 工厂(Integration 适配器由宿主注入) */
180
209
  private _mcpClientFactory?;
@@ -195,9 +224,13 @@ export declare class AgentBuilder {
195
224
  /** 设置模型提供者 */
196
225
  model(provider: ModelProvider): this;
197
226
  model(name: string): this;
198
- /** 注册工具 */
227
+ /** 注册工具(同名默认拒绝;单工具失败不中断其余注册) */
199
228
  tool(tool: RegisteredTool): this;
200
- /** 批量注册工具 */
229
+ /**
230
+ * 覆盖注册(显式)。用于热更新/替换同名工具,不可默默发生。
231
+ */
232
+ toolReplace(tool: RegisteredTool): this;
233
+ /** 批量注册:逐个 try/catch,避免一个工具失败拖垮整表 */
201
234
  tools(...tools: RegisteredTool[]): this;
202
235
  private _contextProvider;
203
236
  /** 获取运行时上下文提供者 */
@@ -303,7 +336,7 @@ export declare class AgentBuilder {
303
336
  }): this;
304
337
  /** 注入 WisdomStore(半静态思维范式,进 system prompt WisdomLayer) */
305
338
  wisdomStore(store: import('../memory/types.js').WisdomStore): this;
306
- /** 注入 ConceptGraphStore(按 query 召回概念边,进 system prompt CognitionLayer) */
339
+ /** 注入 ConceptGraphStore(spreadingActivate 召回概念子图,进 system prompt CognitionLayer) */
307
340
  cognitionStore(store: import('../memory/types.js').ConceptGraphStore): this;
308
341
  /**
309
342
  * system prompt 装配器调参
@@ -321,6 +354,8 @@ export declare class AgentBuilder {
321
354
  includeLayerPreview?: boolean;
322
355
  layerPreviewChars?: number;
323
356
  includeLayerContent?: boolean;
357
+ /** E8:易变快照组 token 预算(缺省不设上限) */
358
+ snapshotBudgetTokens?: number;
324
359
  layerShares?: Partial<Record<import('../context/layer-types.js').ContextLayerId, number>>;
325
360
  }): this;
326
361
  /** 设置摘要函数(用于 LLM 摘要压缩) */
@@ -378,6 +413,11 @@ export declare class AgentBuilder {
378
413
  runGuard(config?: RunGuardConfig): this;
379
414
  /** 设置过程监督(手动传入实例) */
380
415
  runGuard(guard: RunGuard, checkpointInterval?: number): this;
416
+ /** 设置模型调用 watchdog 超时(流式 idle + 绝对上限;缺省用引擎默认) */
417
+ modelCallTimeouts(timeouts: {
418
+ idleTimeoutMs?: number;
419
+ absoluteTimeoutMs?: number;
420
+ }): this;
381
421
  /** 加载 persona 目录 */
382
422
  persona(workspace: string): this;
383
423
  persona(...workspaces: string[]): this;
@@ -391,7 +431,7 @@ export declare class AgentBuilder {
391
431
  systemPrompt(prompt: string): this;
392
432
  /** 设置 Session 存储 */
393
433
  store(store: SessionStore<SessionData>): this;
394
- /** 设置 Runner 配置 */
434
+ /** 设置 Runner 配置(浅合并,便于多次补充字段) */
395
435
  runnerConfig(config: SessionAwareRunnerConfig): this;
396
436
  /** 注入产品 Observer Hub(LLM 视图等) */
397
437
  observerHub(hub: import('../observability/observer/hub.js').ObserverHub | undefined): this;
@@ -400,6 +440,10 @@ export declare class AgentBuilder {
400
440
  *
401
441
  * @param mode - `none` | `session-subdir` | `session-lock`
402
442
  */
443
+ /** P3:注入 ToolEffectPolicy */
444
+ effectPolicy(config: import('../extension/execution-environment/effect-policy.js').EffectPolicyConfig): this;
445
+ /** P4:宿主 confirmEffect(host-gate) */
446
+ confirmEffect(fn: import('../extension/execution-environment/effect-policy.js').ConfirmEffect): this;
403
447
  toolIsolation(mode: import('../extension/execution-environment/isolation.js').ToolIsolationMode): this;
404
448
  /**
405
449
  * 统一构建入口。