@octopi-agent/engine 0.98.4 → 0.121.10

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 (493) hide show
  1. package/dist/builtin-model-info.js +28 -7
  2. package/dist/config-admin/agent-presets.d.ts +32 -0
  3. package/dist/config-admin/agent-presets.js +133 -0
  4. package/dist/config-admin/discover.d.ts +33 -4
  5. package/dist/config-admin/discover.js +101 -6
  6. package/dist/config-admin/env.d.ts +11 -0
  7. package/dist/config-admin/env.js +41 -0
  8. package/dist/config-admin/error-copy.d.ts +106 -0
  9. package/dist/config-admin/error-copy.js +287 -0
  10. package/dist/config-admin/i18n.d.ts +21 -0
  11. package/dist/config-admin/i18n.js +19 -0
  12. package/dist/config-admin/index.d.ts +6 -2
  13. package/dist/config-admin/index.js +3 -1
  14. package/dist/config-admin/model-presets.d.ts +14 -0
  15. package/dist/config-admin/model-presets.js +595 -70
  16. package/dist/config-admin/onboarding-apply.d.ts +71 -0
  17. package/dist/config-admin/onboarding-apply.js +235 -0
  18. package/dist/config-admin/onboarding.d.ts +154 -0
  19. package/dist/config-admin/onboarding.js +270 -0
  20. package/dist/config-admin/redact.d.ts +42 -9
  21. package/dist/config-admin/redact.js +69 -5
  22. package/dist/config-schema/agent.d.ts +40 -6
  23. package/dist/config-schema/agent.js +44 -6
  24. package/dist/config-schema/browser.d.ts +62 -0
  25. package/dist/config-schema/browser.js +89 -0
  26. package/dist/config-schema/context.d.ts +12 -37
  27. package/dist/config-schema/context.js +10 -31
  28. package/dist/config-schema/engine.d.ts +140 -164
  29. package/dist/config-schema/engine.js +10 -7
  30. package/dist/config-schema/governance.d.ts +20 -2
  31. package/dist/config-schema/governance.js +18 -3
  32. package/dist/config-schema/models.d.ts +10 -12
  33. package/dist/config-schema/models.js +16 -3
  34. package/dist/config-schema/run.d.ts +6 -2
  35. package/dist/config-schema/run.js +12 -2
  36. package/dist/config-schema/shared.d.ts +1 -3
  37. package/dist/config-schema/shared.js +4 -4
  38. package/dist/config-schema/substrate.d.ts +19 -88
  39. package/dist/config-schema/substrate.js +30 -107
  40. package/dist/config.d.ts +161 -123
  41. package/dist/config.js +109 -7
  42. package/dist/file-mode.d.ts +67 -0
  43. package/dist/file-mode.js +182 -0
  44. package/dist/fork-child.d.ts +82 -0
  45. package/dist/fork-child.js +123 -0
  46. package/dist/harness/activation/delegated-run.d.ts +42 -0
  47. package/dist/harness/activation/delegated-run.js +71 -0
  48. package/dist/harness/activation/dispatcher.js +11 -0
  49. package/dist/harness/activation/inbox.d.ts +3 -3
  50. package/dist/harness/activation/inbox.js +3 -3
  51. package/dist/harness/activation/index.d.ts +1 -0
  52. package/dist/harness/activation/run-backend.d.ts +92 -0
  53. package/dist/harness/activation/run-backend.js +16 -0
  54. package/dist/harness/activation/run-protocol.d.ts +392 -0
  55. package/dist/harness/activation/run-protocol.js +19 -0
  56. package/dist/harness/activation/runtime.d.ts +33 -0
  57. package/dist/harness/activation/runtime.js +130 -31
  58. package/dist/harness/activation/types.d.ts +20 -3
  59. package/dist/harness/agent/builder.d.ts +36 -3
  60. package/dist/harness/agent/builder.js +206 -46
  61. package/dist/harness/agent/config-bridge.d.ts +10 -1
  62. package/dist/harness/agent/config-bridge.js +24 -5
  63. package/dist/harness/agent/config-integrity.js +19 -2
  64. package/dist/harness/agent/registered-tool-adapter.d.ts +27 -0
  65. package/dist/harness/agent/registered-tool-adapter.js +67 -0
  66. package/dist/harness/agent/wire-agent-builder.d.ts +13 -3
  67. package/dist/harness/agent/wire-agent-builder.js +35 -9
  68. package/dist/harness/capabilities/document/backends/plain.js +2 -1
  69. package/dist/harness/capabilities/document/factory.d.ts +5 -0
  70. package/dist/harness/capabilities/document/factory.js +1 -0
  71. package/dist/harness/capabilities/document/legacy/factory.js +3 -2
  72. package/dist/harness/capabilities/document/port.js +6 -3
  73. package/dist/harness/capabilities/document/types.d.ts +5 -0
  74. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.d.ts +17 -0
  75. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.js +66 -36
  76. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.d.ts +6 -2
  77. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.js +27 -7
  78. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +13 -0
  79. package/dist/harness/collaboration/autonomous-subsystem/loader.js +2 -1
  80. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +11 -0
  81. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -0
  82. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +14 -4
  83. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +50 -41
  84. package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.js +4 -4
  85. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +2 -2
  86. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +2 -2
  87. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.d.ts +6 -0
  88. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.js +25 -4
  89. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +4 -1
  90. package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +7 -3
  91. package/dist/harness/collaboration/delegation/child-run.d.ts +10 -1
  92. package/dist/harness/collaboration/delegation/child-run.js +38 -6
  93. package/dist/harness/collaboration/delegation/index.d.ts +1 -1
  94. package/dist/harness/collaboration/delegation/index.js +1 -1
  95. package/dist/harness/collaboration/delegation/notifier.d.ts +6 -1
  96. package/dist/harness/collaboration/delegation/notifier.js +8 -1
  97. package/dist/harness/collaboration/delegation/registry-types.d.ts +2 -0
  98. package/dist/harness/collaboration/delegation/service.d.ts +11 -4
  99. package/dist/harness/collaboration/delegation/service.js +35 -13
  100. package/dist/harness/collaboration/delegation/store.d.ts +4 -0
  101. package/dist/harness/collaboration/delegation/store.js +3 -1
  102. package/dist/harness/collaboration/delegation/types.d.ts +34 -2
  103. package/dist/harness/collaboration/delegation/types.js +22 -0
  104. package/dist/harness/collaboration/delegation/wiring.d.ts +2 -0
  105. package/dist/harness/collaboration/delegation/wiring.js +12 -1
  106. package/dist/harness/context/budget-allocator.d.ts +26 -18
  107. package/dist/harness/context/budget-allocator.js +67 -32
  108. package/dist/harness/context/capabilities/compact/engine.d.ts +44 -11
  109. package/dist/harness/context/capabilities/compact/engine.js +296 -160
  110. package/dist/harness/context/capabilities/compact/handover.d.ts +5 -3
  111. package/dist/harness/context/capabilities/compact/handover.js +7 -5
  112. package/dist/harness/context/capabilities/compact/index.d.ts +7 -2
  113. package/dist/harness/context/capabilities/compact/index.js +5 -1
  114. package/dist/harness/context/capabilities/compact/mechanical.d.ts +130 -0
  115. package/dist/harness/context/capabilities/compact/mechanical.js +268 -0
  116. package/dist/harness/context/capabilities/compact/messages.d.ts +60 -0
  117. package/dist/harness/context/capabilities/compact/messages.js +91 -0
  118. package/dist/harness/context/capabilities/compact/types.d.ts +134 -19
  119. package/dist/harness/context/capabilities/compact/types.js +11 -1
  120. package/dist/harness/context/capabilities/compact/view-split.d.ts +36 -0
  121. package/dist/harness/context/capabilities/compact/view-split.js +72 -0
  122. package/dist/harness/context/capabilities/summary/gate.d.ts +19 -2
  123. package/dist/harness/context/capabilities/summary/gate.js +53 -6
  124. package/dist/harness/context/capabilities/summary/port.js +0 -1
  125. package/dist/harness/context/capabilities/summary/registry.js +20 -0
  126. package/dist/harness/context/capabilities/summary/resolver.d.ts +1 -1
  127. package/dist/harness/context/capabilities/summary/resolver.js +1 -6
  128. package/dist/harness/context/capabilities/summary/tool-binding.d.ts +1 -1
  129. package/dist/harness/context/capabilities/summary/tool-binding.js +16 -12
  130. package/dist/harness/context/capabilities/summary/tool-bindings.d.ts +13 -0
  131. package/dist/harness/context/capabilities/summary/tool-bindings.js +22 -0
  132. package/dist/harness/context/capabilities/summary/types.d.ts +19 -6
  133. package/dist/harness/context/constitution/default-agents.md +85 -0
  134. package/dist/harness/context/context-size-ledger.d.ts +143 -0
  135. package/dist/harness/context/context-size-ledger.js +243 -0
  136. package/dist/harness/context/default-context-engine.d.ts +290 -120
  137. package/dist/harness/context/default-context-engine.js +1555 -764
  138. package/dist/harness/context/index.d.ts +3 -2
  139. package/dist/harness/context/index.js +2 -1
  140. package/dist/harness/context/layer-health.d.ts +4 -0
  141. package/dist/harness/context/layer-health.js +4 -0
  142. package/dist/harness/context/layer-types.d.ts +72 -0
  143. package/dist/harness/context/layer-types.js +87 -2
  144. package/dist/harness/context/layers.d.ts +17 -15
  145. package/dist/harness/context/layers.js +54 -17
  146. package/dist/harness/context/message-selector.d.ts +10 -8
  147. package/dist/harness/context/message-selector.js +49 -27
  148. package/dist/harness/context/prefix-fingerprint.d.ts +46 -0
  149. package/dist/harness/context/prefix-fingerprint.js +52 -0
  150. package/dist/harness/context/summarize.d.ts +2 -2
  151. package/dist/harness/context/summarize.js +27 -2
  152. package/dist/harness/context/system-prompt-assembler.d.ts +4 -0
  153. package/dist/harness/context/system-prompt-assembler.js +7 -3
  154. package/dist/harness/context/token-constants.d.ts +8 -6
  155. package/dist/harness/context/token-constants.js +8 -7
  156. package/dist/harness/context/token-estimate-fns.d.ts +37 -27
  157. package/dist/harness/context/token-estimate-fns.js +85 -66
  158. package/dist/harness/context/token-estimator.d.ts +27 -12
  159. package/dist/harness/context/token-estimator.js +120 -66
  160. package/dist/harness/context/token-segments.d.ts +88 -0
  161. package/dist/harness/context/token-segments.js +103 -0
  162. package/dist/harness/context/tool-result-aging.d.ts +109 -16
  163. package/dist/harness/context/tool-result-aging.js +220 -55
  164. package/dist/harness/context/tool-result-body.js +2 -0
  165. package/dist/harness/context/transform/anchors.d.ts +66 -0
  166. package/dist/harness/context/transform/anchors.js +125 -0
  167. package/dist/harness/context/transform/fold.d.ts +56 -0
  168. package/dist/harness/context/transform/fold.js +135 -0
  169. package/dist/harness/context/transform/migrate.d.ts +41 -0
  170. package/dist/harness/context/transform/migrate.js +69 -0
  171. package/dist/harness/context/transform/types.d.ts +129 -0
  172. package/dist/harness/context/transform/types.js +19 -0
  173. package/dist/harness/context/turn-envelope.d.ts +6 -3
  174. package/dist/harness/context/types.d.ts +196 -119
  175. package/dist/harness/context/types.js +25 -1
  176. package/dist/harness/extension/execution-environment/effect-policy.d.ts +4 -3
  177. package/dist/harness/extension/execution-environment/effect-policy.js +2 -2
  178. package/dist/harness/extension/execution-environment/ops-audit.d.ts +1 -1
  179. package/dist/harness/extension/execution-environment/privileged-exec.js +4 -1
  180. package/dist/harness/extension/execution-environment/resource-limits.d.ts +1 -1
  181. package/dist/harness/extension/execution-environment/resource-limits.js +1 -1
  182. package/dist/harness/extension/execution-environment/workspace.js +1 -1
  183. package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +28 -2
  184. package/dist/harness/extension/plugin-ecosystem/channel-types.js +11 -2
  185. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +12 -0
  186. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +25 -0
  187. package/dist/harness/extension/plugin-ecosystem/commands/builtin.js +28 -1
  188. package/dist/harness/extension/plugin-ecosystem/commands/index.d.ts +3 -1
  189. package/dist/harness/extension/plugin-ecosystem/commands/index.js +1 -0
  190. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.d.ts +12 -1
  191. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.js +14 -4
  192. package/dist/harness/extension/plugin-ecosystem/commands/router.d.ts +5 -4
  193. package/dist/harness/extension/plugin-ecosystem/commands/router.js +23 -14
  194. package/dist/harness/extension/plugin-ecosystem/commands/types.d.ts +8 -1
  195. package/dist/harness/extension/plugin-ecosystem/commands/types.js +2 -1
  196. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.d.ts +54 -0
  197. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.js +397 -0
  198. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.d.ts +16 -0
  199. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.js +66 -0
  200. package/dist/harness/extension/plugin-ecosystem/hooks/index.d.ts +4 -0
  201. package/dist/harness/extension/plugin-ecosystem/hooks/index.js +2 -0
  202. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.d.ts +11 -0
  203. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.js +54 -0
  204. package/dist/harness/extension/plugin-ecosystem/hooks/journal.d.ts +9 -0
  205. package/dist/harness/extension/plugin-ecosystem/hooks/journal.js +22 -0
  206. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.d.ts +12 -0
  207. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.js +19 -0
  208. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.d.ts +36 -0
  209. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.js +338 -0
  210. package/dist/harness/extension/plugin-ecosystem/hooks/services.d.ts +24 -0
  211. package/dist/harness/extension/plugin-ecosystem/hooks/services.js +139 -0
  212. package/dist/harness/extension/plugin-ecosystem/hooks/types.d.ts +229 -0
  213. package/dist/harness/extension/plugin-ecosystem/hooks/types.js +1 -0
  214. package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
  215. package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
  216. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +223 -222
  217. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +218 -203
  218. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.d.ts +95 -0
  219. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.js +170 -0
  220. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.d.ts +178 -0
  221. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.js +314 -0
  222. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +78 -0
  223. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +80 -0
  224. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.d.ts +4 -0
  225. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.js +18 -0
  226. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +7 -85
  227. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +8 -50
  228. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +6 -23
  229. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +3 -23
  230. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +57 -114
  231. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +279 -282
  232. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +46 -484
  233. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +123 -345
  234. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +50 -223
  235. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +144 -20
  236. package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +17 -0
  237. package/dist/harness/extension/plugin-ecosystem/plugins/staging.js +15 -0
  238. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +6 -1
  239. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +17 -1
  240. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +3 -0
  241. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +46 -21
  242. package/dist/harness/extension/plugin-ecosystem/tools/browser-types.d.ts +333 -0
  243. package/dist/harness/extension/plugin-ecosystem/tools/browser-types.js +16 -0
  244. package/dist/harness/extension/plugin-ecosystem/tools/browser.d.ts +64 -0
  245. package/dist/harness/extension/plugin-ecosystem/tools/browser.js +692 -0
  246. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +0 -37
  247. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +108 -4
  248. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +36 -8
  249. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +34 -0
  250. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +0 -6
  251. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +57 -4
  252. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +81 -13
  253. package/dist/harness/extension/plugin-ecosystem/tools/http.js +5 -0
  254. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +13 -7
  255. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +126 -14
  256. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +1 -1
  257. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +44 -5
  258. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.d.ts +11 -0
  259. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.js +39 -0
  260. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +1 -1
  261. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +19 -24
  262. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +7 -0
  263. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +4 -0
  264. package/dist/harness/governance/accounting/usage-ledger.d.ts +13 -1
  265. package/dist/harness/governance/accounting/usage-ledger.js +23 -1
  266. package/dist/harness/governance/credentials/db.d.ts +9 -0
  267. package/dist/harness/governance/credentials/db.js +122 -31
  268. package/dist/harness/governance/credentials/store.d.ts +68 -7
  269. package/dist/harness/governance/credentials/store.js +177 -64
  270. package/dist/harness/governance/credentials/types.d.ts +13 -2
  271. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +3 -3
  272. package/dist/harness/governance/human-in-the-loop/decision-cache.js +2 -2
  273. package/dist/harness/governance/index.d.ts +1 -0
  274. package/dist/harness/governance/index.js +1 -0
  275. package/dist/harness/governance/registry/db.d.ts +32 -0
  276. package/dist/harness/governance/registry/db.js +142 -0
  277. package/dist/harness/governance/registry/index.d.ts +9 -0
  278. package/dist/harness/governance/registry/index.js +9 -0
  279. package/dist/harness/governance/registry/service.d.ts +381 -0
  280. package/dist/harness/governance/registry/service.js +825 -0
  281. package/dist/harness/governance/registry/types.d.ts +77 -0
  282. package/dist/harness/governance/registry/types.js +7 -0
  283. package/dist/harness/governance/security/capability-enforcer.js +1 -2
  284. package/dist/harness/governance/security/default-security-guard.d.ts +3 -0
  285. package/dist/harness/governance/security/default-security-guard.js +12 -1
  286. package/dist/harness/governance/security/risk-evaluator.d.ts +13 -3
  287. package/dist/harness/governance/security/risk-evaluator.js +307 -21
  288. package/dist/harness/governance/security/shell-parser-treesitter.js +12 -4
  289. package/dist/harness/governance/session-acl/tool-rights.d.ts +1 -0
  290. package/dist/harness/index.d.ts +17 -15
  291. package/dist/harness/index.js +9 -9
  292. package/dist/harness/knowledge/boot-config.d.ts +57 -0
  293. package/dist/harness/knowledge/boot-config.js +52 -0
  294. package/dist/harness/knowledge/catalog-types.d.ts +2 -0
  295. package/dist/harness/knowledge/client.d.ts +77 -9
  296. package/dist/harness/knowledge/client.js +95 -24
  297. package/dist/harness/knowledge/db.d.ts +16 -0
  298. package/dist/harness/knowledge/db.js +112 -41
  299. package/dist/harness/knowledge/describe-sample.d.ts +23 -0
  300. package/dist/harness/knowledge/describe-sample.js +58 -0
  301. package/dist/harness/knowledge/describe.d.ts +8 -0
  302. package/dist/harness/knowledge/describe.js +18 -2
  303. package/dist/harness/knowledge/engine-thread.js +11 -7
  304. package/dist/harness/knowledge/grounding.js +7 -2
  305. package/dist/harness/knowledge/http-app.d.ts +15 -0
  306. package/dist/harness/knowledge/http-app.js +117 -25
  307. package/dist/harness/knowledge/http-bridge.d.ts +15 -0
  308. package/dist/harness/knowledge/http-bridge.js +19 -0
  309. package/dist/harness/knowledge/http-params.d.ts +18 -0
  310. package/dist/harness/knowledge/http-params.js +24 -0
  311. package/dist/harness/knowledge/index.d.ts +2 -0
  312. package/dist/harness/knowledge/index.js +1 -0
  313. package/dist/harness/knowledge/knowledge-serve-child.js +5 -3
  314. package/dist/harness/knowledge/purge.js +5 -2
  315. package/dist/harness/knowledge/query-service.d.ts +25 -4
  316. package/dist/harness/knowledge/query-service.js +79 -43
  317. package/dist/harness/knowledge/query-worker-client.d.ts +14 -2
  318. package/dist/harness/knowledge/query-worker-client.js +8 -3
  319. package/dist/harness/knowledge/query-worker.js +9 -5
  320. package/dist/harness/knowledge/read-http.d.ts +2 -0
  321. package/dist/harness/knowledge/read-http.js +14 -3
  322. package/dist/harness/knowledge/retriever.d.ts +1 -1
  323. package/dist/harness/knowledge/retriever.js +1 -2
  324. package/dist/harness/knowledge/serve.d.ts +14 -8
  325. package/dist/harness/knowledge/serve.js +14 -6
  326. package/dist/harness/knowledge/source-store.d.ts +101 -5
  327. package/dist/harness/knowledge/source-store.js +323 -74
  328. package/dist/harness/knowledge/start-service-process.d.ts +41 -14
  329. package/dist/harness/knowledge/start-service-process.js +67 -96
  330. package/dist/harness/knowledge/tenant-gate.d.ts +81 -0
  331. package/dist/harness/knowledge/tenant-gate.js +167 -0
  332. package/dist/harness/knowledge/types.d.ts +7 -0
  333. package/dist/harness/knowledge/writer-service.d.ts +55 -11
  334. package/dist/harness/knowledge/writer-service.js +200 -30
  335. package/dist/harness/knowledge/writer-worker-client.d.ts +19 -11
  336. package/dist/harness/knowledge/writer-worker-client.js +40 -5
  337. package/dist/harness/knowledge/writer-worker.js +20 -5
  338. package/dist/harness/memory/backfill-trigger.d.ts +10 -3
  339. package/dist/harness/memory/backfill-trigger.js +19 -19
  340. package/dist/harness/memory/cognition-seeds.d.ts +45 -0
  341. package/dist/harness/memory/cognition-seeds.js +67 -0
  342. package/dist/harness/memory/cognition.d.ts +12 -3
  343. package/dist/harness/memory/cognition.js +55 -35
  344. package/dist/harness/memory/conceptualizer.d.ts +11 -1
  345. package/dist/harness/memory/conceptualizer.js +10 -1
  346. package/dist/harness/memory/context-slice.d.ts +42 -0
  347. package/dist/harness/memory/context-slice.js +197 -0
  348. package/dist/harness/memory/health-probe.d.ts +8 -2
  349. package/dist/harness/memory/health-probe.js +10 -13
  350. package/dist/harness/memory/index.d.ts +5 -1
  351. package/dist/harness/memory/index.js +3 -1
  352. package/dist/harness/memory/sqlite/agent-db.d.ts +1 -0
  353. package/dist/harness/memory/sqlite/agent-db.js +9 -8
  354. package/dist/harness/memory/sqlite/cognition-store.d.ts +26 -3
  355. package/dist/harness/memory/sqlite/cognition-store.js +103 -45
  356. package/dist/harness/memory/sqlite/memory-store.js +4 -0
  357. package/dist/harness/memory/sqlite/sqlite-vec.d.ts +24 -1
  358. package/dist/harness/memory/sqlite/sqlite-vec.js +37 -1
  359. package/dist/harness/memory/sqlite/wisdom-store.js +35 -10
  360. package/dist/harness/memory/types.d.ts +24 -6
  361. package/dist/harness/memory/wisdom-formation.d.ts +14 -3
  362. package/dist/harness/memory/wisdom-formation.js +85 -22
  363. package/dist/harness/memory/wisdom-gates.d.ts +14 -0
  364. package/dist/harness/memory/wisdom-gates.js +59 -19
  365. package/dist/harness/memory/wisdom.js +9 -0
  366. package/dist/harness/observability/observer/hub.d.ts +10 -0
  367. package/dist/harness/observability/observer/hub.js +120 -17
  368. package/dist/harness/observability/observer/types.d.ts +10 -6
  369. package/dist/harness/run/agent/agent.d.ts +40 -21
  370. package/dist/harness/run/agent/agent.js +67 -13
  371. package/dist/harness/run/agent/index.d.ts +1 -1
  372. package/dist/harness/run/budget/budget.d.ts +28 -10
  373. package/dist/harness/run/budget/budget.js +38 -15
  374. package/dist/harness/run/concurrency/tool-validator.js +4 -3
  375. package/dist/harness/run/model/index.d.ts +3 -1
  376. package/dist/harness/run/model/index.js +2 -1
  377. package/dist/harness/run/model/resolver.d.ts +4 -1
  378. package/dist/harness/run/model/resolver.js +36 -2
  379. package/dist/harness/run/model/run-scope.d.ts +2 -0
  380. package/dist/harness/run/model/run-scope.js +7 -0
  381. package/dist/harness/run/model/types.d.ts +22 -5
  382. package/dist/harness/run/model/types.js +3 -2
  383. package/dist/harness/run/model/window-truth.d.ts +37 -0
  384. package/dist/harness/run/model/window-truth.js +39 -0
  385. package/dist/harness/run/reliability/context-length-feedback.d.ts +77 -0
  386. package/dist/harness/run/reliability/context-length-feedback.js +128 -0
  387. package/dist/harness/run/reliability/harness-events.d.ts +3 -3
  388. package/dist/harness/run/reliability/model-error-policy.js +4 -0
  389. package/dist/harness/run/reliability/run-agent.d.ts +32 -4
  390. package/dist/harness/run/reliability/run-agent.js +216 -63
  391. package/dist/harness/run/reliability/run-metrics-collector.d.ts +19 -8
  392. package/dist/harness/run/reliability/run-metrics-collector.js +38 -23
  393. package/dist/harness/run/run-guard/default-run-guard.js +8 -8
  394. package/dist/harness/run/run-host.d.ts +302 -0
  395. package/dist/harness/run/run-host.js +978 -0
  396. package/dist/harness/run/run-scope.d.ts +48 -4
  397. package/dist/harness/run/run-scope.js +19 -1
  398. package/dist/harness/run/runner.d.ts +181 -39
  399. package/dist/harness/run/runner.js +654 -119
  400. package/dist/harness/session/attachments/index.d.ts +1 -0
  401. package/dist/harness/session/attachments/index.js +1 -0
  402. package/dist/harness/session/attachments/inject.d.ts +21 -10
  403. package/dist/harness/session/attachments/inject.js +76 -24
  404. package/dist/harness/session/attachments/recall-index.d.ts +70 -0
  405. package/dist/harness/session/attachments/recall-index.js +219 -0
  406. package/dist/harness/session/attachments/service.d.ts +21 -0
  407. package/dist/harness/session/attachments/service.js +258 -139
  408. package/dist/harness/session/attachments/types.d.ts +6 -0
  409. package/dist/harness/session/in-memory-store.js +13 -1
  410. package/dist/harness/session/schedules/service.d.ts +10 -2
  411. package/dist/harness/session/schedules/service.js +13 -2
  412. package/dist/harness/session/tasks/tools.js +12 -0
  413. package/dist/harness/session/transform-store.d.ts +136 -0
  414. package/dist/harness/session/transform-store.js +302 -0
  415. package/dist/harness/session/types.d.ts +11 -15
  416. package/dist/harness/shared/events/agent-event-map.d.ts +75 -13
  417. package/dist/harness/shared/events/agent-event-map.js +3 -2
  418. package/dist/harness/shared/events/scenario-events.d.ts +6 -6
  419. package/dist/harness/shared/types/agent-definition.d.ts +7 -2
  420. package/dist/index.d.ts +16 -18
  421. package/dist/index.js +9 -10
  422. package/dist/integration/agent-runtime/channel-message-source.d.ts +3 -1
  423. package/dist/integration/agent-runtime/channel-message-source.js +4 -3
  424. package/dist/integration/browser/camoufox.d.ts +40 -0
  425. package/dist/integration/browser/camoufox.js +80 -0
  426. package/dist/integration/browser/index.d.ts +91 -0
  427. package/dist/integration/browser/index.js +110 -0
  428. package/dist/integration/browser/install.d.ts +47 -0
  429. package/dist/integration/browser/install.js +214 -0
  430. package/dist/integration/browser/playwright.d.ts +224 -0
  431. package/dist/integration/browser/playwright.js +925 -0
  432. package/dist/integration/browser/service.d.ts +41 -0
  433. package/dist/integration/browser/service.js +181 -0
  434. package/dist/integration/browser/stealth.d.ts +42 -0
  435. package/dist/integration/browser/stealth.js +104 -0
  436. package/dist/integration/observability/metrics.d.ts +6 -6
  437. package/dist/integration/observability/metrics.js +13 -13
  438. package/dist/integration/observability/observer-bridge.js +2 -2
  439. package/dist/integration/observability/trace-collector.d.ts +5 -5
  440. package/dist/integration/observability/trace-collector.js +34 -35
  441. package/dist/integration/observability/trace-events.d.ts +3 -3
  442. package/dist/integration/observability/trace-events.js +3 -3
  443. package/dist/integration/providers/anthropic-message-normalize.d.ts +20 -0
  444. package/dist/integration/providers/anthropic-message-normalize.js +48 -0
  445. package/dist/integration/providers/anthropic.js +41 -3
  446. package/dist/integration/providers/fetch-timeout.d.ts +17 -0
  447. package/dist/integration/providers/fetch-timeout.js +24 -0
  448. package/dist/integration/providers/openai.d.ts +8 -0
  449. package/dist/integration/providers/openai.js +48 -2
  450. package/dist/integration/providers/usage.d.ts +1 -1
  451. package/dist/integration/providers/wire-dump-diff.js +2 -1
  452. package/dist/integration/providers/wire-dump.d.ts +57 -3
  453. package/dist/integration/providers/wire-dump.js +119 -6
  454. package/dist/integration/storage/archive-manager.d.ts +20 -2
  455. package/dist/integration/storage/archive-manager.js +34 -8
  456. package/dist/integration/storage/atomic-tmp.d.ts +12 -0
  457. package/dist/integration/storage/atomic-tmp.js +36 -0
  458. package/dist/integration/storage/jsonl.d.ts +10 -1
  459. package/dist/integration/storage/jsonl.js +155 -54
  460. package/dist/integration/storage/session-index.d.ts +5 -0
  461. package/dist/integration/storage/session-index.js +25 -4
  462. package/dist/integration/tools/assemble.d.ts +50 -0
  463. package/dist/integration/tools/assemble.js +137 -0
  464. package/dist/paths.d.ts +18 -0
  465. package/dist/paths.js +36 -0
  466. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +3 -1
  467. package/dist/subsystems/cognition-steward/conceptualize/handler.js +74 -5
  468. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +3 -2
  469. package/dist/subsystems/cognition-steward/consolidate/config.yaml +11 -2
  470. package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +6 -3
  471. package/dist/subsystems/cognition-steward/consolidate/handler.js +266 -28
  472. package/dist/subsystems/memory-steward/backfill/handler.js +3 -2
  473. package/dist/subsystems/memory-steward/govern/config.yaml +6 -1
  474. package/dist/subsystems/wisdom-steward/attribute/config.yaml +5 -1
  475. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +8 -1
  476. package/dist/subsystems/wisdom-steward/formation/config.yaml +4 -0
  477. package/dist/subsystems/wisdom-steward/formation/handler.js +27 -5
  478. package/dist/subsystems/wisdom-steward/govern/config.yaml +6 -1
  479. package/package.json +14 -15
  480. package/dist/harness/context/hybrid-compressor.d.ts +0 -41
  481. package/dist/harness/context/hybrid-compressor.js +0 -159
  482. package/dist/harness/context/llm-summarizer.d.ts +0 -46
  483. package/dist/harness/context/llm-summarizer.js +0 -249
  484. package/dist/harness/context/smart-router.d.ts +0 -75
  485. package/dist/harness/context/smart-router.js +0 -118
  486. package/dist/harness/context/truncate-compressor.d.ts +0 -28
  487. package/dist/harness/context/truncate-compressor.js +0 -107
  488. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -97
  489. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -155
  490. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.d.ts +0 -7
  491. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.js +0 -7
  492. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.d.ts +0 -86
  493. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.js +0 -139
