@copilotkit/shared 2.0.0-rc.5 → 2.0.0-rc.51

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 (569) hide show
  1. package/README.md +4 -15
  2. package/dist/a2ui-envelope.cjs +3 -3
  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 +3 -3
  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 +20 -7
  325. package/dist/generative-ui/types.d.cts.map +1 -1
  326. package/dist/generative-ui/types.d.mts +20 -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 +18 -17
  337. package/dist/index.d.cts.map +1 -1
  338. package/dist/index.d.mts +18 -17
  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 +5 -7
  383. package/dist/utils/index.d.cts.map +1 -1
  384. package/dist/utils/index.d.mts +5 -7
  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/dist/utils/types.cjs.map +1 -1
  413. package/dist/utils/types.d.cts +5 -12
  414. package/dist/utils/types.d.cts.map +1 -1
  415. package/dist/utils/types.d.mts +5 -12
  416. package/dist/utils/types.d.mts.map +1 -1
  417. package/dist/utils/types.mjs.map +1 -1
  418. package/package.json +19 -32
  419. package/scripts/verify-cjs-exports.cjs +1 -1
  420. package/src/__tests__/a2ui-envelope.test.ts +38 -13
  421. package/src/__tests__/a2ui-prompts.test.ts +47 -14
  422. package/src/__tests__/fixtures/prompt-goldens.json +354 -0
  423. package/src/__tests__/prompt-spec.test.ts +191 -0
  424. package/src/__tests__/root-entry-browser-safety.test.ts +5 -7
  425. package/src/__tests__/schema-render.test.ts +323 -0
  426. package/src/__tests__/standard-schema.test.ts +61 -101
  427. package/src/a2ui-envelope.ts +9 -7
  428. package/src/a2ui-prompts.ts +47 -96
  429. package/src/attachments/__tests__/utils.test.ts +22 -0
  430. package/src/attachments/types.ts +1 -3
  431. package/src/attachments/utils.ts +23 -5
  432. package/src/finalize-events.ts +16 -0
  433. package/src/generative-ui/__tests__/clone-value-differential.test.ts +480 -0
  434. package/src/generative-ui/__tests__/clone-value.test.ts +226 -0
  435. package/src/generative-ui/__tests__/render-ui-args.test.ts +7 -7
  436. package/src/generative-ui/__tests__/validate-operation.test.ts +19 -13
  437. package/src/generative-ui/base.ts +9 -0
  438. package/src/generative-ui/basic-functions.ts +1 -1
  439. package/src/generative-ui/catalog/catalog-export.ts +478 -0
  440. package/src/generative-ui/catalog/catalog.ts +1167 -0
  441. package/src/generative-ui/catalog/errors.ts +102 -0
  442. package/src/generative-ui/catalog/index.ts +6 -0
  443. package/src/generative-ui/catalog/json-schema.ts +14 -0
  444. package/src/generative-ui/catalog/refs.ts +87 -0
  445. package/src/generative-ui/catalog/schema.ts +107 -0
  446. package/src/generative-ui/child-refs.ts +5 -4
  447. package/src/generative-ui/clone-value.ts +511 -0
  448. package/src/generative-ui/compact-schema.ts +277 -0
  449. package/src/generative-ui/index.ts +14 -0
  450. package/src/generative-ui/is-record.ts +6 -1
  451. package/src/generative-ui/prompt-spec.ts +335 -0
  452. package/src/generative-ui/prompt.ts +25 -75
  453. package/src/generative-ui/render-ui-args.ts +3 -0
  454. package/src/generative-ui/schema-render.ts +378 -0
  455. package/src/generative-ui/standard/__tests__/standard-helpers.test.ts +407 -0
  456. package/src/generative-ui/standard/__tests__/theme.test.ts +61 -0
  457. package/src/generative-ui/standard/__tests__/tokens.test.ts +139 -0
  458. package/src/generative-ui/standard/chart-config.ts +434 -0
  459. package/src/generative-ui/standard/chart.ts +79 -0
  460. package/src/generative-ui/standard/checks.ts +98 -0
  461. package/src/generative-ui/standard/components.ts +35 -0
  462. package/src/generative-ui/standard/composites.ts +158 -0
  463. package/src/generative-ui/standard/data.ts +213 -0
  464. package/src/generative-ui/standard/declarations.ts +57 -0
  465. package/src/generative-ui/standard/feedback.ts +105 -0
  466. package/src/generative-ui/standard/index.ts +55 -0
  467. package/src/generative-ui/standard/inputs.ts +423 -0
  468. package/src/generative-ui/standard/layout.ts +312 -0
  469. package/src/generative-ui/standard/map-helpers.ts +155 -0
  470. package/src/generative-ui/standard/map.ts +32 -0
  471. package/src/generative-ui/standard/media.ts +265 -0
  472. package/src/generative-ui/standard/parameter-order.ts +155 -0
  473. package/src/generative-ui/standard/style-helpers.ts +170 -0
  474. package/src/generative-ui/standard/styles.ts +79 -0
  475. package/src/generative-ui/standard/text.ts +210 -0
  476. package/src/generative-ui/standard/theme.ts +198 -0
  477. package/src/generative-ui/standard/tokens.ts +317 -0
  478. package/src/generative-ui/standard/url.ts +51 -0
  479. package/src/generative-ui/thrown.ts +90 -0
  480. package/src/generative-ui/types.ts +23 -7
  481. package/src/generative-ui/validate-operation.ts +2 -2
  482. package/src/index.ts +9 -17
  483. package/src/standard-schema.ts +24 -27
  484. package/src/telemetry/lambda-client.ts +8 -3
  485. package/src/telemetry/model-host.test.ts +2 -5
  486. package/src/telemetry/telemetry-disabled.ts +0 -5
  487. package/src/types/message.ts +1 -19
  488. package/src/utils/__tests__/errors.test.ts +44 -0
  489. package/src/utils/__tests__/json-schema.test.ts +3 -479
  490. package/src/utils/__tests__/random-id.test.ts +37 -0
  491. package/src/utils/errors.ts +28 -85
  492. package/src/utils/index.ts +0 -2
  493. package/src/utils/inspector-visibility.test.ts +26 -0
  494. package/src/utils/inspector-visibility.ts +35 -3
  495. package/src/utils/json-schema.ts +5 -152
  496. package/src/utils/random-id.ts +17 -37
  497. package/src/utils/types.ts +4 -11
  498. package/tsconfig.json +3 -1
  499. package/tsdown.config.ts +2 -19
  500. package/dist/event-transforms/index.cjs +0 -15
  501. package/dist/event-transforms/index.d.cts +0 -4
  502. package/dist/event-transforms/index.d.mts +0 -4
  503. package/dist/event-transforms/index.mjs +0 -5
  504. package/dist/event-transforms/open-generative-ui-middleware.cjs +0 -286
  505. package/dist/event-transforms/open-generative-ui-middleware.cjs.map +0 -1
  506. package/dist/event-transforms/open-generative-ui-middleware.d.cts +0 -60
  507. package/dist/event-transforms/open-generative-ui-middleware.d.cts.map +0 -1
  508. package/dist/event-transforms/open-generative-ui-middleware.d.mts +0 -60
  509. package/dist/event-transforms/open-generative-ui-middleware.d.mts.map +0 -1
  510. package/dist/event-transforms/open-generative-ui-middleware.mjs +0 -283
  511. package/dist/event-transforms/open-generative-ui-middleware.mjs.map +0 -1
  512. package/dist/event-transforms/recorded-events.cjs +0 -59
  513. package/dist/event-transforms/recorded-events.cjs.map +0 -1
  514. package/dist/event-transforms/recorded-events.d.cts +0 -23
  515. package/dist/event-transforms/recorded-events.d.cts.map +0 -1
  516. package/dist/event-transforms/recorded-events.d.mts +0 -23
  517. package/dist/event-transforms/recorded-events.d.mts.map +0 -1
  518. package/dist/event-transforms/recorded-events.mjs +0 -58
  519. package/dist/event-transforms/recorded-events.mjs.map +0 -1
  520. package/dist/telemetry/events.d.cts +0 -72
  521. package/dist/telemetry/events.d.cts.map +0 -1
  522. package/dist/telemetry/events.d.mts +0 -72
  523. package/dist/telemetry/events.d.mts.map +0 -1
  524. package/dist/telemetry/index.cjs +0 -18
  525. package/dist/telemetry/index.d.cts +0 -5
  526. package/dist/telemetry/index.d.mts +0 -5
  527. package/dist/telemetry/index.mjs +0 -6
  528. package/dist/telemetry/telemetry-client.cjs +0 -165
  529. package/dist/telemetry/telemetry-client.cjs.map +0 -1
  530. package/dist/telemetry/telemetry-client.d.cts +0 -87
  531. package/dist/telemetry/telemetry-client.d.cts.map +0 -1
  532. package/dist/telemetry/telemetry-client.d.mts +0 -87
  533. package/dist/telemetry/telemetry-client.d.mts.map +0 -1
  534. package/dist/telemetry/telemetry-client.mjs +0 -164
  535. package/dist/telemetry/telemetry-client.mjs.map +0 -1
  536. package/dist/telemetry/utils.cjs +0 -14
  537. package/dist/telemetry/utils.cjs.map +0 -1
  538. package/dist/telemetry/utils.mjs +0 -13
  539. package/dist/telemetry/utils.mjs.map +0 -1
  540. package/dist/utils/conditions.cjs +0 -32
  541. package/dist/utils/conditions.cjs.map +0 -1
  542. package/dist/utils/conditions.d.cts +0 -31
  543. package/dist/utils/conditions.d.cts.map +0 -1
  544. package/dist/utils/conditions.d.mts +0 -31
  545. package/dist/utils/conditions.d.mts.map +0 -1
  546. package/dist/utils/conditions.mjs +0 -31
  547. package/dist/utils/conditions.mjs.map +0 -1
  548. package/dist/utils/console-styling.cjs +0 -91
  549. package/dist/utils/console-styling.cjs.map +0 -1
  550. package/dist/utils/console-styling.d.cts +0 -65
  551. package/dist/utils/console-styling.d.cts.map +0 -1
  552. package/dist/utils/console-styling.d.mts +0 -65
  553. package/dist/utils/console-styling.d.mts.map +0 -1
  554. package/dist/utils/console-styling.mjs +0 -85
  555. package/dist/utils/console-styling.mjs.map +0 -1
  556. package/src/__tests__/zod-regression.test.ts +0 -319
  557. package/src/event-transforms/index.ts +0 -5
  558. package/src/event-transforms/open-generative-ui-middleware.ts +0 -392
  559. package/src/event-transforms/recorded-events.test.ts +0 -166
  560. package/src/event-transforms/recorded-events.ts +0 -74
  561. package/src/telemetry/events.ts +0 -68
  562. package/src/telemetry/index.ts +0 -9
  563. package/src/telemetry/telemetry-blank-license-identity.test.ts +0 -128
  564. package/src/telemetry/telemetry-client.test.ts +0 -798
  565. package/src/telemetry/telemetry-client.ts +0 -328
  566. package/src/telemetry/utils.ts +0 -15
  567. package/src/utils/__tests__/conditions.test.ts +0 -161
  568. package/src/utils/conditions.ts +0 -116
  569. package/src/utils/console-styling.ts +0 -126
