@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
@@ -15,10 +15,10 @@
15
15
  */
16
16
  export function readJobControlState(db, index, sourceId, opts) {
17
17
  const row = db.raw
18
- .prepare(`SELECT
19
- SUM(CASE WHEN status = 'queued' THEN 1 ELSE 0 END) AS q,
20
- SUM(CASE WHEN status = 'running' THEN 1 ELSE 0 END) AS r,
21
- SUM(CASE WHEN status = 'cancelled' THEN 1 ELSE 0 END) AS c
18
+ .prepare(`SELECT
19
+ SUM(CASE WHEN status = 'queued' THEN 1 ELSE 0 END) AS q,
20
+ SUM(CASE WHEN status = 'running' THEN 1 ELSE 0 END) AS r,
21
+ SUM(CASE WHEN status = 'cancelled' THEN 1 ELSE 0 END) AS c
22
22
  FROM knowledge_jobs WHERE source_id = ?`)
23
23
  .get(sourceId);
24
24
  const jobsQueued = Number(row?.q ?? 0);
@@ -10,13 +10,13 @@ export class KnowledgeJobControl {
10
10
  abortBySource = new Map();
11
11
  constructor(db) {
12
12
  this.db = db;
13
- this.db.raw.exec(`
14
- CREATE TABLE IF NOT EXISTS knowledge_source_control (
15
- source_id TEXT PRIMARY KEY,
16
- aborted INTEGER NOT NULL DEFAULT 0,
17
- aborted_at INTEGER,
18
- updated_at INTEGER NOT NULL
19
- );
13
+ this.db.raw.exec(`
14
+ CREATE TABLE IF NOT EXISTS knowledge_source_control (
15
+ source_id TEXT PRIMARY KEY,
16
+ aborted INTEGER NOT NULL DEFAULT 0,
17
+ aborted_at INTEGER,
18
+ updated_at INTEGER NOT NULL
19
+ );
20
20
  `);
21
21
  }
22
22
  /** 是否处于中止态(DB 权威;进程重启后仍生效)。连接已关时视为停止调度 */
@@ -47,8 +47,8 @@ export class KnowledgeJobControl {
47
47
  beginEpoch(sourceId) {
48
48
  this.abortBySource.set(sourceId, new AbortController());
49
49
  this.db.raw
50
- .prepare(`INSERT INTO knowledge_source_control (source_id, aborted, aborted_at, updated_at)
51
- VALUES (?, 0, NULL, ?)
50
+ .prepare(`INSERT INTO knowledge_source_control (source_id, aborted, aborted_at, updated_at)
51
+ VALUES (?, 0, NULL, ?)
52
52
  ON CONFLICT(source_id) DO UPDATE SET aborted = 0, aborted_at = NULL, updated_at = excluded.updated_at`)
53
53
  .run(sourceId, Date.now());
54
54
  }
@@ -59,8 +59,8 @@ export class KnowledgeJobControl {
59
59
  markAborted(sourceId) {
60
60
  const already = this.isAborted(sourceId);
61
61
  this.db.raw
62
- .prepare(`INSERT INTO knowledge_source_control (source_id, aborted, aborted_at, updated_at)
63
- VALUES (?, 1, ?, ?)
62
+ .prepare(`INSERT INTO knowledge_source_control (source_id, aborted, aborted_at, updated_at)
63
+ VALUES (?, 1, ?, ?)
64
64
  ON CONFLICT(source_id) DO UPDATE SET aborted = 1, aborted_at = excluded.aborted_at, updated_at = excluded.updated_at`)
65
65
  .run(sourceId, Date.now(), Date.now());
66
66
  let ctrl = this.abortBySource.get(sourceId);
@@ -30,7 +30,7 @@ async function main() {
30
30
  throw new Error('knowledge-serve-child: missing boot file path');
31
31
  }
32
32
  const raw = await readFile(bootPath, 'utf8');
33
- const boot = JSON.parse(raw.replace(/^/, ''));
33
+ const boot = JSON.parse(raw.replace(/^\uFEFF/, ''));
34
34
  try {
35
35
  await unlink(bootPath);
36
36
  }
@@ -16,7 +16,7 @@ export class MembershipStore {
16
16
  const tenant = opts?.tenantId ?? 'default';
17
17
  const now = Date.now();
18
18
  const row = this.db.raw
19
- .prepare(`SELECT id, size, mtime FROM knowledge_files
19
+ .prepare(`SELECT id, size, mtime FROM knowledge_files
20
20
  WHERE tenant_id = ? AND identity_key = ?`)
21
21
  .get(tenant, identity.key);
22
22
  if (row) {
@@ -30,20 +30,20 @@ export class MembershipStore {
30
30
  }
31
31
  const fileId = newId('file');
32
32
  this.db.raw
33
- .prepare(`INSERT INTO knowledge_files
34
- (id, tenant_id, identity_key, size, mtime, content_hash, status, chunk_count, indexed_at)
33
+ .prepare(`INSERT INTO knowledge_files
34
+ (id, tenant_id, identity_key, size, mtime, content_hash, status, chunk_count, indexed_at)
35
35
  VALUES (?, ?, ?, ?, ?, NULL, 'pending', 0, ?)`)
36
36
  .run(fileId, tenant, identity.key, identity.size, identity.mtime, now);
37
37
  return { fileId, created: true, versionChanged: true };
38
38
  }
39
39
  claim(sourceId, fileId, logicalPath) {
40
40
  const prev = this.db.raw
41
- .prepare(`SELECT file_id FROM knowledge_memberships
41
+ .prepare(`SELECT file_id FROM knowledge_memberships
42
42
  WHERE source_id = ? AND logical_path = ?`)
43
43
  .get(sourceId, logicalPath);
44
44
  this.db.raw
45
- .prepare(`INSERT INTO knowledge_memberships (source_id, file_id, logical_path, created_at)
46
- VALUES (?, ?, ?, ?)
45
+ .prepare(`INSERT INTO knowledge_memberships (source_id, file_id, logical_path, created_at)
46
+ VALUES (?, ?, ?, ?)
47
47
  ON CONFLICT(source_id, logical_path) DO UPDATE SET file_id = excluded.file_id`)
48
48
  .run(sourceId, fileId, logicalPath, Date.now());
49
49
  // 换绑后旧 File 若零认领,由调用方 purge(此处只记孤儿风险)
@@ -53,7 +53,7 @@ export class MembershipStore {
53
53
  }
54
54
  unclaim(sourceId, logicalPath) {
55
55
  const row = this.db.raw
56
- .prepare(`SELECT file_id FROM knowledge_memberships
56
+ .prepare(`SELECT file_id FROM knowledge_memberships
57
57
  WHERE source_id = ? AND logical_path = ?`)
58
58
  .get(sourceId, logicalPath);
59
59
  this.db.raw
@@ -69,7 +69,7 @@ export class MembershipStore {
69
69
  }
70
70
  listBySource(sourceId) {
71
71
  const rows = this.db.raw
72
- .prepare(`SELECT source_id, file_id, logical_path, created_at
72
+ .prepare(`SELECT source_id, file_id, logical_path, created_at
73
73
  FROM knowledge_memberships WHERE source_id = ? ORDER BY logical_path`)
74
74
  .all(sourceId);
75
75
  return rows.map((r) => ({
@@ -81,7 +81,7 @@ export class MembershipStore {
81
81
  }
82
82
  listByFile(fileId) {
83
83
  const rows = this.db.raw
84
- .prepare(`SELECT source_id, file_id, logical_path, created_at
84
+ .prepare(`SELECT source_id, file_id, logical_path, created_at
85
85
  FROM knowledge_memberships WHERE file_id = ?`)
86
86
  .all(fileId);
87
87
  return rows.map((r) => ({
@@ -163,7 +163,7 @@ export class MembershipStore {
163
163
  }
164
164
  getFile(fileId) {
165
165
  const r = this.db.raw
166
- .prepare(`SELECT id, identity_key, size, mtime, content_hash, status, chunk_count
166
+ .prepare(`SELECT id, identity_key, size, mtime, content_hash, status, chunk_count
167
167
  FROM knowledge_files WHERE id = ?`)
168
168
  .get(fileId);
169
169
  if (!r)
@@ -180,7 +180,7 @@ export class MembershipStore {
180
180
  }
181
181
  findFileByIdentity(identityKey, tenantId = 'default') {
182
182
  const r = this.db.raw
183
- .prepare(`SELECT id, identity_key, size, mtime, content_hash, status, chunk_count
183
+ .prepare(`SELECT id, identity_key, size, mtime, content_hash, status, chunk_count
184
184
  FROM knowledge_files WHERE tenant_id = ? AND identity_key = ?`)
185
185
  .get(tenantId, identityKey);
186
186
  if (!r)
@@ -1,11 +1,15 @@
1
1
  /**
2
- * 出站网络门禁 — Knowledge 外源 ingest SSRF 防护
2
+ * 出站网络门禁 — Knowledge 外源 ingest / http_request SSRF 防护
3
3
  *
4
- * 默认拒绝私网/环回/link-local/云 metadata;源级 allowPrivateNetwork 显式放行。
5
- * 重定向上每跳复验地址;**不**做 IP 钉扎——DNS TOCTOU 见 docs/KNOWN-ISSUES。
4
+ * 默认拒绝私网/环回/link-local/云 metadata;`allowPrivateNetwork` 显式放行。
5
+ * 重定向上每跳复验地址;**connect 时再校验**(自定义 lookup),关闭
6
+ * `assertUrlAllowed` lookup 与实际 connect 之间的 DNS TOCTOU(SEC-3a)。
7
+ *
8
+ * 真·IP 钉扎 / hostname allowlist:嵌入方经 `lookup` / `filterAddresses`
9
+ * 注入(SEC-3 结论:引擎不做完整钉扎,见 arch/security-open-issues.md)。
6
10
  */
7
11
  export interface NetworkGuardOptions {
8
- /** 放行私网/环回(源级显式开启) */
12
+ /** 放行私网/环回(源级/部署显式开启) */
9
13
  allowPrivateNetwork?: boolean;
10
14
  /** 重定向上限(默认 5) */
11
15
  maxRedirects?: number;
@@ -15,10 +19,21 @@ export interface NetworkGuardOptions {
15
19
  maxResponseBytes?: number;
16
20
  /** 允许的协议(默认 http/https) */
17
21
  protocols?: string[];
22
+ /**
23
+ * Connect 时 DNS lookup 覆盖(嵌入方 IP 钉扎缝)。
24
+ * 未提供时使用 `createValidatingLookup`(受限 IP 拒绝 + 可选 filter)。
25
+ */
26
+ lookup?: ConnectLookup;
27
+ /**
28
+ * Connect 解析后的地址过滤(钉扎:只保留已审查 IP)。
29
+ * 在默认 validating lookup 内生效;提供 `lookup` 时忽略。
30
+ */
31
+ filterAddresses?: AddressFilter;
18
32
  }
19
33
  export interface FetchResult {
20
34
  url: string;
21
35
  status: number;
36
+ statusText: string;
22
37
  headers: Record<string, string>;
23
38
  body: string;
24
39
  contentType?: string;
@@ -26,7 +41,24 @@ export interface FetchResult {
26
41
  lastModified?: string;
27
42
  /** 条件请求未修改 */
28
43
  notModified: boolean;
44
+ /** 响应体因 maxResponseBytes 截断 */
45
+ bodyTruncated?: boolean;
29
46
  }
47
+ export type ConnectLookup = (hostname: string, options: {
48
+ family?: number | 'IPv4' | 'IPv6';
49
+ hints?: number;
50
+ all?: boolean;
51
+ }, callback: (err: NodeJS.ErrnoException | null, address?: string | Array<{
52
+ address: string;
53
+ family: number;
54
+ }>, family?: number) => void) => void;
55
+ export type AddressFilter = (hostname: string, addresses: Array<{
56
+ address: string;
57
+ family: number;
58
+ }>) => Array<{
59
+ address: string;
60
+ family: number;
61
+ }>;
30
62
  /**
31
63
  * 凭证只属于「源入口 origin」。远端内容指向的任何其他 origin 一律不带鉴权头。
32
64
  *
@@ -36,12 +68,20 @@ export interface FetchResult {
36
68
  * @returns 同 origin 时原样返回;跨 origin 时只保留安全白名单
37
69
  */
38
70
  export declare function authHeadersForUrl(trustedOrigin: string, targetUrl: string, headers?: Record<string, string>): Record<string, string>;
71
+ /**
72
+ * 永不放行:云 metadata / 链路本地 / 未指定(即使 allowPrivateNetwork)
73
+ */
74
+ export declare function isAlwaysBlockedIp(ip: string): boolean;
39
75
  /**
40
76
  * 判断 IP 是否属于受限地址(私网/环回/metadata/未指定)
41
77
  *
42
78
  * @param ip - IPv4/IPv6 字面量
43
79
  */
44
80
  export declare function isRestrictedIp(ip: string): boolean;
81
+ export declare function createValidatingLookup(opts?: {
82
+ allowPrivateNetwork?: boolean;
83
+ filterAddresses?: AddressFilter;
84
+ }): ConnectLookup;
45
85
  /**
46
86
  * 校验 URL 主机是否允许出站
47
87
  *
@@ -50,6 +90,23 @@ export declare function isRestrictedIp(ip: string): boolean;
50
90
  * @throws 协议/地址不允许时抛错
51
91
  */
52
92
  export declare function assertUrlAllowed(rawUrl: string, opts?: NetworkGuardOptions): Promise<URL>;
93
+ /**
94
+ * 受门禁保护的 HTTP 请求(手动跟随重定向并每跳 SSRF 复验 + connect 时 lookup 校验)
95
+ *
96
+ * @param rawUrl - 目标 URL
97
+ * @param options - 门禁与请求选项(method/body/headers)
98
+ * @param init - 额外 fetch 头(凭证等);与 options.headers 合并
99
+ * @returns 规范化响应
100
+ */
101
+ export declare function guardedRequest(rawUrl: string, options?: NetworkGuardOptions & {
102
+ method?: string;
103
+ body?: string;
104
+ headers?: Record<string, string>;
105
+ etag?: string;
106
+ lastModified?: string;
107
+ }, init?: {
108
+ headers?: Record<string, string>;
109
+ }): Promise<FetchResult>;
53
110
  /**
54
111
  * 受门禁保护的 GET(跟随重定向并每跳复验)
55
112
  *