@octopi-agent/engine 0.65.0 → 0.86.38

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (421) hide show
  1. package/LICENSE +201 -201
  2. package/NOTICE +7 -7
  3. package/README.md +64 -26
  4. package/dist/config-schema/agent.d.ts +89 -1
  5. package/dist/config-schema/agent.js +69 -0
  6. package/dist/config-schema/context.d.ts +23 -4
  7. package/dist/config-schema/context.js +28 -1
  8. package/dist/config-schema/engine.d.ts +285 -9
  9. package/dist/config-schema/engine.js +35 -3
  10. package/dist/config-schema/governance.d.ts +95 -0
  11. package/dist/config-schema/governance.js +91 -0
  12. package/dist/config-schema/models.d.ts +1 -1
  13. package/dist/config-schema/observability.d.ts +6 -0
  14. package/dist/config-schema/observability.js +16 -0
  15. package/dist/config-schema/run.d.ts +10 -0
  16. package/dist/config-schema/run.js +18 -0
  17. package/dist/config-schema/shared.d.ts +10 -0
  18. package/dist/config-schema/shared.js +10 -0
  19. package/dist/config-schema/substrate.d.ts +87 -1
  20. package/dist/config-schema/substrate.js +114 -0
  21. package/dist/config-schema/subsystems.d.ts +1 -1
  22. package/dist/config-schema/subsystems.js +2 -1
  23. package/dist/config.d.ts +249 -7
  24. package/dist/config.js +113 -3
  25. package/dist/harness/activation/compiler.js +3 -0
  26. package/dist/harness/activation/runtime.d.ts +7 -0
  27. package/dist/harness/activation/runtime.js +60 -2
  28. package/dist/harness/activation/sources/agent-signal.d.ts +11 -0
  29. package/dist/harness/activation/sources/agent-signal.js +33 -0
  30. package/dist/harness/activation/types.d.ts +6 -1
  31. package/dist/harness/agent/builder.d.ts +48 -4
  32. package/dist/harness/agent/builder.js +206 -55
  33. package/dist/harness/agent/config-bridge.d.ts +33 -25
  34. package/dist/harness/agent/config-bridge.js +83 -280
  35. package/dist/harness/agent/index.d.ts +3 -1
  36. package/dist/harness/agent/index.js +2 -1
  37. package/dist/harness/agent/tool-purpose.d.ts +38 -0
  38. package/dist/harness/agent/tool-purpose.js +118 -0
  39. package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
  40. package/dist/harness/agent/wire-agent-builder.js +363 -0
  41. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +4 -1
  42. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +14 -8
  43. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
  44. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
  45. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
  46. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
  47. package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
  48. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
  49. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
  50. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
  51. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
  52. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
  53. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
  54. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
  55. package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
  56. package/dist/harness/collaboration/delegation/child-run.js +241 -0
  57. package/dist/harness/collaboration/delegation/index.d.ts +26 -0
  58. package/dist/harness/collaboration/delegation/index.js +25 -0
  59. package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
  60. package/dist/harness/collaboration/delegation/notifier.js +84 -0
  61. package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
  62. package/dist/harness/collaboration/delegation/registry-types.js +61 -0
  63. package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
  64. package/dist/harness/collaboration/delegation/registry.js +220 -0
  65. package/dist/harness/collaboration/delegation/service.d.ts +249 -0
  66. package/dist/harness/collaboration/delegation/service.js +499 -0
  67. package/dist/harness/collaboration/delegation/store.d.ts +155 -0
  68. package/dist/harness/collaboration/delegation/store.js +271 -0
  69. package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
  70. package/dist/harness/collaboration/delegation/transport.js +61 -0
  71. package/dist/harness/collaboration/delegation/types.d.ts +231 -0
  72. package/dist/harness/collaboration/delegation/types.js +70 -0
  73. package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
  74. package/dist/harness/collaboration/delegation/wiring.js +145 -0
  75. package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
  76. package/dist/harness/collaboration/orchestration/index.js +11 -11
  77. package/dist/harness/context/assembler.d.ts +2 -2
  78. package/dist/harness/context/assembler.js +12 -7
  79. package/dist/harness/context/capabilities/compact/engine.js +80 -38
  80. package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
  81. package/dist/harness/context/capabilities/summary/gate.js +2 -2
  82. package/dist/harness/context/capabilities/summary/policies.js +5 -5
  83. package/dist/harness/context/capabilities/summary/registry.js +39 -24
  84. package/dist/harness/context/constitution/default-agents.md +230 -228
  85. package/dist/harness/context/default-context-engine.d.ts +101 -23
  86. package/dist/harness/context/default-context-engine.js +483 -172
  87. package/dist/harness/context/hybrid-compressor.d.ts +3 -3
  88. package/dist/harness/context/hybrid-compressor.js +18 -23
  89. package/dist/harness/context/index.d.ts +5 -1
  90. package/dist/harness/context/index.js +2 -0
  91. package/dist/harness/context/layer-health.js +3 -2
  92. package/dist/harness/context/layer-snapshot.d.ts +4 -0
  93. package/dist/harness/context/layer-snapshot.js +30 -18
  94. package/dist/harness/context/layer-types.d.ts +49 -1
  95. package/dist/harness/context/layer-types.js +72 -4
  96. package/dist/harness/context/layers.d.ts +32 -15
  97. package/dist/harness/context/layers.js +87 -71
  98. package/dist/harness/context/llm-summarizer.d.ts +15 -1
  99. package/dist/harness/context/llm-summarizer.js +107 -56
  100. package/dist/harness/context/message-selector.js +6 -2
  101. package/dist/harness/context/root-instructions.d.ts +72 -0
  102. package/dist/harness/context/root-instructions.js +227 -0
  103. package/dist/harness/context/runtime-datetime.d.ts +34 -7
  104. package/dist/harness/context/runtime-datetime.js +66 -10
  105. package/dist/harness/context/smart-router.d.ts +1 -1
  106. package/dist/harness/context/smart-router.js +1 -1
  107. package/dist/harness/context/system-prompt-assembler.d.ts +33 -0
  108. package/dist/harness/context/system-prompt-assembler.js +78 -7
  109. package/dist/harness/context/token-constants.d.ts +2 -2
  110. package/dist/harness/context/token-constants.js +2 -2
  111. package/dist/harness/context/token-estimate-fns.d.ts +1 -3
  112. package/dist/harness/context/token-estimate-fns.js +2 -4
  113. package/dist/harness/context/token-estimator.d.ts +1 -1
  114. package/dist/harness/context/token-estimator.js +14 -6
  115. package/dist/harness/context/tool-result-aging.d.ts +140 -0
  116. package/dist/harness/context/tool-result-aging.js +331 -0
  117. package/dist/harness/context/tool-result-body.d.ts +10 -0
  118. package/dist/harness/context/tool-result-body.js +27 -0
  119. package/dist/harness/context/turn-envelope.d.ts +123 -0
  120. package/dist/harness/context/turn-envelope.js +188 -0
  121. package/dist/harness/context/types.d.ts +35 -47
  122. package/dist/harness/extension/execution-environment/effect-policy.d.ts +248 -0
  123. package/dist/harness/extension/execution-environment/effect-policy.js +334 -0
  124. package/dist/harness/extension/execution-environment/index.d.ts +18 -2
  125. package/dist/harness/extension/execution-environment/index.js +11 -2
  126. package/dist/harness/extension/execution-environment/memory-undo.d.ts +101 -0
  127. package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
  128. package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
  129. package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
  130. package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
  131. package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
  132. package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
  133. package/dist/harness/extension/execution-environment/sandbox.js +493 -51
  134. package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
  135. package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
  136. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
  137. package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
  138. package/dist/harness/extension/execution-environment/types.d.ts +67 -39
  139. package/dist/harness/extension/execution-environment/types.js +2 -2
  140. package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
  141. package/dist/harness/extension/execution-environment/undo-log.js +627 -0
  142. package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
  143. package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
  144. package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +4 -0
  145. package/dist/harness/extension/plugin-ecosystem/client-tools/index.js +3 -0
  146. package/dist/harness/extension/plugin-ecosystem/client-tools/invoke.d.ts +56 -0
  147. package/dist/harness/extension/plugin-ecosystem/client-tools/invoke.js +281 -0
  148. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +98 -0
  149. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +250 -0
  150. package/dist/harness/extension/plugin-ecosystem/client-tools/stream.d.ts +124 -0
  151. package/dist/harness/extension/plugin-ecosystem/client-tools/stream.js +372 -0
  152. package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +118 -0
  153. package/dist/harness/extension/plugin-ecosystem/client-tools/types.js +8 -0
  154. package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
  155. package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
  156. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
  157. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
  158. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
  159. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
  160. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
  161. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
  162. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
  163. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
  164. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
  165. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
  166. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
  167. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
  168. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
  169. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
  170. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
  171. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
  172. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
  173. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +45 -0
  174. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +136 -0
  175. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
  176. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
  177. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +278 -82
  178. package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
  179. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
  180. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
  181. package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
  182. package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
  183. package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
  184. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
  185. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
  186. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
  187. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
  188. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +239 -61
  189. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
  190. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +554 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
  192. package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
  193. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +2 -0
  194. package/dist/harness/extension/plugin-ecosystem/tools/index.js +2 -0
  195. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
  196. package/dist/harness/extension/plugin-ecosystem/tools/memory.d.ts +11 -1
  197. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +39 -1
  198. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
  199. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
  200. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
  201. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
  202. package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
  203. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
  204. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
  205. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
  206. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
  207. package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
  208. package/dist/harness/governance/credentials/index.d.ts +1 -1
  209. package/dist/harness/governance/credentials/store.d.ts +16 -4
  210. package/dist/harness/governance/credentials/store.js +33 -6
  211. package/dist/harness/governance/credentials/types.d.ts +11 -0
  212. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
  213. package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
  214. package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
  215. package/dist/harness/governance/human-in-the-loop/index.js +3 -3
  216. package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
  217. package/dist/harness/governance/human-in-the-loop/types.js +6 -2
  218. package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
  219. package/dist/harness/governance/security/capability-enforcer.js +31 -8
  220. package/dist/harness/governance/security/degradation.js +5 -7
  221. package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
  222. package/dist/harness/governance/security/risk-evaluator.js +4 -82
  223. package/dist/harness/governance/security/temp-path.d.ts +41 -0
  224. package/dist/harness/governance/security/temp-path.js +117 -0
  225. package/dist/harness/governance/session-acl/index.d.ts +1 -0
  226. package/dist/harness/governance/session-acl/index.js +1 -0
  227. package/dist/harness/governance/session-acl/rights.d.ts +12 -0
  228. package/dist/harness/governance/session-acl/rights.js +89 -7
  229. package/dist/harness/governance/session-acl/seed-roles.js +9 -1
  230. package/dist/harness/governance/session-acl/service.js +21 -29
  231. package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
  232. package/dist/harness/governance/session-acl/tool-rights.js +238 -0
  233. package/dist/harness/governance/session-acl/types.d.ts +22 -0
  234. package/dist/harness/index.d.ts +18 -15
  235. package/dist/harness/index.js +11 -7
  236. package/dist/harness/knowledge/file-index-store.js +11 -11
  237. package/dist/harness/knowledge/grounding.d.ts +2 -1
  238. package/dist/harness/knowledge/grounding.js +6 -3
  239. package/dist/harness/knowledge/index.d.ts +2 -2
  240. package/dist/harness/knowledge/index.js +1 -1
  241. package/dist/harness/knowledge/ingest.js +4 -1
  242. package/dist/harness/knowledge/job-control-state.js +4 -4
  243. package/dist/harness/knowledge/job-control.js +11 -11
  244. package/dist/harness/knowledge/membership-store.js +11 -11
  245. package/dist/harness/knowledge/network-guard.d.ts +61 -4
  246. package/dist/harness/knowledge/network-guard.js +390 -113
  247. package/dist/harness/knowledge/query-service.js +8 -8
  248. package/dist/harness/knowledge/retriever.js +1 -1
  249. package/dist/harness/knowledge/source-store.d.ts +17 -2
  250. package/dist/harness/knowledge/source-store.js +6 -5
  251. package/dist/harness/knowledge/writer-service.d.ts +2 -0
  252. package/dist/harness/knowledge/writer-service.js +14 -13
  253. package/dist/harness/memory/backfill-trigger.d.ts +2 -2
  254. package/dist/harness/memory/backfill-trigger.js +4 -4
  255. package/dist/harness/memory/cognition-decay.d.ts +36 -0
  256. package/dist/harness/memory/cognition-decay.js +55 -0
  257. package/dist/harness/memory/cognition-gates.d.ts +60 -0
  258. package/dist/harness/memory/cognition-gates.js +191 -0
  259. package/dist/harness/memory/cognition-trigger.d.ts +30 -0
  260. package/dist/harness/memory/cognition-trigger.js +41 -0
  261. package/dist/harness/memory/cognition-types.d.ts +1 -1
  262. package/dist/harness/memory/cognition.d.ts +40 -8
  263. package/dist/harness/memory/cognition.js +432 -79
  264. package/dist/harness/memory/conceptualizer.d.ts +66 -0
  265. package/dist/harness/memory/conceptualizer.js +246 -0
  266. package/dist/harness/memory/index.d.ts +17 -2
  267. package/dist/harness/memory/index.js +12 -1
  268. package/dist/harness/memory/sqlite/agent-db.d.ts +9 -0
  269. package/dist/harness/memory/sqlite/agent-db.js +120 -15
  270. package/dist/harness/memory/sqlite/cognition-store.d.ts +55 -16
  271. package/dist/harness/memory/sqlite/cognition-store.js +591 -144
  272. package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
  273. package/dist/harness/memory/sqlite/memory-store.js +14 -4
  274. package/dist/harness/memory/sqlite/wisdom-store.d.ts +33 -14
  275. package/dist/harness/memory/sqlite/wisdom-store.js +257 -44
  276. package/dist/harness/memory/store.d.ts +1 -0
  277. package/dist/harness/memory/store.js +3 -0
  278. package/dist/harness/memory/time-format.d.ts +28 -0
  279. package/dist/harness/memory/time-format.js +52 -0
  280. package/dist/harness/memory/types.d.ts +343 -16
  281. package/dist/harness/memory/types.js +49 -0
  282. package/dist/harness/memory/wisdom-formation.d.ts +101 -0
  283. package/dist/harness/memory/wisdom-formation.js +304 -0
  284. package/dist/harness/memory/wisdom-gates.d.ts +50 -0
  285. package/dist/harness/memory/wisdom-gates.js +204 -0
  286. package/dist/harness/memory/wisdom-policy.d.ts +107 -0
  287. package/dist/harness/memory/wisdom-policy.js +220 -0
  288. package/dist/harness/memory/wisdom-types.d.ts +3 -2
  289. package/dist/harness/memory/wisdom-types.js +2 -2
  290. package/dist/harness/memory/wisdom.d.ts +27 -0
  291. package/dist/harness/memory/wisdom.js +181 -0
  292. package/dist/harness/observability/observer/hub.js +23 -1
  293. package/dist/harness/observability/observer/index.d.ts +2 -2
  294. package/dist/harness/observability/observer/index.js +1 -1
  295. package/dist/harness/observability/observer/types.d.ts +57 -0
  296. package/dist/harness/observability/observer/types.js +118 -9
  297. package/dist/harness/run/agent/agent.d.ts +27 -0
  298. package/dist/harness/run/agent/agent.js +45 -0
  299. package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
  300. package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
  301. package/dist/harness/run/reliability/harness-events.d.ts +4 -0
  302. package/dist/harness/run/reliability/run-agent.js +116 -20
  303. package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
  304. package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
  305. package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
  306. package/dist/harness/run/run-guard/default-run-guard.js +104 -44
  307. package/dist/harness/run/run-scope.d.ts +52 -0
  308. package/dist/harness/run/runner.d.ts +101 -16
  309. package/dist/harness/run/runner.js +557 -158
  310. package/dist/harness/session/attachments/llm-intent.js +17 -17
  311. package/dist/harness/session/history/port.js +1 -0
  312. package/dist/harness/session/in-memory-store.d.ts +1 -0
  313. package/dist/harness/session/in-memory-store.js +22 -1
  314. package/dist/harness/session/index.d.ts +1 -0
  315. package/dist/harness/session/index.js +1 -0
  316. package/dist/harness/session/schedules/index.d.ts +10 -0
  317. package/dist/harness/session/schedules/index.js +10 -0
  318. package/dist/harness/session/schedules/render.d.ts +13 -0
  319. package/dist/harness/session/schedules/render.js +63 -0
  320. package/dist/harness/session/schedules/service.d.ts +179 -0
  321. package/dist/harness/session/schedules/service.js +695 -0
  322. package/dist/harness/session/schedules/store.d.ts +119 -0
  323. package/dist/harness/session/schedules/store.js +323 -0
  324. package/dist/harness/session/schedules/tools.d.ts +39 -0
  325. package/dist/harness/session/schedules/tools.js +442 -0
  326. package/dist/harness/session/schedules/types.d.ts +104 -0
  327. package/dist/harness/session/schedules/types.js +97 -0
  328. package/dist/harness/session/tasks/tools.js +22 -0
  329. package/dist/harness/session/title.d.ts +86 -0
  330. package/dist/harness/session/title.js +268 -0
  331. package/dist/harness/session/types.d.ts +35 -0
  332. package/dist/harness/shared/events/agent-event-map.d.ts +21 -0
  333. package/dist/harness/shared/events/agent-event-map.js +1 -0
  334. package/dist/harness/shared/types/agent-definition.d.ts +23 -0
  335. package/dist/index.d.ts +25 -9
  336. package/dist/index.js +11 -2
  337. package/dist/integration/providers/anthropic.d.ts +10 -0
  338. package/dist/integration/providers/anthropic.js +44 -1
  339. package/dist/integration/providers/openai.d.ts +10 -0
  340. package/dist/integration/providers/openai.js +58 -2
  341. package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
  342. package/dist/integration/providers/wire-dump-diff.js +351 -0
  343. package/dist/integration/providers/wire-dump.d.ts +178 -0
  344. package/dist/integration/providers/wire-dump.js +396 -0
  345. package/dist/integration/storage/jsonl.d.ts +11 -0
  346. package/dist/integration/storage/jsonl.js +148 -39
  347. package/dist/integration/storage/session-index.js +63 -8
  348. package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -0
  349. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -0
  350. package/dist/subsystems/cognition-steward/conceptualize/handler.d.ts +9 -0
  351. package/dist/subsystems/cognition-steward/conceptualize/handler.js +125 -0
  352. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -0
  353. package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -0
  354. package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +12 -0
  355. package/dist/subsystems/cognition-steward/consolidate/handler.js +93 -0
  356. package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
  357. package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -0
  358. package/dist/subsystems/wisdom-steward/evaluate/handler.d.ts +18 -0
  359. package/dist/subsystems/wisdom-steward/evaluate/handler.js +91 -0
  360. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -0
  361. package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -0
  362. package/dist/subsystems/wisdom-steward/formation/handler.d.ts +18 -0
  363. package/dist/subsystems/wisdom-steward/formation/handler.js +212 -0
  364. package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -0
  365. package/dist/subsystems/wisdom-steward/govern/handler.d.ts +17 -0
  366. package/dist/subsystems/wisdom-steward/govern/handler.js +68 -0
  367. package/package.json +115 -115
  368. package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
  369. package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
  370. package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
  371. package/dist/harness/collaboration/multi-agent/index.js +0 -15
  372. package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
  373. package/dist/harness/collaboration/multi-agent/process.js +0 -256
  374. package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
  375. package/dist/harness/collaboration/multi-agent/registry.js +0 -137
  376. package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
  377. package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
  378. package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
  379. package/dist/harness/collaboration/multi-agent/types.js +0 -15
  380. package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
  381. package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
  382. package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
  383. package/dist/harness/collaboration/orchestration/async-task.js +0 -359
  384. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
  385. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
  386. package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
  387. package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
  388. package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
  389. package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
  390. package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
  391. package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
  392. package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
  393. package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
  394. package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
  395. package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
  396. package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
  397. package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
  398. package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
  399. package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
  400. package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
  401. package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
  402. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
  403. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
  404. package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
  405. package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
  406. package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
  407. package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
  408. package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
  409. package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
  410. package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
  411. package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
  412. package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
  413. package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
  414. package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
  415. package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
  416. package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
  417. package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
  418. package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
  419. package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
  420. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
  421. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.js +0 -0
