@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
@@ -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
+ });
@@ -3,26 +3,26 @@ import { z } from "zod";
3
3
  import * as v from "valibot";
4
4
  import { toStandardJsonSchema } from "@valibot/to-json-schema";
5
5
  import { type } from "arktype";
6
- import { zodToJsonSchema } from "zod-to-json-schema";
7
- import { schemaToJsonSchema } from "../standard-schema";
6
+ import { schemaToJsonSchema, ɵanySchema } from "../standard-schema";
8
7
  import type { StandardSchemaV1 } from "@standard-schema/spec";
9
8
 
10
9
  describe("schemaToJsonSchema", () => {
11
- describe("Zod schemas (via injected zodToJsonSchema)", () => {
10
+ describe("Zod 4 schemas (native ~standard.jsonSchema)", () => {
12
11
  it("converts a simple zod object schema", () => {
13
12
  const schema = z.object({
14
- name: z.string(),
13
+ name: z.string().describe("Full name"),
15
14
  age: z.number(),
16
15
  });
17
16
 
18
- const result = schemaToJsonSchema(schema, { zodToJsonSchema });
19
-
20
- expect(result).toHaveProperty("type", "object");
21
- expect(result).toHaveProperty("properties.name.type", "string");
22
- expect(result).toHaveProperty("properties.age.type", "number");
23
- expect(result).toHaveProperty("required");
24
- expect(result.required).toContain("name");
25
- expect(result.required).toContain("age");
17
+ expect(schemaToJsonSchema(schema)).toEqual({
18
+ $schema: "http://json-schema.org/draft-07/schema#",
19
+ type: "object",
20
+ properties: {
21
+ name: { type: "string", description: "Full name" },
22
+ age: { type: "number" },
23
+ },
24
+ required: ["name", "age"],
25
+ });
26
26
  });
27
27
 
28
28
  it("converts a zod schema with optional fields", () => {
@@ -31,12 +31,27 @@ describe("schemaToJsonSchema", () => {
31
31
  units: z.enum(["celsius", "fahrenheit"]).optional(),
32
32
  });
33
33
 
34
- const result = schemaToJsonSchema(schema, { zodToJsonSchema });
34
+ const result = schemaToJsonSchema(schema);
35
35
 
36
36
  expect(result).toHaveProperty("type", "object");
37
37
  expect(result).toHaveProperty("properties.city.type", "string");
38
- expect(result.required).toContain("city");
39
- expect(result.required).not.toContain("units");
38
+ expect(result).toHaveProperty("properties.units.enum", [
39
+ "celsius",
40
+ "fahrenheit",
41
+ ]);
42
+ expect(result.required).toEqual(["city"]);
43
+ });
44
+
45
+ it("describes the input side, so fields with defaults are optional", () => {
46
+ const schema = z.object({
47
+ query: z.string(),
48
+ page: z.number().default(1),
49
+ });
50
+
51
+ const result = schemaToJsonSchema(schema);
52
+
53
+ expect(result.required).toEqual(["query"]);
54
+ expect(result).toHaveProperty("properties.page.default", 1);
40
55
  });
41
56
 
42
57
  it("has vendor 'zod' on ~standard", () => {
@@ -131,10 +146,9 @@ describe("schemaToJsonSchema", () => {
131
146
  expect(result.required).toContain("age");
132
147
  });
133
148
 
134
- it("converts an arktype schema without needing zodToJsonSchema fallback", () => {
149
+ it("converts a single-field arktype schema", () => {
135
150
  const schema = type({ query: "string" });
136
151
 
137
- // No zodToJsonSchema option needed — arktype uses Standard JSON Schema V1 natively
138
152
  const result = schemaToJsonSchema(schema);
139
153
 
140
154
  expect(result).toHaveProperty("type", "object");
@@ -179,38 +193,9 @@ describe("schemaToJsonSchema", () => {
179
193
  $target: "draft-07",
180
194
  });
181
195
  });
182
-
183
- it("prefers ~standard.jsonSchema over zodToJsonSchema fallback", () => {
184
- const mockSchema = {
185
- "~standard": {
186
- version: 1,
187
- vendor: "zod",
188
- validate: (value: unknown) => ({ value }),
189
- jsonSchema: {
190
- input: () => ({
191
- type: "object",
192
- properties: { fromJsonSchema: { type: "boolean" } },
193
- }),
194
- },
195
- },
196
- };
197
-
198
- const zodFallback = () => ({
199
- type: "object",
200
- properties: { fromZodFallback: { type: "boolean" } },
201
- });
202
-
203
- const result = schemaToJsonSchema(mockSchema, {
204
- zodToJsonSchema: zodFallback,
205
- });
206
-
207
- // Should use ~standard.jsonSchema, not the zod fallback
208
- expect(result).toHaveProperty("properties.fromJsonSchema");
209
- expect(result).not.toHaveProperty("properties.fromZodFallback");
210
- });
211
196
  });
212
197
 
213
- describe("Zod v4 schemas (via toJSONSchema method)", () => {
198
+ describe("schemas exposing a toJSONSchema() method", () => {
214
199
  it("calls toJSONSchema() when the method exists on the schema", () => {
215
200
  const expectedOutput = {
216
201
  type: "object",
@@ -231,7 +216,7 @@ describe("schemaToJsonSchema", () => {
231
216
  expect(result).toEqual(expectedOutput);
232
217
  });
233
218
 
234
- it("uses toJSONSchema() even without zodToJsonSchema option", () => {
219
+ it("uses toJSONSchema() with no options", () => {
235
220
  const mockZod4Schema: StandardSchemaV1 = {
236
221
  "~standard": {
237
222
  version: 1,
@@ -249,32 +234,6 @@ describe("schemaToJsonSchema", () => {
249
234
  expect(result).toHaveProperty("properties.city.type", "string");
250
235
  });
251
236
 
252
- it("prefers toJSONSchema() over zodToJsonSchema fallback for Zod v4", () => {
253
- const mockZod4Schema: StandardSchemaV1 = {
254
- "~standard": {
255
- version: 1,
256
- vendor: "zod",
257
- validate: (value: unknown) => ({ value }),
258
- },
259
- toJSONSchema: () => ({
260
- type: "object",
261
- properties: { fromNative: { type: "boolean" } },
262
- }),
263
- } as any;
264
-
265
- const zodFallback = () => ({
266
- type: "object",
267
- properties: { fromFallback: { type: "boolean" } },
268
- });
269
-
270
- const result = schemaToJsonSchema(mockZod4Schema, {
271
- zodToJsonSchema: zodFallback,
272
- });
273
-
274
- expect(result).toHaveProperty("properties.fromNative");
275
- expect(result).not.toHaveProperty("properties.fromFallback");
276
- });
277
-
278
237
  it("prefers ~standard.jsonSchema over toJSONSchema()", () => {
279
238
  const mockSchema = {
280
239
  "~standard": {
@@ -303,7 +262,7 @@ describe("schemaToJsonSchema", () => {
303
262
  });
304
263
 
305
264
  describe("Error handling", () => {
306
- it("throws when schema has no jsonSchema support and no zodToJsonSchema", () => {
265
+ it("throws when schema has no jsonSchema support", () => {
307
266
  const mockSchema: StandardSchemaV1 = {
308
267
  "~standard": {
309
268
  version: 1,
@@ -318,42 +277,43 @@ describe("schemaToJsonSchema", () => {
318
277
  expect(() => schemaToJsonSchema(mockSchema)).toThrow(/unknown-lib/);
319
278
  });
320
279
 
321
- it("throws for non-zod vendor when zodToJsonSchema is not provided", () => {
322
- const mockSchema: StandardSchemaV1 = {
280
+ it("rejects a Zod 3 schema and names the supported Zod version", () => {
281
+ // Zod 3 implements Standard Schema validation only: no
282
+ // `~standard.jsonSchema` and no `toJSONSchema()` method.
283
+ const zod3Like: StandardSchemaV1 = {
323
284
  "~standard": {
324
285
  version: 1,
325
- vendor: "some-other-lib",
286
+ vendor: "zod",
326
287
  validate: (value: unknown) => ({ value }),
327
288
  },
328
289
  };
329
290
 
330
- expect(() => schemaToJsonSchema(mockSchema)).toThrow(
331
- /no zodToJsonSchema fallback/,
332
- );
291
+ expect(() => schemaToJsonSchema(zod3Like)).toThrow(/Zod 4\.2\+/);
333
292
  });
293
+ });
294
+ });
334
295
 
335
- it("uses zodToJsonSchema fallback for zod vendor schemas", () => {
336
- const mockZodSchema: StandardSchemaV1 = {
337
- "~standard": {
338
- version: 1,
339
- vendor: "zod",
340
- validate: (value: unknown) => ({ value }),
341
- },
342
- };
296
+ describe("ɵanySchema", () => {
297
+ it("identifies itself as a CopilotKit Standard Schema V1", () => {
298
+ expect(ɵanySchema["~standard"].version).toBe(1);
299
+ expect(ɵanySchema["~standard"].vendor).toBe("copilotkit");
300
+ });
343
301
 
344
- const fallback = () => ({
345
- type: "object",
346
- properties: { test: { type: "string" } },
347
- });
302
+ it("returns the value it was given, unchanged", async () => {
303
+ const args = { city: "Berlin", days: [1, 2] };
348
304
 
349
- const result = schemaToJsonSchema(mockZodSchema, {
350
- zodToJsonSchema: fallback,
351
- });
305
+ const result = await ɵanySchema["~standard"].validate(args);
352
306
 
353
- expect(result).toEqual({
354
- type: "object",
355
- properties: { test: { type: "string" } },
356
- });
357
- });
307
+ expect(result).toEqual({ value: { city: "Berlin", days: [1, 2] } });
358
308
  });
309
+
310
+ it.each([undefined, null, "", 0, false])(
311
+ "accepts %j without issues",
312
+ async (input) => {
313
+ const result = await ɵanySchema["~standard"].validate(input);
314
+
315
+ expect(result).toEqual({ value: input });
316
+ expect(result).not.toHaveProperty("issues");
317
+ },
318
+ );
359
319
  });
@@ -29,7 +29,7 @@ export const COPILOTKIT_UI_ENVELOPE_FORMAT = 3;
29
29
  /** What the client renders and calls, and how the model must write UI. */
30
30
  export interface CopilotKitUIEnvelope {
31
31
  /** The A2UI v1.0 renderer capabilities. */
32
- "v1.0": {
32
+ "1.0": {
33
33
  /**
34
34
  * The catalog that the client renders comes first, then the catalogs of
35
35
  * its `extends`. An operation can name any of them.
@@ -66,7 +66,7 @@ export interface CopilotKitUIEnvelope {
66
66
  }
67
67
 
68
68
  type InlineCatalog = NonNullable<
69
- CopilotKitUIEnvelope["v1.0"]["inlineCatalogs"]
69
+ CopilotKitUIEnvelope["1.0"]["inlineCatalogs"]
70
70
  >[number];
71
71
  type Extensions = CopilotKitUIEnvelope["metadata"]["extensions"];
72
72
 
@@ -149,7 +149,7 @@ function isInlineCatalog(value: unknown): value is InlineCatalog {
149
149
  );
150
150
  }
151
151
 
152
- function isCapabilities(value: unknown): value is CopilotKitUIEnvelope["v1.0"] {
152
+ function isCapabilities(value: unknown): value is CopilotKitUIEnvelope["1.0"] {
153
153
  return (
154
154
  isRecord(value) &&
155
155
  Array.isArray(value.supportedCatalogIds) &&
@@ -222,7 +222,7 @@ function isExtensions(value: unknown): value is Extensions {
222
222
  function isEnvelope(value: unknown): value is CopilotKitUIEnvelope {
223
223
  return (
224
224
  isRecord(value) &&
225
- isCapabilities(value["v1.0"]) &&
225
+ isCapabilities(value["1.0"]) &&
226
226
  isRecord(value.metadata) &&
227
227
  isExtensions(value.metadata.extensions)
228
228
  );
@@ -282,8 +282,9 @@ export function readCopilotKitUIEnvelope(forwardedProps: unknown) {
282
282
  * ```
283
283
  */
284
284
  export function envelopeToManifest(envelope: CopilotKitUIEnvelope) {
285
- const { supportedCatalogIds, inlineCatalogs } = envelope["v1.0"];
286
- const catalogId = supportedCatalogIds[0];
285
+ const { supportedCatalogIds, inlineCatalogs } = envelope["1.0"];
286
+ // `readCopilotKitUIEnvelope` only accepts a non-empty `supportedCatalogIds`.
287
+ const catalogId = supportedCatalogIds[0]!;
287
288
  const catalog = inlineCatalogs?.find(
288
289
  (entry) => entry.catalogId === catalogId,
289
290
  );