@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,61 +0,0 @@
1
- /**
2
- * HybridPlanner — 混合规划器
3
- *
4
- * 规则优先,LLM fallback。
5
- * 常见事件用规则快速处理,复杂情况交给 LLM。
6
- *
7
- * 策略:
8
- * 1. 先用 RulePlanner 匹配
9
- * 2. 如果规则匹配且生成了步骤 → 直接使用
10
- * 3. 如果没有匹配的规则 → fallback 到 LLMPlanner
11
- */
12
- import { RulePlanner } from './rule-planner.js';
13
- import { LLMPlanner } from './llm-planner.js';
14
- import { getDefaultRules } from './rule-planner.js';
15
- // ── HybridPlanner ──
16
- /**
17
- * 混合规划器
18
- *
19
- * 规则优先,LLM 兜底。
20
- */
21
- export class HybridPlanner {
22
- name = 'hybrid-planner';
23
- _rulePlanner;
24
- _llmPlanner;
25
- _enableFallback;
26
- constructor(config) {
27
- const rules = config.rules ?? getDefaultRules();
28
- this._rulePlanner = new RulePlanner(rules);
29
- this._llmPlanner = new LLMPlanner(config.llm);
30
- this._enableFallback = config.enableLLMFallback ?? true;
31
- }
32
- /**
33
- * 添加规则
34
- */
35
- addRule(rule) {
36
- this._rulePlanner.addRule(rule);
37
- }
38
- /**
39
- * 分析事件:规则优先,LLM fallback
40
- */
41
- async decide(events, state) {
42
- // 1. 先用规则匹配
43
- const rulePlan = await this._rulePlanner.decide(events, state);
44
- // 2. 如果规则匹配到了步骤,直接使用
45
- if (rulePlan.steps.length > 0) {
46
- return rulePlan;
47
- }
48
- // 3. 没有匹配的规则,fallback 到 LLM
49
- if (this._enableFallback) {
50
- return this._llmPlanner.decide(events, state);
51
- }
52
- // 4. 未启用 fallback,返回空计划
53
- return rulePlan;
54
- }
55
- /**
56
- * 目标分解:直接用 LLM(规则不擅长分解)
57
- */
58
- async decompose(goal, state) {
59
- return this._llmPlanner.decompose(goal, state);
60
- }
61
- }
@@ -1,9 +0,0 @@
1
- /**
2
- * Planner 模块统一导出
3
- */
4
- export { RulePlanner, USER_MESSAGE_RULE, SECURITY_EVENT_RULE, IDLE_RULE, getDefaultRules } from './rule-planner.js';
5
- export type { Rule, RuleCondition, RuleAction } from './rule-planner.js';
6
- export { LLMPlanner } from './llm-planner.js';
7
- export type { LLMPlannerConfig } from './llm-planner.js';
8
- export { HybridPlanner } from './hybrid-planner.js';
9
- export type { HybridPlannerConfig } from './hybrid-planner.js';
@@ -1,6 +0,0 @@
1
- /**
2
- * Planner 模块统一导出
3
- */
4
- export { RulePlanner, USER_MESSAGE_RULE, SECURITY_EVENT_RULE, IDLE_RULE, getDefaultRules } from './rule-planner.js';
5
- export { LLMPlanner } from './llm-planner.js';
6
- export { HybridPlanner } from './hybrid-planner.js';
@@ -1,54 +0,0 @@
1
- /**
2
- * LLMPlanner — LLM 驱动的规划器
3
- *
4
- * 用 LLM 分析事件和状态,决定下一步行动。
5
- * 比规则驱动更灵活,但更慢、更贵。
6
- *
7
- * 适用场景:
8
- * - 复杂的用户请求(需要理解意图)
9
- * - 目标分解(大任务拆成小步骤)
10
- * - 异常情况处理(规则没覆盖的场景)
11
- */
12
- import type { Planner, Plan, AgentState } from '../cognitive-loop.js';
13
- import type { EventBusAgentEvent as AgentEvent } from '@octopi-agent/core/index.js';
14
- import type { ModelProvider } from '@octopi-agent/core/interfaces/model-provider.js';
15
- export interface LLMPlannerConfig {
16
- /** ModelProvider 实例 */
17
- model: ModelProvider;
18
- /** 使用的模型名 */
19
- modelName?: string;
20
- /** 系统提示词 */
21
- systemPrompt?: string;
22
- /** 温度 */
23
- temperature?: number;
24
- /** 最大 token */
25
- maxTokens?: number;
26
- }
27
- /**
28
- * LLM 驱动的规划器
29
- *
30
- * 将事件和状态序列化为 prompt,让 LLM 返回结构化的计划。
31
- */
32
- export declare class LLMPlanner implements Planner {
33
- readonly name = "llm-planner";
34
- private _model;
35
- private _modelName?;
36
- private _systemPrompt;
37
- private _temperature;
38
- private _maxTokens;
39
- constructor(config: LLMPlannerConfig);
40
- /**
41
- * 分析事件,让 LLM 决定下一步
42
- */
43
- decide(events: AgentEvent[], state: AgentState): Promise<Plan>;
44
- /**
45
- * 将目标分解为可执行步骤
46
- */
47
- decompose(goal: string, state: AgentState): Promise<Plan>;
48
- private _buildDecidePrompt;
49
- private _buildDecomposePrompt;
50
- private _callLLM;
51
- private _parsePlan;
52
- private _validateStepType;
53
- private _emptyPlan;
54
- }
@@ -1,167 +0,0 @@
1
- /**
2
- * LLMPlanner — LLM 驱动的规划器
3
- *
4
- * 用 LLM 分析事件和状态,决定下一步行动。
5
- * 比规则驱动更灵活,但更慢、更贵。
6
- *
7
- * 适用场景:
8
- * - 复杂的用户请求(需要理解意图)
9
- * - 目标分解(大任务拆成小步骤)
10
- * - 异常情况处理(规则没覆盖的场景)
11
- */
12
- import { randomUUID } from 'node:crypto';
13
- // ── LLMPlanner ──
14
- /**
15
- * LLM 驱动的规划器
16
- *
17
- * 将事件和状态序列化为 prompt,让 LLM 返回结构化的计划。
18
- */
19
- export class LLMPlanner {
20
- name = 'llm-planner';
21
- _model;
22
- _modelName;
23
- _systemPrompt;
24
- _temperature;
25
- _maxTokens;
26
- constructor(config) {
27
- this._model = config.model;
28
- this._modelName = config.modelName;
29
- this._systemPrompt = config.systemPrompt ?? DEFAULT_PLANNER_PROMPT;
30
- this._temperature = config.temperature ?? 0.3;
31
- this._maxTokens = config.maxTokens ?? 2000;
32
- }
33
- /**
34
- * 分析事件,让 LLM 决定下一步
35
- */
36
- async decide(events, state) {
37
- const prompt = this._buildDecidePrompt(events, state);
38
- const response = await this._callLLM(prompt);
39
- return this._parsePlan(response, 'decide events');
40
- }
41
- /**
42
- * 将目标分解为可执行步骤
43
- */
44
- async decompose(goal, state) {
45
- const prompt = this._buildDecomposePrompt(goal, state);
46
- const response = await this._callLLM(prompt);
47
- return this._parsePlan(response, goal);
48
- }
49
- // ── 内部方法 ──
50
- _buildDecidePrompt(events, state) {
51
- const eventSummary = events.map(e => `- [${e.type}] ${e.data?.content ?? e.data?.description ?? JSON.stringify(e.data ?? {}).slice(0, 200)}`).join('\n');
52
- return `你是一个 Agent 规划器。分析以下事件,决定下一步行动。
53
-
54
- ## 待处理事件
55
- ${eventSummary}
56
-
57
- ## Agent 状态
58
- - 活跃计划: ${state.activePlan ? state.activePlan.goal : '无'}
59
- - 最近执行次数: ${state.stats.totalExecutions}
60
- - 最近错误次数: ${state.stats.totalErrors}
61
-
62
- ## 输出格式
63
- 返回 JSON,格式如下:
64
- {
65
- "goal": "计划目标",
66
- "steps": [
67
- {
68
- "description": "步骤描述",
69
- "type": "llm_call | tool_call | wait | custom",
70
- "params": {}
71
- }
72
- ]
73
- }
74
-
75
- 如果不需要任何行动,返回空 steps 数组。
76
- 只返回 JSON,不要其他文字。`;
77
- }
78
- _buildDecomposePrompt(goal, state) {
79
- return `你是一个 Agent 规划器。将以下目标分解为可执行的步骤。
80
-
81
- ## 目标
82
- ${goal}
83
-
84
- ## Agent 状态
85
- - 最近执行次数: ${state.stats.totalExecutions}
86
-
87
- ## 输出格式
88
- 返回 JSON,格式如下:
89
- {
90
- "goal": "${goal}",
91
- "steps": [
92
- {
93
- "description": "步骤描述",
94
- "type": "llm_call | tool_call | wait | custom",
95
- "params": {}
96
- }
97
- ]
98
- }
99
-
100
- 步骤应该具体、可执行、有序。
101
- 只返回 JSON,不要其他文字。`;
102
- }
103
- async _callLLM(prompt) {
104
- const request = {
105
- messages: [
106
- { role: 'system', content: this._systemPrompt },
107
- { role: 'user', content: prompt },
108
- ],
109
- temperature: this._temperature,
110
- maxTokens: this._maxTokens,
111
- model: this._modelName,
112
- };
113
- const response = await this._model.chat(request);
114
- return response.content;
115
- }
116
- _parsePlan(response, goal) {
117
- try {
118
- // 尝试从响应中提取 JSON
119
- const jsonMatch = response.match(/\{[\s\S]*\}/);
120
- if (!jsonMatch) {
121
- return this._emptyPlan(goal, 'No JSON in response');
122
- }
123
- const parsed = JSON.parse(jsonMatch[0]);
124
- const steps = (parsed.steps ?? []).map((s, i) => ({
125
- id: `step-${randomUUID().slice(0, 8)}`,
126
- description: s.description ?? `Step ${i + 1}`,
127
- type: this._validateStepType(s.type),
128
- params: s.params ?? {},
129
- status: 'pending',
130
- }));
131
- return {
132
- id: `plan-${randomUUID().slice(0, 8)}`,
133
- goal: parsed.goal ?? goal,
134
- steps,
135
- currentStepIndex: 0,
136
- status: 'pending',
137
- createdAt: Date.now(),
138
- };
139
- }
140
- catch {
141
- return this._emptyPlan(goal, 'Failed to parse LLM response');
142
- }
143
- }
144
- _validateStepType(type) {
145
- const valid = ['llm_call', 'tool_call', 'spawn_agent', 'wait', 'custom'];
146
- return valid.includes(type) ? type : 'llm_call';
147
- }
148
- _emptyPlan(goal, reason) {
149
- return {
150
- id: `plan-${randomUUID().slice(0, 8)}`,
151
- goal,
152
- steps: [],
153
- currentStepIndex: 0,
154
- status: 'completed',
155
- createdAt: Date.now(),
156
- };
157
- }
158
- }
159
- // ── 默认系统提示 ──
160
- const DEFAULT_PLANNER_PROMPT = `你是一个 Agent 规划器。你的任务是分析事件并决定 Agent 应该做什么。
161
-
162
- 规则:
163
- 1. 只生成必要的步骤,避免冗余
164
- 2. 每个步骤应该是独立可执行的
165
- 3. 优先使用已有的工具和能力
166
- 4. 遇到不确定的情况,倾向于询问用户而不是猜测
167
- 5. 安全事件需要立即响应`;
@@ -1,85 +0,0 @@
1
- /**
2
- * RulePlanner — 规则驱动的规划器
3
- *
4
- * 用 if-then 规则处理常见事件,不需要 LLM 调用。
5
- * 快速、低成本、可预测。
6
- *
7
- * 适用场景:
8
- * - 用户消息 → 转发给 LLM 引擎处理
9
- * - 定时事件 → 执行预定义任务
10
- * - 安全事件 → 立即响应
11
- * - 子进程回报 → 更新状态
12
- *
13
- * 复杂场景 fallback 到 LLMPlanner。
14
- */
15
- import type { Planner, Plan, PlanStep, AgentState } from '../cognitive-loop.js';
16
- import type { EventBusAgentEvent as AgentEvent } from '@octopi-agent/core/index.js';
17
- /** 规则匹配条件 */
18
- export interface RuleCondition {
19
- /** 事件类型(支持前缀匹配:'user.*' 匹配所有 user 开头的事件) */
20
- eventType?: string | string[];
21
- /** 自定义条件函数 */
22
- custom?: (event: AgentEvent, state: AgentState) => boolean;
23
- }
24
- /** 规则动作 */
25
- export interface RuleAction {
26
- /** 步骤类型 */
27
- type: PlanStep['type'];
28
- /** 步骤描述 */
29
- description: string;
30
- /** 步骤参数 */
31
- params?: Record<string, unknown>;
32
- }
33
- /** 规则 */
34
- export interface Rule {
35
- /** 规则 ID */
36
- id: string;
37
- /** 规则名称 */
38
- name: string;
39
- /** 优先级(数字越大越先执行) */
40
- priority: number;
41
- /** 匹配条件 */
42
- when: RuleCondition;
43
- /** 匹配后生成的步骤 */
44
- then: RuleAction[];
45
- /** 是否只匹配一次 */
46
- once?: boolean;
47
- }
48
- /**
49
- * 规则驱动的规划器
50
- *
51
- * 按优先级遍历规则,第一个匹配的规则生成计划。
52
- */
53
- export declare class RulePlanner implements Planner {
54
- readonly name = "rule-planner";
55
- private _rules;
56
- private _firedOnce;
57
- constructor(rules?: Rule[]);
58
- /**
59
- * 添加规则
60
- */
61
- addRule(rule: Rule): void;
62
- /**
63
- * 移除规则
64
- */
65
- removeRule(ruleId: string): void;
66
- /**
67
- * 分析事件,按规则生成计划
68
- */
69
- decide(events: AgentEvent[], state: AgentState): Promise<Plan>;
70
- /**
71
- * 目标分解 — 规则驱动的规划器不支持目标分解
72
- * 返回单步骤计划,由调用方决定如何处理
73
- */
74
- decompose(goal: string, _state: AgentState): Promise<Plan>;
75
- private _matchRule;
76
- private _matchCondition;
77
- }
78
- /** 用户消息规则:转发给 LLM 引擎 */
79
- export declare const USER_MESSAGE_RULE: Rule;
80
- /** 安全事件规则:立即标记 */
81
- export declare const SECURITY_EVENT_RULE: Rule;
82
- /** 空闲事件规则:无操作 */
83
- export declare const IDLE_RULE: Rule;
84
- /** 获取默认规则集 */
85
- export declare function getDefaultRules(): Rule[];
@@ -1,175 +0,0 @@
1
- /**
2
- * RulePlanner — 规则驱动的规划器
3
- *
4
- * 用 if-then 规则处理常见事件,不需要 LLM 调用。
5
- * 快速、低成本、可预测。
6
- *
7
- * 适用场景:
8
- * - 用户消息 → 转发给 LLM 引擎处理
9
- * - 定时事件 → 执行预定义任务
10
- * - 安全事件 → 立即响应
11
- * - 子进程回报 → 更新状态
12
- *
13
- * 复杂场景 fallback 到 LLMPlanner。
14
- */
15
- import { randomUUID } from 'node:crypto';
16
- // ── RulePlanner ──
17
- /**
18
- * 规则驱动的规划器
19
- *
20
- * 按优先级遍历规则,第一个匹配的规则生成计划。
21
- */
22
- export class RulePlanner {
23
- name = 'rule-planner';
24
- _rules = [];
25
- _firedOnce = new Set();
26
- constructor(rules) {
27
- if (rules) {
28
- this._rules = [...rules].sort((a, b) => b.priority - a.priority);
29
- }
30
- }
31
- /**
32
- * 添加规则
33
- */
34
- addRule(rule) {
35
- this._rules.push(rule);
36
- this._rules.sort((a, b) => b.priority - a.priority);
37
- }
38
- /**
39
- * 移除规则
40
- */
41
- removeRule(ruleId) {
42
- this._rules = this._rules.filter(r => r.id !== ruleId);
43
- }
44
- /**
45
- * 分析事件,按规则生成计划
46
- */
47
- async decide(events, state) {
48
- const steps = [];
49
- for (const event of events) {
50
- const rule = this._matchRule(event, state);
51
- if (rule) {
52
- // 标记 once 规则已触发
53
- if (rule.once) {
54
- this._firedOnce.add(rule.id);
55
- }
56
- // 生成步骤
57
- for (const action of rule.then) {
58
- steps.push({
59
- id: `step-${randomUUID().slice(0, 8)}`,
60
- description: action.description,
61
- type: action.type,
62
- params: {
63
- ...action.params,
64
- triggerEvent: event,
65
- },
66
- status: 'pending',
67
- });
68
- }
69
- }
70
- }
71
- return {
72
- id: `plan-${randomUUID().slice(0, 8)}`,
73
- goal: steps.length > 0 ? 'handle events by rules' : 'no matching rule',
74
- steps,
75
- currentStepIndex: 0,
76
- status: 'pending',
77
- createdAt: Date.now(),
78
- };
79
- }
80
- /**
81
- * 目标分解 — 规则驱动的规划器不支持目标分解
82
- * 返回单步骤计划,由调用方决定如何处理
83
- */
84
- async decompose(goal, _state) {
85
- return {
86
- id: `plan-${randomUUID().slice(0, 8)}`,
87
- goal,
88
- steps: [{
89
- id: `step-${randomUUID().slice(0, 8)}`,
90
- description: goal,
91
- type: 'llm_call',
92
- params: { prompt: goal },
93
- status: 'pending',
94
- }],
95
- currentStepIndex: 0,
96
- status: 'pending',
97
- createdAt: Date.now(),
98
- };
99
- }
100
- // ── 内部方法 ──
101
- _matchRule(event, state) {
102
- for (const rule of this._rules) {
103
- // 跳过已触发的 once 规则
104
- if (rule.once && this._firedOnce.has(rule.id))
105
- continue;
106
- if (this._matchCondition(rule.when, event, state)) {
107
- return rule;
108
- }
109
- }
110
- return null;
111
- }
112
- _matchCondition(condition, event, state) {
113
- // 事件类型匹配
114
- if (condition.eventType) {
115
- const types = Array.isArray(condition.eventType) ? condition.eventType : [condition.eventType];
116
- const matched = types.some(t => {
117
- if (t.endsWith('*')) {
118
- return event.type.startsWith(t.slice(0, -1));
119
- }
120
- return event.type === t;
121
- });
122
- if (!matched)
123
- return false;
124
- }
125
- // 自定义条件
126
- if (condition.custom) {
127
- if (!condition.custom(event, state))
128
- return false;
129
- }
130
- return true;
131
- }
132
- }
133
- // ── 内置规则 ──
134
- /** 用户消息规则:转发给 LLM 引擎 */
135
- export const USER_MESSAGE_RULE = {
136
- id: 'builtin:user-message',
137
- name: 'User Message → LLM',
138
- priority: 100,
139
- when: {
140
- eventType: 'user.message',
141
- },
142
- then: [{
143
- type: 'llm_call',
144
- description: 'Process user message with LLM',
145
- params: {},
146
- }],
147
- };
148
- /** 安全事件规则:立即标记 */
149
- export const SECURITY_EVENT_RULE = {
150
- id: 'builtin:security',
151
- name: 'Security Event → Alert',
152
- priority: 200,
153
- when: {
154
- eventType: ['injection.*', 'policy.*', 'sensitive.*'],
155
- },
156
- then: [{
157
- type: 'custom',
158
- description: 'Handle security event',
159
- params: { action: 'alert' },
160
- }],
161
- };
162
- /** 空闲事件规则:无操作 */
163
- export const IDLE_RULE = {
164
- id: 'builtin:idle',
165
- name: 'Idle → No-op',
166
- priority: 0,
167
- when: {
168
- eventType: 'supervisor.idle',
169
- },
170
- then: [],
171
- };
172
- /** 获取默认规则集 */
173
- export function getDefaultRules() {
174
- return [SECURITY_EVENT_RULE, USER_MESSAGE_RULE, IDLE_RULE];
175
- }
@@ -1,21 +0,0 @@
1
- /**
2
- * Output Error Classifier - 异常分类器
3
- *
4
- * 根据质量检测结果和上下文信息,分类异常类型并推荐恢复策略
5
- */
6
- import type { ErrorClassification, RecoveryConfig } from './types.js';
7
- /**
8
- * Output 异常分类器
9
- */
10
- export declare class OutputErrorClassifier {
11
- private config;
12
- constructor(config?: RecoveryConfig);
13
- /**
14
- * 分类异常
15
- */
16
- classify(qualityResult: unknown, context: unknown): ErrorClassification;
17
- }
18
- /**
19
- * 创建 Output 异常分类器
20
- */
21
- export declare function createOutputErrorClassifier(config?: RecoveryConfig): OutputErrorClassifier;