@octopi-agent/engine 0.70.7 → 0.90.11

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 (390) 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 +81 -5
  6. package/dist/config-schema/context.d.ts +24 -5
  7. package/dist/config-schema/context.js +28 -1
  8. package/dist/config-schema/engine.d.ts +205 -13
  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 +93 -1
  12. package/dist/config-schema/models.d.ts +3 -3
  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 +13 -0
  18. package/dist/config-schema/shared.js +22 -0
  19. package/dist/config-schema/substrate.d.ts +2 -2
  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 +201 -8
  23. package/dist/config.js +105 -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 +50 -5
  31. package/dist/harness/agent/builder.js +189 -59
  32. package/dist/harness/agent/config-bridge.d.ts +33 -25
  33. package/dist/harness/agent/config-bridge.js +84 -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 +46 -0
  37. package/dist/harness/agent/tool-purpose.js +127 -0
  38. package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
  39. package/dist/harness/agent/wire-agent-builder.js +370 -0
  40. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.d.ts +11 -1
  41. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +11 -1
  42. package/dist/harness/collaboration/autonomous-subsystem/loader.d.ts +13 -0
  43. package/dist/harness/collaboration/autonomous-subsystem/loader.js +16 -1
  44. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +8 -1
  45. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -9
  46. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
  47. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
  48. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
  49. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
  50. package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
  51. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
  52. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
  53. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
  54. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
  55. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
  56. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
  57. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
  58. package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
  59. package/dist/harness/collaboration/delegation/child-run.js +241 -0
  60. package/dist/harness/collaboration/delegation/index.d.ts +26 -0
  61. package/dist/harness/collaboration/delegation/index.js +25 -0
  62. package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
  63. package/dist/harness/collaboration/delegation/notifier.js +84 -0
  64. package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
  65. package/dist/harness/collaboration/delegation/registry-types.js +61 -0
  66. package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
  67. package/dist/harness/collaboration/delegation/registry.js +220 -0
  68. package/dist/harness/collaboration/delegation/service.d.ts +249 -0
  69. package/dist/harness/collaboration/delegation/service.js +499 -0
  70. package/dist/harness/collaboration/delegation/store.d.ts +155 -0
  71. package/dist/harness/collaboration/delegation/store.js +271 -0
  72. package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
  73. package/dist/harness/collaboration/delegation/transport.js +61 -0
  74. package/dist/harness/collaboration/delegation/types.d.ts +231 -0
  75. package/dist/harness/collaboration/delegation/types.js +70 -0
  76. package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
  77. package/dist/harness/collaboration/delegation/wiring.js +145 -0
  78. package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
  79. package/dist/harness/collaboration/orchestration/index.js +11 -11
  80. package/dist/harness/context/assembler.d.ts +2 -2
  81. package/dist/harness/context/assembler.js +12 -7
  82. package/dist/harness/context/capabilities/compact/engine.js +80 -38
  83. package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
  84. package/dist/harness/context/capabilities/summary/registry.js +10 -0
  85. package/dist/harness/context/constitution/default-agents.md +230 -228
  86. package/dist/harness/context/default-context-engine.d.ts +101 -23
  87. package/dist/harness/context/default-context-engine.js +483 -172
  88. package/dist/harness/context/hybrid-compressor.d.ts +3 -3
  89. package/dist/harness/context/hybrid-compressor.js +18 -23
  90. package/dist/harness/context/index.d.ts +5 -1
  91. package/dist/harness/context/index.js +2 -0
  92. package/dist/harness/context/layer-snapshot.d.ts +4 -0
  93. package/dist/harness/context/layer-snapshot.js +30 -18
  94. package/dist/harness/context/layer-types.d.ts +85 -1
  95. package/dist/harness/context/layer-types.js +110 -4
  96. package/dist/harness/context/layers.d.ts +5 -2
  97. package/dist/harness/context/layers.js +11 -5
  98. package/dist/harness/context/llm-summarizer.d.ts +15 -1
  99. package/dist/harness/context/llm-summarizer.js +107 -56
  100. package/dist/harness/context/message-selector.js +6 -2
  101. package/dist/harness/context/root-instructions.d.ts +72 -0
  102. package/dist/harness/context/root-instructions.js +227 -0
  103. package/dist/harness/context/runtime-datetime.d.ts +34 -7
  104. package/dist/harness/context/runtime-datetime.js +66 -10
  105. package/dist/harness/context/smart-router.d.ts +1 -1
  106. package/dist/harness/context/smart-router.js +1 -1
  107. package/dist/harness/context/system-prompt-assembler.d.ts +30 -0
  108. package/dist/harness/context/system-prompt-assembler.js +73 -6
  109. package/dist/harness/context/token-constants.d.ts +2 -2
  110. package/dist/harness/context/token-constants.js +2 -2
  111. package/dist/harness/context/token-estimate-fns.d.ts +1 -3
  112. package/dist/harness/context/token-estimate-fns.js +2 -4
  113. package/dist/harness/context/token-estimator.d.ts +1 -1
  114. package/dist/harness/context/token-estimator.js +14 -6
  115. package/dist/harness/context/tool-result-aging.d.ts +140 -0
  116. package/dist/harness/context/tool-result-aging.js +331 -0
  117. package/dist/harness/context/tool-result-body.d.ts +10 -0
  118. package/dist/harness/context/tool-result-body.js +27 -0
  119. package/dist/harness/context/turn-envelope.d.ts +123 -0
  120. package/dist/harness/context/turn-envelope.js +188 -0
  121. package/dist/harness/context/types.d.ts +35 -47
  122. package/dist/harness/extension/execution-environment/effect-policy.d.ts +258 -0
  123. package/dist/harness/extension/execution-environment/effect-policy.js +358 -0
  124. package/dist/harness/extension/execution-environment/index.d.ts +18 -2
  125. package/dist/harness/extension/execution-environment/index.js +11 -2
  126. package/dist/harness/extension/execution-environment/isolation.js +5 -1
  127. package/dist/harness/extension/execution-environment/memory-undo.d.ts +101 -0
  128. package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
  129. package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
  130. package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
  131. package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
  132. package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
  133. package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
  134. package/dist/harness/extension/execution-environment/sandbox.js +521 -51
  135. package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
  136. package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
  137. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
  138. package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
  139. package/dist/harness/extension/execution-environment/types.d.ts +67 -39
  140. package/dist/harness/extension/execution-environment/types.js +2 -2
  141. package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
  142. package/dist/harness/extension/execution-environment/undo-log.js +627 -0
  143. package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
  144. package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
  145. package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +1 -1
  146. package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +9 -0
  147. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
  148. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
  149. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
  150. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
  151. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
  152. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
  153. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
  154. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
  155. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
  156. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
  157. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
  158. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
  159. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
  160. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
  161. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
  162. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
  163. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
  164. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +51 -0
  165. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +153 -0
  166. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
  167. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
  168. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +277 -81
  169. package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
  170. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
  171. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
  172. package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
  173. package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
  174. package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
  175. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
  176. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
  177. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
  178. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
  179. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +241 -70
  180. package/dist/harness/extension/plugin-ecosystem/tools/git-runner.d.ts +31 -0
  181. package/dist/harness/extension/plugin-ecosystem/tools/git-runner.js +104 -0
  182. package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.d.ts +111 -0
  183. package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.js +197 -0
  184. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
  185. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +463 -0
  186. package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
  187. package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
  188. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +6 -0
  189. package/dist/harness/extension/plugin-ecosystem/tools/index.js +4 -0
  190. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +25 -1
  192. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
  193. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
  194. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
  195. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
  196. package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
  197. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
  198. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
  199. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
  200. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
  201. package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
  202. package/dist/harness/governance/credentials/index.d.ts +1 -1
  203. package/dist/harness/governance/credentials/store.d.ts +16 -4
  204. package/dist/harness/governance/credentials/store.js +33 -6
  205. package/dist/harness/governance/credentials/types.d.ts +11 -0
  206. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
  207. package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
  208. package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
  209. package/dist/harness/governance/human-in-the-loop/index.js +3 -3
  210. package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
  211. package/dist/harness/governance/human-in-the-loop/types.js +6 -2
  212. package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
  213. package/dist/harness/governance/security/capability-enforcer.js +31 -8
  214. package/dist/harness/governance/security/degradation.js +5 -7
  215. package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
  216. package/dist/harness/governance/security/risk-evaluator.js +4 -82
  217. package/dist/harness/governance/security/temp-path.d.ts +41 -0
  218. package/dist/harness/governance/security/temp-path.js +117 -0
  219. package/dist/harness/governance/session-acl/index.d.ts +1 -0
  220. package/dist/harness/governance/session-acl/index.js +1 -0
  221. package/dist/harness/governance/session-acl/rights.d.ts +12 -0
  222. package/dist/harness/governance/session-acl/rights.js +89 -7
  223. package/dist/harness/governance/session-acl/seed-roles.js +9 -1
  224. package/dist/harness/governance/session-acl/service.js +21 -29
  225. package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
  226. package/dist/harness/governance/session-acl/tool-rights.js +238 -0
  227. package/dist/harness/governance/session-acl/types.d.ts +22 -0
  228. package/dist/harness/index.d.ts +16 -12
  229. package/dist/harness/index.js +10 -6
  230. package/dist/harness/knowledge/file-identity.d.ts +8 -0
  231. package/dist/harness/knowledge/file-identity.js +26 -1
  232. package/dist/harness/knowledge/file-index-store.js +11 -11
  233. package/dist/harness/knowledge/grounding.d.ts +2 -1
  234. package/dist/harness/knowledge/grounding.js +8 -5
  235. package/dist/harness/knowledge/index-store.d.ts +31 -4
  236. package/dist/harness/knowledge/index-store.js +121 -39
  237. package/dist/harness/knowledge/index.d.ts +2 -2
  238. package/dist/harness/knowledge/index.js +1 -1
  239. package/dist/harness/knowledge/ingest.d.ts +115 -115
  240. package/dist/harness/knowledge/ingest.js +154 -151
  241. package/dist/harness/knowledge/job-control-state.js +4 -4
  242. package/dist/harness/knowledge/job-control.js +11 -11
  243. package/dist/harness/knowledge/knowledge-serve-child.js +1 -1
  244. package/dist/harness/knowledge/membership-store.js +11 -11
  245. package/dist/harness/knowledge/network-guard.d.ts +61 -4
  246. package/dist/harness/knowledge/network-guard.js +390 -113
  247. package/dist/harness/knowledge/purge.js +4 -1
  248. package/dist/harness/knowledge/query-service.js +3 -3
  249. package/dist/harness/knowledge/writer-service.d.ts +2 -0
  250. package/dist/harness/knowledge/writer-service.js +14 -13
  251. package/dist/harness/memory/backfill-coverage.js +3 -1
  252. package/dist/harness/memory/backfill-trigger.d.ts +2 -2
  253. package/dist/harness/memory/backfill-trigger.js +4 -4
  254. package/dist/harness/memory/index.d.ts +1 -0
  255. package/dist/harness/memory/index.js +1 -0
  256. package/dist/harness/memory/sqlite/agent-db.js +2 -0
  257. package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
  258. package/dist/harness/memory/sqlite/memory-store.js +14 -4
  259. package/dist/harness/memory/sqlite/wisdom-store.js +9 -9
  260. package/dist/harness/memory/store.d.ts +1 -0
  261. package/dist/harness/memory/store.js +3 -0
  262. package/dist/harness/memory/time-format.d.ts +28 -0
  263. package/dist/harness/memory/time-format.js +52 -0
  264. package/dist/harness/memory/types.d.ts +12 -0
  265. package/dist/harness/observability/observer/hub.js +53 -2
  266. package/dist/harness/observability/observer/index.d.ts +2 -2
  267. package/dist/harness/observability/observer/index.js +1 -1
  268. package/dist/harness/observability/observer/types.d.ts +80 -0
  269. package/dist/harness/observability/observer/types.js +118 -9
  270. package/dist/harness/run/agent/agent.d.ts +18 -0
  271. package/dist/harness/run/agent/agent.js +26 -0
  272. package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
  273. package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
  274. package/dist/harness/run/reliability/harness-events.d.ts +4 -0
  275. package/dist/harness/run/reliability/run-agent.js +110 -18
  276. package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
  277. package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
  278. package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
  279. package/dist/harness/run/run-guard/default-run-guard.js +104 -44
  280. package/dist/harness/run/run-scope.d.ts +52 -0
  281. package/dist/harness/run/runner.d.ts +117 -16
  282. package/dist/harness/run/runner.js +668 -157
  283. package/dist/harness/session/attachments/llm-intent.js +17 -17
  284. package/dist/harness/session/history/port.js +16 -5
  285. package/dist/harness/session/in-memory-store.d.ts +6 -0
  286. package/dist/harness/session/in-memory-store.js +55 -3
  287. package/dist/harness/session/schedules/index.d.ts +10 -0
  288. package/dist/harness/session/schedules/index.js +10 -0
  289. package/dist/harness/session/schedules/render.d.ts +13 -0
  290. package/dist/harness/session/schedules/render.js +63 -0
  291. package/dist/harness/session/schedules/service.d.ts +179 -0
  292. package/dist/harness/session/schedules/service.js +695 -0
  293. package/dist/harness/session/schedules/store.d.ts +119 -0
  294. package/dist/harness/session/schedules/store.js +323 -0
  295. package/dist/harness/session/schedules/tools.d.ts +39 -0
  296. package/dist/harness/session/schedules/tools.js +442 -0
  297. package/dist/harness/session/schedules/types.d.ts +104 -0
  298. package/dist/harness/session/schedules/types.js +97 -0
  299. package/dist/harness/session/tasks/tools.js +22 -0
  300. package/dist/harness/session/title.js +25 -9
  301. package/dist/harness/session/types.d.ts +35 -0
  302. package/dist/harness/shared/events/agent-event-map.d.ts +39 -0
  303. package/dist/harness/shared/events/agent-event-map.js +2 -0
  304. package/dist/harness/shared/types/agent-definition.d.ts +23 -0
  305. package/dist/index.d.ts +25 -9
  306. package/dist/index.js +11 -2
  307. package/dist/integration/observability/run-telemetry.d.ts +8 -0
  308. package/dist/integration/observability/run-telemetry.js +31 -8
  309. package/dist/integration/observability/trace-collector.js +26 -4
  310. package/dist/integration/observability/trace-events.d.ts +1 -0
  311. package/dist/integration/observability/trace-events.js +2 -0
  312. package/dist/integration/observability/trace-logger.js +27 -17
  313. package/dist/integration/providers/anthropic.d.ts +10 -0
  314. package/dist/integration/providers/anthropic.js +44 -1
  315. package/dist/integration/providers/openai.d.ts +10 -0
  316. package/dist/integration/providers/openai.js +58 -2
  317. package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
  318. package/dist/integration/providers/wire-dump-diff.js +351 -0
  319. package/dist/integration/providers/wire-dump.d.ts +178 -0
  320. package/dist/integration/providers/wire-dump.js +396 -0
  321. package/dist/integration/storage/jsonl.d.ts +29 -0
  322. package/dist/integration/storage/jsonl.js +243 -41
  323. package/dist/integration/storage/session-index.js +63 -8
  324. package/dist/paths.d.ts +19 -0
  325. package/dist/paths.js +38 -1
  326. package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -43
  327. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -50
  328. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -6
  329. package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -54
  330. package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
  331. package/dist/subsystems/safety-guard/config.yaml +3 -1
  332. package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -50
  333. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -42
  334. package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -54
  335. package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -55
  336. package/package.json +115 -115
  337. package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
  338. package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
  339. package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
  340. package/dist/harness/collaboration/multi-agent/index.js +0 -15
  341. package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
  342. package/dist/harness/collaboration/multi-agent/process.js +0 -256
  343. package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
  344. package/dist/harness/collaboration/multi-agent/registry.js +0 -137
  345. package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
  346. package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
  347. package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
  348. package/dist/harness/collaboration/multi-agent/types.js +0 -15
  349. package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
  350. package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
  351. package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
  352. package/dist/harness/collaboration/orchestration/async-task.js +0 -359
  353. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
  354. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
  355. package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
  356. package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
  357. package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
  358. package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
  359. package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
  360. package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
  361. package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
  362. package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
  363. package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
  364. package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
  365. package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
  366. package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
  367. package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
  368. package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
  369. package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
  370. package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
  371. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
  372. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
  373. package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
  374. package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
  375. package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
  376. package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
  377. package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
  378. package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
  379. package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
  380. package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
  381. package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
  382. package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
  383. package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
  384. package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
  385. package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
  386. package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
  387. package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
  388. package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
  389. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
  390. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.js +0 -0
