@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
@@ -1,144 +0,0 @@
1
- /**
2
- * AgentRegistry — Agent 注册与发现契约
3
- *
4
- * @layer harness/collaboration/multi-agent — 多 Agent 产品契约,非 Core Kernel。
5
- * 实现:DefaultAgentRegistry(registry.ts)。
6
- *
7
- * 设计原则:
8
- * - 契约与实现同域;跨域只 import 本文件 types
9
- * - 支持按能力(capability)发现 Agent
10
- * - 支持 Agent 上下线通知
11
- * - 支持多 Agent 拓扑描述
12
- */
13
- /** Agent 注册信息 */
14
- export interface AgentInfo {
15
- /** Agent 唯一 ID */
16
- id: string;
17
- /** Agent 名称(人类可读) */
18
- name: string;
19
- /** Agent 描述 */
20
- description?: string;
21
- /** Agent 能力标签(用于发现) */
22
- capabilities: string[];
23
- /** Agent 元数据 */
24
- metadata?: Record<string, unknown>;
25
- /** 注册时间 */
26
- registeredAt: number;
27
- /** 最后活跃时间 */
28
- lastActiveAt: number;
29
- /** Agent 状态 */
30
- status: 'active' | 'idle' | 'busy' | 'offline';
31
- }
32
- /** Agent 查询条件 */
33
- export interface AgentQuery {
34
- /** 按能力过滤 */
35
- capabilities?: string[];
36
- /** 按状态过滤 */
37
- status?: AgentInfo['status'];
38
- /** 按元数据过滤 */
39
- metadata?: Record<string, unknown>;
40
- }
41
- /** Agent 间关系类型 */
42
- export type AgentRelationType = 'peer' | 'superior' | 'subordinate' | 'pipeline' | 'depends';
43
- /** Agent 间关系 */
44
- export interface AgentRelation {
45
- /** 关系来源 Agent */
46
- from: string;
47
- /** 关系目标 Agent */
48
- to: string;
49
- /** 关系类型 */
50
- type: AgentRelationType;
51
- /** 关系元数据 */
52
- metadata?: Record<string, unknown>;
53
- }
54
- export declare const AgentRegistryEvents: {
55
- /** Agent 注册 */
56
- readonly AGENT_REGISTERED: "registry.agent.registered";
57
- /** Agent 注销 */
58
- readonly AGENT_UNREGISTERED: "registry.agent.unregistered";
59
- /** Agent 状态变更 */
60
- readonly AGENT_STATUS_CHANGED: "registry.agent.status_changed";
61
- /** 关系添加 */
62
- readonly RELATION_ADDED: "registry.relation.added";
63
- /** 关系移除 */
64
- readonly RELATION_REMOVED: "registry.relation.removed";
65
- };
66
- /**
67
- * AgentRegistry 接口
68
- *
69
- * Agent 注册与发现的核心契约。
70
- */
71
- export interface AgentRegistry {
72
- /**
73
- * 注册 Agent
74
- *
75
- * @param info - Agent 信息
76
- */
77
- register(info: Omit<AgentInfo, 'registeredAt' | 'lastActiveAt'>): void;
78
- /**
79
- * 注销 Agent
80
- *
81
- * @param agentId - Agent ID
82
- * @returns 是否成功注销
83
- */
84
- unregister(agentId: string): boolean;
85
- /**
86
- * 获取 Agent 信息
87
- *
88
- * @param agentId - Agent ID
89
- * @returns Agent 信息,不存在返回 undefined
90
- */
91
- get(agentId: string): AgentInfo | undefined;
92
- /**
93
- * 查询 Agent
94
- *
95
- * @param query - 查询条件
96
- * @returns 匹配的 Agent 列表
97
- */
98
- query(query: AgentQuery): AgentInfo[];
99
- /**
100
- * 列出所有已注册 Agent
101
- */
102
- list(): AgentInfo[];
103
- /**
104
- * 更新 Agent 状态
105
- *
106
- * @param agentId - Agent ID
107
- * @param status - 新状态
108
- */
109
- updateStatus(agentId: string, status: AgentInfo['status']): void;
110
- /**
111
- * 更新 Agent 活跃时间
112
- *
113
- * @param agentId - Agent ID
114
- */
115
- touch(agentId: string): void;
116
- /**
117
- * 添加 Agent 间关系
118
- *
119
- * @param relation - 关系描述
120
- */
121
- addRelation(relation: AgentRelation): void;
122
- /**
123
- * 移除 Agent 间关系
124
- *
125
- * @param from - 来源 Agent ID
126
- * @param to - 目标 Agent ID
127
- * @param type - 关系类型(不传则移除所有关系)
128
- */
129
- removeRelation(from: string, to: string, type?: AgentRelationType): void;
130
- /**
131
- * 获取 Agent 的所有关系
132
- *
133
- * @param agentId - Agent ID
134
- * @returns 关系列表
135
- */
136
- getRelations(agentId: string): AgentRelation[];
137
- /**
138
- * 查找具有特定能力的 Agent
139
- *
140
- * @param capability - 能力标签
141
- * @returns 具备该能力的 Agent 列表
142
- */
143
- findByCapability(capability: string): AgentInfo[];
144
- }
@@ -1,25 +0,0 @@
1
- /**
2
- * AgentRegistry — Agent 注册与发现契约
3
- *
4
- * @layer harness/collaboration/multi-agent — 多 Agent 产品契约,非 Core Kernel。
5
- * 实现:DefaultAgentRegistry(registry.ts)。
6
- *
7
- * 设计原则:
8
- * - 契约与实现同域;跨域只 import 本文件 types
9
- * - 支持按能力(capability)发现 Agent
10
- * - 支持 Agent 上下线通知
11
- * - 支持多 Agent 拓扑描述
12
- */
13
- // ── 事件 ──
14
- export const AgentRegistryEvents = {
15
- /** Agent 注册 */
16
- AGENT_REGISTERED: 'registry.agent.registered',
17
- /** Agent 注销 */
18
- AGENT_UNREGISTERED: 'registry.agent.unregistered',
19
- /** Agent 状态变更 */
20
- AGENT_STATUS_CHANGED: 'registry.agent.status_changed',
21
- /** 关系添加 */
22
- RELATION_ADDED: 'registry.relation.added',
23
- /** 关系移除 */
24
- RELATION_REMOVED: 'registry.relation.removed',
25
- };
@@ -1,17 +0,0 @@
1
- /**
2
- * Multi-Agent 模块统一导出
3
- *
4
- * 多 Agent 编排、注册、发现。
5
- */
6
- export type { SwarmTopology, SwarmConfig, SwarmAgent, SwarmTask, } from './types.js';
7
- export { SwarmEvents } from './types.js';
8
- export type { AgentRegistry, AgentInfo, AgentQuery, AgentRelation, AgentRelationType, } from './agent-registry-types.js';
9
- export { AgentRegistryEvents } from './agent-registry-types.js';
10
- export type { MessageChannel, ProcessMessage, MessageHandler, } from './message-channel-types.js';
11
- export { DefaultAgentRegistry } from './registry.js';
12
- export { AgentSwarm } from './swarm.js';
13
- export type { OrchestrationStrategy } from './swarm.js';
14
- export { RoundRobinStrategy, CapabilityStrategy, PipelineStrategy, } from './swarm.js';
15
- export { AgentProcess, spawnAgentProcess, forkAgentProcess } from './process.js';
16
- export type { AgentProcessState, AgentProcessResult, AgentProcessAnnounce, AgentProcessConfig } from './process.js';
17
- export { AgentProcessEvents } from './process.js';
@@ -1,15 +0,0 @@
1
- /**
2
- * Multi-Agent 模块统一导出
3
- *
4
- * 多 Agent 编排、注册、发现。
5
- */
6
- export { SwarmEvents } from './types.js';
7
- export { AgentRegistryEvents } from './agent-registry-types.js';
8
- // ── 注册表 ──
9
- export { DefaultAgentRegistry } from './registry.js';
10
- // ── 编排器 ──
11
- export { AgentSwarm } from './swarm.js';
12
- export { RoundRobinStrategy, CapabilityStrategy, PipelineStrategy, } from './swarm.js';
13
- // ── 进程 ──
14
- export { AgentProcess, spawnAgentProcess, forkAgentProcess } from './process.js';
15
- export { AgentProcessEvents } from './process.js';
@@ -1,167 +0,0 @@
1
- /**
2
- * AgentProcess — Agent 进程运行时
3
- *
4
- * 将 Agent 的一次运行包装为可追踪的进程。
5
- * 支持父子关系、完成通知(announce)、上下文分叉(fork)。
6
- *
7
- * 设计原则:
8
- * - 独立状态机(pending/running/completed/failed/aborted),不继承任何进程壳
9
- * - 结果通过 EventBus 推送给父进程(announce 模式)
10
- * - 支持 context fork:子进程继承父进程的消息历史
11
- * - 进程完成后不可重用(completed/failed/aborted 终态)
12
- */
13
- import type { EventBus } from '@octopi-agent/core/primitives/event-bus.js';
14
- import type { Message } from '@octopi-agent/core/types.js';
15
- import type { Agent } from '../../run/agent/index.js';
16
- import type { ReliabilityHarness } from '../../run/reliability/index.js';
17
- import type { AgentInfo } from './agent-registry-types.js';
18
- /** Agent 进程状态 */
19
- export type AgentProcessState = 'pending' | 'running' | 'completed' | 'failed' | 'aborted';
20
- /** 进程完成信息 */
21
- export interface AgentProcessResult {
22
- /** 最终回复内容 */
23
- content: string;
24
- /** 完整消息历史(含工具调用) */
25
- messages: Message[];
26
- /** 使用统计 */
27
- usage?: import('@octopi-agent/core/types/turn.js').TokenUsage;
28
- /** 运行时长(毫秒) */
29
- durationMs: number;
30
- }
31
- /** 进程完成事件数据 */
32
- export interface AgentProcessAnnounce {
33
- /** 进程 ID */
34
- processId: string;
35
- /** 父进程 ID */
36
- parentId?: string;
37
- /** Agent 信息 */
38
- agentInfo: AgentInfo;
39
- /** 完成状态 */
40
- state: 'completed' | 'failed' | 'aborted';
41
- /** 完成结果(completed 时有值) */
42
- result?: AgentProcessResult;
43
- /** 错误信息(failed 时有值) */
44
- error?: string;
45
- /** 时间戳 */
46
- timestamp: number;
47
- }
48
- export declare const AgentProcessEvents: {
49
- /** 进程启动 */
50
- readonly STARTED: "agent_process.started";
51
- /** 进程完成(announce 核心事件) */
52
- readonly COMPLETED: "agent_process.completed";
53
- /** 进程失败 */
54
- readonly FAILED: "agent_process.failed";
55
- /** 进程中止 */
56
- readonly ABORTED: "agent_process.aborted";
57
- /** 子进程 spawn */
58
- readonly CHILD_SPAWNED: "agent_process.child_spawned";
59
- };
60
- /** AgentProcess 配置 */
61
- export interface AgentProcessConfig {
62
- /** 进程 ID(不传则自动生成) */
63
- id?: string;
64
- /** 父进程 ID */
65
- parentId?: string;
66
- /** Agent 信息 */
67
- agentInfo: AgentInfo;
68
- /** Agent 实例 */
69
- agent: Agent;
70
- /** 可靠性 Harness */
71
- harness: ReliabilityHarness;
72
- /** EventBus(用于 announce) */
73
- events: EventBus;
74
- /** 系统提示词 */
75
- systemPrompt: string;
76
- /** 超时(毫秒,默认 0 = 不超时) */
77
- timeoutMs?: number;
78
- /** 是否启用 context fork(默认 false) */
79
- forkContext?: boolean;
80
- }
81
- /**
82
- * AgentProcess — Agent 进程运行时
83
- *
84
- * 用法:
85
- * ```ts
86
- * const process = new AgentProcess({
87
- * agentInfo: coderAgent,
88
- * engine: coderEngine,
89
- * events: eventBus,
90
- * systemPrompt: 'You are a coding assistant...',
91
- * });
92
- *
93
- * // 非阻塞启动
94
- * process.start(userMessages);
95
- *
96
- * // 监听完成事件
97
- * events.on(AgentProcessEvents.COMPLETED, (event) => {
98
- * console.log(event.data.result);
99
- * });
100
- *
101
- * // 或等待完成
102
- * const result = await process.waitForCompletion();
103
- * ```
104
- */
105
- export declare class AgentProcess {
106
- readonly id: string;
107
- readonly parentId?: string;
108
- readonly agentInfo: AgentInfo;
109
- private _agent;
110
- private _harness;
111
- private _events;
112
- private _systemPrompt;
113
- private _timeoutMs;
114
- private _forkContext;
115
- private _state;
116
- private _result?;
117
- private _error?;
118
- private _startedAt?;
119
- private _completedAt?;
120
- private _abortController?;
121
- private _completionResolvers;
122
- constructor(config: AgentProcessConfig);
123
- /** 当前状态 */
124
- get state(): AgentProcessState;
125
- /** 完成结果 */
126
- get result(): AgentProcessResult | undefined;
127
- /** 错误信息 */
128
- get error(): string | undefined;
129
- /** 运行时长(毫秒) */
130
- get durationMs(): number | undefined;
131
- /**
132
- * 启动进程(非阻塞)
133
- *
134
- * @param messages - 输入消息
135
- * @param parentMessages - 父进程的消息历史(用于 context fork)
136
- * @returns this(链式调用)
137
- */
138
- start(messages: Message[], parentMessages?: Message[]): this;
139
- /**
140
- * 中止进程
141
- */
142
- abort(): void;
143
- /**
144
- * 等待进程完成(Promise 模式)
145
- */
146
- waitForCompletion(): Promise<AgentProcessAnnounce>;
147
- private _runAsync;
148
- private _collectRun;
149
- private _buildAnnounce;
150
- private _resolveCompletion;
151
- private _emit;
152
- private _withTimeout;
153
- }
154
- /**
155
- * 创建并启动 AgentProcess
156
- */
157
- export declare function spawnAgentProcess(config: Omit<AgentProcessConfig, 'id'> & {
158
- id?: string;
159
- }, messages: Message[], parentMessages?: Message[]): AgentProcess;
160
- /**
161
- * 创建 context fork 子进程
162
- *
163
- * 从父进程的消息历史创建子进程,子进程继承父上下文。
164
- */
165
- export declare function forkAgentProcess(config: Omit<AgentProcessConfig, 'forkContext'> & {
166
- forkContext?: boolean;
167
- }, messages: Message[], parentMessages: Message[]): AgentProcess;
@@ -1,256 +0,0 @@
1
- /**
2
- * AgentProcess — Agent 进程运行时
3
- *
4
- * 将 Agent 的一次运行包装为可追踪的进程。
5
- * 支持父子关系、完成通知(announce)、上下文分叉(fork)。
6
- *
7
- * 设计原则:
8
- * - 独立状态机(pending/running/completed/failed/aborted),不继承任何进程壳
9
- * - 结果通过 EventBus 推送给父进程(announce 模式)
10
- * - 支持 context fork:子进程继承父进程的消息历史
11
- * - 进程完成后不可重用(completed/failed/aborted 终态)
12
- */
13
- import { randomUUID } from 'node:crypto';
14
- // ── 事件常量 ──
15
- export const AgentProcessEvents = {
16
- /** 进程启动 */
17
- STARTED: 'agent_process.started',
18
- /** 进程完成(announce 核心事件) */
19
- COMPLETED: 'agent_process.completed',
20
- /** 进程失败 */
21
- FAILED: 'agent_process.failed',
22
- /** 进程中止 */
23
- ABORTED: 'agent_process.aborted',
24
- /** 子进程 spawn */
25
- CHILD_SPAWNED: 'agent_process.child_spawned',
26
- };
27
- // ── AgentProcess ──
28
- /**
29
- * AgentProcess — Agent 进程运行时
30
- *
31
- * 用法:
32
- * ```ts
33
- * const process = new AgentProcess({
34
- * agentInfo: coderAgent,
35
- * engine: coderEngine,
36
- * events: eventBus,
37
- * systemPrompt: 'You are a coding assistant...',
38
- * });
39
- *
40
- * // 非阻塞启动
41
- * process.start(userMessages);
42
- *
43
- * // 监听完成事件
44
- * events.on(AgentProcessEvents.COMPLETED, (event) => {
45
- * console.log(event.data.result);
46
- * });
47
- *
48
- * // 或等待完成
49
- * const result = await process.waitForCompletion();
50
- * ```
51
- */
52
- export class AgentProcess {
53
- id;
54
- parentId;
55
- agentInfo;
56
- _agent;
57
- _harness;
58
- _events;
59
- _systemPrompt;
60
- _timeoutMs;
61
- _forkContext;
62
- _state = 'pending';
63
- _result;
64
- _error;
65
- _startedAt;
66
- _completedAt;
67
- _abortController;
68
- _completionResolvers = [];
69
- constructor(config) {
70
- this.id = config.id ?? `proc-${randomUUID().slice(0, 8)}`;
71
- this.parentId = config.parentId;
72
- this.agentInfo = config.agentInfo;
73
- this._agent = config.agent;
74
- this._harness = config.harness;
75
- this._events = config.events;
76
- this._systemPrompt = config.systemPrompt;
77
- this._timeoutMs = config.timeoutMs ?? 0;
78
- this._forkContext = config.forkContext ?? false;
79
- }
80
- /** 当前状态 */
81
- get state() { return this._state; }
82
- /** 完成结果 */
83
- get result() { return this._result; }
84
- /** 错误信息 */
85
- get error() { return this._error; }
86
- /** 运行时长(毫秒) */
87
- get durationMs() {
88
- if (!this._startedAt)
89
- return undefined;
90
- const end = this._completedAt ?? Date.now();
91
- return end - this._startedAt;
92
- }
93
- /**
94
- * 启动进程(非阻塞)
95
- *
96
- * @param messages - 输入消息
97
- * @param parentMessages - 父进程的消息历史(用于 context fork)
98
- * @returns this(链式调用)
99
- */
100
- start(messages, parentMessages) {
101
- if (this._state !== 'pending') {
102
- throw new Error(`Process ${this.id} already started (state: ${this._state})`);
103
- }
104
- this._state = 'running';
105
- this._startedAt = Date.now();
106
- this._abortController = new AbortController();
107
- // 构建输入消息
108
- let inputMessages = [...messages];
109
- // Context fork:继承父进程的消息历史
110
- if (this._forkContext && parentMessages && parentMessages.length > 0) {
111
- inputMessages = [
112
- ...parentMessages,
113
- {
114
- role: 'system',
115
- content: `[Context Fork] 以下是从父会话分叉的上下文。你继承了完整的对话历史,可以在此基础上继续工作。`,
116
- timestamp: Date.now(),
117
- },
118
- ...messages,
119
- ];
120
- }
121
- // 发射启动事件
122
- this._emit(AgentProcessEvents.STARTED, {
123
- processId: this.id,
124
- parentId: this.parentId,
125
- agentId: this.agentInfo.id,
126
- });
127
- // 异步运行(不 await,非阻塞)
128
- this._runAsync(inputMessages);
129
- return this;
130
- }
131
- /**
132
- * 中止进程
133
- */
134
- abort() {
135
- if (this._state !== 'running')
136
- return;
137
- this._abortController?.abort();
138
- this._state = 'aborted';
139
- this._completedAt = Date.now();
140
- this._emit(AgentProcessEvents.ABORTED, { processId: this.id });
141
- this._resolveCompletion();
142
- }
143
- /**
144
- * 等待进程完成(Promise 模式)
145
- */
146
- waitForCompletion() {
147
- if (this._state !== 'running' && this._state !== 'pending') {
148
- return Promise.resolve(this._buildAnnounce());
149
- }
150
- return new Promise((resolve) => {
151
- this._completionResolvers.push(resolve);
152
- });
153
- }
154
- // ── 内部方法 ──
155
- async _runAsync(messages) {
156
- try {
157
- // 带超时的运行
158
- const runPromise = this._collectRun(messages);
159
- const result = this._timeoutMs > 0
160
- ? await this._withTimeout(runPromise, this._timeoutMs)
161
- : await runPromise;
162
- this._result = {
163
- content: result.content,
164
- messages: result.messages,
165
- usage: result.usage,
166
- durationMs: this.durationMs ?? 0,
167
- };
168
- this._state = 'completed';
169
- this._completedAt = Date.now();
170
- // Announce:推送完成事件
171
- const announce = this._buildAnnounce();
172
- this._emit(AgentProcessEvents.COMPLETED, { announce });
173
- this._resolveCompletion();
174
- }
175
- catch (err) {
176
- if (this._state === 'aborted')
177
- return; // 已经处理过
178
- this._state = 'failed';
179
- this._completedAt = Date.now();
180
- this._error = err instanceof Error ? err.message : String(err);
181
- const announce = this._buildAnnounce();
182
- this._emit(AgentProcessEvents.FAILED, { announce });
183
- this._resolveCompletion();
184
- }
185
- }
186
- async _collectRun(messages) {
187
- let content = '';
188
- let usage;
189
- let errorReason;
190
- // 同步消息到 Agent 上下文
191
- this._agent.context.messages = messages;
192
- for await (const event of this._agent.run(this._abortController?.signal, this._harness)) {
193
- if (event.type === 'assistant_message') {
194
- content = typeof event.message.content === 'string' ? event.message.content : '';
195
- }
196
- // 检测错误退出
197
- if (event.type === 'agent_end' && event.reason === 'error') {
198
- errorReason = event.error instanceof Error ? event.error.message : String(event.error ?? 'Unknown error');
199
- }
200
- }
201
- if (errorReason) {
202
- throw new Error(errorReason);
203
- }
204
- return { content, messages: this._agent.context.messages, usage };
205
- }
206
- _buildAnnounce() {
207
- return {
208
- processId: this.id,
209
- parentId: this.parentId,
210
- agentInfo: this.agentInfo,
211
- state: this._state === 'completed' ? 'completed' : this._state === 'aborted' ? 'aborted' : 'failed',
212
- result: this._result,
213
- error: this._error,
214
- timestamp: Date.now(),
215
- };
216
- }
217
- _resolveCompletion() {
218
- const announce = this._buildAnnounce();
219
- for (const resolver of this._completionResolvers) {
220
- resolver(announce);
221
- }
222
- this._completionResolvers = [];
223
- }
224
- _emit(type, data) {
225
- this._events.emit({
226
- type,
227
- timestamp: Date.now(),
228
- agentId: this.agentInfo.id,
229
- sessionId: this.id,
230
- data,
231
- });
232
- }
233
- _withTimeout(promise, ms) {
234
- return new Promise((resolve, reject) => {
235
- const timer = setTimeout(() => reject(new Error(`Process ${this.id} timeout after ${ms}ms`)), ms);
236
- promise.then((result) => { clearTimeout(timer); resolve(result); }, (err) => { clearTimeout(timer); reject(err); });
237
- });
238
- }
239
- }
240
- // ── 工厂函数 ──
241
- /**
242
- * 创建并启动 AgentProcess
243
- */
244
- export function spawnAgentProcess(config, messages, parentMessages) {
245
- const process = new AgentProcess(config);
246
- process.start(messages, parentMessages);
247
- return process;
248
- }
249
- /**
250
- * 创建 context fork 子进程
251
- *
252
- * 从父进程的消息历史创建子进程,子进程继承父上下文。
253
- */
254
- export function forkAgentProcess(config, messages, parentMessages) {
255
- return spawnAgentProcess({ ...config, forkContext: true }, messages, parentMessages);
256
- }
@@ -1,36 +0,0 @@
1
- /**
2
- * DefaultAgentRegistry — Agent 注册与发现的默认实现
3
- *
4
- * Harness 层组件。实现本域 `agent-registry-types.ts` 的 AgentRegistry。
5
- * 基于内存存储,支持按能力发现、状态管理、关系管理。
6
- *
7
- * 设计原则:
8
- * - 不依赖外部存储
9
- * - 事件驱动:所有变更通过 EventBus 通知
10
- * - 线程安全:操作是同步的,适合单进程场景
11
- */
12
- import type { AgentRegistry, AgentInfo, AgentQuery, AgentRelation, AgentRelationType } from './agent-registry-types.js';
13
- import type { EventBus } from '@octopi-agent/core/primitives/event-bus.js';
14
- /**
15
- * DefaultAgentRegistry
16
- *
17
- * 基于内存的 Agent 注册表实现。
18
- */
19
- export declare class DefaultAgentRegistry implements AgentRegistry {
20
- private _agents;
21
- private _relations;
22
- private _events?;
23
- constructor(events?: EventBus);
24
- register(info: Omit<AgentInfo, 'registeredAt' | 'lastActiveAt'>): void;
25
- unregister(agentId: string): boolean;
26
- get(agentId: string): AgentInfo | undefined;
27
- query(query: AgentQuery): AgentInfo[];
28
- list(): AgentInfo[];
29
- findByCapability(capability: string): AgentInfo[];
30
- updateStatus(agentId: string, status: AgentInfo['status']): void;
31
- touch(agentId: string): void;
32
- addRelation(relation: AgentRelation): void;
33
- removeRelation(from: string, to: string, type?: AgentRelationType): void;
34
- getRelations(agentId: string): AgentRelation[];
35
- private _emit;
36
- }