@octopi-agent/engine 0.70.7 → 0.90.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (390) hide show
  1. package/LICENSE +201 -201
  2. package/NOTICE +7 -7
  3. package/README.md +64 -26
  4. package/dist/config-schema/agent.d.ts +89 -1
  5. package/dist/config-schema/agent.js +81 -5
  6. package/dist/config-schema/context.d.ts +24 -5
  7. package/dist/config-schema/context.js +28 -1
  8. package/dist/config-schema/engine.d.ts +205 -13
  9. package/dist/config-schema/engine.js +31 -2
  10. package/dist/config-schema/governance.d.ts +95 -0
  11. package/dist/config-schema/governance.js +93 -1
  12. package/dist/config-schema/models.d.ts +3 -3
  13. package/dist/config-schema/observability.d.ts +6 -0
  14. package/dist/config-schema/observability.js +16 -0
  15. package/dist/config-schema/run.d.ts +10 -0
  16. package/dist/config-schema/run.js +18 -0
  17. package/dist/config-schema/shared.d.ts +13 -0
  18. package/dist/config-schema/shared.js +22 -0
  19. package/dist/config-schema/substrate.d.ts +2 -2
  20. package/dist/config-schema/subsystems.d.ts +1 -1
  21. package/dist/config-schema/subsystems.js +2 -1
  22. package/dist/config.d.ts +201 -8
  23. package/dist/config.js +105 -3
  24. package/dist/harness/activation/compiler.js +3 -0
  25. package/dist/harness/activation/runtime.d.ts +7 -0
  26. package/dist/harness/activation/runtime.js +60 -2
  27. package/dist/harness/activation/sources/agent-signal.d.ts +11 -0
  28. package/dist/harness/activation/sources/agent-signal.js +33 -0
  29. package/dist/harness/activation/types.d.ts +6 -1
  30. package/dist/harness/agent/builder.d.ts +50 -5
  31. package/dist/harness/agent/builder.js +189 -59
  32. package/dist/harness/agent/config-bridge.d.ts +33 -25
  33. package/dist/harness/agent/config-bridge.js +84 -291
  34. package/dist/harness/agent/index.d.ts +3 -1
  35. package/dist/harness/agent/index.js +2 -1
  36. package/dist/harness/agent/tool-purpose.d.ts +46 -0
  37. package/dist/harness/agent/tool-purpose.js +127 -0
  38. package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
  39. package/dist/harness/agent/wire-agent-builder.js +370 -0
  40. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.d.ts +11 -1
  41. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +11 -1
  42. package/dist/harness/collaboration/autonomous-subsystem/loader.d.ts +13 -0
  43. package/dist/harness/collaboration/autonomous-subsystem/loader.js +16 -1
  44. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +8 -1
  45. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -9
  46. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
  47. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
  48. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
  49. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
  50. package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
  51. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
  52. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
  53. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
  54. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
  55. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
  56. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
  57. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
  58. package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
  59. package/dist/harness/collaboration/delegation/child-run.js +241 -0
  60. package/dist/harness/collaboration/delegation/index.d.ts +26 -0
  61. package/dist/harness/collaboration/delegation/index.js +25 -0
  62. package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
  63. package/dist/harness/collaboration/delegation/notifier.js +84 -0
  64. package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
  65. package/dist/harness/collaboration/delegation/registry-types.js +61 -0
  66. package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
  67. package/dist/harness/collaboration/delegation/registry.js +220 -0
  68. package/dist/harness/collaboration/delegation/service.d.ts +249 -0
  69. package/dist/harness/collaboration/delegation/service.js +499 -0
  70. package/dist/harness/collaboration/delegation/store.d.ts +155 -0
  71. package/dist/harness/collaboration/delegation/store.js +271 -0
  72. package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
  73. package/dist/harness/collaboration/delegation/transport.js +61 -0
  74. package/dist/harness/collaboration/delegation/types.d.ts +231 -0
  75. package/dist/harness/collaboration/delegation/types.js +70 -0
  76. package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
  77. package/dist/harness/collaboration/delegation/wiring.js +145 -0
  78. package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
  79. package/dist/harness/collaboration/orchestration/index.js +11 -11
  80. package/dist/harness/context/assembler.d.ts +2 -2
  81. package/dist/harness/context/assembler.js +12 -7
  82. package/dist/harness/context/capabilities/compact/engine.js +80 -38
  83. package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
  84. package/dist/harness/context/capabilities/summary/registry.js +10 -0
  85. package/dist/harness/context/constitution/default-agents.md +230 -228
  86. package/dist/harness/context/default-context-engine.d.ts +101 -23
  87. package/dist/harness/context/default-context-engine.js +483 -172
  88. package/dist/harness/context/hybrid-compressor.d.ts +3 -3
  89. package/dist/harness/context/hybrid-compressor.js +18 -23
  90. package/dist/harness/context/index.d.ts +5 -1
  91. package/dist/harness/context/index.js +2 -0
  92. package/dist/harness/context/layer-snapshot.d.ts +4 -0
  93. package/dist/harness/context/layer-snapshot.js +30 -18
  94. package/dist/harness/context/layer-types.d.ts +85 -1
  95. package/dist/harness/context/layer-types.js +110 -4
  96. package/dist/harness/context/layers.d.ts +5 -2
  97. package/dist/harness/context/layers.js +11 -5
  98. package/dist/harness/context/llm-summarizer.d.ts +15 -1
  99. package/dist/harness/context/llm-summarizer.js +107 -56
  100. package/dist/harness/context/message-selector.js +6 -2
  101. package/dist/harness/context/root-instructions.d.ts +72 -0
  102. package/dist/harness/context/root-instructions.js +227 -0
  103. package/dist/harness/context/runtime-datetime.d.ts +34 -7
  104. package/dist/harness/context/runtime-datetime.js +66 -10
  105. package/dist/harness/context/smart-router.d.ts +1 -1
  106. package/dist/harness/context/smart-router.js +1 -1
  107. package/dist/harness/context/system-prompt-assembler.d.ts +30 -0
  108. package/dist/harness/context/system-prompt-assembler.js +73 -6
  109. package/dist/harness/context/token-constants.d.ts +2 -2
  110. package/dist/harness/context/token-constants.js +2 -2
  111. package/dist/harness/context/token-estimate-fns.d.ts +1 -3
  112. package/dist/harness/context/token-estimate-fns.js +2 -4
  113. package/dist/harness/context/token-estimator.d.ts +1 -1
  114. package/dist/harness/context/token-estimator.js +14 -6
  115. package/dist/harness/context/tool-result-aging.d.ts +140 -0
  116. package/dist/harness/context/tool-result-aging.js +331 -0
  117. package/dist/harness/context/tool-result-body.d.ts +10 -0
  118. package/dist/harness/context/tool-result-body.js +27 -0
  119. package/dist/harness/context/turn-envelope.d.ts +123 -0
  120. package/dist/harness/context/turn-envelope.js +188 -0
  121. package/dist/harness/context/types.d.ts +35 -47
  122. package/dist/harness/extension/execution-environment/effect-policy.d.ts +258 -0
  123. package/dist/harness/extension/execution-environment/effect-policy.js +358 -0
  124. package/dist/harness/extension/execution-environment/index.d.ts +18 -2
  125. package/dist/harness/extension/execution-environment/index.js +11 -2
  126. package/dist/harness/extension/execution-environment/isolation.js +5 -1
  127. package/dist/harness/extension/execution-environment/memory-undo.d.ts +101 -0
  128. package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
  129. package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
  130. package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
  131. package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
  132. package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
  133. package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
  134. package/dist/harness/extension/execution-environment/sandbox.js +521 -51
  135. package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
  136. package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
  137. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
  138. package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
  139. package/dist/harness/extension/execution-environment/types.d.ts +67 -39
  140. package/dist/harness/extension/execution-environment/types.js +2 -2
  141. package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
  142. package/dist/harness/extension/execution-environment/undo-log.js +627 -0
  143. package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
  144. package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
  145. package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +1 -1
  146. package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +9 -0
  147. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
  148. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
  149. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
  150. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
  151. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
  152. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
  153. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
  154. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
  155. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
  156. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
  157. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
  158. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
  159. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
  160. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
  161. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
  162. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
  163. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
  164. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +51 -0
  165. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +153 -0
  166. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
  167. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
  168. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +277 -81
  169. package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
  170. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
  171. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
  172. package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
  173. package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
  174. package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
  175. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
  176. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
  177. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
  178. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
  179. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +241 -70
  180. package/dist/harness/extension/plugin-ecosystem/tools/git-runner.d.ts +31 -0
  181. package/dist/harness/extension/plugin-ecosystem/tools/git-runner.js +104 -0
  182. package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.d.ts +111 -0
  183. package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.js +197 -0
  184. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
  185. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +463 -0
  186. package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
  187. package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
  188. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +6 -0
  189. package/dist/harness/extension/plugin-ecosystem/tools/index.js +4 -0
  190. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +25 -1
  192. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
  193. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
  194. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
  195. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
  196. package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
  197. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
  198. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
  199. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
  200. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
  201. package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
  202. package/dist/harness/governance/credentials/index.d.ts +1 -1
  203. package/dist/harness/governance/credentials/store.d.ts +16 -4
  204. package/dist/harness/governance/credentials/store.js +33 -6
  205. package/dist/harness/governance/credentials/types.d.ts +11 -0
  206. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
  207. package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
  208. package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
  209. package/dist/harness/governance/human-in-the-loop/index.js +3 -3
  210. package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
  211. package/dist/harness/governance/human-in-the-loop/types.js +6 -2
  212. package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
  213. package/dist/harness/governance/security/capability-enforcer.js +31 -8
  214. package/dist/harness/governance/security/degradation.js +5 -7
  215. package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
  216. package/dist/harness/governance/security/risk-evaluator.js +4 -82
  217. package/dist/harness/governance/security/temp-path.d.ts +41 -0
  218. package/dist/harness/governance/security/temp-path.js +117 -0
  219. package/dist/harness/governance/session-acl/index.d.ts +1 -0
  220. package/dist/harness/governance/session-acl/index.js +1 -0
  221. package/dist/harness/governance/session-acl/rights.d.ts +12 -0
  222. package/dist/harness/governance/session-acl/rights.js +89 -7
  223. package/dist/harness/governance/session-acl/seed-roles.js +9 -1
  224. package/dist/harness/governance/session-acl/service.js +21 -29
  225. package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
  226. package/dist/harness/governance/session-acl/tool-rights.js +238 -0
  227. package/dist/harness/governance/session-acl/types.d.ts +22 -0
  228. package/dist/harness/index.d.ts +16 -12
  229. package/dist/harness/index.js +10 -6
  230. package/dist/harness/knowledge/file-identity.d.ts +8 -0
  231. package/dist/harness/knowledge/file-identity.js +26 -1
  232. package/dist/harness/knowledge/file-index-store.js +11 -11
  233. package/dist/harness/knowledge/grounding.d.ts +2 -1
  234. package/dist/harness/knowledge/grounding.js +8 -5
  235. package/dist/harness/knowledge/index-store.d.ts +31 -4
  236. package/dist/harness/knowledge/index-store.js +121 -39
  237. package/dist/harness/knowledge/index.d.ts +2 -2
  238. package/dist/harness/knowledge/index.js +1 -1
  239. package/dist/harness/knowledge/ingest.d.ts +115 -115
  240. package/dist/harness/knowledge/ingest.js +154 -151
  241. package/dist/harness/knowledge/job-control-state.js +4 -4
  242. package/dist/harness/knowledge/job-control.js +11 -11
  243. package/dist/harness/knowledge/knowledge-serve-child.js +1 -1
  244. package/dist/harness/knowledge/membership-store.js +11 -11
  245. package/dist/harness/knowledge/network-guard.d.ts +61 -4
  246. package/dist/harness/knowledge/network-guard.js +390 -113
  247. package/dist/harness/knowledge/purge.js +4 -1
  248. package/dist/harness/knowledge/query-service.js +3 -3
  249. package/dist/harness/knowledge/writer-service.d.ts +2 -0
  250. package/dist/harness/knowledge/writer-service.js +14 -13
  251. package/dist/harness/memory/backfill-coverage.js +3 -1
  252. package/dist/harness/memory/backfill-trigger.d.ts +2 -2
  253. package/dist/harness/memory/backfill-trigger.js +4 -4
  254. package/dist/harness/memory/index.d.ts +1 -0
  255. package/dist/harness/memory/index.js +1 -0
  256. package/dist/harness/memory/sqlite/agent-db.js +2 -0
  257. package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
  258. package/dist/harness/memory/sqlite/memory-store.js +14 -4
  259. package/dist/harness/memory/sqlite/wisdom-store.js +9 -9
  260. package/dist/harness/memory/store.d.ts +1 -0
  261. package/dist/harness/memory/store.js +3 -0
  262. package/dist/harness/memory/time-format.d.ts +28 -0
  263. package/dist/harness/memory/time-format.js +52 -0
  264. package/dist/harness/memory/types.d.ts +12 -0
  265. package/dist/harness/observability/observer/hub.js +53 -2
  266. package/dist/harness/observability/observer/index.d.ts +2 -2
  267. package/dist/harness/observability/observer/index.js +1 -1
  268. package/dist/harness/observability/observer/types.d.ts +80 -0
  269. package/dist/harness/observability/observer/types.js +118 -9
  270. package/dist/harness/run/agent/agent.d.ts +18 -0
  271. package/dist/harness/run/agent/agent.js +26 -0
  272. package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
  273. package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
  274. package/dist/harness/run/reliability/harness-events.d.ts +4 -0
  275. package/dist/harness/run/reliability/run-agent.js +110 -18
  276. package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
  277. package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
  278. package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
  279. package/dist/harness/run/run-guard/default-run-guard.js +104 -44
  280. package/dist/harness/run/run-scope.d.ts +52 -0
  281. package/dist/harness/run/runner.d.ts +117 -16
  282. package/dist/harness/run/runner.js +668 -157
  283. package/dist/harness/session/attachments/llm-intent.js +17 -17
  284. package/dist/harness/session/history/port.js +16 -5
  285. package/dist/harness/session/in-memory-store.d.ts +6 -0
  286. package/dist/harness/session/in-memory-store.js +55 -3
  287. package/dist/harness/session/schedules/index.d.ts +10 -0
  288. package/dist/harness/session/schedules/index.js +10 -0
  289. package/dist/harness/session/schedules/render.d.ts +13 -0
  290. package/dist/harness/session/schedules/render.js +63 -0
  291. package/dist/harness/session/schedules/service.d.ts +179 -0
  292. package/dist/harness/session/schedules/service.js +695 -0
  293. package/dist/harness/session/schedules/store.d.ts +119 -0
  294. package/dist/harness/session/schedules/store.js +323 -0
  295. package/dist/harness/session/schedules/tools.d.ts +39 -0
  296. package/dist/harness/session/schedules/tools.js +442 -0
  297. package/dist/harness/session/schedules/types.d.ts +104 -0
  298. package/dist/harness/session/schedules/types.js +97 -0
  299. package/dist/harness/session/tasks/tools.js +22 -0
  300. package/dist/harness/session/title.js +25 -9
  301. package/dist/harness/session/types.d.ts +35 -0
  302. package/dist/harness/shared/events/agent-event-map.d.ts +39 -0
  303. package/dist/harness/shared/events/agent-event-map.js +2 -0
  304. package/dist/harness/shared/types/agent-definition.d.ts +23 -0
  305. package/dist/index.d.ts +25 -9
  306. package/dist/index.js +11 -2
  307. package/dist/integration/observability/run-telemetry.d.ts +8 -0
  308. package/dist/integration/observability/run-telemetry.js +31 -8
  309. package/dist/integration/observability/trace-collector.js +26 -4
  310. package/dist/integration/observability/trace-events.d.ts +1 -0
  311. package/dist/integration/observability/trace-events.js +2 -0
  312. package/dist/integration/observability/trace-logger.js +27 -17
  313. package/dist/integration/providers/anthropic.d.ts +10 -0
  314. package/dist/integration/providers/anthropic.js +44 -1
  315. package/dist/integration/providers/openai.d.ts +10 -0
  316. package/dist/integration/providers/openai.js +58 -2
  317. package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
  318. package/dist/integration/providers/wire-dump-diff.js +351 -0
  319. package/dist/integration/providers/wire-dump.d.ts +178 -0
  320. package/dist/integration/providers/wire-dump.js +396 -0
  321. package/dist/integration/storage/jsonl.d.ts +29 -0
  322. package/dist/integration/storage/jsonl.js +243 -41
  323. package/dist/integration/storage/session-index.js +63 -8
  324. package/dist/paths.d.ts +19 -0
  325. package/dist/paths.js +38 -1
  326. package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -43
  327. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -50
  328. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -6
  329. package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -54
  330. package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
  331. package/dist/subsystems/safety-guard/config.yaml +3 -1
  332. package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -50
  333. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -42
  334. package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -54
  335. package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -55
  336. package/package.json +115 -115
  337. package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
  338. package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
  339. package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
  340. package/dist/harness/collaboration/multi-agent/index.js +0 -15
  341. package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
  342. package/dist/harness/collaboration/multi-agent/process.js +0 -256
  343. package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
  344. package/dist/harness/collaboration/multi-agent/registry.js +0 -137
  345. package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
  346. package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
  347. package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
  348. package/dist/harness/collaboration/multi-agent/types.js +0 -15
  349. package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
  350. package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
  351. package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
  352. package/dist/harness/collaboration/orchestration/async-task.js +0 -359
  353. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
  354. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
  355. package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
  356. package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
  357. package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
  358. package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
  359. package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
  360. package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
  361. package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
  362. package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
  363. package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
  364. package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
  365. package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
  366. package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
  367. package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
  368. package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
  369. package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
  370. package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
  371. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
  372. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
  373. package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
  374. package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
  375. package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
  376. package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
  377. package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
  378. package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
  379. package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
  380. package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
  381. package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
  382. package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
  383. package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
  384. package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
  385. package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
  386. package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
  387. package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
  388. package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
  389. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
  390. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.js +0 -0
