@octopi-agent/engine 0.70.7 → 0.86.38

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (362) hide show
  1. package/LICENSE +201 -201
  2. package/NOTICE +7 -7
  3. package/README.md +64 -26
  4. package/dist/config-schema/agent.d.ts +89 -1
  5. package/dist/config-schema/agent.js +69 -0
  6. package/dist/config-schema/context.d.ts +23 -4
  7. package/dist/config-schema/context.js +28 -1
  8. package/dist/config-schema/engine.d.ts +201 -9
  9. package/dist/config-schema/engine.js +31 -2
  10. package/dist/config-schema/governance.d.ts +95 -0
  11. package/dist/config-schema/governance.js +91 -0
  12. package/dist/config-schema/models.d.ts +1 -1
  13. package/dist/config-schema/observability.d.ts +6 -0
  14. package/dist/config-schema/observability.js +16 -0
  15. package/dist/config-schema/run.d.ts +10 -0
  16. package/dist/config-schema/run.js +18 -0
  17. package/dist/config-schema/shared.d.ts +10 -0
  18. package/dist/config-schema/shared.js +10 -0
  19. package/dist/config-schema/substrate.d.ts +1 -1
  20. package/dist/config-schema/subsystems.d.ts +1 -1
  21. package/dist/config-schema/subsystems.js +2 -1
  22. package/dist/config.d.ts +178 -7
  23. package/dist/config.js +113 -3
  24. package/dist/harness/activation/compiler.js +3 -0
  25. package/dist/harness/activation/runtime.d.ts +7 -0
  26. package/dist/harness/activation/runtime.js +60 -2
  27. package/dist/harness/activation/sources/agent-signal.d.ts +11 -0
  28. package/dist/harness/activation/sources/agent-signal.js +33 -0
  29. package/dist/harness/activation/types.d.ts +6 -1
  30. package/dist/harness/agent/builder.d.ts +47 -3
  31. package/dist/harness/agent/builder.js +180 -54
  32. package/dist/harness/agent/config-bridge.d.ts +33 -25
  33. package/dist/harness/agent/config-bridge.js +81 -291
  34. package/dist/harness/agent/index.d.ts +3 -1
  35. package/dist/harness/agent/index.js +2 -1
  36. package/dist/harness/agent/tool-purpose.d.ts +38 -0
  37. package/dist/harness/agent/tool-purpose.js +118 -0
  38. package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
  39. package/dist/harness/agent/wire-agent-builder.js +363 -0
  40. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +4 -1
  41. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +14 -8
  42. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
  43. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
  44. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
  45. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
  46. package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
  47. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
  48. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
  49. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
  50. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
  51. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
  52. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
  53. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
  54. package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
  55. package/dist/harness/collaboration/delegation/child-run.js +241 -0
  56. package/dist/harness/collaboration/delegation/index.d.ts +26 -0
  57. package/dist/harness/collaboration/delegation/index.js +25 -0
  58. package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
  59. package/dist/harness/collaboration/delegation/notifier.js +84 -0
  60. package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
  61. package/dist/harness/collaboration/delegation/registry-types.js +61 -0
  62. package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
  63. package/dist/harness/collaboration/delegation/registry.js +220 -0
  64. package/dist/harness/collaboration/delegation/service.d.ts +249 -0
  65. package/dist/harness/collaboration/delegation/service.js +499 -0
  66. package/dist/harness/collaboration/delegation/store.d.ts +155 -0
  67. package/dist/harness/collaboration/delegation/store.js +271 -0
  68. package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
  69. package/dist/harness/collaboration/delegation/transport.js +61 -0
  70. package/dist/harness/collaboration/delegation/types.d.ts +231 -0
  71. package/dist/harness/collaboration/delegation/types.js +70 -0
  72. package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
  73. package/dist/harness/collaboration/delegation/wiring.js +145 -0
  74. package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
  75. package/dist/harness/collaboration/orchestration/index.js +11 -11
  76. package/dist/harness/context/assembler.d.ts +2 -2
  77. package/dist/harness/context/assembler.js +12 -7
  78. package/dist/harness/context/capabilities/compact/engine.js +80 -38
  79. package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
  80. package/dist/harness/context/capabilities/summary/registry.js +10 -0
  81. package/dist/harness/context/constitution/default-agents.md +230 -228
  82. package/dist/harness/context/default-context-engine.d.ts +101 -23
  83. package/dist/harness/context/default-context-engine.js +483 -172
  84. package/dist/harness/context/hybrid-compressor.d.ts +3 -3
  85. package/dist/harness/context/hybrid-compressor.js +18 -23
  86. package/dist/harness/context/index.d.ts +5 -1
  87. package/dist/harness/context/index.js +2 -0
  88. package/dist/harness/context/layer-snapshot.d.ts +4 -0
  89. package/dist/harness/context/layer-snapshot.js +30 -18
  90. package/dist/harness/context/layer-types.d.ts +49 -1
  91. package/dist/harness/context/layer-types.js +72 -4
  92. package/dist/harness/context/layers.d.ts +5 -2
  93. package/dist/harness/context/layers.js +11 -5
  94. package/dist/harness/context/llm-summarizer.d.ts +15 -1
  95. package/dist/harness/context/llm-summarizer.js +107 -56
  96. package/dist/harness/context/message-selector.js +6 -2
  97. package/dist/harness/context/root-instructions.d.ts +72 -0
  98. package/dist/harness/context/root-instructions.js +227 -0
  99. package/dist/harness/context/runtime-datetime.d.ts +34 -7
  100. package/dist/harness/context/runtime-datetime.js +66 -10
  101. package/dist/harness/context/smart-router.d.ts +1 -1
  102. package/dist/harness/context/smart-router.js +1 -1
  103. package/dist/harness/context/system-prompt-assembler.d.ts +30 -0
  104. package/dist/harness/context/system-prompt-assembler.js +67 -6
  105. package/dist/harness/context/token-constants.d.ts +2 -2
  106. package/dist/harness/context/token-constants.js +2 -2
  107. package/dist/harness/context/token-estimate-fns.d.ts +1 -3
  108. package/dist/harness/context/token-estimate-fns.js +2 -4
  109. package/dist/harness/context/token-estimator.d.ts +1 -1
  110. package/dist/harness/context/token-estimator.js +14 -6
  111. package/dist/harness/context/tool-result-aging.d.ts +140 -0
  112. package/dist/harness/context/tool-result-aging.js +331 -0
  113. package/dist/harness/context/tool-result-body.d.ts +10 -0
  114. package/dist/harness/context/tool-result-body.js +27 -0
  115. package/dist/harness/context/turn-envelope.d.ts +123 -0
  116. package/dist/harness/context/turn-envelope.js +188 -0
  117. package/dist/harness/context/types.d.ts +35 -47
  118. package/dist/harness/extension/execution-environment/effect-policy.d.ts +248 -0
  119. package/dist/harness/extension/execution-environment/effect-policy.js +334 -0
  120. package/dist/harness/extension/execution-environment/index.d.ts +18 -2
  121. package/dist/harness/extension/execution-environment/index.js +11 -2
  122. package/dist/harness/extension/execution-environment/memory-undo.d.ts +101 -0
  123. package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
  124. package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
  125. package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
  126. package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
  127. package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
  128. package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
  129. package/dist/harness/extension/execution-environment/sandbox.js +493 -51
  130. package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
  131. package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
  132. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
  133. package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
  134. package/dist/harness/extension/execution-environment/types.d.ts +67 -39
  135. package/dist/harness/extension/execution-environment/types.js +2 -2
  136. package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
  137. package/dist/harness/extension/execution-environment/undo-log.js +627 -0
  138. package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
  139. package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
  140. package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +1 -1
  141. package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +9 -0
  142. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
  143. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
  144. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
  145. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
  146. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
  147. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
  148. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
  149. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
  150. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
  151. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
  152. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
  153. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
  154. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
  155. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
  156. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
  157. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
  158. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
  159. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +45 -0
  160. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +136 -0
  161. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
  162. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
  163. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +277 -81
  164. package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
  165. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
  166. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
  167. package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
  168. package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
  169. package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
  170. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
  171. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
  172. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
  173. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
  174. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +239 -61
  175. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
  176. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +554 -0
  177. package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
  178. package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
  179. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +2 -0
  180. package/dist/harness/extension/plugin-ecosystem/tools/index.js +2 -0
  181. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
  182. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +25 -1
  183. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
  184. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
  185. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
  186. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
  187. package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
  188. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
  189. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
  190. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
  192. package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
  193. package/dist/harness/governance/credentials/index.d.ts +1 -1
  194. package/dist/harness/governance/credentials/store.d.ts +16 -4
  195. package/dist/harness/governance/credentials/store.js +33 -6
  196. package/dist/harness/governance/credentials/types.d.ts +11 -0
  197. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
  198. package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
  199. package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
  200. package/dist/harness/governance/human-in-the-loop/index.js +3 -3
  201. package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
  202. package/dist/harness/governance/human-in-the-loop/types.js +6 -2
  203. package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
  204. package/dist/harness/governance/security/capability-enforcer.js +31 -8
  205. package/dist/harness/governance/security/degradation.js +5 -7
  206. package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
  207. package/dist/harness/governance/security/risk-evaluator.js +4 -82
  208. package/dist/harness/governance/security/temp-path.d.ts +41 -0
  209. package/dist/harness/governance/security/temp-path.js +117 -0
  210. package/dist/harness/governance/session-acl/index.d.ts +1 -0
  211. package/dist/harness/governance/session-acl/index.js +1 -0
  212. package/dist/harness/governance/session-acl/rights.d.ts +12 -0
  213. package/dist/harness/governance/session-acl/rights.js +89 -7
  214. package/dist/harness/governance/session-acl/seed-roles.js +9 -1
  215. package/dist/harness/governance/session-acl/service.js +21 -29
  216. package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
  217. package/dist/harness/governance/session-acl/tool-rights.js +238 -0
  218. package/dist/harness/governance/session-acl/types.d.ts +22 -0
  219. package/dist/harness/index.d.ts +14 -12
  220. package/dist/harness/index.js +9 -6
  221. package/dist/harness/knowledge/file-index-store.js +11 -11
  222. package/dist/harness/knowledge/grounding.d.ts +2 -1
  223. package/dist/harness/knowledge/grounding.js +6 -3
  224. package/dist/harness/knowledge/index.d.ts +2 -2
  225. package/dist/harness/knowledge/index.js +1 -1
  226. package/dist/harness/knowledge/ingest.js +4 -1
  227. package/dist/harness/knowledge/job-control-state.js +4 -4
  228. package/dist/harness/knowledge/job-control.js +11 -11
  229. package/dist/harness/knowledge/membership-store.js +11 -11
  230. package/dist/harness/knowledge/network-guard.d.ts +61 -4
  231. package/dist/harness/knowledge/network-guard.js +390 -113
  232. package/dist/harness/knowledge/query-service.js +3 -3
  233. package/dist/harness/knowledge/writer-service.d.ts +2 -0
  234. package/dist/harness/knowledge/writer-service.js +14 -13
  235. package/dist/harness/memory/backfill-trigger.d.ts +2 -2
  236. package/dist/harness/memory/backfill-trigger.js +4 -4
  237. package/dist/harness/memory/index.d.ts +1 -0
  238. package/dist/harness/memory/index.js +1 -0
  239. package/dist/harness/memory/sqlite/agent-db.js +2 -0
  240. package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
  241. package/dist/harness/memory/sqlite/memory-store.js +14 -4
  242. package/dist/harness/memory/sqlite/wisdom-store.js +9 -9
  243. package/dist/harness/memory/store.d.ts +1 -0
  244. package/dist/harness/memory/store.js +3 -0
  245. package/dist/harness/memory/time-format.d.ts +28 -0
  246. package/dist/harness/memory/time-format.js +52 -0
  247. package/dist/harness/memory/types.d.ts +12 -0
  248. package/dist/harness/observability/observer/hub.js +23 -1
  249. package/dist/harness/observability/observer/index.d.ts +2 -2
  250. package/dist/harness/observability/observer/index.js +1 -1
  251. package/dist/harness/observability/observer/types.d.ts +57 -0
  252. package/dist/harness/observability/observer/types.js +118 -9
  253. package/dist/harness/run/agent/agent.d.ts +18 -0
  254. package/dist/harness/run/agent/agent.js +26 -0
  255. package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
  256. package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
  257. package/dist/harness/run/reliability/harness-events.d.ts +4 -0
  258. package/dist/harness/run/reliability/run-agent.js +110 -18
  259. package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
  260. package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
  261. package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
  262. package/dist/harness/run/run-guard/default-run-guard.js +104 -44
  263. package/dist/harness/run/run-scope.d.ts +52 -0
  264. package/dist/harness/run/runner.d.ts +101 -16
  265. package/dist/harness/run/runner.js +556 -158
  266. package/dist/harness/session/attachments/llm-intent.js +17 -17
  267. package/dist/harness/session/history/port.js +1 -0
  268. package/dist/harness/session/in-memory-store.d.ts +1 -0
  269. package/dist/harness/session/in-memory-store.js +22 -1
  270. package/dist/harness/session/schedules/index.d.ts +10 -0
  271. package/dist/harness/session/schedules/index.js +10 -0
  272. package/dist/harness/session/schedules/render.d.ts +13 -0
  273. package/dist/harness/session/schedules/render.js +63 -0
  274. package/dist/harness/session/schedules/service.d.ts +179 -0
  275. package/dist/harness/session/schedules/service.js +695 -0
  276. package/dist/harness/session/schedules/store.d.ts +119 -0
  277. package/dist/harness/session/schedules/store.js +323 -0
  278. package/dist/harness/session/schedules/tools.d.ts +39 -0
  279. package/dist/harness/session/schedules/tools.js +442 -0
  280. package/dist/harness/session/schedules/types.d.ts +104 -0
  281. package/dist/harness/session/schedules/types.js +97 -0
  282. package/dist/harness/session/tasks/tools.js +22 -0
  283. package/dist/harness/session/types.d.ts +35 -0
  284. package/dist/harness/shared/events/agent-event-map.d.ts +13 -0
  285. package/dist/harness/shared/types/agent-definition.d.ts +23 -0
  286. package/dist/index.d.ts +23 -9
  287. package/dist/index.js +10 -2
  288. package/dist/integration/providers/anthropic.d.ts +10 -0
  289. package/dist/integration/providers/anthropic.js +44 -1
  290. package/dist/integration/providers/openai.d.ts +10 -0
  291. package/dist/integration/providers/openai.js +58 -2
  292. package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
  293. package/dist/integration/providers/wire-dump-diff.js +351 -0
  294. package/dist/integration/providers/wire-dump.d.ts +178 -0
  295. package/dist/integration/providers/wire-dump.js +396 -0
  296. package/dist/integration/storage/jsonl.d.ts +11 -0
  297. package/dist/integration/storage/jsonl.js +148 -39
  298. package/dist/integration/storage/session-index.js +63 -8
  299. package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -43
  300. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -50
  301. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -6
  302. package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -54
  303. package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
  304. package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -50
  305. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -42
  306. package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -54
  307. package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -55
  308. package/package.json +115 -115
  309. package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
  310. package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
  311. package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
  312. package/dist/harness/collaboration/multi-agent/index.js +0 -15
  313. package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
  314. package/dist/harness/collaboration/multi-agent/process.js +0 -256
  315. package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
  316. package/dist/harness/collaboration/multi-agent/registry.js +0 -137
  317. package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
  318. package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
  319. package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
  320. package/dist/harness/collaboration/multi-agent/types.js +0 -15
  321. package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
  322. package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
  323. package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
  324. package/dist/harness/collaboration/orchestration/async-task.js +0 -359
  325. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
  326. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
  327. package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
  328. package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
  329. package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
  330. package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
  331. package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
  332. package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
  333. package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
  334. package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
  335. package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
  336. package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
  337. package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
  338. package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
  339. package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
  340. package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
  341. package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
  342. package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
  343. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
  344. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
  345. package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
  346. package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
  347. package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
  348. package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
  349. package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
  350. package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
  351. package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
  352. package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
  353. package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
  354. package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
  355. package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
  356. package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
  357. package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
  358. package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
  359. package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
  360. package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
  361. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
  362. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.js +0 -0
