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

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
@@ -0,0 +1,67 @@
1
+ //#region src/generative-ui/thrown.ts
2
+ /**
3
+ * Sets `cause` as an own property. `new Error(message, { cause })` needs
4
+ * ES2022 error options, which an engine without them (the JavaScriptCore of
5
+ * iOS before 15, which React Native 0.70 can still run on) ignores without a
6
+ * word, so it is set by hand on every engine.
7
+ */
8
+ function withCause(error, cause) {
9
+ Object.defineProperty(error, "cause", {
10
+ value: cause,
11
+ writable: true,
12
+ configurable: true,
13
+ enumerable: false
14
+ });
15
+ return error;
16
+ }
17
+ /** The longest description of a thrown object's data. */
18
+ const MAX_DESCRIPTION = 200;
19
+ /**
20
+ * Reads what a thrown value says without letting the reading throw: a
21
+ * getter, a Proxy trap, a `toJSON` or a `toString` may throw too.
22
+ */
23
+ function attempt(read) {
24
+ try {
25
+ return read();
26
+ } catch {
27
+ return;
28
+ }
29
+ }
30
+ /** The `message` of a thrown object, when it is a non-empty string. */
31
+ function messageOf(value) {
32
+ if (typeof value !== "object" || value === null) return void 0;
33
+ const message = attempt(() => value.message);
34
+ return typeof message === "string" && message !== "" ? message : void 0;
35
+ }
36
+ /** A thrown value as text, for a value that is not an Error. */
37
+ function describeThrown(value) {
38
+ if (typeof value === "string") return JSON.stringify(value);
39
+ if (typeof value === "object" && value !== null) {
40
+ const json = attempt(() => JSON.stringify(value));
41
+ if (typeof json === "string") return json.length > MAX_DESCRIPTION ? `${json.slice(0, MAX_DESCRIPTION)}…` : json;
42
+ }
43
+ return attempt(() => String(value)) ?? attempt(() => Object.prototype.toString.call(value)) ?? typeof value;
44
+ }
45
+ /** An Error of this realm, or of another one (a frame, a VM context). */
46
+ function isError(value) {
47
+ if (attempt(() => value instanceof Error)) return true;
48
+ return attempt(() => Object.prototype.toString.call(value)) === "[object Error]" && typeof attempt(() => value.message) === "string";
49
+ }
50
+ /**
51
+ * The Error for any thrown value. Code may throw anything: a string, or a
52
+ * falsy value (`undefined`, `null`, `0`, `""`) that a boundary which keeps
53
+ * the thrown value and tests it for truth would take for "no error". An
54
+ * Error comes back as it is; a non-empty string, or the string `message`
55
+ * of a thrown object, becomes the message; any other value is described in
56
+ * the message. A value that is not an Error is kept as the `cause`. This
57
+ * never throws, whatever the value.
58
+ */
59
+ function toError(value) {
60
+ if (isError(value)) return value;
61
+ const message = typeof value === "string" && value !== "" ? value : messageOf(value) ?? `A value that is not an Error was thrown: ${describeThrown(value)}`;
62
+ return withCause(new Error(message), value);
63
+ }
64
+
65
+ //#endregion
66
+ export { toError, withCause };
67
+ //# sourceMappingURL=thrown.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"thrown.mjs","names":[],"sources":["../../src/generative-ui/thrown.ts"],"sourcesContent":["// Turns any thrown value into an Error, for the error boundaries of the\n// framework packages. Framework-free, and safe on Hermes.\n\n/**\n * Sets `cause` as an own property. `new Error(message, { cause })` needs\n * ES2022 error options, which an engine without them (the JavaScriptCore of\n * iOS before 15, which React Native 0.70 can still run on) ignores without a\n * word, so it is set by hand on every engine.\n */\nexport function withCause(error: Error, cause: unknown): Error {\n Object.defineProperty(error, \"cause\", {\n value: cause,\n writable: true,\n configurable: true,\n enumerable: false,\n });\n return error;\n}\n\n/** The longest description of a thrown object's data. */\nconst MAX_DESCRIPTION = 200;\n\n/**\n * Reads what a thrown value says without letting the reading throw: a\n * getter, a Proxy trap, a `toJSON` or a `toString` may throw too.\n */\nfunction attempt<T>(read: () => T): T | undefined {\n try {\n return read();\n } catch {\n return undefined;\n }\n}\n\n/** The `message` of a thrown object, when it is a non-empty string. */\nfunction messageOf(value: unknown): string | undefined {\n if (typeof value !== \"object\" || value === null) return undefined;\n const message = attempt(() => (value as { message?: unknown }).message);\n return typeof message === \"string\" && message !== \"\" ? message : undefined;\n}\n\n/** A thrown value as text, for a value that is not an Error. */\nfunction describeThrown(value: unknown): string {\n if (typeof value === \"string\") return JSON.stringify(value);\n if (typeof value === \"object\" && value !== null) {\n // Its data, not \"[object Object]\".\n const json = attempt(() => JSON.stringify(value));\n if (typeof json === \"string\") {\n return json.length > MAX_DESCRIPTION\n ? `${json.slice(0, MAX_DESCRIPTION)}…`\n : json;\n }\n }\n return (\n attempt(() => String(value)) ??\n attempt(() => Object.prototype.toString.call(value)) ??\n typeof value\n );\n}\n\n/** An Error of this realm, or of another one (a frame, a VM context). */\nfunction isError(value: unknown): value is Error {\n // `instanceof` runs a Proxy's getPrototypeOf trap, which may throw.\n if (attempt(() => value instanceof Error)) return true;\n // Another realm's Error fails `instanceof`; its tag says what it is. A\n // tag can be set on any object, so it must have a message as well.\n return (\n attempt(() => Object.prototype.toString.call(value)) === \"[object Error]\" &&\n typeof attempt(() => (value as { message?: unknown }).message) === \"string\"\n );\n}\n\n/**\n * The Error for any thrown value. Code may throw anything: a string, or a\n * falsy value (`undefined`, `null`, `0`, `\"\"`) that a boundary which keeps\n * the thrown value and tests it for truth would take for \"no error\". An\n * Error comes back as it is; a non-empty string, or the string `message`\n * of a thrown object, becomes the message; any other value is described in\n * the message. A value that is not an Error is kept as the `cause`. This\n * never throws, whatever the value.\n */\nexport function toError(value: unknown): Error {\n if (isError(value)) return value;\n const message =\n typeof value === \"string\" && value !== \"\"\n ? value\n : (messageOf(value) ??\n `A value that is not an Error was thrown: ${describeThrown(value)}`);\n return withCause(new Error(message), value);\n}\n"],"mappings":";;;;;;;AASA,SAAgB,UAAU,OAAc,OAAuB;AAC7D,QAAO,eAAe,OAAO,SAAS;EACpC,OAAO;EACP,UAAU;EACV,cAAc;EACd,YAAY;EACb,CAAC;AACF,QAAO;;;AAIT,MAAM,kBAAkB;;;;;AAMxB,SAAS,QAAW,MAA8B;AAChD,KAAI;AACF,SAAO,MAAM;SACP;AACN;;;;AAKJ,SAAS,UAAU,OAAoC;AACrD,KAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;CACxD,MAAM,UAAU,cAAe,MAAgC,QAAQ;AACvE,QAAO,OAAO,YAAY,YAAY,YAAY,KAAK,UAAU;;;AAInE,SAAS,eAAe,OAAwB;AAC9C,KAAI,OAAO,UAAU,SAAU,QAAO,KAAK,UAAU,MAAM;AAC3D,KAAI,OAAO,UAAU,YAAY,UAAU,MAAM;EAE/C,MAAM,OAAO,cAAc,KAAK,UAAU,MAAM,CAAC;AACjD,MAAI,OAAO,SAAS,SAClB,QAAO,KAAK,SAAS,kBACjB,GAAG,KAAK,MAAM,GAAG,gBAAgB,CAAC,KAClC;;AAGR,QACE,cAAc,OAAO,MAAM,CAAC,IAC5B,cAAc,OAAO,UAAU,SAAS,KAAK,MAAM,CAAC,IACpD,OAAO;;;AAKX,SAAS,QAAQ,OAAgC;AAE/C,KAAI,cAAc,iBAAiB,MAAM,CAAE,QAAO;AAGlD,QACE,cAAc,OAAO,UAAU,SAAS,KAAK,MAAM,CAAC,KAAK,oBACzD,OAAO,cAAe,MAAgC,QAAQ,KAAK;;;;;;;;;;;AAavE,SAAgB,QAAQ,OAAuB;AAC7C,KAAI,QAAQ,MAAM,CAAE,QAAO;CAC3B,MAAM,UACJ,OAAO,UAAU,YAAY,UAAU,KACnC,QACC,UAAU,MAAM,IACjB,4CAA4C,eAAe,MAAM;AACvE,QAAO,UAAU,IAAI,MAAM,QAAQ,EAAE,MAAM"}
@@ -1,7 +1,7 @@
1
1
 
2
2
  //#region src/generative-ui/types.ts
3
3
  /** A2UI protocol version used on the wire. */
4
- const A2UI_VERSION = "v1.0";
4
+ const A2UI_VERSION = "1.0";
5
5
  /** Activity type of a generated surface message. */
6
6
  const GENERATIVE_UI_ACTIVITY_TYPE = "generative-ui-surface";
7
7
  /** Activity type of a function call that the agent asks the client to run. */
@@ -65,7 +65,7 @@ const GENERATIVE_UI_MAX_REJECTION_LENGTH = 500;
65
65
  * @example
66
66
  * ```ts
67
67
  * toA2UIActionMessage({ name: "buy", surfaceId: "s1", componentId: "b", context: { sku: "a" } });
68
- * // { version: "v1.0", action: { name: "buy", surfaceId: "s1", sourceComponentId: "b", timestamp: "2026-…", context: { sku: "a" } } }
68
+ * // { version: "1.0", action: { name: "buy", surfaceId: "s1", sourceComponentId: "b", timestamp: "2026-…", context: { sku: "a" } } }
69
69
  * ```
70
70
  */
