@co-engram/core 0.1.0

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 (531) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +167 -0
  3. package/dist/config/defaults.d.ts +45 -0
  4. package/dist/config/defaults.d.ts.map +1 -0
  5. package/dist/config/defaults.js +70 -0
  6. package/dist/config/defaults.js.map +1 -0
  7. package/dist/config/index.d.ts +84 -0
  8. package/dist/config/index.d.ts.map +1 -0
  9. package/dist/config/index.js +230 -0
  10. package/dist/config/index.js.map +1 -0
  11. package/dist/config/types.d.ts +145 -0
  12. package/dist/config/types.d.ts.map +1 -0
  13. package/dist/config/types.js +14 -0
  14. package/dist/config/types.js.map +1 -0
  15. package/dist/contradiction/arbiter.d.ts +51 -0
  16. package/dist/contradiction/arbiter.d.ts.map +1 -0
  17. package/dist/contradiction/arbiter.js +112 -0
  18. package/dist/contradiction/arbiter.js.map +1 -0
  19. package/dist/contradiction/auto-degrade.d.ts +53 -0
  20. package/dist/contradiction/auto-degrade.d.ts.map +1 -0
  21. package/dist/contradiction/auto-degrade.js +79 -0
  22. package/dist/contradiction/auto-degrade.js.map +1 -0
  23. package/dist/contradiction/detector.d.ts +33 -0
  24. package/dist/contradiction/detector.d.ts.map +1 -0
  25. package/dist/contradiction/detector.js +76 -0
  26. package/dist/contradiction/detector.js.map +1 -0
  27. package/dist/contradiction/index.d.ts +11 -0
  28. package/dist/contradiction/index.d.ts.map +1 -0
  29. package/dist/contradiction/index.js +11 -0
  30. package/dist/contradiction/index.js.map +1 -0
  31. package/dist/contradiction/resolver.d.ts +45 -0
  32. package/dist/contradiction/resolver.d.ts.map +1 -0
  33. package/dist/contradiction/resolver.js +196 -0
  34. package/dist/contradiction/resolver.js.map +1 -0
  35. package/dist/contradiction/types.d.ts +73 -0
  36. package/dist/contradiction/types.d.ts.map +1 -0
  37. package/dist/contradiction/types.js +7 -0
  38. package/dist/contradiction/types.js.map +1 -0
  39. package/dist/dedup/dedupe.d.ts +49 -0
  40. package/dist/dedup/dedupe.d.ts.map +1 -0
  41. package/dist/dedup/dedupe.js +111 -0
  42. package/dist/dedup/dedupe.js.map +1 -0
  43. package/dist/dedup/hash.d.ts +27 -0
  44. package/dist/dedup/hash.d.ts.map +1 -0
  45. package/dist/dedup/hash.js +43 -0
  46. package/dist/dedup/hash.js.map +1 -0
  47. package/dist/dedup/index.d.ts +12 -0
  48. package/dist/dedup/index.d.ts.map +1 -0
  49. package/dist/dedup/index.js +12 -0
  50. package/dist/dedup/index.js.map +1 -0
  51. package/dist/dedup/llm-triage.d.ts +48 -0
  52. package/dist/dedup/llm-triage.d.ts.map +1 -0
  53. package/dist/dedup/llm-triage.js +100 -0
  54. package/dist/dedup/llm-triage.js.map +1 -0
  55. package/dist/dedup/merge.d.ts +41 -0
  56. package/dist/dedup/merge.d.ts.map +1 -0
  57. package/dist/dedup/merge.js +55 -0
  58. package/dist/dedup/merge.js.map +1 -0
  59. package/dist/dedup/similar.d.ts +45 -0
  60. package/dist/dedup/similar.d.ts.map +1 -0
  61. package/dist/dedup/similar.js +103 -0
  62. package/dist/dedup/similar.js.map +1 -0
  63. package/dist/dedup/types.d.ts +72 -0
  64. package/dist/dedup/types.d.ts.map +1 -0
  65. package/dist/dedup/types.js +18 -0
  66. package/dist/dedup/types.js.map +1 -0
  67. package/dist/disclosure/adaptive.d.ts +86 -0
  68. package/dist/disclosure/adaptive.d.ts.map +1 -0
  69. package/dist/disclosure/adaptive.js +196 -0
  70. package/dist/disclosure/adaptive.js.map +1 -0
  71. package/dist/disclosure/budget.d.ts +51 -0
  72. package/dist/disclosure/budget.d.ts.map +1 -0
  73. package/dist/disclosure/budget.js +91 -0
  74. package/dist/disclosure/budget.js.map +1 -0
  75. package/dist/disclosure/index.d.ts +11 -0
  76. package/dist/disclosure/index.d.ts.map +1 -0
  77. package/dist/disclosure/index.js +11 -0
  78. package/dist/disclosure/index.js.map +1 -0
  79. package/dist/disclosure/tier-loader.d.ts +58 -0
  80. package/dist/disclosure/tier-loader.d.ts.map +1 -0
  81. package/dist/disclosure/tier-loader.js +205 -0
  82. package/dist/disclosure/tier-loader.js.map +1 -0
  83. package/dist/dreaming/decay.d.ts +46 -0
  84. package/dist/dreaming/decay.d.ts.map +1 -0
  85. package/dist/dreaming/decay.js +69 -0
  86. package/dist/dreaming/decay.js.map +1 -0
  87. package/dist/dreaming/deep.d.ts +48 -0
  88. package/dist/dreaming/deep.d.ts.map +1 -0
  89. package/dist/dreaming/deep.js +41 -0
  90. package/dist/dreaming/deep.js.map +1 -0
  91. package/dist/dreaming/index.d.ts +12 -0
  92. package/dist/dreaming/index.d.ts.map +1 -0
  93. package/dist/dreaming/index.js +12 -0
  94. package/dist/dreaming/index.js.map +1 -0
  95. package/dist/dreaming/light.d.ts +54 -0
  96. package/dist/dreaming/light.d.ts.map +1 -0
  97. package/dist/dreaming/light.js +114 -0
  98. package/dist/dreaming/light.js.map +1 -0
  99. package/dist/dreaming/rem.d.ts +128 -0
  100. package/dist/dreaming/rem.d.ts.map +1 -0
  101. package/dist/dreaming/rem.js +228 -0
  102. package/dist/dreaming/rem.js.map +1 -0
  103. package/dist/dreaming/scheduler.d.ts +75 -0
  104. package/dist/dreaming/scheduler.d.ts.map +1 -0
  105. package/dist/dreaming/scheduler.js +138 -0
  106. package/dist/dreaming/scheduler.js.map +1 -0
  107. package/dist/dreaming/trash.d.ts +174 -0
  108. package/dist/dreaming/trash.d.ts.map +1 -0
  109. package/dist/dreaming/trash.js +466 -0
  110. package/dist/dreaming/trash.js.map +1 -0
  111. package/dist/evolution/category.d.ts +127 -0
  112. package/dist/evolution/category.d.ts.map +1 -0
  113. package/dist/evolution/category.js +271 -0
  114. package/dist/evolution/category.js.map +1 -0
  115. package/dist/evolution/index.d.ts +8 -0
  116. package/dist/evolution/index.d.ts.map +1 -0
  117. package/dist/evolution/index.js +8 -0
  118. package/dist/evolution/index.js.map +1 -0
  119. package/dist/evolution/triggered.d.ts +107 -0
  120. package/dist/evolution/triggered.d.ts.map +1 -0
  121. package/dist/evolution/triggered.js +278 -0
  122. package/dist/evolution/triggered.js.map +1 -0
  123. package/dist/generative/cross-pollinate.d.ts +144 -0
  124. package/dist/generative/cross-pollinate.d.ts.map +1 -0
  125. package/dist/generative/cross-pollinate.js +390 -0
  126. package/dist/generative/cross-pollinate.js.map +1 -0
  127. package/dist/generative/gap-detector.d.ts +80 -0
  128. package/dist/generative/gap-detector.d.ts.map +1 -0
  129. package/dist/generative/gap-detector.js +250 -0
  130. package/dist/generative/gap-detector.js.map +1 -0
  131. package/dist/generative/hypothesis.d.ts +161 -0
  132. package/dist/generative/hypothesis.d.ts.map +1 -0
  133. package/dist/generative/hypothesis.js +356 -0
  134. package/dist/generative/hypothesis.js.map +1 -0
  135. package/dist/generative/index.d.ts +9 -0
  136. package/dist/generative/index.d.ts.map +1 -0
  137. package/dist/generative/index.js +9 -0
  138. package/dist/generative/index.js.map +1 -0
  139. package/dist/graph/clustering.d.ts +117 -0
  140. package/dist/graph/clustering.d.ts.map +1 -0
  141. package/dist/graph/clustering.js +196 -0
  142. package/dist/graph/clustering.js.map +1 -0
  143. package/dist/graph/index.d.ts +13 -0
  144. package/dist/graph/index.d.ts.map +1 -0
  145. package/dist/graph/index.js +13 -0
  146. package/dist/graph/index.js.map +1 -0
  147. package/dist/graph/layout.d.ts +46 -0
  148. package/dist/graph/layout.d.ts.map +1 -0
  149. package/dist/graph/layout.js +269 -0
  150. package/dist/graph/layout.js.map +1 -0
  151. package/dist/graph/presets.d.ts +134 -0
  152. package/dist/graph/presets.d.ts.map +1 -0
  153. package/dist/graph/presets.js +190 -0
  154. package/dist/graph/presets.js.map +1 -0
  155. package/dist/graph/registry.d.ts +42 -0
  156. package/dist/graph/registry.d.ts.map +1 -0
  157. package/dist/graph/registry.js +158 -0
  158. package/dist/graph/registry.js.map +1 -0
  159. package/dist/graph/snapshot.d.ts +113 -0
  160. package/dist/graph/snapshot.d.ts.map +1 -0
  161. package/dist/graph/snapshot.js +194 -0
  162. package/dist/graph/snapshot.js.map +1 -0
  163. package/dist/graph/traverse.d.ts +84 -0
  164. package/dist/graph/traverse.d.ts.map +1 -0
  165. package/dist/graph/traverse.js +190 -0
  166. package/dist/graph/traverse.js.map +1 -0
  167. package/dist/graph/view-config.d.ts +99 -0
  168. package/dist/graph/view-config.d.ts.map +1 -0
  169. package/dist/graph/view-config.js +208 -0
  170. package/dist/graph/view-config.js.map +1 -0
  171. package/dist/host/detect-git-author.d.ts +26 -0
  172. package/dist/host/detect-git-author.d.ts.map +1 -0
  173. package/dist/host/detect-git-author.js +53 -0
  174. package/dist/host/detect-git-author.js.map +1 -0
  175. package/dist/host/index.d.ts +7 -0
  176. package/dist/host/index.d.ts.map +1 -0
  177. package/dist/host/index.js +7 -0
  178. package/dist/host/index.js.map +1 -0
  179. package/dist/i18n/en.d.ts +8 -0
  180. package/dist/i18n/en.d.ts.map +1 -0
  181. package/dist/i18n/en.js +211 -0
  182. package/dist/i18n/en.js.map +1 -0
  183. package/dist/i18n/field-names.d.ts +95 -0
  184. package/dist/i18n/field-names.d.ts.map +1 -0
  185. package/dist/i18n/field-names.js +329 -0
  186. package/dist/i18n/field-names.js.map +1 -0
  187. package/dist/i18n/index.d.ts +92 -0
  188. package/dist/i18n/index.d.ts.map +1 -0
  189. package/dist/i18n/index.js +135 -0
  190. package/dist/i18n/index.js.map +1 -0
  191. package/dist/i18n/types.d.ts +92 -0
  192. package/dist/i18n/types.d.ts.map +1 -0
  193. package/dist/i18n/types.js +7 -0
  194. package/dist/i18n/types.js.map +1 -0
  195. package/dist/i18n/zh.d.ts +197 -0
  196. package/dist/i18n/zh.d.ts.map +1 -0
  197. package/dist/i18n/zh.js +216 -0
  198. package/dist/i18n/zh.js.map +1 -0
  199. package/dist/importance/index.d.ts +7 -0
  200. package/dist/importance/index.d.ts.map +1 -0
  201. package/dist/importance/index.js +7 -0
  202. package/dist/importance/index.js.map +1 -0
  203. package/dist/importance/vector.d.ts +113 -0
  204. package/dist/importance/vector.d.ts.map +1 -0
  205. package/dist/importance/vector.js +202 -0
  206. package/dist/importance/vector.js.map +1 -0
  207. package/dist/index/digest-builder.d.ts +59 -0
  208. package/dist/index/digest-builder.d.ts.map +1 -0
  209. package/dist/index/digest-builder.js +195 -0
  210. package/dist/index/digest-builder.js.map +1 -0
  211. package/dist/index/graph-builder.d.ts +32 -0
  212. package/dist/index/graph-builder.d.ts.map +1 -0
  213. package/dist/index/graph-builder.js +104 -0
  214. package/dist/index/graph-builder.js.map +1 -0
  215. package/dist/index/incremental.d.ts +31 -0
  216. package/dist/index/incremental.d.ts.map +1 -0
  217. package/dist/index/incremental.js +47 -0
  218. package/dist/index/incremental.js.map +1 -0
  219. package/dist/index/index.d.ts +11 -0
  220. package/dist/index/index.d.ts.map +1 -0
  221. package/dist/index/index.js +11 -0
  222. package/dist/index/index.js.map +1 -0
  223. package/dist/index/orchestrator.d.ts +60 -0
  224. package/dist/index/orchestrator.d.ts.map +1 -0
  225. package/dist/index/orchestrator.js +99 -0
  226. package/dist/index/orchestrator.js.map +1 -0
  227. package/dist/index/types.d.ts +116 -0
  228. package/dist/index/types.d.ts.map +1 -0
  229. package/dist/index/types.js +10 -0
  230. package/dist/index/types.js.map +1 -0
  231. package/dist/index.d.ts +37 -0
  232. package/dist/index.d.ts.map +1 -0
  233. package/dist/index.js +37 -0
  234. package/dist/index.js.map +1 -0
  235. package/dist/learning/index.d.ts +7 -0
  236. package/dist/learning/index.d.ts.map +1 -0
  237. package/dist/learning/index.js +7 -0
  238. package/dist/learning/index.js.map +1 -0
  239. package/dist/learning/loop.d.ts +79 -0
  240. package/dist/learning/loop.d.ts.map +1 -0
  241. package/dist/learning/loop.js +116 -0
  242. package/dist/learning/loop.js.map +1 -0
  243. package/dist/lifecycle/freshness.d.ts +35 -0
  244. package/dist/lifecycle/freshness.d.ts.map +1 -0
  245. package/dist/lifecycle/freshness.js +60 -0
  246. package/dist/lifecycle/freshness.js.map +1 -0
  247. package/dist/lifecycle/index.d.ts +7 -0
  248. package/dist/lifecycle/index.d.ts.map +1 -0
  249. package/dist/lifecycle/index.js +7 -0
  250. package/dist/lifecycle/index.js.map +1 -0
  251. package/dist/lineage/index.d.ts +10 -0
  252. package/dist/lineage/index.d.ts.map +1 -0
  253. package/dist/lineage/index.js +10 -0
  254. package/dist/lineage/index.js.map +1 -0
  255. package/dist/lineage/trace.d.ts +142 -0
  256. package/dist/lineage/trace.d.ts.map +1 -0
  257. package/dist/lineage/trace.js +316 -0
  258. package/dist/lineage/trace.js.map +1 -0
  259. package/dist/maintenance/engine.d.ts +78 -0
  260. package/dist/maintenance/engine.d.ts.map +1 -0
  261. package/dist/maintenance/engine.js +291 -0
  262. package/dist/maintenance/engine.js.map +1 -0
  263. package/dist/maintenance/index.d.ts +8 -0
  264. package/dist/maintenance/index.d.ts.map +1 -0
  265. package/dist/maintenance/index.js +8 -0
  266. package/dist/maintenance/index.js.map +1 -0
  267. package/dist/maintenance/types.d.ts +111 -0
  268. package/dist/maintenance/types.d.ts.map +1 -0
  269. package/dist/maintenance/types.js +24 -0
  270. package/dist/maintenance/types.js.map +1 -0
  271. package/dist/observability/audit-log.d.ts +77 -0
  272. package/dist/observability/audit-log.d.ts.map +1 -0
  273. package/dist/observability/audit-log.js +101 -0
  274. package/dist/observability/audit-log.js.map +1 -0
  275. package/dist/observability/effectiveness-tracker.d.ts +162 -0
  276. package/dist/observability/effectiveness-tracker.d.ts.map +1 -0
  277. package/dist/observability/effectiveness-tracker.js +251 -0
  278. package/dist/observability/effectiveness-tracker.js.map +1 -0
  279. package/dist/observability/index.d.ts +16 -0
  280. package/dist/observability/index.d.ts.map +1 -0
  281. package/dist/observability/index.js +16 -0
  282. package/dist/observability/index.js.map +1 -0
  283. package/dist/observability/necessity-evaluator.d.ts +116 -0
  284. package/dist/observability/necessity-evaluator.d.ts.map +1 -0
  285. package/dist/observability/necessity-evaluator.js +487 -0
  286. package/dist/observability/necessity-evaluator.js.map +1 -0
  287. package/dist/observability/proposal-engine.d.ts +224 -0
  288. package/dist/observability/proposal-engine.d.ts.map +1 -0
  289. package/dist/observability/proposal-engine.js +651 -0
  290. package/dist/observability/proposal-engine.js.map +1 -0
  291. package/dist/perspectives/index.d.ts +7 -0
  292. package/dist/perspectives/index.d.ts.map +1 -0
  293. package/dist/perspectives/index.js +7 -0
  294. package/dist/perspectives/index.js.map +1 -0
  295. package/dist/perspectives/multi-view.d.ts +81 -0
  296. package/dist/perspectives/multi-view.d.ts.map +1 -0
  297. package/dist/perspectives/multi-view.js +221 -0
  298. package/dist/perspectives/multi-view.js.map +1 -0
  299. package/dist/prompt-builder/builder.d.ts +47 -0
  300. package/dist/prompt-builder/builder.d.ts.map +1 -0
  301. package/dist/prompt-builder/builder.js +136 -0
  302. package/dist/prompt-builder/builder.js.map +1 -0
  303. package/dist/prompt-builder/index.d.ts +8 -0
  304. package/dist/prompt-builder/index.d.ts.map +1 -0
  305. package/dist/prompt-builder/index.js +8 -0
  306. package/dist/prompt-builder/index.js.map +1 -0
  307. package/dist/prompt-builder/types.d.ts +42 -0
  308. package/dist/prompt-builder/types.d.ts.map +1 -0
  309. package/dist/prompt-builder/types.js +10 -0
  310. package/dist/prompt-builder/types.js.map +1 -0
  311. package/dist/prompt-signals/cache.d.ts +36 -0
  312. package/dist/prompt-signals/cache.d.ts.map +1 -0
  313. package/dist/prompt-signals/cache.js +70 -0
  314. package/dist/prompt-signals/cache.js.map +1 -0
  315. package/dist/prompt-signals/index.d.ts +12 -0
  316. package/dist/prompt-signals/index.d.ts.map +1 -0
  317. package/dist/prompt-signals/index.js +11 -0
  318. package/dist/prompt-signals/index.js.map +1 -0
  319. package/dist/prompt-signals/stats.d.ts +45 -0
  320. package/dist/prompt-signals/stats.d.ts.map +1 -0
  321. package/dist/prompt-signals/stats.js +119 -0
  322. package/dist/prompt-signals/stats.js.map +1 -0
  323. package/dist/prompt-signals/types.d.ts +53 -0
  324. package/dist/prompt-signals/types.d.ts.map +1 -0
  325. package/dist/prompt-signals/types.js +34 -0
  326. package/dist/prompt-signals/types.js.map +1 -0
  327. package/dist/provenance/index.d.ts +7 -0
  328. package/dist/provenance/index.d.ts.map +1 -0
  329. package/dist/provenance/index.js +7 -0
  330. package/dist/provenance/index.js.map +1 -0
  331. package/dist/provenance/reliability.d.ts +133 -0
  332. package/dist/provenance/reliability.d.ts.map +1 -0
  333. package/dist/provenance/reliability.js +213 -0
  334. package/dist/provenance/reliability.js.map +1 -0
  335. package/dist/reinforcement/config.d.ts +34 -0
  336. package/dist/reinforcement/config.d.ts.map +1 -0
  337. package/dist/reinforcement/config.js +43 -0
  338. package/dist/reinforcement/config.js.map +1 -0
  339. package/dist/reinforcement/index.d.ts +12 -0
  340. package/dist/reinforcement/index.d.ts.map +1 -0
  341. package/dist/reinforcement/index.js +12 -0
  342. package/dist/reinforcement/index.js.map +1 -0
  343. package/dist/reinforcement/ltd.d.ts +59 -0
  344. package/dist/reinforcement/ltd.d.ts.map +1 -0
  345. package/dist/reinforcement/ltd.js +90 -0
  346. package/dist/reinforcement/ltd.js.map +1 -0
  347. package/dist/reinforcement/ltp.d.ts +63 -0
  348. package/dist/reinforcement/ltp.d.ts.map +1 -0
  349. package/dist/reinforcement/ltp.js +99 -0
  350. package/dist/reinforcement/ltp.js.map +1 -0
  351. package/dist/reinforcement/related.d.ts +39 -0
  352. package/dist/reinforcement/related.d.ts.map +1 -0
  353. package/dist/reinforcement/related.js +92 -0
  354. package/dist/reinforcement/related.js.map +1 -0
  355. package/dist/retrieval/filter.d.ts +18 -0
  356. package/dist/retrieval/filter.d.ts.map +1 -0
  357. package/dist/retrieval/filter.js +68 -0
  358. package/dist/retrieval/filter.js.map +1 -0
  359. package/dist/retrieval/fts.d.ts +44 -0
  360. package/dist/retrieval/fts.d.ts.map +1 -0
  361. package/dist/retrieval/fts.js +120 -0
  362. package/dist/retrieval/fts.js.map +1 -0
  363. package/dist/retrieval/index.d.ts +10 -0
  364. package/dist/retrieval/index.d.ts.map +1 -0
  365. package/dist/retrieval/index.js +10 -0
  366. package/dist/retrieval/index.js.map +1 -0
  367. package/dist/retrieval/orchestrator.d.ts +78 -0
  368. package/dist/retrieval/orchestrator.d.ts.map +1 -0
  369. package/dist/retrieval/orchestrator.js +156 -0
  370. package/dist/retrieval/orchestrator.js.map +1 -0
  371. package/dist/retrieval/scoring.d.ts +105 -0
  372. package/dist/retrieval/scoring.d.ts.map +1 -0
  373. package/dist/retrieval/scoring.js +165 -0
  374. package/dist/retrieval/scoring.js.map +1 -0
  375. package/dist/signals/extract.d.ts +98 -0
  376. package/dist/signals/extract.d.ts.map +1 -0
  377. package/dist/signals/extract.js +388 -0
  378. package/dist/signals/extract.js.map +1 -0
  379. package/dist/signals/file-sink.d.ts +81 -0
  380. package/dist/signals/file-sink.d.ts.map +1 -0
  381. package/dist/signals/file-sink.js +227 -0
  382. package/dist/signals/file-sink.js.map +1 -0
  383. package/dist/signals/index.d.ts +12 -0
  384. package/dist/signals/index.d.ts.map +1 -0
  385. package/dist/signals/index.js +12 -0
  386. package/dist/signals/index.js.map +1 -0
  387. package/dist/signals/rpe.d.ts +60 -0
  388. package/dist/signals/rpe.d.ts.map +1 -0
  389. package/dist/signals/rpe.js +68 -0
  390. package/dist/signals/rpe.js.map +1 -0
  391. package/dist/signals/types.d.ts +80 -0
  392. package/dist/signals/types.d.ts.map +1 -0
  393. package/dist/signals/types.js +14 -0
  394. package/dist/signals/types.js.map +1 -0
  395. package/dist/storage/engram-index.d.ts +73 -0
  396. package/dist/storage/engram-index.d.ts.map +1 -0
  397. package/dist/storage/engram-index.js +215 -0
  398. package/dist/storage/engram-index.js.map +1 -0
  399. package/dist/storage/engram-store.d.ts +147 -0
  400. package/dist/storage/engram-store.d.ts.map +1 -0
  401. package/dist/storage/engram-store.js +221 -0
  402. package/dist/storage/engram-store.js.map +1 -0
  403. package/dist/storage/git-stage.d.ts +56 -0
  404. package/dist/storage/git-stage.d.ts.map +1 -0
  405. package/dist/storage/git-stage.js +147 -0
  406. package/dist/storage/git-stage.js.map +1 -0
  407. package/dist/storage/git.d.ts +57 -0
  408. package/dist/storage/git.d.ts.map +1 -0
  409. package/dist/storage/git.js +156 -0
  410. package/dist/storage/git.js.map +1 -0
  411. package/dist/storage/hash.d.ts +23 -0
  412. package/dist/storage/hash.d.ts.map +1 -0
  413. package/dist/storage/hash.js +31 -0
  414. package/dist/storage/hash.js.map +1 -0
  415. package/dist/storage/index.d.ts +14 -0
  416. package/dist/storage/index.d.ts.map +1 -0
  417. package/dist/storage/index.js +14 -0
  418. package/dist/storage/index.js.map +1 -0
  419. package/dist/storage/path.d.ts +51 -0
  420. package/dist/storage/path.d.ts.map +1 -0
  421. package/dist/storage/path.js +72 -0
  422. package/dist/storage/path.js.map +1 -0
  423. package/dist/storage/repository.d.ts +342 -0
  424. package/dist/storage/repository.d.ts.map +1 -0
  425. package/dist/storage/repository.js +1221 -0
  426. package/dist/storage/repository.js.map +1 -0
  427. package/dist/storage/synapse-store.d.ts +113 -0
  428. package/dist/storage/synapse-store.d.ts.map +1 -0
  429. package/dist/storage/synapse-store.js +279 -0
  430. package/dist/storage/synapse-store.js.map +1 -0
  431. package/dist/tools/doctor-tools.d.ts +53 -0
  432. package/dist/tools/doctor-tools.d.ts.map +1 -0
  433. package/dist/tools/doctor-tools.js +97 -0
  434. package/dist/tools/doctor-tools.js.map +1 -0
  435. package/dist/tools/engram-tools.d.ts +166 -0
  436. package/dist/tools/engram-tools.d.ts.map +1 -0
  437. package/dist/tools/engram-tools.js +834 -0
  438. package/dist/tools/engram-tools.js.map +1 -0
  439. package/dist/tools/index.d.ts +16 -0
  440. package/dist/tools/index.d.ts.map +1 -0
  441. package/dist/tools/index.js +16 -0
  442. package/dist/tools/index.js.map +1 -0
  443. package/dist/tools/llm-descriptions.d.ts +61 -0
  444. package/dist/tools/llm-descriptions.d.ts.map +1 -0
  445. package/dist/tools/llm-descriptions.js +556 -0
  446. package/dist/tools/llm-descriptions.js.map +1 -0
  447. package/dist/tools/proposal-tools.d.ts +40 -0
  448. package/dist/tools/proposal-tools.d.ts.map +1 -0
  449. package/dist/tools/proposal-tools.js +99 -0
  450. package/dist/tools/proposal-tools.js.map +1 -0
  451. package/dist/tools/registry.d.ts +30 -0
  452. package/dist/tools/registry.d.ts.map +1 -0
  453. package/dist/tools/registry.js +43 -0
  454. package/dist/tools/registry.js.map +1 -0
  455. package/dist/tools/schemas.d.ts +715 -0
  456. package/dist/tools/schemas.d.ts.map +1 -0
  457. package/dist/tools/schemas.js +383 -0
  458. package/dist/tools/schemas.js.map +1 -0
  459. package/dist/tools/skill-tools.d.ts +26 -0
  460. package/dist/tools/skill-tools.d.ts.map +1 -0
  461. package/dist/tools/skill-tools.js +84 -0
  462. package/dist/tools/skill-tools.js.map +1 -0
  463. package/dist/tools/synapse-tools.d.ts +28 -0
  464. package/dist/tools/synapse-tools.d.ts.map +1 -0
  465. package/dist/tools/synapse-tools.js +177 -0
  466. package/dist/tools/synapse-tools.js.map +1 -0
  467. package/dist/tools/tool.d.ts +84 -0
  468. package/dist/tools/tool.d.ts.map +1 -0
  469. package/dist/tools/tool.js +22 -0
  470. package/dist/tools/tool.js.map +1 -0
  471. package/dist/tools/wrapped.d.ts +28 -0
  472. package/dist/tools/wrapped.d.ts.map +1 -0
  473. package/dist/tools/wrapped.js +172 -0
  474. package/dist/tools/wrapped.js.map +1 -0
  475. package/dist/types/disclosure.d.ts +70 -0
  476. package/dist/types/disclosure.d.ts.map +1 -0
  477. package/dist/types/disclosure.js +9 -0
  478. package/dist/types/disclosure.js.map +1 -0
  479. package/dist/types/engram.d.ts +203 -0
  480. package/dist/types/engram.d.ts.map +1 -0
  481. package/dist/types/engram.js +7 -0
  482. package/dist/types/engram.js.map +1 -0
  483. package/dist/types/index.d.ts +15 -0
  484. package/dist/types/index.d.ts.map +1 -0
  485. package/dist/types/index.js +15 -0
  486. package/dist/types/index.js.map +1 -0
  487. package/dist/types/intention.d.ts +91 -0
  488. package/dist/types/intention.d.ts.map +1 -0
  489. package/dist/types/intention.js +9 -0
  490. package/dist/types/intention.js.map +1 -0
  491. package/dist/types/repository-types.d.ts +113 -0
  492. package/dist/types/repository-types.d.ts.map +1 -0
  493. package/dist/types/repository-types.js +18 -0
  494. package/dist/types/repository-types.js.map +1 -0
  495. package/dist/types/scene.d.ts +52 -0
  496. package/dist/types/scene.d.ts.map +1 -0
  497. package/dist/types/scene.js +12 -0
  498. package/dist/types/scene.js.map +1 -0
  499. package/dist/types/skill.d.ts +107 -0
  500. package/dist/types/skill.d.ts.map +1 -0
  501. package/dist/types/skill.js +10 -0
  502. package/dist/types/skill.js.map +1 -0
  503. package/dist/types/slugify.d.ts +34 -0
  504. package/dist/types/slugify.d.ts.map +1 -0
  505. package/dist/types/slugify.js +55 -0
  506. package/dist/types/slugify.js.map +1 -0
  507. package/dist/types/synapse-id.d.ts +22 -0
  508. package/dist/types/synapse-id.d.ts.map +1 -0
  509. package/dist/types/synapse-id.js +34 -0
  510. package/dist/types/synapse-id.js.map +1 -0
  511. package/dist/types/synapse.d.ts +99 -0
  512. package/dist/types/synapse.d.ts.map +1 -0
  513. package/dist/types/synapse.js +9 -0
  514. package/dist/types/synapse.js.map +1 -0
  515. package/dist/verification/index.d.ts +11 -0
  516. package/dist/verification/index.d.ts.map +1 -0
  517. package/dist/verification/index.js +11 -0
  518. package/dist/verification/index.js.map +1 -0
  519. package/dist/verification/metacognition.d.ts +102 -0
  520. package/dist/verification/metacognition.d.ts.map +1 -0
  521. package/dist/verification/metacognition.js +284 -0
  522. package/dist/verification/metacognition.js.map +1 -0
  523. package/dist/verification/state-machine.d.ts +77 -0
  524. package/dist/verification/state-machine.d.ts.map +1 -0
  525. package/dist/verification/state-machine.js +126 -0
  526. package/dist/verification/state-machine.js.map +1 -0
  527. package/dist/verification/upgrade.d.ts +133 -0
  528. package/dist/verification/upgrade.d.ts.map +1 -0
  529. package/dist/verification/upgrade.js +364 -0
  530. package/dist/verification/upgrade.js.map +1 -0
  531. package/package.json +70 -0
