@copilotkit/shared 2.0.0-next.1 → 2.0.0-rc.0

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 (592) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +93 -12
  3. package/dist/_virtual/_rolldown/runtime.cjs +29 -0
  4. package/dist/a2ui-envelope.cjs +154 -0
  5. package/dist/a2ui-envelope.cjs.map +1 -0
  6. package/dist/a2ui-envelope.d.cts +101 -0
  7. package/dist/a2ui-envelope.d.cts.map +1 -0
  8. package/dist/a2ui-envelope.d.mts +101 -0
  9. package/dist/a2ui-envelope.d.mts.map +1 -0
  10. package/dist/a2ui-envelope.mjs +151 -0
  11. package/dist/a2ui-envelope.mjs.map +1 -0
  12. package/dist/a2ui-prompts.cjs +259 -0
  13. package/dist/a2ui-prompts.cjs.map +1 -0
  14. package/dist/a2ui-prompts.d.cts +79 -0
  15. package/dist/a2ui-prompts.d.cts.map +1 -0
  16. package/dist/a2ui-prompts.d.mts +79 -0
  17. package/dist/a2ui-prompts.d.mts.map +1 -0
  18. package/dist/a2ui-prompts.mjs +251 -0
  19. package/dist/a2ui-prompts.mjs.map +1 -0
  20. package/dist/attachments/content.cjs +17 -0
  21. package/dist/attachments/content.cjs.map +1 -0
  22. package/dist/attachments/content.d.cts +9 -0
  23. package/dist/attachments/content.d.cts.map +1 -0
  24. package/dist/attachments/content.d.mts +9 -0
  25. package/dist/attachments/content.d.mts.map +1 -0
  26. package/dist/attachments/content.mjs +16 -0
  27. package/dist/attachments/content.mjs.map +1 -0
  28. package/dist/attachments/types.d.cts +64 -0
  29. package/dist/attachments/types.d.cts.map +1 -0
  30. package/dist/attachments/types.d.mts +64 -0
  31. package/dist/attachments/types.d.mts.map +1 -0
  32. package/dist/attachments/utils.cjs +137 -0
  33. package/dist/attachments/utils.cjs.map +1 -0
  34. package/dist/attachments/utils.d.cts +44 -0
  35. package/dist/attachments/utils.d.cts.map +1 -0
  36. package/dist/attachments/utils.d.mts +44 -0
  37. package/dist/attachments/utils.d.mts.map +1 -0
  38. package/dist/attachments/utils.mjs +129 -0
  39. package/dist/attachments/utils.mjs.map +1 -0
  40. package/dist/constants/index.cjs +25 -0
  41. package/dist/constants/index.cjs.map +1 -0
  42. package/dist/constants/index.d.cts +17 -0
  43. package/dist/constants/index.d.cts.map +1 -0
  44. package/dist/constants/index.d.mts +17 -0
  45. package/dist/constants/index.d.mts.map +1 -0
  46. package/dist/constants/index.mjs +17 -12
  47. package/dist/constants/index.mjs.map +1 -1
  48. package/dist/debug-event-envelope.d.cts +13 -0
  49. package/dist/debug-event-envelope.d.cts.map +1 -0
  50. package/dist/debug-event-envelope.d.mts +13 -0
  51. package/dist/debug-event-envelope.d.mts.map +1 -0
  52. package/dist/debug.cjs +38 -0
  53. package/dist/debug.cjs.map +1 -0
  54. package/dist/debug.d.cts +29 -0
  55. package/dist/debug.d.cts.map +1 -0
  56. package/dist/debug.d.mts +29 -0
  57. package/dist/debug.d.mts.map +1 -0
  58. package/dist/debug.mjs +37 -0
  59. package/dist/debug.mjs.map +1 -0
  60. package/dist/event-transforms/index.cjs +15 -0
  61. package/dist/event-transforms/index.d.cts +4 -0
  62. package/dist/event-transforms/index.d.mts +4 -0
  63. package/dist/event-transforms/index.mjs +5 -0
  64. package/dist/event-transforms/open-generative-ui-middleware.cjs +286 -0
  65. package/dist/event-transforms/open-generative-ui-middleware.cjs.map +1 -0
  66. package/dist/event-transforms/open-generative-ui-middleware.d.cts +60 -0
  67. package/dist/event-transforms/open-generative-ui-middleware.d.cts.map +1 -0
  68. package/dist/event-transforms/open-generative-ui-middleware.d.mts +60 -0
  69. package/dist/event-transforms/open-generative-ui-middleware.d.mts.map +1 -0
  70. package/dist/event-transforms/open-generative-ui-middleware.mjs +283 -0
  71. package/dist/event-transforms/open-generative-ui-middleware.mjs.map +1 -0
  72. package/dist/event-transforms/recorded-events.cjs +59 -0
  73. package/dist/event-transforms/recorded-events.cjs.map +1 -0
  74. package/dist/event-transforms/recorded-events.d.cts +23 -0
  75. package/dist/event-transforms/recorded-events.d.cts.map +1 -0
  76. package/dist/event-transforms/recorded-events.d.mts +23 -0
  77. package/dist/event-transforms/recorded-events.d.mts.map +1 -0
  78. package/dist/event-transforms/recorded-events.mjs +58 -0
  79. package/dist/event-transforms/recorded-events.mjs.map +1 -0
  80. package/dist/finalize-events.cjs +186 -0
  81. package/dist/finalize-events.cjs.map +1 -0
  82. package/dist/finalize-events.d.cts +40 -0
  83. package/dist/finalize-events.d.cts.map +1 -0
  84. package/dist/finalize-events.d.mts +40 -0
  85. package/dist/finalize-events.d.mts.map +1 -0
  86. package/dist/finalize-events.mjs +184 -0
  87. package/dist/finalize-events.mjs.map +1 -0
  88. package/dist/generative-ui/basic-functions.cjs +177 -0
  89. package/dist/generative-ui/basic-functions.cjs.map +1 -0
  90. package/dist/generative-ui/basic-functions.d.cts +108 -0
  91. package/dist/generative-ui/basic-functions.d.cts.map +1 -0
  92. package/dist/generative-ui/basic-functions.d.mts +108 -0
  93. package/dist/generative-ui/basic-functions.d.mts.map +1 -0
  94. package/dist/generative-ui/basic-functions.mjs +167 -0
  95. package/dist/generative-ui/basic-functions.mjs.map +1 -0
  96. package/dist/generative-ui/child-refs.cjs +161 -0
  97. package/dist/generative-ui/child-refs.cjs.map +1 -0
  98. package/dist/generative-ui/child-refs.d.cts +68 -0
  99. package/dist/generative-ui/child-refs.d.cts.map +1 -0
  100. package/dist/generative-ui/child-refs.d.mts +68 -0
  101. package/dist/generative-ui/child-refs.d.mts.map +1 -0
  102. package/dist/generative-ui/child-refs.mjs +152 -0
  103. package/dist/generative-ui/child-refs.mjs.map +1 -0
  104. package/dist/generative-ui/is-record.cjs +10 -0
  105. package/dist/generative-ui/is-record.cjs.map +1 -0
  106. package/dist/generative-ui/is-record.mjs +9 -0
  107. package/dist/generative-ui/is-record.mjs.map +1 -0
  108. package/dist/generative-ui/prompt.cjs +91 -0
  109. package/dist/generative-ui/prompt.cjs.map +1 -0
  110. package/dist/generative-ui/prompt.d.cts +13 -0
  111. package/dist/generative-ui/prompt.d.cts.map +1 -0
  112. package/dist/generative-ui/prompt.d.mts +13 -0
  113. package/dist/generative-ui/prompt.d.mts.map +1 -0
  114. package/dist/generative-ui/prompt.mjs +90 -0
  115. package/dist/generative-ui/prompt.mjs.map +1 -0
  116. package/dist/generative-ui/render-ui-args.cjs +160 -0
  117. package/dist/generative-ui/render-ui-args.cjs.map +1 -0
  118. package/dist/generative-ui/render-ui-args.d.cts +40 -0
  119. package/dist/generative-ui/render-ui-args.d.cts.map +1 -0
  120. package/dist/generative-ui/render-ui-args.d.mts +40 -0
  121. package/dist/generative-ui/render-ui-args.d.mts.map +1 -0
  122. package/dist/generative-ui/render-ui-args.mjs +159 -0
  123. package/dist/generative-ui/render-ui-args.mjs.map +1 -0
  124. package/dist/generative-ui/types.cjs +101 -0
  125. package/dist/generative-ui/types.cjs.map +1 -0
  126. package/dist/generative-ui/types.d.cts +270 -0
  127. package/dist/generative-ui/types.d.cts.map +1 -0
  128. package/dist/generative-ui/types.d.mts +270 -0
  129. package/dist/generative-ui/types.d.mts.map +1 -0
  130. package/dist/generative-ui/types.mjs +86 -0
  131. package/dist/generative-ui/types.mjs.map +1 -0
  132. package/dist/generative-ui/validate-operation.cjs +405 -0
  133. package/dist/generative-ui/validate-operation.cjs.map +1 -0
  134. package/dist/generative-ui/validate-operation.d.cts +86 -0
  135. package/dist/generative-ui/validate-operation.d.cts.map +1 -0
  136. package/dist/generative-ui/validate-operation.d.mts +86 -0
  137. package/dist/generative-ui/validate-operation.d.mts.map +1 -0
  138. package/dist/generative-ui/validate-operation.mjs +399 -0
  139. package/dist/generative-ui/validate-operation.mjs.map +1 -0
  140. package/dist/index.cjs +233 -0
  141. package/dist/index.cjs.map +1 -0
  142. package/dist/index.d.cts +80 -0
  143. package/dist/index.d.cts.map +1 -0
  144. package/dist/index.d.mts +80 -0
  145. package/dist/index.d.mts.map +1 -0
  146. package/dist/index.mjs +78 -123
  147. package/dist/index.mjs.map +1 -1
  148. package/dist/index.umd.js +3979 -0
  149. package/dist/index.umd.js.map +1 -0
  150. package/dist/intelligence-routing-fields.cjs +35 -0
  151. package/dist/intelligence-routing-fields.cjs.map +1 -0
  152. package/dist/intelligence-routing-fields.d.cts +18 -0
  153. package/dist/intelligence-routing-fields.d.cts.map +1 -0
  154. package/dist/intelligence-routing-fields.d.mts +18 -0
  155. package/dist/intelligence-routing-fields.d.mts.map +1 -0
  156. package/dist/intelligence-routing-fields.mjs +34 -0
  157. package/dist/intelligence-routing-fields.mjs.map +1 -0
  158. package/dist/logger.cjs +7 -0
  159. package/dist/logger.cjs.map +1 -0
  160. package/dist/logger.d.cts +5 -0
  161. package/dist/logger.d.cts.map +1 -0
  162. package/dist/logger.d.mts +5 -0
  163. package/dist/logger.d.mts.map +1 -0
  164. package/dist/logger.mjs +6 -0
  165. package/dist/logger.mjs.map +1 -0
  166. package/dist/open-generative-ui-prompts.cjs +8 -0
  167. package/dist/open-generative-ui-prompts.cjs.map +1 -0
  168. package/dist/open-generative-ui-prompts.d.cts +6 -0
  169. package/dist/open-generative-ui-prompts.d.cts.map +1 -0
  170. package/dist/open-generative-ui-prompts.d.mts +6 -0
  171. package/dist/open-generative-ui-prompts.d.mts.map +1 -0
  172. package/dist/open-generative-ui-prompts.mjs +7 -0
  173. package/dist/open-generative-ui-prompts.mjs.map +1 -0
  174. package/dist/package.cjs +12 -0
  175. package/dist/package.cjs.map +1 -0
  176. package/dist/package.mjs +6 -0
  177. package/dist/package.mjs.map +1 -0
  178. package/dist/standard-schema.cjs +31 -0
  179. package/dist/standard-schema.cjs.map +1 -0
  180. package/dist/standard-schema.d.cts +33 -0
  181. package/dist/standard-schema.d.cts.map +1 -0
  182. package/dist/standard-schema.d.mts +33 -0
  183. package/dist/standard-schema.d.mts.map +1 -0
  184. package/dist/standard-schema.mjs +30 -0
  185. package/dist/standard-schema.mjs.map +1 -0
  186. package/dist/telemetry/events.d.cts +72 -0
  187. package/dist/telemetry/events.d.cts.map +1 -0
  188. package/dist/telemetry/events.d.mts +72 -0
  189. package/dist/telemetry/events.d.mts.map +1 -0
  190. package/dist/telemetry/index.cjs +18 -0
  191. package/dist/telemetry/index.d.cts +5 -0
  192. package/dist/telemetry/index.d.mts +5 -0
  193. package/dist/telemetry/index.mjs +6 -12
  194. package/dist/telemetry/lambda-client.cjs +91 -0
  195. package/dist/telemetry/lambda-client.cjs.map +1 -0
  196. package/dist/telemetry/lambda-client.d.cts +31 -0
  197. package/dist/telemetry/lambda-client.d.cts.map +1 -0
  198. package/dist/telemetry/lambda-client.d.mts +31 -0
  199. package/dist/telemetry/lambda-client.d.mts.map +1 -0
  200. package/dist/telemetry/lambda-client.mjs +87 -0
  201. package/dist/telemetry/lambda-client.mjs.map +1 -0
  202. package/dist/telemetry/model-host.cjs +104 -0
  203. package/dist/telemetry/model-host.cjs.map +1 -0
  204. package/dist/telemetry/model-host.d.cts +26 -0
  205. package/dist/telemetry/model-host.d.cts.map +1 -0
  206. package/dist/telemetry/model-host.d.mts +26 -0
  207. package/dist/telemetry/model-host.d.mts.map +1 -0
  208. package/dist/telemetry/model-host.mjs +102 -0
  209. package/dist/telemetry/model-host.mjs.map +1 -0
  210. package/dist/telemetry/sampling.cjs +50 -0
  211. package/dist/telemetry/sampling.cjs.map +1 -0
  212. package/dist/telemetry/sampling.d.cts +57 -0
  213. package/dist/telemetry/sampling.d.cts.map +1 -0
  214. package/dist/telemetry/sampling.d.mts +57 -0
  215. package/dist/telemetry/sampling.d.mts.map +1 -0
  216. package/dist/telemetry/sampling.mjs +44 -0
  217. package/dist/telemetry/sampling.mjs.map +1 -0
  218. package/dist/telemetry/telemetry-client.cjs +165 -0
  219. package/dist/telemetry/telemetry-client.cjs.map +1 -0
  220. package/dist/telemetry/telemetry-client.d.cts +87 -0
  221. package/dist/telemetry/telemetry-client.d.cts.map +1 -0
  222. package/dist/telemetry/telemetry-client.d.mts +87 -0
  223. package/dist/telemetry/telemetry-client.d.mts.map +1 -0
  224. package/dist/telemetry/telemetry-client.mjs +162 -9
  225. package/dist/telemetry/telemetry-client.mjs.map +1 -1
  226. package/dist/telemetry/telemetry-disabled.cjs +20 -0
  227. package/dist/telemetry/telemetry-disabled.cjs.map +1 -0
  228. package/dist/telemetry/telemetry-disabled.d.cts +16 -0
  229. package/dist/telemetry/telemetry-disabled.d.cts.map +1 -0
  230. package/dist/telemetry/telemetry-disabled.d.mts +16 -0
  231. package/dist/telemetry/telemetry-disabled.d.mts.map +1 -0
  232. package/dist/telemetry/telemetry-disabled.mjs +19 -0
  233. package/dist/telemetry/telemetry-disabled.mjs.map +1 -0
  234. package/dist/telemetry/utils.cjs +14 -0
  235. package/dist/telemetry/utils.cjs.map +1 -0
  236. package/dist/telemetry/utils.mjs +12 -8
  237. package/dist/telemetry/utils.mjs.map +1 -1
  238. package/dist/transcription-errors.cjs +84 -0
  239. package/dist/transcription-errors.cjs.map +1 -0
  240. package/dist/transcription-errors.d.cts +52 -0
  241. package/dist/transcription-errors.d.cts.map +1 -0
  242. package/dist/transcription-errors.d.mts +52 -0
  243. package/dist/transcription-errors.d.mts.map +1 -0
  244. package/dist/transcription-errors.mjs +82 -0
  245. package/dist/transcription-errors.mjs.map +1 -0
  246. package/dist/types/{action.d.ts → action.d.cts} +32 -32
  247. package/dist/types/action.d.cts.map +1 -0
  248. package/dist/types/action.d.mts +59 -0
  249. package/dist/types/action.d.mts.map +1 -0
  250. package/dist/types/copilot-cloud-config.d.cts +15 -0
  251. package/dist/types/copilot-cloud-config.d.cts.map +1 -0
  252. package/dist/types/copilot-cloud-config.d.mts +15 -0
  253. package/dist/types/copilot-cloud-config.d.mts.map +1 -0
  254. package/dist/types/error.d.cts +57 -0
  255. package/dist/types/error.d.cts.map +1 -0
  256. package/dist/types/error.d.mts +57 -0
  257. package/dist/types/error.d.mts.map +1 -0
  258. package/dist/types/message.d.cts +42 -0
  259. package/dist/types/message.d.cts.map +1 -0
  260. package/dist/types/message.d.mts +42 -0
  261. package/dist/types/message.d.mts.map +1 -0
  262. package/dist/types/openai-assistant.d.cts +55 -0
  263. package/dist/types/openai-assistant.d.cts.map +1 -0
  264. package/dist/types/openai-assistant.d.mts +55 -0
  265. package/dist/types/openai-assistant.d.mts.map +1 -0
  266. package/dist/types/utility.d.cts +6 -0
  267. package/dist/types/utility.d.cts.map +1 -0
  268. package/dist/types/utility.d.mts +6 -0
  269. package/dist/types/utility.d.mts.map +1 -0
  270. package/dist/utils/clipboard.cjs +28 -0
  271. package/dist/utils/clipboard.cjs.map +1 -0
  272. package/dist/utils/clipboard.d.cts +14 -0
  273. package/dist/utils/clipboard.d.cts.map +1 -0
  274. package/dist/utils/clipboard.d.mts +14 -0
  275. package/dist/utils/clipboard.d.mts.map +1 -0
  276. package/dist/utils/clipboard.mjs +27 -0
  277. package/dist/utils/clipboard.mjs.map +1 -0
  278. package/dist/utils/conditions.cjs +32 -0
  279. package/dist/utils/conditions.cjs.map +1 -0
  280. package/dist/utils/{conditions.d.ts → conditions.d.cts} +16 -11
  281. package/dist/utils/conditions.d.cts.map +1 -0
  282. package/dist/utils/conditions.d.mts +31 -0
  283. package/dist/utils/conditions.d.mts.map +1 -0
  284. package/dist/utils/conditions.mjs +30 -6
  285. package/dist/utils/conditions.mjs.map +1 -1
  286. package/dist/utils/console-styling.cjs +91 -0
  287. package/dist/utils/console-styling.cjs.map +1 -0
  288. package/dist/utils/console-styling.d.cts +65 -0
  289. package/dist/utils/console-styling.d.cts.map +1 -0
  290. package/dist/utils/console-styling.d.mts +65 -0
  291. package/dist/utils/console-styling.d.mts.map +1 -0
  292. package/dist/utils/console-styling.mjs +83 -15
  293. package/dist/utils/console-styling.mjs.map +1 -1
  294. package/dist/utils/dashboard-url.cjs +19 -0
  295. package/dist/utils/dashboard-url.cjs.map +1 -0
  296. package/dist/utils/dashboard-url.mjs +18 -0
  297. package/dist/utils/dashboard-url.mjs.map +1 -0
  298. package/dist/utils/errors.cjs +439 -0
  299. package/dist/utils/errors.cjs.map +1 -0
  300. package/dist/utils/{errors.d.ts → errors.d.cts} +188 -156
  301. package/dist/utils/errors.d.cts.map +1 -0
  302. package/dist/utils/errors.d.mts +312 -0
  303. package/dist/utils/errors.d.mts.map +1 -0
  304. package/dist/utils/errors.mjs +416 -63
  305. package/dist/utils/errors.mjs.map +1 -1
  306. package/dist/utils/index.cjs +105 -0
  307. package/dist/utils/index.cjs.map +1 -0
  308. package/dist/utils/index.d.cts +58 -0
  309. package/dist/utils/index.d.cts.map +1 -0
  310. package/dist/utils/index.d.mts +58 -0
  311. package/dist/utils/index.d.mts.map +1 -0
  312. package/dist/utils/index.mjs +97 -107
  313. package/dist/utils/index.mjs.map +1 -1
  314. package/dist/utils/inspector-learning.cjs +217 -0
  315. package/dist/utils/inspector-learning.cjs.map +1 -0
  316. package/dist/utils/inspector-learning.d.cts +104 -0
  317. package/dist/utils/inspector-learning.d.cts.map +1 -0
  318. package/dist/utils/inspector-learning.d.mts +104 -0
  319. package/dist/utils/inspector-learning.d.mts.map +1 -0
  320. package/dist/utils/inspector-learning.mjs +215 -0
  321. package/dist/utils/inspector-learning.mjs.map +1 -0
  322. package/dist/utils/inspector-metadata.cjs +146 -0
  323. package/dist/utils/inspector-metadata.cjs.map +1 -0
  324. package/dist/utils/inspector-metadata.d.cts +55 -0
  325. package/dist/utils/inspector-metadata.d.cts.map +1 -0
  326. package/dist/utils/inspector-metadata.d.mts +55 -0
  327. package/dist/utils/inspector-metadata.d.mts.map +1 -0
  328. package/dist/utils/inspector-metadata.mjs +146 -0
  329. package/dist/utils/inspector-metadata.mjs.map +1 -0
  330. package/dist/utils/inspector-visibility.cjs +13 -0
  331. package/dist/utils/inspector-visibility.cjs.map +1 -0
  332. package/dist/utils/inspector-visibility.d.cts +18 -0
  333. package/dist/utils/inspector-visibility.d.cts.map +1 -0
  334. package/dist/utils/inspector-visibility.d.mts +18 -0
  335. package/dist/utils/inspector-visibility.d.mts.map +1 -0
  336. package/dist/utils/inspector-visibility.mjs +12 -0
  337. package/dist/utils/inspector-visibility.mjs.map +1 -0
  338. package/dist/utils/json-schema.cjs +215 -0
  339. package/dist/utils/json-schema.cjs.map +1 -0
  340. package/dist/utils/{json-schema.d.ts → json-schema.d.cts} +20 -18
  341. package/dist/utils/json-schema.d.cts.map +1 -0
  342. package/dist/utils/json-schema.d.mts +36 -0
  343. package/dist/utils/json-schema.d.mts.map +1 -0
  344. package/dist/utils/json-schema.mjs +210 -12
  345. package/dist/utils/json-schema.mjs.map +1 -1
  346. package/dist/utils/random-id.cjs +38 -0
  347. package/dist/utils/random-id.cjs.map +1 -0
  348. package/dist/utils/{random-id.d.ts → random-id.d.cts} +3 -1
  349. package/dist/utils/random-id.d.cts.map +1 -0
  350. package/dist/utils/random-id.d.mts +8 -0
  351. package/dist/utils/random-id.d.mts.map +1 -0
  352. package/dist/utils/random-id.mjs +33 -12
  353. package/dist/utils/random-id.mjs.map +1 -1
  354. package/dist/utils/requests.cjs +58 -0
  355. package/dist/utils/requests.cjs.map +1 -0
  356. package/dist/utils/{requests.d.ts → requests.d.cts} +3 -1
  357. package/dist/utils/requests.d.cts.map +1 -0
  358. package/dist/utils/requests.d.mts +12 -0
  359. package/dist/utils/requests.d.mts.map +1 -0
  360. package/dist/utils/requests.mjs +56 -6
  361. package/dist/utils/requests.mjs.map +1 -1
  362. package/dist/utils/row-render-keys.cjs +206 -0
  363. package/dist/utils/row-render-keys.cjs.map +1 -0
  364. package/dist/utils/row-render-keys.d.cts +65 -0
  365. package/dist/utils/row-render-keys.d.cts.map +1 -0
  366. package/dist/utils/row-render-keys.d.mts +65 -0
  367. package/dist/utils/row-render-keys.d.mts.map +1 -0
  368. package/dist/utils/row-render-keys.mjs +201 -0
  369. package/dist/utils/row-render-keys.mjs.map +1 -0
  370. package/dist/utils/types.cjs +9 -0
  371. package/dist/utils/types.cjs.map +1 -0
  372. package/dist/utils/types.d.cts +122 -0
  373. package/dist/utils/types.d.cts.map +1 -0
  374. package/dist/utils/types.d.mts +122 -0
  375. package/dist/utils/types.d.mts.map +1 -0
  376. package/dist/utils/types.mjs +6 -1
  377. package/dist/utils/types.mjs.map +1 -1
  378. package/package.json +74 -40
  379. package/scripts/verify-cjs-exports.cjs +16 -0
  380. package/src/__tests__/a2ui-envelope.test.ts +434 -0
  381. package/src/__tests__/a2ui-prompts.test.ts +362 -0
  382. package/src/__tests__/debug.test.ts +116 -0
  383. package/src/__tests__/license-context.test.ts +253 -0
  384. package/src/__tests__/root-entry-browser-safety.test.ts +91 -0
  385. package/src/__tests__/standard-schema-types.test.ts +144 -0
  386. package/src/__tests__/standard-schema.test.ts +359 -0
  387. package/src/__tests__/zod-regression.test.ts +319 -0
  388. package/src/a2ui-envelope.ts +309 -0
  389. package/src/a2ui-prompts.ts +322 -0
  390. package/src/attachments/__tests__/utils.test.ts +214 -0
  391. package/src/attachments/content.test.ts +48 -0
  392. package/src/attachments/content.ts +16 -0
  393. package/src/attachments/index.ts +21 -0
  394. package/src/attachments/types.ts +77 -0
  395. package/src/attachments/utils.ts +169 -0
  396. package/src/constants/index.ts +14 -1
  397. package/src/debug-event-envelope.ts +9 -0
  398. package/src/debug.ts +55 -0
  399. package/src/event-transforms/index.ts +5 -0
  400. package/src/event-transforms/open-generative-ui-middleware.ts +392 -0
  401. package/src/event-transforms/recorded-events.test.ts +166 -0
  402. package/src/event-transforms/recorded-events.ts +74 -0
  403. package/src/finalize-events.test.ts +284 -0
  404. package/src/finalize-events.ts +260 -0
  405. package/src/generative-ui/__tests__/render-ui-args.test.ts +175 -0
  406. package/src/generative-ui/__tests__/validate-operation.test.ts +977 -0
  407. package/src/generative-ui/basic-functions.ts +282 -0
  408. package/src/generative-ui/child-refs.ts +210 -0
  409. package/src/generative-ui/index.ts +6 -0
  410. package/src/generative-ui/is-record.ts +4 -0
  411. package/src/generative-ui/prompt.ts +174 -0
  412. package/src/generative-ui/render-ui-args.ts +199 -0
  413. package/src/generative-ui/types.ts +314 -0
  414. package/src/generative-ui/validate-operation.ts +723 -0
  415. package/src/index.ts +190 -1
  416. package/src/intelligence-routing-fields.test.ts +51 -0
  417. package/src/intelligence-routing-fields.ts +40 -0
  418. package/src/logger.ts +1 -0
  419. package/src/open-generative-ui-prompts.ts +20 -0
  420. package/src/standard-schema.ts +82 -0
  421. package/src/telemetry/events.ts +37 -10
  422. package/src/telemetry/index.ts +8 -0
  423. package/src/telemetry/lambda-client.test.ts +446 -0
  424. package/src/telemetry/lambda-client.ts +194 -0
  425. package/src/telemetry/model-host.test.ts +145 -0
  426. package/src/telemetry/model-host.ts +156 -0
  427. package/src/telemetry/sampling.test.ts +65 -0
  428. package/src/telemetry/sampling.ts +103 -0
  429. package/src/telemetry/telemetry-blank-license-identity.test.ts +128 -0
  430. package/src/telemetry/telemetry-client.test.ts +798 -0
  431. package/src/telemetry/telemetry-client.ts +223 -37
  432. package/src/telemetry/telemetry-disabled.ts +22 -0
  433. package/src/telemetry/utils.ts +0 -24
  434. package/src/transcription-errors.ts +99 -0
  435. package/src/types/__tests__/message.test.ts +62 -0
  436. package/src/types/action.ts +9 -5
  437. package/src/types/error.ts +11 -2
  438. package/src/types/message.ts +33 -5
  439. package/src/types/openai-assistant.ts +6 -2
  440. package/src/utils/__tests__/clipboard.test.ts +87 -0
  441. package/src/utils/__tests__/conditions.test.ts +161 -0
  442. package/src/utils/__tests__/json-schema.test.ts +812 -0
  443. package/src/utils/__tests__/row-render-keys.test.ts +388 -0
  444. package/src/utils/clipboard.ts +23 -0
  445. package/src/utils/conditions.ts +27 -9
  446. package/src/utils/console-styling.ts +10 -8
  447. package/src/utils/dashboard-url.ts +17 -0
  448. package/src/utils/errors.ts +55 -22
  449. package/src/utils/index.ts +70 -1
  450. package/src/utils/inspector-learning.test.ts +423 -0
  451. package/src/utils/inspector-learning.ts +523 -0
  452. package/src/utils/inspector-metadata.test.ts +743 -0
  453. package/src/utils/inspector-metadata.ts +263 -0
  454. package/src/utils/inspector-visibility.test.ts +43 -0
  455. package/src/utils/inspector-visibility.ts +17 -0
  456. package/src/utils/json-schema.ts +156 -12
  457. package/src/utils/random-id.ts +5 -2
  458. package/src/utils/requests.ts +3 -1
  459. package/src/utils/row-render-keys.ts +263 -0
  460. package/src/utils/types.ts +128 -1
  461. package/src/utils.test.ts +137 -0
  462. package/tsconfig.json +10 -2
  463. package/tsdown.config.ts +49 -0
  464. package/vitest.config.mjs +11 -0
  465. package/CHANGELOG.md +0 -1817
  466. package/dist/chunk-2OJ5OJ2D.mjs +0 -1
  467. package/dist/chunk-2OJ5OJ2D.mjs.map +0 -1
  468. package/dist/chunk-64DYJ27R.mjs +0 -201
  469. package/dist/chunk-64DYJ27R.mjs.map +0 -1
  470. package/dist/chunk-6QGXWNS5.mjs +0 -34
  471. package/dist/chunk-6QGXWNS5.mjs.map +0 -1
  472. package/dist/chunk-6W2UEO2M.mjs +0 -94
  473. package/dist/chunk-6W2UEO2M.mjs.map +0 -1
  474. package/dist/chunk-7DJDTRNX.mjs +0 -426
  475. package/dist/chunk-7DJDTRNX.mjs.map +0 -1
  476. package/dist/chunk-A66772CV.mjs +0 -107
  477. package/dist/chunk-A66772CV.mjs.map +0 -1
  478. package/dist/chunk-BOKE4OKY.mjs +0 -41
  479. package/dist/chunk-BOKE4OKY.mjs.map +0 -1
  480. package/dist/chunk-FCCOSO5L.mjs +0 -1
  481. package/dist/chunk-FCCOSO5L.mjs.map +0 -1
  482. package/dist/chunk-GYZIHHE6.mjs +0 -13
  483. package/dist/chunk-GYZIHHE6.mjs.map +0 -1
  484. package/dist/chunk-IAFBVORQ.mjs +0 -1
  485. package/dist/chunk-IAFBVORQ.mjs.map +0 -1
  486. package/dist/chunk-JAAUCDUR.mjs +0 -38
  487. package/dist/chunk-JAAUCDUR.mjs.map +0 -1
  488. package/dist/chunk-MSUB6DGR.mjs +0 -1
  489. package/dist/chunk-MSUB6DGR.mjs.map +0 -1
  490. package/dist/chunk-N5EP5OD5.mjs +0 -1
  491. package/dist/chunk-N5EP5OD5.mjs.map +0 -1
  492. package/dist/chunk-NAFEBKSO.mjs +0 -1
  493. package/dist/chunk-NAFEBKSO.mjs.map +0 -1
  494. package/dist/chunk-P7STFMPO.mjs +0 -1
  495. package/dist/chunk-P7STFMPO.mjs.map +0 -1
  496. package/dist/chunk-PL5WNHFZ.mjs +0 -50
  497. package/dist/chunk-PL5WNHFZ.mjs.map +0 -1
  498. package/dist/chunk-UYARLQNA.mjs +0 -1
  499. package/dist/chunk-UYARLQNA.mjs.map +0 -1
  500. package/dist/chunk-XEMZTHQZ.mjs +0 -67
  501. package/dist/chunk-XEMZTHQZ.mjs.map +0 -1
  502. package/dist/chunk-XTHC46M2.mjs +0 -1
  503. package/dist/chunk-XTHC46M2.mjs.map +0 -1
  504. package/dist/constants/index.d.ts +0 -6
  505. package/dist/constants/index.js +0 -40
  506. package/dist/constants/index.js.map +0 -1
  507. package/dist/index.d.ts +0 -25
  508. package/dist/index.js +0 -1098
  509. package/dist/index.js.map +0 -1
  510. package/dist/telemetry/events.d.ts +0 -45
  511. package/dist/telemetry/events.js +0 -19
  512. package/dist/telemetry/events.js.map +0 -1
  513. package/dist/telemetry/events.mjs +0 -1
  514. package/dist/telemetry/events.mjs.map +0 -1
  515. package/dist/telemetry/index.d.ts +0 -3
  516. package/dist/telemetry/index.js +0 -188
  517. package/dist/telemetry/index.js.map +0 -1
  518. package/dist/telemetry/index.mjs.map +0 -1
  519. package/dist/telemetry/scarf-client.d.ts +0 -7
  520. package/dist/telemetry/scarf-client.js +0 -59
  521. package/dist/telemetry/scarf-client.js.map +0 -1
  522. package/dist/telemetry/scarf-client.mjs +0 -7
  523. package/dist/telemetry/scarf-client.mjs.map +0 -1
  524. package/dist/telemetry/security-check.d.ts +0 -2
  525. package/dist/telemetry/security-check.js +0 -2
  526. package/dist/telemetry/security-check.js.map +0 -1
  527. package/dist/telemetry/security-check.mjs +0 -1
  528. package/dist/telemetry/security-check.mjs.map +0 -1
  529. package/dist/telemetry/telemetry-client.d.ts +0 -40
  530. package/dist/telemetry/telemetry-client.js +0 -186
  531. package/dist/telemetry/telemetry-client.js.map +0 -1
  532. package/dist/telemetry/utils.d.ts +0 -8
  533. package/dist/telemetry/utils.js +0 -69
  534. package/dist/telemetry/utils.js.map +0 -1
  535. package/dist/types/action.js +0 -19
  536. package/dist/types/action.js.map +0 -1
  537. package/dist/types/action.mjs +0 -2
  538. package/dist/types/action.mjs.map +0 -1
  539. package/dist/types/copilot-cloud-config.d.ts +0 -13
  540. package/dist/types/copilot-cloud-config.js +0 -19
  541. package/dist/types/copilot-cloud-config.js.map +0 -1
  542. package/dist/types/copilot-cloud-config.mjs +0 -2
  543. package/dist/types/copilot-cloud-config.mjs.map +0 -1
  544. package/dist/types/error.d.ts +0 -55
  545. package/dist/types/error.js +0 -19
  546. package/dist/types/error.js.map +0 -1
  547. package/dist/types/error.mjs +0 -2
  548. package/dist/types/error.mjs.map +0 -1
  549. package/dist/types/index.d.ts +0 -7
  550. package/dist/types/index.js +0 -19
  551. package/dist/types/index.js.map +0 -1
  552. package/dist/types/index.mjs +0 -8
  553. package/dist/types/index.mjs.map +0 -1
  554. package/dist/types/message.d.ts +0 -26
  555. package/dist/types/message.js +0 -19
  556. package/dist/types/message.js.map +0 -1
  557. package/dist/types/message.mjs +0 -2
  558. package/dist/types/message.mjs.map +0 -1
  559. package/dist/types/openai-assistant.d.ts +0 -53
  560. package/dist/types/openai-assistant.js +0 -19
  561. package/dist/types/openai-assistant.js.map +0 -1
  562. package/dist/types/openai-assistant.mjs +0 -2
  563. package/dist/types/openai-assistant.mjs.map +0 -1
  564. package/dist/types/utility.d.ts +0 -6
  565. package/dist/types/utility.js +0 -19
  566. package/dist/types/utility.js.map +0 -1
  567. package/dist/types/utility.mjs +0 -2
  568. package/dist/types/utility.mjs.map +0 -1
  569. package/dist/utils/conditions.js +0 -74
  570. package/dist/utils/conditions.js.map +0 -1
  571. package/dist/utils/console-styling.d.ts +0 -84
  572. package/dist/utils/console-styling.js +0 -123
  573. package/dist/utils/console-styling.js.map +0 -1
  574. package/dist/utils/errors.js +0 -443
  575. package/dist/utils/errors.js.map +0 -1
  576. package/dist/utils/index.d.ts +0 -32
  577. package/dist/utils/index.js +0 -927
  578. package/dist/utils/index.js.map +0 -1
  579. package/dist/utils/json-schema.js +0 -228
  580. package/dist/utils/json-schema.js.map +0 -1
  581. package/dist/utils/random-id.js +0 -68
  582. package/dist/utils/random-id.js.map +0 -1
  583. package/dist/utils/requests.js +0 -91
  584. package/dist/utils/requests.js.map +0 -1
  585. package/dist/utils/types.d.ts +0 -20
  586. package/dist/utils/types.js +0 -19
  587. package/dist/utils/types.js.map +0 -1
  588. package/jest.config.js +0 -5
  589. package/src/telemetry/scarf-client.ts +0 -39
  590. package/src/telemetry/security-check.ts +0 -0
  591. package/src/utils/json-schema.test.ts +0 -383
  592. package/tsup.config.ts +0 -11