@@ -14,12 +14,17 @@
14
14
  * ```
15
15
  */
16
16
  import { DefaultToolBus } from '../extension/plugin-ecosystem/tools/tool-bus.js';
17
+ import { createUnconfiguredFileEffects, createUnconfiguredMemoryEffects, } from '../extension/execution-environment/undo-log.js';
18
+ import { JournaledMemoryStore } from '../extension/execution-environment/memory-undo.js';
19
+ import { buildToolLlmParameters, prepareHandlerArgs, resolveToolCallPurpose, sanitizeToolJsonSchema, } from './tool-purpose.js';
17
20
  import { Agent } from '../run/agent/index.js';
18
21
  import { DEFAULT_RELIABILITY_CONFIG } from '../run/reliability/run-agent.js';
19
22
  import { DefaultRunGuard } from '../run/run-guard/default-run-guard.js';
20
23
  import { summarizeLlmMessages } from '../observability/observer/types.js';
21
24
  import { SessionTaskService } from '../session/tasks/service.js';
22
25
  import { createSessionTaskTools } from '../session/tasks/tools.js';
26
+ import { SessionScheduleService } from '../session/schedules/service.js';
27
+ import { createSessionScheduleTools } from '../session/schedules/tools.js';
23
28
  import { InMemorySessionStore } from '../session/in-memory-store.js';
24
29
  import { DefaultEventBus, } from '@octopi-agent/core/primitives/event-bus.js';
25
30
  import { DefaultSecurityGuard, } from '../governance/security/default-security-guard.js';
@@ -93,52 +98,95 @@ class RuntimeToolContextProvider {
93
98
  get() {
94
99
  // I1:优先 RunScope ALS(并发 session 下不可依赖单槽 setRuntime)
95
100
  const scope = getRunScope();
101
+ const unconfigured = createUnconfiguredFileEffects();
102
+ const unconfiguredMemory = createUnconfiguredMemoryEffects();
96
103
  if (scope?.toolRuntime) {
97
104
  return {
98
105
  sessionId: scope.toolRuntime.sessionId,
99
106
  agentId: scope.toolRuntime.agentId,
107
+ runId: scope.runId,
100
108
  messages: scope.toolRuntime.messages,
101
109
  cwd: scope.toolRuntime.cwd ?? this.cwd,
102
110
  attachmentRoots: scope.toolRuntime.attachmentRoots,
111
+ fileEffects: scope.toolRuntime.fileEffects ?? unconfigured,
112
+ memoryEffects: scope.toolRuntime.memoryEffects ?? unconfiguredMemory,
113
+ pathRoots: scope.toolRuntime.pathRoots,
114
+ undoRoots: scope.toolRuntime.undoRoots,
115
+ networkPolicy: scope.toolRuntime.networkPolicy,
116
+ requireCredentialBindings: scope.toolRuntime.requireCredentialBindings,
117
+ requireJail: scope.toolRuntime.requireJail,
118
+ homeWrite: scope.toolRuntime.homeWrite,
119
+ noteSecurityDegraded: scope.toolRuntime.noteSecurityDegraded,
120
+ pathContainment: scope.toolRuntime.pathContainment,
121
+ confirmEffect: scope.toolRuntime.confirmEffect,
122
+ effectChannel: scope.toolRuntime.effectChannel,
123
+ processLimits: scope.toolRuntime.processLimits,
124
+ shellEscape: scope.toolRuntime.shellEscape,
125
+ shellJournal: scope.toolRuntime.shellJournal,
126
+ shellJournalLimit: scope.toolRuntime.shellJournalLimit,
103
127
  };
104
128
  }
105
129
  if (scope) {
106
130
  return {
107
131
  sessionId: scope.sessionId,
108
132
  agentId: scope.agentId,
133
+ runId: scope.runId,
109
134
  messages: this.messages,
110
135
  cwd: this.cwd,
136
+ fileEffects: unconfigured,
137
+ memoryEffects: unconfiguredMemory,
111
138
  };
112
139
  }
113
- return { sessionId: this.sessionId, agentId: this.agentId, messages: this.messages, cwd: this.cwd };
140
+ return {
141
+ sessionId: this.sessionId,
142
+ agentId: this.agentId,
143
+ messages: this.messages,
144
+ cwd: this.cwd,
145
+ fileEffects: unconfigured,
146
+ memoryEffects: unconfiguredMemory,
147
+ };
114
148
  }
115
149
  }
150
+ /**
151
+ * 发给 LLM 的 JSON Schema 净化 + purpose 统一装配见 tool-purpose.ts(arch/tool-call-purpose.md)。
152
+ * 此处仅保留兼容别名。
153
+ */
154
+ const sanitizeLlmJsonSchema = sanitizeToolJsonSchema;
116
155
  /**
117
156
  * 将 RegisteredTool 转换为 AgentTool(新循环格式)
157
+ *
158
+ * purpose schema 必须经 buildToolLlmParameters 统一装配,
159
+ * 与 gateway 热更新路径(registeredToolToAgentTool)同构。
118
160
  */
119
161
  function convertToAgentTool(tool, contextProvider) {
120
162
  return {
121
163
  name: tool.definition.name,
122
164
  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
- },
165
+ executionMode: tool.executionMode,
166
+ parameters: buildToolLlmParameters(tool.definition.parameters),
133
167
  execute: async (toolCallId, args, signal) => {
134
168
  const startTime = Date.now();
135
169
  try {
136
170
  const context = contextProvider.get();
137
- const result = await tool.handler(args, { ...context, abortSignal: signal });
171
+ const rawArgs = (args ?? {});
172
+ // schema 已 required purpose;模型漏填时推导,不中断调用
173
+ const purpose = resolveToolCallPurpose(tool.definition.name, rawArgs);
174
+ // 注入型 purpose 只为人读/审批;工具自带 purpose 是真实入参,必须进 handler
175
+ const handlerArgs = prepareHandlerArgs(rawArgs, tool.definition);
176
+ const { runWithToolLimits, resolveToolTimeoutMs } = await import('../extension/execution-environment/resource-limits.js');
177
+ const processLimitsEnabled = context.processLimits !== false;
178
+ const result = await runWithToolLimits((sig) => tool.handler(handlerArgs, { ...context, abortSignal: sig }), {
179
+ timeoutMs: processLimitsEnabled
180
+ ? resolveToolTimeoutMs(tool.definition)
181
+ : undefined,
182
+ abortSignal: signal,
183
+ toolName: tool.definition.name,
184
+ });
138
185
  return {
139
186
  toolCallId,
140
187
  name: tool.definition.name,
141
188
  content: result,
189
+ purpose,
142
190
  durationMs: Date.now() - startTime,
143
191
  };
144
192
  }
@@ -148,6 +196,9 @@ function convertToAgentTool(tool, contextProvider) {
148
196
  name: tool.definition.name,
149
197
  content: `Error: ${error instanceof Error ? error.message : String(error)}`,
150
198
  isError: true,
199
+ purpose: typeof args?.purpose === 'string'
200
+ ? String(args.purpose)
201
+ : '',
151
202
  durationMs: Date.now() - startTime,
152
203
  };
153
204
  }
@@ -297,6 +348,8 @@ export class AgentBuilder {
297
348
  _runGuard;
298
349
  _runGuardConfig;
299
350
  _checkpointInterval;
351
+ /** 模型调用 watchdog 超时(undefined = 引擎默认) */
352
+ _modelCallTimeouts;
300
353
  _reliabilityConfig;
301
354
  // Harness 组件
302
355
  _personaWorkspaces = [];
@@ -344,6 +397,8 @@ export class AgentBuilder {
344
397
  _observerHub;
345
398
  /** 工具效应隔离(I5);Runner 解析 toolRuntime.cwd */
346
399
  _toolIsolation;
400
+ _effectPolicy;
401
+ _confirmEffect;
347
402
  // MCP 配置
348
403
  _mcpConfigs = [];
349
404
  /** MCP client 工厂(Integration 适配器由宿主注入) */
@@ -382,15 +437,28 @@ export class AgentBuilder {
382
437
  }
383
438
  return this;
384
439
  }
385
- /** 注册工具 */
440
+ /** 注册工具(同名默认拒绝;单工具失败不中断其余注册) */
386
441
  tool(tool) {
387
442
  this._toolBus.register(tool);
388
443
  return this;
389
444
  }
390
- /** 批量注册工具 */
445
+ /**
446
+ * 覆盖注册(显式)。用于热更新/替换同名工具,不可默默发生。
447
+ */
448
+ toolReplace(tool) {
449
+ this._toolBus.register(tool, { replace: true });
450
+ return this;
451
+ }
452
+ /** 批量注册:逐个 try/catch,避免一个工具失败拖垮整表 */
391
453
  tools(...tools) {
392
- for (const t of tools)
393
- this.tool(t);
454
+ for (const t of tools) {
455
+ try {
456
+ this.tool(t);
457
+ }
458
+ catch (err) {
459
+ console.warn(`[AgentBuilder] tool register failed (${t.definition.name}): ${err instanceof Error ? err.message : String(err)}`);
460
+ }
461
+ }
394
462
  return this;
395
463
  }
396
464
  _contextProvider = new RuntimeToolContextProvider();
@@ -489,7 +557,8 @@ export class AgentBuilder {
489
557
  }
490
558
  /** 注入 MemoryStore(每轮按 query 召回进 system prompt) */
491
559
  memoryStore(store) {
492
- this._memoryStore = store;
560
+ // L3:写口记 turn journal(RunScope ALS);turn 外(steward)无 journal 则直写
561
+ this._memoryStore = new JournaledMemoryStore(store, () => getRunScope()?.toolRuntime?.memoryEffects);
493
562
  return this;
494
563
  }
495
564
  /** 注入补录覆盖表(默认:SqliteMemoryStore→agent.db,否则内存) */
@@ -684,6 +753,11 @@ export class AgentBuilder {
684
753
  this._checkpointInterval = checkpointInterval;
685
754
  return this;
686
755
  }
756
+ /** 设置模型调用 watchdog 超时(流式 idle + 绝对上限;缺省用引擎默认) */
757
+ modelCallTimeouts(timeouts) {
758
+ this._modelCallTimeouts = timeouts;
759
+ return this;
760
+ }
687
761
  persona(...workspaces) {
688
762
  this._personaWorkspaces.push(...workspaces);
689
763
  return this;
@@ -714,9 +788,9 @@ export class AgentBuilder {
714
788
  this._store = store;
715
789
  return this;
716
790
  }
717
- /** 设置 Runner 配置 */
791
+ /** 设置 Runner 配置(浅合并,便于多次补充字段) */
718
792
  runnerConfig(config) {
719
- this._runnerConfig = config;
793
+ this._runnerConfig = { ...this._runnerConfig, ...config };
720
794
  if (config.observerHub) {
721
795
  this._observerHub = config.observerHub;
722
796
  }
@@ -732,6 +806,16 @@ export class AgentBuilder {
732
806
  *
733
807
  * @param mode - `none` | `session-subdir` | `session-lock`
734
808
  */
809
+ /** P3:注入 ToolEffectPolicy */
810
+ effectPolicy(config) {
811
+ this._effectPolicy = config;
812
+ return this;
813
+ }
814
+ /** P4:宿主 confirmEffect(host-gate) */
815
+ confirmEffect(fn) {
816
+ this._confirmEffect = fn;
817
+ return this;
818
+ }
735
819
  toolIsolation(mode) {
736
820
  this._toolIsolation = mode;
737
821
  return this;
@@ -771,6 +855,22 @@ export class AgentBuilder {
771
855
  this._toolBus.register(t);
772
856
  }
773
857
  }
858
+ // 会话日程:与 task_* 同构;进程内共用实例时经 runnerConfig 注入
859
+ let sessionScheduleService = this._runnerConfig?.sessionScheduleService;
860
+ if (!sessionScheduleService) {
861
+ sessionScheduleService = new SessionScheduleService({ events });
862
+ // 默认实例必须 open,否则 runner 注入 list() 会抛 not opened
863
+ await sessionScheduleService.open();
864
+ }
865
+ this._runnerConfig = {
866
+ ...this._runnerConfig,
867
+ sessionScheduleService,
868
+ };
869
+ if (!this._toolBus.getTool('schedule_set')) {
870
+ for (const t of createSessionScheduleTools(sessionScheduleService)) {
871
+ this._toolBus.register(t);
872
+ }
873
+ }
774
874
  // memory 工具必须在 buildCore 之前注册:Agent 构造时从 ToolBus 快照 tools
775
875
  if (this._memoryStore && !this._toolBus.getTool('memory_store')) {
776
876
  const { createMemoryTools } = await import('../extension/plugin-ecosystem/tools/memory.js');
@@ -856,12 +956,16 @@ export class AgentBuilder {
856
956
  const runner = new SessionAwareRunner(agent, harness, store, {
857
957
  ...this._runnerConfig,
858
958
  toolIsolation: this._toolIsolation ?? this._runnerConfig?.toolIsolation,
959
+ effectPolicy: this._effectPolicy ?? this._runnerConfig?.effectPolicy,
960
+ confirmEffect: this._confirmEffect ?? this._runnerConfig?.confirmEffect,
859
961
  agentWorkspace: this._workspace?.trim() ? this._workspace : this._runnerConfig?.agentWorkspace,
860
962
  sessionLease: this._runnerConfig?.sessionLease,
861
963
  sessionAcl: this._runnerConfig?.sessionAcl,
862
964
  agentMaxSessionRights: this._runnerConfig?.agentMaxSessionRights,
965
+ agentToolPolicy: this._runnerConfig?.agentToolPolicy,
863
966
  observerHub: this._observerHub ?? this._runnerConfig?.observerHub,
864
967
  sessionTaskService,
968
+ sessionScheduleService,
865
969
  events,
866
970
  eventSink: this._telemetry?.onEvent
867
971
  ? (event, ctx) => this._telemetry?.onEvent?.(event, ctx)
@@ -893,6 +997,7 @@ export class AgentBuilder {
893
997
  cognitionStore,
894
998
  systemBudgetRatio: assemblerCfg?.systemBudgetRatio,
895
999
  systemBudgetTokens: assemblerCfg?.systemBudgetTokens,
1000
+ snapshotBudgetTokens: assemblerCfg?.snapshotBudgetTokens,
896
1001
  constitution: constitutionCfg,
897
1002
  assemblerConfig: {
898
1003
  layerShares: assemblerCfg?.layerShares,
@@ -964,8 +1069,10 @@ export class AgentBuilder {
964
1069
  errorStrategy: this._errorStrategy ?? new DefaultErrorStrategy(),
965
1070
  mainTools: this._toolBus,
966
1071
  modelLevels: this._modelLevels,
1072
+ providers: this._namedProviders.size > 0 ? this._namedProviders : undefined,
967
1073
  },
968
1074
  auditDir: this._subsystemAuditDir,
1075
+ agentId: this._agentId,
969
1076
  });
970
1077
  const registeredIds = new Set();
971
1078
  const tryRegister = (spec) => {
@@ -993,7 +1100,11 @@ export class AgentBuilder {
993
1100
  tryRegister(spec);
994
1101
  }
995
1102
  }
996
- // 依赖注入:memoryStore / wisdomStore / conceptGraphStore / sessionStore / constitution / backfillCoverage
1103
+ // 依赖注入:modelProvider / memoryStore / wisdomStore / conceptGraphStore / sessionStore / constitution / backfillCoverage
1104
+ // modelProvider = 主 provider 实例(legacy runtimeInject.requires;新代码用 llmPort)
1105
+ if (this._model) {
1106
+ subsystemRuntime.registerDependency('modelProvider', this._model);
1107
+ }
997
1108
  if (this._memoryStore) {
998
1109
  subsystemRuntime.registerDependency('memoryStore', this._memoryStore);
999
1110
  }
@@ -1089,6 +1200,15 @@ export class AgentBuilder {
1089
1200
  const personaLoadedForHealth = Boolean((this._systemPrompt ?? '').trim() ||
1090
1201
  (this._initialPersonaContent ?? '').trim() ||
1091
1202
  this._personaResolver);
1203
+ // 后置注册工具:走 convertToAgentTool + Agent.registerTool(自带 security 名单同步)
1204
+ const registerTools = (tools) => {
1205
+ for (const t of tools) {
1206
+ if (this._toolBus.getTool(t.definition.name))
1207
+ continue;
1208
+ this._toolBus.register(t);
1209
+ agent.registerTool(convertToAgentTool(t, this._contextProvider));
1210
+ }
1211
+ };
1092
1212
  return {
1093
1213
  agent,
1094
1214
  harness,
@@ -1096,6 +1216,8 @@ export class AgentBuilder {
1096
1216
  mcpManager,
1097
1217
  runtime: subsystemRuntime,
1098
1218
  events,
1219
+ store,
1220
+ registerTools,
1099
1221
  contextEngine,
1100
1222
  contextHealth: async (agentId) => {
1101
1223
  const { probeContextLayerHealth } = await import('../context/layer-health.js');
@@ -1156,7 +1278,7 @@ export class AgentBuilder {
1156
1278
  this._initialPersonaContent = await this._personaResolver();
1157
1279
  systemPrompt = this._initialPersonaContent;
1158
1280
  }
1159
- if (!systemPrompt && this._toolBus.listForAgent('default').length > 0) {
1281
+ if (!systemPrompt && this._toolBus.listForAgent(this._agentId ?? 'default').length > 0) {
1160
1282
  systemPrompt = this.buildDefaultSystemPrompt();
1161
1283
  }
1162
1284
  // Skill:目录 discover(或外部注入的 manager)
@@ -1177,9 +1299,13 @@ export class AgentBuilder {
1177
1299
  this._contextProvider = new RuntimeToolContextProvider({
1178
1300
  cwd: this._workspace?.trim() ? this._workspace : undefined,
1179
1301
  });
1180
- const agentTools = this._toolBus.listForAgent('default').map(t => convertToAgentTool(t, this._contextProvider));
1302
+ const busAgentId = this._agentId ?? 'default';
1303
+ const agentTools = this._toolBus.listForAgent(busAgentId).map(t => convertToAgentTool(t, this._contextProvider));
1304
+ console.log(`[AgentBuilder] agent tools (${agentTools.length}): ${agentTools.map((t) => t.name).join(', ')}`);
1181
1305
  // 创建 Agent
1182
1306
  const agentOptions = {
1307
+ modelCallIdleTimeoutMs: this._modelCallTimeouts?.idleTimeoutMs,
1308
+ modelCallAbsoluteTimeoutMs: this._modelCallTimeouts?.absoluteTimeoutMs,
1183
1309
  model: this._model,
1184
1310
  systemPrompt,
1185
1311
  tools: agentTools,
@@ -1198,8 +1324,11 @@ export class AgentBuilder {
1198
1324
  const summarizeFn = this._summarize ??
1199
1325
  (!this._disableAutoSummarize && this._model
1200
1326
  ? async (messages, opts) => {
1201
- const provider = getResolvedModel()?.provider ?? this._model;
1202
- return createProviderSummarize(provider)(messages, opts);
1327
+ // 与会话同 provider+model:前缀缓存同域。禁止自动切 summary/mini。
1328
+ const snap = getResolvedModel();
1329
+ const provider = snap?.provider ?? this._model;
1330
+ const model = snap?.modelName;
1331
+ return createProviderSummarize(provider, { model })(messages, opts);
1203
1332
  }
1204
1333
  : undefined);
1205
1334
  agent.setConvertToLlm(async (messages) => {
@@ -1213,7 +1342,7 @@ export class AgentBuilder {
1213
1342
  function: {
1214
1343
  name: t.name,
1215
1344
  description: t.description,
1216
- parameters: t.parameters ?? { type: 'object', properties: {} },
1345
+ parameters: sanitizeLlmJsonSchema(t.parameters ?? { type: 'object', properties: {} }),
1217
1346
  },
1218
1347
  }));
1219
1348
  // 方案 B:只读 snapshot.contextWindow;未知则 undefined(跳过自动压缩)
@@ -1292,24 +1421,9 @@ export class AgentBuilder {
1292
1421
  estimatedTokens: result.estimatedTokens,
1293
1422
  contextWindow,
1294
1423
  };
1295
- // droppedSummary:并入已有 system,避免连续两条 system(严格网关)
1296
- const llmMessages = [...result.messages];
1297
- if (result.droppedSummary) {
1298
- const note = `[Context compacted] ${result.droppedSummary}`;
1299
- const sysIdx = llmMessages.findIndex((m) => m.role === 'system');
1300
- if (sysIdx >= 0) {
1301
- const sys = llmMessages[sysIdx];
1302
- const prev = typeof sys.content === 'string' ? sys.content : '';
1303
- llmMessages[sysIdx] = {
1304
- ...sys,
1305
- content: prev ? `${prev}\n\n${note}` : note,
1306
- };
1307
- }
1308
- else {
1309
- llmMessages.unshift({ role: 'system', content: note });
1310
- }
1311
- }
1312
- return llmMessages;
1424
+ // droppedSummary 不得进 system(动态注记打穿前缀缓存)。
1425
+ // 本轮直接不投递;压缩语义由消息侧 contextSummary 承载。
1426
+ return result.messages;
1313
1427
  });
1314
1428
  agent.setOnAfterTurn(async (usage, turn) => {
1315
1429
  const scope = getRunScope();
@@ -1339,7 +1453,7 @@ export class AgentBuilder {
1339
1453
  }
1340
1454
  // 未注册工具硬边界:灌入工具面快照(空集 = 不校验,必须在 build 时接线)
1341
1455
  if (security.setRegisteredTools) {
1342
- security.setRegisteredTools(new Set(this._toolBus.listForAgent('default').map((t) => t.definition.name)));
1456
+ security.setRegisteredTools(new Set(this._toolBus.listForAgent(this._agentId ?? 'default').map((t) => t.definition.name)));
1343
1457
  }
1344
1458
  const errorStrategy = this._errorStrategy ?? new DefaultErrorStrategy();
1345
1459
  // 自动创建 RunGuard(如果通过 config 配置但未手动传入实例)
@@ -1409,15 +1523,17 @@ export class AgentBuilder {
1409
1523
  * 生成默认 systemPrompt,包含可用工具说明
1410
1524
  */
1411
1525
  buildDefaultSystemPrompt() {
1412
- const toolList = this._toolBus.listForAgent('default')
1526
+ const toolList = this._toolBus.listForAgent(this._agentId ?? 'default')
1413
1527
  .map(t => `- ${t.definition.name}: ${t.definition.description}`)
1414
1528
  .join('\n');
1415
1529
  return `You are a helpful AI assistant with access to the following tools:
1416
1530
 
1417
1531
  ${toolList}
1418
1532
 
1533
+ Every tool call must include a short honest purpose field (verb + object + goal, e.g. "read package.json to find test script") — humans and approvers see it as the call title.
1534
+
1419
1535
  Tool selection (strict):
1420
- 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).
1536
+ 1. Prefer a dedicated tool when one covers the job (file_read / file_list / file_write / file_edit / file_delete / file_mkdir / file_rename / file_copy / file_stat / file_rmdir / file_search / env_info, and any task-specific tool).
1421
1537
  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.
1422
1538
  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.
1423
1539
  4. Do not prefer shell over a working dedicated tool for the same job.
@@ -1426,26 +1542,36 @@ Examples:
1426
1542
  - Read a file → file_read first (shell cat only if file_read is unavailable or still fails after a correct retry)
1427
1543
  - List directory → file_list first
1428
1544
  - Write/edit a file → file_write / file_edit first
1545
+ - Delete a file → file_delete first (not shell rm)
1546
+ - Create a folder → file_mkdir first
1547
+ - Rename/move → file_rename first
1548
+ - Copy a file → file_copy first
1549
+ - File info → file_stat first
1550
+ - Remove empty folder → file_rmdir first
1429
1551
  - Search file contents → file_search first