package/package.json CHANGED
@@ -1,115 +1,115 @@
1
- {
2
- "name": "@octopi-agent/engine",
3
- "version": "0.65.0",
4
- "description": "Octopi Engine — Harness product domains, library integrations, and embeddable Agent.run()",
5
- "type": "module",
6
- "license": "Apache-2.0",
7
- "main": "./dist/index.js",
8
- "types": "./dist/index.d.ts",
9
- "exports": {
10
- ".": {
11
- "types": "./dist/index.d.ts",
12
- "import": "./dist/index.js"
13
- },
14
- "./harness": {
15
- "types": "./dist/harness/index.d.ts",
16
- "import": "./dist/harness/index.js"
17
- },
18
- "./harness/orchestration": {
19
- "types": "./dist/harness/collaboration/orchestration/index.d.ts",
20
- "import": "./dist/harness/collaboration/orchestration/index.js"
21
- },
22
- "./integration": {
23
- "types": "./dist/integration/index.d.ts",
24
- "import": "./dist/integration/index.js"
25
- },
26
- "./plugin-sdk/plugin-entry": {
27
- "types": "./dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts",
28
- "import": "./dist/harness/extension/plugin-ecosystem/plugins/entry.js"
29
- },
30
- "./plugin-sdk/api": {
31
- "types": "./dist/harness/extension/plugin-ecosystem/plugins/api.d.ts",
32
- "import": "./dist/harness/extension/plugin-ecosystem/plugins/api.js"
33
- },
34
- "./plugin-sdk/manifest": {
35
- "types": "./dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts",
36
- "import": "./dist/harness/extension/plugin-ecosystem/plugins/manifest.js"
37
- },
38
- "./plugin-sdk/capability": {
39
- "types": "./dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts",
40
- "import": "./dist/harness/extension/plugin-ecosystem/plugins/capability.js"
41
- },
42
- "./plugin-sdk/loader": {
43
- "types": "./dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts",
44
- "import": "./dist/harness/extension/plugin-ecosystem/plugins/loader.js"
45
- },
46
- "./plugin-sdk/manager": {
47
- "types": "./dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts",
48
- "import": "./dist/harness/extension/plugin-ecosystem/plugins/manager.js"
49
- },
50
- "./package.json": "./package.json",
51
- "./harness/*": {
52
- "types": "./dist/harness/*",
53
- "import": "./dist/harness/*"
54
- },
55
- "./integration/*": {
56
- "types": "./dist/integration/*",
57
- "import": "./dist/integration/*"
58
- },
59
- "./config-schema/*": {
60
- "types": "./dist/config-schema/*",
61
- "import": "./dist/config-schema/*"
62
- },
63
- "./*": {
64
- "types": "./dist/*",
65
- "import": "./dist/*"
66
- }
67
- },
68
- "files": [
69
- "dist",
70
- "LICENSE",
71
- "NOTICE",
72
- "README.md"
73
- ],
74
- "scripts": {
75
- "build": "tsc -p tsconfig.json && node ./scripts/copy-engine-assets.mjs",
76
- "dev": "tsc -p tsconfig.json --watch"
77
- },
78
- "engines": {
79
- "node": ">=24"
80
- },
81
- "dependencies": {
82
- "@modelcontextprotocol/sdk": "^1.29.0",
83
- "@octopi-agent/core": "0.65.0",
84
- "js-yaml": "^4.3.2",
85
- "zod": "^4.4.3"
86
- },
87
- "optionalDependencies": {
88
- "fflate": "^0.8.3",
89
- "mammoth": "^1.13.0",
90
- "officeparser": "^8.1.0",
91
- "sqlite-vec": "^0.1.9",
92
- "unpdf": "^1.8.1",
93
- "xlsx": "^0.18.5"
94
- },
95
- "private": false,
96
- "publishConfig": {
97
- "access": "public"
98
- },
99
- "repository": {
100
- "type": "git",
101
- "url": "git+https://github.com/JK-Ai-Era/octopi.git",
102
- "directory": "packages/engine"
103
- },
104
- "homepage": "https://github.com/JK-Ai-Era/octopi#readme",
105
- "bugs": {
106
- "url": "https://github.com/JK-Ai-Era/octopi/issues"
107
- },
108
- "keywords": [
109
- "agent",
110
- "ai",
111
- "llm",
112
- "octopi",
113
- "harness"
114
- ]
115
- }
1
+ {
2
+ "name": "@octopi-agent/engine",
3
+ "version": "0.86.38",
4
+ "description": "Octopi Engine — Harness product domains, library integrations, and embeddable Agent.run()",
5
+ "type": "module",
6
+ "license": "Apache-2.0",
7
+ "main": "./dist/index.js",
8
+ "types": "./dist/index.d.ts",
9
+ "exports": {
10
+ ".": {
11
+ "types": "./dist/index.d.ts",
12
+ "import": "./dist/index.js"
13
+ },
14
+ "./harness": {
15
+ "types": "./dist/harness/index.d.ts",
16
+ "import": "./dist/harness/index.js"
17
+ },
18
+ "./harness/orchestration": {
19
+ "types": "./dist/harness/collaboration/orchestration/index.d.ts",
20
+ "import": "./dist/harness/collaboration/orchestration/index.js"
21
+ },
22
+ "./integration": {
23
+ "types": "./dist/integration/index.d.ts",
24
+ "import": "./dist/integration/index.js"
25
+ },
26
+ "./plugin-sdk/plugin-entry": {
27
+ "types": "./dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts",
28
+ "import": "./dist/harness/extension/plugin-ecosystem/plugins/entry.js"
29
+ },
30
+ "./plugin-sdk/api": {
31
+ "types": "./dist/harness/extension/plugin-ecosystem/plugins/api.d.ts",
32
+ "import": "./dist/harness/extension/plugin-ecosystem/plugins/api.js"
33
+ },
34
+ "./plugin-sdk/manifest": {
35
+ "types": "./dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts",
36
+ "import": "./dist/harness/extension/plugin-ecosystem/plugins/manifest.js"
37
+ },
38
+ "./plugin-sdk/capability": {
39
+ "types": "./dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts",
40
+ "import": "./dist/harness/extension/plugin-ecosystem/plugins/capability.js"
41
+ },
42
+ "./plugin-sdk/loader": {
43
+ "types": "./dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts",
44
+ "import": "./dist/harness/extension/plugin-ecosystem/plugins/loader.js"
45
+ },
46
+ "./plugin-sdk/manager": {
47
+ "types": "./dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts",
48
+ "import": "./dist/harness/extension/plugin-ecosystem/plugins/manager.js"
49
+ },
50
+ "./package.json": "./package.json",
51
+ "./harness/*": {
52
+ "types": "./dist/harness/*",
53
+ "import": "./dist/harness/*"
54
+ },
55
+ "./integration/*": {
56
+ "types": "./dist/integration/*",
57
+ "import": "./dist/integration/*"
58
+ },
59
+ "./config-schema/*": {
60
+ "types": "./dist/config-schema/*",
61
+ "import": "./dist/config-schema/*"
62
+ },
63
+ "./*": {
64
+ "types": "./dist/*",
65
+ "import": "./dist/*"
66
+ }
67
+ },
68
+ "files": [
69
+ "dist",
70
+ "LICENSE",
71
+ "NOTICE",
72
+ "README.md"
73
+ ],
74
+ "scripts": {
75
+ "build": "tsc -p tsconfig.json && node ./scripts/copy-engine-assets.mjs",
76
+ "dev": "tsc -p tsconfig.json --watch"
77
+ },
78
+ "engines": {
79
+ "node": ">=24"
80
+ },
81
+ "dependencies": {
82
+ "@modelcontextprotocol/sdk": "^1.29.0",
83
+ "@octopi-agent/core": "0.86.38",
84
+ "js-yaml": "^4.3.2",
85
+ "zod": "^4.4.3"
86
+ },
87
+ "optionalDependencies": {
88
+ "fflate": "^0.8.3",
89
+ "mammoth": "^1.13.0",
90
+ "officeparser": "^8.1.0",
91
+ "sqlite-vec": "^0.1.9",
92
+ "unpdf": "^1.8.1",
93
+ "xlsx": "^0.18.5"
94
+ },
95
+ "private": false,
96
+ "publishConfig": {
97
+ "access": "public"
98
+ },
99
+ "repository": {
100
+ "type": "git",
101
+ "url": "git+https://github.com/JK-Ai-Era/octopi.git",
102
+ "directory": "packages/engine"
103
+ },
104
+ "homepage": "https://github.com/JK-Ai-Era/octopi#readme",
105
+ "bugs": {
106
+ "url": "https://github.com/JK-Ai-Era/octopi/issues"
107
+ },
108
+ "keywords": [
109
+ "agent",
110
+ "ai",
111
+ "llm",
112
+ "octopi",
113
+ "harness"
114
+ ]
115
+ }
@@ -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;