@@ -0,0 +1,812 @@
1
+ import { describe, it, expect, vi } from "vitest";
2
+ import { z } from "zod";
3
+ import {
4
+ convertJsonSchemaToZodSchema,
5
+ actionParametersToJsonSchema,
6
+ jsonSchemaToActionParameters,
7
+ JSONSchema,
8
+ } from "../json-schema";
9
+ import { zodToJsonSchema } from "zod-to-json-schema";
10
+ import { Parameter } from "../../types";
11
+
12
+ describe("convertJsonSchemaToZodSchema", () => {
13
+ it("should convert a simple JSON schema to a Zod schema", () => {
14
+ const jsonSchema = {
15
+ type: "object",
16
+ properties: {
17
+ name: { type: "string" },
18
+ age: { type: "number" },
19
+ },
20
+ required: ["name", "age"],
21
+ };
22
+
23
+ const expectedSchema = z.object({
24
+ name: z.string(),
25
+ age: z.number(),
26
+ });
27
+
28
+ const result = convertJsonSchemaToZodSchema(jsonSchema, true);
29
+ const resultSchemaJson = zodToJsonSchema(result);
30
+ const expectedSchemaJson = zodToJsonSchema(expectedSchema);
31
+
32
+ expect(resultSchemaJson).toStrictEqual(expectedSchemaJson);
33
+ });
34
+
35
+ it("should convert a JSON schema with nested objects to a Zod schema", () => {
36
+ const jsonSchema = {
37
+ type: "object",
38
+ properties: {
39
+ name: { type: "string" },
40
+ address: {
41
+ type: "object",
42
+ properties: {
43
+ street: { type: "string" },
44
+ city: { type: "string" },
45
+ },
46
+ required: ["street", "city"],
47
+ },
48
+ },
49
+ required: ["name", "address"],
50
+ };
51
+
52
+ const expectedSchema = z.object({
53
+ name: z.string(),
54
+ address: z.object({
55
+ street: z.string(),
56
+ city: z.string(),
57
+ }),
58
+ });
59
+
60
+ const result = convertJsonSchemaToZodSchema(jsonSchema, true);
61
+ const resultSchemaJson = zodToJsonSchema(result);
62
+ const expectedSchemaJson = zodToJsonSchema(expectedSchema);
63
+
64
+ expect(resultSchemaJson).toStrictEqual(expectedSchemaJson);
65
+ });
66
+
67
+ it("should convert a JSON schema with arrays to a Zod schema", () => {
68
+ const jsonSchema = {
69
+ type: "object",
70
+ properties: {
71
+ names: {
72
+ type: "array",
73
+ items: { type: "string" },
74
+ },
75
+ },
76
+ required: ["names"],
77
+ };
78
+
79
+ const expectedSchema = z.object({
80
+ names: z.array(z.string()),
81
+ });
82
+
83
+ const result = convertJsonSchemaToZodSchema(jsonSchema, true);
84
+ const resultSchemaJson = zodToJsonSchema(result);
85
+ const expectedSchemaJson = zodToJsonSchema(expectedSchema);
86
+
87
+ expect(resultSchemaJson).toStrictEqual(expectedSchemaJson);
88
+ });
89
+
90
+ it("should convert a JSON schema with optional properties to a Zod schema", () => {
91
+ const jsonSchema = {
92
+ type: "object",
93
+ properties: {
94
+ name: { type: "string" },
95
+ age: { type: "number", required: false },
96
+ },
97
+ };
98
+
99
+ const expectedSchema = z
100
+ .object({
101
+ name: z.string().optional(),
102
+ age: z.number().optional(),
103
+ })
104
+ .optional();
105
+
106
+ const result = convertJsonSchemaToZodSchema(jsonSchema, false);
107
+
108
+ console.log(convertJsonSchemaToZodSchema(jsonSchema, false));
109
+
110
+ const resultSchemaJson = zodToJsonSchema(result);
111
+ const expectedSchemaJson = zodToJsonSchema(expectedSchema);
112
+
113
+ expect(resultSchemaJson).toStrictEqual(expectedSchemaJson);
114
+ });
115
+
116
+ it("should convert a JSON schema with different types to a Zod schema", () => {
117
+ const jsonSchema = {
118
+ type: "object",
119
+ properties: {
120
+ name: { type: "string" },
121
+ age: { type: "number" },
122
+ isAdmin: { type: "boolean" },
123
+ },
124
+ required: ["name", "age", "isAdmin"],
125
+ };
126
+
127
+ const expectedSchema = z.object({
128
+ name: z.string(),
129
+ age: z.number(),
130
+ isAdmin: z.boolean(),
131
+ });
132
+
133
+ const result = convertJsonSchemaToZodSchema(jsonSchema, true);
134
+ const resultSchemaJson = zodToJsonSchema(result);
135
+ const expectedSchemaJson = zodToJsonSchema(expectedSchema);
136
+
137
+ expect(resultSchemaJson).toStrictEqual(expectedSchemaJson);
138
+ });
139
+
140
+ it("should handle edge case where JSON schema has no properties", () => {
141
+ const jsonSchema = {
142
+ type: "object",
143
+ };
144
+
145
+ const expectedSchema = z.object({});
146
+
147
+ const result = convertJsonSchemaToZodSchema(jsonSchema, true);
148
+ const resultSchemaJson = zodToJsonSchema(result);
149
+ const expectedSchemaJson = zodToJsonSchema(expectedSchema);
150
+
151
+ expect(resultSchemaJson).toStrictEqual(expectedSchemaJson);
152
+ });
153
+
154
+ it("should preserve string enum constraints", () => {
155
+ const jsonSchema = {
156
+ type: "object",
157
+ properties: {
158
+ status: {
159
+ type: "string",
160
+ description: "The status",
161
+ enum: ["todo", "done"],
162
+ },
163
+ },
164
+ required: ["status"],
165
+ };
166
+ const result = convertJsonSchemaToZodSchema(jsonSchema, true);
167
+ const statusSchema = (result as z.ZodObject<any>).shape.status;
168
+ expect(statusSchema._def.typeName).toBe("ZodEnum");
169
+ expect(statusSchema._def.values).toEqual(["todo", "done"]);
170
+ });
171
+
172
+ it("should handle null-union type ['string', 'null'] as nullable", () => {
173
+ const jsonSchema = {
174
+ type: "object",
175
+ properties: {
176
+ nickname: {
177
+ type: ["string", "null"],
178
+ description: "Optional nickname",
179
+ },
180
+ },
181
+ required: ["nickname"],
182
+ };
183
+
184
+ const result = convertJsonSchemaToZodSchema(jsonSchema, true);
185
+ const shape = (result as z.ZodObject<any>).shape;
186
+
187
+ // The nickname field should accept both string and null
188
+ expect(shape.nickname.safeParse("hello").success).toBe(true);
189
+ expect(shape.nickname.safeParse(null).success).toBe(true);
190
+ expect(shape.nickname.safeParse(42).success).toBe(false);
191
+ });
192
+
193
+ it("should handle null-union type ['number', 'null'] as nullable number", () => {
194
+ const jsonSchema = {
195
+ type: "object",
196
+ properties: {
197
+ score: {
198
+ type: ["number", "null"],
199
+ },
200
+ },
201
+ required: ["score"],
202
+ };
203
+
204
+ const result = convertJsonSchemaToZodSchema(jsonSchema, true);
205
+ const shape = (result as z.ZodObject<any>).shape;
206
+
207
+ expect(shape.score.safeParse(42).success).toBe(true);
208
+ expect(shape.score.safeParse(null).success).toBe(true);
209
+ expect(shape.score.safeParse("hello").success).toBe(false);
210
+ });
211
+
212
+ it("should handle edge case where JSON schema has no required properties", () => {
213
+ const jsonSchema = {
214
+ type: "object",
215
+ properties: {
216
+ name: { type: "string" },
217
+ age: { type: "number" },
218
+ },
219
+ };
220
+
221
+ const expectedSchema = z
222
+ .object({
223
+ name: z.string().optional(),
224
+ age: z.number().optional(),
225
+ })
226
+ .optional();
227
+
228
+ const result = convertJsonSchemaToZodSchema(jsonSchema, false);
229
+ const resultSchemaJson = zodToJsonSchema(result);
230
+ const expectedSchemaJson = zodToJsonSchema(expectedSchema);
231
+
232
+ expect(resultSchemaJson).toStrictEqual(expectedSchemaJson);
233
+ });
234
+
235
+ it("should resolve non-circular $ref definitions correctly", () => {
236
+ const jsonSchema = {
237
+ type: "object",
238
+ properties: {
239
+ address: { $ref: "#/$defs/Address" },
240
+ },
241
+ required: ["address"],
242
+ $defs: {
243
+ Address: {
244
+ type: "object",
245
+ properties: {
246
+ street: { type: "string", description: "Street name" },
247
+ city: { type: "string", description: "City name" },
248
+ },
249
+ required: ["street", "city"],
250
+ description: "A postal address",
251
+ },
252
+ },
253
+ };
254
+
255
+ const result = convertJsonSchemaToZodSchema(jsonSchema, true);
256
+ const resultJson = zodToJsonSchema(result);
257
+
258
+ const expectedSchema = z.object({
259
+ address: z
260
+ .object({
261
+ street: z.string().describe("Street name"),
262
+ city: z.string().describe("City name"),
263
+ })
264
+ .describe("A postal address"),
265
+ });
266
+ const expectedJson = zodToJsonSchema(expectedSchema);
267
+
268
+ expect(resultJson).toStrictEqual(expectedJson);
269
+ });
270
+
271
+ it("should handle circular $ref without crashing and return z.any()", () => {
272
+ // A schema where Node references itself — this would cause infinite
273
+ // recursion without cycle detection.
274
+ const jsonSchema = {
275
+ type: "object",
276
+ properties: {
277
+ root: { $ref: "#/$defs/Node" },
278
+ },
279
+ required: ["root"],
280
+ $defs: {
281
+ Node: {
282
+ type: "object",
283
+ properties: {
284
+ value: { type: "string", description: "Node value" },
285
+ child: { $ref: "#/$defs/Node" },
286
+ },
287
+ required: ["value"],
288
+ description: "A tree node",
289
+ },
290
+ },
291
+ };
292
+
293
+ const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => {});
294
+
295
+ // Must not throw or hang
296
+ const result = convertJsonSchemaToZodSchema(jsonSchema, true);
297
+ expect(result).toBeDefined();
298
+
299
+ // The circular ref should have produced a console.warn
300
+ expect(warnSpy).toHaveBeenCalledWith(
301
+ expect.stringContaining("Circular $ref detected"),
302
+ );
303
+
304
+ // The top-level shape should still have a "root" key that is an object
305
+ const shape = (result as z.ZodObject<any>).shape;
306
+ expect(shape.root).toBeDefined();
307
+
308
+ // Inside root, "value" should be a string and "child" should be z.any()
309
+ // (child is optional since it's not in required[], so unwrap ZodOptional)
310
+ const rootShape = (shape.root as z.ZodObject<any>).shape;
311
+ expect(rootShape.value._def.typeName).toBe("ZodString");
312
+ const childDef = rootShape.child._def;
313
+ if (childDef.typeName === "ZodOptional") {
314
+ expect(childDef.innerType._def.typeName).toBe("ZodAny");
315
+ } else {
316
+ expect(childDef.typeName).toBe("ZodAny");
317
+ }
318
+
319
+ warnSpy.mockRestore();
320
+ });
321
+
322
+ it("should resolve the same $ref used by multiple sibling properties", () => {
323
+ // Two properties reference the same $def — the visited set must NOT
324
+ // mark the second usage as circular.
325
+ const jsonSchema = {
326
+ type: "object",
327
+ properties: {
328
+ billing: { $ref: "#/$defs/Address" },
329
+ shipping: { $ref: "#/$defs/Address" },
330
+ },
331
+ required: ["billing", "shipping"],
332
+ $defs: {
333
+ Address: {
334
+ type: "object",
335
+ properties: {
336
+ street: { type: "string", description: "Street" },
337
+ city: { type: "string", description: "City" },
338
+ },
339
+ required: ["street", "city"],
340
+ description: "An address",
341
+ },
342
+ },
343
+ };
344
+
345
+ const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => {});
346
+
347
+ const result = convertJsonSchemaToZodSchema(jsonSchema, true);
348
+ const shape = (result as z.ZodObject<any>).shape;
349
+
350
+ // Both should be fully resolved objects, NOT z.any()
351
+ expect(shape.billing._def.typeName).toBe("ZodObject");
352
+ expect(shape.shipping._def.typeName).toBe("ZodObject");
353
+
354
+ // No circular-ref warning should have been emitted
355
+ expect(warnSpy).not.toHaveBeenCalled();
356
+
357
+ warnSpy.mockRestore();
358
+ });
359
+
360
+ it("should resolve a shared $ref used in different branches of a $ref chain", () => {
361
+ // Wrapper -> Container (via $ref) which has two children both using $ref to Leaf.
362
+ // Without set cloning, the second Leaf ref in Container would be wrongly flagged
363
+ // as circular because the first Leaf resolution already added it to the set.
364
+ const jsonSchema = {
365
+ type: "object",
366
+ properties: {
367
+ wrapper: { $ref: "#/$defs/Container" },
368
+ },
369
+ required: ["wrapper"],
370
+ $defs: {
371
+ Container: {
372
+ type: "object",
373
+ properties: {
374
+ first: { $ref: "#/$defs/Leaf" },
375
+ second: { $ref: "#/$defs/Leaf" },
376
+ },
377
+ required: ["first", "second"],
378
+ description: "A container with two leaves",
379
+ },
380
+ Leaf: {
381
+ type: "object",
382
+ properties: {
383
+ label: { type: "string", description: "Leaf label" },
384
+ },
385
+ required: ["label"],
386
+ description: "A leaf node",
387
+ },
388
+ },
389
+ };
390
+
391
+ const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => {});
392
+
393
+ const result = convertJsonSchemaToZodSchema(jsonSchema, true);
394
+ const wrapperShape = (
395
+ (result as z.ZodObject<any>).shape.wrapper as z.ZodObject<any>
396
+ ).shape;
397
+
398
+ // Both first and second should be fully resolved Leaf objects
399
+ expect(wrapperShape.first._def.typeName).toBe("ZodObject");
400
+ expect(wrapperShape.second._def.typeName).toBe("ZodObject");
401
+
402
+ // No circular-ref warning should have been emitted
403
+ expect(warnSpy).not.toHaveBeenCalled();
404
+
405
+ warnSpy.mockRestore();
406
+ });
407
+
408
+ it("should handle anyOf with $ref variants", () => {
409
+ const jsonSchema = {
410
+ type: "object",
411
+ properties: {
412
+ pet: {
413
+ anyOf: [{ $ref: "#/$defs/Cat" }, { $ref: "#/$defs/Dog" }],
414
+ description: "A pet",
415
+ },
416
+ },
417
+ required: ["pet"],
418
+ $defs: {
419
+ Cat: {
420
+ type: "object",
421
+ properties: { meow: { type: "boolean" } },
422
+ required: ["meow"],
423
+ },
424
+ Dog: {
425
+ type: "object",
426
+ properties: { bark: { type: "boolean" } },
427
+ required: ["bark"],
428
+ },
429
+ },
430
+ };
431
+
432
+ const result = convertJsonSchemaToZodSchema(jsonSchema, true);
433
+ expect(result).toBeDefined();
434
+
435
+ // Should produce a union inside the "pet" property
436
+ const petSchema = (result as z.ZodObject<any>).shape.pet;
437
+ expect(petSchema._def.typeName).toBe("ZodUnion");
438
+ });
439
+
440
+ it("should handle integer type as z.number()", () => {
441
+ const jsonSchema = {
442
+ type: "object",
443
+ properties: {
444
+ count: { type: "integer", description: "A count" },
445
+ },
446
+ required: ["count"],
447
+ };
448
+
449
+ const result = convertJsonSchemaToZodSchema(jsonSchema, true);
450
+ const shape = (result as z.ZodObject<any>).shape;
451
+ expect(shape.count._def.typeName).toBe("ZodNumber");
452
+ });
453
+
454
+ it("should handle null type", () => {
455
+ const jsonSchema = {
456
+ type: "object",
457
+ properties: {
458
+ empty: { type: "null", description: "Always null" },
459
+ },
460
+ required: ["empty"],
461
+ };
462
+
463
+ const result = convertJsonSchemaToZodSchema(jsonSchema, true);
464
+ const shape = (result as z.ZodObject<any>).shape;
465
+ expect(shape.empty._def.typeName).toBe("ZodNull");
466
+ });
467
+
468
+ it("should warn and return z.any() for unsupported schema types", () => {
469
+ const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => {});
470
+
471
+ const jsonSchema = { type: "custom_unsupported" };
472
+ const result = convertJsonSchemaToZodSchema(jsonSchema, true);
473
+
474
+ expect(result._def.typeName).toBe("ZodAny");
475
+ expect(warnSpy).toHaveBeenCalledWith(
476
+ expect.stringContaining(
477
+ 'Unsupported JSON schema type "custom_unsupported"',
478
+ ),
479
+ );
480
+
481
+ warnSpy.mockRestore();
482
+ });
483
+ });
484
+
485
+ describe("jsonSchemaToActionParameters", () => {
486
+ it("should convert a simple JSONSchema to Parameter array", () => {
487
+ const jsonSchema: JSONSchema = {
488
+ type: "object",
489
+ properties: {
490
+ name: { type: "string", description: "User name" },
491
+ age: { type: "number", description: "User age" },
492
+ },
493
+ required: ["name"],
494
+ };
495
+
496
+ const expectedParameters: Parameter[] = [
497
+ { name: "name", type: "string", description: "User name" },
498
+ { name: "age", type: "number", description: "User age", required: false },
499
+ ];
500
+
501
+ const result = jsonSchemaToActionParameters(jsonSchema);
502
+ expect(result).toEqual(expectedParameters);
503
+ });
504
+
505
+ it("should convert JSONSchema with enum to Parameter array", () => {
506
+ const jsonSchema: JSONSchema = {
507
+ type: "object",
508
+ properties: {
509
+ role: {
510
+ type: "string",
511
+ enum: ["admin", "user", "guest"],
512
+ description: "User role",
513
+ },
514
+ },
515
+ required: ["role"],
516
+ };
517
+
518
+ const expectedParameters: Parameter[] = [
519
+ {
520
+ name: "role",
521
+ type: "string",
522
+ enum: ["admin", "user", "guest"],
523
+ description: "User role",
524
+ },
525
+ ];
526
+
527
+ const result = jsonSchemaToActionParameters(jsonSchema);
528
+ expect(result).toEqual(expectedParameters);
529
+ });
530
+
531
+ it("should convert nested object JSONSchema to Parameter array", () => {
532
+ const jsonSchema: JSONSchema = {
533
+ type: "object",
534
+ properties: {
535
+ user: {
536
+ type: "object",
537
+ properties: {
538
+ name: { type: "string", description: "User name" },
539
+ age: { type: "number", description: "User age" },
540
+ },
541
+ required: ["name"],
542
+ description: "User information",
543
+ },
544
+ },
545
+ required: ["user"],
546
+ };
547
+
548
+ const expectedParameters: Parameter[] = [
549
+ {
550
+ name: "user",
551
+ type: "object",
552
+ description: "User information",
553
+ attributes: [
554
+ { name: "name", type: "string", description: "User name" },
555
+ {
556
+ name: "age",
557
+ type: "number",
558
+ description: "User age",
559
+ required: false,
560
+ },
561
+ ],
562
+ },
563
+ ];
564
+
565
+ const result = jsonSchemaToActionParameters(jsonSchema);
566
+ expect(result).toEqual(expectedParameters);
567
+ });
568
+
569
+ it("should convert array JSONSchema to Parameter array", () => {
570
+ const jsonSchema: JSONSchema = {
571
+ type: "object",
572
+ properties: {
573
+ tags: {
574
+ type: "array",
575
+ items: { type: "string" },
576
+ description: "User tags",
577
+ },
578
+ },
579
+ required: ["tags"],
580
+ };
581
+
582
+ const expectedParameters: Parameter[] = [
583
+ { name: "tags", type: "string[]", description: "User tags" },
584
+ ];
585
+
586
+ const result = jsonSchemaToActionParameters(jsonSchema);
587
+ expect(result).toEqual(expectedParameters);
588
+ });
589
+
590
+ it("should convert object array JSONSchema to Parameter array", () => {
591
+ const jsonSchema: JSONSchema = {
592
+ type: "object",
593
+ properties: {
594
+ addresses: {
595
+ type: "array",
596
+ items: {
597
+ type: "object",
598
+ properties: {
599
+ street: { type: "string", description: "Street name" },
600
+ city: { type: "string", description: "City name" },
601
+ },
602
+ required: ["street"],
603
+ },
604
+ description: "User addresses",
605
+ },
606
+ },
607
+ required: ["addresses"],
608
+ };
609
+
610
+ const expectedParameters: Parameter[] = [
611
+ {
612
+ name: "addresses",
613
+ type: "object[]",
614
+ description: "User addresses",
615
+ attributes: [
616
+ { name: "street", type: "string", description: "Street name" },
617
+ {
618
+ name: "city",
619
+ type: "string",
620
+ description: "City name",
621
+ required: false,
622
+ },
623
+ ],
624
+ },
625
+ ];
626
+
627
+ const result = jsonSchemaToActionParameters(jsonSchema);
628
+ expect(result).toEqual(expectedParameters);
629
+ });
630
+
631
+ it("should handle boolean types", () => {
632
+ const jsonSchema: JSONSchema = {
633
+ type: "object",
634
+ properties: {
635
+ isAdmin: { type: "boolean", description: "Is user an admin" },
636
+ },
637
+ required: ["isAdmin"],
638
+ };
639
+
640
+ const expectedParameters: Parameter[] = [
641
+ { name: "isAdmin", type: "boolean", description: "Is user an admin" },
642
+ ];
643
+
644
+ const result = jsonSchemaToActionParameters(jsonSchema);
645
+ expect(result).toEqual(expectedParameters);
646
+ });
647
+
648
+ it("should handle empty object schema", () => {
649
+ const jsonSchema: JSONSchema = {
650
+ type: "object",
651
+ };
652
+
653
+ const expectedParameters: Parameter[] = [];
654
+
655
+ const result = jsonSchemaToActionParameters(jsonSchema);
656
+ expect(result).toEqual(expectedParameters);
657
+ });
658
+
659
+ it("should throw error for nested arrays", () => {
660
+ const jsonSchema: JSONSchema = {
661
+ type: "object",
662
+ properties: {
663
+ nestedArray: {
664
+ type: "array",
665
+ items: {
666
+ type: "array",
667
+ items: { type: "string" },
668
+ },
669
+ description: "Matrix of strings",
670
+ },
671
+ },
672
+ required: ["nestedArray"],
673
+ };
674
+
675
+ expect(() => jsonSchemaToActionParameters(jsonSchema)).toThrow(
676
+ "Nested arrays are not supported",
677
+ );
678
+ });
679
+
680
+ it("should handle null-union type ['string', 'null'] as optional string", () => {
681
+ const jsonSchema = {
682
+ type: "object",
683
+ properties: {
684
+ nickname: {
685
+ type: ["string", "null"],
686
+ description: "Optional nickname",
687
+ },
688
+ },
689
+ required: ["nickname"],
690
+ };
691
+
692
+ const result = jsonSchemaToActionParameters(jsonSchema as any);
693
+ expect(result).toEqual([
694
+ {
695
+ name: "nickname",
696
+ type: "string",
697
+ description: "Optional nickname",
698
+ required: false,
699
+ },
700
+ ]);
701
+ });
702
+
703
+ it("should handle null-union type ['object', 'null'] preserving properties", () => {
704
+ const jsonSchema = {
705
+ type: "object",
706
+ properties: {
707
+ metadata: {
708
+ type: ["object", "null"],
709
+ description: "Optional metadata",
710
+ properties: {
711
+ key: { type: "string" },
712
+ },
713
+ required: ["key"],
714
+ },
715
+ },
716
+ required: ["metadata"],
717
+ };
718
+
719
+ const result = jsonSchemaToActionParameters(jsonSchema as any);
720
+ expect(result).toEqual([
721
+ {
722
+ name: "metadata",
723
+ type: "object",
724
+ description: "Optional metadata",
725
+ required: false,
726
+ attributes: [{ name: "key", type: "string", description: undefined }],
727
+ },
728
+ ]);
729
+ });
730
+
731
+ it("should handle null-union type when field is already optional", () => {
732
+ const jsonSchema = {
733
+ type: "object",
734
+ properties: {
735
+ nickname: {
736
+ type: ["string", "null"],
737
+ description: "Optional nickname",
738
+ },
739
+ },
740
+ // nickname is NOT in required
741
+ };
742
+
743
+ const result = jsonSchemaToActionParameters(jsonSchema as any);
744
+ expect(result).toEqual([
745
+ {
746
+ name: "nickname",
747
+ type: "string",
748
+ description: "Optional nickname",
749
+ required: false,
750
+ },
751
+ ]);
752
+ });
753
+
754
+ it("should handle type array with only 'null' by falling back to string", () => {
755
+ const jsonSchema = {
756
+ type: "object",
757
+ properties: {
758
+ weird: {
759
+ type: ["null"],
760
+ description: "Null-only type",
761
+ },
762
+ },
763
+ required: ["weird"],
764
+ };
765
+
766
+ const result = jsonSchemaToActionParameters(jsonSchema as any);
767
+ expect(result).toEqual([
768
+ {
769
+ name: "weird",
770
+ type: "string",
771
+ description: "Null-only type",
772
+ required: false,
773
+ },
774
+ ]);
775
+ });
776
+
777
+ it("should ensure round-trip conversion works", () => {
778
+ const originalParameters: Parameter[] = [
779
+ { name: "name", type: "string", description: "User name" },
780
+ { name: "age", type: "number", description: "User age", required: false },
781
+ {
782
+ name: "role",
783
+ type: "string",
784
+ enum: ["admin", "user"],
785
+ description: "User role",
786
+ },
787
+ {
788
+ name: "address",
789
+ type: "object",
790
+ description: "User address",
791
+ attributes: [
792
+ { name: "street", type: "string", description: "Street name" },
793
+ { name: "city", type: "string", description: "City name" },
794
+ ],
795
+ },
796
+ {
797
+ name: "contacts",
798
+ type: "object[]",
799
+ description: "User contacts",
800
+ attributes: [
801
+ { name: "type", type: "string", description: "Contact type" },
802
+ { name: "value", type: "string", description: "Contact value" },
803
+ ],
804
+ },
805
+ ];
806
+
807
+ const jsonSchema = actionParametersToJsonSchema(originalParameters);
808
+ const roundTripParameters = jsonSchemaToActionParameters(jsonSchema);
809
+
810
+ expect(roundTripParameters).toEqual(originalParameters);
811
+ });
812
+ });