@@ -0,0 +1,133 @@
1
+ /**
2
+ * wireAgentBuilder — 配置 → AgentBuilder 的唯一组装入口
3
+ *
4
+ * 设计约定:
5
+ * - 产品(Gateway)与库嵌入(config-bridge)**都只调用本函数**,禁止各自维护第二套接线清单。
6
+ * - 本函数覆盖「标准配置」:模型档 / summarize / contextEngine / security / budget /
7
+ * runGuard / persona / skills / memory stores / subsystems / toolIsolation / effectPolicy。
8
+ * - 宿主适配(circuit breaker、WS、approval 门禁、Knowledge Service、委派…)在 wire **之后**
9
+ * 由宿主自己叠加,不进本文件。
10
+ * - 不做双轨/兼容层:漏接线即 bug,由契约测试锁两路径能力一致。
11
+ *
12
+ * @module harness/agent/wire-agent-builder
13
+ */
14
+ import type { ModelProvider } from '@octopi-agent/core/interfaces/model-provider.js';
15
+ import type { SecurityGuardConfig } from '@octopi-agent/core/security-guard.js';
16
+ import type { ErrorStrategy } from '@octopi-agent/core/interfaces/error-strategy.js';
17
+ import type { ContextEngineConfig, BudgetPolicyJsonConfig, RunGuardJsonConfig, ModelCallConfig, LevelMap, ModelsConfig, HarnessConfig } from '../../config.js';
18
+ import type { SubsystemSpec } from '../collaboration/autonomous-subsystem/types.js';
19
+ import type { BudgetPolicyConfig } from '../run/budget/budget.js';
20
+ import type { SessionAwareRunnerConfig } from '../run/runner.js';
21
+ import type { EffectPolicyConfig } from '../extension/execution-environment/effect-policy.js';
22
+ import { DefaultRunGuard } from '../run/run-guard/default-run-guard.js';
23
+ import type { ContextEngine } from '../context/types.js';
24
+ import type { AgentBuilder } from './builder.js';
25
+ /**
26
+ * 解析子系统审计目录(docs/autonomous-subsystem.md §10)
27
+ *
28
+ * - `false` → 关闭审计(返回 undefined,不接 AuditWriter)
29
+ * - 字符串 → 显式目录
30
+ * - 缺省 → `<OCTOPI_HOME>/audit`(`OCTOPI_HOME` env 可重定向,测试可隔离)
31
+ *
32
+ * @param configured - 配置值(`subsystems.auditDir`)
33
+ * @returns 审计目录;undefined = 显式关闭
34
+ */
35
+ export declare function resolveSubsystemAuditDir(configured: string | false | undefined): string | undefined;
36
+ /**
37
+ * 从配置中解析安全策略(始终返回;无总开关)
38
+ *
39
+ * 硬边界与 ToolCallRiskPolicy 由 Guard/Builder 保证接线,
40
+ * 这里只归一化处置、范围与灵敏度。
41
+ *
42
+ * @param config - Harness 配置
43
+ * @returns 安全策略
44
+ */
45
+ export declare function resolveSecurityConfig(config: {
46
+ security?: HarnessConfig['security'];
47
+ }): SecurityGuardConfig;
48
+ /**
49
+ * 从配置中创建 ContextEngine 实例
50
+ *
51
+ * @param config - contextEngine 配置(可空)
52
+ * @returns ContextEngine
53
+ */
54
+ export declare function resolveContextEngine(config: ContextEngineConfig | undefined): ContextEngine;
55
+ /**
56
+ * 从配置中解析 RunGuard
57
+ *
58
+ * 解析 llmModel 字段:
59
+ * - "model" → 使用主 provider
60
+ * - "provider/model" → 使用指定 provider
61
+ *
62
+ * @param config - runGuard JSON 配置
63
+ * @param providers - 可用 provider 映射
64
+ * @returns RunGuard 或 undefined(禁用时)
65
+ */
66
+ export declare function resolveRunGuard(config: RunGuardJsonConfig | undefined, providers: Map<string, ModelProvider>): DefaultRunGuard | undefined;
67
+ /**
68
+ * 标准组装输入。宿主先解析好 model provider(可包 circuit breaker / fallback),
69
+ * 再把其余配置块交给本函数。
70
+ */
71
+ export interface AgentWireSpec {
72
+ /** 已解析/已包装的主模型 provider */
73
+ model: ModelProvider;
74
+ agentId: string;
75
+ workspace?: string;
76
+ /** agent 文件态持久目录(persona/skills) */
77
+ home?: string;
78
+ /** 文件式 persona 目录,或内联 systemPrompt */
79
+ persona?: string | {
80
+ systemPrompt?: string;
81
+ };
82
+ skillDirectory?: string;
83
+ /** SEC-2 / E6 工具策略与会话权利天花板 */
84
+ tools?: import('@octopi-agent/core/types.js').ToolPolicy;
85
+ maxSessionRights?: SessionAwareRunnerConfig['agentMaxSessionRights'];
86
+ effectPolicy?: EffectPolicyConfig;
87
+ toolIsolation?: HarnessConfig['toolIsolation'];
88
+ sessionIdleExpiryMs?: number;
89
+ modelCallTimeouts?: ModelCallConfig;
90
+ /** 可用 provider 映射(summarize / runGuard / subsystems) */
91
+ providers: Map<string, ModelProvider>;
92
+ levelMap?: LevelMap;
93
+ modelsConfig?: {
94
+ providers?: ModelsConfig['providers'];
95
+ embedding?: ModelsConfig['embedding'];
96
+ };
97
+ contextEngineConfig?: ContextEngineConfig;
98
+ contextAssemblerConfig?: HarnessConfig['contextAssembler'];
99
+ constitutionConfig?: HarnessConfig['constitution'];
100
+ memoryConfig?: HarnessConfig['memory'];
101
+ cognitionConfig?: HarnessConfig['cognition'];
102
+ wisdomConfig?: HarnessConfig['wisdom'];
103
+ securityConfig?: SecurityGuardConfig;
104
+ /** budget 旋钮(JSON 面或 Builder BudgetPolicyConfig 局部) */
105
+ budgetConfig?: BudgetPolicyJsonConfig | Partial<BudgetPolicyConfig>;
106
+ runGuardConfig?: RunGuardJsonConfig;
107
+ /** 并发控制(ProviderPool / SessionGate);与 config-bridge 同源 */
108
+ concurrencyConfig?: HarnessConfig['concurrency'];
109
+ subsystemSpecs?: SubsystemSpec[];
110
+ /** 审计目录;缺省 `<OCTOPI_HOME>/audit`,`false` 显式关闭 */
111
+ subsystemAuditDir?: string | false;
112
+ subsystemAllowlist?: string[];
113
+ subsystemDenylist?: string[];
114
+ /**
115
+ * 宿主 runner 附加项(session lease / ACL / attachment 等)。
116
+ * 与标准字段合并;冲突时宿主值覆盖标准值。
117
+ */
118
+ extraRunnerConfig?: Partial<SessionAwareRunnerConfig>;
119
+ /** 覆盖默认错误策略(缺省不设,用 Builder 内建) */
120
+ errorStrategy?: ErrorStrategy;
121
+ }
122
+ /**
123
+ * 将标准配置接到 AgentBuilder 上。不调用 `build()`——由宿主在叠加完适配层后 build。
124
+ *
125
+ * @param builder - 目标 builder(宿主可已注入 store/events/model)
126
+ * @param spec - 标准组装输入
127
+ */
128
+ export declare function wireAgentBuilder(builder: AgentBuilder, spec: AgentWireSpec): Promise<{
129
+ memoryStore?: unknown;
130
+ skillManager?: unknown;
131
+ }>;
132
+ /** 显式 specs 时是否仍允许 builder 自动发现(防双载) */
133
+ export declare function shouldAutoLoadSubsystems(spec: Pick<AgentWireSpec, 'subsystemSpecs'>): boolean;
@@ -0,0 +1,370 @@
1
+ /**
2
+ * wireAgentBuilder — 配置 → AgentBuilder 的唯一组装入口
3
+ *
4
+ * 设计约定:
5
+ * - 产品(Gateway)与库嵌入(config-bridge)**都只调用本函数**,禁止各自维护第二套接线清单。
6
+ * - 本函数覆盖「标准配置」:模型档 / summarize / contextEngine / security / budget /
7
+ * runGuard / persona / skills / memory stores / subsystems / toolIsolation / effectPolicy。
8
+ * - 宿主适配(circuit breaker、WS、approval 门禁、Knowledge Service、委派…)在 wire **之后**
9
+ * 由宿主自己叠加,不进本文件。
10
+ * - 不做双轨/兼容层:漏接线即 bug,由契约测试锁两路径能力一致。
11
+ *
12
+ * @module harness/agent/wire-agent-builder
13
+ */
14
+ import { existsSync } from 'node:fs';
15
+ import { join } from 'node:path';
16
+ import { expandHomePath } from '../../paths.js';
17
+ import { getOctopiHome } from '../../paths.js';
18
+ import { DefaultRunGuard, } from '../run/run-guard/default-run-guard.js';
19
+ import { DefaultContextEngine } from '../context/default-context-engine.js';
20
+ import { DefaultBudgetAllocator } from '../context/budget-allocator.js';
21
+ // ── 配置解析(唯一实现;供 wire 与公开导出共用) ──
22
+ /**
23
+ * 解析子系统审计目录(docs/autonomous-subsystem.md §10)
24
+ *
25
+ * - `false` → 关闭审计(返回 undefined,不接 AuditWriter)
26
+ * - 字符串 → 显式目录
27
+ * - 缺省 → `<OCTOPI_HOME>/audit`(`OCTOPI_HOME` env 可重定向,测试可隔离)
28
+ *
29
+ * @param configured - 配置值(`subsystems.auditDir`)
30
+ * @returns 审计目录;undefined = 显式关闭
31
+ */
32
+ export function resolveSubsystemAuditDir(configured) {
33
+ if (configured === false)
34
+ return undefined;
35
+ return configured ?? join(getOctopiHome(), 'audit');
36
+ }
37
+ /**
38
+ * 从配置中解析安全策略(始终返回;无总开关)
39
+ *
40
+ * 硬边界与 ToolCallRiskPolicy 由 Guard/Builder 保证接线,
41
+ * 这里只归一化处置、范围与灵敏度。
42
+ *
43
+ * @param config - Harness 配置
44
+ * @returns 安全策略
45
+ */
46
+ export function resolveSecurityConfig(config) {
47
+ const security = config.security ?? {};
48
+ return {
49
+ enforce: security.enforce ?? 'block',
50
+ injectionSensitivity: security.injectionSensitivity ?? 'medium',
51
+ allowedPaths: security.allowedPaths ?? [],
52
+ };
53
+ }
54
+ /**
55
+ * 从配置中创建 ContextEngine 实例
56
+ *
57
+ * @param config - contextEngine 配置(可空)
58
+ * @returns ContextEngine
59
+ */
60
+ export function resolveContextEngine(config) {
61
+ // 缺省 type = default:只给旋钮(如 proactiveCompactRatio)也必须落到默认引擎
62
+ if (!config || config.type == null || config.type === 'default') {
63
+ return new DefaultContextEngine({
64
+ protectFirstN: config?.protectFirstN ?? 3,
65
+ protectLastN: config?.protectLastN ?? 20,
66
+ proactiveCompactRatio: config?.proactiveCompactRatio ?? 0.6,
67
+ proactiveCooldownMs: config?.proactiveCooldownMs ?? 30_000,
68
+ historyAging: config?.historyAging,
69
+ targetTokens: config?.targetTokens,
70
+ compactFallbackRatio: config?.compactFallbackRatio,
71
+ budgetAllocator: new DefaultBudgetAllocator({
72
+ outputRatio: config?.outputRatio ?? 0.20,
73
+ minOutputReserve: config?.minOutputReserve ?? 2000,
74
+ maxOutputReserve: config?.maxOutputReserve ?? 8000,
75
+ }),
76
+ });
77
+ }
78
+ throw new Error(`Unknown context engine type: ${config.type}`);
79
+ }
80
+ /**
81
+ * 从配置中解析 RunGuard
82
+ *
83
+ * 解析 llmModel 字段:
84
+ * - "model" → 使用主 provider
85
+ * - "provider/model" → 使用指定 provider
86
+ *
87
+ * @param config - runGuard JSON 配置
88
+ * @param providers - 可用 provider 映射
89
+ * @returns RunGuard 或 undefined(禁用时)
90
+ */
91
+ export function resolveRunGuard(config, providers) {
92
+ if (!config || config.enabled === false)
93
+ return undefined;
94
+ let reviewModel;
95
+ if (config.llmModel) {
96
+ const parts = config.llmModel.split('/');
97
+ if (parts.length === 2) {
98
+ reviewModel = providers.get(parts[0]);
99
+ config = { ...config, llmModel: parts[1] };
100
+ }
101
+ else {
102
+ reviewModel = providers.values().next().value;
103
+ }
104
+ }
105
+ const runGuardConfig = {
106
+ enabled: true,
107
+ checkpointInterval: config.checkpointInterval,
108
+ minCheckpointInterval: config.minCheckpointInterval,
109
+ maxCheckpointInterval: config.maxCheckpointInterval,
110
+ enableLLMReview: config.enableLLMReview,
111
+ llmReviewInterval: config.llmReviewInterval,
112
+ llmModel: config.llmModel,
113
+ hardLimit: config.hardLimit,
114
+ hardWallClockMs: config.hardWallClockMs,
115
+ };
116
+ return new DefaultRunGuard(runGuardConfig, reviewModel);
117
+ }
118
+ /**
119
+ * 将标准配置接到 AgentBuilder 上。不调用 `build()`——由宿主在叠加完适配层后 build。
120
+ *
121
+ * @param builder - 目标 builder(宿主可已注入 store/events/model)
122
+ * @param spec - 标准组装输入
123
+ */
124
+ export async function wireAgentBuilder(builder, spec) {
125
+ // ── Model ──
126
+ builder.model(spec.model);
127
+ // ── Model call watchdog ──
128
+ if (spec.modelCallTimeouts) {
129
+ builder.modelCallTimeouts(spec.modelCallTimeouts);
130
+ }
131
+ // ── Model Levels(子系统 think.model / 摘要选型共用) ──
132
+ if (spec.levelMap) {
133
+ builder.withModelLevels(spec.levelMap);
134
+ }
135
+ // ── Providers 映射(子系统 provider/model 解析用;缺 provider 回退主模型) ──
136
+ builder.providers(spec.providers);
137
+ // ── 并发控制(ProviderPool / SessionGate) ──
138
+ if (spec.concurrencyConfig) {
139
+ builder.concurrency(spec.concurrencyConfig);
140
+ }
141
+ // ── Workspace ──
142
+ if (spec.workspace) {
143
+ builder.workspace(spec.workspace);
144
+ }
145
+ // ── Tool isolation (I5) ──
146
+ if (spec.toolIsolation) {
147
+ builder.toolIsolation(spec.toolIsolation);
148
+ }
149
+ // ── EffectPolicy (P3) ──
150
+ if (spec.effectPolicy) {
151
+ builder.effectPolicy(spec.effectPolicy);
152
+ }
153
+ // ── Runner:标准字段 + 宿主附加 ──
154
+ const runnerConfig = {
155
+ ...(spec.sessionIdleExpiryMs && spec.sessionIdleExpiryMs > 0
156
+ ? { idleExpiryMs: spec.sessionIdleExpiryMs }
157
+ : {}),
158
+ ...(spec.tools ? { agentToolPolicy: spec.tools } : {}),
159
+ ...(spec.maxSessionRights !== undefined
160
+ ? { agentMaxSessionRights: spec.maxSessionRights }
161
+ : {}),
162
+ ...(spec.extraRunnerConfig ?? {}),
163
+ };
164
+ if (Object.keys(runnerConfig).length > 0) {
165
+ builder.runnerConfig(runnerConfig);
166
+ }
167
+ // ── Home / Persona / Skills ──
168
+ // stores 只跟显式 home 走;string persona 只作 prompt 目录,不隐式开 agent.db
169
+ //(config-bridge 需要 legacy persona-as-home 时应显式传 home)。
170
+ // home/skillDirectory 在库边界展开 `~`(幂等):`join()` 与 agent.db 路径都以它为基,
171
+ // 留一个未展开的 `~` 就会在进程 cwd 下建出字面 `~/…` 目录。
172
+ const agentHome = spec.home ? expandHomePath(spec.home.trim()) : undefined;
173
+ // agentId 无条件接线(审计分区 / 工具域对称);home 只决定 agent 文件态目录
174
+ builder.agentId(spec.agentId);
175
+ if (spec.home) {
176
+ builder.agentHome(spec.home);
177
+ }
178
+ if (typeof spec.persona === 'string') {
179
+ builder.persona(spec.persona);
180
+ }
181
+ else if (spec.persona?.systemPrompt) {
182
+ builder.systemPrompt(spec.persona.systemPrompt);
183
+ }
184
+ else if (agentHome) {
185
+ builder.persona(agentHome);
186
+ }
187
+ const skillDir = spec.skillDirectory
188
+ ? expandHomePath(spec.skillDirectory.trim())
189
+ : agentHome
190
+ ? join(agentHome, 'skills')
191
+ : undefined;
192
+ let skillManager;
193
+ if (skillDir && existsSync(skillDir)) {
194
+ try {
195
+ const { DefaultSkillManager } = await import('../extension/plugin-ecosystem/skills/manager.js');
196
+ skillManager = new DefaultSkillManager();
197
+ await skillManager.discover(skillDir);
198
+ builder.skills(skillManager);
199
+ }
200
+ catch (err) {
201
+ console.warn(`[AgentWire] skill discover failed for ${skillDir}: ${err instanceof Error ? err.message : String(err)}`);
202
+ skillManager = undefined;
203
+ }
204
+ // 无 manager 时 builder 仍可用目录兜底
205
+ builder.skillDirectory(skillDir);
206
+ }
207
+ // ── Memory / Wisdom / Cognition(agent home 下 AgentDatabase) ──
208
+ let memoryStore;
209
+ if (agentHome) {
210
+ const stores = await wireContextStores(builder, {
211
+ agentHome,
212
+ modelsConfig: spec.modelsConfig,
213
+ memoryConfig: spec.memoryConfig,
214
+ wisdomConfig: spec.wisdomConfig,
215
+ cognitionConfig: spec.cognitionConfig,
216
+ });
217
+ memoryStore = stores.memoryStore;
218
+ }
219
+ // ── Security(策略与 RiskPolicy 始终接线) ──
220
+ builder.securityPolicy(spec.securityConfig ?? {});
221
+ const { DefaultToolCallRiskPolicy } = await import('../governance/security/default-risk-policy.js');
222
+ builder.withRiskPolicy(new DefaultToolCallRiskPolicy({ cwd: spec.workspace }));
223
+ // ── Budget + wrap-up / policy units ──
224
+ if (spec.budgetConfig) {
225
+ wireBudget(builder, spec.budgetConfig);
226
+ }
227
+ // ── Context Engine(缺省也接线:配置面必须有唯一出口) ──
228
+ builder.contextEngine(resolveContextEngine(spec.contextEngineConfig));
229
+ // ── Context Assembler / Constitution / Memory policy ──
230
+ if (spec.contextAssemblerConfig) {
231
+ builder.contextAssembler(spec.contextAssemblerConfig);
232
+ }
233
+ if (spec.constitutionConfig !== undefined) {
234
+ builder.constitution(spec.constitutionConfig);
235
+ }
236
+ if (spec.memoryConfig) {
237
+ builder.memoryConfig(spec.memoryConfig);
238
+ }
239
+ // ── summarize:与会话同模型(前缀缓存同域)──
240
+ // 不自动切 summary/mini:换 provider/model = 换缓存域,全量历史冷 prefill。
241
+ // 显式 builder.summarize() 仍可覆盖;缺省走 AgentBuilder 的 session 模型路径。
242
+ // ── RunGuard ──
243
+ if (spec.runGuardConfig?.enabled !== false) {
244
+ const guard = resolveRunGuard(spec.runGuardConfig, spec.providers);
245
+ if (guard) {
246
+ builder.runGuard(guard);
247
+ }
248
+ if (spec.runGuardConfig?.checkpointInterval !== undefined) {
249
+ builder.reliability({
250
+ checkpointInterval: spec.runGuardConfig.checkpointInterval,
251
+ });
252
+ }
253
+ }
254
+ // ── Subsystems ──
255
+ if (spec.subsystemSpecs && spec.subsystemSpecs.length > 0) {
256
+ for (const s of spec.subsystemSpecs) {
257
+ builder.withSubsystem(s);
258
+ }
259
+ }
260
+ const auditDir = resolveSubsystemAuditDir(spec.subsystemAuditDir);
261
+ if (auditDir) {
262
+ builder.withSubsystemAuditDir(auditDir);
263
+ }
264
+ if (spec.subsystemAllowlist?.length) {
265
+ builder.subsystemAllowlist(...spec.subsystemAllowlist);
266
+ }
267
+ if (spec.subsystemDenylist?.length) {
268
+ builder.subsystemDenylist(...spec.subsystemDenylist);
269
+ }
270
+ if (spec.errorStrategy) {
271
+ builder.errorStrategy(spec.errorStrategy);
272
+ }
273
+ return { memoryStore, skillManager };
274
+ }
275
+ /** 显式 specs 时是否仍允许 builder 自动发现(防双载) */
276
+ export function shouldAutoLoadSubsystems(spec) {
277
+ return (spec.subsystemSpecs?.length ?? 0) === 0;
278
+ }
279
+ // ── 内部 ──
280
+ function wireBudget(builder, budgetConfig) {
281
+ const engineConfig = {
282
+ maxWallClockMs: budgetConfig.maxWallClockMs,
283
+ maxIterations: budgetConfig.maxIterations,
284
+ maxToolCalls: budgetConfig.maxToolCalls,
285
+ };
286
+ builder.budget(engineConfig);
287
+ const wrapUpConfig = {};
288
+ if ('wrapUpTurns' in budgetConfig && budgetConfig.wrapUpTurns !== undefined) {
289
+ wrapUpConfig.turns = budgetConfig.wrapUpTurns;
290
+ }
291
+ if ('onPolicyHit' in budgetConfig && budgetConfig.onPolicyHit !== undefined) {
292
+ wrapUpConfig.onPolicyHit = budgetConfig.onPolicyHit;
293
+ }
294
+ if ('contextWrapUpRatio' in budgetConfig && budgetConfig.contextWrapUpRatio !== undefined) {
295
+ wrapUpConfig.contextRatio = budgetConfig.contextWrapUpRatio;
296
+ }
297
+ const policyUnits = 'units' in budgetConfig ? budgetConfig.units : undefined;
298
+ const policyPricing = 'pricing' in budgetConfig ? budgetConfig.pricing : undefined;
299
+ const advisory = 'advisory' in budgetConfig ? budgetConfig.advisory : undefined;
300
+ if (Object.keys(wrapUpConfig).length > 0 || policyUnits || policyPricing || advisory) {
301
+ builder.reliability({
302
+ wrapUp: Object.keys(wrapUpConfig).length > 0
303
+ ? wrapUpConfig
304
+ : undefined,
305
+ policyUnits: policyUnits
306
+ ? {
307
+ maxCost: policyUnits.maxCost,
308
+ maxUncachedInputTokens: policyUnits.maxUncachedInputTokens,
309
+ maxOutputTokens: policyUnits.maxOutputTokens,
310
+ maxLlmCalls: policyUnits.maxLlmCalls,
311
+ }
312
+ : undefined,
313
+ policyPricing,
314
+ advisory: advisory,
315
+ });
316
+ }
317
+ }
318
+ async function wireContextStores(builder, input) {
319
+ try {
320
+ const { AgentDatabase } = await import('../memory/sqlite/agent-db.js');
321
+ const { SqliteMemoryStore } = await import('../memory/sqlite/memory-store.js');
322
+ const { SqliteWisdomStore } = await import('../memory/sqlite/wisdom-store.js');
323
+ const { SqliteConceptGraph } = await import('../memory/sqlite/cognition-store.js');
324
+ const { resolveEmbeddingRuntime } = await import('../memory/sqlite/embedding-from-models.js');
325
+ const embRuntime = resolveEmbeddingRuntime({
326
+ providers: input.modelsConfig?.providers ?? {},
327
+ embedding: input.modelsConfig?.embedding,
328
+ });
329
+ const useVec = embRuntime && embRuntime.vectorEngine !== 'js';
330
+ const db = await AgentDatabase.create({
331
+ dbPath: join(input.agentHome, 'agent.db'),
332
+ sqliteVec: useVec
333
+ ? { extensionPath: embRuntime?.sqliteVecExtensionPath }
334
+ : false,
335
+ vectorDimensions: useVec ? embRuntime?.dimensions : undefined,
336
+ });
337
+ const memoryStore = new SqliteMemoryStore(db, {
338
+ embeddingProvider: embRuntime?.provider ?? null,
339
+ vectorEngine: embRuntime?.vectorEngine ?? 'auto',
340
+ minSimilarity: input.memoryConfig?.retrieval?.minSimilarity,
341
+ similarityWeight: input.memoryConfig?.retrieval?.similarityWeight,
342
+ minKeywordScore: input.memoryConfig?.retrieval?.minKeywordScore,
343
+ });
344
+ builder.memoryStore(memoryStore);
345
+ const wis = input.wisdomConfig;
346
+ if (wis?.enabled !== false) {
347
+ builder.wisdomStore(new SqliteWisdomStore(db, { hardCap: wis?.capacity?.hardCap }));
348
+ }
349
+ const cog = input.cognitionConfig;
350
+ if (cog?.enabled !== false) {
351
+ builder.cognitionStore(new SqliteConceptGraph(db, {
352
+ embeddingProvider: embRuntime?.provider ?? null,
353
+ mergeThreshold: cog?.identity?.mergeThreshold,
354
+ candidateBandHi: cog?.identity?.candidateBandHi,
355
+ stopNodes: cog?.capacity?.stopNodes,
356
+ stopEdges: cog?.capacity?.stopEdges,
357
+ causesMinIndependentMemories: cog?.relations?.causesMinIndependentMemories,
358
+ }));
359
+ }
360
+ return { memoryStore };
361
+ }
362
+ catch (err) {
363
+ const msg = err instanceof Error ? err.message : String(err);
364
+ console.warn(`[AgentWire] memory/wisdom/cognition stores unavailable for agent home ${input.agentHome}: ${msg}`);
365
+ if (/node:sqlite|ERR_UNKNOWN_BUILTIN_MODULE|ERR_DLOPEN|NODE_MODULE_VERSION/i.test(msg)) {
366
+ console.warn(`[AgentWire] hint: SQLite backend requires Node.js >= 24 with built-in node:sqlite (process.version=${process.version})`);
367
+ }
368
+ return {};
369
+ }
370
+ }
@@ -6,6 +6,15 @@
6
6
  * @module autonomous-subsystem/boundary/validator