1430
1552
  - Operation with no dedicated tool → shell is acceptable`;
1431
1553
  }
1432
1554
  }
1433
1555
  export async function createAgent(config) {
1434
- const builder = new AgentBuilder()
1435
- .model(config.model);
1436
- if (config.persona)
1437
- builder.persona(config.persona);
1438
- if (config.tools)
1439
- builder.tools(...config.tools);
1556
+ const builder = new AgentBuilder();
1440
1557
  if (config.store)
1441
1558
  builder.store(config.store);
1442
- if (config.budget)
1443
- builder.budget(config.budget);
1444
1559
  if (config.mcpClientFactory)
1445
1560
  builder.mcpClientFactory(config.mcpClientFactory);
1446
1561
  if (config.mcp) {
1447
1562
  for (const mcpConfig of config.mcp)
1448
1563
  builder.mcp(mcpConfig);
1449
1564
  }
1565
+ if (config.tools)
1566
+ builder.tools(...config.tools);
1567
+ // 标准组装与 Gateway / config-bridge 同源;嵌入路径未给 levelMap/contextEngine 时走 wire 缺省
1568
+ const { wireAgentBuilder } = await import('./wire-agent-builder.js');
1569
+ await wireAgentBuilder(builder, {
1570
+ model: config.model,
1571
+ agentId: 'default',
1572
+ persona: config.persona,
1573
+ providers: new Map([['default', config.model]]),
1574
+ budgetConfig: config.budget,
1575
+ });
1450
1576
  return builder.build();
1451
1577
  }
@@ -13,20 +13,28 @@
13
13
  * // agents.get('assistant') → { engine, runner }
14
14
  * ```
