@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
@@ -0,0 +1,110 @@
1
+ /**
2
+ * DefaultAgentRegistry — Agent 注册与发现的默认实现
3
+ *
4
+ * @layer harness/collaboration/delegation
5
+ * 实现本域 `registry-types.ts` 的 `AgentRegistry`(`arch/delegation.md` §12.1 重写)。
6
+ *
7
+ * 设计原则(沿用旧实现并修正):
8
+ * - 不依赖外部存储(v1 内存;跨进程 Registry 归 L3/L4)
9
+ * - 事件驱动:所有变更经 EventBus 通知
10
+ * - 同步操作,适合单进程场景
11
+ * - **委派策略一等**:`query` 支持 `callableOnly` / `callableBy`(§9.2)
12
+ *
13
+ * 与旧 `multi-agent/registry.ts` 的差异:
14
+ * - 新增 `AgentInfo.delegation` 策略字段
15
+ * - `query` 增 `callableOnly` / `callableBy` 过滤
16
+ * - 契约与实现同域(旧版分居两文件)
17
+ */
18
+ import type { EventBus } from '@octopi-agent/core/primitives/event-bus.js';
19
+ import type { AgentInfo, AgentQuery, AgentRegistry, AgentRelation, AgentRelationType } from './registry-types.js';
20
+ /**
21
+ * DefaultAgentRegistry
22
+ *
23
+ * 基于内存的 Agent 注册表实现。
24
+ */
25
+ export declare class DefaultAgentRegistry implements AgentRegistry {
26
+ private readonly events?;
27
+ private readonly agents;
28
+ private relations;
29
+ /**
30
+ * @param events - 可选 EventBus;提供时发射 `registry.*` 事件
31
+ */
32
+ constructor(events?: EventBus | undefined);
33
+ /**
34
+ * 注册 Agent
35
+ *
36
+ * @param info - Agent 信息(不含时间戳,服务端补)
37
+ */
38
+ register(info: Omit<AgentInfo, 'registeredAt' | 'lastActiveAt'>): void;
39
+ /**
40
+ * 注销 Agent(同时清理其关系)
41
+ *
42
+ * @param agentId - Agent ID
43
+ * @returns 是否成功注销
44
+ */
45
+ unregister(agentId: string): boolean;
46
+ /**
47
+ * 获取 Agent 信息
48
+ *
49
+ * @param agentId - Agent ID
50
+ * @returns Agent 信息;不存在返回 undefined
51
+ */
52
+ get(agentId: string): AgentInfo | undefined;
53
+ /**
54
+ * 查询 Agent
55
+ *
56
+ * @param query - 查询条件(traits 为 **任一**命中)
57
+ * @returns 匹配的 Agent 列表
58
+ */
59
+ query(query: AgentQuery): AgentInfo[];
60
+ /**
61
+ * 列出所有已注册 Agent
62
+ *
63
+ * @returns Agent 列表
64
+ */
65
+ list(): AgentInfo[];
66
+ /**
67
+ * 查找具有特定特质的 Agent
68
+ *
69
+ * @param trait - 特质标签
70
+ * @returns 具备该特质的 Agent 列表
71
+ */
72
+ findByTrait(trait: string): AgentInfo[];
73
+ /**
74
+ * 更新 Agent 状态
75
+ *
76
+ * @param agentId - Agent ID
77
+ * @param status - 新状态
78
+ */
79
+ updateStatus(agentId: string, status: AgentInfo['status']): void;
80
+ /**
81
+ * 更新 Agent 活跃时间
82
+ *
83
+ * @param agentId - Agent ID
84
+ */
85
+ touch(agentId: string): void;
86
+ /**
87
+ * 添加 Agent 间关系(同 from/to/type 去重)
88
+ *
89
+ * @param relation - 关系描述
90
+ */
91
+ addRelation(relation: AgentRelation): void;
92
+ /**
93
+ * 移除 Agent 间关系
94
+ *
95
+ * @param from - 来源 Agent ID
96
+ * @param to - 目标 Agent ID
97
+ * @param type - 关系类型(不传则移除两者的全部关系)
98
+ */
99
+ removeRelation(from: string, to: string, type?: AgentRelationType): void;
100
+ /**
101
+ * 获取 Agent 的所有关系
102
+ *
103
+ * @param agentId - Agent ID
104
+ * @returns 关系列表(含 from 与 to 两侧)
105
+ */
106
+ getRelations(agentId: string): AgentRelation[];
107
+ /** callableBy 白名单校验(缺省 = 任意) */
108
+ private isCallableBy;
109
+ private emit;
110
+ }
@@ -0,0 +1,220 @@
1
+ /**
2
+ * DefaultAgentRegistry — Agent 注册与发现的默认实现
3
+ *
4
+ * @layer harness/collaboration/delegation
5
+ * 实现本域 `registry-types.ts` 的 `AgentRegistry`(`arch/delegation.md` §12.1 重写)。
6
+ *
7
+ * 设计原则(沿用旧实现并修正):
8
+ * - 不依赖外部存储(v1 内存;跨进程 Registry 归 L3/L4)
9
+ * - 事件驱动:所有变更经 EventBus 通知
10
+ * - 同步操作,适合单进程场景
11
+ * - **委派策略一等**:`query` 支持 `callableOnly` / `callableBy`(§9.2)
12
+ *
13
+ * 与旧 `multi-agent/registry.ts` 的差异:
14
+ * - 新增 `AgentInfo.delegation` 策略字段
15
+ * - `query` 增 `callableOnly` / `callableBy` 过滤
16
+ * - 契约与实现同域(旧版分居两文件)
17
+ */
18
+ import { AgentRegistryEvents, effectiveDelegationPolicy } from './registry-types.js';
19
+ /**
20
+ * DefaultAgentRegistry
21
+ *
22
+ * 基于内存的 Agent 注册表实现。
23
+ */
24
+ export class DefaultAgentRegistry {
25
+ events;
26
+ agents = new Map();
27
+ relations = [];
28
+ /**
29
+ * @param events - 可选 EventBus;提供时发射 `registry.*` 事件
30
+ */
31
+ constructor(events) {
32
+ this.events = events;
33
+ }
34
+ // ── 注册 / 注销 ──
35
+ /**
36
+ * 注册 Agent
37
+ *
38
+ * @param info - Agent 信息(不含时间戳,服务端补)
39
+ */
40
+ register(info) {
41
+ const timestamp = Date.now();
42
+ const record = {
43
+ ...info,
44
+ traits: [...info.traits],
45
+ // 归一化为生效策略(缺省默认具备委派能力,arch/delegation.md §9.2);
46
+ // 此后所有消费方读到的都是完整策略,无需各自兜底。
47
+ delegation: effectiveDelegationPolicy(info.delegation),
48
+ registeredAt: timestamp,
49
+ lastActiveAt: timestamp,
50
+ };
51
+ this.agents.set(record.id, record);
52
+ this.emit(AgentRegistryEvents.AGENT_REGISTERED, {
53
+ agentId: record.id,
54
+ name: record.name,
55
+ traits: record.traits,
56
+ });
57
+ }
58
+ /**
59
+ * 注销 Agent(同时清理其关系)
60
+ *
61
+ * @param agentId - Agent ID
62
+ * @returns 是否成功注销
63
+ */
64
+ unregister(agentId) {
65
+ const existed = this.agents.delete(agentId);
66
+ if (existed) {
67
+ this.relations = this.relations.filter((r) => r.from !== agentId && r.to !== agentId);
68
+ this.emit(AgentRegistryEvents.AGENT_UNREGISTERED, { agentId });
69
+ }
70
+ return existed;
71
+ }
72
+ // ── 查询 ──
73
+ /**
74
+ * 获取 Agent 信息
75
+ *
76
+ * @param agentId - Agent ID
77
+ * @returns Agent 信息;不存在返回 undefined
78
+ */
79
+ get(agentId) {
80
+ return this.agents.get(agentId);
81
+ }
82
+ /**
83
+ * 查询 Agent
84
+ *
85
+ * @param query - 查询条件(traits 为 **任一**命中)
86
+ * @returns 匹配的 Agent 列表
87
+ */
88
+ query(query) {
89
+ let results = Array.from(this.agents.values());
90
+ if (query.traits && query.traits.length > 0) {
91
+ results = results.filter((agent) => query.traits.some((t) => agent.traits.includes(t)));
92
+ }
93
+ if (query.status) {
94
+ results = results.filter((agent) => agent.status === query.status);
95
+ }
96
+ if (query.metadata) {
97
+ results = results.filter((agent) => {
98
+ if (!agent.metadata)
99
+ return false;
100
+ return Object.entries(query.metadata).every(([key, value]) => agent.metadata[key] === value);
101
+ });
102
+ }
103
+ if (query.callableOnly) {
104
+ results = results.filter((agent) => effectiveDelegationPolicy(agent.delegation).callable);
105
+ }
106
+ if (query.callableBy !== undefined) {
107
+ results = results.filter((agent) => this.isCallableBy(agent, query.callableBy));
108
+ }
109
+ return results;
110
+ }
111
+ /**
112
+ * 列出所有已注册 Agent
113
+ *
114
+ * @returns Agent 列表
115
+ */
116
+ list() {
117
+ return Array.from(this.agents.values());
118
+ }
119
+ /**
120
+ * 查找具有特定特质的 Agent
121
+ *
122
+ * @param trait - 特质标签
123
+ * @returns 具备该特质的 Agent 列表
124
+ */
125
+ findByTrait(trait) {
126
+ return Array.from(this.agents.values()).filter((agent) => agent.traits.includes(trait));
127
+ }
128
+ // ── 状态管理 ──
129
+ /**
130
+ * 更新 Agent 状态
131
+ *
132
+ * @param agentId - Agent ID
133
+ * @param status - 新状态
134
+ */
135
+ updateStatus(agentId, status) {
136
+ const agent = this.agents.get(agentId);
137
+ if (!agent)
138
+ return;
139
+ const oldStatus = agent.status;
140
+ agent.status = status;
141
+ agent.lastActiveAt = Date.now();
142
+ if (oldStatus !== status) {
143
+ this.emit(AgentRegistryEvents.AGENT_STATUS_CHANGED, {
144
+ agentId,
145
+ oldStatus,
146
+ newStatus: status,
147
+ });
148
+ }
149
+ }
150
+ /**
151
+ * 更新 Agent 活跃时间
152
+ *
153
+ * @param agentId - Agent ID
154
+ */
155
+ touch(agentId) {
156
+ const agent = this.agents.get(agentId);
157
+ if (agent) {
158
+ agent.lastActiveAt = Date.now();
159
+ }
160
+ }
161
+ // ── 关系管理 ──
162
+ /**
163
+ * 添加 Agent 间关系(同 from/to/type 去重)
164
+ *
165
+ * @param relation - 关系描述
166
+ */
167
+ addRelation(relation) {
168
+ const exists = this.relations.some((r) => r.from === relation.from && r.to === relation.to && r.type === relation.type);
169
+ if (exists)
170
+ return;
171
+ this.relations.push(relation);
172
+ this.emit(AgentRegistryEvents.RELATION_ADDED, {
173
+ from: relation.from,
174
+ to: relation.to,
175
+ type: relation.type,
176
+ });
177
+ }
178
+ /**
179
+ * 移除 Agent 间关系
180
+ *
181
+ * @param from - 来源 Agent ID
182
+ * @param to - 目标 Agent ID
183
+ * @param type - 关系类型(不传则移除两者的全部关系)
184
+ */
185
+ removeRelation(from, to, type) {
186
+ const before = this.relations.length;
187
+ this.relations = this.relations.filter((r) => {
188
+ if (r.from !== from || r.to !== to)
189
+ return true;
190
+ if (type && r.type !== type)
191
+ return true;
192
+ return false;
193
+ });
194
+ if (this.relations.length < before) {
195
+ this.emit(AgentRegistryEvents.RELATION_REMOVED, { from, to, type });
196
+ }
197
+ }
198
+ /**
199
+ * 获取 Agent 的所有关系
200
+ *
201
+ * @param agentId - Agent ID
202
+ * @returns 关系列表(含 from 与 to 两侧)
203
+ */
204
+ getRelations(agentId) {
205
+ return this.relations.filter((r) => r.from === agentId || r.to === agentId);
206
+ }
207
+ // ── 内部 ──
208
+ /** callableBy 白名单校验(缺省 = 任意) */
209
+ isCallableBy(agent, callerAgentId) {
210
+ const allowed = agent.delegation?.callableBy;
211
+ if (!allowed || allowed.length === 0)
212
+ return true;
213
+ return allowed.includes(callerAgentId);
214
+ }
215
+ emit(type, data) {
216
+ if (!this.events)
217
+ return;
218
+ this.events.emit({ type, timestamp: Date.now(), data });
219
+ }
220
+ }
@@ -0,0 +1,249 @@
1
+ /**
2
+ * DelegateService — 委派编排
3
+ *
4
+ * @layer harness/collaboration/delegation
5
+ * 设计权威:`arch/delegation.md` §7 / §8 / §10。
6
+ *
7
+ * 职责:
8
+ * - 建单(`DelegationStore.create`,唯一写入口)
9
+ * - 解析目标(`AgentRegistry`:agentId 优先,capability 兜底,D2)
10
+ * - 递归深度闸(§10.4)
11
+ * - 失控防护 `maxActiveDelegationsPerSession`(§8:**不是并发闸**,并发硬闸只在 SessionGate 一处,D9)
12
+ * - 经 `DelegateTransport` 起子 Run、收结果(D1/D5)
13
+ * - 归集 usage 到父的 run 账(决策 C2)
14
+ * - 终态投递 notify(§7.1,投递由 P3 的 notifier 实现,本层只负责触发)
15
+ *
16
+ * **非阻塞**(§7):`dispatch()` 建单后立即返回 `delegationId`,不等子 Run 结束。
17
+ */
18
+ import type { AgentRegistry } from './registry-types.js';
19
+ import type { Delegation, DelegationParentRef, DelegationTarget } from './types.js';
20
+ import { DelegationEvents } from './types.js';
21
+ import type { DelegationBudget, DelegationContextMode } from './types.js';
22
+ import type { DelegationListFilter, DelegationStore } from './store.js';
23
+ import type { DelegateTransport } from './transport.js';
24
+ /** dispatch 入参 */
25
+ export interface DispatchDelegationInput {
26
+ parent: DelegationParentRef;
27
+ /**
28
+ * 父所在委派链的深度(父未被委派 = 0)。
29
+ * 服务据此算 `depth = parentDepth + 1`,再比对父 agent 的 `maxDepth`(§10.4)。
30
+ */
31
+ parentDepth?: number;
32
+ target: DelegationTarget;
33
+ /**
34
+ * 发起方的**有效** session rights(D3:权限随调用传播)。
35
+ *
36
+ * 服务方把它与目标 agent 的 `delegation.rightsCeiling` 取交集后
37
+ * 写入 `DelegateRequest.rightsCeiling`,使子只能在父的权限内行事。
38
+ * 缺省 = 不叠加父约束(仅用目标自身天花板)。
39
+ */
40
+ parentRights?: import('../../governance/session-acl/types.js').SessionRights;
41
+ task: string;
42
+ input: string;
43
+ context?: DelegationContextMode;
44
+ /** 父消息历史(仅 context='fork' 时携带) */
45
+ parentMessages?: import('@octopi-agent/core/types.js').Message[];
46
+ budget?: DelegationBudget;
47
+ /** 相对超时(毫秒);与 `deadlineAt` 二选一 */
48
+ timeoutMs?: number;
49
+ /** 绝对截止时刻(D4) */
50
+ deadlineAt?: number;
51
+ cancelable?: boolean;
52
+ /** 父亡子亡(决策 C1:默认 false = 子继续跑) */
53
+ cascade?: boolean;
54
+ }
55
+ /** dispatch 结果(非阻塞:不含 output) */
56
+ export interface DispatchResult {
57
+ delegation: Delegation;
58
+ /** 已解析的目标 agentId */
59
+ resolvedAgentId: string;
60
+ }
61
+ /** 服务配置 */
62
+ export interface DelegateServiceConfig {
63
+ /**
64
+ * 单个父 session 可同时挂载的未闭合委派上限(失控防护,§8)。
65
+ *
66
+ * **这不是并发闸**(并发硬闸只在 SessionGate,D9)。
67
+ * 缺省 = {@link DEFAULT_MAX_ACTIVE_DELEGATIONS}(委派默认开启,必须有上限)。
68
+ */
69
+ maxActiveDelegationsPerSession?: number;
70
+ /**
71
+ * notify 投递器(P3 接 `emitAgentSignal`)。
72
+ * 缺省 = 不投递:委派单保持「未送达」,由 §7.3 状态提示与 poll
73
+ * (`get` 取回即 `markSurfaced`)兜底。
74
+ */
75
+ notifier?: DelegationNotifier;
76
+ /**
77
+ * 解析父 session 所在的委派链深度(父未被委派 = 0)。
78
+ *
79
+ * 工具路径下 `DispatchDelegationInput.parentDepth` 不便携带时由服务回调取得,
80
+ * 使 §10.4 的递归深度闸在工具路径同样生效。
81
+ * 缺省 = 0(父视为根 agent)。
82
+ */
83
+ resolveParentDepth?: (sessionId: string) => number | undefined;
84
+ }
85
+ /**
86
+ * notify 投递器(§7.1)
87
+ *
88
+ * @param delegation - 终态委派单
89
+ */
90
+ export type DelegationNotifier = (delegation: Delegation) => Promise<void> | void;
91
+ /** 目标不可达 / 策略拒绝的分类错误 */
92
+ /** 可用委派目标概要(解析失败时回传,供调用方自愈) */
93
+ export interface ResolutionAvailability {
94
+ /** 全部已登记 trait */
95
+ traits: string[];
96
+ /** 全部已登记 agent 概要 */
97
+ agents: Array<{
98
+ id: string;
99
+ traits: string[];
100
+ callable: boolean;
101
+ }>;
102
+ }
103
+ export declare class DelegateResolutionError extends Error {
104
+ readonly reason: 'not_found' | 'not_callable' | 'forbidden' | 'depth_exceeded' | 'too_many_active';
105
+ /** 解析失败时的可用目标(可选;让调用方不必瞎猜) */
106
+ readonly available?: ResolutionAvailability | undefined;
107
+ constructor(message: string, reason: 'not_found' | 'not_callable' | 'forbidden' | 'depth_exceeded' | 'too_many_active',
108
+ /** 解析失败时的可用目标(可选;让调用方不必瞎猜) */
109
+ available?: ResolutionAvailability | undefined);
110
+ }
111
+ /** 缺省失控防护:单父 session 同时挂载的未闭合委派上限 */
112
+ export declare const DEFAULT_MAX_ACTIVE_DELEGATIONS = 8;
113
+ /**
114
+ * 合并预算:请求预算 ∩ agent 上限(取更严的一侧)
115
+ *
116
+ * @param requested - 请求里的预算
117
+ * @param ceiling - agent 声明的预算上限
118
+ * @returns 生效预算
119
+ */
120
+ export declare function intersectBudget(requested: DelegationBudget | undefined, ceiling: DelegationBudget | undefined): DelegationBudget | undefined;
121
+ /**
122
+ * DelegateService — 委派编排
123
+ */
124
+ export declare class DelegateService {
125
+ private readonly store;
126
+ private readonly registry;
127
+ private readonly transport;
128
+ private readonly config;
129
+ private readonly inflight;
130
+ constructor(store: DelegationStore, registry: AgentRegistry, transport: DelegateTransport, config?: DelegateServiceConfig);
131
+ /**
132
+ * 非阻塞派发:建单并起子 Run,立即返回(§7)
133
+ *
134
+ * @param input - 派发入参
135
+ * @returns 委派单(status = queued 或 running)与解析出的目标
136
+ * @throws 目标不可达 / 不可被委派 / 深度超限 / 未闭合委派过多
137
+ */
138
+ dispatch(input: DispatchDelegationInput): Promise<DispatchResult>;
139
+ /**
140
+ * 读取委派单
141
+ *
142
+ * @param delegationId - 委派单 ID
143
+ * @returns 委派单;不存在返回 undefined
144
+ */
145
+ get(delegationId: string): Delegation | undefined;
146
+ /**
147
+ * 列出委派单(poll 通道,§7)
148
+ *
149
+ * @param filter - 过滤条件
150
+ * @returns 匹配的委派单
151
+ */
152
+ list(filter?: DelegationListFilter): Delegation[];
153
+ /**
154
+ * 取消委派(D4)
155
+ *
156
+ * @param delegationId - 委派单 ID
157
+ * @returns 取消后的委派单
158
+ * @throws 委派单不存在,或已终态 / 不可取消
159
+ */
160
+ cancel(delegationId: string, reason?: string): Delegation;
161
+ /**
162
+ * 级联中止:父 session 消亡时中止其所有 `cascade: true` 的在途委派(决策 C1)
163
+ *
164
+ * 默认(`cascade: false`)子 Run **继续跑**,父结束不影响;
165
+ * 只有父显式声明 `cascade: true` 的委派会被中止。
166
+ *
167
+ * 调用时机由宿主决定(Gateway / 嵌入方在父 run 或父 session 终止时调用)。
168
+ *
169
+ * @param parentSessionId - 父 session ID
170
+ * @param reason - 中止原因(写入 error 字段)
171
+ * @returns 被中止的委派单 ID 列表
172
+ */
173
+ abortChildren(parentSessionId: string, reason?: string): string[];
174
+ /**
175
+ * 渲染父 session 的委派状态提示(§7.3,供 `getSteeringMessages` 用)
176
+ *
177
+ * @param parentSessionId - 父 session ID
178
+ * @returns 状态提示文本;无未闭合且无未读终态时返回空串
179
+ */
180
+ renderStatusHint(parentSessionId: string): string;
181
+ /**
182
+ * 解析目标(D2):agentId 优先,capability 兜底
183
+ *
184
+ * @param target - 目标寻址
185
+ * @param callerAgentId - 调用方 agentId(校验 callableBy)
186
+ * @returns 解析出的 AgentHandle
187
+ * @throws 目标不可达 / 不可被委派 / 策略拒绝
188
+ */
189
+ private resolveTarget;
190
+ /**
191
+ * 列出**可用委派目标**(失败时回传,供调用方自愈)
192
+ *
193
+ * @returns 可用 traits 与 agent 概要
194
+ */
195
+ private describeTargets;
196
+ /** 校验委派策略并转 AgentHandle */
197
+ private toHandle;
198
+ /** callableBy 白名单校验(缺省 = 任意) */
199
+ private isCallableBy;
200
+ /** budget.timeoutMs → deadlineAt */
201
+ private deadlineFromBudget;
202
+ /** 起子 Run、收结果、落终态(非阻塞入口) */
203
+ private runChild;
204
+ /**
205
+ * 落成功终态。
206
+ *
207
+ * 若委派单已被 deadline / cancel 抢先落到终态,**不得覆盖**,但必须留痕——
208
+ * 否则子跑完的结果会无声无息消失(审查 P1-2)。
209
+ */
210
+ private settleWithResult;
211
+ /**
212
+ * 落失败终态。
213
+ *
214
+ * 已终态时**保留原 error**(如用户的取消原因),绝不让状态机内部文案
215
+ * 「Invalid delegation transition: …」污染对外可见面(审查 P1-2)。
216
+ */
217
+ private settleWithFailure;
218
+ /**
219
+ * 迟到结果/失败留痕:保留原 error,追加一行说明,并打 warn。
220
+ *
221
+ * @param delegationId - 委派单 ID
222
+ * @param current - 已落入的终态
223
+ * @param lateOutput - 迟到的子产出(若有)
224
+ * @param lateError - 迟到的失败原因(若有)
225
+ */
226
+ private noteLateOutcome;
227
+ /**
228
+ * notify 通道触发点(§7.1)。
229
+ *
230
+ * `deliveryState` 只在**结果真正送达父**时为 `surfaced`:notify 投递成功
231
+ * (投递器自带接收端校验,发进空总线会抛错按失败处理),或父经
232
+ * {@link markSurfaced}(delegate_get)取回。投递期间为 `delivering`
233
+ * (乐观占位,提示保持点亮);投递器缺省 / 失败 / 被丢回滚时 `pending`,
234
+ * 让 §7.3 状态提示兜底——否则通知会无声消失。
235
+ */
236
+ private notify;
237
+ /**
238
+ * 标记委派单结果已送达父(§7.3 状态提示据此消音)。
239
+ *
240
+ * 送达途径之二:父经 `delegate_get` 主动取回终态结果(工具面在返回结果前
241
+ * 调用)。`delegate_list` 是只读概览,不置位——列表结果可能被截断,
242
+ * 只有明确取回单条全文才算送达。途径之一是 notify 投递成功(服务内部置位)。
243
+ *
244
+ * @param delegationId - 委派单 ID
245
+ * @returns 更新后的委派单
246
+ */
247
+ markSurfaced(delegationId: string): Delegation;
248
+ }
249
+ export { DelegationEvents };