@octopi-agent/engine 0.65.0 → 0.86.38

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (421) hide show
  1. package/LICENSE +201 -201
  2. package/NOTICE +7 -7
  3. package/README.md +64 -26
  4. package/dist/config-schema/agent.d.ts +89 -1
  5. package/dist/config-schema/agent.js +69 -0
  6. package/dist/config-schema/context.d.ts +23 -4
  7. package/dist/config-schema/context.js +28 -1
  8. package/dist/config-schema/engine.d.ts +285 -9
  9. package/dist/config-schema/engine.js +35 -3
  10. package/dist/config-schema/governance.d.ts +95 -0
  11. package/dist/config-schema/governance.js +91 -0
  12. package/dist/config-schema/models.d.ts +1 -1
  13. package/dist/config-schema/observability.d.ts +6 -0
  14. package/dist/config-schema/observability.js +16 -0
  15. package/dist/config-schema/run.d.ts +10 -0
  16. package/dist/config-schema/run.js +18 -0
  17. package/dist/config-schema/shared.d.ts +10 -0
  18. package/dist/config-schema/shared.js +10 -0
  19. package/dist/config-schema/substrate.d.ts +87 -1
  20. package/dist/config-schema/substrate.js +114 -0
  21. package/dist/config-schema/subsystems.d.ts +1 -1
  22. package/dist/config-schema/subsystems.js +2 -1
  23. package/dist/config.d.ts +249 -7
  24. package/dist/config.js +113 -3
  25. package/dist/harness/activation/compiler.js +3 -0
  26. package/dist/harness/activation/runtime.d.ts +7 -0
  27. package/dist/harness/activation/runtime.js +60 -2
  28. package/dist/harness/activation/sources/agent-signal.d.ts +11 -0
  29. package/dist/harness/activation/sources/agent-signal.js +33 -0
  30. package/dist/harness/activation/types.d.ts +6 -1
  31. package/dist/harness/agent/builder.d.ts +48 -4
  32. package/dist/harness/agent/builder.js +206 -55
  33. package/dist/harness/agent/config-bridge.d.ts +33 -25
  34. package/dist/harness/agent/config-bridge.js +83 -280
  35. package/dist/harness/agent/index.d.ts +3 -1
  36. package/dist/harness/agent/index.js +2 -1
  37. package/dist/harness/agent/tool-purpose.d.ts +38 -0
  38. package/dist/harness/agent/tool-purpose.js +118 -0
  39. package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
  40. package/dist/harness/agent/wire-agent-builder.js +363 -0
  41. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +4 -1
  42. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +14 -8
  43. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
  44. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
  45. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
  46. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
  47. package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
  48. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
  49. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
  50. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
  51. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
  52. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
  53. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
  54. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
  55. package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
  56. package/dist/harness/collaboration/delegation/child-run.js +241 -0
  57. package/dist/harness/collaboration/delegation/index.d.ts +26 -0
  58. package/dist/harness/collaboration/delegation/index.js +25 -0
  59. package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
  60. package/dist/harness/collaboration/delegation/notifier.js +84 -0
  61. package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
  62. package/dist/harness/collaboration/delegation/registry-types.js +61 -0
  63. package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
  64. package/dist/harness/collaboration/delegation/registry.js +220 -0
  65. package/dist/harness/collaboration/delegation/service.d.ts +249 -0
  66. package/dist/harness/collaboration/delegation/service.js +499 -0
  67. package/dist/harness/collaboration/delegation/store.d.ts +155 -0
  68. package/dist/harness/collaboration/delegation/store.js +271 -0
  69. package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
  70. package/dist/harness/collaboration/delegation/transport.js +61 -0
  71. package/dist/harness/collaboration/delegation/types.d.ts +231 -0
  72. package/dist/harness/collaboration/delegation/types.js +70 -0
  73. package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
  74. package/dist/harness/collaboration/delegation/wiring.js +145 -0
  75. package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
  76. package/dist/harness/collaboration/orchestration/index.js +11 -11
  77. package/dist/harness/context/assembler.d.ts +2 -2
  78. package/dist/harness/context/assembler.js +12 -7
  79. package/dist/harness/context/capabilities/compact/engine.js +80 -38
  80. package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
  81. package/dist/harness/context/capabilities/summary/gate.js +2 -2
  82. package/dist/harness/context/capabilities/summary/policies.js +5 -5
  83. package/dist/harness/context/capabilities/summary/registry.js +39 -24
  84. package/dist/harness/context/constitution/default-agents.md +230 -228
  85. package/dist/harness/context/default-context-engine.d.ts +101 -23
  86. package/dist/harness/context/default-context-engine.js +483 -172
  87. package/dist/harness/context/hybrid-compressor.d.ts +3 -3
  88. package/dist/harness/context/hybrid-compressor.js +18 -23
  89. package/dist/harness/context/index.d.ts +5 -1
  90. package/dist/harness/context/index.js +2 -0
  91. package/dist/harness/context/layer-health.js +3 -2
  92. package/dist/harness/context/layer-snapshot.d.ts +4 -0
  93. package/dist/harness/context/layer-snapshot.js +30 -18
  94. package/dist/harness/context/layer-types.d.ts +49 -1
  95. package/dist/harness/context/layer-types.js +72 -4
  96. package/dist/harness/context/layers.d.ts +32 -15
  97. package/dist/harness/context/layers.js +87 -71
  98. package/dist/harness/context/llm-summarizer.d.ts +15 -1
  99. package/dist/harness/context/llm-summarizer.js +107 -56
  100. package/dist/harness/context/message-selector.js +6 -2
  101. package/dist/harness/context/root-instructions.d.ts +72 -0
  102. package/dist/harness/context/root-instructions.js +227 -0
  103. package/dist/harness/context/runtime-datetime.d.ts +34 -7
  104. package/dist/harness/context/runtime-datetime.js +66 -10
  105. package/dist/harness/context/smart-router.d.ts +1 -1
  106. package/dist/harness/context/smart-router.js +1 -1
  107. package/dist/harness/context/system-prompt-assembler.d.ts +33 -0
  108. package/dist/harness/context/system-prompt-assembler.js +78 -7
  109. package/dist/harness/context/token-constants.d.ts +2 -2
  110. package/dist/harness/context/token-constants.js +2 -2
  111. package/dist/harness/context/token-estimate-fns.d.ts +1 -3
  112. package/dist/harness/context/token-estimate-fns.js +2 -4
  113. package/dist/harness/context/token-estimator.d.ts +1 -1
  114. package/dist/harness/context/token-estimator.js +14 -6
  115. package/dist/harness/context/tool-result-aging.d.ts +140 -0
  116. package/dist/harness/context/tool-result-aging.js +331 -0
  117. package/dist/harness/context/tool-result-body.d.ts +10 -0
  118. package/dist/harness/context/tool-result-body.js +27 -0
  119. package/dist/harness/context/turn-envelope.d.ts +123 -0
  120. package/dist/harness/context/turn-envelope.js +188 -0
  121. package/dist/harness/context/types.d.ts +35 -47
  122. package/dist/harness/extension/execution-environment/effect-policy.d.ts +248 -0
  123. package/dist/harness/extension/execution-environment/effect-policy.js +334 -0
  124. package/dist/harness/extension/execution-environment/index.d.ts +18 -2
  125. package/dist/harness/extension/execution-environment/index.js +11 -2
  126. package/dist/harness/extension/execution-environment/memory-undo.d.ts +101 -0
  127. package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
  128. package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
  129. package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
  130. package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
  131. package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
  132. package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
  133. package/dist/harness/extension/execution-environment/sandbox.js +493 -51
  134. package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
  135. package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
  136. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
  137. package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
  138. package/dist/harness/extension/execution-environment/types.d.ts +67 -39
  139. package/dist/harness/extension/execution-environment/types.js +2 -2
  140. package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
  141. package/dist/harness/extension/execution-environment/undo-log.js +627 -0
  142. package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
  143. package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
  144. package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +4 -0
  145. package/dist/harness/extension/plugin-ecosystem/client-tools/index.js +3 -0
  146. package/dist/harness/extension/plugin-ecosystem/client-tools/invoke.d.ts +56 -0
  147. package/dist/harness/extension/plugin-ecosystem/client-tools/invoke.js +281 -0
  148. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +98 -0
  149. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +250 -0
  150. package/dist/harness/extension/plugin-ecosystem/client-tools/stream.d.ts +124 -0
  151. package/dist/harness/extension/plugin-ecosystem/client-tools/stream.js +372 -0
  152. package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +118 -0
  153. package/dist/harness/extension/plugin-ecosystem/client-tools/types.js +8 -0
  154. package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
  155. package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
  156. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
  157. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
  158. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
  159. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
  160. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
  161. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
  162. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
  163. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
  164. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
  165. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
  166. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
  167. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
  168. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
  169. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
  170. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
  171. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
  172. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
  173. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +45 -0
  174. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +136 -0
  175. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
  176. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
  177. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +278 -82
  178. package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
  179. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
  180. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
  181. package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
  182. package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
  183. package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
  184. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
  185. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
  186. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
  187. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
  188. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +239 -61
  189. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
  190. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +554 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
  192. package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
  193. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +2 -0
  194. package/dist/harness/extension/plugin-ecosystem/tools/index.js +2 -0
  195. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
  196. package/dist/harness/extension/plugin-ecosystem/tools/memory.d.ts +11 -1
  197. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +39 -1
  198. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
  199. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
  200. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
  201. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
  202. package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
  203. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
  204. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
  205. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
  206. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
  207. package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
  208. package/dist/harness/governance/credentials/index.d.ts +1 -1
  209. package/dist/harness/governance/credentials/store.d.ts +16 -4
  210. package/dist/harness/governance/credentials/store.js +33 -6
  211. package/dist/harness/governance/credentials/types.d.ts +11 -0
  212. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
  213. package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
  214. package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
  215. package/dist/harness/governance/human-in-the-loop/index.js +3 -3
  216. package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
  217. package/dist/harness/governance/human-in-the-loop/types.js +6 -2
  218. package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
  219. package/dist/harness/governance/security/capability-enforcer.js +31 -8
  220. package/dist/harness/governance/security/degradation.js +5 -7
  221. package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
  222. package/dist/harness/governance/security/risk-evaluator.js +4 -82
  223. package/dist/harness/governance/security/temp-path.d.ts +41 -0
  224. package/dist/harness/governance/security/temp-path.js +117 -0
  225. package/dist/harness/governance/session-acl/index.d.ts +1 -0
  226. package/dist/harness/governance/session-acl/index.js +1 -0
  227. package/dist/harness/governance/session-acl/rights.d.ts +12 -0
  228. package/dist/harness/governance/session-acl/rights.js +89 -7
  229. package/dist/harness/governance/session-acl/seed-roles.js +9 -1
  230. package/dist/harness/governance/session-acl/service.js +21 -29
  231. package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
  232. package/dist/harness/governance/session-acl/tool-rights.js +238 -0
  233. package/dist/harness/governance/session-acl/types.d.ts +22 -0
  234. package/dist/harness/index.d.ts +18 -15
  235. package/dist/harness/index.js +11 -7
  236. package/dist/harness/knowledge/file-index-store.js +11 -11
  237. package/dist/harness/knowledge/grounding.d.ts +2 -1
  238. package/dist/harness/knowledge/grounding.js +6 -3
  239. package/dist/harness/knowledge/index.d.ts +2 -2
  240. package/dist/harness/knowledge/index.js +1 -1
  241. package/dist/harness/knowledge/ingest.js +4 -1
  242. package/dist/harness/knowledge/job-control-state.js +4 -4
  243. package/dist/harness/knowledge/job-control.js +11 -11
  244. package/dist/harness/knowledge/membership-store.js +11 -11
  245. package/dist/harness/knowledge/network-guard.d.ts +61 -4
  246. package/dist/harness/knowledge/network-guard.js +390 -113
  247. package/dist/harness/knowledge/query-service.js +8 -8
  248. package/dist/harness/knowledge/retriever.js +1 -1
  249. package/dist/harness/knowledge/source-store.d.ts +17 -2
  250. package/dist/harness/knowledge/source-store.js +6 -5
  251. package/dist/harness/knowledge/writer-service.d.ts +2 -0
  252. package/dist/harness/knowledge/writer-service.js +14 -13
  253. package/dist/harness/memory/backfill-trigger.d.ts +2 -2
  254. package/dist/harness/memory/backfill-trigger.js +4 -4
  255. package/dist/harness/memory/cognition-decay.d.ts +36 -0
  256. package/dist/harness/memory/cognition-decay.js +55 -0
  257. package/dist/harness/memory/cognition-gates.d.ts +60 -0
  258. package/dist/harness/memory/cognition-gates.js +191 -0
  259. package/dist/harness/memory/cognition-trigger.d.ts +30 -0
  260. package/dist/harness/memory/cognition-trigger.js +41 -0
  261. package/dist/harness/memory/cognition-types.d.ts +1 -1
  262. package/dist/harness/memory/cognition.d.ts +40 -8
  263. package/dist/harness/memory/cognition.js +432 -79
  264. package/dist/harness/memory/conceptualizer.d.ts +66 -0
  265. package/dist/harness/memory/conceptualizer.js +246 -0
  266. package/dist/harness/memory/index.d.ts +17 -2
  267. package/dist/harness/memory/index.js +12 -1
  268. package/dist/harness/memory/sqlite/agent-db.d.ts +9 -0
  269. package/dist/harness/memory/sqlite/agent-db.js +120 -15
  270. package/dist/harness/memory/sqlite/cognition-store.d.ts +55 -16
  271. package/dist/harness/memory/sqlite/cognition-store.js +591 -144
  272. package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
  273. package/dist/harness/memory/sqlite/memory-store.js +14 -4
  274. package/dist/harness/memory/sqlite/wisdom-store.d.ts +33 -14
  275. package/dist/harness/memory/sqlite/wisdom-store.js +257 -44
  276. package/dist/harness/memory/store.d.ts +1 -0
  277. package/dist/harness/memory/store.js +3 -0
  278. package/dist/harness/memory/time-format.d.ts +28 -0
  279. package/dist/harness/memory/time-format.js +52 -0
  280. package/dist/harness/memory/types.d.ts +343 -16
  281. package/dist/harness/memory/types.js +49 -0
  282. package/dist/harness/memory/wisdom-formation.d.ts +101 -0
  283. package/dist/harness/memory/wisdom-formation.js +304 -0
  284. package/dist/harness/memory/wisdom-gates.d.ts +50 -0
  285. package/dist/harness/memory/wisdom-gates.js +204 -0
  286. package/dist/harness/memory/wisdom-policy.d.ts +107 -0
  287. package/dist/harness/memory/wisdom-policy.js +220 -0
  288. package/dist/harness/memory/wisdom-types.d.ts +3 -2
  289. package/dist/harness/memory/wisdom-types.js +2 -2
  290. package/dist/harness/memory/wisdom.d.ts +27 -0
  291. package/dist/harness/memory/wisdom.js +181 -0
  292. package/dist/harness/observability/observer/hub.js +23 -1
  293. package/dist/harness/observability/observer/index.d.ts +2 -2
  294. package/dist/harness/observability/observer/index.js +1 -1
  295. package/dist/harness/observability/observer/types.d.ts +57 -0
  296. package/dist/harness/observability/observer/types.js +118 -9
  297. package/dist/harness/run/agent/agent.d.ts +27 -0
  298. package/dist/harness/run/agent/agent.js +45 -0
  299. package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
  300. package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
  301. package/dist/harness/run/reliability/harness-events.d.ts +4 -0
  302. package/dist/harness/run/reliability/run-agent.js +116 -20
  303. package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
  304. package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
  305. package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
  306. package/dist/harness/run/run-guard/default-run-guard.js +104 -44
  307. package/dist/harness/run/run-scope.d.ts +52 -0
  308. package/dist/harness/run/runner.d.ts +101 -16
  309. package/dist/harness/run/runner.js +557 -158
  310. package/dist/harness/session/attachments/llm-intent.js +17 -17
  311. package/dist/harness/session/history/port.js +1 -0
  312. package/dist/harness/session/in-memory-store.d.ts +1 -0
  313. package/dist/harness/session/in-memory-store.js +22 -1
  314. package/dist/harness/session/index.d.ts +1 -0
  315. package/dist/harness/session/index.js +1 -0
  316. package/dist/harness/session/schedules/index.d.ts +10 -0
  317. package/dist/harness/session/schedules/index.js +10 -0
  318. package/dist/harness/session/schedules/render.d.ts +13 -0
  319. package/dist/harness/session/schedules/render.js +63 -0
  320. package/dist/harness/session/schedules/service.d.ts +179 -0
  321. package/dist/harness/session/schedules/service.js +695 -0
  322. package/dist/harness/session/schedules/store.d.ts +119 -0
  323. package/dist/harness/session/schedules/store.js +323 -0
  324. package/dist/harness/session/schedules/tools.d.ts +39 -0
  325. package/dist/harness/session/schedules/tools.js +442 -0
  326. package/dist/harness/session/schedules/types.d.ts +104 -0
  327. package/dist/harness/session/schedules/types.js +97 -0
  328. package/dist/harness/session/tasks/tools.js +22 -0
  329. package/dist/harness/session/title.d.ts +86 -0
  330. package/dist/harness/session/title.js +268 -0
  331. package/dist/harness/session/types.d.ts +35 -0
  332. package/dist/harness/shared/events/agent-event-map.d.ts +21 -0
  333. package/dist/harness/shared/events/agent-event-map.js +1 -0
  334. package/dist/harness/shared/types/agent-definition.d.ts +23 -0
  335. package/dist/index.d.ts +25 -9
  336. package/dist/index.js +11 -2
  337. package/dist/integration/providers/anthropic.d.ts +10 -0
  338. package/dist/integration/providers/anthropic.js +44 -1
  339. package/dist/integration/providers/openai.d.ts +10 -0
  340. package/dist/integration/providers/openai.js +58 -2
  341. package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
  342. package/dist/integration/providers/wire-dump-diff.js +351 -0
  343. package/dist/integration/providers/wire-dump.d.ts +178 -0
  344. package/dist/integration/providers/wire-dump.js +396 -0
  345. package/dist/integration/storage/jsonl.d.ts +11 -0
  346. package/dist/integration/storage/jsonl.js +148 -39
  347. package/dist/integration/storage/session-index.js +63 -8
  348. package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -0
  349. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -0
  350. package/dist/subsystems/cognition-steward/conceptualize/handler.d.ts +9 -0
  351. package/dist/subsystems/cognition-steward/conceptualize/handler.js +125 -0
  352. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -0
  353. package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -0
  354. package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +12 -0
  355. package/dist/subsystems/cognition-steward/consolidate/handler.js +93 -0
  356. package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
  357. package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -0
  358. package/dist/subsystems/wisdom-steward/evaluate/handler.d.ts +18 -0
  359. package/dist/subsystems/wisdom-steward/evaluate/handler.js +91 -0
  360. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -0
  361. package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -0
  362. package/dist/subsystems/wisdom-steward/formation/handler.d.ts +18 -0
  363. package/dist/subsystems/wisdom-steward/formation/handler.js +212 -0
  364. package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -0
  365. package/dist/subsystems/wisdom-steward/govern/handler.d.ts +17 -0
  366. package/dist/subsystems/wisdom-steward/govern/handler.js +68 -0
  367. package/package.json +115 -115
  368. package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
  369. package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
  370. package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
  371. package/dist/harness/collaboration/multi-agent/index.js +0 -15
  372. package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
  373. package/dist/harness/collaboration/multi-agent/process.js +0 -256
  374. package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
  375. package/dist/harness/collaboration/multi-agent/registry.js +0 -137
  376. package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
  377. package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
  378. package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
  379. package/dist/harness/collaboration/multi-agent/types.js +0 -15
  380. package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
  381. package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
  382. package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
  383. package/dist/harness/collaboration/orchestration/async-task.js +0 -359
  384. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
  385. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
  386. package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
  387. package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
  388. package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
  389. package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
  390. package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
  391. package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
  392. package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
  393. package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
  394. package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
  395. package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
  396. package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
  397. package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
  398. package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
  399. package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
  400. package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
  401. package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
  402. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
  403. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
  404. package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
  405. package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
  406. package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
  407. package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
  408. package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
  409. package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
  410. package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
  411. package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
  412. package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
  413. package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
  414. package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
  415. package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
  416. package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
  417. package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
  418. package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
  419. package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
  420. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
  421. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.js +0 -0