15
15
  */
16
- import type { HarnessConfig, AgentConfig, ContextEngineConfig, NormalizedHarnessConfig } from '../../config.js';
16
+ import type { AgentConfig, NormalizedHarnessConfig } from '../../config.js';
17
17
  import type { SubsystemSpec } from '../collaboration/autonomous-subsystem/types.js';
18
18
  import type { ModelProvider } from '@octopi-agent/core/interfaces/model-provider.js';
19
19
  import type { SessionAwareRunner } from '../run/runner.js';
20
- import type { SecurityGuardConfig } from '@octopi-agent/core/security-guard.js';
21
- import type { RunGuardJsonConfig } from '../../config.js';
22
- import { DefaultRunGuard } from '../run/run-guard/default-run-guard.js';
23
- import type { ContextEngine } from '../context/types.js';
24
20
  import type { Agent } from '../run/agent/index.js';
25
21
  export interface BuiltAgent {
26
22
  agent: Agent;
27
23
  runner: SessionAwareRunner;
28
24
  agentConfig: AgentConfig;
29
25
  runtime?: import('../collaboration/autonomous-subsystem/runtime.js').SubsystemRuntime;
26
+ /**
27
+ * 该 Agent 的事件总线。
28
+ *
29
+ * 跨 agent 的 notify(`arch/delegation.md` §7.1)必须落在**同一条**总线上,
30
+ * 否则 `AgentSignalSource` 收不到;跨 agent 场景请用 `buildFromConfig` 的
31
+ * `options.events` 提供共享总线,或自行 `builder.events(bus)` 注入。
32
+ */
33
+ events: import('@octopi-agent/core/primitives/event-bus.js').EventBus;
34
+ /** SessionStore(委派子 Run 预创建 child session 用;`arch/delegation.md` D7) */
35
+ store: import('@octopi-agent/core/interfaces/session-store.js').SessionStore<import('../session/types.js').SessionData>;
36
+ /** 后置注册工具(`delegate_*` 等运行期才可构造的工具) */
37
+ registerTools: (tools: import('@octopi-agent/core/types.js').RegisteredTool[]) => void;
30
38
  }