7
7
  */
8
8
  import type { SubsystemSpec } from '../types.js';
9
+ /**
10
+ * SEC-6 执行上下文:声明必须可兑现。
11
+ * `sandboxed` 是加载器的硬承诺(环境须满足 L4 process 最低线);
12
+ * `trusted | privileged` 是作者承诺(advisory,见 docs/autonomous-subsystem.md)。
13
+ */
14
+ export interface SecurityEnforcementContext {
15
+ /** 环境是否满足 L4 process 最低线(`assessL4ProcessMinimum`) */
16
+ l4Available: boolean;
17
+ }
9
18
  /**
10
19
  * 校验错误
11
20
  */
@@ -19,6 +28,7 @@ export interface ValidationError {
19
28
  * 校验 SubsystemSpec 的内部一致性
20
29
  *
21
30
  * @param spec - 子系统规格
31
+ * @param enforcement - SEC-6 执行上下文(宿主能力声明,必填:校验器不替调用方猜环境)
22
32
  * @returns 校验错误数组,空数组表示通过
23
33
  */
24
- export declare function validateSubsystemSpec(spec: SubsystemSpec): ValidationError[];
34
+ export declare function validateSubsystemSpec(spec: SubsystemSpec, enforcement: SecurityEnforcementContext): ValidationError[];
@@ -18,9 +18,10 @@ const AUTHORITY_ACT_MAP = {
18
18
  * 校验 SubsystemSpec 的内部一致性
19
19
  *
20
20
  * @param spec - 子系统规格
21
+ * @param enforcement - SEC-6 执行上下文(宿主能力声明,必填:校验器不替调用方猜环境)
21
22
  * @returns 校验错误数组,空数组表示通过
22
23
  */
23
- export function validateSubsystemSpec(spec) {
24
+ export function validateSubsystemSpec(spec, enforcement) {
24
25
  const errors = [];
25
26
  if (!spec.boundary)
26
27
  errors.push({ field: 'boundary', message: 'boundary is required' });
@@ -30,6 +31,15 @@ export function validateSubsystemSpec(spec) {
30
31
  errors.push({ field: 'act', message: 'act is required' });
31
32
  if (!spec.boundary || !spec.signal || !spec.act)
32
33
  return errors;
34
+ // ── SEC-6:`sandboxed` 声明必须可兑现(fail-closed)──
35
+ // `sandboxed` 是加载器的硬承诺:环境达不到 L4 process 最低线就拒绝加载,
36
+ // 绝不允许「看起来已沙箱」。`trusted | privileged` 是作者承诺(advisory),不在此拦截。
37
+ if (spec.boundary.security === 'sandboxed' && !enforcement.l4Available) {
38
+ errors.push({
39
+ field: 'boundary.security',
40
+ message: 'security "sandboxed" requires L4 process isolation (bwrap/Seatbelt/Job) in this environment; declare trusted/privileged explicitly or run where L4 exists',
41
+ });
42
+ }
33
43
  // ── act.mode 与 boundary.authority 交叉校验 ──
34
44
  const allowedModes = AUTHORITY_ACT_MAP[spec.boundary.authority];
35
45
  if (!allowedModes.has(spec.act.mode)) {
@@ -1,10 +1,16 @@
1
1
  import type { SubsystemSpec } from './types.js';
2
+ import { type SecurityEnforcementContext } from './boundary/validator.js';
2
3
  export interface SubsystemLoaderConfig {
3
4
  builtinDir?: string;
4
5
  userDir?: string;
5
6
  projectDir?: string;
6
7
  /** node_modules 目录(用于 npm 子系统发现) */
7
8
  npmDir?: string;
9
+ /**
10
+ * SEC-6 能力注入(测试/确定性场景)。缺省实测环境:
11
+ * `probeProcessIsolation()` + L4 process 最低线评估。
12
+ */
13
+ securityEnforcement?: SecurityEnforcementContext;
8
14
  }
9
15
  export interface LoadResult {
10
16
  specs: SubsystemSpec[];
@@ -18,7 +24,14 @@ export declare class SubsystemLoader {
18
24
  private userDir?;
19
25
  private projectDir?;
20
26
  private npmDir?;
27
+ private securityEnforcement?;
21
28
  constructor(config: SubsystemLoaderConfig);
29
+ /**
30
+ * SEC-6 能力解析:注入优先;缺省实测环境(L4 process 最低线评估)。
31
+ *
32
+ * @returns 宿主能力声明
33
+ */
34
+ private resolveSecurityEnforcement;
22
35
  loadAll(): Promise<LoadResult>;
23
36
  /**
24
37
  * 加载一级目录:单 spec 包,或多 spec 包(子目录含 config/SUBSYSTEM.md + shared 静默跳过)
@@ -2,6 +2,7 @@ import { existsSync, readdirSync, readFileSync } from 'node:fs';
2
2
  import { basename, join } from 'node:path';
3
3
  import { createRequire } from 'node:module';
4
4
  import { validateSubsystemSpec } from './boundary/validator.js';
5
+ import { probeProcessIsolation, assessL4ProcessMinimum } from '../../extension/execution-environment/process-isolation.js';
5
6
  // js-yaml 自身未附带 d.ts;仅使用 load,避免为类型强装 @types(与当前 TS 版本 peer 冲突)
6
7
  // 惰性 require:包缺失时只在真正解析 YAML 时失败,不阻断模块 import
7
8
  let loadYamlFn;
@@ -17,11 +18,24 @@ export class SubsystemLoader {
17
18
  userDir;
18
19
  projectDir;
19
20
  npmDir;
21
+ securityEnforcement;
20
22
  constructor(config) {
21
23
  this.builtinDir = config.builtinDir;
22
24
  this.userDir = config.userDir;
23
25
  this.projectDir = config.projectDir;
24
26
  this.npmDir = config.npmDir;
27
+ this.securityEnforcement = config.securityEnforcement;
28
+ }
29
+ /**
30
+ * SEC-6 能力解析:注入优先;缺省实测环境(L4 process 最低线评估)。
31
+ *
32
+ * @returns 宿主能力声明
33
+ */
34
+ async resolveSecurityEnforcement() {
35
+ if (this.securityEnforcement)
36
+ return this.securityEnforcement;
37
+ const profile = await probeProcessIsolation();
38
+ return { l4Available: assessL4ProcessMinimum(profile).ok };
25
39
  }
26
40
  async loadAll() {
27
41
  const specs = new Map();
@@ -188,7 +202,8 @@ export class SubsystemLoader {
188
202
  if (missingExplicitFields.length > 0) {
189
203
  return { error: `Missing required explicit fields: ${missingExplicitFields.join(', ')}` };
190
204
  }
191
- const errors = validateSubsystemSpec(spec);
205
+ const enforcement = await this.resolveSecurityEnforcement();
206
+ const errors = validateSubsystemSpec(spec, enforcement);
192
207
  if (errors.length > 0) {
193
208
  return { error: `Validation failed: ${errors.map((e) => `${e.field}: ${e.message}`).join('; ')}` };
194
209
  }
@@ -14,6 +14,7 @@ import type { SubsystemSpec, AgentContext, SenseContext } from './types.js';
14
14
  import { MetricsStore } from './sense/metrics.js';
15
15
  import type { ModelLevelMap } from './types.js';
16
16
  import { SignalBus } from './signal/bus.js';
17
+ import { type SecurityEnforcementContext } from './boundary/validator.js';
17
18
  /** 子系统运行终态(与 SubsystemRun.status 对齐) */
18
19
  export type SubsystemRunStatus = 'success' | 'failed' | 'timeout' | 'degraded';
19
20
  /**
@@ -29,12 +30,14 @@ export type SubsystemTriggerResult = {
29
30
  status: SubsystemRunStatus;
30
31
  };
31
32
  export interface SharedDeps {
33
+ /** 主 provider 实例(resolved 未指名 provider / 未命中时回退) */
32
34
  model: ModelProvider;
33
35
  events: EventBus;
34
36
  errorStrategy: ErrorStrategy;
35
37
  mainTools: import('@octopi-agent/core/interfaces/tool-bus.js').ToolBus;
36
38
  modelLevels?: ModelLevelMap;
37
- defaultModelProvider?: string;
39
+ /** 按名选择 provider(`think.model: "provider/model"` / levels.primary 的 provider 段) */
40
+ providers?: Map<string, ModelProvider>;
38
41
  /** 依赖注入注册表:名称 → 实现实例,供 runtimeInject.requires 解析 */
39
42
  injectRegistry?: Map<string, unknown>;
40
43
  }
@@ -42,13 +45,17 @@ export interface SubsystemRuntimeConfig {
42
45
  deps: SharedDeps;
43
46
  auditDir?: string;
44
47
  agentId?: string;
48
+ /** SEC-6 宿主能力声明(必填):`sandboxed` 声明只有在 L4 可用时才放行 */
49
+ securityEnforcement: SecurityEnforcementContext;
45
50
  }
46
51
  export declare class SubsystemRuntime {
47
52
  private deps;
53
+ private securityEnforcement;
48
54
  private senseEngine;
49
55
  private thinkExecutor;
50
56
  private signalBus;
51
57
  private sessionManager;
58
+ private sessionLifecycleBridge;
52
59
  private auditWriter?;
53
60
  private modelResolver;
54
61
  private subsystems;