71
71
  function toA2UIActionMessage(event) {
@@ -1 +1 @@
1
- {"version":3,"file":"types.cjs","names":[],"sources":["../../src/generative-ui/types.ts"],"sourcesContent":["/** A2UI protocol version used on the wire. */\nexport const A2UI_VERSION = \"v1.0\";\n/** Activity type of a generated surface message. */\nexport const GENERATIVE_UI_ACTIVITY_TYPE = \"generative-ui-surface\";\n/** Activity type of a function call that the agent asks the client to run. */\nexport const GENERATIVE_UI_FUNCTION_CALL_ACTIVITY_TYPE =\n \"generative-ui-function-call\";\n/** Tool the model calls to render or update surfaces. */\nexport const GENERATIVE_UI_RENDER_TOOL = \"render_ui\";\n/** Target id of the chat transcript. */\nexport const GENERATIVE_UI_CHAT_TARGET = \"chat\";\n/** Component id every surface renders from. */\nexport const GENERATIVE_UI_ROOT_ID = \"root\";\n/**\n * Whether the agent may call renderer functions with `callRendererFunction`.\n * Off for now: the result goes back as a developer message, and not every\n * backend keeps that message where the model reads it in order. While off,\n * the prompts do not mention the operation, the validator rejects it, and\n * the dispatcher refuses the agent, whatever a declaration's\n * `allowedCallers` says. The code and its tests stay for when it is on.\n */\nexport const GENERATIVE_UI_AGENT_FUNCTION_CALLS = false;\n/** The reason an agent function call is rejected while they are off. */\nexport const GENERATIVE_UI_AGENT_FUNCTION_CALLS_OFF_REASON =\n \"callRendererFunction is not supported in this version: the agent cannot call renderer functions until their results can be sent back to it reliably\";\n\n/** Activity message id of a surface. One message per surface. */\nexport function generativeUISurfaceMessageId(surfaceId: string) {\n return `genui:${surfaceId}`;\n}\n\n/**\n * Activity message id of an agent-called function. One message per\n * `functionCallId`.\n *\n * @param functionCallId - The `functionCallId` of the `callRendererFunction` operation.\n *\n * @example\n * ```ts\n * generativeUIFunctionCallMessageId(\"f1\"); // \"genui-fn:f1\"\n * ```\n */\nexport function generativeUIFunctionCallMessageId(functionCallId: string) {\n return `genui-fn:${functionCallId}`;\n}\n\nimport type {\n A2UIFunctionPermissions,\n A2UIFunctionReturnType,\n} from \"./basic-functions\";\n\n// Named `GenerativeUIJSONSchema` because the package root already exports a\n// `JSONSchema` (utils/json-schema.ts); the bare name would collide.\nexport type GenerativeUIJSONSchema = Record<string, unknown>;\n\nexport type A2UIComponentNode = {\n id: string;\n component: string;\n [prop: string]: unknown;\n};\n\n/**\n * The keys of the A2UI 1.0 component envelope next to `id` and\n * `component`: `catalogId`, `accessibility` and `metadata`. They are not\n * props of the component. The renderer reads `accessibility` and ignores\n * the other two.\n */\nexport const A2UI_COMPONENT_ENVELOPE_KEYS: ReadonlySet<string> = new Set([\n \"catalogId\",\n \"accessibility\",\n \"metadata\",\n]);\n\n/**\n * A call of a named function: `{ \"@call\": \"addToCart\", \"args\": { ... } }`.\n * Without `catalogId`, the function comes from the catalog of the run.\n */\nexport type A2UIFunctionCall = {\n \"@call\": string;\n args?: Record<string, unknown>;\n catalogId?: string;\n};\n\nexport type A2UIOperation =\n | {\n version: \"v1.0\";\n createSurface: {\n surfaceId: string;\n /** Left out by the model. The run's catalog id is filled in. */\n catalogId?: string;\n /** Components to add at once, checked like `updateComponents`. */\n components?: A2UIComponentNode[];\n /** The initial root data model. */\n dataModel?: Record<string, unknown>;\n sendDataModel?: boolean;\n metadata?: { extensions?: Record<string, unknown> };\n };\n }\n | {\n version: \"v1.0\";\n updateComponents: { surfaceId: string; components: A2UIComponentNode[] };\n }\n | {\n version: \"v1.0\";\n /**\n * Sets `value` at `path`. A `null` value deletes the key at `path`.\n * With no `path`, or `\"/\"`, it sets the whole data model.\n */\n updateDataModel: { surfaceId: string; path?: string; value: unknown };\n }\n | { version: \"v1.0\"; deleteSurface: { surfaceId: string } }\n | {\n version: \"v1.0\";\n /** Runs an app function in the browser, with no user interaction. */\n callRendererFunction: {\n functionCallId: string;\n callFunction: A2UIFunctionCall;\n };\n };\n\n/** Value of an event prop: run a host function, or report the event to the agent. */\nexport type GenerativeUIActionBinding =\n | {\n event: {\n name: string;\n /**\n * First line of the user message that the event becomes: text, a\n * data binding, or a function value such as formatString.\n */\n userMessage?: string | { \"@path\": string } | A2UIFunctionCall;\n context?: Record<string, unknown>;\n };\n }\n | { functionCall: A2UIFunctionCall };\n\nexport type GenerativeUISurfaceStatus = \"streaming\" | \"ready\" | \"error\";\n\nexport interface GenerativeUIRejectedOperation {\n /** Position of the operation in the render_ui call, or in the content list. */\n index: number;\n reason: string;\n}\n\n/** Content of a `generative-ui-surface` activity message. */\nexport interface GenerativeUISurfaceContent {\n surfaceId: string;\n target: string;\n catalogId: string;\n /** Committed (validated) operations, cumulative. */\n operations: A2UIOperation[];\n status: GenerativeUISurfaceStatus;\n rejected: GenerativeUIRejectedOperation[];\n}\n\n/** Content of a `generative-ui-function-call` activity message. */\nexport interface GenerativeUIFunctionCallContent {\n functionCallId: string;\n callFunction: A2UIFunctionCall;\n}\n\n/**\n * Value of a \"multiple\" slot that repeats one component for each item of the\n * list at `path`. Paths inside the repeated component are relative to the item.\n */\nexport type GenerativeUITemplateChildren = {\n componentId: string;\n path: string;\n};\n\nexport interface GenerativeUIComponentManifest {\n /** CopilotKit positional order across model-visible props, slots and events.\n * Exporters encode this as JSON Schema property order; it is not an A2UI keyword. */\n parameterOrder?: readonly string[];\n description?: string;\n props: GenerativeUIJSONSchema;\n events?: Record<\n string,\n { description?: string; parameters: GenerativeUIJSONSchema }\n >;\n /**\n * Props that hold child components. A \"single\" slot takes one component id.\n * A \"multiple\" slot takes a `string[]` of component ids, or a\n * {@link GenerativeUITemplateChildren} template.\n */\n slots?: Record<string, \"single\" | \"multiple\">;\n}\n\nexport interface GenerativeUIFunctionManifest extends A2UIFunctionPermissions {\n description?: string;\n parameters: GenerativeUIJSONSchema;\n /** What the function gives back, as A2UI 1.0 names it. */\n returnType?: A2UIFunctionReturnType;\n}\n\n/** Serializable description of what the browser can render and call. */\nexport interface GenerativeUIManifest {\n /** The catalog of the run. A surface with no `catalogId` gets this one. */\n catalogId: string;\n /**\n * Every catalog that a `catalogId` can name: `catalogId` first, then the\n * catalogs of `extends`. Left out, only `catalogId`.\n */\n catalogIds?: string[];\n components: Record<string, GenerativeUIComponentManifest>;\n functions: Record<string, GenerativeUIFunctionManifest>;\n /**\n * Places where the model can render surfaces. Only mounted targets are\n * listed. `description` tells the model where the target is on the page\n * and what to put in it.\n */\n targets: GenerativeUITarget[];\n /** Surfaces the client already holds for the current thread. */\n surfaces: Record<string, GenerativeUISurfaceSummary>;\n}\n\n/** A place where the model can render surfaces. */\nexport interface GenerativeUITarget {\n id: string;\n kind: \"chat\" | \"inline\";\n description?: string;\n /**\n * The only components that the surfaces of this target can use, at most\n * {@link GENERATIVE_UI_MAX_TARGET_COMPONENTS} names. Left out, the target\n * takes every component of the catalog.\n */\n components?: string[];\n}\n\n/** Most component names that one target can list. */\nexport const GENERATIVE_UI_MAX_TARGET_COMPONENTS = 100;\n\n/** Most rejections that a surface summary lists. */\nexport const GENERATIVE_UI_MAX_SUMMARY_REJECTIONS = 20;\n/** Most characters of one rejection in a surface summary. */\nexport const GENERATIVE_UI_MAX_REJECTION_LENGTH = 500;\n\n/** One surface that the client holds, as the model sees it. */\nexport interface GenerativeUISurfaceSummary {\n target: string;\n /** The values that the user set, by path. Left out when there are none. */\n dataModel?: Record<string, unknown>;\n /**\n * Operations that the client dropped, as `\"operation <index>: <reason>\"`.\n * At most {@link GENERATIVE_UI_MAX_SUMMARY_REJECTIONS} entries of at most\n * {@link GENERATIVE_UI_MAX_REJECTION_LENGTH} characters. Left out when\n * there are none.\n */\n rejected?: string[];\n /**\n * Left out while the surface exists. `\"deleted\"`: a deleteSurface removed\n * it, and its id cannot be used again. `\"failed\"`: its createSurface was\n * rejected, so it does not exist; a corrected createSurface can use the id.\n */\n status?: \"deleted\" | \"failed\";\n}\n\n/** A user interaction bound to `{ event }`, sent to the agent. */\nexport interface GenerativeUIUserEvent {\n name: string;\n surfaceId: string;\n componentId: string;\n context: Record<string, unknown>;\n /** The resolved `event.userMessage`: the first line of the user message. */\n userMessage?: string;\n /** When the user acted, as an ISO 8601 string. Filled in when left out. */\n timestamp?: string;\n}\n\n/**\n * The A2UI 1.0 action message of a user event: what a renderer sends to the\n * agent when the user triggers an `{ event }` action. The run that the\n * event starts carries it in the envelope (`copilotkit_action`), next to\n * the visible user message.\n */\nexport interface A2UIActionMessage {\n version: typeof A2UI_VERSION;\n action: {\n name: string;\n surfaceId: string;\n sourceComponentId: string;\n /** ISO 8601. */\n timestamp: string;\n userMessage?: string;\n context: Record<string, unknown>;\n };\n}\n\n/**\n * The action message of a user event, with the A2UI field names. Takes the\n * time of the call when the event has no timestamp.\n *\n * @example\n * ```ts\n * toA2UIActionMessage({ name: \"buy\", surfaceId: \"s1\", componentId: \"b\", context: { sku: \"a\" } });\n * // { version: \"v1.0\", action: { name: \"buy\", surfaceId: \"s1\", sourceComponentId: \"b\", timestamp: \"2026-…\", context: { sku: \"a\" } } }\n * ```\n */\nexport function toA2UIActionMessage(\n event: GenerativeUIUserEvent,\n): A2UIActionMessage {\n return {\n version: A2UI_VERSION,\n action: {\n name: event.name,\n surfaceId: event.surfaceId,\n sourceComponentId: event.componentId,\n timestamp: event.timestamp ?? new Date().toISOString(),\n ...(event.userMessage === undefined\n ? {}\n : { userMessage: event.userMessage }),\n context: event.context,\n },\n };\n}\n"],"mappings":";;;AACA,MAAa,eAAe;;AAE5B,MAAa,8BAA8B;;AAE3C,MAAa,4CACX;;AAEF,MAAa,4BAA4B;;AAEzC,MAAa,4BAA4B;;AAEzC,MAAa,wBAAwB;;;;;;;;;AASrC,MAAa,qCAAqC;;AAElD,MAAa,gDACX;;AAGF,SAAgB,6BAA6B,WAAmB;AAC9D,QAAO,SAAS;;;;;;;;;;;;;AAclB,SAAgB,kCAAkC,gBAAwB;AACxE,QAAO,YAAY;;;;;;;;AAwBrB,MAAa,+BAAoD,IAAI,IAAI;CACvE;CACA;CACA;CACD,CAAC;;AA8JF,MAAa,sCAAsC;;AAGnD,MAAa,uCAAuC;;AAEpD,MAAa,qCAAqC;;;;;;;;;;;AA+DlD,SAAgB,oBACd,OACmB;AACnB,QAAO;EACL,SAAS;EACT,QAAQ;GACN,MAAM,MAAM;GACZ,WAAW,MAAM;GACjB,mBAAmB,MAAM;GACzB,WAAW,MAAM,8BAAa,IAAI,MAAM,EAAC,aAAa;GACtD,GAAI,MAAM,gBAAgB,SACtB,EAAE,GACF,EAAE,aAAa,MAAM,aAAa;GACtC,SAAS,MAAM;GAChB;EACF"}
1
+ {"version":3,"file":"types.cjs","names":[],"sources":["../../src/generative-ui/types.ts"],"sourcesContent":["/** A2UI protocol version used on the wire. */\nexport const A2UI_VERSION = \"1.0\";\n/** Activity type of a generated surface message. */\nexport const GENERATIVE_UI_ACTIVITY_TYPE = \"generative-ui-surface\";\n/** Activity type of a function call that the agent asks the client to run. */\nexport const GENERATIVE_UI_FUNCTION_CALL_ACTIVITY_TYPE =\n \"generative-ui-function-call\";\n/** Tool the model calls to render or update surfaces. */\nexport const GENERATIVE_UI_RENDER_TOOL = \"render_ui\";\n/** Target id of the chat transcript. */\nexport const GENERATIVE_UI_CHAT_TARGET = \"chat\";\n/** Component id every surface renders from. */\nexport const GENERATIVE_UI_ROOT_ID = \"root\";\n/**\n * Whether the agent may call renderer functions with `callRendererFunction`.\n * Off for now: the result goes back as a developer message, and not every\n * backend keeps that message where the model reads it in order. While off,\n * the prompts do not mention the operation, the validator rejects it, and\n * the dispatcher refuses the agent, whatever a declaration's\n * `allowedCallers` says. The code and its tests stay for when it is on.\n */\nexport const GENERATIVE_UI_AGENT_FUNCTION_CALLS = false;\n/** The reason an agent function call is rejected while they are off. */\nexport const GENERATIVE_UI_AGENT_FUNCTION_CALLS_OFF_REASON =\n \"callRendererFunction is not supported in this version: the agent cannot call renderer functions until their results can be sent back to it reliably\";\n\n/** Activity message id of a surface. One message per surface. */\nexport function generativeUISurfaceMessageId(surfaceId: string) {\n return `genui:${surfaceId}`;\n}\n\n/**\n * Activity message id of an agent-called function. One message per\n * `functionCallId`.\n *\n * @param functionCallId - The `functionCallId` of the `callRendererFunction` operation.\n *\n * @example\n * ```ts\n * generativeUIFunctionCallMessageId(\"f1\"); // \"genui-fn:f1\"\n * ```\n */\nexport function generativeUIFunctionCallMessageId(functionCallId: string) {\n return `genui-fn:${functionCallId}`;\n}\n\nimport type {\n A2UIFunctionPermissions,\n A2UIFunctionReturnType,\n} from \"./basic-functions\";\n\n// Named `GenerativeUIJSONSchema` because the package root already exports a\n// `JSONSchema` (utils/json-schema.ts); the bare name would collide.\nexport type GenerativeUIJSONSchema = Record<string, unknown>;\n\nexport type A2UIComponentNode = {\n id: string;\n component: string;\n [prop: string]: unknown;\n};\n\n/**\n * The keys of the A2UI 1.0 component envelope next to `id` and\n * `component`: `catalogId`, `accessibility` and `metadata`. They are not\n * props of the component. The renderer reads `accessibility` and ignores\n * the other two.\n */\nexport const A2UI_COMPONENT_ENVELOPE_KEYS: ReadonlySet<string> = new Set([\n \"catalogId\",\n \"accessibility\",\n \"metadata\",\n]);\n\n/**\n * A call of a named function: `{ \"@call\": \"addToCart\", \"args\": { ... } }`.\n * Without `catalogId`, the function comes from the catalog of the run.\n */\nexport type A2UIFunctionCall = {\n \"@call\": string;\n args?: Record<string, unknown>;\n catalogId?: string;\n};\n\nexport type A2UIOperation =\n | {\n version: typeof A2UI_VERSION;\n createSurface: {\n surfaceId: string;\n /** Left out by the model. The run's catalog id is filled in. */\n catalogId?: string;\n /** Components to add at once, checked like `updateComponents`. */\n components?: A2UIComponentNode[];\n /** The initial root data model. */\n dataModel?: Record<string, unknown>;\n sendDataModel?: boolean;\n metadata?: { extensions?: Record<string, unknown> };\n };\n }\n | {\n version: typeof A2UI_VERSION;\n updateComponents: { surfaceId: string; components: A2UIComponentNode[] };\n }\n | {\n version: typeof A2UI_VERSION;\n /**\n * Sets `value` at `path`. A `null` value deletes the key at `path`.\n * With no `path`, or `\"/\"`, it sets the whole data model.\n */\n updateDataModel: { surfaceId: string; path?: string; value: unknown };\n }\n | {\n version: typeof A2UI_VERSION;\n deleteSurface: { surfaceId: string };\n }\n | {\n version: typeof A2UI_VERSION;\n /** Runs an app function in the browser, with no user interaction. */\n callRendererFunction: {\n functionCallId: string;\n callFunction: A2UIFunctionCall;\n };\n };\n\n/** Value of an event prop: run a host function, or report the event to the agent. */\nexport type GenerativeUIActionBinding =\n | {\n event: {\n name: string;\n /**\n * First line of the user message that the event becomes: text, a\n * data binding, or a function value such as formatString.\n */\n userMessage?: string | { \"@path\": string } | A2UIFunctionCall;\n context?: Record<string, unknown>;\n };\n }\n | { functionCall: A2UIFunctionCall };\n\nexport type GenerativeUISurfaceStatus = \"streaming\" | \"ready\" | \"error\";\n\nexport interface GenerativeUIRejectedOperation {\n /** Position of the operation in the render_ui call, or in the content list. */\n index: number;\n reason: string;\n}\n\n/** Content of a `generative-ui-surface` activity message. */\nexport interface GenerativeUISurfaceContent {\n surfaceId: string;\n target: string;\n catalogId: string;\n /** Committed (validated) operations, cumulative. */\n operations: A2UIOperation[];\n status: GenerativeUISurfaceStatus;\n rejected: GenerativeUIRejectedOperation[];\n}\n\n/** Content of a `generative-ui-function-call` activity message. */\nexport interface GenerativeUIFunctionCallContent {\n functionCallId: string;\n callFunction: A2UIFunctionCall;\n}\n\n/**\n * Value of a \"multiple\" slot that repeats one component for each item of the\n * list at `path`. Paths inside the repeated component are relative to the item.\n */\nexport type GenerativeUITemplateChildren = {\n componentId: string;\n path: string;\n};\n\nexport interface GenerativeUIComponentManifest {\n /** CopilotKit positional order across model-visible props, slots and events.\n * Exporters encode this as JSON Schema property order; it is not an A2UI keyword. */\n parameterOrder?: readonly string[];\n description?: string;\n props: GenerativeUIJSONSchema;\n events?: Record<\n string,\n { description?: string; parameters: GenerativeUIJSONSchema }\n >;\n /**\n * Props that hold child components. A \"single\" slot takes one component id.\n * A \"multiple\" slot takes a `string[]` of component ids, or a\n * {@link GenerativeUITemplateChildren} template.\n */\n slots?: Record<string, \"single\" | \"multiple\">;\n}\n\nexport interface GenerativeUIFunctionManifest extends A2UIFunctionPermissions {\n description?: string;\n parameters: GenerativeUIJSONSchema;\n /** What the function gives back, as A2UI 1.0 names it. */\n returnType?: A2UIFunctionReturnType;\n}\n\n/** Serializable description of what the browser can render and call. */\nexport interface GenerativeUIManifest {\n /** The catalog of the run. A surface with no `catalogId` gets this one. */\n catalogId: string;\n /**\n * Every catalog that a `catalogId` can name: `catalogId` first, then the\n * catalogs of `extends`. Left out, only `catalogId`.\n */\n catalogIds?: string[];\n components: Record<string, GenerativeUIComponentManifest>;\n functions: Record<string, GenerativeUIFunctionManifest>;\n /**\n * Places where the model can render surfaces. Only mounted targets are\n * listed. `description` tells the model where the target is on the page\n * and what to put in it.\n */\n targets: GenerativeUITarget[];\n /** Surfaces the client already holds for the current thread. */\n surfaces: Record<string, GenerativeUISurfaceSummary>;\n}\n\n/** A place where the model can render surfaces. */\nexport interface GenerativeUITarget {\n id: string;\n kind: \"chat\" | \"inline\";\n description?: string;\n /**\n * The only components that the surfaces of this target can use, at most\n * {@link GENERATIVE_UI_MAX_TARGET_COMPONENTS} names. Left out, the target\n * takes every component of the catalog.\n */\n components?: string[];\n}\n\n/** Most component names that one target can list. */\nexport const GENERATIVE_UI_MAX_TARGET_COMPONENTS = 100;\n\n/** Most rejections that a surface summary lists. */\nexport const GENERATIVE_UI_MAX_SUMMARY_REJECTIONS = 20;\n/** Most characters of one rejection in a surface summary. */\nexport const GENERATIVE_UI_MAX_REJECTION_LENGTH = 500;\n\n/** One surface that the client holds, as the model sees it. */\nexport interface GenerativeUISurfaceSummary {\n target: string;\n /** The values that the user set, by path. Left out when there are none. */\n dataModel?: Record<string, unknown>;\n /**\n * Operations that the client dropped, as `\"operation <index>: <reason>\"`.\n * At most {@link GENERATIVE_UI_MAX_SUMMARY_REJECTIONS} entries of at most\n * {@link GENERATIVE_UI_MAX_REJECTION_LENGTH} characters. Left out when\n * there are none.\n */\n rejected?: string[];\n /**\n * Left out while the surface exists. `\"deleted\"`: a deleteSurface removed\n * it, and its id cannot be used again. `\"failed\"`: its createSurface was\n * rejected, so it does not exist; a corrected createSurface can use the id.\n */\n status?: \"deleted\" | \"failed\";\n}\n\n/** A user interaction bound to `{ event }`, sent to the agent. */\nexport interface GenerativeUIUserEvent {\n name: string;\n surfaceId: string;\n componentId: string;\n context: Record<string, unknown>;\n /** The resolved `event.userMessage`: the first line of the user message. */\n userMessage?: string;\n /** When the user acted, as an ISO 8601 string. Filled in when left out. */\n timestamp?: string;\n}\n\n/**\n * The A2UI 1.0 action message of a user event: what a renderer sends to the\n * agent when the user triggers an `{ event }` action. The run that the\n * event starts carries it in the envelope (`copilotkit_action`), next to\n * the visible user message.\n */\nexport interface A2UIActionMessage {\n version: typeof A2UI_VERSION;\n action: {\n name: string;\n surfaceId: string;\n sourceComponentId: string;\n /** ISO 8601. */\n timestamp: string;\n userMessage?: string;\n context: Record<string, unknown>;\n };\n}\n\n/**\n * The action message of a user event, with the A2UI field names. Takes the\n * time of the call when the event has no timestamp.\n *\n * @example\n * ```ts\n * toA2UIActionMessage({ name: \"buy\", surfaceId: \"s1\", componentId: \"b\", context: { sku: \"a\" } });\n * // { version: \"1.0\", action: { name: \"buy\", surfaceId: \"s1\", sourceComponentId: \"b\", timestamp: \"2026-…\", context: { sku: \"a\" } } }\n * ```\n */\nexport function toA2UIActionMessage(\n event: GenerativeUIUserEvent,\n): A2UIActionMessage {\n return {\n version: A2UI_VERSION,\n action: {\n name: event.name,\n surfaceId: event.surfaceId,\n sourceComponentId: event.componentId,\n timestamp: event.timestamp ?? new Date().toISOString(),\n ...(event.userMessage === undefined\n ? {}\n : { userMessage: event.userMessage }),\n context: event.context,\n },\n };\n}\n"],"mappings":";;;AACA,MAAa,eAAe;;AAE5B,MAAa,8BAA8B;;AAE3C,MAAa,4CACX;;AAEF,MAAa,4BAA4B;;AAEzC,MAAa,4BAA4B;;AAEzC,MAAa,wBAAwB;;;;;;;;;AASrC,MAAa,qCAAqC;;AAElD,MAAa,gDACX;;AAGF,SAAgB,6BAA6B,WAAmB;AAC9D,QAAO,SAAS;;;;;;;;;;;;;AAclB,SAAgB,kCAAkC,gBAAwB;AACxE,QAAO,YAAY;;;;;;;;AAwBrB,MAAa,+BAAoD,IAAI,IAAI;CACvE;CACA;CACA;CACD,CAAC;;AAiKF,MAAa,sCAAsC;;AAGnD,MAAa,uCAAuC;;AAEpD,MAAa,qCAAqC;;;;;;;;;;;AA+DlD,SAAgB,oBACd,OACmB;AACnB,QAAO;EACL,SAAS;EACT,QAAQ;GACN,MAAM,MAAM;GACZ,WAAW,MAAM;GACjB,mBAAmB,MAAM;GACzB,WAAW,MAAM,8BAAa,IAAI,MAAM,EAAC,aAAa;GACtD,GAAI,MAAM,gBAAgB,SACtB,EAAE,GACF,EAAE,aAAa,MAAM,aAAa;GACtC,SAAS,MAAM;GAChB;EACF"}
@@ -2,7 +2,7 @@ import { A2UIFunctionPermissions, A2UIFunctionReturnType } from "./basic-functio
2
2
 
3
3
  //#region src/generative-ui/types.d.ts
4
4
  /** A2UI protocol version used on the wire. */
5
- declare const A2UI_VERSION = "v1.0";
5
+ declare const A2UI_VERSION = "1.0";
6
6
  /** Activity type of a generated surface message. */
7
7
  declare const GENERATIVE_UI_ACTIVITY_TYPE = "generative-ui-surface";
8
8
  /** Activity type of a function call that the agent asks the client to run. */
@@ -61,7 +61,7 @@ type A2UIFunctionCall = {
61
61
  catalogId?: string;
62
62
  };
63
63
  type A2UIOperation = {
64
- version: "v1.0";
64
+ version: typeof A2UI_VERSION;
65
65
  createSurface: {
66
66
  surfaceId: string; /** Left out by the model. The run's catalog id is filled in. */
67
67
  catalogId?: string; /** Components to add at once, checked like `updateComponents`. */
@@ -73,13 +73,13 @@ type A2UIOperation = {
73
73
  };
74
74
  };
75
75
  } | {
76
- version: "v1.0";
76
+ version: typeof A2UI_VERSION;
77
77
  updateComponents: {
78
78
  surfaceId: string;
79
79
  components: A2UIComponentNode[];
80
80
  };
81
81
  } | {
82
- version: "v1.0";
82
+ version: typeof A2UI_VERSION;
83
83
  /**
84
84
  * Sets `value` at `path`. A `null` value deletes the key at `path`.
85
85
  * With no `path`, or `"/"`, it sets the whole data model.
@@ -90,12 +90,12 @@ type A2UIOperation = {
90
90
  value: unknown;
91
91
  };
92
92
  } | {
93
- version: "v1.0";
93
+ version: typeof A2UI_VERSION;
94
94
  deleteSurface: {
95
95
  surfaceId: string;
96
96
  };
97
97
  } | {
98
- version: "v1.0"; /** Runs an app function in the browser, with no user interaction. */
98
+ version: typeof A2UI_VERSION; /** Runs an app function in the browser, with no user interaction. */
99
99
  callRendererFunction: {
100
100
  functionCallId: string;
101
101
  callFunction: A2UIFunctionCall;
@@ -261,7 +261,7 @@ interface A2UIActionMessage {
261
261
  * @example
262
262
  * ```ts
263
263
  * toA2UIActionMessage({ name: "buy", surfaceId: "s1", componentId: "b", context: { sku: "a" } });
264
- * // { version: "v1.0", action: { name: "buy", surfaceId: "s1", sourceComponentId: "b", timestamp: "2026-…", context: { sku: "a" } } }
264
+ * // { version: "1.0", action: { name: "buy", surfaceId: "s1", sourceComponentId: "b", timestamp: "2026-…", context: { sku: "a" } } }
265
265
  * ```
266
266
  */
267
267
  declare function toA2UIActionMessage(event: GenerativeUIUserEvent): A2UIActionMessage;
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.cts","names":[],"sources":["../../src/generative-ui/types.ts"],"mappings":"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"}
1
+ {"version":3,"file":"types.d.cts","names":[],"sources":["../../src/generative-ui/types.ts"],"mappings":"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"}
@@ -2,7 +2,7 @@ import { A2UIFunctionPermissions, A2UIFunctionReturnType } from "./basic-functio
2
2
 
3
3
  //#region src/generative-ui/types.d.ts
4
4
  /** A2UI protocol version used on the wire. */
5
- declare const A2UI_VERSION = "v1.0";
5
+ declare const A2UI_VERSION = "1.0";
6
6
  /** Activity type of a generated surface message. */
7
7
  declare const GENERATIVE_UI_ACTIVITY_TYPE = "generative-ui-surface";
8
8
  /** Activity type of a function call that the agent asks the client to run. */
@@ -61,7 +61,7 @@ type A2UIFunctionCall = {
61
61
  catalogId?: string;
62
62
  };
63
63
  type A2UIOperation = {
64
- version: "v1.0";
64
+ version: typeof A2UI_VERSION;
65
65
  createSurface: {
66
66
  surfaceId: string; /** Left out by the model. The run's catalog id is filled in. */
67
67
  catalogId?: string; /** Components to add at once, checked like `updateComponents`. */
@@ -73,13 +73,13 @@ type A2UIOperation = {
73
73
  };
74
74
  };
75
75
  } | {
76
- version: "v1.0";
76
+ version: typeof A2UI_VERSION;
77
77
  updateComponents: {
78
78
  surfaceId: string;
79
79
  components: A2UIComponentNode[];
80
80
  };
81
81
  } | {
82
- version: "v1.0";
82
+ version: typeof A2UI_VERSION;
83
83
  /**
84
84
  * Sets `value` at `path`. A `null` value deletes the key at `path`.
85
85
  * With no `path`, or `"/"`, it sets the whole data model.
@@ -90,12 +90,12 @@ type A2UIOperation = {
90
90
  value: unknown;
91
91
  };
92
92
  } | {
93
- version: "v1.0";
93
+ version: typeof A2UI_VERSION;
94
94
  deleteSurface: {
95
95
  surfaceId: string;
96
96
  };
97
97
  } | {
98
- version: "v1.0"; /** Runs an app function in the browser, with no user interaction. */
98
+ version: typeof A2UI_VERSION; /** Runs an app function in the browser, with no user interaction. */
99
99
  callRendererFunction: {
100
100
  functionCallId: string;
101
101
  callFunction: A2UIFunctionCall;
@@ -261,7 +261,7 @@ interface A2UIActionMessage {
261
261
  * @example
262
262
  * ```ts
263
263
  * toA2UIActionMessage({ name: "buy", surfaceId: "s1", componentId: "b", context: { sku: "a" } });
264
- * // { version: "v1.0", action: { name: "buy", surfaceId: "s1", sourceComponentId: "b", timestamp: "2026-…", context: { sku: "a" } } }
264
+ * // { version: "1.0", action: { name: "buy", surfaceId: "s1", sourceComponentId: "b", timestamp: "2026-…", context: { sku: "a" } } }
265
265
  * ```
266
266
  */
267
267
  declare function toA2UIActionMessage(event: GenerativeUIUserEvent): A2UIActionMessage;
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.mts","names":[],"sources":["../../src/generative-ui/types.ts"],"mappings":"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"}
1
+ {"version":3,"file":"types.d.mts","names":[],"sources":["../../src/generative-ui/types.ts"],"mappings":"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"}
@@ -1,6 +1,6 @@
1
1
  //#region src/generative-ui/types.ts
2
2
  /** A2UI protocol version used on the wire. */
3
- const A2UI_VERSION = "v1.0";
3
+ const A2UI_VERSION = "1.0";
4
4
  /** Activity type of a generated surface message. */
5
5
  const GENERATIVE_UI_ACTIVITY_TYPE = "generative-ui-surface";
6
6
  /** Activity type of a function call that the agent asks the client to run. */
@@ -64,7 +64,7 @@ const GENERATIVE_UI_MAX_REJECTION_LENGTH = 500;
64
64
  * @example
65
65
  * ```ts
66
66
  * toA2UIActionMessage({ name: "buy", surfaceId: "s1", componentId: "b", context: { sku: "a" } });
67
- * // { version: "v1.0", action: { name: "buy", surfaceId: "s1", sourceComponentId: "b", timestamp: "2026-…", context: { sku: "a" } } }
67
+ * // { version: "1.0", action: { name: "buy", surfaceId: "s1", sourceComponentId: "b", timestamp: "2026-…", context: { sku: "a" } } }
68
68
  * ```
69
69
  */
70
70
  function toA2UIActionMessage(event) {
@@ -1 +1 @@
1
- {"version":3,"file":"types.mjs","names":[],"sources":["../../src/generative-ui/types.ts"],"sourcesContent":["/** A2UI protocol version used on the wire. */\nexport const A2UI_VERSION = \"v1.0\";\n/** Activity type of a generated surface message. */\nexport const GENERATIVE_UI_ACTIVITY_TYPE = \"generative-ui-surface\";\n/** Activity type of a function call that the agent asks the client to run. */\nexport const GENERATIVE_UI_FUNCTION_CALL_ACTIVITY_TYPE =\n \"generative-ui-function-call\";\n/** Tool the model calls to render or update surfaces. */\nexport const GENERATIVE_UI_RENDER_TOOL = \"render_ui\";\n/** Target id of the chat transcript. */\nexport const GENERATIVE_UI_CHAT_TARGET = \"chat\";\n/** Component id every surface renders from. */\nexport const GENERATIVE_UI_ROOT_ID = \"root\";\n/**\n * Whether the agent may call renderer functions with `callRendererFunction`.\n * Off for now: the result goes back as a developer message, and not every\n * backend keeps that message where the model reads it in order. While off,\n * the prompts do not mention the operation, the validator rejects it, and\n * the dispatcher refuses the agent, whatever a declaration's\n * `allowedCallers` says. The code and its tests stay for when it is on.\n */\nexport const GENERATIVE_UI_AGENT_FUNCTION_CALLS = false;\n/** The reason an agent function call is rejected while they are off. */\nexport const GENERATIVE_UI_AGENT_FUNCTION_CALLS_OFF_REASON =\n \"callRendererFunction is not supported in this version: the agent cannot call renderer functions until their results can be sent back to it reliably\";\n\n/** Activity message id of a surface. One message per surface. */\nexport function generativeUISurfaceMessageId(surfaceId: string) {\n return `genui:${surfaceId}`;\n}\n\n/**\n * Activity message id of an agent-called function. One message per\n * `functionCallId`.\n *\n * @param functionCallId - The `functionCallId` of the `callRendererFunction` operation.\n *\n * @example\n * ```ts\n * generativeUIFunctionCallMessageId(\"f1\"); // \"genui-fn:f1\"\n * ```\n */\nexport function generativeUIFunctionCallMessageId(functionCallId: string) {\n return `genui-fn:${functionCallId}`;\n}\n\nimport type {\n A2UIFunctionPermissions,\n A2UIFunctionReturnType,\n} from \"./basic-functions\";\n\n// Named `GenerativeUIJSONSchema` because the package root already exports a\n// `JSONSchema` (utils/json-schema.ts); the bare name would collide.\nexport type GenerativeUIJSONSchema = Record<string, unknown>;\n\nexport type A2UIComponentNode = {\n id: string;\n component: string;\n [prop: string]: unknown;\n};\n\n/**\n * The keys of the A2UI 1.0 component envelope next to `id` and\n * `component`: `catalogId`, `accessibility` and `metadata`. They are not\n * props of the component. The renderer reads `accessibility` and ignores\n * the other two.\n */\nexport const A2UI_COMPONENT_ENVELOPE_KEYS: ReadonlySet<string> = new Set([\n \"catalogId\",\n \"accessibility\",\n \"metadata\",\n]);\n\n/**\n * A call of a named function: `{ \"@call\": \"addToCart\", \"args\": { ... } }`.\n * Without `catalogId`, the function comes from the catalog of the run.\n */\nexport type A2UIFunctionCall = {\n \"@call\": string;\n args?: Record<string, unknown>;\n catalogId?: string;\n};\n\nexport type A2UIOperation =\n | {\n version: \"v1.0\";\n createSurface: {\n surfaceId: string;\n /** Left out by the model. The run's catalog id is filled in. */\n catalogId?: string;\n /** Components to add at once, checked like `updateComponents`. */\n components?: A2UIComponentNode[];\n /** The initial root data model. */\n dataModel?: Record<string, unknown>;\n sendDataModel?: boolean;\n metadata?: { extensions?: Record<string, unknown> };\n };\n }\n | {\n version: \"v1.0\";\n updateComponents: { surfaceId: string; components: A2UIComponentNode[] };\n }\n | {\n version: \"v1.0\";\n /**\n * Sets `value` at `path`. A `null` value deletes the key at `path`.\n * With no `path`, or `\"/\"`, it sets the whole data model.\n */\n updateDataModel: { surfaceId: string; path?: string; value: unknown };\n }\n | { version: \"v1.0\"; deleteSurface: { surfaceId: string } }\n | {\n version: \"v1.0\";\n /** Runs an app function in the browser, with no user interaction. */\n callRendererFunction: {\n functionCallId: string;\n callFunction: A2UIFunctionCall;\n };\n };\n\n/** Value of an event prop: run a host function, or report the event to the agent. */\nexport type GenerativeUIActionBinding =\n | {\n event: {\n name: string;\n /**\n * First line of the user message that the event becomes: text, a\n * data binding, or a function value such as formatString.\n */\n userMessage?: string | { \"@path\": string } | A2UIFunctionCall;\n context?: Record<string, unknown>;\n };\n }\n | { functionCall: A2UIFunctionCall };\n\nexport type GenerativeUISurfaceStatus = \"streaming\" | \"ready\" | \"error\";\n\nexport interface GenerativeUIRejectedOperation {\n /** Position of the operation in the render_ui call, or in the content list. */\n index: number;\n reason: string;\n}\n\n/** Content of a `generative-ui-surface` activity message. */\nexport interface GenerativeUISurfaceContent {\n surfaceId: string;\n target: string;\n catalogId: string;\n /** Committed (validated) operations, cumulative. */\n operations: A2UIOperation[];\n status: GenerativeUISurfaceStatus;\n rejected: GenerativeUIRejectedOperation[];\n}\n\n/** Content of a `generative-ui-function-call` activity message. */\nexport interface GenerativeUIFunctionCallContent {\n functionCallId: string;\n callFunction: A2UIFunctionCall;\n}\n\n/**\n * Value of a \"multiple\" slot that repeats one component for each item of the\n * list at `path`. Paths inside the repeated component are relative to the item.\n */\nexport type GenerativeUITemplateChildren = {\n componentId: string;\n path: string;\n};\n\nexport interface GenerativeUIComponentManifest {\n /** CopilotKit positional order across model-visible props, slots and events.\n * Exporters encode this as JSON Schema property order; it is not an A2UI keyword. */\n parameterOrder?: readonly string[];\n description?: string;\n props: GenerativeUIJSONSchema;\n events?: Record<\n string,\n { description?: string; parameters: GenerativeUIJSONSchema }\n >;\n /**\n * Props that hold child components. A \"single\" slot takes one component id.\n * A \"multiple\" slot takes a `string[]` of component ids, or a\n * {@link GenerativeUITemplateChildren} template.\n */\n slots?: Record<string, \"single\" | \"multiple\">;\n}\n\nexport interface GenerativeUIFunctionManifest extends A2UIFunctionPermissions {\n description?: string;\n parameters: GenerativeUIJSONSchema;\n /** What the function gives back, as A2UI 1.0 names it. */\n returnType?: A2UIFunctionReturnType;\n}\n\n/** Serializable description of what the browser can render and call. */\nexport interface GenerativeUIManifest {\n /** The catalog of the run. A surface with no `catalogId` gets this one. */\n catalogId: string;\n /**\n * Every catalog that a `catalogId` can name: `catalogId` first, then the\n * catalogs of `extends`. Left out, only `catalogId`.\n */\n catalogIds?: string[];\n components: Record<string, GenerativeUIComponentManifest>;\n functions: Record<string, GenerativeUIFunctionManifest>;\n /**\n * Places where the model can render surfaces. Only mounted targets are\n * listed. `description` tells the model where the target is on the page\n * and what to put in it.\n */\n targets: GenerativeUITarget[];\n /** Surfaces the client already holds for the current thread. */\n surfaces: Record<string, GenerativeUISurfaceSummary>;\n}\n\n/** A place where the model can render surfaces. */\nexport interface GenerativeUITarget {\n id: string;\n kind: \"chat\" | \"inline\";\n description?: string;\n /**\n * The only components that the surfaces of this target can use, at most\n * {@link GENERATIVE_UI_MAX_TARGET_COMPONENTS} names. Left out, the target\n * takes every component of the catalog.\n */\n components?: string[];\n}\n\n/** Most component names that one target can list. */\nexport const GENERATIVE_UI_MAX_TARGET_COMPONENTS = 100;\n\n/** Most rejections that a surface summary lists. */\nexport const GENERATIVE_UI_MAX_SUMMARY_REJECTIONS = 20;\n/** Most characters of one rejection in a surface summary. */\nexport const GENERATIVE_UI_MAX_REJECTION_LENGTH = 500;\n\n/** One surface that the client holds, as the model sees it. */\nexport interface GenerativeUISurfaceSummary {\n target: string;\n /** The values that the user set, by path. Left out when there are none. */\n dataModel?: Record<string, unknown>;\n /**\n * Operations that the client dropped, as `\"operation <index>: <reason>\"`.\n * At most {@link GENERATIVE_UI_MAX_SUMMARY_REJECTIONS} entries of at most\n * {@link GENERATIVE_UI_MAX_REJECTION_LENGTH} characters. Left out when\n * there are none.\n */\n rejected?: string[];\n /**\n * Left out while the surface exists. `\"deleted\"`: a deleteSurface removed\n * it, and its id cannot be used again. `\"failed\"`: its createSurface was\n * rejected, so it does not exist; a corrected createSurface can use the id.\n */\n status?: \"deleted\" | \"failed\";\n}\n\n/** A user interaction bound to `{ event }`, sent to the agent. */\nexport interface GenerativeUIUserEvent {\n name: string;\n surfaceId: string;\n componentId: string;\n context: Record<string, unknown>;\n /** The resolved `event.userMessage`: the first line of the user message. */\n userMessage?: string;\n /** When the user acted, as an ISO 8601 string. Filled in when left out. */\n timestamp?: string;\n}\n\n/**\n * The A2UI 1.0 action message of a user event: what a renderer sends to the\n * agent when the user triggers an `{ event }` action. The run that the\n * event starts carries it in the envelope (`copilotkit_action`), next to\n * the visible user message.\n */\nexport interface A2UIActionMessage {\n version: typeof A2UI_VERSION;\n action: {\n name: string;\n surfaceId: string;\n sourceComponentId: string;\n /** ISO 8601. */\n timestamp: string;\n userMessage?: string;\n context: Record<string, unknown>;\n };\n}\n\n/**\n * The action message of a user event, with the A2UI field names. Takes the\n * time of the call when the event has no timestamp.\n *\n * @example\n * ```ts\n * toA2UIActionMessage({ name: \"buy\", surfaceId: \"s1\", componentId: \"b\", context: { sku: \"a\" } });\n * // { version: \"v1.0\", action: { name: \"buy\", surfaceId: \"s1\", sourceComponentId: \"b\", timestamp: \"2026-…\", context: { sku: \"a\" } } }\n * ```\n */\nexport function toA2UIActionMessage(\n event: GenerativeUIUserEvent,\n): A2UIActionMessage {\n return {\n version: A2UI_VERSION,\n action: {\n name: event.name,\n surfaceId: event.surfaceId,\n sourceComponentId: event.componentId,\n timestamp: event.timestamp ?? new Date().toISOString(),\n ...(event.userMessage === undefined\n ? {}\n : { userMessage: event.userMessage }),\n context: event.context,\n },\n };\n}\n"],"mappings":";;AACA,MAAa,eAAe;;AAE5B,MAAa,8BAA8B;;AAE3C,MAAa,4CACX;;AAEF,MAAa,4BAA4B;;AAEzC,MAAa,4BAA4B;;AAEzC,MAAa,wBAAwB;;;;;;;;;AASrC,MAAa,qCAAqC;;AAElD,MAAa,gDACX;;AAGF,SAAgB,6BAA6B,WAAmB;AAC9D,QAAO,SAAS;;;;;;;;;;;;;AAclB,SAAgB,kCAAkC,gBAAwB;AACxE,QAAO,YAAY;;;;;;;;AAwBrB,MAAa,+BAAoD,IAAI,IAAI;CACvE;CACA;CACA;CACD,CAAC;;AA8JF,MAAa,sCAAsC;;AAGnD,MAAa,uCAAuC;;AAEpD,MAAa,qCAAqC;;;;;;;;;;;AA+DlD,SAAgB,oBACd,OACmB;AACnB,QAAO;EACL,SAAS;EACT,QAAQ;GACN,MAAM,MAAM;GACZ,WAAW,MAAM;GACjB,mBAAmB,MAAM;GACzB,WAAW,MAAM,8BAAa,IAAI,MAAM,EAAC,aAAa;GACtD,GAAI,MAAM,gBAAgB,SACtB,EAAE,GACF,EAAE,aAAa,MAAM,aAAa;GACtC,SAAS,MAAM;GAChB;EACF"}
1
+ {"version":3,"file":"types.mjs","names":[],"sources":["../../src/generative-ui/types.ts"],"sourcesContent":["/** A2UI protocol version used on the wire. */\nexport const A2UI_VERSION = \"1.0\";\n/** Activity type of a generated surface message. */\nexport const GENERATIVE_UI_ACTIVITY_TYPE = \"generative-ui-surface\";\n/** Activity type of a function call that the agent asks the client to run. */\nexport const GENERATIVE_UI_FUNCTION_CALL_ACTIVITY_TYPE =\n \"generative-ui-function-call\";\n/** Tool the model calls to render or update surfaces. */\nexport const GENERATIVE_UI_RENDER_TOOL = \"render_ui\";\n/** Target id of the chat transcript. */\nexport const GENERATIVE_UI_CHAT_TARGET = \"chat\";\n/** Component id every surface renders from. */\nexport const GENERATIVE_UI_ROOT_ID = \"root\";\n/**\n * Whether the agent may call renderer functions with `callRendererFunction`.\n * Off for now: the result goes back as a developer message, and not every\n * backend keeps that message where the model reads it in order. While off,\n * the prompts do not mention the operation, the validator rejects it, and\n * the dispatcher refuses the agent, whatever a declaration's\n * `allowedCallers` says. The code and its tests stay for when it is on.\n */\nexport const GENERATIVE_UI_AGENT_FUNCTION_CALLS = false;\n/** The reason an agent function call is rejected while they are off. */\nexport const GENERATIVE_UI_AGENT_FUNCTION_CALLS_OFF_REASON =\n \"callRendererFunction is not supported in this version: the agent cannot call renderer functions until their results can be sent back to it reliably\";\n\n/** Activity message id of a surface. One message per surface. */\nexport function generativeUISurfaceMessageId(surfaceId: string) {\n return `genui:${surfaceId}`;\n}\n\n/**\n * Activity message id of an agent-called function. One message per\n * `functionCallId`.\n *\n * @param functionCallId - The `functionCallId` of the `callRendererFunction` operation.\n *\n * @example\n * ```ts\n * generativeUIFunctionCallMessageId(\"f1\"); // \"genui-fn:f1\"\n * ```\n */\nexport function generativeUIFunctionCallMessageId(functionCallId: string) {\n return `genui-fn:${functionCallId}`;\n}\n\nimport type {\n A2UIFunctionPermissions,\n A2UIFunctionReturnType,\n} from \"./basic-functions\";\n\n// Named `GenerativeUIJSONSchema` because the package root already exports a\n// `JSONSchema` (utils/json-schema.ts); the bare name would collide.\nexport type GenerativeUIJSONSchema = Record<string, unknown>;\n\nexport type A2UIComponentNode = {\n id: string;\n component: string;\n [prop: string]: unknown;\n};\n\n/**\n * The keys of the A2UI 1.0 component envelope next to `id` and\n * `component`: `catalogId`, `accessibility` and `metadata`. They are not\n * props of the component. The renderer reads `accessibility` and ignores\n * the other two.\n */\nexport const A2UI_COMPONENT_ENVELOPE_KEYS: ReadonlySet<string> = new Set([\n \"catalogId\",\n \"accessibility\",\n \"metadata\",\n]);\n\n/**\n * A call of a named function: `{ \"@call\": \"addToCart\", \"args\": { ... } }`.\n * Without `catalogId`, the function comes from the catalog of the run.\n */\nexport type A2UIFunctionCall = {\n \"@call\": string;\n args?: Record<string, unknown>;\n catalogId?: string;\n};\n\nexport type A2UIOperation =\n | {\n version: typeof A2UI_VERSION;\n createSurface: {\n surfaceId: string;\n /** Left out by the model. The run's catalog id is filled in. */\n catalogId?: string;\n /** Components to add at once, checked like `updateComponents`. */\n components?: A2UIComponentNode[];\n /** The initial root data model. */\n dataModel?: Record<string, unknown>;\n sendDataModel?: boolean;\n metadata?: { extensions?: Record<string, unknown> };\n };\n }\n | {\n version: typeof A2UI_VERSION;\n updateComponents: { surfaceId: string; components: A2UIComponentNode[] };\n }\n | {\n version: typeof A2UI_VERSION;\n /**\n * Sets `value` at `path`. A `null` value deletes the key at `path`.\n * With no `path`, or `\"/\"`, it sets the whole data model.\n */\n updateDataModel: { surfaceId: string; path?: string; value: unknown };\n }\n | {\n version: typeof A2UI_VERSION;\n deleteSurface: { surfaceId: string };\n }\n | {\n version: typeof A2UI_VERSION;\n /** Runs an app function in the browser, with no user interaction. */\n callRendererFunction: {\n functionCallId: string;\n callFunction: A2UIFunctionCall;\n };\n };\n\n/** Value of an event prop: run a host function, or report the event to the agent. */\nexport type GenerativeUIActionBinding =\n | {\n event: {\n name: string;\n /**\n * First line of the user message that the event becomes: text, a\n * data binding, or a function value such as formatString.\n */\n userMessage?: string | { \"@path\": string } | A2UIFunctionCall;\n context?: Record<string, unknown>;\n };\n }\n | { functionCall: A2UIFunctionCall };\n\nexport type GenerativeUISurfaceStatus = \"streaming\" | \"ready\" | \"error\";\n\nexport interface GenerativeUIRejectedOperation {\n /** Position of the operation in the render_ui call, or in the content list. */\n index: number;\n reason: string;\n}\n\n/** Content of a `generative-ui-surface` activity message. */\nexport interface GenerativeUISurfaceContent {\n surfaceId: string;\n target: string;\n catalogId: string;\n /** Committed (validated) operations, cumulative. */\n operations: A2UIOperation[];\n status: GenerativeUISurfaceStatus;\n rejected: GenerativeUIRejectedOperation[];\n}\n\n/** Content of a `generative-ui-function-call` activity message. */\nexport interface GenerativeUIFunctionCallContent {\n functionCallId: string;\n callFunction: A2UIFunctionCall;\n}\n\n/**\n * Value of a \"multiple\" slot that repeats one component for each item of the\n * list at `path`. Paths inside the repeated component are relative to the item.\n */\nexport type GenerativeUITemplateChildren = {\n componentId: string;\n path: string;\n};\n\nexport interface GenerativeUIComponentManifest {\n /** CopilotKit positional order across model-visible props, slots and events.\n * Exporters encode this as JSON Schema property order; it is not an A2UI keyword. */\n parameterOrder?: readonly string[];\n description?: string;\n props: GenerativeUIJSONSchema;\n events?: Record<\n string,\n { description?: string; parameters: GenerativeUIJSONSchema }\n >;\n /**\n * Props that hold child components. A \"single\" slot takes one component id.\n * A \"multiple\" slot takes a `string[]` of component ids, or a\n * {@link GenerativeUITemplateChildren} template.\n */\n slots?: Record<string, \"single\" | \"multiple\">;\n}\n\nexport interface GenerativeUIFunctionManifest extends A2UIFunctionPermissions {\n description?: string;\n parameters: GenerativeUIJSONSchema;\n /** What the function gives back, as A2UI 1.0 names it. */\n returnType?: A2UIFunctionReturnType;\n}\n\n/** Serializable description of what the browser can render and call. */\nexport interface GenerativeUIManifest {\n /** The catalog of the run. A surface with no `catalogId` gets this one. */\n catalogId: string;\n /**\n * Every catalog that a `catalogId` can name: `catalogId` first, then the\n * catalogs of `extends`. Left out, only `catalogId`.\n */\n catalogIds?: string[];\n components: Record<string, GenerativeUIComponentManifest>;\n functions: Record<string, GenerativeUIFunctionManifest>;\n /**\n * Places where the model can render surfaces. Only mounted targets are\n * listed. `description` tells the model where the target is on the page\n * and what to put in it.\n */\n targets: GenerativeUITarget[];\n /** Surfaces the client already holds for the current thread. */\n surfaces: Record<string, GenerativeUISurfaceSummary>;\n}\n\n/** A place where the model can render surfaces. */\nexport interface GenerativeUITarget {\n id: string;\n kind: \"chat\" | \"inline\";\n description?: string;\n /**\n * The only components that the surfaces of this target can use, at most\n * {@link GENERATIVE_UI_MAX_TARGET_COMPONENTS} names. Left out, the target\n * takes every component of the catalog.\n */\n components?: string[];\n}\n\n/** Most component names that one target can list. */\nexport const GENERATIVE_UI_MAX_TARGET_COMPONENTS = 100;\n\n/** Most rejections that a surface summary lists. */\nexport const GENERATIVE_UI_MAX_SUMMARY_REJECTIONS = 20;\n/** Most characters of one rejection in a surface summary. */\nexport const GENERATIVE_UI_MAX_REJECTION_LENGTH = 500;\n\n/** One surface that the client holds, as the model sees it. */\nexport interface GenerativeUISurfaceSummary {\n target: string;\n /** The values that the user set, by path. Left out when there are none. */\n dataModel?: Record<string, unknown>;\n /**\n * Operations that the client dropped, as `\"operation <index>: <reason>\"`.\n * At most {@link GENERATIVE_UI_MAX_SUMMARY_REJECTIONS} entries of at most\n * {@link GENERATIVE_UI_MAX_REJECTION_LENGTH} characters. Left out when\n * there are none.\n */\n rejected?: string[];\n /**\n * Left out while the surface exists. `\"deleted\"`: a deleteSurface removed\n * it, and its id cannot be used again. `\"failed\"`: its createSurface was\n * rejected, so it does not exist; a corrected createSurface can use the id.\n */\n status?: \"deleted\" | \"failed\";\n}\n\n/** A user interaction bound to `{ event }`, sent to the agent. */\nexport interface GenerativeUIUserEvent {\n name: string;\n surfaceId: string;\n componentId: string;\n context: Record<string, unknown>;\n /** The resolved `event.userMessage`: the first line of the user message. */\n userMessage?: string;\n /** When the user acted, as an ISO 8601 string. Filled in when left out. */\n timestamp?: string;\n}\n\n/**\n * The A2UI 1.0 action message of a user event: what a renderer sends to the\n * agent when the user triggers an `{ event }` action. The run that the\n * event starts carries it in the envelope (`copilotkit_action`), next to\n * the visible user message.\n */\nexport interface A2UIActionMessage {\n version: typeof A2UI_VERSION;\n action: {\n name: string;\n surfaceId: string;\n sourceComponentId: string;\n /** ISO 8601. */\n timestamp: string;\n userMessage?: string;\n context: Record<string, unknown>;\n };\n}\n\n/**\n * The action message of a user event, with the A2UI field names. Takes the\n * time of the call when the event has no timestamp.\n *\n * @example\n * ```ts\n * toA2UIActionMessage({ name: \"buy\", surfaceId: \"s1\", componentId: \"b\", context: { sku: \"a\" } });\n * // { version: \"1.0\", action: { name: \"buy\", surfaceId: \"s1\", sourceComponentId: \"b\", timestamp: \"2026-…\", context: { sku: \"a\" } } }\n * ```\n */\nexport function toA2UIActionMessage(\n event: GenerativeUIUserEvent,\n): A2UIActionMessage {\n return {\n version: A2UI_VERSION,\n action: {\n name: event.name,\n surfaceId: event.surfaceId,\n sourceComponentId: event.componentId,\n timestamp: event.timestamp ?? new Date().toISOString(),\n ...(event.userMessage === undefined\n ? {}\n : { userMessage: event.userMessage }),\n context: event.context,\n },\n };\n}\n"],"mappings":";;AACA,MAAa,eAAe;;AAE5B,MAAa,8BAA8B;;AAE3C,MAAa,4CACX;;AAEF,MAAa,4BAA4B;;AAEzC,MAAa,4BAA4B;;AAEzC,MAAa,wBAAwB;;;;;;;;;AASrC,MAAa,qCAAqC;;AAElD,MAAa,gDACX;;AAGF,SAAgB,6BAA6B,WAAmB;AAC9D,QAAO,SAAS;;;;;;;;;;;;;AAclB,SAAgB,kCAAkC,gBAAwB;AACxE,QAAO,YAAY;;;;;;;;AAwBrB,MAAa,+BAAoD,IAAI,IAAI;CACvE;CACA;CACA;CACD,CAAC;;AAiKF,MAAa,sCAAsC;;AAGnD,MAAa,uCAAuC;;AAEpD,MAAa,qCAAqC;;;;;;;;;;;AA+DlD,SAAgB,oBACd,OACmB;AACnB,QAAO;EACL,SAAS;EACT,QAAQ;GACN,MAAM,MAAM;GACZ,WAAW,MAAM;GACjB,mBAAmB,MAAM;GACzB,WAAW,MAAM,8BAAa,IAAI,MAAM,EAAC,aAAa;GACtD,GAAI,MAAM,gBAAgB,SACtB,EAAE,GACF,EAAE,aAAa,MAAM,aAAa;GACtC,SAAS,MAAM;GAChB;EACF"}
@@ -375,11 +375,11 @@ function childRefProblem(node, ref, ownId) {
375
375
  const isDynamic = (value) => isPathBinding(value) || require_is_record.isRecord(value) && "@call" in value;
376
376
  const visit = (value, steps) => {
377
377
  if (isDynamic(value)) return void 0;
378
- if (steps.length === 0) {
378
+ const [head, ...rest] = steps;
379
+ if (head === void 0) {
379
380
  const reason = slotProblem(value, ref.kind, ownId);
380
381
  return reason ? `${label}: ${reason}` : void 0;
381
382
  }
382
- const [head, ...rest] = steps;
383
383
  if (head === "*") {
384
384
  if (!Array.isArray(value)) return void 0;
385
385
  for (const item of value) {
@@ -1 +1 @@
1
- {"version":3,"file":"validate-operation.cjs","names":["isRecord","A2UI_VERSION","GENERATIVE_UI_AGENT_FUNCTION_CALLS","GENERATIVE_UI_AGENT_FUNCTION_CALLS_OFF_REASON","isCallBinding","GENERATIVE_UI_FUNCTIONS","functionCallers","isA2UIValueFunction","isA2UIBasicFunction","collectChildRefs"],"sources":["../../src/generative-ui/validate-operation.ts"],"sourcesContent":["import {\n GENERATIVE_UI_FUNCTIONS,\n functionCallers,\n isA2UIBasicFunction,\n isA2UIValueFunction,\n isCallBinding,\n} from \"./basic-functions\";\nimport type { A2UIFunctionPermissions } from \"./basic-functions\";\nimport { collectChildRefs } from \"./child-refs\";\nimport type { ChildRef } from \"./child-refs\";\nimport {\n A2UI_VERSION,\n GENERATIVE_UI_AGENT_FUNCTION_CALLS,\n GENERATIVE_UI_AGENT_FUNCTION_CALLS_OFF_REASON,\n} from \"./types\";\nimport type {\n GenerativeUIActionBinding,\n GenerativeUIJSONSchema,\n GenerativeUIManifest,\n} from \"./types\";\nimport { isRecord } from \"./is-record\";\n\nexport type OperationValidation = { ok: true } | { ok: false; reason: string };\n\nconst OPERATION_KINDS = [\n \"createSurface\",\n \"updateComponents\",\n \"updateDataModel\",\n \"deleteSurface\",\n \"callRendererFunction\",\n] as const;\nexport type OperationKind = (typeof OPERATION_KINDS)[number];\n\nexport interface ValidateOperationOptions {\n manifest: Pick<\n GenerativeUIManifest,\n \"catalogId\" | \"catalogIds\" | \"components\"\n >;\n /**\n * Surfaces that exist before this operation is applied. `updateComponents`,\n * `updateDataModel`, and `deleteSurface` need their surface in this set.\n */\n knownSurfaces: ReadonlySet<string>;\n /**\n * Surface ids that were created before, also the deleted ones. A surface id\n * is unique for the life of the page, so `createSurface` rejects them.\n */\n createdSurfaces?: ReadonlySet<string>;\n /**\n * UI-callable functions. When provided, `functionCall` bindings and\n * `callRendererFunction` must name one of them. The client omits it:\n * availability is checked when the function runs.\n */\n functions?: GenerativeUIManifest[\"functions\"];\n /**\n * The components that the target of the surface takes. When provided,\n * `updateComponents` and the inline components of `createSurface` can use\n * only these names. Left out, every catalog component is allowed.\n */\n allowedComponents?: AllowedComponents;\n}\n\n/** The component names that one target takes. */\nexport interface AllowedComponents {\n /** The target id, for the reason of a rejection. */\n target: string;\n names: ReadonlySet<string>;\n}\n\nconst OK: OperationValidation = { ok: true };\nconst fail = (reason: string): OperationValidation => ({ ok: false, reason });\n\n/** Models write the v0.9 binding from habit. The reason names the v1.0 form. */\nconst V09_PATH_REASON = 'bind data with {\"@path\": \"/x\"}, not {\"path\": \"/x\"}';\n\nfunction hasOwn(record: object, key: string) {\n return Object.prototype.hasOwnProperty.call(record, key);\n}\n\n/**\n * Reads an own property only. Model-controlled keys such as \"constructor\" or\n * \"toString\" must not resolve to Object.prototype members.\n */\nfunction ownValue<T>(record: Record<string, T> | undefined, key: string) {\n return record && hasOwn(record, key) ? record[key] : undefined;\n}\n\nexport function getOperationKind(op: unknown) {\n if (!isRecord(op)) return undefined;\n const kinds = OPERATION_KINDS.filter((kind) => kind in op);\n return kinds.length === 1 ? kinds[0] : undefined;\n}\n\n/** The `surfaceId` of a surface operation. `callRendererFunction` has none. */\nexport function getOperationSurfaceId(op: unknown) {\n if (!isRecord(op)) return undefined;\n const kind = getOperationKind(op);\n if (!kind) return undefined;\n const payload = op[kind];\n return isRecord(payload) && typeof payload.surfaceId === \"string\"\n ? payload.surfaceId\n : undefined;\n}\n\n/** `{ \"@path\": \"/x\" }`: a data-model binding. */\nexport function isPathBinding(value: unknown): value is { \"@path\": string } {\n return (\n isRecord(value) &&\n typeof value[\"@path\"] === \"string\" &&\n Object.keys(value).length === 1\n );\n}\n\n/** `{ \"path\": \"/x\" }`: the v0.9 binding, which v1.0 does not accept. */\nfunction isV09PathBinding(value: unknown) {\n return (\n isRecord(value) &&\n typeof value.path === \"string\" &&\n Object.keys(value).length === 1\n );\n}\n\n/**\n * `{ \"@call\": \"@index\" }` or `{ \"@call\": \"@index\", \"args\": { \"offset\": 1 } }`:\n * the 0-based position of the item in a template, plus `offset`.\n */\nexport function isIndexCall(\n value: unknown,\n): value is { \"@call\": \"@index\"; args?: { offset?: number } } {\n if (!isRecord(value) || value[\"@call\"] !== \"@index\") return false;\n const hasOnlyCallKeys = Object.keys(value).every(\n (key) => key === \"@call\" || key === \"args\",\n );\n if (!hasOnlyCallKeys) return false;\n const { args } = value;\n if (args === undefined) return true;\n return (\n isRecord(args) &&\n Object.keys(args).every((key) => key === \"offset\") &&\n (args.offset === undefined || Number.isFinite(args.offset))\n );\n}\n\nexport function isActionBinding(\n value: unknown,\n): value is GenerativeUIActionBinding {\n return (\n isRecord(value) &&\n Object.keys(value).length === 1 &&\n (isRecord(value.functionCall) || isRecord(value.event))\n );\n}\n\n/**\n * Checks one A2UI v1.0 operation against the catalog and the surfaces that\n * exist. The operation comes from the model, so nothing in it is trusted.\n *\n * @param op - The operation, as parsed from JSON.\n * @param options - The catalog, the known and created surfaces, the\n * functions that the UI can call, and the components that the target of\n * the surface takes.\n *\n * @example\n * ```ts\n * const result = validateOperation(op, { manifest, knownSurfaces });\n * if (!result.ok) rejected.push({ index, reason: result.reason });\n * ```\n */\nexport function validateOperation(\n op: unknown,\n options: ValidateOperationOptions,\n) {\n if (!isRecord(op)) return fail(\"operation must be a JSON object\");\n if (op.version !== A2UI_VERSION) return fail(versionProblem(op.version));\n const kind = getOperationKind(op);\n if (!kind) {\n return fail(\n `operation must contain exactly one of ${OPERATION_KINDS.join(\", \")}`,\n );\n }\n const payload = op[kind];\n if (kind === \"callRendererFunction\") {\n if (!GENERATIVE_UI_AGENT_FUNCTION_CALLS) {\n return fail(GENERATIVE_UI_AGENT_FUNCTION_CALLS_OFF_REASON);\n }\n return validateRendererFunctionCall(payload, options);\n }\n if (\n !isRecord(payload) ||\n typeof payload.surfaceId !== \"string\" ||\n !payload.surfaceId\n ) {\n return fail(`${kind}.surfaceId is required`);\n }\n const surfaceId = payload.surfaceId;\n if (kind === \"createSurface\") {\n return validateCreateSurface(payload, surfaceId, options);\n }\n if (!options.knownSurfaces.has(surfaceId)) {\n return fail(\n `surface \"${surfaceId}\" does not exist; send createSurface first`,\n );\n }\n switch (kind) {\n case \"deleteSurface\":\n return OK;\n case \"updateDataModel\":\n return validateDataModelUpdate(payload);\n case \"updateComponents\":\n return validateComponents(\n payload.components,\n \"updateComponents.components\",\n options,\n );\n }\n}\n\nfunction versionProblem(version: unknown) {\n return typeof version === \"string\"\n ? `unsupported version \"${version}\"; use \"${A2UI_VERSION}\"`\n : `operation needs \"version\":\"${A2UI_VERSION}\"`;\n}\n\n/** A `catalogId` can name the catalog of the run or one of its bases. */\nfunction catalogProblem(\n catalogId: unknown,\n manifest: ValidateOperationOptions[\"manifest\"],\n) {\n const ids = manifest.catalogIds ?? [manifest.catalogId];\n if (catalogId === undefined || ids.includes(catalogId as string)) {\n return undefined;\n }\n const names = ids.map((id) => `\"${id}\"`).join(\", \");\n const use = ids.length === 1 ? names : `one of: ${names}`;\n return `unknown catalog \"${String(catalogId)}\"; leave out catalogId or use ${use}`;\n}\n\nfunction validateCreateSurface(\n payload: Record<string, unknown>,\n surfaceId: string,\n options: ValidateOperationOptions,\n) {\n if (options.knownSurfaces.has(surfaceId)) {\n return fail(`surface \"${surfaceId}\" already exists`);\n }\n if (options.createdSurfaces?.has(surfaceId)) {\n return fail(\n `surface id \"${surfaceId}\" was used before; use a new surfaceId`,\n );\n }\n const catalogReason = catalogProblem(payload.catalogId, options.manifest);\n if (catalogReason) return fail(catalogReason);\n const { dataModel, components } = payload;\n if (dataModel !== undefined && !isRecord(dataModel)) {\n return fail(\"createSurface.dataModel must be a JSON object\");\n }\n if (components === undefined) return OK;\n return validateComponents(components, \"createSurface.components\", options);\n}\n\nfunction validateRendererFunctionCall(\n payload: unknown,\n options: ValidateOperationOptions,\n) {\n const hasCallId =\n isRecord(payload) &&\n typeof payload.functionCallId === \"string\" &&\n payload.functionCallId !== \"\";\n if (!hasCallId) {\n return fail(\n \"callRendererFunction.functionCallId must be a non-empty string\",\n );\n }\n const reason = functionCallProblem(\n payload.callFunction,\n \"callRendererFunction.callFunction\",\n options,\n );\n return reason ? fail(reason) : OK;\n}\n\nconst FORBIDDEN_SEGMENTS = new Set([\"__proto__\", \"constructor\", \"prototype\"]);\n\nfunction decodeSegment(segment: string) {\n return segment.replace(/~([01])/g, (_, g) => (g === \"1\" ? \"/\" : \"~\"));\n}\n\nfunction validateDataModelUpdate(payload: Record<string, unknown>) {\n if (payload.value === undefined) {\n return fail(\n 'updateDataModel.value is required; use \"value\":null to delete',\n );\n }\n const path = payload.path ?? \"/\";\n if (typeof path !== \"string\" || !path.startsWith(\"/\")) {\n return fail(\"updateDataModel.path must be an absolute JSON pointer\");\n }\n if (path === \"/\") {\n // Paths such as \"/items\" point into the root, so the root must be an object.\n if (!isRecord(payload.value)) {\n return fail(\"a root updateDataModel value must be a JSON object\");\n }\n return OK;\n }\n const reason = pathProblem(path, \"updateDataModel.path\");\n return reason ? fail(reason) : OK;\n}\n\n/**\n * Checks the segments of an absolute JSON pointer (\"/a/b\") or of a path\n * relative to a template item (\"a/b\"). `label` names the field in the reason.\n */\nfunction pathProblem(path: string, label: string) {\n const relative = path.startsWith(\"/\") ? path.slice(1) : path;\n const segments = relative.split(\"/\");\n if (segments.some((segment) => segment === \"\")) {\n return `${label} must not contain empty segments`;\n }\n const decoded = segments.map(decodeSegment);\n const forbidden = decoded.find((segment) => FORBIDDEN_SEGMENTS.has(segment));\n if (forbidden !== undefined) {\n return `path segment \"${forbidden}\" is not allowed in ${label}`;\n }\n return undefined;\n}\n\nfunction validateComponents(\n components: unknown,\n label: string,\n options: ValidateOperationOptions,\n) {\n if (!Array.isArray(components) || components.length === 0) {\n return fail(`${label} must be a non-empty array`);\n }\n const ids = new Set<string>();\n for (const node of components) {\n if (!isRecord(node)) return fail(\"component must be a JSON object\");\n const { id } = node;\n if (typeof id !== \"string\" || !id) return fail(\"id is required\");\n const reason = nodeProblem(node, id, options);\n if (reason) return fail(`component \"${id}\": ${reason}`);\n if (ids.has(id)) {\n return fail(`component \"${id}\" appears twice in one update`);\n }\n ids.add(id);\n }\n return OK;\n}\n\nfunction nodeProblem(\n node: Record<string, unknown>,\n id: string,\n options: ValidateOperationOptions,\n) {\n if (typeof node.component !== \"string\") return \"component type is required\";\n const entry = ownValue(options.manifest.components, node.component);\n if (!entry) return `unknown component \"${node.component}\"`;\n const { allowedComponents } = options;\n if (allowedComponents && !allowedComponents.names.has(node.component)) {\n const names = [...allowedComponents.names].join(\", \") || \"none\";\n return `\"${node.component}\" is not allowed in target \"${allowedComponents.target}\"; use one of: ${names}`;\n }\n const { properties, required } = entry.props;\n const propNames = isRecord(properties) ? Object.keys(properties) : [];\n const props = Object.entries(node);\n for (const [key, value] of props) {\n if (key === \"id\" || key === \"component\") continue;\n if (key === \"catalogId\") {\n const reason = catalogProblem(value, options.manifest);\n if (reason) return `${key}: ${reason}`;\n continue;\n }\n if (key === \"metadata\") {\n const isMetadata =\n isRecord(value) &&\n (value.extensions === undefined || isRecord(value.extensions));\n if (!isMetadata) return 'metadata must be { \"extensions\": { ... } }';\n continue;\n }\n if (key === \"accessibility\") {\n const reason = accessibilityProblem(value);\n if (reason) return `${key}: ${reason}`;\n continue;\n }\n if (ownValue(entry.events, key)) {\n const reason = actionBindingProblem(value, options);\n if (reason) return `${key}: ${reason}`;\n continue;\n }\n const slot = ownValue(entry.slots, key);\n if (slot) {\n const reason = slotProblem(value, slot, id);\n if (reason) return `${key}: ${reason}`;\n continue;\n }\n if (!propNames.includes(key)) return `unknown prop \"${key}\"`;\n if (isV09PathBinding(value)) return `${key}: ${V09_PATH_REASON}`;\n const call = findForbiddenCall(value, { allowValueFunctions: true });\n if (call !== undefined) {\n return `${key}: ${call}; a data prop can call only ${VALUE_FUNCTION_LIST}`;\n }\n }\n for (const ref of childRefsOf(entry.props)) {\n const reason = childRefProblem(node, ref, id);\n if (reason) return reason;\n }\n const requiredNames = Array.isArray(required) ? required : [];\n for (const name of requiredNames) {\n if (typeof name === \"string\" && !(name in node)) {\n return `missing required prop \"${name}\"`;\n }\n }\n return undefined;\n}\n\nconst ACCESSIBILITY_KEYS = [\"label\", \"description\", \"live\", \"hidden\"];\nconst LIVE_VALUES = [\"off\", \"polite\", \"assertive\"];\n\n/**\n * Checks the `accessibility` of a component envelope: `label` and\n * `description` are strings or dynamic values, `live` is one of the ARIA\n * values, `hidden` is a boolean or a dynamic value.\n */\nfunction accessibilityProblem(value: unknown) {\n if (!isRecord(value)) {\n return 'must be { \"label\": \"...\", \"description\": \"...\", \"live\": \"polite\", \"hidden\": false }';\n }\n const isDynamic = (field: unknown) =>\n isPathBinding(field) || isCallBinding(field);\n for (const [key, field] of Object.entries(value)) {\n if (!ACCESSIBILITY_KEYS.includes(key)) return `unknown key \"${key}\"`;\n if (isV09PathBinding(field)) return `${key}: ${V09_PATH_REASON}`;\n if (isDynamic(field)) {\n const call = findForbiddenCall(field, { allowValueFunctions: true });\n if (call !== undefined) return `${key}: ${call}`;\n continue;\n }\n if (key === \"live\") {\n if (typeof field !== \"string\" || !LIVE_VALUES.includes(field)) {\n return `live must be one of ${LIVE_VALUES.join(\", \")}`;\n }\n } else if (key === \"hidden\") {\n if (typeof field !== \"boolean\") return \"hidden must be a boolean\";\n } else if (typeof field !== \"string\") {\n return `${key} must be a string`;\n }\n }\n return undefined;\n}\n\nfunction actionBindingProblem(\n value: unknown,\n options: ValidateOperationOptions,\n) {\n if (!isRecord(value)) return \"must be an action object\";\n const keys = Object.keys(value);\n const isOneAction =\n keys.length === 1 && (keys[0] === \"functionCall\" || keys[0] === \"event\");\n if (!isOneAction) {\n return 'must be { \"event\": ... } or { \"functionCall\": ... }';\n }\n if (keys[0] === \"functionCall\") {\n return functionCallProblem(value.functionCall, \"functionCall\", options);\n }\n return eventProblem(value.event);\n}\n\n/**\n * Checks `{ \"@call\": \"<function>\", \"args\": { ... } }`. `label` names the\n * field in the reason.\n */\nfunction functionCallProblem(\n call: unknown,\n label: string,\n options: ValidateOperationOptions,\n) {\n if (!isRecord(call)) {\n return `${label} must be { \"@call\": \"<function>\", \"args\": { ... } }`;\n }\n const name = call[\"@call\"];\n if (typeof name !== \"string\" || !name) {\n return typeof call.call === \"string\"\n ? `${label} names the function with \"@call\", not \"call\"`\n : `${label}[\"@call\"] must be a function name`;\n }\n const { args } = call;\n if (args !== undefined && !isRecord(args)) {\n return `${label}.args must be an object`;\n }\n const catalogReason = catalogProblem(call.catalogId, options.manifest);\n if (catalogReason) return `${label}: ${catalogReason}`;\n const argEntries = Object.entries(args ?? {});\n for (const [key, arg] of argEntries) {\n if (isV09PathBinding(arg))\n return `${label}.args.${key}: ${V09_PATH_REASON}`;\n }\n // A function the app declares under a built-in name is the app's; the\n // restrictions of the built-in do not apply to it.\n const appFunctions = options.functions;\n const declared =\n appFunctions !== undefined && hasOwn(appFunctions, name)\n ? appFunctions[name]\n : undefined;\n const builtIn =\n declared === undefined && hasOwn(GENERATIVE_UI_FUNCTIONS, name)\n ? GENERATIVE_UI_FUNCTIONS[name]\n : undefined;\n if (declared === undefined && builtIn === undefined) {\n return appFunctions === undefined\n ? undefined\n : `function \"${name}\" is not exposed to generative UI`;\n }\n // Without the list of app functions, a built-in name may be the app's own\n // function, so the dispatcher applies the restriction when the call runs.\n if (declared === undefined && appFunctions === undefined) return undefined;\n return callerProblem(\n name,\n declared ?? builtIn!,\n label.startsWith(\"callRendererFunction\") ? \"agent\" : \"renderer\",\n );\n}\n\n/**\n * Why `caller` may not call a function with these permissions, or\n * `undefined` when it may. The dispatcher gives the same reasons at run\n * time, for the calls that are not validated against a function list.\n */\nexport function callerProblem(\n name: string,\n fn: A2UIFunctionPermissions,\n caller: \"agent\" | \"renderer\",\n) {\n const callers = functionCallers(fn);\n if (caller === \"agent\" && !callers.agent) {\n return fn.requiresUserActivation\n ? `function \"${name}\" runs only from a user gesture; the agent cannot call it`\n : `function \"${name}\" runs only in the UI (allowedCallers \"rendererOnly\"); the agent cannot call it`;\n }\n if (caller === \"renderer\" && !callers.renderer) {\n return `function \"${name}\" runs only for the agent (allowedCallers \"agentOnly\"); the UI cannot call it`;\n }\n return undefined;\n}\n\nfunction eventProblem(event: unknown) {\n if (!isRecord(event) || typeof event.name !== \"string\" || !event.name) {\n return \"event.name is required\";\n }\n const { userMessage, context } = event;\n const isUserMessage =\n userMessage === undefined ||\n typeof userMessage === \"string\" ||\n isPathBinding(userMessage) ||\n (isRecord(userMessage) &&\n typeof userMessage[\"@call\"] === \"string\" &&\n findForbiddenCall(userMessage, { allowValueFunctions: true }) ===\n undefined);\n if (!isUserMessage) {\n return isV09PathBinding(userMessage)\n ? `event.userMessage: ${V09_PATH_REASON}`\n : 'event.userMessage must be a string, {\"@path\": \"/x\"} or a function value';\n }\n if (context === undefined) return undefined;\n if (!isRecord(context)) return \"event.context must be an object\";\n const entries = Object.entries(context);\n for (const [key, entry] of entries) {\n if (isV09PathBinding(entry)) {\n return `event.context.${key}: ${V09_PATH_REASON}`;\n }\n const call = findForbiddenCall(entry, { allowValueFunctions: true });\n if (call !== undefined) {\n return `event.context.${key}: ${call}; a context value can call only ${VALUE_FUNCTION_LIST}`;\n }\n }\n return undefined;\n}\n\nfunction slotProblem(\n value: unknown,\n kind: \"single\" | \"multiple\",\n ownId: string,\n) {\n const isTemplate = isRecord(value) && \"componentId\" in value;\n if (kind === \"single\" && isTemplate) {\n return 'a template { \"componentId\", \"path\" } is only allowed in a \"multiple\" slot';\n }\n if (kind === \"multiple\" && isTemplate) {\n return templateProblem(value, ownId);\n }\n if (kind === \"multiple\" && !Array.isArray(value)) {\n return 'must be an array of component ids or a template { \"componentId\", \"path\" }';\n }\n const ids = kind === \"multiple\" && Array.isArray(value) ? value : [value];\n for (const id of ids) {\n if (typeof id !== \"string\" || !id)\n return \"must reference component ids (strings)\";\n if (id === ownId) return \"a component cannot be its own child\";\n }\n return undefined;\n}\n\nfunction templateProblem(template: Record<string, unknown>, ownId: string) {\n const hasOnlyTemplateKeys = Object.keys(template).every(\n (key) => key === \"componentId\" || key === \"path\",\n );\n if (!hasOnlyTemplateKeys) {\n return 'a template takes only \"componentId\" and \"path\"';\n }\n const { componentId, path } = template;\n if (typeof componentId !== \"string\" || !componentId) {\n return \"template componentId must be a component id\";\n }\n if (componentId === ownId) return \"a component cannot be its own child\";\n if (typeof path !== \"string\" || !path) {\n return \"template path must be a JSON pointer or a relative path\";\n }\n return pathProblem(path, \"template path\");\n}\n\nconst VALUE_FUNCTION_LIST = `@index and the built-in functions (${Object.keys(\n GENERATIVE_UI_FUNCTIONS,\n)\n .filter(isA2UIValueFunction)\n .join(\", \")})`;\n\n/**\n * The reason for the first function call in `value` that a data value may\n * not make, at any depth, or `undefined`. A data value may call `@index`\n * and, with `allowValueFunctions`, the basic functions that need no user\n * gesture; the renderer resolves those. An app function, `openUrl`, or an\n * event binding is not a value.\n */\n// The annotation is needed: the function calls itself in its return.\nfunction findForbiddenCall(\n value: unknown,\n options: { allowValueFunctions: boolean },\n): string | undefined {\n if (Array.isArray(value)) {\n for (const item of value) {\n const reason = findForbiddenCall(item, options);\n if (reason !== undefined) return reason;\n }\n return undefined;\n }\n if (!isRecord(value)) return undefined;\n if (isIndexCall(value)) return undefined;\n if (value[\"@call\"] === \"@index\") return \"@index takes only an offset\";\n if (typeof value.call === \"string\") {\n return 'name the function with \"@call\", not \"call\"';\n }\n if (\"functionCall\" in value) {\n return \"an event binding is not a value\";\n }\n const name = value[\"@call\"];\n if (typeof name === \"string\") {\n if (!options.allowValueFunctions || !isA2UIValueFunction(name)) {\n return isA2UIBasicFunction(name)\n ? `\"${name}\" runs only from an event`\n : `\"${name}\" is not a basic function`;\n }\n const args = value.args;\n if (args !== undefined && !isRecord(args)) {\n return `the args of \"${name}\" must be an object`;\n }\n return args === undefined ? undefined : findForbiddenCall(args, options);\n }\n for (const item of Object.values(value)) {\n const reason = findForbiddenCall(item, options);\n if (reason !== undefined) return reason;\n }\n return undefined;\n}\n\nconst childRefCache = new WeakMap<GenerativeUIJSONSchema, ChildRef[]>();\n\n/** The component references of a props schema, computed once per schema. */\nfunction childRefsOf(props: GenerativeUIJSONSchema) {\n let refs = childRefCache.get(props);\n if (!refs) {\n refs = collectChildRefs(props);\n childRefCache.set(props, refs);\n }\n return refs;\n}\n\n/**\n * Checks the component ids at one reference of a node: a typed `child()`\n * or `childList()` prop, at any depth. A missing key is fine; the props\n * schema reports a required one.\n */\nfunction childRefProblem(\n node: Record<string, unknown>,\n ref: ChildRef,\n ownId: string,\n): string | undefined {\n const label = ref.path.filter((step) => step !== \"*\").join(\".\");\n const isDynamic = (value: unknown) =>\n isPathBinding(value) || (isRecord(value) && \"@call\" in value);\n const visit = (\n value: unknown,\n steps: readonly string[],\n ): string | undefined => {\n // A bound or computed value, at the reference or above it, is known\n // only at render.\n if (isDynamic(value)) return undefined;\n if (steps.length === 0) {\n const reason = slotProblem(value, ref.kind, ownId);\n return reason ? `${label}: ${reason}` : undefined;\n }\n const [head, ...rest] = steps;\n if (head === \"*\") {\n if (!Array.isArray(value)) return undefined;\n for (const item of value) {\n const reason = visit(item, rest);\n if (reason) return reason;\n }\n return undefined;\n }\n if (!isRecord(value) || !hasOwn(value, head)) return undefined;\n return visit(value[head], rest);\n };\n return visit(node, ref.path);\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"validate-operation.cjs","names":["isRecord","A2UI_VERSION","GENERATIVE_UI_AGENT_FUNCTION_CALLS","GENERATIVE_UI_AGENT_FUNCTION_CALLS_OFF_REASON","isCallBinding","GENERATIVE_UI_FUNCTIONS","functionCallers","isA2UIValueFunction","isA2UIBasicFunction","collectChildRefs"],"sources":["../../src/generative-ui/validate-operation.ts"],"sourcesContent":["import {\n GENERATIVE_UI_FUNCTIONS,\n functionCallers,\n isA2UIBasicFunction,\n isA2UIValueFunction,\n isCallBinding,\n} from \"./basic-functions\";\nimport type { A2UIFunctionPermissions } from \"./basic-functions\";\nimport { collectChildRefs } from \"./child-refs\";\nimport type { ChildRef } from \"./child-refs\";\nimport {\n A2UI_VERSION,\n GENERATIVE_UI_AGENT_FUNCTION_CALLS,\n GENERATIVE_UI_AGENT_FUNCTION_CALLS_OFF_REASON,\n} from \"./types\";\nimport type {\n GenerativeUIActionBinding,\n GenerativeUIJSONSchema,\n GenerativeUIManifest,\n} from \"./types\";\nimport { isRecord } from \"./is-record\";\n\nexport type OperationValidation = { ok: true } | { ok: false; reason: string };\n\nconst OPERATION_KINDS = [\n \"createSurface\",\n \"updateComponents\",\n \"updateDataModel\",\n \"deleteSurface\",\n \"callRendererFunction\",\n] as const;\nexport type OperationKind = (typeof OPERATION_KINDS)[number];\n\nexport interface ValidateOperationOptions {\n manifest: Pick<\n GenerativeUIManifest,\n \"catalogId\" | \"catalogIds\" | \"components\"\n >;\n /**\n * Surfaces that exist before this operation is applied. `updateComponents`,\n * `updateDataModel`, and `deleteSurface` need their surface in this set.\n */\n knownSurfaces: ReadonlySet<string>;\n /**\n * Surface ids that were created before, also the deleted ones. A surface id\n * is unique for the life of the page, so `createSurface` rejects them.\n */\n createdSurfaces?: ReadonlySet<string>;\n /**\n * UI-callable functions. When provided, `functionCall` bindings and\n * `callRendererFunction` must name one of them. The client omits it:\n * availability is checked when the function runs.\n */\n functions?: GenerativeUIManifest[\"functions\"];\n /**\n * The components that the target of the surface takes. When provided,\n * `updateComponents` and the inline components of `createSurface` can use\n * only these names. Left out, every catalog component is allowed.\n */\n allowedComponents?: AllowedComponents;\n}\n\n/** The component names that one target takes. */\nexport interface AllowedComponents {\n /** The target id, for the reason of a rejection. */\n target: string;\n names: ReadonlySet<string>;\n}\n\nconst OK: OperationValidation = { ok: true };\nconst fail = (reason: string): OperationValidation => ({ ok: false, reason });\n\n/** Models write the v0.9 binding from habit. The reason names the v1.0 form. */\nconst V09_PATH_REASON = 'bind data with {\"@path\": \"/x\"}, not {\"path\": \"/x\"}';\n\nfunction hasOwn(record: object, key: string) {\n return Object.prototype.hasOwnProperty.call(record, key);\n}\n\n/**\n * Reads an own property only. Model-controlled keys such as \"constructor\" or\n * \"toString\" must not resolve to Object.prototype members.\n */\nfunction ownValue<T>(record: Record<string, T> | undefined, key: string) {\n return record && hasOwn(record, key) ? record[key] : undefined;\n}\n\nexport function getOperationKind(op: unknown) {\n if (!isRecord(op)) return undefined;\n const kinds = OPERATION_KINDS.filter((kind) => kind in op);\n return kinds.length === 1 ? kinds[0] : undefined;\n}\n\n/** The `surfaceId` of a surface operation. `callRendererFunction` has none. */\nexport function getOperationSurfaceId(op: unknown) {\n if (!isRecord(op)) return undefined;\n const kind = getOperationKind(op);\n if (!kind) return undefined;\n const payload = op[kind];\n return isRecord(payload) && typeof payload.surfaceId === \"string\"\n ? payload.surfaceId\n : undefined;\n}\n\n/** `{ \"@path\": \"/x\" }`: a data-model binding. */\nexport function isPathBinding(value: unknown): value is { \"@path\": string } {\n return (\n isRecord(value) &&\n typeof value[\"@path\"] === \"string\" &&\n Object.keys(value).length === 1\n );\n}\n\n/** `{ \"path\": \"/x\" }`: the v0.9 binding, which v1.0 does not accept. */\nfunction isV09PathBinding(value: unknown) {\n return (\n isRecord(value) &&\n typeof value.path === \"string\" &&\n Object.keys(value).length === 1\n );\n}\n\n/**\n * `{ \"@call\": \"@index\" }` or `{ \"@call\": \"@index\", \"args\": { \"offset\": 1 } }`:\n * the 0-based position of the item in a template, plus `offset`.\n */\nexport function isIndexCall(\n value: unknown,\n): value is { \"@call\": \"@index\"; args?: { offset?: number } } {\n if (!isRecord(value) || value[\"@call\"] !== \"@index\") return false;\n const hasOnlyCallKeys = Object.keys(value).every(\n (key) => key === \"@call\" || key === \"args\",\n );\n if (!hasOnlyCallKeys) return false;\n const { args } = value;\n if (args === undefined) return true;\n return (\n isRecord(args) &&\n Object.keys(args).every((key) => key === \"offset\") &&\n (args.offset === undefined || Number.isFinite(args.offset))\n );\n}\n\nexport function isActionBinding(\n value: unknown,\n): value is GenerativeUIActionBinding {\n return (\n isRecord(value) &&\n Object.keys(value).length === 1 &&\n (isRecord(value.functionCall) || isRecord(value.event))\n );\n}\n\n/**\n * Checks one A2UI v1.0 operation against the catalog and the surfaces that\n * exist. The operation comes from the model, so nothing in it is trusted.\n *\n * @param op - The operation, as parsed from JSON.\n * @param options - The catalog, the known and created surfaces, the\n * functions that the UI can call, and the components that the target of\n * the surface takes.\n *\n * @example\n * ```ts\n * const result = validateOperation(op, { manifest, knownSurfaces });\n * if (!result.ok) rejected.push({ index, reason: result.reason });\n * ```\n */\nexport function validateOperation(\n op: unknown,\n options: ValidateOperationOptions,\n) {\n if (!isRecord(op)) return fail(\"operation must be a JSON object\");\n if (op.version !== A2UI_VERSION) return fail(versionProblem(op.version));\n const kind = getOperationKind(op);\n if (!kind) {\n return fail(\n `operation must contain exactly one of ${OPERATION_KINDS.join(\", \")}`,\n );\n }\n const payload = op[kind];\n if (kind === \"callRendererFunction\") {\n if (!GENERATIVE_UI_AGENT_FUNCTION_CALLS) {\n return fail(GENERATIVE_UI_AGENT_FUNCTION_CALLS_OFF_REASON);\n }\n return validateRendererFunctionCall(payload, options);\n }\n if (\n !isRecord(payload) ||\n typeof payload.surfaceId !== \"string\" ||\n !payload.surfaceId\n ) {\n return fail(`${kind}.surfaceId is required`);\n }\n const surfaceId = payload.surfaceId;\n if (kind === \"createSurface\") {\n return validateCreateSurface(payload, surfaceId, options);\n }\n if (!options.knownSurfaces.has(surfaceId)) {\n return fail(\n `surface \"${surfaceId}\" does not exist; send createSurface first`,\n );\n }\n switch (kind) {\n case \"deleteSurface\":\n return OK;\n case \"updateDataModel\":\n return validateDataModelUpdate(payload);\n case \"updateComponents\":\n return validateComponents(\n payload.components,\n \"updateComponents.components\",\n options,\n );\n }\n}\n\nfunction versionProblem(version: unknown) {\n return typeof version === \"string\"\n ? `unsupported version \"${version}\"; use \"${A2UI_VERSION}\"`\n : `operation needs \"version\":\"${A2UI_VERSION}\"`;\n}\n\n/** A `catalogId` can name the catalog of the run or one of its bases. */\nfunction catalogProblem(\n catalogId: unknown,\n manifest: ValidateOperationOptions[\"manifest\"],\n) {\n const ids = manifest.catalogIds ?? [manifest.catalogId];\n if (catalogId === undefined || ids.includes(catalogId as string)) {\n return undefined;\n }\n const names = ids.map((id) => `\"${id}\"`).join(\", \");\n const use = ids.length === 1 ? names : `one of: ${names}`;\n return `unknown catalog \"${String(catalogId)}\"; leave out catalogId or use ${use}`;\n}\n\nfunction validateCreateSurface(\n payload: Record<string, unknown>,\n surfaceId: string,\n options: ValidateOperationOptions,\n) {\n if (options.knownSurfaces.has(surfaceId)) {\n return fail(`surface \"${surfaceId}\" already exists`);\n }\n if (options.createdSurfaces?.has(surfaceId)) {\n return fail(\n `surface id \"${surfaceId}\" was used before; use a new surfaceId`,\n );\n }\n const catalogReason = catalogProblem(payload.catalogId, options.manifest);\n if (catalogReason) return fail(catalogReason);\n const { dataModel, components } = payload;\n if (dataModel !== undefined && !isRecord(dataModel)) {\n return fail(\"createSurface.dataModel must be a JSON object\");\n }\n if (components === undefined) return OK;\n return validateComponents(components, \"createSurface.components\", options);\n}\n\nfunction validateRendererFunctionCall(\n payload: unknown,\n options: ValidateOperationOptions,\n) {\n const hasCallId =\n isRecord(payload) &&\n typeof payload.functionCallId === \"string\" &&\n payload.functionCallId !== \"\";\n if (!hasCallId) {\n return fail(\n \"callRendererFunction.functionCallId must be a non-empty string\",\n );\n }\n const reason = functionCallProblem(\n payload.callFunction,\n \"callRendererFunction.callFunction\",\n options,\n );\n return reason ? fail(reason) : OK;\n}\n\nconst FORBIDDEN_SEGMENTS = new Set([\"__proto__\", \"constructor\", \"prototype\"]);\n\nfunction decodeSegment(segment: string) {\n return segment.replace(/~([01])/g, (_, g) => (g === \"1\" ? \"/\" : \"~\"));\n}\n\nfunction validateDataModelUpdate(payload: Record<string, unknown>) {\n if (payload.value === undefined) {\n return fail(\n 'updateDataModel.value is required; use \"value\":null to delete',\n );\n }\n const path = payload.path ?? \"/\";\n if (typeof path !== \"string\" || !path.startsWith(\"/\")) {\n return fail(\"updateDataModel.path must be an absolute JSON pointer\");\n }\n if (path === \"/\") {\n // Paths such as \"/items\" point into the root, so the root must be an object.\n if (!isRecord(payload.value)) {\n return fail(\"a root updateDataModel value must be a JSON object\");\n }\n return OK;\n }\n const reason = pathProblem(path, \"updateDataModel.path\");\n return reason ? fail(reason) : OK;\n}\n\n/**\n * Checks the segments of an absolute JSON pointer (\"/a/b\") or of a path\n * relative to a template item (\"a/b\"). `label` names the field in the reason.\n */\nfunction pathProblem(path: string, label: string) {\n const relative = path.startsWith(\"/\") ? path.slice(1) : path;\n const segments = relative.split(\"/\");\n if (segments.some((segment) => segment === \"\")) {\n return `${label} must not contain empty segments`;\n }\n const decoded = segments.map(decodeSegment);\n const forbidden = decoded.find((segment) => FORBIDDEN_SEGMENTS.has(segment));\n if (forbidden !== undefined) {\n return `path segment \"${forbidden}\" is not allowed in ${label}`;\n }\n return undefined;\n}\n\nfunction validateComponents(\n components: unknown,\n label: string,\n options: ValidateOperationOptions,\n) {\n if (!Array.isArray(components) || components.length === 0) {\n return fail(`${label} must be a non-empty array`);\n }\n const ids = new Set<string>();\n for (const node of components) {\n if (!isRecord(node)) return fail(\"component must be a JSON object\");\n const { id } = node;\n if (typeof id !== \"string\" || !id) return fail(\"id is required\");\n const reason = nodeProblem(node, id, options);\n if (reason) return fail(`component \"${id}\": ${reason}`);\n if (ids.has(id)) {\n return fail(`component \"${id}\" appears twice in one update`);\n }\n ids.add(id);\n }\n return OK;\n}\n\nfunction nodeProblem(\n node: Record<string, unknown>,\n id: string,\n options: ValidateOperationOptions,\n) {\n if (typeof node.component !== \"string\") return \"component type is required\";\n const entry = ownValue(options.manifest.components, node.component);\n if (!entry) return `unknown component \"${node.component}\"`;\n const { allowedComponents } = options;\n if (allowedComponents && !allowedComponents.names.has(node.component)) {\n const names = [...allowedComponents.names].join(\", \") || \"none\";\n return `\"${node.component}\" is not allowed in target \"${allowedComponents.target}\"; use one of: ${names}`;\n }\n const { properties, required } = entry.props;\n const propNames = isRecord(properties) ? Object.keys(properties) : [];\n const props = Object.entries(node);\n for (const [key, value] of props) {\n if (key === \"id\" || key === \"component\") continue;\n if (key === \"catalogId\") {\n const reason = catalogProblem(value, options.manifest);\n if (reason) return `${key}: ${reason}`;\n continue;\n }\n if (key === \"metadata\") {\n const isMetadata =\n isRecord(value) &&\n (value.extensions === undefined || isRecord(value.extensions));\n if (!isMetadata) return 'metadata must be { \"extensions\": { ... } }';\n continue;\n }\n if (key === \"accessibility\") {\n const reason = accessibilityProblem(value);\n if (reason) return `${key}: ${reason}`;\n continue;\n }\n if (ownValue(entry.events, key)) {\n const reason = actionBindingProblem(value, options);\n if (reason) return `${key}: ${reason}`;\n continue;\n }\n const slot = ownValue(entry.slots, key);\n if (slot) {\n const reason = slotProblem(value, slot, id);\n if (reason) return `${key}: ${reason}`;\n continue;\n }\n if (!propNames.includes(key)) return `unknown prop \"${key}\"`;\n if (isV09PathBinding(value)) return `${key}: ${V09_PATH_REASON}`;\n const call = findForbiddenCall(value, { allowValueFunctions: true });\n if (call !== undefined) {\n return `${key}: ${call}; a data prop can call only ${VALUE_FUNCTION_LIST}`;\n }\n }\n for (const ref of childRefsOf(entry.props)) {\n const reason = childRefProblem(node, ref, id);\n if (reason) return reason;\n }\n const requiredNames = Array.isArray(required) ? required : [];\n for (const name of requiredNames) {\n if (typeof name === \"string\" && !(name in node)) {\n return `missing required prop \"${name}\"`;\n }\n }\n return undefined;\n}\n\nconst ACCESSIBILITY_KEYS = [\"label\", \"description\", \"live\", \"hidden\"];\nconst LIVE_VALUES = [\"off\", \"polite\", \"assertive\"];\n\n/**\n * Checks the `accessibility` of a component envelope: `label` and\n * `description` are strings or dynamic values, `live` is one of the ARIA\n * values, `hidden` is a boolean or a dynamic value.\n */\nfunction accessibilityProblem(value: unknown) {\n if (!isRecord(value)) {\n return 'must be { \"label\": \"...\", \"description\": \"...\", \"live\": \"polite\", \"hidden\": false }';\n }\n const isDynamic = (field: unknown) =>\n isPathBinding(field) || isCallBinding(field);\n for (const [key, field] of Object.entries(value)) {\n if (!ACCESSIBILITY_KEYS.includes(key)) return `unknown key \"${key}\"`;\n if (isV09PathBinding(field)) return `${key}: ${V09_PATH_REASON}`;\n if (isDynamic(field)) {\n const call = findForbiddenCall(field, { allowValueFunctions: true });\n if (call !== undefined) return `${key}: ${call}`;\n continue;\n }\n if (key === \"live\") {\n if (typeof field !== \"string\" || !LIVE_VALUES.includes(field)) {\n return `live must be one of ${LIVE_VALUES.join(\", \")}`;\n }\n } else if (key === \"hidden\") {\n if (typeof field !== \"boolean\") return \"hidden must be a boolean\";\n } else if (typeof field !== \"string\") {\n return `${key} must be a string`;\n }\n }\n return undefined;\n}\n\nfunction actionBindingProblem(\n value: unknown,\n options: ValidateOperationOptions,\n) {\n if (!isRecord(value)) return \"must be an action object\";\n const keys = Object.keys(value);\n const isOneAction =\n keys.length === 1 && (keys[0] === \"functionCall\" || keys[0] === \"event\");\n if (!isOneAction) {\n return 'must be { \"event\": ... } or { \"functionCall\": ... }';\n }\n if (keys[0] === \"functionCall\") {\n return functionCallProblem(value.functionCall, \"functionCall\", options);\n }\n return eventProblem(value.event);\n}\n\n/**\n * Checks `{ \"@call\": \"<function>\", \"args\": { ... } }`. `label` names the\n * field in the reason.\n */\nfunction functionCallProblem(\n call: unknown,\n label: string,\n options: ValidateOperationOptions,\n) {\n if (!isRecord(call)) {\n return `${label} must be { \"@call\": \"<function>\", \"args\": { ... } }`;\n }\n const name = call[\"@call\"];\n if (typeof name !== \"string\" || !name) {\n return typeof call.call === \"string\"\n ? `${label} names the function with \"@call\", not \"call\"`\n : `${label}[\"@call\"] must be a function name`;\n }\n const { args } = call;\n if (args !== undefined && !isRecord(args)) {\n return `${label}.args must be an object`;\n }\n const catalogReason = catalogProblem(call.catalogId, options.manifest);\n if (catalogReason) return `${label}: ${catalogReason}`;\n const argEntries = Object.entries(args ?? {});\n for (const [key, arg] of argEntries) {\n if (isV09PathBinding(arg))\n return `${label}.args.${key}: ${V09_PATH_REASON}`;\n }\n // A function the app declares under a built-in name is the app's; the\n // restrictions of the built-in do not apply to it.\n const appFunctions = options.functions;\n const declared =\n appFunctions !== undefined && hasOwn(appFunctions, name)\n ? appFunctions[name]\n : undefined;\n const builtIn =\n declared === undefined && hasOwn(GENERATIVE_UI_FUNCTIONS, name)\n ? GENERATIVE_UI_FUNCTIONS[name]\n : undefined;\n if (declared === undefined && builtIn === undefined) {\n return appFunctions === undefined\n ? undefined\n : `function \"${name}\" is not exposed to generative UI`;\n }\n // Without the list of app functions, a built-in name may be the app's own\n // function, so the dispatcher applies the restriction when the call runs.\n if (declared === undefined && appFunctions === undefined) return undefined;\n return callerProblem(\n name,\n declared ?? builtIn!,\n label.startsWith(\"callRendererFunction\") ? \"agent\" : \"renderer\",\n );\n}\n\n/**\n * Why `caller` may not call a function with these permissions, or\n * `undefined` when it may. The dispatcher gives the same reasons at run\n * time, for the calls that are not validated against a function list.\n */\nexport function callerProblem(\n name: string,\n fn: A2UIFunctionPermissions,\n caller: \"agent\" | \"renderer\",\n) {\n const callers = functionCallers(fn);\n if (caller === \"agent\" && !callers.agent) {\n return fn.requiresUserActivation\n ? `function \"${name}\" runs only from a user gesture; the agent cannot call it`\n : `function \"${name}\" runs only in the UI (allowedCallers \"rendererOnly\"); the agent cannot call it`;\n }\n if (caller === \"renderer\" && !callers.renderer) {\n return `function \"${name}\" runs only for the agent (allowedCallers \"agentOnly\"); the UI cannot call it`;\n }\n return undefined;\n}\n\nfunction eventProblem(event: unknown) {\n if (!isRecord(event) || typeof event.name !== \"string\" || !event.name) {\n return \"event.name is required\";\n }\n const { userMessage, context } = event;\n const isUserMessage =\n userMessage === undefined ||\n typeof userMessage === \"string\" ||\n isPathBinding(userMessage) ||\n (isRecord(userMessage) &&\n typeof userMessage[\"@call\"] === \"string\" &&\n findForbiddenCall(userMessage, { allowValueFunctions: true }) ===\n undefined);\n if (!isUserMessage) {\n return isV09PathBinding(userMessage)\n ? `event.userMessage: ${V09_PATH_REASON}`\n : 'event.userMessage must be a string, {\"@path\": \"/x\"} or a function value';\n }\n if (context === undefined) return undefined;\n if (!isRecord(context)) return \"event.context must be an object\";\n const entries = Object.entries(context);\n for (const [key, entry] of entries) {\n if (isV09PathBinding(entry)) {\n return `event.context.${key}: ${V09_PATH_REASON}`;\n }\n const call = findForbiddenCall(entry, { allowValueFunctions: true });\n if (call !== undefined) {\n return `event.context.${key}: ${call}; a context value can call only ${VALUE_FUNCTION_LIST}`;\n }\n }\n return undefined;\n}\n\nfunction slotProblem(\n value: unknown,\n kind: \"single\" | \"multiple\",\n ownId: string,\n) {\n const isTemplate = isRecord(value) && \"componentId\" in value;\n if (kind === \"single\" && isTemplate) {\n return 'a template { \"componentId\", \"path\" } is only allowed in a \"multiple\" slot';\n }\n if (kind === \"multiple\" && isTemplate) {\n return templateProblem(value, ownId);\n }\n if (kind === \"multiple\" && !Array.isArray(value)) {\n return 'must be an array of component ids or a template { \"componentId\", \"path\" }';\n }\n const ids = kind === \"multiple\" && Array.isArray(value) ? value : [value];\n for (const id of ids) {\n if (typeof id !== \"string\" || !id)\n return \"must reference component ids (strings)\";\n if (id === ownId) return \"a component cannot be its own child\";\n }\n return undefined;\n}\n\nfunction templateProblem(template: Record<string, unknown>, ownId: string) {\n const hasOnlyTemplateKeys = Object.keys(template).every(\n (key) => key === \"componentId\" || key === \"path\",\n );\n if (!hasOnlyTemplateKeys) {\n return 'a template takes only \"componentId\" and \"path\"';\n }\n const { componentId, path } = template;\n if (typeof componentId !== \"string\" || !componentId) {\n return \"template componentId must be a component id\";\n }\n if (componentId === ownId) return \"a component cannot be its own child\";\n if (typeof path !== \"string\" || !path) {\n return \"template path must be a JSON pointer or a relative path\";\n }\n return pathProblem(path, \"template path\");\n}\n\nconst VALUE_FUNCTION_LIST = `@index and the built-in functions (${Object.keys(\n GENERATIVE_UI_FUNCTIONS,\n)\n .filter(isA2UIValueFunction)\n .join(\", \")})`;\n\n/**\n * The reason for the first function call in `value` that a data value may\n * not make, at any depth, or `undefined`. A data value may call `@index`\n * and, with `allowValueFunctions`, the basic functions that need no user\n * gesture; the renderer resolves those. An app function, `openUrl`, or an\n * event binding is not a value.\n */\n// The annotation is needed: the function calls itself in its return.\nfunction findForbiddenCall(\n value: unknown,\n options: { allowValueFunctions: boolean },\n): string | undefined {\n if (Array.isArray(value)) {\n for (const item of value) {\n const reason = findForbiddenCall(item, options);\n if (reason !== undefined) return reason;\n }\n return undefined;\n }\n if (!isRecord(value)) return undefined;\n if (isIndexCall(value)) return undefined;\n if (value[\"@call\"] === \"@index\") return \"@index takes only an offset\";\n if (typeof value.call === \"string\") {\n return 'name the function with \"@call\", not \"call\"';\n }\n if (\"functionCall\" in value) {\n return \"an event binding is not a value\";\n }\n const name = value[\"@call\"];\n if (typeof name === \"string\") {\n if (!options.allowValueFunctions || !isA2UIValueFunction(name)) {\n return isA2UIBasicFunction(name)\n ? `\"${name}\" runs only from an event`\n : `\"${name}\" is not a basic function`;\n }\n const args = value.args;\n if (args !== undefined && !isRecord(args)) {\n return `the args of \"${name}\" must be an object`;\n }\n return args === undefined ? undefined : findForbiddenCall(args, options);\n }\n for (const item of Object.values(value)) {\n const reason = findForbiddenCall(item, options);\n if (reason !== undefined) return reason;\n }\n return undefined;\n}\n\nconst childRefCache = new WeakMap<GenerativeUIJSONSchema, ChildRef[]>();\n\n/** The component references of a props schema, computed once per schema. */\nfunction childRefsOf(props: GenerativeUIJSONSchema) {\n let refs = childRefCache.get(props);\n if (!refs) {\n refs = collectChildRefs(props);\n childRefCache.set(props, refs);\n }\n return refs;\n}\n\n/**\n * Checks the component ids at one reference of a node: a typed `child()`\n * or `childList()` prop, at any depth. A missing key is fine; the props\n * schema reports a required one.\n */\nfunction childRefProblem(\n node: Record<string, unknown>,\n ref: ChildRef,\n ownId: string,\n): string | undefined {\n const label = ref.path.filter((step) => step !== \"*\").join(\".\");\n const isDynamic = (value: unknown) =>\n isPathBinding(value) || (isRecord(value) && \"@call\" in value);\n const visit = (\n value: unknown,\n steps: readonly string[],\n ): string | undefined => {\n // A bound or computed value, at the reference or above it, is known\n // only at render.\n if (isDynamic(value)) return undefined;\n const [head, ...rest] = steps;\n if (head === undefined) {\n const reason = slotProblem(value, ref.kind, ownId);\n return reason ? `${label}: ${reason}` : undefined;\n }\n if (head === \"*\") {\n if (!Array.isArray(value)) return undefined;\n for (const item of value) {\n const reason = visit(item, rest);\n if (reason) return reason;\n }\n return undefined;\n }\n if (!isRecord(value) || !hasOwn(value, head)) return undefined;\n return visit(value[head], rest);\n };\n return visit(node, ref.path);\n}\n"],"mappings":"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"}
@@ -375,11 +375,11 @@ function childRefProblem(node, ref, ownId) {
375
375
  const isDynamic = (value) => isPathBinding(value) || isRecord(value) && "@call" in value;
376
376
  const visit = (value, steps) => {
377
377
  if (isDynamic(value)) return void 0;
378
- if (steps.length === 0) {
378
+ const [head, ...rest] = steps;
379
+ if (head === void 0) {
379
380
  const reason = slotProblem(value, ref.kind, ownId);
380
381
  return reason ? `${label}: ${reason}` : void 0;
381
382
  }
382
- const [head, ...rest] = steps;
383
383
  if (head === "*") {
384
384
  if (!Array.isArray(value)) return void 0;
385
385
  for (const item of value) {