@copilotkit/shared 2.0.0-rc.4 → 2.0.0-rc.40

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 (562) hide show
  1. package/README.md +4 -15
  2. package/dist/a2ui-envelope.cjs +2 -2
  3. package/dist/a2ui-envelope.cjs.map +1 -1
  4. package/dist/a2ui-envelope.d.cts +1 -1
  5. package/dist/a2ui-envelope.d.cts.map +1 -1
  6. package/dist/a2ui-envelope.d.mts +1 -1
  7. package/dist/a2ui-envelope.d.mts.map +1 -1
  8. package/dist/a2ui-envelope.mjs +2 -2
  9. package/dist/a2ui-envelope.mjs.map +1 -1
  10. package/dist/a2ui-prompts.cjs +21 -62
  11. package/dist/a2ui-prompts.cjs.map +1 -1
  12. package/dist/a2ui-prompts.d.cts +8 -1
  13. package/dist/a2ui-prompts.d.cts.map +1 -1
  14. package/dist/a2ui-prompts.d.mts +8 -1
  15. package/dist/a2ui-prompts.d.mts.map +1 -1
  16. package/dist/a2ui-prompts.mjs +22 -62
  17. package/dist/a2ui-prompts.mjs.map +1 -1
  18. package/dist/attachments/types.d.cts +1 -3
  19. package/dist/attachments/types.d.cts.map +1 -1
  20. package/dist/attachments/types.d.mts +1 -3
  21. package/dist/attachments/types.d.mts.map +1 -1
  22. package/dist/attachments/utils.cjs +16 -5
  23. package/dist/attachments/utils.cjs.map +1 -1
  24. package/dist/attachments/utils.d.cts +3 -1
  25. package/dist/attachments/utils.d.cts.map +1 -1
  26. package/dist/attachments/utils.d.mts +3 -1
  27. package/dist/attachments/utils.d.mts.map +1 -1
  28. package/dist/attachments/utils.mjs +16 -5
  29. package/dist/attachments/utils.mjs.map +1 -1
  30. package/dist/finalize-events.cjs +16 -0
  31. package/dist/finalize-events.cjs.map +1 -1
  32. package/dist/finalize-events.d.cts.map +1 -1
  33. package/dist/finalize-events.d.mts.map +1 -1
  34. package/dist/finalize-events.mjs +16 -0
  35. package/dist/finalize-events.mjs.map +1 -1
  36. package/dist/generative-ui/basic-functions.cjs +1 -1
  37. package/dist/generative-ui/basic-functions.cjs.map +1 -1
  38. package/dist/generative-ui/basic-functions.mjs +1 -1
  39. package/dist/generative-ui/basic-functions.mjs.map +1 -1
  40. package/dist/generative-ui/catalog/catalog-export.cjs +329 -0
  41. package/dist/generative-ui/catalog/catalog-export.cjs.map +1 -0
  42. package/dist/generative-ui/catalog/catalog-export.d.cts +92 -0
  43. package/dist/generative-ui/catalog/catalog-export.d.cts.map +1 -0
  44. package/dist/generative-ui/catalog/catalog-export.d.mts +92 -0
  45. package/dist/generative-ui/catalog/catalog-export.d.mts.map +1 -0
  46. package/dist/generative-ui/catalog/catalog-export.mjs +328 -0
  47. package/dist/generative-ui/catalog/catalog-export.mjs.map +1 -0
  48. package/dist/generative-ui/catalog/catalog.cjs +315 -0
  49. package/dist/generative-ui/catalog/catalog.cjs.map +1 -0
  50. package/dist/generative-ui/catalog/catalog.d.cts +407 -0
  51. package/dist/generative-ui/catalog/catalog.d.cts.map +1 -0
  52. package/dist/generative-ui/catalog/catalog.d.mts +407 -0
  53. package/dist/generative-ui/catalog/catalog.d.mts.map +1 -0
  54. package/dist/generative-ui/catalog/catalog.mjs +312 -0
  55. package/dist/generative-ui/catalog/catalog.mjs.map +1 -0
  56. package/dist/generative-ui/catalog/errors.cjs +13 -0
  57. package/dist/generative-ui/catalog/errors.cjs.map +1 -0
  58. package/dist/generative-ui/catalog/errors.d.cts +46 -0
  59. package/dist/generative-ui/catalog/errors.d.cts.map +1 -0
  60. package/dist/generative-ui/catalog/errors.d.mts +46 -0
  61. package/dist/generative-ui/catalog/errors.d.mts.map +1 -0
  62. package/dist/generative-ui/catalog/errors.mjs +12 -0
  63. package/dist/generative-ui/catalog/errors.mjs.map +1 -0
  64. package/dist/generative-ui/catalog/index.d.mts +6 -0
  65. package/dist/generative-ui/catalog/json-schema.cjs +16 -0
  66. package/dist/generative-ui/catalog/json-schema.cjs.map +1 -0
  67. package/dist/generative-ui/catalog/json-schema.d.cts +12 -0
  68. package/dist/generative-ui/catalog/json-schema.d.cts.map +1 -0
  69. package/dist/generative-ui/catalog/json-schema.d.mts +12 -0
  70. package/dist/generative-ui/catalog/json-schema.d.mts.map +1 -0
  71. package/dist/generative-ui/catalog/json-schema.mjs +16 -0
  72. package/dist/generative-ui/catalog/json-schema.mjs.map +1 -0
  73. package/dist/generative-ui/catalog/refs.cjs +21 -0
  74. package/dist/generative-ui/catalog/refs.cjs.map +1 -0
  75. package/dist/generative-ui/catalog/refs.d.cts +55 -0
  76. package/dist/generative-ui/catalog/refs.d.cts.map +1 -0
  77. package/dist/generative-ui/catalog/refs.d.mts +55 -0
  78. package/dist/generative-ui/catalog/refs.d.mts.map +1 -0
  79. package/dist/generative-ui/catalog/refs.mjs +18 -0
  80. package/dist/generative-ui/catalog/refs.mjs.map +1 -0
  81. package/dist/generative-ui/catalog/schema.cjs +74 -0
  82. package/dist/generative-ui/catalog/schema.cjs.map +1 -0
  83. package/dist/generative-ui/catalog/schema.d.cts +43 -0
  84. package/dist/generative-ui/catalog/schema.d.cts.map +1 -0
  85. package/dist/generative-ui/catalog/schema.d.mts +43 -0
  86. package/dist/generative-ui/catalog/schema.d.mts.map +1 -0
  87. package/dist/generative-ui/catalog/schema.mjs +68 -0
  88. package/dist/generative-ui/catalog/schema.mjs.map +1 -0
  89. package/dist/generative-ui/child-refs.cjs +3 -3
  90. package/dist/generative-ui/child-refs.cjs.map +1 -1
  91. package/dist/generative-ui/child-refs.d.cts.map +1 -1
  92. package/dist/generative-ui/child-refs.d.mts.map +1 -1
  93. package/dist/generative-ui/child-refs.mjs +3 -3
  94. package/dist/generative-ui/child-refs.mjs.map +1 -1
  95. package/dist/generative-ui/clone-value.cjs +364 -0
  96. package/dist/generative-ui/clone-value.cjs.map +1 -0
  97. package/dist/generative-ui/clone-value.d.cts +51 -0
  98. package/dist/generative-ui/clone-value.d.cts.map +1 -0
  99. package/dist/generative-ui/clone-value.d.mts +51 -0
  100. package/dist/generative-ui/clone-value.d.mts.map +1 -0
  101. package/dist/generative-ui/clone-value.mjs +363 -0
  102. package/dist/generative-ui/clone-value.mjs.map +1 -0
  103. package/dist/generative-ui/compact-schema.cjs +187 -0
  104. package/dist/generative-ui/compact-schema.cjs.map +1 -0
  105. package/dist/generative-ui/compact-schema.d.cts +55 -0
  106. package/dist/generative-ui/compact-schema.d.cts.map +1 -0
  107. package/dist/generative-ui/compact-schema.d.mts +55 -0
  108. package/dist/generative-ui/compact-schema.d.mts.map +1 -0
  109. package/dist/generative-ui/compact-schema.mjs +185 -0
  110. package/dist/generative-ui/compact-schema.mjs.map +1 -0
  111. package/dist/generative-ui/index.cjs +286 -0
  112. package/dist/generative-ui/index.d.cts +39 -0
  113. package/dist/generative-ui/index.d.mts +41 -0
  114. package/dist/generative-ui/index.mjs +40 -0
  115. package/dist/generative-ui/is-record.cjs +6 -1
  116. package/dist/generative-ui/is-record.cjs.map +1 -1
  117. package/dist/generative-ui/is-record.d.cts +8 -0
  118. package/dist/generative-ui/is-record.d.cts.map +1 -0
  119. package/dist/generative-ui/is-record.d.mts +8 -0
  120. package/dist/generative-ui/is-record.d.mts.map +1 -0
  121. package/dist/generative-ui/is-record.mjs +6 -2
  122. package/dist/generative-ui/is-record.mjs.map +1 -1
  123. package/dist/generative-ui/prompt-spec.cjs +225 -0
  124. package/dist/generative-ui/prompt-spec.cjs.map +1 -0
  125. package/dist/generative-ui/prompt-spec.d.cts +94 -0
  126. package/dist/generative-ui/prompt-spec.d.cts.map +1 -0
  127. package/dist/generative-ui/prompt-spec.d.mts +94 -0
  128. package/dist/generative-ui/prompt-spec.d.mts.map +1 -0
  129. package/dist/generative-ui/prompt-spec.mjs +220 -0
  130. package/dist/generative-ui/prompt-spec.mjs.map +1 -0
  131. package/dist/generative-ui/prompt.cjs +10 -36
  132. package/dist/generative-ui/prompt.cjs.map +1 -1
  133. package/dist/generative-ui/prompt.d.cts +2 -1
  134. package/dist/generative-ui/prompt.d.cts.map +1 -1
  135. package/dist/generative-ui/prompt.d.mts +2 -1
  136. package/dist/generative-ui/prompt.d.mts.map +1 -1
  137. package/dist/generative-ui/prompt.mjs +12 -38
  138. package/dist/generative-ui/prompt.mjs.map +1 -1
  139. package/dist/generative-ui/render-ui-args.cjs +1 -0
  140. package/dist/generative-ui/render-ui-args.cjs.map +1 -1
  141. package/dist/generative-ui/render-ui-args.d.cts.map +1 -1
  142. package/dist/generative-ui/render-ui-args.d.mts.map +1 -1
  143. package/dist/generative-ui/render-ui-args.mjs +1 -0
  144. package/dist/generative-ui/render-ui-args.mjs.map +1 -1
  145. package/dist/generative-ui/schema-render.cjs +243 -0
  146. package/dist/generative-ui/schema-render.cjs.map +1 -0
  147. package/dist/generative-ui/schema-render.d.cts +44 -0
  148. package/dist/generative-ui/schema-render.d.cts.map +1 -0
  149. package/dist/generative-ui/schema-render.d.mts +44 -0
  150. package/dist/generative-ui/schema-render.d.mts.map +1 -0
  151. package/dist/generative-ui/schema-render.mjs +240 -0
  152. package/dist/generative-ui/schema-render.mjs.map +1 -0
  153. package/dist/generative-ui/standard/chart-config.cjs +347 -0
  154. package/dist/generative-ui/standard/chart-config.cjs.map +1 -0
  155. package/dist/generative-ui/standard/chart-config.d.cts +97 -0
  156. package/dist/generative-ui/standard/chart-config.d.cts.map +1 -0
  157. package/dist/generative-ui/standard/chart-config.d.mts +97 -0
  158. package/dist/generative-ui/standard/chart-config.d.mts.map +1 -0
  159. package/dist/generative-ui/standard/chart-config.mjs +342 -0
  160. package/dist/generative-ui/standard/chart-config.mjs.map +1 -0
  161. package/dist/generative-ui/standard/chart.cjs +56 -0
  162. package/dist/generative-ui/standard/chart.cjs.map +1 -0
  163. package/dist/generative-ui/standard/chart.d.cts +62 -0
  164. package/dist/generative-ui/standard/chart.d.cts.map +1 -0
  165. package/dist/generative-ui/standard/chart.d.mts +62 -0
  166. package/dist/generative-ui/standard/chart.d.mts.map +1 -0
  167. package/dist/generative-ui/standard/chart.mjs +54 -0
  168. package/dist/generative-ui/standard/chart.mjs.map +1 -0
  169. package/dist/generative-ui/standard/checks.cjs +74 -0
  170. package/dist/generative-ui/standard/checks.cjs.map +1 -0
  171. package/dist/generative-ui/standard/checks.d.cts +56 -0
  172. package/dist/generative-ui/standard/checks.d.cts.map +1 -0
  173. package/dist/generative-ui/standard/checks.d.mts +56 -0
  174. package/dist/generative-ui/standard/checks.d.mts.map +1 -0
  175. package/dist/generative-ui/standard/checks.mjs +71 -0
  176. package/dist/generative-ui/standard/checks.mjs.map +1 -0
  177. package/dist/generative-ui/standard/components.cjs +23 -0
  178. package/dist/generative-ui/standard/components.cjs.map +1 -0
  179. package/dist/generative-ui/standard/components.d.cts +24 -0
  180. package/dist/generative-ui/standard/components.d.cts.map +1 -0
  181. package/dist/generative-ui/standard/components.d.mts +24 -0
  182. package/dist/generative-ui/standard/components.d.mts.map +1 -0
  183. package/dist/generative-ui/standard/components.mjs +22 -0
  184. package/dist/generative-ui/standard/components.mjs.map +1 -0
  185. package/dist/generative-ui/standard/composites.cjs +143 -0
  186. package/dist/generative-ui/standard/composites.cjs.map +1 -0
  187. package/dist/generative-ui/standard/composites.d.cts +233 -0
  188. package/dist/generative-ui/standard/composites.d.cts.map +1 -0
  189. package/dist/generative-ui/standard/composites.d.mts +233 -0
  190. package/dist/generative-ui/standard/composites.d.mts.map +1 -0
  191. package/dist/generative-ui/standard/composites.mjs +132 -0
  192. package/dist/generative-ui/standard/composites.mjs.map +1 -0
  193. package/dist/generative-ui/standard/data.cjs +176 -0
  194. package/dist/generative-ui/standard/data.cjs.map +1 -0
  195. package/dist/generative-ui/standard/data.d.cts +365 -0
  196. package/dist/generative-ui/standard/data.d.cts.map +1 -0
  197. package/dist/generative-ui/standard/data.d.mts +365 -0
  198. package/dist/generative-ui/standard/data.d.mts.map +1 -0
  199. package/dist/generative-ui/standard/data.mjs +167 -0
  200. package/dist/generative-ui/standard/data.mjs.map +1 -0
  201. package/dist/generative-ui/standard/declarations.cjs +40 -0
  202. package/dist/generative-ui/standard/declarations.cjs.map +1 -0
  203. package/dist/generative-ui/standard/declarations.d.cts +2570 -0
  204. package/dist/generative-ui/standard/declarations.d.cts.map +1 -0
  205. package/dist/generative-ui/standard/declarations.d.mts +2571 -0
  206. package/dist/generative-ui/standard/declarations.d.mts.map +1 -0
  207. package/dist/generative-ui/standard/declarations.mjs +39 -0
  208. package/dist/generative-ui/standard/declarations.mjs.map +1 -0
  209. package/dist/generative-ui/standard/feedback.cjs +97 -0
  210. package/dist/generative-ui/standard/feedback.cjs.map +1 -0
  211. package/dist/generative-ui/standard/feedback.d.cts +133 -0
  212. package/dist/generative-ui/standard/feedback.d.cts.map +1 -0
  213. package/dist/generative-ui/standard/feedback.d.mts +133 -0
  214. package/dist/generative-ui/standard/feedback.d.mts.map +1 -0
  215. package/dist/generative-ui/standard/feedback.mjs +90 -0
  216. package/dist/generative-ui/standard/feedback.mjs.map +1 -0
  217. package/dist/generative-ui/standard/index.d.mts +20 -0
  218. package/dist/generative-ui/standard/inputs.cjs +333 -0
  219. package/dist/generative-ui/standard/inputs.cjs.map +1 -0
  220. package/dist/generative-ui/standard/inputs.d.cts +1128 -0
  221. package/dist/generative-ui/standard/inputs.d.cts.map +1 -0
  222. package/dist/generative-ui/standard/inputs.d.mts +1128 -0
  223. package/dist/generative-ui/standard/inputs.d.mts.map +1 -0
  224. package/dist/generative-ui/standard/inputs.mjs +318 -0
  225. package/dist/generative-ui/standard/inputs.mjs.map +1 -0
  226. package/dist/generative-ui/standard/layout.cjs +289 -0
  227. package/dist/generative-ui/standard/layout.cjs.map +1 -0
  228. package/dist/generative-ui/standard/layout.d.cts +1974 -0
  229. package/dist/generative-ui/standard/layout.d.cts.map +1 -0
  230. package/dist/generative-ui/standard/layout.d.mts +1975 -0
  231. package/dist/generative-ui/standard/layout.d.mts.map +1 -0
  232. package/dist/generative-ui/standard/layout.mjs +269 -0
  233. package/dist/generative-ui/standard/layout.mjs.map +1 -0
  234. package/dist/generative-ui/standard/map-helpers.cjs +104 -0
  235. package/dist/generative-ui/standard/map-helpers.cjs.map +1 -0
  236. package/dist/generative-ui/standard/map-helpers.d.cts +88 -0
  237. package/dist/generative-ui/standard/map-helpers.d.cts.map +1 -0
  238. package/dist/generative-ui/standard/map-helpers.d.mts +88 -0
  239. package/dist/generative-ui/standard/map-helpers.d.mts.map +1 -0
  240. package/dist/generative-ui/standard/map-helpers.mjs +95 -0
  241. package/dist/generative-ui/standard/map-helpers.mjs.map +1 -0
  242. package/dist/generative-ui/standard/map.cjs +27 -0
  243. package/dist/generative-ui/standard/map.cjs.map +1 -0
  244. package/dist/generative-ui/standard/map.d.cts +31 -0
  245. package/dist/generative-ui/standard/map.d.cts.map +1 -0
  246. package/dist/generative-ui/standard/map.d.mts +31 -0
  247. package/dist/generative-ui/standard/map.d.mts.map +1 -0
  248. package/dist/generative-ui/standard/map.mjs +25 -0
  249. package/dist/generative-ui/standard/map.mjs.map +1 -0
  250. package/dist/generative-ui/standard/media.cjs +215 -0
  251. package/dist/generative-ui/standard/media.cjs.map +1 -0
  252. package/dist/generative-ui/standard/media.d.cts +396 -0
  253. package/dist/generative-ui/standard/media.d.cts.map +1 -0
  254. package/dist/generative-ui/standard/media.d.mts +396 -0
  255. package/dist/generative-ui/standard/media.d.mts.map +1 -0
  256. package/dist/generative-ui/standard/media.mjs +205 -0
  257. package/dist/generative-ui/standard/media.mjs.map +1 -0
  258. package/dist/generative-ui/standard/parameter-order.cjs +231 -0
  259. package/dist/generative-ui/standard/parameter-order.cjs.map +1 -0
  260. package/dist/generative-ui/standard/parameter-order.d.cts +84 -0
  261. package/dist/generative-ui/standard/parameter-order.d.cts.map +1 -0
  262. package/dist/generative-ui/standard/parameter-order.d.mts +84 -0
  263. package/dist/generative-ui/standard/parameter-order.d.mts.map +1 -0
  264. package/dist/generative-ui/standard/parameter-order.mjs +230 -0
  265. package/dist/generative-ui/standard/parameter-order.mjs.map +1 -0
  266. package/dist/generative-ui/standard/style-helpers.cjs +151 -0
  267. package/dist/generative-ui/standard/style-helpers.cjs.map +1 -0
  268. package/dist/generative-ui/standard/style-helpers.d.cts +56 -0
  269. package/dist/generative-ui/standard/style-helpers.d.cts.map +1 -0
  270. package/dist/generative-ui/standard/style-helpers.d.mts +56 -0
  271. package/dist/generative-ui/standard/style-helpers.d.mts.map +1 -0
  272. package/dist/generative-ui/standard/style-helpers.mjs +142 -0
  273. package/dist/generative-ui/standard/style-helpers.mjs.map +1 -0
  274. package/dist/generative-ui/standard/styles.cjs +62 -0
  275. package/dist/generative-ui/standard/styles.cjs.map +1 -0
  276. package/dist/generative-ui/standard/styles.d.cts +17 -0
  277. package/dist/generative-ui/standard/styles.d.cts.map +1 -0
  278. package/dist/generative-ui/standard/styles.d.mts +17 -0
  279. package/dist/generative-ui/standard/styles.d.mts.map +1 -0
  280. package/dist/generative-ui/standard/styles.mjs +60 -0
  281. package/dist/generative-ui/standard/styles.mjs.map +1 -0
  282. package/dist/generative-ui/standard/text.cjs +226 -0
  283. package/dist/generative-ui/standard/text.cjs.map +1 -0
  284. package/dist/generative-ui/standard/text.d.cts +522 -0
  285. package/dist/generative-ui/standard/text.d.cts.map +1 -0
  286. package/dist/generative-ui/standard/text.d.mts +522 -0
  287. package/dist/generative-ui/standard/text.d.mts.map +1 -0
  288. package/dist/generative-ui/standard/text.mjs +209 -0
  289. package/dist/generative-ui/standard/text.mjs.map +1 -0
  290. package/dist/generative-ui/standard/theme.cjs +115 -0
  291. package/dist/generative-ui/standard/theme.cjs.map +1 -0
  292. package/dist/generative-ui/standard/theme.d.cts +60 -0
  293. package/dist/generative-ui/standard/theme.d.cts.map +1 -0
  294. package/dist/generative-ui/standard/theme.d.mts +60 -0
  295. package/dist/generative-ui/standard/theme.d.mts.map +1 -0
  296. package/dist/generative-ui/standard/theme.mjs +112 -0
  297. package/dist/generative-ui/standard/theme.mjs.map +1 -0
  298. package/dist/generative-ui/standard/tokens.cjs +336 -0
  299. package/dist/generative-ui/standard/tokens.cjs.map +1 -0
  300. package/dist/generative-ui/standard/tokens.d.cts +76 -0
  301. package/dist/generative-ui/standard/tokens.d.cts.map +1 -0
  302. package/dist/generative-ui/standard/tokens.d.mts +76 -0
  303. package/dist/generative-ui/standard/tokens.d.mts.map +1 -0
  304. package/dist/generative-ui/standard/tokens.mjs +305 -0
  305. package/dist/generative-ui/standard/tokens.mjs.map +1 -0
  306. package/dist/generative-ui/standard/url.cjs +54 -0
  307. package/dist/generative-ui/standard/url.cjs.map +1 -0
  308. package/dist/generative-ui/standard/url.d.cts +32 -0
  309. package/dist/generative-ui/standard/url.d.cts.map +1 -0
  310. package/dist/generative-ui/standard/url.d.mts +32 -0
  311. package/dist/generative-ui/standard/url.d.mts.map +1 -0
  312. package/dist/generative-ui/standard/url.mjs +50 -0
  313. package/dist/generative-ui/standard/url.mjs.map +1 -0
  314. package/dist/generative-ui/thrown.cjs +69 -0
  315. package/dist/generative-ui/thrown.cjs.map +1 -0
  316. package/dist/generative-ui/thrown.d.cts +21 -0
  317. package/dist/generative-ui/thrown.d.cts.map +1 -0
  318. package/dist/generative-ui/thrown.d.mts +21 -0
  319. package/dist/generative-ui/thrown.d.mts.map +1 -0
  320. package/dist/generative-ui/thrown.mjs +67 -0
  321. package/dist/generative-ui/thrown.mjs.map +1 -0
  322. package/dist/generative-ui/types.cjs +2 -2
  323. package/dist/generative-ui/types.cjs.map +1 -1
  324. package/dist/generative-ui/types.d.cts +7 -7
  325. package/dist/generative-ui/types.d.cts.map +1 -1
  326. package/dist/generative-ui/types.d.mts +7 -7
  327. package/dist/generative-ui/types.d.mts.map +1 -1
  328. package/dist/generative-ui/types.mjs +2 -2
  329. package/dist/generative-ui/types.mjs.map +1 -1
  330. package/dist/generative-ui/validate-operation.cjs +2 -2
  331. package/dist/generative-ui/validate-operation.cjs.map +1 -1
  332. package/dist/generative-ui/validate-operation.mjs +2 -2
  333. package/dist/generative-ui/validate-operation.mjs.map +1 -1
  334. package/dist/index.cjs +18 -15
  335. package/dist/index.cjs.map +1 -1
  336. package/dist/index.d.cts +17 -16
  337. package/dist/index.d.cts.map +1 -1
  338. package/dist/index.d.mts +17 -16
  339. package/dist/index.d.mts.map +1 -1
  340. package/dist/index.mjs +10 -8
  341. package/dist/index.mjs.map +1 -1
  342. package/dist/index.umd.js +1233 -456
  343. package/dist/index.umd.js.map +1 -1
  344. package/dist/package.cjs +1 -1
  345. package/dist/package.mjs +1 -1
  346. package/dist/standard-schema.cjs +20 -7
  347. package/dist/standard-schema.cjs.map +1 -1
  348. package/dist/standard-schema.d.cts +15 -16
  349. package/dist/standard-schema.d.cts.map +1 -1
  350. package/dist/standard-schema.d.mts +15 -16
  351. package/dist/standard-schema.d.mts.map +1 -1
  352. package/dist/standard-schema.mjs +20 -8
  353. package/dist/standard-schema.mjs.map +1 -1
  354. package/dist/telemetry/lambda-client.cjs +1 -1
  355. package/dist/telemetry/lambda-client.cjs.map +1 -1
  356. package/dist/telemetry/lambda-client.d.cts.map +1 -1
  357. package/dist/telemetry/lambda-client.d.mts.map +1 -1
  358. package/dist/telemetry/lambda-client.mjs +1 -1
  359. package/dist/telemetry/lambda-client.mjs.map +1 -1
  360. package/dist/telemetry/telemetry-disabled.cjs +0 -5
  361. package/dist/telemetry/telemetry-disabled.cjs.map +1 -1
  362. package/dist/telemetry/telemetry-disabled.d.cts +0 -5
  363. package/dist/telemetry/telemetry-disabled.d.cts.map +1 -1
  364. package/dist/telemetry/telemetry-disabled.d.mts +0 -5
  365. package/dist/telemetry/telemetry-disabled.d.mts.map +1 -1
  366. package/dist/telemetry/telemetry-disabled.mjs +0 -5
  367. package/dist/telemetry/telemetry-disabled.mjs.map +1 -1
  368. package/dist/types/message.d.cts +1 -18
  369. package/dist/types/message.d.cts.map +1 -1
  370. package/dist/types/message.d.mts +1 -18
  371. package/dist/types/message.d.mts.map +1 -1
  372. package/dist/utils/errors.cjs +5 -42
  373. package/dist/utils/errors.cjs.map +1 -1
  374. package/dist/utils/errors.d.cts +16 -34
  375. package/dist/utils/errors.d.cts.map +1 -1
  376. package/dist/utils/errors.d.mts +16 -34
  377. package/dist/utils/errors.d.mts.map +1 -1
  378. package/dist/utils/errors.mjs +6 -41
  379. package/dist/utils/errors.mjs.map +1 -1
  380. package/dist/utils/index.cjs +0 -2
  381. package/dist/utils/index.cjs.map +1 -1
  382. package/dist/utils/index.d.cts +4 -6
  383. package/dist/utils/index.d.cts.map +1 -1
  384. package/dist/utils/index.d.mts +4 -6
  385. package/dist/utils/index.d.mts.map +1 -1
  386. package/dist/utils/index.mjs +4 -6
  387. package/dist/utils/index.mjs.map +1 -1
  388. package/dist/utils/inspector-visibility.cjs +25 -3
  389. package/dist/utils/inspector-visibility.cjs.map +1 -1
  390. package/dist/utils/inspector-visibility.d.cts +26 -3
  391. package/dist/utils/inspector-visibility.d.cts.map +1 -1
  392. package/dist/utils/inspector-visibility.d.mts +26 -3
  393. package/dist/utils/inspector-visibility.d.mts.map +1 -1
  394. package/dist/utils/inspector-visibility.mjs +25 -4
  395. package/dist/utils/inspector-visibility.mjs.map +1 -1
  396. package/dist/utils/json-schema.cjs +4 -79
  397. package/dist/utils/json-schema.cjs.map +1 -1
  398. package/dist/utils/json-schema.d.cts +1 -4
  399. package/dist/utils/json-schema.d.cts.map +1 -1
  400. package/dist/utils/json-schema.d.mts +1 -4
  401. package/dist/utils/json-schema.d.mts.map +1 -1
  402. package/dist/utils/json-schema.mjs +5 -78
  403. package/dist/utils/json-schema.mjs.map +1 -1
  404. package/dist/utils/random-id.cjs +13 -26
  405. package/dist/utils/random-id.cjs.map +1 -1
  406. package/dist/utils/random-id.d.cts +6 -3
  407. package/dist/utils/random-id.d.cts.map +1 -1
  408. package/dist/utils/random-id.d.mts +6 -3
  409. package/dist/utils/random-id.d.mts.map +1 -1
  410. package/dist/utils/random-id.mjs +14 -25
  411. package/dist/utils/random-id.mjs.map +1 -1
  412. package/package.json +19 -32
  413. package/scripts/verify-cjs-exports.cjs +1 -1
  414. package/src/__tests__/a2ui-envelope.test.ts +18 -13
  415. package/src/__tests__/a2ui-prompts.test.ts +47 -14
  416. package/src/__tests__/fixtures/prompt-goldens.json +354 -0
  417. package/src/__tests__/prompt-spec.test.ts +191 -0
  418. package/src/__tests__/root-entry-browser-safety.test.ts +5 -7
  419. package/src/__tests__/schema-render.test.ts +323 -0
  420. package/src/__tests__/standard-schema.test.ts +61 -101
  421. package/src/a2ui-envelope.ts +7 -6
  422. package/src/a2ui-prompts.ts +47 -96
  423. package/src/attachments/__tests__/utils.test.ts +22 -0
  424. package/src/attachments/types.ts +1 -3
  425. package/src/attachments/utils.ts +23 -5
  426. package/src/finalize-events.ts +16 -0
  427. package/src/generative-ui/__tests__/clone-value-differential.test.ts +480 -0
  428. package/src/generative-ui/__tests__/clone-value.test.ts +226 -0
  429. package/src/generative-ui/__tests__/render-ui-args.test.ts +7 -7
  430. package/src/generative-ui/__tests__/validate-operation.test.ts +19 -13
  431. package/src/generative-ui/base.ts +9 -0
  432. package/src/generative-ui/basic-functions.ts +1 -1
  433. package/src/generative-ui/catalog/catalog-export.ts +478 -0
  434. package/src/generative-ui/catalog/catalog.ts +1167 -0
  435. package/src/generative-ui/catalog/errors.ts +102 -0
  436. package/src/generative-ui/catalog/index.ts +6 -0
  437. package/src/generative-ui/catalog/json-schema.ts +14 -0
  438. package/src/generative-ui/catalog/refs.ts +87 -0
  439. package/src/generative-ui/catalog/schema.ts +107 -0
  440. package/src/generative-ui/child-refs.ts +5 -4
  441. package/src/generative-ui/clone-value.ts +511 -0
  442. package/src/generative-ui/compact-schema.ts +277 -0
  443. package/src/generative-ui/index.ts +14 -0
  444. package/src/generative-ui/is-record.ts +6 -1
  445. package/src/generative-ui/prompt-spec.ts +335 -0
  446. package/src/generative-ui/prompt.ts +25 -75
  447. package/src/generative-ui/render-ui-args.ts +3 -0
  448. package/src/generative-ui/schema-render.ts +378 -0
  449. package/src/generative-ui/standard/__tests__/standard-helpers.test.ts +407 -0
  450. package/src/generative-ui/standard/__tests__/theme.test.ts +61 -0
  451. package/src/generative-ui/standard/__tests__/tokens.test.ts +139 -0
  452. package/src/generative-ui/standard/chart-config.ts +434 -0
  453. package/src/generative-ui/standard/chart.ts +79 -0
  454. package/src/generative-ui/standard/checks.ts +98 -0
  455. package/src/generative-ui/standard/components.ts +35 -0
  456. package/src/generative-ui/standard/composites.ts +158 -0
  457. package/src/generative-ui/standard/data.ts +213 -0
  458. package/src/generative-ui/standard/declarations.ts +57 -0
  459. package/src/generative-ui/standard/feedback.ts +105 -0
  460. package/src/generative-ui/standard/index.ts +55 -0
  461. package/src/generative-ui/standard/inputs.ts +423 -0
  462. package/src/generative-ui/standard/layout.ts +312 -0
  463. package/src/generative-ui/standard/map-helpers.ts +155 -0
  464. package/src/generative-ui/standard/map.ts +32 -0
  465. package/src/generative-ui/standard/media.ts +265 -0
  466. package/src/generative-ui/standard/parameter-order.ts +155 -0
  467. package/src/generative-ui/standard/style-helpers.ts +170 -0
  468. package/src/generative-ui/standard/styles.ts +79 -0
  469. package/src/generative-ui/standard/text.ts +210 -0
  470. package/src/generative-ui/standard/theme.ts +198 -0
  471. package/src/generative-ui/standard/tokens.ts +317 -0
  472. package/src/generative-ui/standard/url.ts +51 -0
  473. package/src/generative-ui/thrown.ts +90 -0
  474. package/src/generative-ui/types.ts +10 -7
  475. package/src/generative-ui/validate-operation.ts +2 -2
  476. package/src/index.ts +9 -17
  477. package/src/standard-schema.ts +24 -27
  478. package/src/telemetry/lambda-client.ts +8 -3
  479. package/src/telemetry/model-host.test.ts +2 -5
  480. package/src/telemetry/telemetry-disabled.ts +0 -5
  481. package/src/types/message.ts +1 -19
  482. package/src/utils/__tests__/errors.test.ts +44 -0
  483. package/src/utils/__tests__/json-schema.test.ts +3 -479
  484. package/src/utils/__tests__/random-id.test.ts +37 -0
  485. package/src/utils/errors.ts +28 -85
  486. package/src/utils/index.ts +0 -2
  487. package/src/utils/inspector-visibility.test.ts +26 -0
  488. package/src/utils/inspector-visibility.ts +35 -3
  489. package/src/utils/json-schema.ts +5 -152
  490. package/src/utils/random-id.ts +17 -37
  491. package/tsconfig.json +3 -1
  492. package/tsdown.config.ts +2 -19
  493. package/dist/event-transforms/index.cjs +0 -15
  494. package/dist/event-transforms/index.d.cts +0 -4
  495. package/dist/event-transforms/index.d.mts +0 -4
  496. package/dist/event-transforms/index.mjs +0 -5
  497. package/dist/event-transforms/open-generative-ui-middleware.cjs +0 -286
  498. package/dist/event-transforms/open-generative-ui-middleware.cjs.map +0 -1
  499. package/dist/event-transforms/open-generative-ui-middleware.d.cts +0 -60
  500. package/dist/event-transforms/open-generative-ui-middleware.d.cts.map +0 -1
  501. package/dist/event-transforms/open-generative-ui-middleware.d.mts +0 -60
  502. package/dist/event-transforms/open-generative-ui-middleware.d.mts.map +0 -1
  503. package/dist/event-transforms/open-generative-ui-middleware.mjs +0 -283
  504. package/dist/event-transforms/open-generative-ui-middleware.mjs.map +0 -1
  505. package/dist/event-transforms/recorded-events.cjs +0 -59
  506. package/dist/event-transforms/recorded-events.cjs.map +0 -1
  507. package/dist/event-transforms/recorded-events.d.cts +0 -23
  508. package/dist/event-transforms/recorded-events.d.cts.map +0 -1
  509. package/dist/event-transforms/recorded-events.d.mts +0 -23
  510. package/dist/event-transforms/recorded-events.d.mts.map +0 -1
  511. package/dist/event-transforms/recorded-events.mjs +0 -58
  512. package/dist/event-transforms/recorded-events.mjs.map +0 -1
  513. package/dist/telemetry/events.d.cts +0 -72
  514. package/dist/telemetry/events.d.cts.map +0 -1
  515. package/dist/telemetry/events.d.mts +0 -72
  516. package/dist/telemetry/events.d.mts.map +0 -1
  517. package/dist/telemetry/index.cjs +0 -18
  518. package/dist/telemetry/index.d.cts +0 -5
  519. package/dist/telemetry/index.d.mts +0 -5
  520. package/dist/telemetry/index.mjs +0 -6
  521. package/dist/telemetry/telemetry-client.cjs +0 -165
  522. package/dist/telemetry/telemetry-client.cjs.map +0 -1
  523. package/dist/telemetry/telemetry-client.d.cts +0 -87
  524. package/dist/telemetry/telemetry-client.d.cts.map +0 -1
  525. package/dist/telemetry/telemetry-client.d.mts +0 -87
  526. package/dist/telemetry/telemetry-client.d.mts.map +0 -1
  527. package/dist/telemetry/telemetry-client.mjs +0 -164
  528. package/dist/telemetry/telemetry-client.mjs.map +0 -1
  529. package/dist/telemetry/utils.cjs +0 -14
  530. package/dist/telemetry/utils.cjs.map +0 -1
  531. package/dist/telemetry/utils.mjs +0 -13
  532. package/dist/telemetry/utils.mjs.map +0 -1
  533. package/dist/utils/conditions.cjs +0 -32
  534. package/dist/utils/conditions.cjs.map +0 -1
  535. package/dist/utils/conditions.d.cts +0 -31
  536. package/dist/utils/conditions.d.cts.map +0 -1
  537. package/dist/utils/conditions.d.mts +0 -31
  538. package/dist/utils/conditions.d.mts.map +0 -1
  539. package/dist/utils/conditions.mjs +0 -31
  540. package/dist/utils/conditions.mjs.map +0 -1
  541. package/dist/utils/console-styling.cjs +0 -91
  542. package/dist/utils/console-styling.cjs.map +0 -1
  543. package/dist/utils/console-styling.d.cts +0 -65
  544. package/dist/utils/console-styling.d.cts.map +0 -1
  545. package/dist/utils/console-styling.d.mts +0 -65
  546. package/dist/utils/console-styling.d.mts.map +0 -1
  547. package/dist/utils/console-styling.mjs +0 -85
  548. package/dist/utils/console-styling.mjs.map +0 -1
  549. package/src/__tests__/zod-regression.test.ts +0 -319
  550. package/src/event-transforms/index.ts +0 -5
  551. package/src/event-transforms/open-generative-ui-middleware.ts +0 -392
  552. package/src/event-transforms/recorded-events.test.ts +0 -166
  553. package/src/event-transforms/recorded-events.ts +0 -74
  554. package/src/telemetry/events.ts +0 -68
  555. package/src/telemetry/index.ts +0 -9
  556. package/src/telemetry/telemetry-blank-license-identity.test.ts +0 -128
  557. package/src/telemetry/telemetry-client.test.ts +0 -798
  558. package/src/telemetry/telemetry-client.ts +0 -328
  559. package/src/telemetry/utils.ts +0 -15
  560. package/src/utils/__tests__/conditions.test.ts +0 -161
  561. package/src/utils/conditions.ts +0 -116
  562. package/src/utils/console-styling.ts +0 -126
