@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
@@ -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) &&
@@ -201,7 +201,8 @@ function isSurfaceEntry(value: unknown): value is GenerativeUISurfaceSummary {
201
201
  (value.rejected === undefined || isRejectionList(value.rejected)) &&
202
202
  (value.status === undefined ||
203
203
  value.status === "deleted" ||
204
- value.status === "failed")
204
+ value.status === "failed") &&
205
+ (value.a2uiSourceVersion === undefined || value.a2uiSourceVersion === "0.9")
205
206
  );
206
207
  }
207
208
 
@@ -222,7 +223,7 @@ function isExtensions(value: unknown): value is Extensions {
222
223
  function isEnvelope(value: unknown): value is CopilotKitUIEnvelope {
223
224
  return (
224
225
  isRecord(value) &&
225
- isCapabilities(value["v1.0"]) &&
226
+ isCapabilities(value["1.0"]) &&
226
227
  isRecord(value.metadata) &&
227
228
  isExtensions(value.metadata.extensions)
228
229
  );
@@ -282,8 +283,9 @@ export function readCopilotKitUIEnvelope(forwardedProps: unknown) {
282
283
  * ```
283
284
  */
284
285
  export function envelopeToManifest(envelope: CopilotKitUIEnvelope) {
285
- const { supportedCatalogIds, inlineCatalogs } = envelope["v1.0"];
286
- const catalogId = supportedCatalogIds[0];
286
+ const { supportedCatalogIds, inlineCatalogs } = envelope["1.0"];
287
+ // `readCopilotKitUIEnvelope` only accepts a non-empty `supportedCatalogIds`.
288
+ const catalogId = supportedCatalogIds[0]!;
287
289
  const catalog = inlineCatalogs?.find(
288
290
  (entry) => entry.catalogId === catalogId,
289
291
  );
@@ -1,7 +1,17 @@
1
1
  import { isA2UIBasicFunction } from "./generative-ui/basic-functions";
2
2
  import { A2UI_CHILD_LIST_REF } from "./generative-ui/child-refs";
3
- import { GENERATIVE_UI_AGENT_FUNCTION_CALLS } from "./generative-ui/types";
4
3
  import type { GenerativeUIManifest } from "./generative-ui/types";
4
+ import {
5
+ defaultGenerativeUIPromptSpec,
6
+ GUIDE_COMPONENTS,
7
+ generativeUIPromptFeatures,
8
+ selectPromptItems,
9
+ } from "./generative-ui/prompt-spec";
10
+ import type { GenerativeUIPromptSpec } from "./generative-ui/prompt-spec";
11
+ export {
12
+ GENERATIVE_UI_MARKDOWN_WHEN_TO_SHOW,
13
+ GENERATIVE_UI_WHEN_TO_SHOW,
14
+ } from "./generative-ui/prompt-spec";
5
15
  /**
6
16
  * Default A2UI generation and design guideline prompts.
7
17
  *
@@ -118,14 +128,6 @@ Design principles:
118
128
 
119
129
  Use the SAME surfaceId as the main surface. Match action names to button action event names.`;
120
130
 
121
- /**
122
- * When UI helps the user, for both transports: a light nudge to reach for UI
123
- * where it conveys the answer better than prose, and to stay in prose
124
- * otherwise.
125
- */
126
- export const GENERATIVE_UI_WHEN_TO_SHOW =
127
- "Show UI when it conveys the answer better than prose: to illustrate a concept (a diagram, a chart of how something changes), to compare options side by side, to let the user explore or adjust values, or to collect input. A small, focused surface next to your explanation often lands better than a long description. Reply in prose alone for a quick fact, a short answer, or conversation, and never add UI only as decoration.";
128
-
129
131
  /** Description of the context entry that carries `GENERATIVE_UI_MARKDOWN_GUIDELINES`. */
130
132
  export const GENERATIVE_UI_MARKDOWN_GUIDELINES_DESCRIPTION =
131
133
  "Generative UI markdown guide: how to write UI surfaces inside ```a2ui code fences in a normal markdown reply.";
@@ -154,6 +156,11 @@ export interface GenerativeUIGuideFeatures {
154
156
  templates: boolean;
155
157
  /** A component has a "checks" prop: validation rules on inputs. */
156
158
  checks: boolean;
159
+ /**
160
+ * The component names of the catalog. A guide line that names a standard
161
+ * component missing from it is left out. Unset keeps every line.
162
+ */
163
+ components?: readonly string[];
157
164
  }
158
165
 
159
166
  /** Every optional rule group. Use it when the manifest is not known. */
@@ -190,6 +197,7 @@ export function generativeUIGuideFeatures(
190
197
  return Object.values(node).some(hasChildList);
191
198
  };
192
199
  return {
200
+ components: Object.keys(manifest.components),
193
201
  // App functions only: the built-in ones are always there and have
194
202
  // their own rules.
195
203
  functions: Object.keys(manifest.functions).some(
@@ -212,44 +220,22 @@ export function generativeUIGuideFeatures(
212
220
  };
213
221
  }
214
222
 
215
- /** The first rules of every markdown guideline, before the optional groups. */
216
- const MARKDOWN_BASE_RULES = [
217
- "Write explanations as normal markdown prose outside the fences.",
218
- "Open a fence with ```a2ui to show the surface in the chat, at the place of the fence.",
219
- 'Open a fence with ```a2ui target=<id> to show the surface in a named target. Use only target ids from the schema. When a target has "components", its surfaces can use only those components.',
220
- "Inside a fence, write one JSON object per line and nothing else. No comments, no trailing commas, no pretty-printing.",
221
- "Keep each operation whole on its line.",
222
- 'Give every operation "version":"v1.0".',
223
- `Start a surface with one createSurface. Put all the initial data in "dataModel" and the "root" component in "components". Then write the children in updateComponents lines, so that they show while you write:
224
- \`\`\`a2ui
225
- {"version":"v1.0","createSurface":{"surfaceId":"plan-picker","dataModel":{ ...initial data... },"components":[{"id":"root","component":"<Name>","children":["seats","pick"]}]}}
226
- {"version":"v1.0","updateComponents":{"surfaceId":"plan-picker","components":[ ...the children... ]}}
227
- \`\`\``,
228
- 'Keep "dataModel" flat: top-level keys such as "seats" or "form", never one wrapper object around everything. Check that every { and [ you open in a line is closed.',
229
- 'Every surface renders from the component with id "root". Make every other component reachable from "root" through slots.',
230
- "Use unique ids. Do not make cycles. A component cannot be its own child.",
231
- 'Write a component as one flat object: {"id":"title","component":"<Name>","text":"Hello"}.',
232
- 'Put the component name in "component" (never "type"). Put props next to it, never inside a "props" object.',
233
- 'A component may take "accessibility":{"label":"<1 to 3 words>","description":"<what it does>"} for screen readers: on the component it describes, when nothing visible names it. Not on every component, and "live":"polite" only on text that changes by itself.',
234
- 'Use only the components, props, events, and slots in the schema. A component with "includesCommonProps" also takes every prop in "commonProps".',
235
- 'Give a prop a literal value, or bind it to the data model with {"@path":"/x"}. Never write {"path":"/x"} as a binding.',
236
- 'A prop can also be a function value that updates with the data: {"@call":"formatCurrency","args":{"value":{"@path":"/total"},"currency":"EUR"}}. Use only the functions under "functions" in the schema. Write a literal when the value never changes.',
237
- 'formatString interpolates ${...}: {"@call":"formatString","args":{"value":"${/qty} × ${formatCurrency(value: /price, currency: \'EUR\')}"}}. Inside ${...}, a path has no quotes, a string has single quotes, and a function takes named args.',
238
- '${...} is evaluated only in the value of formatString and in the item of series; in other strings it stays literal text. Inside formatString, ${...} does not support operators. For arithmetic use calc, with the values as named args: {"@call":"calc","args":{"expression":"seats * 29 * (annual ? 0.8 : 1)","seats":{"@path":"/seats"},"annual":{"@path":"/annual"}}}. Inside formatString: ${formatCurrency(value: calc(expression: \'seats * 29\', seats: /seats), currency: \'USD\')}. The UI then follows the user\'s input with no round trip.',
239
- 'For a computed list (chart data, template items) use series. Its description under "functions" in the schema gives the rules and an example. Bind the "data" of a Chart or the "items" of a List to it; a template path stays a literal path.',
240
- 'Bind a writable prop to let the user edit it: "value":{"@path":"/form/email"}. The user\'s input goes to that path.',
241
- 'To change data, write updateDataModel with a "path" and a "value": {"version":"v1.0","updateDataModel":{"surfaceId":"plan-picker","path":"/seats","value":12}}. Always give "value".',
242
- 'Set "value":null to delete the key at "path".',
243
- ];
244
-
245
- /** The last rules of every markdown guideline, after the optional groups. */
246
- const MARKDOWN_CLOSING_RULES = [
247
- 'The schema lists the surfaces that already exist under "surfaces". "dataModel" holds the values that the user entered: read them, and do not write those paths. "rejected" lists operations that the client dropped: send corrected operations in a new fence for that surfaceId. "status":"deleted" means the surface is gone: never use its id again. "status":"failed" means its createSurface was rejected: send a corrected createSurface with that id.',
248
- "Never make a surface that is only prose. Write headings, paragraphs, lists of text, intros, and summaries as markdown outside the fences, also between two fences.",
249
- "Put in a fence only what markdown cannot show: charts, tables, maps, images, badges, inputs, buttons, cards with controls.",
250
- "Use Card only for an interactive panel (controls, a form, a configurator). Put everything else in a plain layout component.",
251
- "Never wrap the whole reply in a fence.",
252
- ];
223
+ /**
224
+ * Whether a guide line names only standard components (`GUIDE_COMPONENTS`,
225
+ * also in the plural) that the catalog has. With no catalog, every line fits.
226
+ */
227
+ function namesOnlyCatalogComponents(catalog: readonly string[] | undefined) {
228
+ if (!catalog) return () => true;
229
+ const has = new Set(catalog);
230
+ return (line: string) =>
231
+ (line.match(/\b[A-Z][A-Za-z0-9]*\b/g) ?? []).every((word) => {
232
+ const name =
233
+ !GUIDE_COMPONENTS.has(word) && word.endsWith("s")
234
+ ? word.slice(0, -1)
235
+ : word;
236
+ return !GUIDE_COMPONENTS.has(name) || has.has(name);
237
+ });
238
+ }
253
239
 
254
240
  /**
255
241
  * Builds the markdown-transport guideline. The model writes A2UI v1.0
@@ -258,60 +244,25 @@ const MARKDOWN_CLOSING_RULES = [
258
244
  * none of them, so the guideline stays small.
259
245
  *
260
246
  * @param features - The optional rule groups to include. Defaults to all.
247
+ * @param spec - The wording. Defaults to the prompts that ship.
261
248
  * @returns The guideline text, one rule per line.
262
249
  */
263
250
  export function buildGenerativeUIMarkdownGuidelines(
264
251
  features: GenerativeUIGuideFeatures = ALL_GENERATIVE_UI_GUIDE_FEATURES,
252
+ spec: GenerativeUIPromptSpec = defaultGenerativeUIPromptSpec(),
265
253
  ) {
266
- const { functions, events, templates, checks } = features;
267
- const rules = [...MARKDOWN_BASE_RULES];
268
- if (events) {
269
- rules.push(
270
- 'Give an event prop an object: {"event":{"name":"<name>","userMessage":"<text>","context":{...}}} or {"functionCall":{"@call":"<function>","args":{...}}}. Never a flat {"event":"<name>"}.',
271
- functions
272
- ? 'Use {"functionCall": ...} to run a function in the browser when the user clicks: an app function from the schema, or openUrl: {"functionCall":{"@call":"openUrl","args":{"url":"https://example.com"}}}. You are not told about the call.'
273
- : 'Use {"functionCall": ...} to open a URL when the user clicks: {"functionCall":{"@call":"openUrl","args":{"url":"https://example.com"}}}. You are not told about the call.',
274
- 'Use {"event": ...} to send the interaction back to you as a user message. Put the text of that message in "userMessage": {"event":{"name":"choose","userMessage":"Show me the Team plan"}}. "userMessage" is plain text: ${...} is not interpolated in it; put values in "context".',
275
- 'To send input values with an event, bind them in the context: "context":{"email":{"@path":"/form/email"}}.',
276
- "A button or other event prop without an event or functionCall does nothing.",
277
- );
278
- }
279
- if (checks) {
280
- rules.push(
281
- 'Validate an input with "checks": [{"condition":{"@call":"email","args":{"value":{"@path":"/form/email"}}},"message":"Enter a valid email"}]. The check functions are required, regex, length, numeric and email; a condition can also be a boolean {"@path"}. A failed check shows the message under the input and disables a Button that has the same checks.',
282
- );
283
- }
284
- rules.push(
285
- 'A prop typed componentId takes the id of another component, and a childList takes ids ["a","b"]: "child":"card", "children":["a","b"], "tabs":[{"title":"Specs","child":"specs"}].',
286
- );
287
- if (templates) {
288
- rules.push(
289
- 'To repeat a component for each item of a list, give a childList a template: "children":{"componentId":"row","path":"/items"}.',
290
- 'Inside a template, paths are relative to the item ("name", not "/name").',
291
- 'Inside a template, {"@call":"@index"} gives the position of the item, from 0. To count from 1, write {"@call":"@index","args":{"offset":1}}.',
292
- );
293
- }
294
- rules.push(
295
- "Updating a component replaces all of its props. Send every prop again.",
296
- "To change a surface in this reply, write another fence with the same surfaceId. Do not send createSurface again. The surface changes where it already is. A surface in a target can also be changed from a later reply; a chat surface cannot, because the chat is a transcript: a later reply with the same surfaceId makes a new surface.",
297
- "Use a new surfaceId for a different view. Never use a surfaceId again, also after the surface is deleted.",
298
- );
299
- if (functions && GENERATIVE_UI_AGENT_FUNCTION_CALLS) {
300
- rules.push(
301
- 'To run an app function now, with no click, write a callRendererFunction line in a fence: {"version":"v1.0","callRendererFunction":{"functionCallId":"<unique id>","callFunction":{"@call":"<function>","args":{...}}}}. It needs no surface.',
302
- 'Give every callRendererFunction a new functionCallId. Call only a function from the schema with "callers": "UI or agent" or "agent only"; a function without "callers" is for the UI only. A function with "callers": "agent only" is only for callRendererFunction: do not bind an event to it.',
303
- 'The result of a callRendererFunction comes back to you as a developer message: {"version":"v1.0","rendererFunctionResponse":{"functionCallId":"<id>","value":...}}. If the call failed, it has "error" in place of "value". Then you get a new turn.',
304
- "Do not guess the result of a callRendererFunction. Wait for the developer message.",
305
- );
306
- }
307
- rules.push(...MARKDOWN_CLOSING_RULES);
308
- return `You can show interactive UI in your reply. Write A2UI operations inside a fenced code block tagged a2ui.
309
-
310
- ${GENERATIVE_UI_WHEN_TO_SHOW}
311
-
312
- RULES
313
- ${rules.map((rule) => `- ${rule}`).join("\n")}
314
- `;
254
+ const { intro, rules } = spec.markdown;
255
+ const fits = namesOnlyCatalogComponents(features.components);
256
+ const selected = selectPromptItems(
257
+ rules,
258
+ generativeUIPromptFeatures(features),
259
+ ).filter(fits);
260
+ const whenToShow = spec.markdown.whenToShow
261
+ .split("\n")
262
+ .filter(fits)
263
+ .join("\n");
264
+ const when = whenToShow ? `${whenToShow}\n\n` : "";
265
+ return `${intro}\n\n${when}RULES\n${selected.map((rule) => `- ${rule}`).join("\n")}\n`;
315
266
  }
316
267
 
317
268
  /**
@@ -4,6 +4,7 @@ import {
4
4
  exceedsMaxSize,
5
5
  matchesAcceptFilter,
6
6
  getSourceUrl,
7
+ generateVideoThumbnail,
7
8
  } from "../utils";
8
9
 
9
10
  // ---------------------------------------------------------------------------
@@ -212,3 +213,24 @@ describe("getSourceUrl", () => {
212
213
  expect(getSourceUrl({ type: "file", value: "file-abc123" })).toBe("");
213
214
  });
214
215
  });
216
+
217
+ // ---------------------------------------------------------------------------
218
+ // generateVideoThumbnail
219
+ // ---------------------------------------------------------------------------
220
+
221
+ describe("generateVideoThumbnail", () => {
222
+ afterEach(() => {
223
+ vi.unstubAllGlobals();
224
+ });
225
+
226
+ it("returns undefined for a file that is not a Blob, such as a React Native file", async () => {
227
+ vi.stubGlobal("document", { createElement: () => ({}) });
228
+ const nativeVideo = {
229
+ name: "clip.mp4",
230
+ size: 1,
231
+ type: "video/mp4",
232
+ } as unknown as File;
233
+
234
+ await expect(generateVideoThumbnail(nativeVideo)).resolves.toBeUndefined();
235
+ });
236
+ });
@@ -49,9 +49,7 @@ export interface AttachmentsConfig {
49
49
  * called concurrently unless you raise this. Files past the limit wait for a
50
50
  * free slot; `Infinity` lifts it. The limit covers everything in flight, so
51
51
  * two selections dropped or pasted at once share the slots rather than each
52
- * taking the full number.
53
- * Honored by the React `useAttachments` hook — the Vue and Angular bindings
54
- * still upload serially.
52
+ * taking the full number. React, Vue and Angular all honor it.
55
53
  */
56
54
  maxConcurrentUploads?: number;
57
55
  /** Custom upload handler. Return an InputContentSource with optional metadata. */
@@ -54,19 +54,37 @@ export function readFileAsBase64(file: File): Promise<string> {
54
54
 
55
55
  /**
56
56
  * Generate a thumbnail data URL from a video file by capturing a frame near the start (at 0.1s).
57
- * Returns undefined if thumbnail generation fails or if called outside a browser environment.
57
+ * Returns undefined if thumbnail generation fails, if called outside a browser environment,
58
+ * or if `file` is not a `Blob` the browser can read (React Native for web passes a
59
+ * native file's description). Never rejects.
58
60
  */
59
61
  export function generateVideoThumbnail(
60
62
  file: File,
61
63
  ): Promise<string | undefined> {
62
- if (typeof document === "undefined") {
64
+ if (
65
+ typeof document === "undefined" ||
66
+ typeof Blob === "undefined" ||
67
+ !(file instanceof Blob)
68
+ ) {
63
69
  return Promise.resolve(undefined);
64
70
  }
65
71
  return new Promise((resolve) => {
66
72
  let resolved = false;
67
- const video = document.createElement("video");
68
- const canvas = document.createElement("canvas");
69
- const url = URL.createObjectURL(file);
73
+ let url: string;
74
+ let video: HTMLVideoElement;
75
+ let canvas: HTMLCanvasElement;
76
+ try {
77
+ video = document.createElement("video");
78
+ canvas = document.createElement("canvas");
79
+ url = URL.createObjectURL(file);
80
+ } catch (error) {
81
+ console.warn(
82
+ `[CopilotKit] generateVideoThumbnail: could not read file "${file.name}"`,
83
+ error,
84
+ );
85
+ resolve(undefined);
86
+ return;
87
+ }
70
88
 
71
89
  const cleanup = (result: string | undefined) => {
72
90
  if (resolved) return;
@@ -136,6 +136,22 @@ export function createRunEventFinalizer(): RunEventFinalizer {
136
136
  terminalEventObserved = true;
137
137
  clearOpen();
138
138
  break;
139
+ case EventType.TEXT_MESSAGE_CONTENT:
140
+ case EventType.TEXT_MESSAGE_CHUNK:
141
+ case EventType.TOOL_CALL_ARGS:
142
+ case EventType.TOOL_CALL_CHUNK:
143
+ case EventType.STATE_SNAPSHOT:
144
+ case EventType.STATE_DELTA:
145
+ case EventType.MESSAGES_SNAPSHOT:
146
+ case EventType.ACTIVITY_SNAPSHOT:
147
+ case EventType.ACTIVITY_DELTA:
148
+ case EventType.RAW:
149
+ case EventType.CUSTOM:
150
+ case EventType.STEP_STARTED:
151
+ case EventType.STEP_FINISHED:
152
+ case EventType.REASONING_MESSAGE_CONTENT:
153
+ case EventType.REASONING_MESSAGE_CHUNK:
154
+ case EventType.REASONING_ENCRYPTED_VALUE:
139
155
  default:
140
156
  break;
141
157
  }