31
39
  /**
32
40
  * 从配置中创建所有 Provider 实例
@@ -34,25 +42,6 @@ export interface BuiltAgent {
34
42
  * 返回 provider name → ModelProvider 的映射。
35
43
  */
36
44
  export declare function resolveProviders(config: NormalizedHarnessConfig): Promise<Map<string, ModelProvider>>;
37
- /**
38
- * 从配置中解析安全策略(始终返回;无总开关)
39
- *
40
- * 硬边界与 ToolCallRiskPolicy 由 Guard/Builder 保证接线,
41
- * 这里只归一化处置、范围与灵敏度。
42
- */
43
- export declare function resolveSecurityConfig(config: HarnessConfig): SecurityGuardConfig;
44
- /**
45
- * 从配置中创建 ContextEngine 实例
46
- */
47
- export declare function resolveContextEngine(config: ContextEngineConfig | undefined): ContextEngine;
48
- /**
49
- * 从配置中解析 RunGuard
50
- *
51
- * 解析 llmModel 字段:
52
- * - "model" → 使用主 provider
53
- * - "provider/model" → 使用指定 provider
54
- */
55
- export declare function resolveRunGuard(config: RunGuardJsonConfig | undefined, providers: Map<string, ModelProvider>): DefaultRunGuard | undefined;
56
45
  /**
57
46
  * 按架构文档 4.9 的三级搜索路径加载子系统
58
47
  *
@@ -71,10 +60,29 @@ export declare function resolveSubsystemSpecs(projectRoot?: string): Promise<Sub
71
60
  * @param config - 完整配置
72
61
  * @returns agent id → BuiltAgent 的映射
73
62
  */
