@cachly-dev/mcp-server 0.10.129 → 0.10.130

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 (223) hide show
  1. package/README.md +2 -2
  2. package/dist/index.js +1 -7
  3. package/dist/packages/telegram-notify/client.js +2 -75
  4. package/dist/src/ambient-cli.js +7 -253
  5. package/dist/src/ambient-deps.js +1 -55
  6. package/dist/src/ambient-hooks.js +5 -278
  7. package/dist/src/ambient-ledger.js +6 -95
  8. package/dist/src/ambient-memory.js +1 -67
  9. package/dist/src/ambient-recall.js +1 -221
  10. package/dist/src/aussetzer.js +1 -225
  11. package/dist/src/auth.js +9 -140
  12. package/dist/src/autor-abzeichen.js +1 -56
  13. package/dist/src/autor.js +1 -136
  14. package/dist/src/bauabdruck.js +1 -93
  15. package/dist/src/bedeutung.js +2 -323
  16. package/dist/src/bench/cachly-bench.js +4 -249
  17. package/dist/src/bench/external-corpus.js +4 -135
  18. package/dist/src/bench/fixtures.js +1 -225
  19. package/dist/src/brain-export.js +16 -119
  20. package/dist/src/brain-watch-hook.js +8 -86
  21. package/dist/src/cachly-url.js +1 -21
  22. package/dist/src/ckg.js +1 -108
  23. package/dist/src/cls-hook.js +8 -94
  24. package/dist/src/confidence.js +1 -50
  25. package/dist/src/credentials.js +1 -85
  26. package/dist/src/deutsch.js +1 -223
  27. package/dist/src/doctor.js +2 -248
  28. package/dist/src/editor.js +1 -63
  29. package/dist/src/eingaenge-nachruesten.js +1 -290
  30. package/dist/src/eingaenge.js +2 -260
  31. package/dist/src/embeddings.js +13 -223
  32. package/dist/src/feldreparatur.js +3 -113
  33. package/dist/src/first-contact.js +4 -108
  34. package/dist/src/first-recall-proof.js +4 -41
  35. package/dist/src/funnel-milestones.js +2 -48
  36. package/dist/src/geliefert.js +1 -114
  37. package/dist/src/handlers/advanced.js +38 -537
  38. package/dist/src/handlers/brain.js +69 -4397
  39. package/dist/src/handlers/cache.js +59 -638
  40. package/dist/src/handlers/context.js +17 -182
  41. package/dist/src/handlers/fedbrain.js +40 -1436
  42. package/dist/src/handlers/instances.js +16 -201
  43. package/dist/src/handlers/roadmap.js +13 -175
  44. package/dist/src/handlers/share.js +19 -530
  45. package/dist/src/handlers/syndicate.js +38 -904
  46. package/dist/src/handlers/team.js +89 -1865
  47. package/dist/src/handlers/viz.js +3 -148
  48. package/dist/src/index.js +321 -4281
  49. package/dist/src/interferenz.js +1 -141
  50. package/dist/src/kostprobe.js +7 -125
  51. package/dist/src/lesson-preview.js +2 -133
  52. package/dist/src/namespace.js +1 -128
  53. package/dist/src/notifier.js +1 -6
  54. package/dist/src/rangfolge-stellschrauben.js +1 -0
  55. package/dist/src/rangfolge.js +1 -249
  56. package/dist/src/raumkorrektur.js +1 -197
  57. package/dist/src/recall-tiefe.js +1 -42
  58. package/dist/src/rerank.js +1 -154
  59. package/dist/src/resonanz.js +1 -140
  60. package/dist/src/search.js +1 -2104
  61. package/dist/src/seltenheitsbestand.js +1 -92
  62. package/dist/src/speicherlage.js +1 -84
  63. package/dist/src/spuren.js +1 -150
  64. package/dist/src/starter-corpus.js +1 -165
  65. package/dist/src/telemetry-types.js +0 -13
  66. package/dist/src/tools.js +10 -2465
  67. package/dist/src/toolspecs.js +1 -121
  68. package/dist/src/upgrade-nudge.js +1 -29
  69. package/dist/src/utils.js +1 -89
  70. package/dist/src/versuch.js +1 -264
  71. package/dist/src/vorspann.js +1 -146
  72. package/dist/src/wartung/vektoren-verdichten.js +1 -200
  73. package/dist/src/werkzeug-nutzung.js +1 -72
  74. package/dist/src/wertbeitrag.js +1 -203
  75. package/dist/src/wirkungsspur.js +1 -0
  76. package/glama.json +1 -1
  77. package/package.json +8 -7
  78. package/server.json +3 -3
  79. package/dist/index.d.ts +0 -1
  80. package/dist/index.js.map +0 -1
  81. package/dist/packages/telegram-notify/client.d.ts +0 -19
  82. package/dist/packages/telegram-notify/client.js.map +0 -1
  83. package/dist/src/ambient-cli.d.ts +0 -101
  84. package/dist/src/ambient-cli.js.map +0 -1
  85. package/dist/src/ambient-deps.d.ts +0 -26
  86. package/dist/src/ambient-deps.js.map +0 -1
  87. package/dist/src/ambient-hooks.d.ts +0 -137
  88. package/dist/src/ambient-hooks.js.map +0 -1
  89. package/dist/src/ambient-ledger.d.ts +0 -19
  90. package/dist/src/ambient-ledger.js.map +0 -1
  91. package/dist/src/ambient-memory.d.ts +0 -12
  92. package/dist/src/ambient-memory.js.map +0 -1
  93. package/dist/src/ambient-recall.d.ts +0 -127
  94. package/dist/src/ambient-recall.js.map +0 -1
  95. package/dist/src/aussetzer.d.ts +0 -156
  96. package/dist/src/aussetzer.js.map +0 -1
  97. package/dist/src/auth.d.ts +0 -43
  98. package/dist/src/auth.js.map +0 -1
  99. package/dist/src/autor-abzeichen.d.ts +0 -41
  100. package/dist/src/autor-abzeichen.js.map +0 -1
  101. package/dist/src/autor.d.ts +0 -101
  102. package/dist/src/autor.js.map +0 -1
  103. package/dist/src/bauabdruck-daten.generiert.json +0 -5
  104. package/dist/src/bauabdruck.d.ts +0 -38
  105. package/dist/src/bauabdruck.js.map +0 -1
  106. package/dist/src/bedeutung.d.ts +0 -168
  107. package/dist/src/bedeutung.js.map +0 -1
  108. package/dist/src/bench/cachly-bench.d.ts +0 -61
  109. package/dist/src/bench/cachly-bench.js.map +0 -1
  110. package/dist/src/bench/external-corpus.d.ts +0 -44
  111. package/dist/src/bench/external-corpus.js.map +0 -1
  112. package/dist/src/bench/fixtures.d.ts +0 -37
  113. package/dist/src/bench/fixtures.js.map +0 -1
  114. package/dist/src/brain-export.d.ts +0 -64
  115. package/dist/src/brain-export.js.map +0 -1
  116. package/dist/src/brain-watch-hook.d.ts +0 -21
  117. package/dist/src/brain-watch-hook.js.map +0 -1
  118. package/dist/src/cachly-url.d.ts +0 -68
  119. package/dist/src/cachly-url.js.map +0 -1
  120. package/dist/src/ckg.d.ts +0 -54
  121. package/dist/src/ckg.js.map +0 -1
  122. package/dist/src/cls-hook.d.ts +0 -15
  123. package/dist/src/cls-hook.js.map +0 -1
  124. package/dist/src/confidence.d.ts +0 -19
  125. package/dist/src/confidence.js.map +0 -1
  126. package/dist/src/credentials.d.ts +0 -37
  127. package/dist/src/credentials.js.map +0 -1
  128. package/dist/src/deutsch.d.ts +0 -98
  129. package/dist/src/deutsch.js.map +0 -1
  130. package/dist/src/doctor.d.ts +0 -47
  131. package/dist/src/doctor.js.map +0 -1
  132. package/dist/src/editor.d.ts +0 -9
  133. package/dist/src/editor.js.map +0 -1
  134. package/dist/src/eingaenge-nachruesten.d.ts +0 -41
  135. package/dist/src/eingaenge-nachruesten.js.map +0 -1
  136. package/dist/src/eingaenge.d.ts +0 -159
  137. package/dist/src/eingaenge.js.map +0 -1
  138. package/dist/src/embeddings.d.ts +0 -48
  139. package/dist/src/embeddings.js.map +0 -1
  140. package/dist/src/feldreparatur.d.ts +0 -58
  141. package/dist/src/feldreparatur.js.map +0 -1
  142. package/dist/src/first-contact.d.ts +0 -56
  143. package/dist/src/first-contact.js.map +0 -1
  144. package/dist/src/first-recall-proof.d.ts +0 -19
  145. package/dist/src/first-recall-proof.js.map +0 -1
  146. package/dist/src/funnel-milestones.d.ts +0 -5
  147. package/dist/src/funnel-milestones.js.map +0 -1
  148. package/dist/src/geliefert.d.ts +0 -63
  149. package/dist/src/geliefert.js.map +0 -1
  150. package/dist/src/handlers/advanced.d.ts +0 -6
  151. package/dist/src/handlers/advanced.js.map +0 -1
  152. package/dist/src/handlers/brain.d.ts +0 -41
  153. package/dist/src/handlers/brain.js.map +0 -1
  154. package/dist/src/handlers/cache.d.ts +0 -6
  155. package/dist/src/handlers/cache.js.map +0 -1
  156. package/dist/src/handlers/context.d.ts +0 -6
  157. package/dist/src/handlers/context.js.map +0 -1
  158. package/dist/src/handlers/fedbrain.d.ts +0 -18
  159. package/dist/src/handlers/fedbrain.js.map +0 -1
  160. package/dist/src/handlers/instances.d.ts +0 -33
  161. package/dist/src/handlers/instances.js.map +0 -1
  162. package/dist/src/handlers/roadmap.d.ts +0 -6
  163. package/dist/src/handlers/roadmap.js.map +0 -1
  164. package/dist/src/handlers/share.d.ts +0 -8
  165. package/dist/src/handlers/share.js.map +0 -1
  166. package/dist/src/handlers/syndicate.d.ts +0 -6
  167. package/dist/src/handlers/syndicate.js.map +0 -1
  168. package/dist/src/handlers/team.d.ts +0 -45
  169. package/dist/src/handlers/team.js.map +0 -1
  170. package/dist/src/handlers/viz.d.ts +0 -6
  171. package/dist/src/handlers/viz.js.map +0 -1
  172. package/dist/src/index.d.ts +0 -93
  173. package/dist/src/index.js.map +0 -1
  174. package/dist/src/interferenz.d.ts +0 -111
  175. package/dist/src/interferenz.js.map +0 -1
  176. package/dist/src/kostprobe.d.ts +0 -25
  177. package/dist/src/kostprobe.js.map +0 -1
  178. package/dist/src/lesson-preview.d.ts +0 -81
  179. package/dist/src/lesson-preview.js.map +0 -1
  180. package/dist/src/namespace.d.ts +0 -20
  181. package/dist/src/namespace.js.map +0 -1
  182. package/dist/src/notifier.d.ts +0 -5
  183. package/dist/src/notifier.js.map +0 -1
  184. package/dist/src/rangfolge.d.ts +0 -205
  185. package/dist/src/rangfolge.js.map +0 -1
  186. package/dist/src/raumkorrektur.d.ts +0 -100
  187. package/dist/src/raumkorrektur.js.map +0 -1
  188. package/dist/src/recall-tiefe.d.ts +0 -48
  189. package/dist/src/recall-tiefe.js.map +0 -1
  190. package/dist/src/rerank.d.ts +0 -48
  191. package/dist/src/rerank.js.map +0 -1
  192. package/dist/src/resonanz.d.ts +0 -85
  193. package/dist/src/resonanz.js.map +0 -1
  194. package/dist/src/search.d.ts +0 -153
  195. package/dist/src/search.js.map +0 -1
  196. package/dist/src/seltenheitsbestand.d.ts +0 -53
  197. package/dist/src/seltenheitsbestand.js.map +0 -1
  198. package/dist/src/speicherlage.d.ts +0 -51
  199. package/dist/src/speicherlage.js.map +0 -1
  200. package/dist/src/spuren.d.ts +0 -97
  201. package/dist/src/spuren.js.map +0 -1
  202. package/dist/src/starter-corpus.d.ts +0 -28
  203. package/dist/src/starter-corpus.js.map +0 -1
  204. package/dist/src/telemetry-types.d.ts +0 -87
  205. package/dist/src/telemetry-types.js.map +0 -1
  206. package/dist/src/tools.d.ts +0 -2933
  207. package/dist/src/tools.js.map +0 -1
  208. package/dist/src/toolspecs.d.ts +0 -43
  209. package/dist/src/toolspecs.js.map +0 -1
  210. package/dist/src/upgrade-nudge.d.ts +0 -15
  211. package/dist/src/upgrade-nudge.js.map +0 -1
  212. package/dist/src/utils.d.ts +0 -34
  213. package/dist/src/utils.js.map +0 -1
  214. package/dist/src/versuch.d.ts +0 -187
  215. package/dist/src/versuch.js.map +0 -1
  216. package/dist/src/vorspann.d.ts +0 -73
  217. package/dist/src/vorspann.js.map +0 -1
  218. package/dist/src/wartung/vektoren-verdichten.d.ts +0 -50
  219. package/dist/src/wartung/vektoren-verdichten.js.map +0 -1
  220. package/dist/src/werkzeug-nutzung.d.ts +0 -62
  221. package/dist/src/werkzeug-nutzung.js.map +0 -1
  222. package/dist/src/wertbeitrag.d.ts +0 -148
  223. package/dist/src/wertbeitrag.js.map +0 -1