@@ -143,10 +143,15 @@ export declare class KnowledgeSourceStore {
143
143
  /**
144
144
  * 生成 agent 可见 catalog(Tier 0)
145
145
  * 默认返回可见全集(display 截断在 KnowledgeLayer);maxEntries 仅作安全硬顶
146
+ * identity 必须与 UI 挂载查询同口径(tenant/gateway),否则会误命中他方挂载行
146
147
  */
147
148
  catalogFor(agentId: string, opts?: {
148
149
  sessionId?: string;
149
150
  maxEntries?: number;
151
+ identity?: {
152
+ tenantId?: string;
153
+ gatewayId?: string;
154
+ };
150
155
  }): KnowledgeCatalogItem[];
151
156
  /** 规模 + topics(短 TTL 缓存;禁止每轮全表拉 path) */
152
157
  private catalogExtras;
@@ -163,12 +168,22 @@ export declare class KnowledgeSourceStore {
163
168
  */
164
169
  catalogFingerprint(agentId: string, opts?: {
165
170
  sessionId?: string;
171
+ identity?: {
172
+ tenantId?: string;
173
+ gatewayId?: string;
174
+ };
166
175
  }): string;
167
176
  /**
168
177
  * 可见源列表(effective = base ⊕ session overlay;含 hiddenFromCatalog)
169
178
  */
170
- listVisible(agentId: string, sessionId?: string): KnowledgeSource[];
179
+ listVisible(agentId: string, sessionId?: string, identity?: {
180
+ tenantId?: string;
181
+ gatewayId?: string;
182
+ }): KnowledgeSource[];
171
183
  /** Agent 级 base 可见源(不含会话 overlay) */
172
- listBaseVisible(agentId: string, sessionId?: string): KnowledgeSource[];
184
+ listBaseVisible(agentId: string, sessionId?: string, identity?: {
185
+ tenantId?: string;
186
+ gatewayId?: string;
187
+ }): KnowledgeSource[];
173
188
  private upsertRow;
174
189
  }
@@ -528,10 +528,11 @@ export class KnowledgeSourceStore {
528
528
  /**
529
529
  * 生成 agent 可见 catalog(Tier 0)
530
530
  * 默认返回可见全集(display 截断在 KnowledgeLayer);maxEntries 仅作安全硬顶
531
+ * identity 必须与 UI 挂载查询同口径(tenant/gateway),否则会误命中他方挂载行
531
532
  */
532
533
  catalogFor(agentId, opts) {
533
534
  const max = opts?.maxEntries ?? 200;
534
- const visible = this.list().filter((s) => this.isVisible(s, agentId, opts?.sessionId));
535
+ const visible = this.list().filter((s) => this.isVisible(s, agentId, opts?.sessionId, opts?.identity));
535
536
  const sorted = [...visible].sort((a, b) => {
536
537
  const pa = a.catalogPriority ?? 0;
537
538
  const pb = b.catalogPriority ?? 0;
@@ -604,12 +605,12 @@ export class KnowledgeSourceStore {
604
605
  /**
605
606
  * 可见源列表(effective = base ⊕ session overlay;含 hiddenFromCatalog)
606
607
  */
607
- listVisible(agentId, sessionId) {
608
- return this.list().filter((s) => this.isVisible(s, agentId, sessionId));
608
+ listVisible(agentId, sessionId, identity) {
609
+ return this.list().filter((s) => this.isVisible(s, agentId, sessionId, identity));
609
610
  }
610
611
  /** Agent 级 base 可见源(不含会话 overlay) */
611
- listBaseVisible(agentId, sessionId) {
612
- return this.list().filter((s) => this.isBaseVisible(s, agentId, sessionId));
612
+ listBaseVisible(agentId, sessionId, identity) {
613
+ return this.list().filter((s) => this.isBaseVisible(s, agentId, sessionId, identity));
613
614
  }
614
615
  upsertRow(source) {
615
616
  this.db.raw
@@ -110,6 +110,8 @@ export interface LocalWriteDeps {
110
110
  db: KnowledgeDatabase;
111
111
  documentConfig?: DocumentCapabilityConfig | null;
112
112
  embeddingProvider?: EmbeddingProvider | null;
113
+ /** source.authRef 解析(SEC-3c consumer 绑定强制) */
114
+ credentials?: import('../governance/credentials/store.js').CredentialStore | null;
113
115
  embed?: {
114
116
  enabled?: boolean;
115
117
  embedBatch?: number;
@@ -28,6 +28,7 @@ export class LocalKnowledgeWriteService {
28
28
  indexStore: this.index,
29
29
  documentConfig: deps.documentConfig ?? null,
30
30
  embeddingProvider: embed?.enabled === false ? null : (deps.embeddingProvider ?? null),
31
+ credentials: deps.credentials ?? null,
31
32
  ...(embed?.embedBatch != null ? { embedBatch: embed.embedBatch } : {}),
32
33
  ...(embed?.embedMinIntervalMs != null ? { embedMinIntervalMs: embed.embedMinIntervalMs } : {}),
33
34
  ...(embed?.embedConcurrency != null ? { embedConcurrency: embed.embedConcurrency } : {}),
@@ -50,19 +51,19 @@ export class LocalKnowledgeWriteService {
50
51
  async upsertPrincipal(identity, agentId, body) {
51
52
  const now = Date.now();
52
53
  this.db.raw
53
- .prepare(`INSERT INTO knowledge_principals
54
- (tenant_id, gateway_id, local_agent_id, display_name, status, last_seen_at, created_at, updated_at)
55
- VALUES (?, ?, ?, ?, ?, ?, ?, ?)
56
- ON CONFLICT(tenant_id, gateway_id, local_agent_id) DO UPDATE SET
57
- display_name = COALESCE(excluded.display_name, knowledge_principals.display_name),
58
- status = excluded.status,
59
- last_seen_at = excluded.last_seen_at,
54
+ .prepare(`INSERT INTO knowledge_principals
55
+ (tenant_id, gateway_id, local_agent_id, display_name, status, last_seen_at, created_at, updated_at)
56
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?)
57
+ ON CONFLICT(tenant_id, gateway_id, local_agent_id) DO UPDATE SET
58
+ display_name = COALESCE(excluded.display_name, knowledge_principals.display_name),
59
+ status = excluded.status,
60
+ last_seen_at = excluded.last_seen_at,
60
61
  updated_at = excluded.updated_at`)
61
62
  .run(identity.tenantId, identity.gatewayId, agentId, body.displayName ?? null, body.status ?? 'active', now, now, now);
62
63
  }
63
64
  async ensurePrincipal(identity, agentId, autoRegister) {
64
65
  const row = this.db.raw
65
- .prepare(`SELECT status FROM knowledge_principals
66
+ .prepare(`SELECT status FROM knowledge_principals
66
67
  WHERE tenant_id = ? AND gateway_id = ? AND local_agent_id = ?`)
67
68
  .get(identity.tenantId, identity.gatewayId, agentId);
68
69
  if (row)
@@ -79,7 +80,7 @@ export class LocalKnowledgeWriteService {
79
80
  // 不得按 gateway 预过滤后再比较——那是永不失败的空检查。
80
81
  // 同名 principal 可挂多 gateway(复合 PK);仅当**另一 gateway 已登记**时拒绝。
81
82
  const rows = this.db.raw
82
- .prepare(`SELECT gateway_id FROM knowledge_principals
83
+ .prepare(`SELECT gateway_id FROM knowledge_principals
83
84
  WHERE tenant_id = ? AND local_agent_id = ?`)
84
85
  .all(identity.tenantId, agentId);
85
86
  const foreign = rows.find((r) => r.gateway_id !== identity.gatewayId);
@@ -89,7 +90,7 @@ export class LocalKnowledgeWriteService {
89
90
  }
90
91
  async createProject(identity, input) {
91
92
  const existing = this.db.raw
92
- .prepare(`SELECT registered_by FROM knowledge_projects
93
+ .prepare(`SELECT registered_by FROM knowledge_projects
93
94
  WHERE tenant_id = ? AND project_key = ?`)
94
95
  .get(identity.tenantId, input.projectKey);
95
96
  if (existing?.registered_by && existing.registered_by !== identity.gatewayId) {
@@ -103,7 +104,7 @@ export class LocalKnowledgeWriteService {
103
104
  });
104
105
  const visibility = input.visibility === 'public' ? 'public' : 'private';
105
106
  this.db.raw
106
- .prepare(`UPDATE knowledge_projects SET registered_by = ?, visibility = ?
107
+ .prepare(`UPDATE knowledge_projects SET registered_by = ?, visibility = ?
107
108
  WHERE tenant_id = ? AND project_key = ?`)
108
109
  .run(identity.gatewayId, visibility, identity.tenantId, input.projectKey);
109
110
  return {
@@ -115,7 +116,7 @@ export class LocalKnowledgeWriteService {
115
116
  }
116
117
  async removeProject(identity, projectKey) {
117
118
  const row = this.db.raw
118
- .prepare(`SELECT registered_by FROM knowledge_projects
119
+ .prepare(`SELECT registered_by FROM knowledge_projects
119
120
  WHERE tenant_id = ? AND project_key = ?`)
120
121
  .get(identity.tenantId, projectKey);
121
122
  if (row?.registered_by && row.registered_by !== identity.gatewayId) {
@@ -142,7 +143,7 @@ export class LocalKnowledgeWriteService {
142
143
  delete input.tenant_id;
143
144
  const src = this.sources.register(input);
144
145
  this.db.raw
145
- .prepare(`UPDATE knowledge_sources SET registered_by = ?, visibility = ?, tenant_id = ?
146
+ .prepare(`UPDATE knowledge_sources SET registered_by = ?, visibility = ?, tenant_id = ?
146
147
  WHERE id = ?`)
147
148
  .run(identity.gatewayId, typeof input.visibility === 'string' ? input.visibility : 'private', identity.tenantId, src.id);
148
149
  void this.ingest.ingestSource(src.id, { full: true }).catch((e) => {
@@ -2,7 +2,7 @@
2
2
  * BackfillTrigger — 补录脉搏协调器
3
3
  *
4
4
  * 时机:
5
- * - 硬收敛(session → recent / /new / idle reset)立即评估并 emit
5
+ * - 硬收敛(session → recent / `/new`)立即评估并 emit
6
6
  * - 空闲漂移(默认 20min)软收敛
7
7
  * - 覆盖差扫描(默认 6h)兜底
8
8
  *
@@ -60,7 +60,7 @@ export declare class BackfillTrigger {
60
60
  noteActivity(sessionId: string, agentId?: string, at?: number): void;
61
61
  /**
62
62
  * 硬收敛:立即评估并 emit(穿透意图是「这段干完了」)
63
- * 可传入 session 快照,避免 reset 清空 messages 后读到空库。
63
+ * 可传入 session 快照;`/new` 后旧会话仍可读,事件快照与 store 并存。
64
64
  */
65
65
  requestHardConverge(input: {
66
66
  sessionId: string;
@@ -2,7 +2,7 @@
2
2
  * BackfillTrigger — 补录脉搏协调器
3
3
  *
4
4
  * 时机:
5
- * - 硬收敛(session → recent / /new / idle reset)立即评估并 emit
5
+ * - 硬收敛(session → recent / `/new`)立即评估并 emit
6
6
  * - 空闲漂移(默认 20min)软收敛
7
7
  * - 覆盖差扫描(默认 6h)兜底
8
8
  *
@@ -61,7 +61,7 @@ export class BackfillTrigger {
61
61
  void this.requestHardConverge({
62
62
  sessionId,
63
63
  agentId,
64
- // idle reset 场景 messages 即将被清空:优先用事件携带的快照
64
+ // 事件可带 sessionText 快照;store.messages 不会因 lifecycle 收敛被清空
65
65
  sessionText: typeof data.sessionText === 'string' ? data.sessionText : undefined,
66
66
  trigger: 'hard_converge',
67
67
  });
@@ -104,7 +104,7 @@ export class BackfillTrigger {
104
104
  }
105
105
  /**
106
106
  * 硬收敛:立即评估并 emit(穿透意图是「这段干完了」)
107
- * 可传入 session 快照,避免 reset 清空 messages 后读到空库。
107
+ * 可传入 session 快照;`/new` 后旧会话仍可读,事件快照与 store 并存。
108
108
  */
109
109
  async requestHardConverge(input) {
110
110
  return this.evaluateAndEmit({
@@ -177,7 +177,7 @@ export class BackfillTrigger {
177
177
  session = undefined;
178
178
  }
179
179
  }
180
- // 快照优先:idle reset / `/new` 会在 store.messages 清空后才可见,
180
+ // 事件快照优先;store.messages 仍保留全量 Discourse
181
181
  // 此时必须用事件里的 sessionText,不得退回空密度。
182
182
  const snapshot = input.sessionText?.trim() ? input.sessionText : undefined;
183
183
  const sessionText = snapshot ?? (session ? this.renderSessionText(session) : undefined);
@@ -0,0 +1,36 @@
1
+ /**
2
+ * Cognition 边衰减曲线 — 按 relationType 的日衰减率
3
+ *
4
+ * @module harness/memory/cognition-decay
5
+ */
6
+ import type { ConceptRelationType, ConceptStatus } from './types.js';
7
+ /** 每日衰减乘数(0–1;越小越快弱) */
8
+ export declare const DEFAULT_EDGE_DECAY_PER_DAY: Record<ConceptRelationType, number>;
9
+ export declare const DEFAULT_EDGE_DECAY_FLOOR = 0.02;
10
+ export type EdgeDecayConfig = Partial<Record<ConceptRelationType, number>>;
11
+ /**
12
+ * 将日衰减率换算到时间间隔后的乘数。
13
+ *
14
+ * @param rate - 每日衰减比例(0.05 表示每日 ×0.95)
15
+ * @param days - 经过的天数
16
+ * @returns 乘数(≥0)
17
+ */
18
+ export declare function decayMultiplier(rate: number, days: number): number;
19
+ /**
20
+ * 下一强度 = max(floor, w × mult)
21
+ */
22
+ export declare function nextEdgeStrength(current: number, relationType: ConceptRelationType, days: number, config?: EdgeDecayConfig, floor?: number): number;
23
+ /**
24
+ * Hebbian 异步累积:w' = 1 - (1-w)(1-η·e)
25
+ *
26
+ * @param current - 当前边权
27
+ * @param eta - 学习率(默认 0.15)
28
+ * @param evidence - 证据强度 0–1
29
+ */
30
+ export declare function hebbianStrengthen(current: number, evidence: number, eta?: number): number;
31
+ /**
32
+ * 反证降权:w' = w × (1-ρ)
33
+ */
34
+ export declare function counterEvidenceWeaken(current: number, rho?: number): number;
35
+ /** Layer 默认只吃 active / strengthened */
36
+ export declare const DEFAULT_RETRIEVE_STATUSES: ConceptStatus[];
@@ -0,0 +1,55 @@
1
+ /**
2
+ * Cognition 边衰减曲线 — 按 relationType 的日衰减率
3
+ *
4
+ * @module harness/memory/cognition-decay
5
+ */
6
+ /** 每日衰减乘数(0–1;越小越快弱) */
7
+ export const DEFAULT_EDGE_DECAY_PER_DAY = {
8
+ related: 0.05,
9
+ similar_to: 0.03,
10
+ opposes: 0.02,
11
+ causes: 0.01,
12
+ part_of: 0.01,
13
+ evolves_to: 0.01,
14
+ };
15
+ export const DEFAULT_EDGE_DECAY_FLOOR = 0.02;
16
+ /**
17
+ * 将日衰减率换算到时间间隔后的乘数。
18
+ *
19
+ * @param rate - 每日衰减比例(0.05 表示每日 ×0.95)
20
+ * @param days - 经过的天数
21
+ * @returns 乘数(≥0)
22
+ */
23
+ export function decayMultiplier(rate, days) {
24
+ if (days <= 0)
25
+ return 1;
26
+ const dailyKeep = Math.max(0, 1 - rate);
27
+ return Math.pow(dailyKeep, days);
28
+ }
29
+ /**
30
+ * 下一强度 = max(floor, w × mult)
31
+ */
32
+ export function nextEdgeStrength(current, relationType, days, config, floor = DEFAULT_EDGE_DECAY_FLOOR) {
33
+ const rate = config?.[relationType] ?? DEFAULT_EDGE_DECAY_PER_DAY[relationType];
34
+ return Math.max(floor, current * decayMultiplier(rate, days));
35
+ }
36
+ /**
37
+ * Hebbian 异步累积:w' = 1 - (1-w)(1-η·e)
38
+ *
39
+ * @param current - 当前边权
40
+ * @param eta - 学习率(默认 0.15)
41
+ * @param evidence - 证据强度 0–1
42
+ */
43
+ export function hebbianStrengthen(current, evidence, eta = 0.15) {
44
+ const e = Math.min(1, Math.max(0, evidence));
45
+ const w = Math.min(1, Math.max(0, current));
46
+ return 1 - (1 - w) * (1 - eta * e);
47
+ }
48
+ /**
49
+ * 反证降权:w' = w × (1-ρ)
50
+ */
51
+ export function counterEvidenceWeaken(current, rho = 0.3) {
52
+ return Math.max(0, current * (1 - Math.min(1, Math.max(0, rho))));
53
+ }
54
+ /** Layer 默认只吃 active / strengthened */
55
+ export const DEFAULT_RETRIEVE_STATUSES = ['active', 'strengthened'];
@@ -0,0 +1,60 @@
1
+ /**
2
+ * Cognition gates — 概念/关系准入执法(结构,不猜语义)
3
+ *
4
+ * 意图判断(是否可复用单元、关系假设)归 LLM;本模块只做:
5
+ * cue 校验、证据等级、保守降级、MDL 出生门槛、伪概念/密钥形态。
6
+ *
7
+ * @module harness/memory/cognition-gates
8
+ */
9
+ import type { AdmitConceptInput, ConceptGateReason, ConceptRelationType, EdgeBasis, EvidenceClass } from './types.js';
10
+ export interface ConceptGateOutcome {
11
+ ok: boolean;
12
+ reason: ConceptGateReason;
13
+ message?: string;
14
+ }
15
+ /** 归一化空白,用于 cue ⊆ evidence 子串校验 */
16
+ export declare function normalizeForCue(text: string): string;
17
+ /**
18
+ * 概念结构门控。
19
+ *
20
+ * @param input - 候选概念
21
+ * @param options - capacityAdmitStop 时禁止新生
22
+ * @returns 是否准入与 reason code
23
+ */
24
+ export declare function evaluateConceptGate(input: AdmitConceptInput, options?: {
25
+ capacityAdmitStop?: boolean;
26
+ }): ConceptGateOutcome;
27
+ export interface EdgeLicenseInput {
28
+ relationType: ConceptRelationType;
29
+ evidenceClass: EvidenceClass;
30
+ cue: string;
31
+ /** evidence + contextSlice 全文;用于 cue 子串校验 */
32
+ evidenceText?: string;
33
+ memoryIds: string[];
34
+ /** 对应 memory 的 status;用于「1 条 strengthened + 失败→修复」例外 */
35
+ memoryStatuses?: Array<'shadow' | 'active' | 'strengthened'>;
36
+ /** 对应 memory 的 channel;strengthened 例外要求 fail_fix */
37
+ memoryChannels?: Array<'user_directive' | 'decision' | 'fail_fix' | 'model_inference' | 'admin'>;
38
+ /** 配置:causes 最少独立命题(默认 2) */
39
+ causesMinIndependentMemories?: number;
40
+ }
41
+ export interface EdgeLicenseOutcome {
42
+ ok: boolean;
43
+ /** 实际应入库的关系类型(可能已降级) */
44
+ relationType: ConceptRelationType;
45
+ status: 'active' | 'shadow' | 'demoted' | 'candidate_only' | 'rejected';
46
+ reason: ConceptGateReason;
47
+ message?: string;
48
+ }
49
+ /**
50
+ * 关系持证门:强边需 cue ⊆ 证据 ∧ 证据形态匹配 ∧ 独立多证据。
51
+ * 任何不满足 → 保守降级为 `related` 或 candidate_only / rejected。
52
+ * **禁止** 共现升格为强类型。
53
+ */
54
+ export declare function licenseEdge(input: EdgeLicenseInput): EdgeLicenseOutcome;
55
+ /**
56
+ * 校验 basis 与许可结果一致;不一致时强制保守。
57
+ */
58
+ export declare function edgeBasisFromLicense(license: EdgeLicenseOutcome, basis: Omit<EdgeBasis, 'licensedAt'> & {
59
+ licensedAt?: number;
60
+ }): EdgeBasis;
@@ -0,0 +1,191 @@
1
+ /**
2
+ * Cognition gates — 概念/关系准入执法(结构,不猜语义)
3
+ *
4
+ * 意图判断(是否可复用单元、关系假设)归 LLM;本模块只做:
5
+ * cue 校验、证据等级、保守降级、MDL 出生门槛、伪概念/密钥形态。
6
+ *
7
+ * @module harness/memory/cognition-gates
8
+ */
9
+ import { CONCEPT_KINDS, CONCEPT_RELATION_TYPES, STRONG_RELATION_TYPES, } from './types.js';
10
+ const SECRET_LIKE = /(?:api[_-]?key|secret|password|token)\s*[:=]\s*\S{8,}/i;
11
+ const STOPWORD = /^(?:the|a|an|this|that|it|is|are|was|were|and|or|of|to|in|for)$/i;
12
+ const CJK = /[一-鿿]/;
13
+ /** 归一化空白,用于 cue ⊆ evidence 子串校验 */
14
+ export function normalizeForCue(text) {
15
+ return text.replace(/\s+/g, ' ').trim().toLowerCase();
16
+ }
17
+ /**
18
+ * 概念结构门控。
19
+ *
20
+ * @param input - 候选概念
21
+ * @param options - capacityAdmitStop 时禁止新生
22
+ * @returns 是否准入与 reason code
23
+ */
24
+ export function evaluateConceptGate(input, options) {
25
+ const name = (input.name ?? '').trim();
26
+ if (!name)
27
+ return { ok: false, reason: 'empty_name' };
28
+ if (!CONCEPT_KINDS.includes(input.kind)) {
29
+ return { ok: false, reason: 'invalid_kind', message: `kind=${input.kind}` };
30
+ }
31
+ if (SECRET_LIKE.test(name) || SECRET_LIKE.test(input.description ?? '')) {
32
+ return { ok: false, reason: 'secret_like' };
33
+ }
34
+ if (STOPWORD.test(name) || /^\d+$/.test(name)) {
35
+ return { ok: false, reason: 'pseudo_concept', message: 'stopword or numeric' };
36
+ }
37
+ // 非 CJK 拉丁名至少 2 字符;CJK 允许单字(锁、库…)
38
+ if (name.length < 2 && !CJK.test(name)) {
39
+ return { ok: false, reason: 'pseudo_concept', message: 'name too short' };
40
+ }
41
+ const support = input.supportCount ?? input.memoryIds?.length ?? 0;
42
+ const highValueKind = ['method', 'constraint', 'construct'];
43
+ if (support < 2 && !(support >= 1 && highValueKind.includes(input.kind))) {
44
+ return {
45
+ ok: false,
46
+ reason: 'mdl_insufficient',
47
+ message: `support=${support} kind=${input.kind}`,
48
+ };
49
+ }
50
+ if (options?.capacityAdmitStop) {
51
+ return { ok: false, reason: 'capacity_admit_stop' };
52
+ }
53
+ return { ok: true, reason: 'ok' };
54
+ }
55
+ // ── 关系持证 ──
56
+ /** relationType → 允许的 evidenceClass */
57
+ const RELATION_EVIDENCE = {
58
+ causes: ['causal'],
59
+ part_of: ['mereonymy'],
60
+ opposes: ['negation'],
61
+ similar_to: ['analogy'],
62
+ evolves_to: ['evolution'],
63
+ related: ['cooccur', 'causal', 'mereonymy', 'negation', 'analogy', 'evolution'],
64
+ };
65
+ /**
66
+ * 关系持证门:强边需 cue ⊆ 证据 ∧ 证据形态匹配 ∧ 独立多证据。
67
+ * 任何不满足 → 保守降级为 `related` 或 candidate_only / rejected。
68
+ * **禁止** 共现升格为强类型。
69
+ */
70
+ export function licenseEdge(input) {
71
+ const rel = input.relationType;
72
+ if (!CONCEPT_RELATION_TYPES.includes(rel)) {
73
+ return {
74
+ ok: false,
75
+ relationType: rel,
76
+ status: 'rejected',
77
+ reason: 'invalid_relation',
78
+ message: `relationType=${rel}`,
79
+ };
80
+ }
81
+ const allowed = RELATION_EVIDENCE[rel] ?? [];
82
+ const classOk = allowed.includes(input.evidenceClass);
83
+ const isStrong = STRONG_RELATION_TYPES.includes(rel);
84
+ // cue 校验(有 evidenceText 时强制)
85
+ if (input.evidenceText != null && input.evidenceText !== '') {
86
+ const hay = normalizeForCue(input.evidenceText);
87
+ const needle = normalizeForCue(input.cue ?? '');
88
+ if (!needle || !hay.includes(needle)) {
89
+ if (isStrong) {
90
+ return {
91
+ ok: true,
92
+ relationType: 'related',
93
+ status: 'demoted',
94
+ reason: 'cue_mismatch',
95
+ message: 'strong relation cue not in evidence; demoted to related',
96
+ };
97
+ }
98
+ return {
99
+ ok: false,
100
+ relationType: 'related',
101
+ status: 'rejected',
102
+ reason: 'cue_mismatch',
103
+ };
104
+ }
105
+ }
106
+ if (!classOk) {
107
+ if (isStrong) {
108
+ return {
109
+ ok: true,
110
+ relationType: 'related',
111
+ status: 'demoted',
112
+ reason: 'demoted_related',
113
+ message: `evidenceClass=${input.evidenceClass} cannot license ${rel}`,
114
+ };
115
+ }
116
+ return {
117
+ ok: false,
118
+ relationType: 'related',
119
+ status: 'rejected',
120
+ reason: 'demoted_related',
121
+ };
122
+ }
123
+ // 强边多证据(调用方应传入同 pair 累积 memoryIds)
124
+ const min = input.causesMinIndependentMemories ?? 2;
125
+ const memCount = new Set(input.memoryIds ?? []).size;
126
+ const hasStrengthened = (input.memoryStatuses ?? []).includes('strengthened');
127
+ const hasFailFix = (input.memoryChannels ?? []).includes('fail_fix');
128
+ if (rel === 'causes') {
129
+ // 2 条独立,或 1 条 strengthened + 失败→修复闭环(fail_fix)
130
+ const closedLoop = memCount >= 1 && hasStrengthened && hasFailFix && input.evidenceClass === 'causal';
131
+ const licensed = memCount >= min || closedLoop;
132
+ if (!licensed) {
133
+ return {
134
+ ok: true,
135
+ relationType: 'related',
136
+ status: 'candidate_only',
137
+ reason: memCount < 1 ? 'cue_mismatch' : 'multi_evidence_required',
138
+ message: `causes needs ≥${min} independent memories (have ${memCount}) or strengthened+fail_fix`,
139
+ };
140
+ }
141
+ }
142
+ else if (rel === 'opposes') {
143
+ // 2 条独立,或 supersede/否定极性(negation 类 1 条可 shadow 持证,2 条才 active)
144
+ if (memCount < 2) {
145
+ return {
146
+ ok: true,
147
+ relationType: rel,
148
+ status: 'shadow',
149
+ reason: 'multi_evidence_required',
150
+ message: `opposes needs ≥2 independent memories (have ${memCount})`,
151
+ };
152
+ }
153
+ }
154
+ else if (isStrong) {
155
+ // part_of / evolves_to:至少 1 条持证件
156
+ if (memCount < 1) {
157
+ return {
158
+ ok: true,
159
+ relationType: 'related',
160
+ status: 'shadow',
161
+ reason: 'multi_evidence_required',
162
+ };
163
+ }
164
+ }
165
+ // related / 共现:永远 shadow,不得因强度升格
166
+ if (rel === 'related' || input.evidenceClass === 'cooccur') {
167
+ return {
168
+ ok: true,
169
+ relationType: 'related',
170
+ status: isStrong ? 'demoted' : 'shadow',
171
+ reason: input.evidenceClass === 'cooccur' && rel !== 'related' ? 'cooccur_no_escalation' : 'ok',
172
+ };
173
+ }
174
+ return {
175
+ ok: true,
176
+ relationType: rel,
177
+ status: 'active',
178
+ reason: 'ok',
179
+ };
180
+ }
181
+ /**
182
+ * 校验 basis 与许可结果一致;不一致时强制保守。
183
+ */
184
+ export function edgeBasisFromLicense(license, basis) {
185
+ return {
186
+ memoryIds: basis.memoryIds ?? [],
187
+ cue: basis.cue ?? '',
188
+ evidenceClass: basis.evidenceClass,
189
+ licensedAt: basis.licensedAt ?? Date.now(),
190
+ };
191
+ }
@@ -0,0 +1,30 @@
1
+ /**
2
+ * Cognition 触发 — 命题落库后 emit 概念化请求
3
+ *
4
+ * 事件类型必须真实存在于 EventBus;sense.source=`eventBus` 才会挂监听。
5
+ *
6
+ * @module harness/memory/cognition-trigger
7
+ */
8
+ import type { EventBus } from '@octopi-agent/core/primitives/event-bus.js';
9
+ import type { MemoryChannel, MemoryStatus, MemoryType } from './types.js';
10
+ /** 概念化请求(cognition.steward.conceptualize 监听) */
11
+ export declare const COGNITIZE_REQUEST_EVENT = "cognition.conceptualize.request";
12
+ export interface ConceptualizeRequestPayload {
13
+ memoryId: string;
14
+ proposition: string;
15
+ evidence: string;
16
+ memoryType: MemoryType;
17
+ memoryStatus?: MemoryStatus;
18
+ channel?: MemoryChannel;
19
+ /** 证据周边语境;缺省由 handler 从 session 补 */
20
+ contextSlice?: string;
21
+ sessionId?: string;
22
+ agentId?: string;
23
+ }
24
+ /**
25
+ * 发射概念化请求。失败静默(不得阻断 memory 写路径)。
26
+ *
27
+ * @param events - EventBus
28
+ * @param payload - 请求载荷
29
+ */
30
+ export declare function emitConceptualizeRequest(events: EventBus | undefined, payload: ConceptualizeRequestPayload): void;
@@ -0,0 +1,41 @@
1
+ /**
2
+ * Cognition 触发 — 命题落库后 emit 概念化请求
3
+ *
4
+ * 事件类型必须真实存在于 EventBus;sense.source=`eventBus` 才会挂监听。
5
+ *
6
+ * @module harness/memory/cognition-trigger
7
+ */
8
+ /** 概念化请求(cognition.steward.conceptualize 监听) */
9
+ export const COGNITIZE_REQUEST_EVENT = 'cognition.conceptualize.request';
10
+ /**
11
+ * 发射概念化请求。失败静默(不得阻断 memory 写路径)。
12
+ *
13
+ * @param events - EventBus
14
+ * @param payload - 请求载荷
15
+ */
16
+ export function emitConceptualizeRequest(events, payload) {
17
+ if (!events)
18
+ return;
19
+ try {
20
+ events.emit({
21
+ type: COGNITIZE_REQUEST_EVENT,
22
+ timestamp: Date.now(),
23
+ agentId: payload.agentId,
24
+ sessionId: payload.sessionId,
25
+ data: {
26
+ memoryId: payload.memoryId,
27
+ proposition: payload.proposition,
28
+ evidence: payload.evidence,
29
+ memoryType: payload.memoryType,
30
+ memoryStatus: payload.memoryStatus,
31
+ channel: payload.channel,
32
+ contextSlice: payload.contextSlice,
33
+ sessionId: payload.sessionId,
34
+ agentId: payload.agentId,
35
+ },
36
+ });
37
+ }
38
+ catch {
39
+ // 总线异常不得拖垮 Memory 写入
40
+ }
41
+ }
@@ -1,4 +1,4 @@
1
1
  /**
2
2
  * Cognition 类型 — 规范定义在 ./types.ts
3
3
  */
4
- export type { ConceptNode, ConceptEdge, ConceptGraph, ConceptGraphStore, } from './types.js';
4
+ export type { ConceptKind, ConceptRelationType, ConceptStatus, EvidenceClass, EdgeBasis, ConceptNode, ConceptEdge, ConceptGraph, MergeCandidate, EdgeAux, AdmitConceptInput, AdmitConceptResult, AdmitEdgeInput, AdmitEdgeResult, ConceptGateReason, SpreadingActivateOptions, ActivatedGraph, ConceptGraphStats, DecayResult, ConceptGraphStore, } from './types.js';