@@ -0,0 +1,177 @@
1
+ /**
2
+ * Synapse 工具集(P0)
3
+ *
4
+ * 4 个工具:
5
+ * - synapse_create: 创建(含双方缓存更新)
6
+ * - synapse_get: 读取单条
7
+ * - synapse_delete: 删除(同步更新双方缓存)
8
+ * - synapse_list: 列出某 engram 的所有 synapses(出/入/双向)
9
+ *
10
+ * @module @co-engram/core/tools
11
+ */
12
+ import { validateInput } from "./tool.js";
13
+ import { randomUUID } from "node:crypto";
14
+ import { SynapseCreateInputSchema, SynapseGetInputSchema, SynapseDeleteInputSchema, SynapseListInputSchema, } from "./schemas.js";
15
+ // ============================================================
16
+ // synapse_create
17
+ // ============================================================
18
+ export const synapseCreateTool = {
19
+ name: "synapse_create",
20
+ description: '在两个 Engram 之间创建 Synapse(连接)。自动更新双方的 incoming/outgoing 缓存。createdBy 可选,缺省时回退到 ToolContext.defaultCreatedBy,再缺省回退到 "unknown"。',
21
+ inputSchema: SynapseCreateInputSchema,
22
+ execute(input, ctx) {
23
+ const parsed = validateInput(SynapseCreateInputSchema, input);
24
+ const createdBy = parsed.createdBy ?? ctx.defaultCreatedBy ?? "unknown";
25
+ // 校验端点存在
26
+ if (!ctx.repository.exists(parsed.from)) {
27
+ throw new Error(`Source engram not found: ${parsed.from}`);
28
+ }
29
+ if (!ctx.repository.exists(parsed.to)) {
30
+ throw new Error(`Target engram not found: ${parsed.to}`);
31
+ }
32
+ if (parsed.from === parsed.to) {
33
+ throw new Error("Self-synapse not allowed in P0");
34
+ }
35
+ const timestamp = new Date().toISOString();
36
+ const synapseId = randomUUID();
37
+ const evidence = (parsed.evidence ?? []).map((e) => ({
38
+ description: e.description,
39
+ source: e.source,
40
+ confidence: e.confidence,
41
+ addedAt: timestamp,
42
+ addedBy: e.addedBy,
43
+ }));
44
+ const synapse = {
45
+ id: synapseId,
46
+ from: parsed.from,
47
+ to: parsed.to,
48
+ kind: parsed.kind,
49
+ weight: parsed.weight,
50
+ direction: parsed.direction,
51
+ evidence,
52
+ createdBy,
53
+ createdAt: timestamp,
54
+ updatedAt: timestamp,
55
+ retrievalWeight: parsed.weight,
56
+ sourceSemantic: parsed.sourceSemantic,
57
+ targetSemantic: parsed.targetSemantic,
58
+ };
59
+ const stored = ctx.repository.addOutgoingSynapse(parsed.from, synapse);
60
+ const storedId = stored.id;
61
+ // audit:synapse_create 复用 'create' action,通过 synapseId 标记是 synapse
62
+ ctx.auditLog?.append({
63
+ actor: "user",
64
+ action: "create",
65
+ engramId: parsed.from,
66
+ metadata: {
67
+ target: "synapse",
68
+ synapseId: storedId,
69
+ from: parsed.from,
70
+ to: parsed.to,
71
+ kind: parsed.kind,
72
+ weight: parsed.weight,
73
+ direction: parsed.direction,
74
+ createdBy,
75
+ },
76
+ });
77
+ // M1: contradicts synapse 触发有效性信号(双方都记一次)
78
+ if (parsed.kind === "contradicts") {
79
+ ctx.auditLog?.append({
80
+ actor: "user",
81
+ action: "contradicted",
82
+ engramId: parsed.from,
83
+ metadata: { synapseId: storedId, contradictedBy: parsed.to, createdBy },
84
+ });
85
+ ctx.auditLog?.append({
86
+ actor: "user",
87
+ action: "contradicted",
88
+ engramId: parsed.to,
89
+ metadata: {
90
+ synapseId: storedId,
91
+ contradictedBy: parsed.from,
92
+ createdBy,
93
+ },
94
+ });
95
+ }
96
+ return { id: storedId };
97
+ },
98
+ };
99
+ // ============================================================
100
+ // synapse_get
101
+ // ============================================================
102
+ export const synapseGetTool = {
103
+ name: "synapse_get",
104
+ description: "读取单条 Synapse(通过 from engramId + synapseId)。",
105
+ inputSchema: SynapseGetInputSchema,
106
+ execute(input, ctx) {
107
+ const parsed = validateInput(SynapseGetInputSchema, input);
108
+ const file = ctx.repository.readSynapses(parsed.from);
109
+ const found = file.outgoing.find((s) => s.id === parsed.synapseId);
110
+ if (!found) {
111
+ throw new Error(`Synapse not found: from=${parsed.from} synapseId=${parsed.synapseId}`);
112
+ }
113
+ return found;
114
+ },
115
+ };
116
+ // ============================================================
117
+ // synapse_delete
118
+ // ============================================================
119
+ export const synapseDeleteTool = {
120
+ name: "synapse_delete",
121
+ description: "删除一条 Synapse(同步更新双方缓存)。",
122
+ inputSchema: SynapseDeleteInputSchema,
123
+ execute(input, ctx) {
124
+ const parsed = validateInput(SynapseDeleteInputSchema, input);
125
+ // 删前先读出原 synapse 信息(audit 用)
126
+ const before = ctx.repository
127
+ .readSynapses(parsed.from)
128
+ .outgoing.find((s) => s.id === parsed.synapseId);
129
+ ctx.repository.removeOutgoingSynapse(parsed.from, parsed.synapseId);
130
+ ctx.auditLog?.append({
131
+ actor: "user",
132
+ action: "purge",
133
+ engramId: parsed.from,
134
+ metadata: {
135
+ target: "synapse",
136
+ synapseId: parsed.synapseId,
137
+ from: parsed.from,
138
+ to: before?.to,
139
+ kind: before?.kind,
140
+ weight: before?.weight,
141
+ direction: before?.direction,
142
+ },
143
+ });
144
+ return { id: parsed.synapseId, deleted: true };
145
+ },
146
+ };
147
+ // ============================================================
148
+ // synapse_list
149
+ // ============================================================
150
+ export const synapseListTool = {
151
+ name: "synapse_list",
152
+ description: "列出某 Engram 的所有 Synapses(出边 / 入边 / 双向)。",
153
+ inputSchema: SynapseListInputSchema,
154
+ execute(input, ctx) {
155
+ const parsed = validateInput(SynapseListInputSchema, input);
156
+ const outgoing = parsed.direction === "outgoing" || parsed.direction === "both"
157
+ ? ctx.repository.readSynapses(parsed.engramId).outgoing
158
+ : [];
159
+ const incoming = parsed.direction === "incoming" || parsed.direction === "both"
160
+ ? ctx.repository
161
+ .collectAllSynapses()
162
+ .filter(({ synapse }) => synapse.to === parsed.engramId)
163
+ .map(({ synapse }) => synapse)
164
+ : [];
165
+ return {
166
+ outgoing: [...outgoing],
167
+ incoming,
168
+ };
169
+ },
170
+ };
171
+ export const ALL_SYNAPSE_TOOLS = [
172
+ synapseCreateTool,
173
+ synapseGetTool,
174
+ synapseDeleteTool,
175
+ synapseListTool,
176
+ ];
177
+ //# sourceMappingURL=synapse-tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"synapse-tools.js","sourceRoot":"","sources":["../../src/tools/synapse-tools.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,84 @@
1
+ /**
2
+ * 工具协议
3
+ *
4
+ * 统一的 Tool 接口,所有 Self-Editing Tool 都实现此接口。
5
+ * host adapter(OpenClaw / MCP)只需把 Tool 包装为各自的工具调用格式。
6
+ *
7
+ * @module @co-engram/core/tools
8
+ */
9
+ import type { ZodTypeAny } from "zod";
10
+ /**
11
+ * 工具元信息(可暴露给 host 用于注册)
12
+ */
13
+ export interface ToolMeta {
14
+ /** 工具名(snake_case,宿主中立) */
15
+ readonly name: string;
16
+ /** 工具描述(host 可展示给 LLM) */
17
+ readonly description: string;
18
+ /** 输入 schema(JSON Schema 友好,host 可直接转 MCP inputSchema) */
19
+ readonly inputSchema: ZodTypeAny;
20
+ }
21
+ /**
22
+ * 工具执行上下文
23
+ *
24
+ * 包含 repository / index / graph 等运行时依赖,
25
+ * 由 host 在调用时注入(依赖注入,避免工具直接 new)。
26
+ */
27
+ export interface ToolContext {
28
+ readonly repository: import("../storage/repository.js").EngramRepository;
29
+ readonly indexOrchestrator?: import("../index/orchestrator.js").IndexOrchestrator;
30
+ readonly searchOrchestrator?: import("../retrieval/orchestrator.js").SearchOrchestrator;
31
+ readonly graphTraverser?: import("../graph/traverse.js").GraphTraverser;
32
+ /**
33
+ * 当前会话 id(用于 behavioral signals 追踪)。
34
+ *
35
+ * 宿主每次工具调用注入新 UUID;维护引擎用 sliding window 替代会话边界。
36
+ */
37
+ readonly sessionId?: string;
38
+ /**
39
+ * 信号收集器(行为追踪)。
40
+ *
41
+ * 如果注入,tools/wrapped.ts 包装的工具会自动 append ToolCallEvent;
42
+ * 否则工具正常运行(不影响功能)。
43
+ */
44
+ readonly signalSink?: import("../signals/types.js").SignalSink;
45
+ /**
46
+ * 审计日志(可选,状态变更 + 有效性信号)。
47
+ *
48
+ * 如果注入,工具会在 create/update/reinforce/report_failure 等关键路径
49
+ * 自动 append 审计事件;否则不记录。
50
+ */
51
+ readonly auditLog?: import("../observability/audit-log.js").AuditLog;
52
+ /**
53
+ * 有效性追踪器(可选)。
54
+ *
55
+ * engram_search 命中时 openWindow;engram_reinforce 时 closeAsEffective;
56
+ * engram_report_failure 时 closeAsFailure。
57
+ */
58
+ readonly effectivenessTracker?: import("../observability/effectiveness-tracker.js").EffectivenessTracker;
59
+ /**
60
+ * 候选提案引擎(可选,用于 engram_list_proposals 等工具)。
61
+ */
62
+ readonly proposalEngine?: import("../observability/proposal-engine.js").ProposalEngine;
63
+ /**
64
+ * 默认作者标识(可选,用于 engram_create 的 createdBy 回退)。
65
+ *
66
+ * 工具调用方未显式传 createdBy 时,工具会用此值;
67
+ * 若此值也缺省,最终回退到 'unknown'。
68
+ * MCP 适配器从 CO_ENGRAM_DEFAULT_CREATED_BY 环境变量或持久化配置读取;
69
+ * OpenClaw 适配器从 plugin config.defaultCreatedBy 读取。
70
+ */
71
+ readonly defaultCreatedBy?: string;
72
+ }
73
+ /**
74
+ * 统一 Tool 接口
75
+ */
76
+ export interface Tool<I = unknown, O = unknown> extends ToolMeta {
77
+ /** 执行工具,返回结果或抛错 */
78
+ execute(input: I, ctx: ToolContext): Promise<O> | O;
79
+ }
80
+ /**
81
+ * 校验并解析输入(host adapter 通常在 execute 前调用)
82
+ */
83
+ export declare function validateInput<T>(schema: ZodTypeAny, raw: unknown): T;
84
+ //# sourceMappingURL=tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/tools/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,0BAA0B,EAAE,gBAAgB,CAAC;IACzE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,0BAA0B,EAAE,iBAAiB,CAAC;IAClF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,8BAA8B,EAAE,kBAAkB,CAAC;IACxF,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,sBAAsB,EAAE,cAAc,CAAC;IACxE;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,qBAAqB,EAAE,UAAU,CAAC;IAC/D;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,+BAA+B,EAAE,QAAQ,CAAC;IACrE;;;;;OAKG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,2CAA2C,EAAE,oBAAoB,CAAC;IACzG;;OAEG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,qCAAqC,EAAE,cAAc,CAAC;IACvF;;;;;;;OAOG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,CAAE,SAAQ,QAAQ;IAC9D,mBAAmB;IACnB,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC,CASpE"}
@@ -0,0 +1,22 @@
1
+ /**
2
+ * 工具协议
3
+ *
4
+ * 统一的 Tool 接口,所有 Self-Editing Tool 都实现此接口。
5
+ * host adapter(OpenClaw / MCP)只需把 Tool 包装为各自的工具调用格式。
6
+ *
7
+ * @module @co-engram/core/tools
8
+ */
9
+ /**
10
+ * 校验并解析输入(host adapter 通常在 execute 前调用)
11
+ */
12
+ export function validateInput(schema, raw) {
13
+ const result = schema.safeParse(raw);
14
+ if (!result.success) {
15
+ const issues = result.error.issues
16
+ .map((i) => `${i.path.join(".")}: ${i.message}`)
17
+ .join("; ");
18
+ throw new Error(`Invalid input: ${issues}`);
19
+ }
20
+ return result.data;
21
+ }
22
+ //# sourceMappingURL=tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/tools/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA6EH;;GAEG;AACH,MAAM,UAAU,aAAa,CAAI,MAAkB,EAAE,GAAY;IAC/D,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aAC/C,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,kBAAkB,MAAM,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,MAAM,CAAC,IAAS,CAAC;AAC1B,CAAC"}
@@ -0,0 +1,28 @@
1
+ /**
2
+ * 工具包装层:行为信号收集(P4 A.2)
3
+ *
4
+ * 在 Tool.execute 前后插入 SignalSink.append,自动捕获工具调用事件,
5
+ * 不依赖 agent 主动上报。
6
+ *
7
+ * 工作流:
8
+ * 1. host 创建 ToolContext 时注入 sessionId + signalSink
9
+ * 2. 调 wrapToolWithSignalSink(tool) 得到包装版本
10
+ * 3. 包装版本在 execute 前后 append ToolCallEvent
11
+ *
12
+ * 关键:append 是 fire-and-forget;失败不阻塞工具执行本身。
13
+ *
14
+ * @module @co-engram/core/tools
15
+ */
16
+ import type { Tool } from "./tool.js";
17
+ /**
18
+ * 包装一个工具:自动收集行为信号
19
+ *
20
+ * @param tool 原始工具
21
+ * @returns 包装后的工具(接口相同)
22
+ */
23
+ export declare function wrapToolWithSignalSink<I, O>(tool: Tool<I, O>): Tool<I, O>;
24
+ /**
25
+ * 批量包装工具注册表里的所有工具
26
+ */
27
+ export declare function wrapAllToolsWithSignalSink<I, O>(tools: readonly Tool<I, O>[]): readonly Tool<I, O>[];
28
+ //# sourceMappingURL=wrapped.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wrapped.d.ts","sourceRoot":"","sources":["../../src/tools/wrapped.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAe,MAAM,WAAW,CAAC;AAGnD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAuCzE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,CAAC,EAC7C,KAAK,EAAE,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAC3B,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAEvB"}
@@ -0,0 +1,172 @@
1
+ /**
2
+ * 工具包装层:行为信号收集(P4 A.2)
3
+ *
4
+ * 在 Tool.execute 前后插入 SignalSink.append,自动捕获工具调用事件,
5
+ * 不依赖 agent 主动上报。
6
+ *
7
+ * 工作流:
8
+ * 1. host 创建 ToolContext 时注入 sessionId + signalSink
9
+ * 2. 调 wrapToolWithSignalSink(tool) 得到包装版本
10
+ * 3. 包装版本在 execute 前后 append ToolCallEvent
11
+ *
12
+ * 关键:append 是 fire-and-forget;失败不阻塞工具执行本身。
13
+ *
14
+ * @module @co-engram/core/tools
15
+ */
16
+ import { randomUUID } from "node:crypto";
17
+ /**
18
+ * 包装一个工具:自动收集行为信号
19
+ *
20
+ * @param tool 原始工具
21
+ * @returns 包装后的工具(接口相同)
22
+ */
23
+ export function wrapToolWithSignalSink(tool) {
24
+ return {
25
+ ...tool,
26
+ async execute(input, ctx) {
27
+ const startedAt = Date.now();
28
+ let result;
29
+ let error;
30
+ let retrievedEngramIds;
31
+ try {
32
+ result = await tool.execute(input, ctx);
33
+ retrievedEngramIds = extractEngramIds(tool.name, input, result);
34
+ return result;
35
+ }
36
+ catch (err) {
37
+ error = err;
38
+ throw err;
39
+ }
40
+ finally {
41
+ // 即使出错也记录事件(失败也是信号)
42
+ if (ctx.signalSink) {
43
+ const event = {
44
+ toolName: tool.name,
45
+ input: sanitizeInput(input),
46
+ outputSummary: error
47
+ ? `error: ${summarizeError(error)}`
48
+ : summarizeResult(result),
49
+ retrievedEngramIds,
50
+ sessionId: ctx.sessionId ?? randomUUID(),
51
+ at: startedAt,
52
+ };
53
+ // fire-and-forget:失败不阻塞工具调用本身
54
+ try {
55
+ ctx.signalSink.append(event);
56
+ }
57
+ catch {
58
+ // intentional no-op
59
+ }
60
+ }
61
+ }
62
+ },
63
+ };
64
+ }
65
+ /**
66
+ * 批量包装工具注册表里的所有工具
67
+ */
68
+ export function wrapAllToolsWithSignalSink(tools) {
69
+ return tools.map((t) => wrapToolWithSignalSink(t));
70
+ }
71
+ // ============================================================
72
+ // 工具特定的输出解析
73
+ // ============================================================
74
+ /**
75
+ * 从工具调用结果中提取涉及的 engram id 列表
76
+ *
77
+ * 不同工具的输出结构不同:
78
+ * - engram_get / engram_create:直接返回 EngramView / { id }
79
+ * - engram_search / engram_list:返回 { hits: [{ id }] } 或 [{ id }]
80
+ * - synapse_create:返回 { id }(synapse id,不是 engram id)
81
+ * - 其他:无
82
+ */
83
+ function extractEngramIds(toolName, input, result) {
84
+ if (result === null || result === undefined)
85
+ return undefined;
86
+ // engram_get / engram_update:input.id 即为 engram id
87
+ if (toolName === "engram_get" || toolName === "engram_update") {
88
+ const id = input?.id;
89
+ return typeof id === "string" ? [id] : undefined;
90
+ }
91
+ // engram_create:result.id 即为新建 engram id
92
+ if (toolName === "engram_create") {
93
+ const id = result?.id;
94
+ return typeof id === "string" ? [id] : undefined;
95
+ }
96
+ // engram_search / engram_list:result.hits[].id 或 result[].id
97
+ if (toolName === "engram_search" || toolName === "engram_list") {
98
+ if (typeof result === "object" &&
99
+ result !== null &&
100
+ !Array.isArray(result)) {
101
+ const hits = result.hits;
102
+ if (Array.isArray(hits)) {
103
+ const ids = hits
104
+ .map((h) => h?.id)
105
+ .filter((id) => typeof id === "string");
106
+ return ids.length > 0 ? ids : undefined;
107
+ }
108
+ }
109
+ if (Array.isArray(result)) {
110
+ const ids = result
111
+ .map((r) => r?.id)
112
+ .filter((id) => typeof id === "string");
113
+ return ids.length > 0 ? ids : undefined;
114
+ }
115
+ return undefined;
116
+ }
117
+ // 其他工具:不提取 engram id
118
+ return undefined;
119
+ }
120
+ /**
121
+ * 简化 input(去掉可能的 binary / 大字段,只保留可序列化部分)
122
+ */
123
+ function sanitizeInput(input) {
124
+ if (input === null || typeof input !== "object") {
125
+ return { value: input };
126
+ }
127
+ // 只保留顶层 string / number / boolean 字段;嵌套对象/array 保留引用但不深拷
128
+ const sanitized = {};
129
+ for (const [k, v] of Object.entries(input)) {
130
+ if (typeof v === "string") {
131
+ // 截断长字符串(避免 signals.jsonl 膨胀)
132
+ sanitized[k] = v.length > 500 ? v.slice(0, 500) + "..." : v;
133
+ }
134
+ else if (typeof v === "number" || typeof v === "boolean") {
135
+ sanitized[k] = v;
136
+ }
137
+ else if (Array.isArray(v)) {
138
+ // 数组只保留 length
139
+ sanitized[k] = `<array:${v.length}>`;
140
+ }
141
+ else if (v !== null && typeof v === "object") {
142
+ sanitized[k] = "<object>";
143
+ }
144
+ }
145
+ return sanitized;
146
+ }
147
+ function summarizeResult(result) {
148
+ if (result === null || result === undefined)
149
+ return "null";
150
+ if (typeof result === "string") {
151
+ return result.length > 200 ? result.slice(0, 200) + "..." : result;
152
+ }
153
+ if (typeof result !== "object")
154
+ return String(result);
155
+ // 对象:取前几个 key 的概要
156
+ const keys = Object.keys(result);
157
+ if (keys.length === 0)
158
+ return "{}";
159
+ // 如果有 hits 字段,重点摘要
160
+ const hits = result.hits;
161
+ if (Array.isArray(hits)) {
162
+ return `{hits: ${hits.length}}`;
163
+ }
164
+ // 否则只返回 key 列表
165
+ return `{${keys.slice(0, 5).join(",")}}`;
166
+ }
167
+ function summarizeError(err) {
168
+ if (err instanceof Error)
169
+ return err.message.slice(0, 200);
170
+ return String(err).slice(0, 200);
171
+ }
172
+ //# sourceMappingURL=wrapped.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wrapped.js","sourceRoot":"","sources":["../../src/tools/wrapped.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,70 @@
1
+ /**
2
+ * 渐进式披露类型定义
3
+ *
4
+ * Tier 0/1/2/3/4 数据单元(按粒度递增,不固定分层)
5
+ *
6
+ * @module @co-engram/core/types
7
+ */
8
+ import type { EngramCatalogEntry, EngramDigest, EngramId } from "./engram.js";
9
+ import type { Synapse } from "./synapse.js";
10
+ /** 披露层级 */
11
+ export type DisclosureTier = "catalog" | "digest" | "content" | "meta" | "synapses";
12
+ /** Context Window 预算 */
13
+ export interface ContextBudget {
14
+ readonly totalTokens: number;
15
+ readonly remaining: number;
16
+ readonly reserved: number;
17
+ }
18
+ /** Synapse Bundle(Tier 4,扩展联想) */
19
+ export interface SynapseBundle {
20
+ readonly engramId: EngramId;
21
+ readonly outgoing: readonly Synapse[];
22
+ readonly incoming: readonly Synapse[];
23
+ readonly neighborDigests: readonly EngramDigest[];
24
+ }
25
+ /** 加载的 Engram 视图(可处于不同披露层级) */
26
+ export type EngramView = {
27
+ readonly tier: "catalog";
28
+ readonly entry: EngramCatalogEntry;
29
+ } | {
30
+ readonly tier: "digest";
31
+ readonly digest: EngramDigest;
32
+ } | {
33
+ readonly tier: "content";
34
+ readonly entry: EngramCatalogEntry;
35
+ readonly content: string;
36
+ } | {
37
+ readonly tier: "meta";
38
+ readonly entry: EngramCatalogEntry;
39
+ readonly meta: Record<string, unknown>;
40
+ } | {
41
+ readonly tier: "synapses";
42
+ readonly bundle: SynapseBundle;
43
+ };
44
+ /** 检索过滤器 */
45
+ export interface SearchFilter {
46
+ readonly domainTags?: readonly string[];
47
+ readonly kinds?: readonly string[];
48
+ readonly status?: readonly string[];
49
+ readonly freshness?: readonly string[];
50
+ readonly emotionalValence?: readonly string[];
51
+ readonly createdBy?: readonly string[];
52
+ readonly createdAfter?: string;
53
+ readonly createdBefore?: string;
54
+ readonly minImportance?: number;
55
+ }
56
+ /** 检索请求 */
57
+ export interface SearchRequest {
58
+ readonly query: string;
59
+ readonly filter?: SearchFilter;
60
+ readonly contextBudget?: ContextBudget;
61
+ readonly limit?: number;
62
+ }
63
+ /** 检索结果(带 score 和 tier) */
64
+ export interface SearchResult {
65
+ readonly id: EngramId;
66
+ readonly score: number;
67
+ readonly view: EngramView;
68
+ readonly matchedBy: readonly ("fts" | "vector" | "recency" | "importance")[];
69
+ }
70
+ //# sourceMappingURL=disclosure.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"disclosure.d.ts","sourceRoot":"","sources":["../../src/types/disclosure.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * 渐进式披露类型定义
3
+ *
4
+ * Tier 0/1/2/3/4 数据单元(按粒度递增,不固定分层)
5
+ *
6
+ * @module @co-engram/core/types
7
+ */
8
+ export {};
9
+ //# sourceMappingURL=disclosure.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"disclosure.js","sourceRoot":"","sources":["../../src/types/disclosure.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}