@@ -1 +0,0 @@
1
- {"version":3,"file":"starter-corpus.js","sourceRoot":"","sources":["../../src/starter-corpus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAYH,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C;QACE,KAAK,EAAE,oBAAoB;QAC3B,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,2LAA2L;QACxM,WAAW,EAAE,8HAA8H;QAC3I,GAAG,EAAE,kGAAkG;QACvG,IAAI,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC;QACvD,UAAU,EAAE,GAAG;KAChB;IACD;QACE,KAAK,EAAE,uBAAuB;QAC9B,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,4JAA4J;QACzK,WAAW,EAAE,kHAAkH;QAC/H,GAAG,EAAE,gEAAgE;QACrE,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,CAAC;QAClD,UAAU,EAAE,IAAI;KACjB;IACD;QACE,KAAK,EAAE,uBAAuB;QAC9B,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,wKAAwK;QACrL,WAAW,EAAE,gHAAgH;QAC7H,GAAG,EAAE,yEAAyE;QAC9E,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAC;QACzD,UAAU,EAAE,IAAI;KACjB;IACD;QACE,KAAK,EAAE,sBAAsB;QAC7B,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,uKAAuK;QACpL,WAAW,EAAE,0HAA0H;QACvI,GAAG,EAAE,0EAA0E;QAC/E,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,CAAC;QAC1D,UAAU,EAAE,IAAI;KACjB;IACD;QACE,KAAK,EAAE,gBAAgB;QACvB,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,gKAAgK;QAC7K,WAAW,EAAE,gHAAgH;QAC7H,GAAG,EAAE,uEAAuE;QAC5E,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC;QACpD,UAAU,EAAE,IAAI;KACjB;IACD;QACE,KAAK,EAAE,yBAAyB;QAChC,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,mLAAmL;QAChM,WAAW,EAAE,oIAAoI;QACjJ,GAAG,EAAE,uEAAuE;QAC5E,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC;QAChE,UAAU,EAAE,IAAI;KACjB;IACD;QACE,KAAK,EAAE,uBAAuB;QAC9B,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,mJAAmJ;QAChK,WAAW,EAAE,2HAA2H;QACxI,GAAG,EAAE,sEAAsE;QAC3E,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC;QACrD,UAAU,EAAE,IAAI;KACjB;IACD;QACE,KAAK,EAAE,gBAAgB;QACvB,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,+KAA+K;QAC5L,WAAW,EAAE,wHAAwH;QACrI,GAAG,EAAE,sEAAsE;QAC3E,IAAI,EAAE,CAAC,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC;QACxD,UAAU,EAAE,IAAI;KACjB;IACD;QACE,KAAK,EAAE,gBAAgB;QACvB,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,4MAA4M;QACzN,WAAW,EAAE,sIAAsI;QACnJ,GAAG,EAAE,wFAAwF;QAC7F,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC;QACrD,UAAU,EAAE,IAAI;KACjB;IACD;QACE,KAAK,EAAE,uBAAuB;QAC9B,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,mNAAmN;QAChO,WAAW,EAAE,qIAAqI;QAClJ,GAAG,EAAE,kEAAkE;QACvE,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;QAC3C,UAAU,EAAE,IAAI;KACjB;IACD;QACE,KAAK,EAAE,2BAA2B;QAClC,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,+JAA+J;QAC5K,WAAW,EAAE,qHAAqH;QAClI,GAAG,EAAE,kFAAkF;QACvF,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,CAAC;QACrD,UAAU,EAAE,IAAI;KACjB;IACD;QACE,KAAK,EAAE,gBAAgB;QACvB,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,8KAA8K;QAC3L,WAAW,EAAE,yGAAyG;QACtH,GAAG,EAAE,0FAA0F;QAC/F,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,CAAC;QACtD,UAAU,EAAE,IAAI;KACjB;IACD;QACE,KAAK,EAAE,wBAAwB;QAC/B,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,yJAAyJ;QACtK,WAAW,EAAE,kHAAkH;QAC/H,GAAG,EAAE,sFAAsF;QAC3F,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,CAAC;QAChE,UAAU,EAAE,IAAI;KACjB;IACD;QACE,KAAK,EAAE,gBAAgB;QACvB,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,iMAAiM;QAC9M,WAAW,EAAE,oHAAoH;QACjI,GAAG,EAAE,qEAAqE;QAC1E,IAAI,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,OAAO,CAAC;QAClE,UAAU,EAAE,IAAI;KACjB;IACD;QACE,KAAK,EAAE,6BAA6B;QACpC,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,kKAAkK;QAC/K,WAAW,EAAE,uIAAuI;QACpJ,GAAG,EAAE,wDAAwD;QAC7D,IAAI,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,CAAC;QAC7D,UAAU,EAAE,GAAG;KAChB;IACD;QACE,KAAK,EAAE,iBAAiB;QACxB,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,+LAA+L;QAC5M,WAAW,EAAE,2GAA2G;QACxH,GAAG,EAAE,oFAAoF;QACzF,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,OAAO,CAAC;QAC3D,UAAU,EAAE,IAAI;KACjB;CACF,CAAC;AAEF,yCAAyC;AACzC,MAAM,CAAC,MAAM,mBAAmB,GAAG,cAAc,CAAC,MAAM,CAAC"}
@@ -1,87 +0,0 @@
1
- /**
2
- * Canonical types for the cachly telemetry event stream.
3
- *
4
- * These types form the contract between:
5
- * - cachly-mcp (emitter) → POST /api/v1/telemetry/mcp
6
- * - cachly API (receiver) → resolves api_key → {org_id, user_id}, queues enriched event
7
- * - cachly-insights ingest (consumer) ← reads enriched events from the resolved queue
8
- *
9
- * The ingest worker MUST NOT see raw JWTs or api_keys. Resolution happens
10
- * exclusively inside the cachly API trust boundary before events reach the queue.
11
- */
12
- export type FunnelEventName = 'device_flow_started' | 'device_flow_completed' | 'device_flow_failed' | 'auth_self_healed' | 'm2m_auth_completed' | 'm2m_auth_failed' | 'setup_started' | 'setup_auth_started' | 'setup_auth_completed' | 'setup_instance_ready' | 'setup_completed' | 'first_call_success' | 'session_start' | 'session_end' | 'recall_best_solution' | 'learn_from_attempts' | 'smart_recall' | 'brain_from_git' | 'brain_predict' | 'brain_predict_failures' | 'brain_seed_starter' | 'premium_gate_hit' | 'premium_taste_used' | (string & Record<never, never>);
13
- export interface SessionStartMetrics {
14
- recalls_total?: number;
15
- born_at?: string;
16
- time_saved_mins?: number;
17
- starter_seeded?: boolean;
18
- }
19
- export interface SmartRecallMetrics {
20
- hit: boolean;
21
- topic?: string;
22
- latency_ms?: number;
23
- cross_author?: boolean;
24
- }
25
- export interface BrainFromGitMetrics {
26
- fixes: number;
27
- features: number;
28
- refactors: number;
29
- total: number;
30
- }
31
- export interface BrainSeedStarterMetrics {
32
- seeded_count: number;
33
- auto: boolean;
34
- }
35
- export type DashboardMetrics = SessionStartMetrics | SmartRecallMetrics | BrainFromGitMetrics | BrainSeedStarterMetrics | Record<string, unknown>;
36
- /**
37
- * Raw event payload sent to /api/v1/telemetry/mcp.
38
- * Fields are stripped / resolved by the cachly API before the event reaches
39
- * the dashboard ingest queue — consumers will never see api_key or jwt.
40
- */
41
- export interface TelemetryEventRaw {
42
- event: FunnelEventName;
43
- ts: string;
44
- instance_id?: string;
45
- /** Long-lived API key or Keycloak access token. Server resolves → {org_id, user_id}. */
46
- api_key?: string;
47
- /** Anonymous JWT sub fingerprint — SHA-256 first 16 hex chars, no PII. */
48
- user_fingerprint?: string;
49
- /** Structured metrics block — typed per event, queryable without JSON path surgery. */
50
- metrics?: DashboardMetrics;
51
- [extra: string]: unknown;
52
- }
53
- /**
54
- * Identity-resolved event. This is what the cachly-insights ingest worker
55
- * consumes from the resolved queue (Redis Stream / Postgres notify channel).
56
- * The `api_key` field is absent — it never crosses the API trust boundary.
57
- */
58
- export interface TelemetryEventResolved {
59
- event: FunnelEventName;
60
- ts: string;
61
- instance_id: string;
62
- org_id: string;
63
- user_id: string;
64
- metrics?: DashboardMetrics;
65
- [extra: string]: unknown;
66
- }
67
- /**
68
- * cachly API must expose this endpoint for the ingest worker:
69
- *
70
- * GET /internal/telemetry/stream?since=<cursor>&limit=<n>
71
- * Authorization: Bearer <SERVICE_ACCOUNT_TOKEN>
72
- *
73
- * Returns:
74
- * { events: TelemetryEventResolved[]; next_cursor: string }
75
- *
76
- * Implementation notes for the cachly API team:
77
- * 1. Accept raw events at POST /api/v1/telemetry/mcp (existing, unchanged)
78
- * 2. Resolve api_key → {org_id, user_id} via Keycloak introspect or local DB lookup
79
- * 3. Strip api_key, write TelemetryEventResolved to a Redis Stream
80
- * (key: cachly:telemetry:resolved, MAXLEN ~1M)
81
- * 4. Expose GET /internal/telemetry/stream as an XREAD wrapper with cursor pagination
82
- * 5. NEVER write api_key or jwt into the resolved stream
83
- */
84
- export type InternalTelemetryStreamResponse = {
85
- events: TelemetryEventResolved[];
86
- next_cursor: string;
87
- };
@@ -1 +0,0 @@
1
- {"version":3,"file":"telemetry-types.js","sourceRoot":"","sources":["../../src/telemetry-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}