74
- export declare function buildFromConfig(config: NormalizedHarnessConfig): Promise<Map<string, BuiltAgent>>;
63
+ export declare function buildFromConfig(config: NormalizedHarnessConfig, options?: BuildFromConfigOptions): Promise<Map<string, BuiltAgent>>;
75
64
  /**
76
65
  * 快捷函数:从配置文件路径构建
77
66
  *
78
67
  * @remarks 文件 IO / `loadConfig` 属于套件侧(arch/npm-package-split.md §10.3)。
79
68
  * 根包 `octopi` 提供 `buildFromConfigFile`;库嵌入请用 {@link buildFromConfig}。
80
69
  */
70
+ /**
71
+ * `buildFromConfig` 可选项
72
+ *
73
+ * @remarks 定义置于文件尾亦生效(TS interface 提升);保持单点定义。
74
+ */
75
+ export interface BuildFromConfigOptions {
76
+ /**
77
+ * 跨 agent **共享**的事件总线。
78
+ *
79
+ * 委派 notify(`arch/delegation.md` §7.1)必须落在 `AgentSignalSource`
80
+ * 所监听的同一条总线上;多 agent 场景请传入共享总线。
81
+ * 缺省 = 各用自己 builder 建的总线,此时 **notify 不接线**(poll 通道仍可用)。
82
+ */
83
+ events?: import('@octopi-agent/core/primitives/event-bus.js').EventBus;
84
+ /**
85
+ * 委派编排开关。缺省 = 只要有 agent 声明 `delegation` 策略就接线。
86
+ */
87
+ delegation?: boolean;
88
+ }