@@ -0,0 +1,191 @@
1
+ import { createHash } from "node:crypto";
2
+ import { describe, expect, it } from "vitest";
3
+ import goldens from "./fixtures/prompt-goldens.json";
4
+ import { buildGenerativeUIMarkdownGuidelines } from "../a2ui-prompts";
5
+ import { buildGenerativeUIPrompt } from "../generative-ui/prompt";
6
+ import {
7
+ defaultGenerativeUIPromptSpec,
8
+ selectPromptItems,
9
+ } from "../generative-ui/prompt-spec";
10
+ import type {
11
+ GenerativeUIComponentManifest,
12
+ GenerativeUIManifest,
13
+ } from "../generative-ui/types";
14
+
15
+ interface Flags {
16
+ functions: boolean;
17
+ events: boolean;
18
+ templates: boolean;
19
+ checks: boolean;
20
+ surfaces: boolean;
21
+ }
22
+
23
+ const childList = { $ref: "common_types.json#/$defs/ChildList" };
24
+
25
+ /** The manifest the goldens were captured with, for one set of flags. */
26
+ function goldenManifest(f: Flags): GenerativeUIManifest {
27
+ const components: Record<string, GenerativeUIComponentManifest> = {
28
+ Text: {
29
+ description: "Shows text",
30
+ props: {
31
+ type: "object",
32
+ properties: { text: { type: "string", description: "The text" } },
33
+ },
34
+ },
35
+ Column: {
36
+ description: "A column",
37
+ props: {
38
+ type: "object",
39
+ properties: {
40
+ children: f.templates
41
+ ? childList
42
+ : { type: "array", items: { type: "string" } },
43
+ },
44
+ },
45
+ ...(f.templates ? { slots: { children: "multiple" as const } } : {}),
46
+ },
47
+ };
48
+ if (f.events) {
49
+ components.Button = {
50
+ description: "A button",
51
+ props: { type: "object", properties: { label: { type: "string" } } },
52
+ events: { onClick: { description: "Action" } },
53
+ };
54
+ }
55
+ if (f.checks) {
56
+ components.TextField = {
57
+ description: "An input",
58
+ props: {
59
+ type: "object",
60
+ properties: { value: { type: "string" }, checks: { type: "array" } },
61
+ },
62
+ };
63
+ }
64
+ return {
65
+ catalogId: "test/goldens@1",
66
+ components,
67
+ functions: {
68
+ formatCurrency: {
69
+ description: "Formats money",
70
+ parameters: {
71
+ type: "object",
72
+ description: "{value: number, currency: string}",
73
+ },
74
+ },
75
+ ...(f.functions
76
+ ? {
77
+ addToCart: {
78
+ description: "Adds to cart",
79
+ parameters: {
80
+ type: "object",
81
+ properties: { id: { type: "string" } },
82
+ },
83
+ },
84
+ }
85
+ : {}),
86
+ },
87
+ targets: [
88
+ { id: "chat", kind: "chat" },
89
+ {
90
+ id: "sidebar",
91
+ kind: "inline",
92
+ description: "The side panel",
93
+ components: ["Text"],
94
+ },
95
+ ],
96
+ surfaces: f.surfaces
97
+ ? {
98
+ s1: {
99
+ target: "chat",
100
+ dataModel: { name: "Ada" },
101
+ rejected: ["updateComponents: unknown component"],
102
+ },
103
+ }
104
+ : {},
105
+ };
106
+ }
107
+
108
+ const sha = (text: string) => createHash("sha256").update(text).digest("hex");
109
+
110
+ describe("prompt builders without a spec", () => {
111
+ it.each(goldens.map((g) => [JSON.stringify(g.flags), g] as const))(
112
+ "render today's text for %s",
113
+ (_name, golden) => {
114
+ const { surfaces: _surfaces, ...features } = golden.flags;
115
+ expect(sha(buildGenerativeUIMarkdownGuidelines(features))).toBe(
116
+ golden.markdown,
117
+ );
118
+ expect(sha(buildGenerativeUIPrompt(goldenManifest(golden.flags)))).toBe(
119
+ golden.tool,
120
+ );
121
+ },
122
+ );
123
+ });
124
+
125
+ describe("prompt builders with a spec", () => {
126
+ const noFeatures = {
127
+ functions: false,
128
+ events: false,
129
+ templates: false,
130
+ checks: false,
131
+ };
132
+
133
+ it("render the default spec exactly like no spec", () => {
134
+ const spec = defaultGenerativeUIPromptSpec();
135
+ expect(buildGenerativeUIMarkdownGuidelines(undefined, spec)).toBe(
136
+ buildGenerativeUIMarkdownGuidelines(),
137
+ );
138
+ const manifest = goldenManifest({ ...noFeatures, surfaces: true });
139
+ expect(buildGenerativeUIPrompt(manifest, spec)).toBe(
140
+ buildGenerativeUIPrompt(manifest),
141
+ );
142
+ });
143
+
144
+ it("use the intro, the paragraph and the rules of the spec", () => {
145
+ const spec = defaultGenerativeUIPromptSpec();
146
+ spec.markdown.intro = "Draw UI in a2ui fences.";
147
+ spec.markdown.whenToShow = "";
148
+ spec.markdown.rules = ["Rule one.", "Rule two."];
149
+ expect(buildGenerativeUIMarkdownGuidelines(noFeatures, spec)).toBe(
150
+ "Draw UI in a2ui fences.\n\nRULES\n- Rule one.\n- Rule two.\n",
151
+ );
152
+ spec.tool.intro = "Use render_ui.";
153
+ spec.tool.rules = ["Only rule."];
154
+ const tool = buildGenerativeUIPrompt(
155
+ goldenManifest({ ...noFeatures, surfaces: false }),
156
+ spec,
157
+ );
158
+ expect(tool).toContain("## Generative UI\nUse render_ui.\n\n");
159
+ expect(tool).toContain("Rules:\n1. Only rule.\n");
160
+ });
161
+
162
+ it("include a block only when all of its features hold", () => {
163
+ const items = [
164
+ "always",
165
+ { when: ["checks" as const], items: ["checks only"] },
166
+ {
167
+ when: ["events" as const, "noFunctions" as const],
168
+ items: ["events, no functions"],
169
+ },
170
+ ];
171
+ const features = {
172
+ functions: false,
173
+ noFunctions: true,
174
+ events: true,
175
+ templates: false,
176
+ checks: false,
177
+ agentCalls: false,
178
+ };
179
+ expect(selectPromptItems(items, features)).toEqual([
180
+ "always",
181
+ "events, no functions",
182
+ ]);
183
+ expect(
184
+ selectPromptItems(items, {
185
+ ...features,
186
+ checks: true,
187
+ noFunctions: false,
188
+ }),
189
+ ).toEqual(["always", "checks only"]);
190
+ });
191
+ });
@@ -80,12 +80,10 @@ describe("root entry browser safety (#4151)", () => {
80
80
  expect(offenders).toEqual([]);
81
81
  });