@@ -0,0 +1,197 @@
1
+ /**
2
+ * ContextSlice 提取 — session 消息 + evidence 锚定 → 证据周边语境(±N 条消息)
3
+ *
4
+ * 概念化输入包要求 contextSlice(arch/cognition-graph-formation.md D1)。
5
+ * evidence 多为缩略引文(「…」截断、句读改写),整串精确匹配常失败,
6
+ * 因此按省略号/句读拆片段、以最长命中片段定位锚点消息,再截两侧窗口。
7
+ * 找不到锚点返回空串,由调用方显式失败——禁止用无关窗口冒充语境。
8
+ *
9
+ * 锚定域:user / assistant / tool 的文本消息(evidence 可能引用工具输出,
10
+ * 如文件路径与命令结果)。引擎载体插槽经 `isEngineCarrierSource` 单源过滤。
11
+ *
12
+ * @module harness/memory/context-slice
13
+ */
14
+ import { elidedCharsMarker } from '@octopi-agent/core/elision.js';
15
+ import { getTextContent } from '@octopi-agent/core/types.js';
16
+ import { isEngineCarrierSource } from '../context/layer-types.js';
17
+ /** 缺省窗口:锚点两侧各取的实质消息条数 */
18
+ export const DEFAULT_CONTEXT_WINDOW_MESSAGES = 2;
19
+ /** 缺省切片字符预算(软上限;elision 标记会略超,见 {@link extractContextSlice}) */
20
+ export const DEFAULT_CONTEXT_SLICE_MAX_CHARS = 4000;
21
+ /** 引号类字符:匹配前剥除(evidence 引文与消息原文的引号使用不一致) */
22
+ const QUOTE_CHARS_RE = /[「」『』“”"'‘’()()【】[\]]/g;
23
+ /**
24
+ * 匹配键归一:剥引号 + 空白折叠 + 拉丁小写(CJK 不受影响)。
25
+ *
26
+ * @param text - 原文
27
+ * @returns 用于包含匹配的归一化文本
28
+ */
29
+ function matchKey(text) {
30
+ return text.replace(QUOTE_CHARS_RE, ' ').replace(/\s+/g, ' ').trim().toLowerCase();
31
+ }
32
+ /**
33
+ * evidence → 候选片段:按省略号/句读/换行/**引号与括号边界**拆开(相邻引文
34
+ * 不粘连成跨引文长片段),归一后保留过阈值的片段。
35
+ *
36
+ * @param evidence - 记忆证据原文
37
+ * @returns 归一化候选片段(保持出现顺序)
38
+ */
39
+ function evidenceFragments(evidence) {
40
+ const rough = evidence.split(/[…⋯]|\.{3,}|[。!?!?\n;;,,::「」『』“”"'‘’()()【】[\]]/);
41
+ const out = [];
42
+ for (const piece of rough) {
43
+ const cleaned = matchKey(piece);
44
+ if (fragmentAcceptable(cleaned))
45
+ out.push(cleaned);
46
+ }
47
+ return out;
48
+ }
49
+ /** CJK 字符(中日韩音节块)——单字信息量高,短引文常足以唯一锚定 */
50
+ const CJK_RE = /[ -〿㐀-䶿一-鿿가-힯]/;
51
+ /** evidence 片段最小长度:拉丁 ≥8(短通用片段易误锚);含 CJK ≥6(误锚比无锚更糟,宁可不锚定) */
52
+ function fragmentAcceptable(fragment) {
53
+ return fragment.length >= (CJK_RE.test(fragment) ? 6 : 8);
54
+ }
55
+ /**
56
+ * 工具调用/结果的文本侧写 — evidence 常引用工具输出与调用参数。
57
+ *
58
+ * SessionData 的 toolCalls/toolResults 是一等字段(content 常为空),只取
59
+ * name/purpose/args/result 的文本形态;条目形状未知时跳过。
60
+ *
61
+ * @param value - toolCalls 或 toolResults 数组(未知形状)
62
+ * @returns 侧写文本行(可能为空数组)
63
+ */
64
+ function toolSidecarLines(value) {
65
+ if (!Array.isArray(value))
66
+ return [];
67
+ const lines = [];
68
+ for (const entry of value) {
69
+ if (!entry || typeof entry !== 'object')
70
+ continue;
71
+ const e = entry;
72
+ const parts = [];
73
+ if (typeof e.name === 'string' && e.name)
74
+ parts.push(e.name);
75
+ if (typeof e.purpose === 'string' && e.purpose)
76
+ parts.push(e.purpose);
77
+ const payload = e.result ?? e.arguments ?? e.input ?? e.args;
78
+ if (payload !== undefined && payload !== null) {
79
+ parts.push(typeof payload === 'string' ? payload : JSON.stringify(payload));
80
+ }
81
+ const line = parts.join(' ').trim();
82
+ if (line)
83
+ lines.push(line);
84
+ }
85
+ return lines;
86
+ }
87
+ /**
88
+ * 消息是否是可作语境的实质消息。
89
+ *
90
+ * 过滤口径:引擎载体插槽(快照/grounding/附件/摘要/hint/turn 闭标/停止说明)
91
+ * 一律不算语境——快照含记忆原文回显,入语境即自我复制;turnEnd 以 user 角色
92
+ * 落盘但不是发言。角色限 user/assistant/tool:evidence 可能引用工具输出
93
+ * (文件路径、命令结果),故 tool 文本也是合法锚点。
94
+ *
95
+ * @param message - 会话消息(未知形状)
96
+ * @returns 实质消息的文本与角色,否则 null
97
+ */
98
+ function asSubstantive(message) {
99
+ if (!message || typeof message !== 'object')
100
+ return null;
101
+ const m = message;
102
+ if (isEngineCarrierSource(m.metadata?.source))
103
+ return null;
104
+ if (m.role !== 'user' && m.role !== 'assistant' && m.role !== 'tool')
105
+ return null;
106
+ const raw = m.content;
107
+ // 只取文本块:ContentBlock[] 整体 stringify 会把 tool_use 参数/图片塞进语境
108
+ const contentText = typeof raw === 'string' ? raw : Array.isArray(raw) ? getTextContent(raw) : '';
109
+ // 工具文本是一等字段(content 常为空),必须并入锚定域:evidence 常引用工具输出
110
+ const sidecar = [...toolSidecarLines(m.toolCalls), ...toolSidecarLines(m.toolResults)].join('\n');
111
+ const text = [contentText.trim(), sidecar].filter(Boolean).join('\n');
112
+ if (!text)
113
+ return null;
114
+ return { text, role: String(m.role) };
115
+ }
116
+ /**
117
+ * 从会话消息中提取 evidence 周边语境切片。
118
+ *
119
+ * 定位策略:evidence 拆片段后取「能命中某条实质消息的最长片段」(等长片段取
120
+ * evidence 中先出现者),同一片段取最后一次出现的消息(贴近记忆产生时的活跃
121
+ * 语境),锚点 ±windowMessages 条实质消息。
122
+ *
123
+ * 截断:锚点行优先保留,两侧邻居按余量裁剪并以 elision 标记标注。
124
+ * maxChars 为软上限(标记文本会略超)。锚点行自身超预算时保头尾两段,
125
+ * 行内中段(含命中片段本身)可能被裁。
126
+ *
127
+ * @param options - 消息序列 + evidence + 窗口/预算
128
+ * @returns `[role] text` 行拼接的语境切片;无锚点或无实质消息时返回空串
129
+ */
130
+ export function extractContextSlice(options) {
131
+ const { messages, evidence } = options;
132
+ const windowMessages = Math.max(0, options.windowMessages ?? DEFAULT_CONTEXT_WINDOW_MESSAGES);
133
+ const maxChars = Math.max(1, options.maxChars ?? DEFAULT_CONTEXT_SLICE_MAX_CHARS);
134
+ const substantive = [];
135
+ for (const message of messages) {
136
+ const item = asSubstantive(message);
137
+ if (item)
138
+ substantive.push(item);
139
+ }
140
+ const fragments = evidenceFragments(evidence);
141
+ if (substantive.length === 0 || fragments.length === 0)
142
+ return '';
143
+ const keys = substantive.map((item) => matchKey(item.text));
144
+ let bestLen = 0;
145
+ let anchorIndex = -1;
146
+ for (const fragment of fragments) {
147
+ let lastHit = -1;
148
+ for (let i = 0; i < keys.length; i++) {
149
+ if (keys[i].includes(fragment))
150
+ lastHit = i;
151
+ }
152
+ if (lastHit >= 0 && fragment.length > bestLen) {
153
+ bestLen = fragment.length;
154
+ anchorIndex = lastHit;
155
+ }
156
+ }
157
+ if (anchorIndex < 0)
158
+ return '';
159
+ const from = Math.max(0, anchorIndex - windowMessages);
160
+ const to = Math.min(substantive.length, anchorIndex + windowMessages + 1);
161
+ const anchorPos = anchorIndex - from;
162
+ const lines = substantive
163
+ .slice(from, to)
164
+ .map((item) => `[${item.role}] ${item.text}`);
165
+ const joined = lines.join('\n');
166
+ if (joined.length <= maxChars)
167
+ return joined;
168
+ // 锚点行在 joined 内的字符区间
169
+ let anchorStart = 0;
170
+ for (let i = 0; i < anchorPos; i++)
171
+ anchorStart += lines[i].length + 1;
172
+ const anchorEnd = anchorStart + lines[anchorPos].length;
173
+ if (anchorEnd - anchorStart >= maxChars) {
174
+ const line = lines[anchorPos];
175
+ const headBudget = Math.floor(maxChars * 0.4);
176
+ const tailBudget = Math.max(0, maxChars - headBudget - 20);
177
+ const tail = tailBudget > 0 ? line.slice(-tailBudget) : '';
178
+ return `${line.slice(0, headBudget)}\n${elidedCharsMarker(line.length - headBudget - tailBudget)}\n${tail}`;
179
+ }
180
+ const room = maxChars - (anchorEnd - anchorStart);
181
+ let left = Math.min(anchorStart, Math.floor(room / 2));
182
+ const right = Math.min(joined.length - anchorEnd, room - left);
183
+ left = Math.min(anchorStart, room - right);
184
+ const start = anchorStart - left;
185
+ const end = anchorEnd + right;
186
+ const parts = [];
187
+ if (start > 0)
188
+ parts.push(elidedCharsMarker(start));
189
+ if (left > 0)
190
+ parts.push(joined.slice(start, anchorStart));
191
+ parts.push(lines[anchorPos]);
192
+ if (right > 0)
193
+ parts.push(joined.slice(anchorEnd, end));
194
+ if (end < joined.length)
195
+ parts.push(elidedCharsMarker(joined.length - end));
196
+ return parts.join('\n');
197
+ }
@@ -27,9 +27,15 @@ export declare class MemoryHealthProbe {
27
27
  private readonly limits;
28
28
  private readonly shadowBacklogLimit;
29
29
  private readonly now;
30
- private timer?;
31
30
  constructor(options: MemoryHealthProbeOptions);
32
- start(): void;
31
+ /** 脉搏声明(P0c A′):供装配层聚合成实例级 PulseSpec 列表 */
32
+ pulseSpecs(): Array<{
33
+ key: string;
34
+ intervalMs: number;
35
+ }>;
36
+ /** 脉搏入口:gateway 单发驱动一次检查。未知 key fail-loud。 */
37
+ pulse(key: string): Promise<string[]>;
38
+ /** P0c A′:检查已改脉搏驱动,无 self-arm 定时器可停(保留调用面兼容)。 */
33
39
  stop(): void;
34
40
  /** 立即检查一轮;返回发出的事件类型 */
35
41
  check(): Promise<string[]>;
@@ -19,7 +19,6 @@ export class MemoryHealthProbe {
19
19
  limits;
20
20
  shadowBacklogLimit;
21
21
  now;
22
- timer;
23
22
  constructor(options) {
24
23
  this.events = options.events;
25
24
  this.memoryStore = options.memoryStore;
@@ -28,20 +27,18 @@ export class MemoryHealthProbe {
28
27
  this.shadowBacklogLimit = options.shadowBacklogLimit ?? 50;
29
28
  this.now = options.now ?? (() => Date.now());
30
29
  }
31
- start() {
32
- if (this.timer)
33
- return;
34
- this.timer = setInterval(() => {
35
- void this.check();
36
- }, this.intervalMs);
37
- this.timer.unref?.();
30
+ /** 脉搏声明(P0c A′):供装配层聚合成实例级 PulseSpec 列表 */
31
+ pulseSpecs() {
32
+ return [{ key: 'memory.health', intervalMs: this.intervalMs }];
38
33
  }
39
- stop() {
40
- if (this.timer) {
41
- clearInterval(this.timer);
42
- this.timer = undefined;
43
- }
34
+ /** 脉搏入口:gateway 单发驱动一次检查。未知 key fail-loud。 */
35
+ async pulse(key) {
36
+ if (key === 'memory.health')
37
+ return this.check();
38
+ throw new Error(`memory-health-probe: unknown pulse key "${key}"`);
44
39
  }
40
+ /** P0c A′:检查已改脉搏驱动,无 self-arm 定时器可停(保留调用面兼容)。 */
41
+ stop() { }
45
42
  /** 立即检查一轮;返回发出的事件类型 */
46
43
  async check() {
47
44
  const emitted = [];
@@ -15,14 +15,18 @@ export { extractCitations, collectRunAssistantTexts, recordWisdomRunWindow, sele
15
15
  export type { WisdomRunWindowInfo, AttributionCandidate, AttributionBatch, AttributionVerdict, } from './wisdom-attribution.js';
16
16
  export { emitWisdomEvaluateRequest, emitWisdomGoverned, WISDOM_EVALUATE_REQUEST_EVENT, WISDOM_GOVERNED_EVENT, } from './wisdom-events.js';
17
17
  export type { WisdomEvaluateRequestPayload } from './wisdom-events.js';
18
+ export { normName, deriveQuerySeeds, createSeedMatcher, } from './cognition-seeds.js';
19
+ export type { DeriveQuerySeedsOptions, SeedMatcher } from './cognition-seeds.js';
18
20
  export { evaluateConceptGate, licenseEdge, edgeBasisFromLicense, normalizeForCue, } from './cognition-gates.js';
19
21
  export type { ConceptGateOutcome, EdgeLicenseInput, EdgeLicenseOutcome, } from './cognition-gates.js';
20
22
  export { DEFAULT_EDGE_DECAY_PER_DAY, DEFAULT_EDGE_DECAY_FLOOR, DEFAULT_RETRIEVE_STATUSES, decayMultiplier, nextEdgeStrength, hebbianStrengthen, counterEvidenceWeaken, } from './cognition-decay.js';
21
23
  export type { EdgeDecayConfig } from './cognition-decay.js';
22
- export { conceptualizeAndAdmit, parseConceptualizerJson, } from './conceptualizer.js';
24
+ export { conceptualizeAndAdmit, hasSufficientContext, parseConceptualizerJson, } from './conceptualizer.js';
23
25
  export type { ConceptualizerInput, ConceptualizerResult, ConceptualizerNodeOut, ConceptualizerEdgeOut, RawConceptualizerOutput, } from './conceptualizer.js';
24
26
  export { COGNITIZE_REQUEST_EVENT, emitConceptualizeRequest, } from './cognition-trigger.js';
25
27
  export type { ConceptualizeRequestPayload } from './cognition-trigger.js';
28
+ export { DEFAULT_CONTEXT_SLICE_MAX_CHARS, DEFAULT_CONTEXT_WINDOW_MESSAGES, extractContextSlice, } from './context-slice.js';
29
+ export type { ContextSliceOptions } from './context-slice.js';
26
30
  export { InMemoryMemoryStore } from './store.js';
27
31
  export { InMemoryWisdomStore } from './wisdom.js';
28
32
  export { InMemoryConceptGraph } from './cognition.js';
@@ -13,10 +13,12 @@ export { parseWisdomFormationJson, normalizeWisdomFormation, toAdmitWisdomInput,
13
13
  export { extractCitations, collectRunAssistantTexts, recordWisdomRunWindow, selectAttributionCandidates, planAttributionBatch, buildAttributionDigest, parseAttributionVerdicts, verdictsToOutcomeEvents, } from './wisdom-attribution.js';
14
14
  export { emitWisdomEvaluateRequest, emitWisdomGoverned, WISDOM_EVALUATE_REQUEST_EVENT, WISDOM_GOVERNED_EVENT, } from './wisdom-events.js';
15
15
  // ── Cognition 门控 / 可塑 / 概念化 ──
16
+ export { normName, deriveQuerySeeds, createSeedMatcher, } from './cognition-seeds.js';
16
17
  export { evaluateConceptGate, licenseEdge, edgeBasisFromLicense, normalizeForCue, } from './cognition-gates.js';
17
18
  export { DEFAULT_EDGE_DECAY_PER_DAY, DEFAULT_EDGE_DECAY_FLOOR, DEFAULT_RETRIEVE_STATUSES, decayMultiplier, nextEdgeStrength, hebbianStrengthen, counterEvidenceWeaken, } from './cognition-decay.js';
18
- export { conceptualizeAndAdmit, parseConceptualizerJson, } from './conceptualizer.js';
19
+ export { conceptualizeAndAdmit, hasSufficientContext, parseConceptualizerJson, } from './conceptualizer.js';
19
20
  export { COGNITIZE_REQUEST_EVENT, emitConceptualizeRequest, } from './cognition-trigger.js';
21
+ export { DEFAULT_CONTEXT_SLICE_MAX_CHARS, DEFAULT_CONTEXT_WINDOW_MESSAGES, extractContextSlice, } from './context-slice.js';
20
22
  // ── 内存实现 ──
21
23
  export { InMemoryMemoryStore } from './store.js';
22
24
  export { InMemoryWisdomStore } from './wisdom.js';
@@ -22,6 +22,7 @@ export interface AgentDatabaseOptions {
22
22
  /** 尝试加载 sqlite-vec 扩展(默认 false) */
23
23
  sqliteVec?: boolean | {
24
24
  extensionPath?: string;
25
+ require?: boolean;
25
26
  };
26
27
  /** 向量维度;配合 sqlite-vec 时用于创建 memory_vec 虚拟表 */
27
28
  vectorDimensions?: number;
@@ -14,7 +14,7 @@
14
14
  import { randomUUID } from 'node:crypto';
15
15
  import { mkdir } from 'node:fs/promises';
16
16
  import { dirname } from 'node:path';
17
- import { ensureMemoryVecTable, tryLoadSqliteVec } from './sqlite-vec.js';
17
+ import { ensureMemoryVecTable, loadSqliteVecOrDegrade } from './sqlite-vec.js';
18
18
  export class AgentDatabase {
19
19
  db;
20
20
  _sqliteVec = false;
@@ -55,14 +55,15 @@ export class AgentDatabase {
55
55
  agentDb.createTables();
56
56
  // 可选:sqlite-vec + memory_vec 虚拟表
57
57
  const vecOpt = options?.sqliteVec;
58
- if (vecOpt) {
59
- const extensionPath = typeof vecOpt === 'object' ? vecOpt.extensionPath : undefined;
60
- const loaded = await tryLoadSqliteVec(db, extensionPath);
61
- agentDb._sqliteVec = loaded;
62
- if (loaded && options?.vectorDimensions) {
63
- const ok = ensureMemoryVecTable(db, options.vectorDimensions);
64
- agentDb._vecDimensions = ok ? options.vectorDimensions : null;
58
+ // AgentDatabase 缺省 = 不加载(与 KnowledgeDatabase 的「缺省尝试」不同;缺省在类上显式归一,防再吃 undefined 语义)
59
+ agentDb._sqliteVec = await loadSqliteVecOrDegrade(db, vecOpt ?? false, 'agent.db');
60
+ if (agentDb._sqliteVec && options?.vectorDimensions) {
61
+ const ok = ensureMemoryVecTable(db, options.vectorDimensions);
62
+ // require 档覆盖「实际可用」而不仅是扩展加载:建表失败同样 fail-loud(契约一致,M4)
63
+ if (!ok && typeof vecOpt === 'object' && vecOpt.require === true) {
64
+ throw new Error("sqlite_vec_table_failed: memory_vec table creation failed under vectorEngine='sqlite-vec'");
65
65
  }
66
+ agentDb._vecDimensions = ok ? options.vectorDimensions : null;
66
67
  }
67
68
  return agentDb;
68
69
  }
@@ -6,13 +6,17 @@
6
6
  *
7
7
  * @module
8
8
  */
9
- import type { ActivatedGraph, AdmitConceptInput, AdmitConceptResult, AdmitEdgeInput, AdmitEdgeResult, ConceptGraph, ConceptGraphStats, ConceptGraphStore, DecayResult, MergeCandidate, SpreadingActivateOptions } from '../cognition-types.js';
9
+ import type { ActivatedGraph, AdmitConceptInput, AdmitConceptResult, AdmitEdgeInput, AdmitEdgeResult, ConceptGraph, ConceptGraphStats, ConceptGraphStore, ConceptKind, DecayResult, MergeCandidate, SpreadingActivateOptions } from '../cognition-types.js';
10
10
  import { AgentDatabase } from './agent-db.js';
11
11
  import type { EmbeddingProvider } from './embedding.js';
12
12
  export interface SqliteConceptGraphOptions {
13
13
  embeddingProvider?: EmbeddingProvider | null;
14
- /** embedding 自动合并距离上限(仅指纹兼容时);默认 0.20 */
14
+ /** 强同义距离:≤ 此值的近邻候选在 fingerprintDiff 落 `strong_near`(供裁决优先);不再触发自动合并(跨名一律候选) */
15
15
  mergeThreshold?: number;
16
+ /** 语义种子距离带(相关性域:查询→概念名,实测相关对 0.41–0.59);默认 0.65,与 merge 同一性带不同域 */
17
+ semanticSeedMaxDistance?: number;
18
+ /** 语义种子查询嵌入超时(毫秒;热路径防无界延迟,超时降级空种子);默认 5000 */
19
+ semanticSeedEmbedTimeoutMs?: number;
16
20
  /** 近阈带上界;[lo, hi) 写 merge_candidates,默认 0.35 */
17
21
  candidateBandHi?: number;
18
22
  /** capacity 软顶 */
@@ -29,6 +33,10 @@ export declare class SqliteConceptGraph implements ConceptGraphStore {
29
33
  private embedding;
30
34
  private mergeThreshold;
31
35
  private candidateBandHi;
36
+ private semanticSeedMaxDistance;
37
+ private semanticSeedEmbedTimeoutMs;
38
+ /** 已解析向量缓存:key=概念 id,value=updated_at 指纹 + 向量(写入即换指纹,天然失效) */
39
+ private parsedVectorCache;
32
40
  private stopNodes;
33
41
  private stopEdges;
34
42
  private decayFloor;
@@ -38,6 +46,7 @@ export declare class SqliteConceptGraph implements ConceptGraphStore {
38
46
  private rowToNode;
39
47
  private rowToEdge;
40
48
  admitConcept(input: AdmitConceptInput): Promise<AdmitConceptResult>;
49
+ /** 义项指纹冲突:仅 kind 不同。domain 是多值标签不参与义项判定(同名同 kind 合并且 domain 取并集) */
41
50
  private fingerprintConflict;
42
51
  private insertConcept;
43
52
  private insertMergeCandidate;
@@ -53,7 +62,21 @@ export declare class SqliteConceptGraph implements ConceptGraphStore {
53
62
  note?: string;
54
63
  }): Promise<void>;
55
64
  listMergeCandidates(limit?: number): Promise<MergeCandidate[]>;
56
- resolveMerge(id: string, action: 'merge' | 'keep_split' | 'drop'): Promise<void>;
65
+ /** 语义种子能力:已注 embeddingProvider 才可做查询近邻 */
66
+ get supportsSemanticSeeds(): boolean;
67
+ /**
68
+ * 查询语义种子:查询文本经自有 provider 嵌入后,对已存向量做近邻扫描。
69
+ * 距离带用 `semanticSeedMaxDistance`(相关性域,默认 0.65)——与 merge 的同一性带
70
+ * (candidateBandHi 0.35)不同域:真模型下「查询句→短概念名」相关对实测 0.41–0.59。
71
+ *
72
+ * @param query - 查询文本
73
+ * @param k - 种子上限(缺省 4)
74
+ * @returns 概念名列表(近者优先);provider 缺失/嵌入失败/无近邻/维度失配行 → 空/跳过(增强路径不 fail)
75
+ */
76
+ semanticSeeds(query: string, k?: number): Promise<string[]>;
77
+ resolveMerge(id: string, action: 'merge' | 'keep_split' | 'drop', options?: {
78
+ canonicalKind?: ConceptKind;
79
+ }): Promise<void>;
57
80
  reinforce(input: {
58
81
  nodeIds?: string[];
59
82
  edgeIds?: string[];
@@ -8,23 +8,34 @@
8
8
  */
9
9
  import { counterEvidenceWeaken, DEFAULT_EDGE_DECAY_FLOOR, DEFAULT_RETRIEVE_STATUSES, hebbianStrengthen, nextEdgeStrength, } from '../cognition-decay.js';
10
10
  import { evaluateConceptGate, licenseEdge, normalizeForCue } from '../cognition-gates.js';
11
+ import { createSeedMatcher, normName } from '../cognition-seeds.js';
11
12
  import { AgentDatabase } from './agent-db.js';
12
13
  import { cosineDistance, parseEmbedding, serializeEmbedding } from './vector-search.js';
13
14
  function daysBetween(a, b) {
14
15
  return Math.max(0, (b - a) / 86_400_000);
15
16
  }
16
- function normName(name) {
17
- return name.trim().toLowerCase();
18
- }
19
- /** 转义 LIKE 通配符(配合 ESCAPE '\') */
20
- function escapeLike(s) {
21
- return s.replace(/[\\%_]/g, (c) => `\\${c}`);
17
+ /** 增强路径限时:超时拒绝;内层 Promise 终态经 then 兜底,无悬挂未处理拒绝 */
18
+ function withTimeout(p, ms) {
19
+ return new Promise((resolve, reject) => {
20
+ const t = setTimeout(() => reject(new Error(`timeout after ${ms}ms`)), ms);
21
+ p.then((v) => {
22
+ clearTimeout(t);
23
+ resolve(v);
24
+ }, (e) => {
25
+ clearTimeout(t);
26
+ reject(e);
27
+ });
28
+ });
22
29
  }
23
30
  export class SqliteConceptGraph {
24
31
  db;
25
32
  embedding;
26
33
  mergeThreshold;
27
34
  candidateBandHi;
35
+ semanticSeedMaxDistance;
36
+ semanticSeedEmbedTimeoutMs;
37
+ /** 已解析向量缓存:key=概念 id,value=updated_at 指纹 + 向量(写入即换指纹,天然失效) */
38
+ parsedVectorCache = new Map();
28
39
  stopNodes;
29
40
  stopEdges;
30
41
  decayFloor;
@@ -34,6 +45,8 @@ export class SqliteConceptGraph {
34
45
  this.embedding = options?.embeddingProvider ?? null;
35
46
  this.mergeThreshold = options?.mergeThreshold ?? 0.2;
36
47
  this.candidateBandHi = options?.candidateBandHi ?? 0.35;
48
+ this.semanticSeedMaxDistance = options?.semanticSeedMaxDistance ?? 0.65;
49
+ this.semanticSeedEmbedTimeoutMs = options?.semanticSeedEmbedTimeoutMs ?? 5000;
37
50
  this.stopNodes = options?.stopNodes ?? 10_000;
38
51
  this.stopEdges = options?.stopEdges ?? 40_000;
39
52
  this.decayFloor = options?.decayFloor ?? DEFAULT_EDGE_DECAY_FLOOR;
@@ -99,8 +112,10 @@ export class SqliteConceptGraph {
99
112
  return { action: 'rejected', reason: gate.reason, message: gate.message };
100
113
  }
101
114
  const nameKey = normName(input.name);
115
+ // 注意:SQLite LOWER() 仅折 ASCII,与 JS toLowerCase 的 Unicode 折叠有别(CJK 无碍)——
116
+ // 归一根治(name_key 列)见 arch/open-problems OP-9R 遗留
102
117
  const existing = this.db.raw
103
- .prepare('SELECT * FROM concepts WHERE LOWER(name) = ?')
118
+ .prepare('SELECT * FROM concepts WHERE LOWER(name) = ? ORDER BY created_at ASC, id ASC')
104
119
  .all(nameKey);
105
120
  // 同名多义项:指纹兼容则合并,冲突则新建 + merge_candidate
106
121
  const conflicts = [];
@@ -112,9 +127,10 @@ export class SqliteConceptGraph {
112
127
  continue;
113
128
  }
114
129
  const memIds = new Set([...node.memoryIds, ...(input.memoryIds ?? [])]);
130
+ const domains = new Set([...node.domain, ...(input.domain ?? [])]);
115
131
  this.db.raw
116
- .prepare('UPDATE concepts SET frequency = frequency + 1, memory_ids = ?, description = COALESCE(description, ?), updated_at = ? WHERE id = ?')
117
- .run(JSON.stringify([...memIds]), input.description ?? null, Date.now(), node.id);
132
+ .prepare('UPDATE concepts SET frequency = frequency + 1, memory_ids = ?, domain = ?, description = COALESCE(description, ?), updated_at = ? WHERE id = ?')
133
+ .run(JSON.stringify([...memIds]), JSON.stringify([...domains]), input.description ?? null, Date.now(), node.id);
118
134
  return { action: 'merged', id: node.id, reason: 'ok' };
119
135
  }
120
136
  // embedding 近邻
@@ -122,17 +138,14 @@ export class SqliteConceptGraph {
122
138
  const vec = await this.embedding.embed(input.name);
123
139
  const near = await this.findSimilarConcept(vec);
124
140
  if (near) {
141
+ // 跨名一律退候选、不自动合并(拍板 2026-11-19):自动合并会静默吞名、无审计、支撑虚高
125
142
  const conflict = this.fingerprintConflict(near.node, input);
143
+ const id = this.insertConcept(input, vec);
144
+ const fingerprintDiff = conflict ? [conflict] : [];
126
145
  if (!conflict && near.distance <= this.mergeThreshold) {
127
- const memIds = new Set([...near.node.memoryIds, ...(input.memoryIds ?? [])]);
128
- this.db.raw
129
- .prepare('UPDATE concepts SET frequency = frequency + 1, memory_ids = ?, updated_at = ? WHERE id = ?')
130
- .run(JSON.stringify([...memIds]), Date.now(), near.node.id);
131
- return { action: 'merged', id: near.node.id, reason: 'ok' };
146
+ fingerprintDiff.push('strong_near');
132
147
  }
133
- // 近阈带或指纹冲突 → candidate
134
- const id = this.insertConcept(input, vec);
135
- const candidateId = this.insertMergeCandidate(near.node.id, id, conflict ?? 'embedding_band', near.distance, conflict ? [conflict] : []);
148
+ const candidateId = this.insertMergeCandidate(near.node.id, id, conflict ?? 'embedding_band', near.distance, fingerprintDiff);
136
149
  return {
137
150
  action: 'merge_candidate',
138
151
  id,
@@ -154,19 +167,10 @@ export class SqliteConceptGraph {
154
167
  }
155
168
  return { action: 'created', id, reason: 'ok' };
156
169
  }
170
+ /** 义项指纹冲突:仅 kind 不同。domain 是多值标签不参与义项判定(同名同 kind 合并且 domain 取并集) */
157
171
  fingerprintConflict(existing, input) {
158
- if (existing.kind !== input.kind && existing.kind !== 'construct' && input.kind !== 'construct') {
159
- return `kind:${existing.kind}≠${input.kind}`;
160
- }
161
172
  if (existing.kind !== input.kind)
162
173
  return `kind:${existing.kind}≠${input.kind}`;
163
- const a = new Set(existing.domain);
164
- const b = new Set(input.domain ?? []);
165
- if (a.size > 0 && b.size > 0) {
166
- const overlap = [...b].some((d) => a.has(d));
167
- if (!overlap)
168
- return 'domain_disjoint';
169
- }
170
174
  return null;
171
175
  }
172
176
  insertConcept(input, vec) {
@@ -175,7 +179,7 @@ export class SqliteConceptGraph {
175
179
  this.db.raw
176
180
  .prepare(`INSERT INTO concepts (id, name, kind, description, frequency, memory_ids, domain, status, embedding, created_at, updated_at)
177
181
  VALUES (?, ?, ?, ?, 1, ?, ?, 'shadow', ?, ?, ?)`)
178
- .run(id, input.name.trim(), input.kind, input.description ?? null, JSON.stringify(input.memoryIds ?? []), JSON.stringify(input.domain ?? []), vec ? serializeEmbedding(vec) : null, now, now);
182
+ .run(id, input.name.trim(), input.kind, input.description ?? null, JSON.stringify([...new Set(input.memoryIds ?? [])]), JSON.stringify([...new Set(input.domain ?? [])]), vec ? serializeEmbedding(vec) : null, now, now);
179
183
  return id;
180
184
  }
181
185
  insertMergeCandidate(leftId, rightId, reason, distance, fingerprintDiff) {
@@ -194,8 +198,8 @@ export class SqliteConceptGraph {
194
198
  let best = null;
195
199
  for (const row of rows) {
196
200
  const vec = parseEmbedding(row.embedding);
197
- if (!vec)
198
- continue;
201
+ if (!vec || vec.length !== embedding.length)
202
+ continue; // 维度失配行跳过(与 semanticSeeds 同守卫)
199
203
  const distance = cosineDistance(embedding, vec);
200
204
  if (!best || distance < best.distance) {
201
205
  best = { node: this.rowToNode(row), distance };
@@ -318,7 +322,7 @@ export class SqliteConceptGraph {
318
322
  }
319
323
  async listMergeCandidates(limit = 50) {
320
324
  const rows = this.db.raw
321
- .prepare(`SELECT * FROM concept_merge_candidates WHERE status = 'open' ORDER BY created_at DESC LIMIT ?`)
325
+ .prepare(`SELECT * FROM concept_merge_candidates WHERE status = 'open' ORDER BY created_at ASC LIMIT ?`)
322
326
  .all(limit);
323
327
  return rows.map((r) => ({
324
328
  id: r.id,
@@ -333,7 +337,55 @@ export class SqliteConceptGraph {
333
337
  resolvedAction: r.resolved_action ?? undefined,
334
338
  }));
335
339
  }
336
- async resolveMerge(id, action) {
340
+ /** 语义种子能力:已注 embeddingProvider 才可做查询近邻 */
341
+ get supportsSemanticSeeds() {
342
+ return this.embedding != null;
343
+ }
344
+ /**
345
+ * 查询语义种子:查询文本经自有 provider 嵌入后,对已存向量做近邻扫描。
346
+ * 距离带用 `semanticSeedMaxDistance`(相关性域,默认 0.65)——与 merge 的同一性带
347
+ * (candidateBandHi 0.35)不同域:真模型下「查询句→短概念名」相关对实测 0.41–0.59。
348
+ *
349
+ * @param query - 查询文本
350
+ * @param k - 种子上限(缺省 4)
351
+ * @returns 概念名列表(近者优先);provider 缺失/嵌入失败/无近邻/维度失配行 → 空/跳过(增强路径不 fail)
352
+ */
353
+ async semanticSeeds(query, k = 4) {
354
+ if (!this.embedding || !query.trim())
355
+ return [];
356
+ const limit = Math.max(1, Math.floor(k));
357
+ let vec;
358
+ try {
359
+ vec = await withTimeout(this.embedding.embed(query), this.semanticSeedEmbedTimeoutMs);
360
+ }
361
+ catch {
362
+ // 增强路径:嵌入失败/超时降级空种子(词面召回照常),不向上抛
363
+ return [];
364
+ }
365
+ const rows = this.db.raw
366
+ .prepare('SELECT id, name, embedding, updated_at FROM concepts WHERE embedding IS NOT NULL')
367
+ .all();
368
+ const scored = [];
369
+ const freshCache = new Map();
370
+ for (const r of rows) {
371
+ const stamp = `${r.updated_at}`;
372
+ let entry = this.parsedVectorCache.get(r.id);
373
+ if (!entry || entry.stamp !== stamp) {
374
+ const parsed = r.embedding ? parseEmbedding(r.embedding) : null;
375
+ entry = parsed ? { stamp, vec: parsed } : null;
376
+ }
377
+ freshCache.set(r.id, entry);
378
+ if (!entry || entry.vec.length !== vec.length)
379
+ continue; // 维度失配行跳过(provider 换代遗留向量)
380
+ const distance = cosineDistance(vec, entry.vec);
381
+ if (distance <= this.semanticSeedMaxDistance)
382
+ scored.push({ name: r.name, distance });
383
+ }
384
+ this.parsedVectorCache = freshCache; // 顺带清掉已删行的缓存
385
+ scored.sort((a, b) => a.distance - b.distance);
386
+ return scored.slice(0, limit).map((s) => s.name);
387
+ }
388
+ async resolveMerge(id, action, options) {
337
389
  const row = this.db.raw
338
390
  .prepare('SELECT * FROM concept_merge_candidates WHERE id = ?')
339
391
  .get(id);
@@ -351,7 +403,7 @@ export class SqliteConceptGraph {
351
403
  if (!right && row.right_id.startsWith('pending:')) {
352
404
  const pendingName = row.right_id.slice('pending:'.length).toLowerCase();
353
405
  const candidates = this.db.raw
354
- .prepare('SELECT * FROM concepts WHERE LOWER(name) = ?')
406
+ .prepare('SELECT * FROM concepts WHERE LOWER(name) = ? ORDER BY created_at ASC, id ASC')
355
407
  .all(pendingName);
356
408
  // 同名多义项:取非 left 的第一个
357
409
  right = candidates.find((c) => c.id !== row.left_id);
@@ -369,7 +421,14 @@ export class SqliteConceptGraph {
369
421
  ...safeJsonArray(left.memory_ids),
370
422
  ...safeJsonArray(right.memory_ids),
371
423
  ]);
372
- db.prepare('UPDATE concepts SET frequency = frequency + ?, memory_ids = ?, updated_at = ? WHERE id = ?').run(right.frequency, JSON.stringify([...memIds]), Date.now(), left.id);
424
+ const domains = new Set([
425
+ ...safeJsonArray(left.domain),
426
+ ...safeJsonArray(right.domain),
427
+ ]);
428
+ db.prepare('UPDATE concepts SET frequency = frequency + ?, memory_ids = ?, domain = ?, description = COALESCE(description, ?), updated_at = ? WHERE id = ?').run(right.frequency, JSON.stringify([...memIds]), JSON.stringify([...domains]), right.description ?? null, Date.now(), left.id);
429
+ if (options?.canonicalKind && left.kind !== options.canonicalKind) {
430
+ db.prepare('UPDATE concepts SET kind = ?, updated_at = ? WHERE id = ?').run(options.canonicalKind, Date.now(), left.id);
431
+ }
373
432
  // 迁边前:丢掉会变自环的边
374
433
  db.prepare('DELETE FROM concept_edges WHERE (source_id = ? AND target_id = ?) OR (source_id = ? AND target_id = ?)')
375
434
  .run(left.id, right.id, right.id, left.id);
@@ -500,17 +559,16 @@ export class SqliteConceptGraph {
500
559
  return empty;
501
560
  const statusPlace = statuses.map(() => '?').join(',');
502
561
  const statusSet = new Set(statuses);
503
- const seedMap = new Map();
504
- for (const seed of seeds) {
505
- const q = `%${escapeLike(seed.toLowerCase())}%`;
506
- const rows = this.db.raw
507
- .prepare(`SELECT * FROM concepts WHERE status IN (${statusPlace})
508
- AND (LOWER(name) LIKE ? ESCAPE '\\' OR LOWER(description) LIKE ? ESCAPE '\\')`)
509
- .all(...statuses, q, q);
510
- for (const r of rows)
511
- seedMap.set(r.id, this.rowToNode(r));
512
- }
513
- const seedIds = [...seedMap.keys()];
562
+ // 反向匹配(token 含 name)无法下推 SQL:轻列扫描 + 共享谓词(cognition-seeds 单源)
563
+ const candidateRows = this.db.raw
564
+ .prepare(`SELECT id, name, description FROM concepts WHERE status IN (${statusPlace})`)
565
+ .all(...statuses);
566
+ const seedMatcher = createSeedMatcher(seeds);
567
+ const seedIds = [];
568
+ for (const r of candidateRows) {
569
+ if (seedMatcher(r.name, r.description))
570
+ seedIds.push(r.id);
571
+ }
514
572
  if (!seedIds.length)
515
573
  return empty;
516
574
  const activation = new Map();