@@ -1,328 +0,0 @@
1
- import { Analytics } from "@segment/analytics-node";
2
- import type { AnalyticsEvents } from "./events";
3
- import { flattenObject } from "./utils";
4
- import { v4 as uuidv4 } from "uuid";
5
- import {
6
- firstNonBlankTelemetryId,
7
- lambdaClient,
8
- parseAndWarnTelemetryId,
9
- } from "./lambda-client";
10
- import {
11
- computeSamplingMeta,
12
- TELEMETRY_EMITTER_V1,
13
- TELEMETRY_SURFACE_V1,
14
- UNSAMPLED_RATE,
15
- } from "./sampling";
16
- import { isTelemetryDisabled } from "./telemetry-disabled";
17
-
18
- export { isTelemetryDisabled };
19
-
20
- /** Transport identity and sampling authority resolved for one runtime. */
21
- export interface TelemetryIdentity {
22
- telemetryId?: string;
23
- licenseToken?: string;
24
- }
25
-
26
- /** Capture-only telemetry client bound to one runtime identity. */
27
- export interface TelemetryCapture {
28
- capture<K extends keyof AnalyticsEvents>(
29
- event: K,
30
- properties: AnalyticsEvents[K],
31
- ): Promise<void>;
32
- }
33
-
34
- interface ResolvedTelemetryIdentity {
35
- telemetryId: string | null;
36
- licenseToken: string | null;
37
- licenseTelemetryId: string | null;
38
- }
39
-
40
- export class TelemetryClient {
41
- segment: Analytics | undefined;
42
- globalProperties: Record<string, any> = {};
43
- cloudConfiguration: { publicApiKey: string; baseUrl: string } | null = null;
44
- // EIP / Intelligence license token (Ed25519-signed JWT). The lambda
45
- // client decodes its payload to extract telemetry_id. Customer API
46
- // keys are NOT used here — they flow only into Segment.
47
- private licenseToken: string | null = null;
48
- // Standalone analytics identity. This stays separate from the effective
49
- // identity so legacy callers continue sending only their license token to
50
- // the Lambda transport.
51
- private telemetryId: string | null = null;
52
- // License-derived identity used only as sampling authority. A standalone
53
- // telemetry id remains a transport claim and does not bypass the
54
- // Segment gate.
55
- private licenseTelemetryId: string | null = null;
56
- packageName: string;
57
- packageVersion: string;
58
- private telemetryDisabled: boolean = false;
59
- // Client-side sampling rate for anonymous events on the Segment wire
60
- // only. The lambda sink is ours and takes every event; Segment is
61
- // billed per event, so the anonymous population stays capped there.
62
- // Identified events (those whose license token yielded a telemetry_id)
63
- // bypass the gate on both wires.
64
- private segmentSampleRate: number = 0.05;
65
- private anonymousId = `anon_${uuidv4()}`;
66
-
67
- constructor({
68
- packageName,
69
- packageVersion,
70
- telemetryDisabled,
71
- telemetryBaseUrl,
72
- sampleRate,
73
- }: {
74
- packageName: string;
75
- packageVersion: string;
76
- telemetryDisabled?: boolean;
77
- telemetryBaseUrl?: string;
78
- // Anonymous sampling rate for the Segment wire. Named without the
79
- // prefix for backward compatibility; the lambda sink ignores it.
80
- sampleRate?: number;
81
- }) {
82
- this.packageName = packageName;
83
- this.packageVersion = packageVersion;
84
- this.telemetryDisabled = telemetryDisabled || isTelemetryDisabled();
85
-
86
- if (this.telemetryDisabled) {
87
- return;
88
- }
89
-
90
- this.setSampleRate(sampleRate);
91
-
92
- // eslint-disable-next-line
93
- const writeKey =
94
- process.env.COPILOTKIT_SEGMENT_WRITE_KEY ||
95
- "n7XAZtQCGS2v1vvBy3LgBCv2h3Y8whja";
96
-
97
- this.segment = new Analytics({
98
- writeKey,
99
- });
100
-
101
- this.setGlobalProperties({
102
- "copilotkit.package.name": packageName,
103
- "copilotkit.package.version": packageVersion,
104
- });
105
- }
106
-
107
- private shouldSendToSegment() {
108
- const randomNumber = Math.random();
109
- return randomNumber < this.segmentSampleRate;
110
- }
111
-
112
- async capture<K extends keyof AnalyticsEvents>(
113
- event: K,
114
- properties: AnalyticsEvents[K],
115
- ): Promise<void> {
116
- return this.captureWithIdentity(event, properties, {
117
- telemetryId: this.telemetryId,
118
- licenseToken: this.licenseToken,
119
- licenseTelemetryId: this.licenseTelemetryId,
120
- });
121
- }
122
-
123
- private async captureWithIdentity<K extends keyof AnalyticsEvents>(
124
- event: K,
125
- properties: AnalyticsEvents[K],
126
- identity: ResolvedTelemetryIdentity,
127
- ): Promise<void> {
128
- // Re-read the environment: an opt-out set after import (for example a
129
- // dotenv call below the imports) must still stop events.
130
- if (this.telemetryDisabled || isTelemetryDisabled()) {
131
- return;
132
- }
133
-
134
- // The two wires are gated separately. The lambda sink takes every
135
- // event: it is CopilotKit-owned, so anonymous volume costs nothing
136
- // per event there and a real count beats one extrapolated from 5% of
137
- // the population. Segment is billed per event, so it keeps the gate —
138
- // callers without license-derived sampling authority are dropped from
139
- // that copy at segmentSampleRate. Legacy license tokens with a
140
- // telemetry_id send on both wires: the volume is bounded by
141
- // paying-customer count and full fidelity per identified customer is
142
- // worth the marginal cost.
143
- const sendToSegment =
144
- Boolean(identity.licenseTelemetryId) || this.shouldSendToSegment();
145
-
146
- // Sampling metadata is computed in ./sampling so this client and the
147
- // v2 runtime client can't drift apart again — see the note there.
148
- // One call per wire, because the two wires were gated differently and
149
- // a shared block would overweight the lambda copy by 1/sampleRate.
150
- const lambdaSamplingMeta = computeSamplingMeta({
151
- telemetryId: identity.licenseTelemetryId,
152
- sampleRate: UNSAMPLED_RATE,
153
- });
154
- const segmentSamplingMeta = computeSamplingMeta({
155
- telemetryId: identity.licenseTelemetryId,
156
- sampleRate: this.segmentSampleRate,
157
- });
158
-
159
- // Everything below travels identically on both copies of this event.
160
- // The event id is what makes the dual-write dedupable downstream:
161
- // one capture() produces one id, stamped on the lambda copy and the
162
- // Segment copy alike, so consumers no longer have to infer the
163
- // duplication from $lib or from which fields happen to be present
164
- // (OSS-1019).
165
- const eventMeta = {
166
- telemetry_emitter: TELEMETRY_EMITTER_V1,
167
- telemetry_surface: TELEMETRY_SURFACE_V1,
168
- telemetry_event_id: uuidv4(),
169
- };
170
-
171
- const flattenedProperties = flattenObject(properties);
172
- const propertiesWithGlobal: Record<string, any> = {
173
- ...this.globalProperties,
174
- ...eventMeta,
175
- ...segmentSamplingMeta,
176
- telemetry_transport: "segment",
177
- ...flattenedProperties,
178
- };
179
- const orderedPropertiesWithGlobal = Object.keys(propertiesWithGlobal)
180
- .sort()
181
- .reduce(
182
- (obj, key) => {
183
- obj[key] = propertiesWithGlobal[key];
184
- return obj;
185
- },
186
- {} as Record<string, any>,
187
- );
188
-
189
- await lambdaClient.send({
190
- event,
191
- properties: flattenedProperties,
192
- globalProperties: {
193
- ...this.globalProperties,
194
- ...eventMeta,
195
- ...lambdaSamplingMeta,
196
- telemetry_transport: "lambda",
197
- },
198
- packageName: this.packageName,
199
- packageVersion: this.packageVersion,
200
- telemetryId: identity.telemetryId ?? undefined,
201
- licenseToken: identity.licenseToken ?? undefined,
202
- });
203
-
204
- if (this.segment && sendToSegment) {
205
- this.segment.track({
206
- anonymousId: this.anonymousId,
207
- event,
208
- properties: { ...orderedPropertiesWithGlobal },
209
- });
210
- }
211
- }
212
-
213
- setGlobalProperties(properties: Record<string, any>) {
214
- const flattenedProperties = flattenObject(properties);
215
- this.globalProperties = {
216
- ...this.globalProperties,
217
- ...flattenedProperties,
218
- };
219
- }
220
-
221
- setCloudConfiguration(properties: { publicApiKey: string; baseUrl: string }) {
222
- this.cloudConfiguration = properties;
223
-
224
- this.setGlobalProperties({
225
- cloud: {
226
- publicApiKey: properties.publicApiKey,
227
- baseUrl: properties.baseUrl,
228
- },
229
- });
230
- }
231
-
232
- /**
233
- * Atomically configure standalone, legacy, or anonymous telemetry identity.
234
- *
235
- * A standalone id takes transport precedence over a supplied legacy license
236
- * token, but only a license-derived id grants sampling authority. Neither
237
- * value is added to event properties.
238
- *
239
- * @param identity - One standalone id, one legacy license token, or neither.
240
- */
241
- setTelemetryIdentity(identity: {
242
- telemetryId?: string;
243
- licenseToken?: string;
244
- }): void {
245
- const resolvedIdentity = this.resolveTelemetryIdentity(identity);
246
- this.telemetryId = resolvedIdentity.telemetryId;
247
- this.licenseToken = resolvedIdentity.licenseToken;
248
- this.licenseTelemetryId = resolvedIdentity.licenseTelemetryId;
249
- }
250
-
251
- /**
252
- * Configure legacy license-derived telemetry identity.
253
- *
254
- * @param licenseToken - License token whose telemetry claim identifies sends.
255
- */
256
- setLicenseToken(licenseToken: string) {
257
- this.setTelemetryIdentity({ licenseToken });
258
- }
259
-
260
- /**
261
- * Create an immutable capture scope for one runtime.
262
- *
263
- * The scope shares this client's sinks, process-wide opt-out, global
264
- * properties, and Segment sampling rate, but snapshots transport identity and
265
- * license-derived sampling authority. Constructing another runtime cannot
266
- * rewrite an existing scope.
267
- *
268
- * @param identity - The runtime's construction-time telemetry identity.
269
- * @returns A capture-only client bound to that identity.
270
- */
271
- createScope(identity: TelemetryIdentity): TelemetryCapture {
272
- const resolvedIdentity = this.resolveTelemetryIdentity(identity);
273
-
274
- return {
275
- capture: <K extends keyof AnalyticsEvents>(
276
- event: K,
277
- properties: AnalyticsEvents[K],
278
- ) => this.captureWithIdentity(event, properties, resolvedIdentity),
279
- };
280
- }
281
-
282
- private resolveTelemetryIdentity(
283
- identity: TelemetryIdentity,
284
- ): ResolvedTelemetryIdentity {
285
- const telemetryId = firstNonBlankTelemetryId(identity.telemetryId);
286
- if (telemetryId !== undefined) {
287
- return {
288
- telemetryId,
289
- licenseToken: null,
290
- licenseTelemetryId: null,
291
- };
292
- }
293
-
294
- return {
295
- telemetryId: null,
296
- licenseToken: identity.licenseToken ?? null,
297
- licenseTelemetryId: identity.licenseToken
298
- ? parseAndWarnTelemetryId(identity.licenseToken)
299
- : null,
300
- };
301
- }
302
-
303
- private setSampleRate(sampleRate: number | undefined) {
304
- let _sampleRate: number;
305
-
306
- _sampleRate = sampleRate ?? 0.05;
307
-
308
- // eslint-disable-next-line
309
- if (process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE) {
310
- // eslint-disable-next-line
311
- _sampleRate = parseFloat(process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE);
312
- }
313
-
314
- // Number.isNaN guards against parseFloat("nonsense") slipping past the
315
- // range check (all NaN comparisons are false), which would silently
316
- // drop every anonymous Segment event with no signal.
317
- if (Number.isNaN(_sampleRate) || _sampleRate < 0 || _sampleRate > 1) {
318
- throw new Error("Sample rate must be between 0 and 1");
319
- }
320
-
321
- this.segmentSampleRate = _sampleRate;
322
- // Per-event sampling metadata (sampleRate/sampleRateAdjustmentFactor/
323
- // sampleWeight) is computed per capture() in ./sampling, once per
324
- // wire. Only license-authorized events get effectiveSampleRate=1 on
325
- // the Segment copy; standalone transport identity stays in the
326
- // sampled population there. The lambda copy is always unsampled.
327
- }
328
- }
@@ -1,15 +0,0 @@
1
- export function flattenObject(
2
- obj: Record<string, any>,
3
- parentKey = "",
4
- res: Record<string, any> = {},
5
- ): Record<string, any> {
6
- for (let key in obj) {
7
- const propName = parentKey ? `${parentKey}.${key}` : key;
8
- if (typeof obj[key] === "object" && obj[key] !== null) {
9
- flattenObject(obj[key], propName, res);
10
- } else {
11
- res[propName] = obj[key];
12
- }
13
- }
14
- return res;
15
- }
@@ -1,161 +0,0 @@
1
- import { describe, it, expect } from "vitest";
2
- import {
3
- executeConditions,
4
- Condition,
5
- ComparisonCondition,
6
- LogicalCondition,
7
- ExistenceCondition,
8
- } from "../conditions";
9
-
10
- describe("executeConditions", () => {
11
- it("returns true when conditions is empty or undefined", () => {
12
- expect(executeConditions({ value: { a: 1 } })).toBe(true);
13
- expect(executeConditions({ conditions: [], value: { a: 1 } })).toBe(true);
14
- });
15
-
16
- it("treats multiple conditions as an implicit AND", () => {
17
- const conditions: Condition[] = [
18
- { rule: "EQUALS", path: "a", value: 1 },
19
- { rule: "EQUALS", path: "b", value: 2 },
20
- ];
21
- expect(executeConditions({ conditions, value: { a: 1, b: 2 } })).toBe(true);
22
- expect(executeConditions({ conditions, value: { a: 1, b: 3 } })).toBe(false);
23
- });
24
-
25
- describe("comparison rules", () => {
26
- it("EQUALS and NOT_EQUALS", () => {
27
- const eq: ComparisonCondition = { rule: "EQUALS", path: "a", value: 5 };
28
- const neq: ComparisonCondition = { rule: "NOT_EQUALS", path: "a", value: 5 };
29
- expect(executeConditions({ conditions: [eq], value: { a: 5 } })).toBe(true);
30
- expect(executeConditions({ conditions: [eq], value: { a: 6 } })).toBe(false);
31
- expect(executeConditions({ conditions: [neq], value: { a: 6 } })).toBe(true);
32
- expect(executeConditions({ conditions: [neq], value: { a: 5 } })).toBe(false);
33
- });
34
-
35
- it("GREATER_THAN and LESS_THAN", () => {
36
- const gt: ComparisonCondition = { rule: "GREATER_THAN", path: "n", value: 10 };
37
- const lt: ComparisonCondition = { rule: "LESS_THAN", path: "n", value: 10 };
38
- expect(executeConditions({ conditions: [gt], value: { n: 11 } })).toBe(true);
39
- expect(executeConditions({ conditions: [gt], value: { n: 10 } })).toBe(false);
40
- expect(executeConditions({ conditions: [lt], value: { n: 9 } })).toBe(true);
41
- expect(executeConditions({ conditions: [lt], value: { n: 10 } })).toBe(false);
42
- });
43
-
44
- it("CONTAINS and NOT_CONTAINS only apply to arrays", () => {
45
- const contains: ComparisonCondition = { rule: "CONTAINS", path: "tags", value: "ts" };
46
- const notContains: ComparisonCondition = { rule: "NOT_CONTAINS", path: "tags", value: "ts" };
47
- expect(
48
- executeConditions({ conditions: [contains], value: { tags: ["js", "ts"] } }),
49
- ).toBe(true);
50
- expect(
51
- executeConditions({ conditions: [contains], value: { tags: ["js"] } }),
52
- ).toBe(false);
53
- expect(
54
- executeConditions({ conditions: [notContains], value: { tags: ["js"] } }),
55
- ).toBe(true);
56
- // non-array target always fails both CONTAINS and NOT_CONTAINS
57
- expect(
58
- executeConditions({ conditions: [contains], value: { tags: "ts" } }),
59
- ).toBe(false);
60
- expect(
61
- executeConditions({ conditions: [notContains], value: { tags: "ts" } }),
62
- ).toBe(false);
63
- });
64
-
65
- it("MATCHES uses the value as a regular expression", () => {
66
- const matches: ComparisonCondition = { rule: "MATCHES", path: "code", value: "^CK-[0-9]+$" };
67
- expect(executeConditions({ conditions: [matches], value: { code: "CK-123" } })).toBe(true);
68
- expect(executeConditions({ conditions: [matches], value: { code: "nope" } })).toBe(false);
69
- });
70
-
71
- it("STARTS_WITH and ENDS_WITH", () => {
72
- const sw: ComparisonCondition = { rule: "STARTS_WITH", path: "s", value: "foo" };
73
- const ew: ComparisonCondition = { rule: "ENDS_WITH", path: "s", value: "bar" };
74
- expect(executeConditions({ conditions: [sw], value: { s: "foobar" } })).toBe(true);
75
- expect(executeConditions({ conditions: [sw], value: { s: "barfoo" } })).toBe(false);
76
- expect(executeConditions({ conditions: [ew], value: { s: "foobar" } })).toBe(true);
77
- expect(executeConditions({ conditions: [ew], value: { s: "barfoo" } })).toBe(false);
78
- });
79
- });
80
-
81
- describe("existence rules", () => {
82
- it("EXISTS passes only for defined non-null values", () => {
83
- const exists: ExistenceCondition = { rule: "EXISTS", path: "a" };
84
- expect(executeConditions({ conditions: [exists], value: { a: 0 } })).toBe(true);
85
- expect(executeConditions({ conditions: [exists], value: { a: "" } })).toBe(true);
86
- expect(executeConditions({ conditions: [exists], value: { a: false } })).toBe(true);
87
- expect(executeConditions({ conditions: [exists], value: { a: null } })).toBe(false);
88
- expect(executeConditions({ conditions: [exists], value: {} })).toBe(false);
89
- });
90
-
91
- it("NOT_EXISTS is the inverse of EXISTS", () => {
92
- const notExists: ExistenceCondition = { rule: "NOT_EXISTS", path: "a" };
93
- expect(executeConditions({ conditions: [notExists], value: { a: 1 } })).toBe(false);
94
- expect(executeConditions({ conditions: [notExists], value: { a: null } })).toBe(true);
95
- expect(executeConditions({ conditions: [notExists], value: {} })).toBe(true);
96
- });
97
- });
98
-
99
- describe("logical rules", () => {
100
- it("AND requires all nested conditions to pass", () => {
101
- const and: LogicalCondition = {
102
- rule: "AND",
103
- conditions: [
104
- { rule: "EQUALS", path: "a", value: 1 },
105
- { rule: "EQUALS", path: "b", value: 2 },
106
- ],
107
- };
108
- expect(executeConditions({ conditions: [and], value: { a: 1, b: 2 } })).toBe(true);
109
- expect(executeConditions({ conditions: [and], value: { a: 1, b: 3 } })).toBe(false);
110
- });
111
-
112
- it("OR passes when any nested condition passes", () => {
113
- const or: LogicalCondition = {
114
- rule: "OR",
115
- conditions: [
116
- { rule: "EQUALS", path: "a", value: 1 },
117
- { rule: "EQUALS", path: "b", value: 2 },
118
- ],
119
- };
120
- expect(executeConditions({ conditions: [or], value: { a: 9, b: 2 } })).toBe(true);
121
- expect(executeConditions({ conditions: [or], value: { a: 9, b: 9 } })).toBe(false);
122
- });
123
-
124
- it("NOT inverts the AND of nested conditions", () => {
125
- const notAll: LogicalCondition = {
126
- rule: "NOT",
127
- conditions: [
128
- { rule: "EQUALS", path: "a", value: 1 },
129
- { rule: "EQUALS", path: "b", value: 2 },
130
- ],
131
- };
132
- // both true → NOT(AND) = false
133
- expect(executeConditions({ conditions: [notAll], value: { a: 1, b: 2 } })).toBe(false);
134
- // one false → NOT(AND) = true
135
- expect(executeConditions({ conditions: [notAll], value: { a: 1, b: 3 } })).toBe(true);
136
- });
137
- });
138
-
139
- describe("path resolution", () => {
140
- it("resolves nested dot paths", () => {
141
- const cond: ComparisonCondition = { rule: "EQUALS", path: "user.profile.age", value: 30 };
142
- expect(
143
- executeConditions({ conditions: [cond], value: { user: { profile: { age: 30 } } } }),
144
- ).toBe(true);
145
- expect(
146
- executeConditions({ conditions: [cond], value: { user: { profile: { age: 31 } } } }),
147
- ).toBe(false);
148
- });
149
-
150
- it("returns false for a missing nested path (undefined target)", () => {
151
- const eq: ComparisonCondition = { rule: "EQUALS", path: "a.b.c", value: 1 };
152
- expect(executeConditions({ conditions: [eq], value: {} })).toBe(false);
153
- });
154
-
155
- it("uses the whole value when no path is given", () => {
156
- const eq: ComparisonCondition = { rule: "EQUALS", value: 42 };
157
- expect(executeConditions({ conditions: [eq], value: 42 })).toBe(true);
158
- expect(executeConditions({ conditions: [eq], value: 43 })).toBe(false);
159
- });
160
- });
161
- });
@@ -1,116 +0,0 @@
1
- export type ComparisonRule =
2
- | "EQUALS"
3
- | "NOT_EQUALS"
4
- | "GREATER_THAN"
5
- | "LESS_THAN"
6
- | "CONTAINS"
7
- | "NOT_CONTAINS"
8
- | "MATCHES"
9
- | "STARTS_WITH"
10
- | "ENDS_WITH";
11
- export type LogicalRule = "AND" | "OR" | "NOT";
12
- export type ExistenceRule = "EXISTS" | "NOT_EXISTS";
13
-
14
- export type Rule = ComparisonRule | LogicalRule | ExistenceRule;
15
-
16
- export interface BaseCondition {
17
- rule: Rule;
18
- path?: string;
19
- }
20
-
21
- export interface ComparisonCondition extends BaseCondition {
22
- rule: ComparisonRule;
23
- value: any;
24
- }
25
-
26
- export interface LogicalCondition extends BaseCondition {
27
- rule: LogicalRule;
28
- conditions: Condition[];
29
- }
30
-
31
- export interface ExistenceCondition extends BaseCondition {
32
- rule: ExistenceRule;
33
- }
34
-
35
- export type Condition =
36
- | ComparisonCondition
37
- | LogicalCondition
38
- | ExistenceCondition;
39
-
40
- export function executeConditions({
41
- conditions,
42
- value,
43
- }: {
44
- conditions?: Condition[];
45
- value: any;
46
- }): boolean {
47
- // If no conditions, consider it a pass
48
- if (!conditions?.length) return true;
49
-
50
- // Run all conditions (implicit AND)
51
- return conditions.every((condition) => executeCondition(condition, value));
52
- }
53
-
54
- function executeCondition(condition: Condition, value: any): boolean {
55
- const targetValue = condition.path
56
- ? getValueFromPath(value, condition.path)
57
- : value;
58
-
59
- switch (condition.rule) {
60
- // Logical
61
- case "AND":
62
- return (condition as LogicalCondition).conditions.every((c) =>
63
- executeCondition(c, value),
64
- );
65
- case "OR":
66
- return (condition as LogicalCondition).conditions.some((c) =>
67
- executeCondition(c, value),
68
- );
69
- case "NOT":
70
- return !(condition as LogicalCondition).conditions.every((c) =>
71
- executeCondition(c, value),
72
- );
73
-
74
- // Comparison
75
- case "EQUALS":
76
- return targetValue === (condition as ComparisonCondition).value;
77
- case "NOT_EQUALS":
78
- return targetValue !== (condition as ComparisonCondition).value;
79
- case "GREATER_THAN":
80
- return targetValue > (condition as ComparisonCondition).value;
81
- case "LESS_THAN":
82
- return targetValue < (condition as ComparisonCondition).value;
83
- case "CONTAINS":
84
- return (
85
- Array.isArray(targetValue) &&
86
- targetValue.includes((condition as ComparisonCondition).value)
87
- );
88
- case "NOT_CONTAINS":
89
- return (
90
- Array.isArray(targetValue) &&
91
- !targetValue.includes((condition as ComparisonCondition).value)
92
- );
93
- case "MATCHES":
94
- return new RegExp((condition as ComparisonCondition).value).test(
95
- String(targetValue),
96
- );
97
- case "STARTS_WITH":
98
- return String(targetValue).startsWith(
99
- (condition as ComparisonCondition).value,
100
- );
101
- case "ENDS_WITH":
102
- return String(targetValue).endsWith(
103
- (condition as ComparisonCondition).value,
104
- );
105
-
106
- // Existence
107
- case "EXISTS":
108
- return targetValue !== undefined && targetValue !== null;
109
- case "NOT_EXISTS":
110
- return targetValue === undefined || targetValue === null;
111
- }
112
- }
113
-
114
- function getValueFromPath(obj: any, path: string): any {
115
- return path.split(".").reduce((acc, part) => acc?.[part], obj);
116
- }