@@ -0,0 +1,271 @@
1
+ /**
2
+ * DelegationStore — 委派单唯一写入口
3
+ *
4
+ * @layer harness/collaboration/delegation
5
+ * 设计权威:`arch/delegation.md` §4 / §6.2 / D10。
6
+ *
7
+ * 职责:
8
+ * - 读写 `Delegation`(委派单)
9
+ * - **状态机校验**(D10:独立状态机,不与 SessionTask / Workflow 共用)
10
+ * - 发射 `delegation.*` 事件(notify 通道的共同数据源,§7.1)
11
+ *
12
+ * 与 `SessionTaskService` 同构但**独立**:
13
+ * `docs/task-system.md` A2 明令 SessionTask 不做执行原语、不与执行件共状态机,
14
+ * 委派单不塞进 SessionTask。
15
+ *
16
+ * 持久化:v1 提供内存实现;跨进程持久化留待分布式议题(`arch/delegation.md` O5)。
17
+ * 但接口形状按可持久化设计(`Delegation` 全字段可序列化,D1/D5)。
18
+ */
19
+ import { randomUUID } from 'node:crypto';
20
+ import { DELEGATION_SCHEMA_VERSION, DelegationEvents, isTerminalDelegationStatus, } from './types.js';
21
+ function now() {
22
+ return Date.now();
23
+ }
24
+ /**
25
+ * 校验状态迁移是否合法(D10 独立状态机)
26
+ *
27
+ * 合法迁移:
28
+ * - queued → running | failed | cancelled | timeout
29
+ * - running → completed | failed | cancelled | timeout
30
+ * - 终态 → 不可再迁(不可复用)
31
+ *
32
+ * @param from - 当前状态
33
+ * @param to - 目标状态
34
+ * @returns 是否合法
35
+ */
36
+ export function canTransitionDelegation(from, to) {
37
+ if (from === to)
38
+ return true;
39
+ if (isTerminalDelegationStatus(from))
40
+ return false;
41
+ if (from === 'queued') {
42
+ return to === 'running' || isTerminalDelegationStatus(to);
43
+ }
44
+ if (from === 'running') {
45
+ return isTerminalDelegationStatus(to);
46
+ }
47
+ return false;
48
+ }
49
+ /**
50
+ * DelegationStore — 委派单唯一写入口
51
+ */
52
+ export class DelegationStore {
53
+ events;
54
+ records = new Map();
55
+ constructor(events) {
56
+ this.events = events;
57
+ }
58
+ /**
59
+ * 建单(status 固定为 `queued`)
60
+ *
61
+ * @param input - 委派单入参
62
+ * @returns 新建的委派单
63
+ */
64
+ create(input) {
65
+ const record = {
66
+ id: `del-${randomUUID().slice(0, 8)}`,
67
+ parent: { ...input.parent },
68
+ target: { ...input.target },
69
+ task: input.task,
70
+ input: input.input,
71
+ context: input.context ?? 'clean',
72
+ status: 'queued',
73
+ depth: input.depth ?? 1,
74
+ budget: input.budget ? { ...input.budget } : undefined,
75
+ createdAt: now(),
76
+ deadlineAt: input.deadlineAt,
77
+ cancelable: input.cancelable ?? true,
78
+ cascade: input.cascade ?? false,
79
+ deliveryState: 'pending',
80
+ schemaVersion: DELEGATION_SCHEMA_VERSION,
81
+ };
82
+ this.records.set(record.id, record);
83
+ this.emit(DelegationEvents.CREATED, record);
84
+ return { ...record };
85
+ }
86
+ /**
87
+ * 读取委派单
88
+ *
89
+ * @param delegationId - 委派单 ID
90
+ * @returns 委派单;不存在返回 undefined
91
+ */
92
+ get(delegationId) {
93
+ const record = this.records.get(delegationId);
94
+ return record ? { ...record } : undefined;
95
+ }
96
+ /**
97
+ * 更新委派单(含状态机校验)
98
+ *
99
+ * @param delegationId - 委派单 ID
100
+ * @param patch - 变更字段
101
+ * @returns 更新后的委派单
102
+ * @throws 委派单不存在,或状态迁移非法
103
+ */
104
+ update(delegationId, patch) {
105
+ const record = this.records.get(delegationId);
106
+ if (!record) {
107
+ throw new Error(`Delegation not found: ${delegationId}`);
108
+ }
109
+ if (patch.status && !canTransitionDelegation(record.status, patch.status)) {
110
+ throw new Error(`Invalid delegation transition: ${record.status} -> ${patch.status} (${delegationId})`);
111
+ }
112
+ const before = record.status;
113
+ if (patch.resolvedAgentId !== undefined)
114
+ record.resolvedAgentId = patch.resolvedAgentId;
115
+ if (patch.status !== undefined)
116
+ record.status = patch.status;
117
+ if (patch.childSessionId !== undefined)
118
+ record.childSessionId = patch.childSessionId;
119
+ if (patch.childRunId !== undefined)
120
+ record.childRunId = patch.childRunId;
121
+ if (patch.output !== undefined)
122
+ record.output = patch.output;
123
+ if (patch.artifacts !== undefined)
124
+ record.artifacts = [...patch.artifacts];
125
+ if (patch.usage !== undefined)
126
+ record.usage = { ...patch.usage };
127
+ if (patch.error !== undefined)
128
+ record.error = patch.error;
129
+ if (patch.startedAt !== undefined)
130
+ record.startedAt = patch.startedAt;
131
+ if (patch.completedAt !== undefined)
132
+ record.completedAt = patch.completedAt;
133
+ if (patch.deadlineAt !== undefined)
134
+ record.deadlineAt = patch.deadlineAt;
135
+ if (patch.deliveryState !== undefined) {
136
+ record.deliveryState = patch.deliveryState;
137
+ this.emit(DelegationEvents.DELIVERY_STATE_CHANGED, record);
138
+ }
139
+ // 进入终态时补 completedAt(若调用方未给)
140
+ if (patch.status && isTerminalDelegationStatus(patch.status) && record.completedAt == null) {
141
+ record.completedAt = now();
142
+ }
143
+ if (patch.status !== undefined && patch.status !== before) {
144
+ this.emit(this.eventForStatus(patch.status), record);
145
+ }
146
+ return { ...record };
147
+ }
148
+ /**
149
+ * 列出委派单
150
+ *
151
+ * @param filter - 过滤条件
152
+ * @returns 匹配的委派单(按 createdAt 升序)
153
+ */
154
+ list(filter) {
155
+ let results = Array.from(this.records.values());
156
+ if (filter?.parentSessionId !== undefined) {
157
+ results = results.filter((r) => r.parent.sessionId === filter.parentSessionId);
158
+ }
159
+ if (filter?.parentAgentId !== undefined) {
160
+ results = results.filter((r) => r.parent.agentId === filter.parentAgentId);
161
+ }
162
+ if (filter?.status !== undefined) {
163
+ const wanted = Array.isArray(filter.status) ? filter.status : [filter.status];
164
+ results = results.filter((r) => wanted.includes(r.status));
165
+ }
166
+ if (filter?.activeOnly) {
167
+ results = results.filter((r) => !isTerminalDelegationStatus(r.status));
168
+ }
169
+ if (filter?.unsurfacedOnly) {
170
+ results = results.filter((r) => r.deliveryState !== 'surfaced');
171
+ }
172
+ return results.sort((a, b) => a.createdAt - b.createdAt).map((r) => ({ ...r }));
173
+ }
174
+ /**
175
+ * 统计父 session 下各状态数量(§7.3 状态提示渲染用)
176
+ *
177
+ * @param parentSessionId - 父 session ID
178
+ * @returns 状态 → 数量
179
+ */
180
+ countByStatus(parentSessionId) {
181
+ const counts = {
182
+ queued: 0,
183
+ running: 0,
184
+ completed: 0,
185
+ failed: 0,
186
+ cancelled: 0,
187
+ timeout: 0,
188
+ };
189
+ for (const record of this.records.values()) {
190
+ if (record.parent.sessionId === parentSessionId) {
191
+ counts[record.status] += 1;
192
+ }
193
+ }
194
+ return counts;
195
+ }
196
+ /**
197
+ * 查子 session 所在的委派链深度(§10.4 递归深度闸)
198
+ *
199
+ * 子 session 的深度 = 创建它的那张委派单的 `depth`。
200
+ * 查不到表示该 session 非委派产生,视作根(返回 undefined,调用方按 0 处理)。
201
+ *
202
+ * @param childSessionId - 子 session ID
203
+ * @returns 委派链深度;非委派 session 返回 undefined
204
+ */
205
+ findDepthByChildSession(childSessionId) {
206
+ for (const record of this.records.values()) {
207
+ if (record.childSessionId === childSessionId)
208
+ return record.depth;
209
+ }
210
+ return undefined;
211
+ }
212
+ /**
213
+ * 标记投递进行中(§7.1 乐观占位,pending → delivering)。
214
+ * 兼作并发去重位:投递期间同单的重复 notify 入口直接返回。
215
+ *
216
+ * @param delegationId - 委派单 ID
217
+ * @returns 更新后的委派单
218
+ */
219
+ markDelivering(delegationId) {
220
+ return this.update(delegationId, { deliveryState: 'delivering' });
221
+ }
222
+ /**
223
+ * 标记结果已送达父(→ surfaced,§7.3 去重):notify 投递成功
224
+ * 或父经 delegate_get 全文取回。
225
+ *
226
+ * @param delegationId - 委派单 ID
227
+ * @returns 更新后的委派单
228
+ */
229
+ markSurfaced(delegationId) {
230
+ return this.update(delegationId, { deliveryState: 'surfaced' });
231
+ }
232
+ /**
233
+ * 回滚送达标记(→ pending,§7.1 送达回执)——投递失败或 dispatch 被丢
234
+ * (`runtime.trigger.dropped`)时调用,让 §7.3 提示重新兜底。
235
+ * 回滚只在推断安全方向上发生:宁可提示多亮一次(父 get 消音),不可丢结果。
236
+ *
237
+ * @param delegationId - 委派单 ID
238
+ * @returns 更新后的委派单
239
+ */
240
+ markUnsurfaced(delegationId) {
241
+ return this.update(delegationId, { deliveryState: 'pending' });
242
+ }
243
+ eventForStatus(status) {
244
+ switch (status) {
245
+ case 'running':
246
+ return DelegationEvents.STARTED;
247
+ case 'completed':
248
+ return DelegationEvents.COMPLETED;
249
+ case 'failed':
250
+ return DelegationEvents.FAILED;
251
+ case 'cancelled':
252
+ return DelegationEvents.CANCELLED;
253
+ case 'timeout':
254
+ return DelegationEvents.TIMEOUT;
255
+ default:
256
+ return DelegationEvents.CREATED;
257
+ }
258
+ }
259
+ emit(type, record) {
260
+ if (!this.events)
261
+ return;
262
+ const event = {
263
+ type,
264
+ timestamp: now(),
265
+ agentId: record.parent.agentId,
266
+ sessionId: record.parent.sessionId,
267
+ data: { delegation: { ...record } },
268
+ };
269
+ this.events.emit(event);
270
+ }
271
+ }
@@ -0,0 +1,73 @@
1
+ /**
2
+ * DelegateTransport — 委派调用的唯一分布式缝
3
+ *
4
+ * @layer harness/collaboration/delegation
5
+ * 设计权威:`arch/delegation.md` §5 / §11。
6
+ *
7
+ * 上层(`DelegateService` / 工具)只见 `call(request) → result`,不见实现。
8
+ * v1 实现 `InProcessTransport`(直接 async 调用);
9
+ * 将来换 `NetworkTransport` / `WorkerTransport` 上层一行不改。
10
+ *
11
+ * **协议 = L2 的消息 schema + 信封语义,不是 wire format**(§5)。
12
+ * 因此本文件不得出现 socket / worker_threads / child_process 等传输细节。
13
+ *
14
+ * v1 交付语义 = **at-most-once**(进程内天然可靠);
15
+ * 持久化 / 顺序 / 重投 / 共识留待分布式议题(`arch/delegation.md` O5)。
16
+ */
17
+ import type { DelegateRequest, DelegateResult } from './types.js';
18
+ /**
19
+ * 本地委派执行器(由 `DelegateService` 提供)
20
+ *
21
+ * 职责:真正起子 Run、收结果、产出 `DelegateResult`。
22
+ * 与 transport 分离,使 `InProcessTransport` 只做"直调"这一件事。
23
+ *
24
+ * @param request - 委派请求(D1:纯 JSON)
25
+ * @param signal - 本地中止信号(D4:只是 `deadlineAt` / `cancelable` 的本地投影)
26
+ * @returns 委派结果(D5:可序列化)
27
+ */
28
+ export type LocalDelegateExecutor = (request: DelegateRequest, signal?: AbortSignal) => Promise<DelegateResult>;
29
+ /**
30
+ * DelegateTransport 接口
31
+ *
32
+ * 唯一的分布式缝。实现方负责把远端 agent 当作本地 handle 调用。
33
+ */
34
+ export interface DelegateTransport {
35
+ /**
36
+ * 调用委派(request-reply 语义)
37
+ *
38
+ * @param request - 委派请求
39
+ * @param signal - 本地中止信号
40
+ * @returns 委派结果
41
+ * @throws 目标不可达 / 请求非法 / schema 版本不兼容
42
+ */
43
+ call(request: DelegateRequest, signal?: AbortSignal): Promise<DelegateResult>;
44
+ }
45
+ /**
46
+ * InProcessTransport — 进程内直调实现
47
+ *
48
+ * 不序列化(同进程无必要),但**入参出参仍必须是纯 JSON**(D1/D5),
49
+ * 以保证换成 `NetworkTransport` 时上层行为一致。
50
+ */
51
+ export declare class InProcessTransport implements DelegateTransport {
52
+ private readonly executor;
53
+ /**
54
+ * @param executor - 本地委派执行器(起子 Run 的实际入口)
55
+ */
56
+ constructor(executor: LocalDelegateExecutor);
57
+ /**
58
+ * 直调本地执行器
59
+ *
60
+ * @param request - 委派请求
61
+ * @param signal - 本地中止信号
62
+ * @returns 委派结果
63
+ * @throws schema 版本不兼容,或执行器抛错
64
+ */
65
+ call(request: DelegateRequest, signal?: AbortSignal): Promise<DelegateResult>;
66
+ }
67
+ /**
68
+ * 断言消息 schema 版本兼容(§11:消息必须版本化)
69
+ *
70
+ * @param request - 委派请求
71
+ * @throws 版本缺失或主版本不兼容
72
+ */
73
+ export declare function assertCompatibleSchema(request: DelegateRequest): void;
@@ -0,0 +1,61 @@
1
+ /**
2
+ * DelegateTransport — 委派调用的唯一分布式缝
3
+ *
4
+ * @layer harness/collaboration/delegation
5
+ * 设计权威:`arch/delegation.md` §5 / §11。
6
+ *
7
+ * 上层(`DelegateService` / 工具)只见 `call(request) → result`,不见实现。
8
+ * v1 实现 `InProcessTransport`(直接 async 调用);
9
+ * 将来换 `NetworkTransport` / `WorkerTransport` 上层一行不改。
10
+ *
11
+ * **协议 = L2 的消息 schema + 信封语义,不是 wire format**(§5)。
12
+ * 因此本文件不得出现 socket / worker_threads / child_process 等传输细节。
13
+ *
14
+ * v1 交付语义 = **at-most-once**(进程内天然可靠);
15
+ * 持久化 / 顺序 / 重投 / 共识留待分布式议题(`arch/delegation.md` O5)。
16
+ */
17
+ import { DELEGATION_SCHEMA_VERSION } from './types.js';
18
+ /**
19
+ * InProcessTransport — 进程内直调实现
20
+ *
21
+ * 不序列化(同进程无必要),但**入参出参仍必须是纯 JSON**(D1/D5),
22
+ * 以保证换成 `NetworkTransport` 时上层行为一致。
23
+ */
24
+ export class InProcessTransport {
25
+ executor;
26
+ /**
27
+ * @param executor - 本地委派执行器(起子 Run 的实际入口)
28
+ */
29
+ constructor(executor) {
30
+ this.executor = executor;
31
+ }
32
+ /**
33
+ * 直调本地执行器
34
+ *
35
+ * @param request - 委派请求
36
+ * @param signal - 本地中止信号
37
+ * @returns 委派结果
38
+ * @throws schema 版本不兼容,或执行器抛错
39
+ */
40
+ async call(request, signal) {
41
+ assertCompatibleSchema(request);
42
+ return this.executor(request, signal);
43
+ }
44
+ }
45
+ /**
46
+ * 断言消息 schema 版本兼容(§11:消息必须版本化)
47
+ *
48
+ * @param request - 委派请求
49
+ * @throws 版本缺失或主版本不兼容
50
+ */
51
+ export function assertCompatibleSchema(request) {
52
+ if (typeof request.schemaVersion !== 'number') {
53
+ throw new Error('delegate_request: missing schemaVersion');
54
+ }
55
+ // 主版本不兼容才拒绝;同主版本的次级演进视为兼容
56
+ const major = Math.trunc(request.schemaVersion);
57
+ const currentMajor = Math.trunc(DELEGATION_SCHEMA_VERSION);
58
+ if (major !== currentMajor) {
59
+ throw new Error(`delegate_request: incompatible schemaVersion ${request.schemaVersion} (current ${DELEGATION_SCHEMA_VERSION})`);
60
+ }
61
+ }
@@ -0,0 +1,231 @@
1
+ /**
2
+ * Delegation — 委派契约类型(L2 委派契约层)
3
+ *
4
+ * @layer harness/collaboration/delegation — 多 Agent 委派产品契约,非 Core Kernel。
5
+ * 设计权威:`arch/delegation.md`。
6
+ *
7
+ * 设计不变量(`arch/delegation.md` §3):
8
+ * - D1 委派契约是**纯 JSON 消息**,不传 JS 对象引用(跨进程可序列化)
9
+ * - D5 结果只含可序列化字段(output / artifacts / usage / error)
10
+ * - D10 委派单状态机独立,不与 SessionTask / Workflow 共用
11
+ *
12
+ * 因此本文件的**所有**类型必须可 `JSON.stringify` 无损往返;
13
+ * 不得出现 `AbortSignal` / `Agent` 实例 / 函数 / class 实例等非序列化值。
14
+ */
15
+ import type { TokenUsage } from '@octopi-agent/core/types/turn.js';
16
+ import type { SessionRights } from '../../governance/session-acl/types.js';
17
+ /**
18
+ * 委派消息 schema 版本(D1/⑤:跨进程契约必须版本化)。
19
+ * 破坏性变更时 +1;transport 与 service 据此做兼容判断。
20
+ */
21
+ export declare const DELEGATION_SCHEMA_VERSION = 1;
22
+ /** 委派单状态 */
23
+ export type DelegationStatus = 'queued' | 'running' | 'completed' | 'failed' | 'cancelled' | 'timeout';
24
+ /** 终态集合:进入后不可复用(对齐 AgentProcess 旧语义,但状态机独立 D10) */
25
+ export declare const DELEGATION_TERMINAL_STATUSES: readonly DelegationStatus[];
26
+ /**
27
+ * 判断委派单是否已到终态
28
+ *
29
+ * @param status - 委派单状态
30
+ * @returns 是否终态
31
+ */
32
+ export declare function isTerminalDelegationStatus(status: DelegationStatus): boolean;
33
+ /** 未闭合状态集合(queued + running) */
34
+ export declare const DELEGATION_ACTIVE_STATUSES: readonly DelegationStatus[];
35
+ /**
36
+ * 判断委派单是否仍未闭合
37
+ *
38
+ * @param status - 委派单状态
39
+ * @returns 是否活跃
40
+ */
41
+ export declare function isActiveDelegationStatus(status: DelegationStatus): boolean;
42
+ /**
43
+ * 委派目标寻址。
44
+ *
45
+ * 二选一:`agentId` 显式指定;或 `capability` 交 `AgentRegistry` 解析。
46
+ * **不得**传对象引用(D1/②)。
47
+ */
48
+ export interface DelegationTarget {
49
+ /** 目标 agentId(与 trait 二选一,agentId 优先) */
50
+ agentId?: string;
51
+ /** 特质标签(无显式 agentId 时按特质发现) */
52
+ trait?: string;
53
+ }
54
+ /**
55
+ * 委派预算。
56
+ *
57
+ * 子的 Guard/Budget **独立生效**(防子失控);usage 归集到父的 run 账(决策 C2)。
58
+ * `timeoutMs` 是相对时长,service 起子 Run 时换算为 `deadlineAt`(D4)。
59
+ */
60
+ export interface DelegationBudget {
61
+ /** 子 Run 最大轮次 */
62
+ maxTurns?: number;
63
+ /** 子 Run 最大 token */
64
+ maxTokens?: number;
65
+ /** 委派超时(毫秒);换算为 deadlineAt */
66
+ timeoutMs?: number;
67
+ }
68
+ /**
69
+ * 父 Run 身份(D2:字符串寻址,不含对象引用)
70
+ */
71
+ export interface DelegationParentRef {
72
+ agentId: string;
73
+ sessionId: string;
74
+ runId: string;
75
+ }
76
+ /** 结果送达父的状态机(§7.1 送达语义) */
77
+ export type DelegationDeliveryState = 'pending' | 'delivering' | 'surfaced';
78
+ /**
79
+ * 委派单 —— 一次委派的全程记录
80
+ *
81
+ * 持久化在 `DelegationStore`(唯一写入口),是 notify / poll 两通道的共同数据源。
82
+ */
83
+ export interface Delegation {
84
+ id: string;
85
+ /** 父 Run 身份 */
86
+ parent: DelegationParentRef;
87
+ /** 目标寻址(D2) */
88
+ target: DelegationTarget;
89
+ /** 解析后的目标 agentId(service 解析后回填;未解析时 undefined) */
90
+ resolvedAgentId?: string;
91
+ /** 任务描述(进子的 user 消息) */
92
+ task: string;
93
+ /** 显式输入(不传父上下文,D6/⑥) */
94
+ input: string;
95
+ /** 上下文传递模式(默认 clean) */
96
+ context: DelegationContextMode;
97
+ status: DelegationStatus;
98
+ /** 子 Session 关联(D7:独立 Session + 显式父子关联) */
99
+ childSessionId?: string;
100
+ childRunId?: string;
101
+ /** 子的最后一轮 assistant 文本 = 结论(D5) */
102
+ output?: string;
103
+ /** 子产出的文件路径(D5/D6:不共享文件系统,显式声明) */
104
+ artifacts?: string[];
105
+ /** 子 Run 的 token 消耗(归集到父的 run 账,决策 C2) */
106
+ usage?: TokenUsage;
107
+ /** 失败原因(failed / timeout / cancelled 时有值) */
108
+ error?: string;
109
+ /** 委派深度(根委派 = 1);超 maxDepth 直接 failed(§10.4) */
110
+ depth: number;
111
+ /** 生效预算(请求 ∩ 目标上限,D3 只收紧);落库可审计 */
112
+ budget?: DelegationBudget;
113
+ createdAt: number;
114
+ startedAt?: number;
115
+ completedAt?: number;
116
+ /** 绝对截止时刻(D4:数据化,非 AbortSignal) */
117
+ deadlineAt?: number;
118
+ /** 是否允许取消(D4) */
119
+ cancelable: boolean;
120
+ /** 是否父亡子亡(决策 C1:默认 false = 子继续跑) */
121
+ cascade: boolean;
122
+ /**
123
+ * 结果送达父的状态(§7.3 提示去重,§7.1 送达回执):
124
+ * - `pending`:未送达(投递未开始 / 失败 / 被丢回滚)
125
+ * - `delivering`:投递进行中(乐观占位;此间提示保持点亮)
126
+ * - `surfaced`:已送达(notify 投递成功或父经 delegate_get 全文取回)
127
+ */
128
+ deliveryState: DelegationDeliveryState;
129
+ schemaVersion: number;
130
+ }
131
+ /** 上下文传递模式 */
132
+ export type DelegationContextMode = 'clean' | 'fork';
133
+ /**
134
+ * 父 → 子的调用消息(D1:纯 JSON schema)
135
+ *
136
+ * **不得**携带 `AbortSignal` / `Agent` / `Message[]` 之外的活对象。
137
+ * `parentMessages` 仅 `context: 'fork'` 时有(D5:Message 本身可序列化)。
138
+ */
139
+ export interface DelegateRequest {
140
+ delegationId: string;
141
+ from: DelegationParentRef;
142
+ to: DelegationTarget;
143
+ /**
144
+ * 子 Session / Run ID(D7)。
145
+ *
146
+ * 由**服务方在起子 Run 之前生成并落库**,而不是由子 Run 结束时回填——
147
+ * 否则子 agent 运行期间发起的孙代委派查不到 `childSessionId`,
148
+ * 递归深度闸(§10.4)会失效。
149
+ */
150
+ childSessionId: string;
151
+ childRunId: string;
152
+ task: string;
153
+ input: string;
154
+ /** 上下文传递模式 */
155
+ context: DelegationContextMode;
156
+ /**
157
+ * 父消息历史(仅 context='fork' 时携带)。
158
+ *
159
+ * 调用方必须传**快照**(不是活数组引用)——父 run 在子起跑后仍会 append,
160
+ * 传引用会让 fork 内容随时间漂移(D1:契约是纯消息,不是活对象)。
161
+ */
162
+ parentMessages?: import('@octopi-agent/core/types.js').Message[];
163
+ /** 权利天花板(D3:子只能收紧不能放宽) */
164
+ rightsCeiling?: SessionRights;
165
+ /** 预算(§8) */
166
+ budget?: DelegationBudget;
167
+ /** 绝对截止时刻(D4) */
168
+ deadlineAt?: number;
169
+ /** 是否允许取消(D4:可取消性随消息传播,不靠本地句柄) */
170
+ cancelable?: boolean;
171
+ schemaVersion: number;
172
+ }
173
+ /**
174
+ * 子 → 父的结果消息(D5:只含可序列化字段)
175
+ */
176
+ export interface DelegateResult {
177
+ delegationId: string;
178
+ status: Extract<DelegationStatus, 'completed' | 'failed' | 'cancelled' | 'timeout'>;
179
+ /** 子 Session / Run ID(回显用;服务方已在起 Run 前落库) */
180
+ childSessionId?: string;
181
+ childRunId?: string;
182
+ output?: string;
183
+ artifacts?: string[];
184
+ usage?: TokenUsage;
185
+ error?: string;
186
+ schemaVersion: number;
187
+ }
188
+ /**
189
+ * 目标 agent 的解析结果(D2)。
190
+ *
191
+ * 进程内实现携带 `run` 入口;跨进程实现只携带可序列化字段,
192
+ * 由 `DelegateTransport` 负责把远端 agent 当作本地 handle 调用。
193
+ */
194
+ export interface AgentHandle {
195
+ /** 解析出的 agentId */
196
+ agentId: string;
197
+ /** 特质标签(供调用方核对是否命中意图) */
198
+ traits: string[];
199
+ /** 被委派时的权利天花板(D3:只能收紧) */
200
+ rightsCeiling?: SessionRights;
201
+ /** 委派预算上限(service 取请求预算 ∩ 此上限) */
202
+ budget?: DelegationBudget;
203
+ /** 递归上限(§10.4;undefined = 默认 1) */
204
+ maxDepth?: number;
205
+ /** 是否可被委派(registry 解析时已过滤 callable=false) */
206
+ callable: true;
207
+ }
208
+ /**
209
+ * 委派事件常量。
210
+ *
211
+ * notify 通道(§7.1)消费 `COMPLETED` / `FAILED` / `CANCELLED` / `TIMEOUT`,
212
+ * 转 `emitAgentSignal` 唤醒父 AgentRuntime。
213
+ */
214
+ export declare const DelegationEvents: {
215
+ /** 委派单创建 */
216
+ readonly CREATED: "delegation.created";
217
+ /** 子 Run 启动 */
218
+ readonly STARTED: "delegation.started";
219
+ /** 终态:completed */
220
+ readonly COMPLETED: "delegation.completed";
221
+ /** 终态:failed */
222
+ readonly FAILED: "delegation.failed";
223
+ /** 终态:cancelled */
224
+ readonly CANCELLED: "delegation.cancelled";
225
+ /** 终态:timeout */
226
+ readonly TIMEOUT: "delegation.timeout";
227
+ /** 送达状态迁移(delivering / surfaced / 回滚 pending) */
228
+ readonly DELIVERY_STATE_CHANGED: "delegation.delivery_state";
229
+ };
230
+ /** 委派事件类型字面量 */
231
+ export type DelegationEventType = (typeof DelegationEvents)[keyof typeof DelegationEvents];