82
82
 
83
- it("still reaches Node-only packages from the telemetry subpath entry", () => {
84
- // Guards the test itself: the walker has to be able to see the edge it is
85
- // asserting the absence of above.
86
- const reachable = collectRuntimeDependencies(
87
- join(SRC, "telemetry", "index.ts"),
88
- );
89
- expect(reachable).toContain("@segment/analytics-node");
83
+ it("sees value imports of bare packages", () => {
84
+ // Guards the test itself: the walker has to be able to see the kind of
85
+ // edge it is asserting the absence of above.
86
+ const reachable = collectRuntimeDependencies(join(SRC, "index.ts"));
87
+ expect(reachable).toContain("partial-json");
90
88
  });
91
89
  });
@@ -0,0 +1,323 @@
1
+ import { readFileSync } from "node:fs";
2
+ import { resolve } from "node:path";
3
+ import { describe, expect, it } from "vitest";
4
+ import { defaultGenerativeUIPromptSpec } from "../generative-ui/prompt-spec";
5
+ import type { GenerativeUISchemaSettings } from "../generative-ui/prompt-spec";
6
+ import {
7
+ applyDescriptionOverrides,
8
+ renderGenerativeUIComponentList,
9
+ renderGenerativeUISchema,
10
+ schemaCoverage,
11
+ } from "../generative-ui/schema-render";
12
+ import type { GenerativeUIManifest } from "../generative-ui/types";
13
+
14
+ const manifest: GenerativeUIManifest = {
15
+ catalogId: "test/schema@1",
16
+ components: {
17
+ Text: {
18
+ description: "Shows text",
19
+ props: {
20
+ type: "object",
21
+ properties: {
22
+ text: { type: "string", description: "The text" },
23
+ size: { enum: ["sm", "md"] },
24
+ },
25
+ required: ["text"],
26
+ },
27
+ },
28
+ Button: {
29
+ description: "A button",
30
+ props: { type: "object", properties: { label: { type: "string" } } },
31
+ events: { onClick: { description: "Action" } },
32
+ },
33
+ },
34
+ functions: {
35
+ formatCurrency: {
36
+ description: "Formats money",
37
+ parameters: { type: "object", description: "{value: number}" },
38
+ },
39
+ },
40
+ targets: [{ id: "chat", kind: "chat" }],
41
+ surfaces: {},
42
+ };
43
+
44
+ const settings = (
45
+ notation: GenerativeUISchemaSettings["notation"],
46
+ ): GenerativeUISchemaSettings => ({
47
+ notation,
48
+ propDescriptions: true,
49
+ commonProps: true,
50
+ });
51
+
52
+ describe("renderGenerativeUISchema", () => {
53
+ it("writes the lines schema that ships by default", () => {
54
+ expect(
55
+ renderGenerativeUISchema(
56
+ manifest,
57
+ defaultGenerativeUIPromptSpec().schema.markdown,
58
+ ),
59
+ ).toBe(renderGenerativeUISchema(manifest, settings("lines")));
60
+ });
61
+
62
+ it.each(["compact", "json-schema", "ts-signature", "lines"] as const)(
63
+ "covers every component and prop in %s notation",
64
+ (notation) => {
65
+ const text = renderGenerativeUISchema(manifest, settings(notation));
66
+ expect(schemaCoverage(manifest, text).missing).toEqual([]);
67
+ },
68
+ );
69
+
70
+ it("writes one signature line per component, with events", () => {
71
+ const text = renderGenerativeUISchema(manifest, settings("ts-signature"));
72
+ expect(text).toContain(
73
+ '- Text(text: string // The text, size?: "sm" | "md"): Shows text',
74
+ );
75
+ expect(text).toContain(" events: onClick(Action)");
76
+ expect(text).toContain("- formatCurrency{value: number}: Formats money");
77
+ });
78
+
79
+ it("separates a function name from parameters that are not an object", () => {
80
+ const withCalls: GenerativeUIManifest = {
81
+ ...manifest,
82
+ functions: {
83
+ clearCart: { parameters: { type: "object", properties: {} } },
84
+ setVolume: { parameters: { type: "number" } },
85
+ },
86
+ };
87
+ for (const notation of ["lines", "ts-signature"] as const) {
88
+ const text = renderGenerativeUISchema(withCalls, settings(notation));
89
+ expect(text).toContain("clearCart{}");
90
+ expect(text).toContain("setVolume(number)");
91
+ }
92
+ });
93
+
94
+ it("keeps the quotes of enum values that would read as a type or a number", () => {
95
+ const text = renderGenerativeUISchema(
96
+ {
97
+ ...manifest,
98
+ components: {
99
+ Icon: {
100
+ props: {
101
+ type: "object",
102
+ properties: {
103
+ size: { anyOf: [{ enum: ["sm", "md"] }, { type: "number" }] },
104
+ format: { enum: ["number", "currency"] },
105
+ level: { enum: ["1", "2"] },
106
+ tone: { enum: ["calm", "loud"] },
107
+ stringFlags: { enum: ["true", "false"] },
108
+ booleanFlags: { enum: [true, false] },
109
+ note: {
110
+ type: "string",
111
+ description: "First line\nIcon: not a component",
112
+ },
113
+ },
114
+ },
115
+ },
116
+ },
117
+ },
118
+ settings("lines"),
119
+ );
120
+ expect(text).toContain(' size: "sm"|"md"|number');
121
+ expect(text).toContain(' format: "number"|"currency"');
122
+ expect(text).toContain(' level: "1"|"2"');
123
+ expect(text).toContain(" tone: calm|loud");
124
+ expect(text).toContain(' stringFlags: "true"|"false"');
125
+ expect(text).toContain(" booleanFlags: true|false");
126
+ expect(text).toContain(" note: string - First line Icon: not a component");
127
+ });
128
+
129
+ it("writes the status of a deleted or failed surface in signature notation", () => {
130
+ const text = renderGenerativeUISchema(
131
+ {
132
+ ...manifest,
133
+ surfaces: {
134
+ old: { target: "chat", status: "deleted" },
135
+ bad: { target: "chat", status: "failed" },
136
+ },
137
+ },
138
+ settings("ts-signature"),
139
+ );
140
+ expect(text).toContain("- old (target chat) status: deleted");
141
+ expect(text).toContain("- bad (target chat) status: failed");
142
+ });
143
+
144
+ it("writes lines: one line per prop, bare enums, required marked *, events as action props", () => {
145
+ const text = renderGenerativeUISchema(manifest, settings("lines"));
146
+ expect(text).toContain(
147
+ "Text: Shows text\n text*: string - The text\n size: sm|md",
148
+ );
149
+ expect(text).toContain(
150
+ "Button: A button\n label: string\n onClick: action - Action",
151
+ );
152
+ expect(text).toContain("formatCurrency{value: number}: Formats money");
153
+ expect(text).not.toContain('\\"');
154
+ });
155
+
156
+ it("writes slots as componentId and childList props in lines notation", () => {
157
+ const withSlots: GenerativeUIManifest = {
158
+ ...manifest,
159
+ components: {
160
+ Card: {
161
+ props: { type: "object", properties: {} },
162
+ slots: { child: "single", children: "multiple" },
163
+ },
164
+ },
165
+ };
166
+ const text = renderGenerativeUISchema(withSlots, settings("lines"));
167
+ expect(text).toContain("Card\n child: componentId\n children: childList");
168
+ expect(text).not.toContain("slots");
169
+ });
170
+
171
+ it("leaves the prop descriptions out on request", () => {
172
+ for (const notation of [
173
+ "compact",
174
+ "json-schema",
175
+ "ts-signature",
176
+ "lines",
177
+ ] as const) {
178
+ const text = renderGenerativeUISchema(manifest, {
179
+ ...settings(notation),
180
+ propDescriptions: false,
181
+ });
182
+ expect(text).not.toContain("The text");
183
+ expect(text).toContain("Shows text");
184
+ }
185
+ });
186
+ });
187
+
188
+ describe("renderGenerativeUIComponentList", () => {
189
+ it("writes each notation for the tool guide and covers the catalog", () => {
190
+ for (const notation of [
191
+ "compact",
192
+ "json-schema",
193
+ "ts-signature",
194
+ "lines",
195
+ ] as const) {
196
+ const text = renderGenerativeUIComponentList(
197
+ manifest.components,
198
+ settings(notation),
199
+ );
200
+ expect(schemaCoverage(manifest, text).missing).toEqual([]);
201
+ }
202
+ });
203
+ });
204
+
205
+ describe("applyDescriptionOverrides", () => {
206
+ it("replaces only the named descriptions and reports unknown keys", () => {
207
+ const { manifest: next, unknown } = applyDescriptionOverrides(manifest, {
208
+ Text: "Prose in a surface",
209
+ "Text.size": "How big",
210
+ Nope: "x",
211
+ "Text.nope": "y",
212
+ });
213
+ expect(next.components.Text.description).toBe("Prose in a surface");
214
+ expect(next.components.Text.props.properties).toMatchObject({
215
+ size: { description: "How big" },
216
+ text: { description: "The text" },
217
+ });
218
+ expect(next.components.Button).toEqual(manifest.components.Button);
219
+ expect(unknown).toEqual(["Nope", "Text.nope"]);
220
+ // The input is not changed.
221
+ expect(manifest.components.Text.description).toBe("Shows text");
222
+ });
223
+
224
+ it("runs without a global structuredClone (Hermes has none)", () => {
225
+ const saved = Object.getOwnPropertyDescriptor(
226
+ globalThis,
227
+ "structuredClone",
228
+ );
229
+ delete (globalThis as { structuredClone?: unknown }).structuredClone;
230
+ try {
231
+ const { manifest: next } = applyDescriptionOverrides(manifest, {
232
+ Text: "Prose in a surface",
233
+ });
234
+ expect(next.components.Text.description).toBe("Prose in a surface");
235
+ expect(manifest.components.Text.description).toBe("Shows text");
236
+ } finally {
237
+ if (saved) Object.defineProperty(globalThis, "structuredClone", saved);
238
+ }
239
+ });
240
+
241
+ it("keeps defaults that JSON cannot hold, without a global structuredClone", () => {
242
+ const saved = Object.getOwnPropertyDescriptor(
243
+ globalThis,
244
+ "structuredClone",
245
+ );
246
+ delete (globalThis as { structuredClone?: unknown }).structuredClone;
247
+ try {
248
+ expect(typeof globalThis.structuredClone).toBe("undefined");
249
+ const since = new Date(0);
250
+ const limits = {
251
+ description: "Limits",
252
+ props: {
253
+ type: "object",
254
+ properties: {
255
+ max: { type: "number", default: Number.POSITIVE_INFINITY },
256
+ min: { type: "number", default: Number.NaN },
257
+ since: { type: "string", default: since },
258
+ gone: { default: undefined },
259
+ },
260
+ },
261
+ };
262
+ const input = { components: { Limits: limits } };
263
+ const { manifest: next } = applyDescriptionOverrides(input, {
264
+ "Limits.max": "Upper bound",
265
+ });
266
+ const properties = next.components.Limits.props.properties as Record<
267
+ string,
268
+ Record<string, unknown>
269
+ >;
270
+ expect(properties.max).toEqual({
271
+ type: "number",
272
+ default: Number.POSITIVE_INFINITY,
273
+ description: "Upper bound",
274
+ });
275
+ expect(properties.min.default).toBeNaN();
276
+ expect(properties.since.default).toBeInstanceOf(Date);
277
+ expect(properties.since.default).not.toBe(since);
278
+ expect("default" in properties.gone).toBe(true);
279
+ // The copy shares no object with the input.
280
+ expect(next.components.Limits).not.toBe(limits);
281
+ expect(next.components.Limits.props).not.toBe(limits.props);
282
+ expect(properties.max).not.toBe(limits.props.properties.max);
283
+ expect(limits.props.properties.max).not.toHaveProperty("description");
284
+ } finally {
285
+ if (saved) Object.defineProperty(globalThis, "structuredClone", saved);
286
+ }
287
+ });
288
+
289
+ it("does not import a value from @ag-ui/client", () => {
290
+ // schema-render is reachable from the @copilotkit/shared root entry.
291
+ const source = readFileSync(
292
+ resolve(__dirname, "../generative-ui/schema-render.ts"),
293
+ "utf8",
294
+ );
295
+ expect(source).not.toMatch(
296
+ /^import\s+\{[^}]*\}\s+from\s+"@ag-ui\/client"/m,
297
+ );
298
+ });
299
+ });
300
+
301
+ describe("applyDescriptionOverrides with inherited keys", () => {
302
+ it("treats __proto__ as unknown and never touches Object.prototype", () => {
303
+ const { unknown } = applyDescriptionOverrides(manifest, {
304
+ __proto__: "polluted",
305
+ "Text.__proto__": "polluted",
306
+ "Text.constructor": "polluted",
307
+ } as Record<string, string>);
308
+ expect(({} as { description?: string }).description).toBeUndefined();
309
+ expect(unknown).toEqual(
310
+ expect.arrayContaining(["Text.__proto__", "Text.constructor"]),
311
+ );
312
+ });
313
+ });
314
+
315
+ describe("schemaCoverage", () => {
316
+ it("reports a prop that the text leaves out", () => {
317
+ const text = renderGenerativeUISchema(
318
+ manifest,
319
+ settings("ts-signature"),
320
+ ).replace("size", "");
321
+ expect(schemaCoverage(manifest, text).missing).toEqual(["Text.size"]);
322
+ });
323
+ });