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

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,263 @@
1
+ import { isSafeDashboardUrl } from "./dashboard-url";
2
+
3
+ /**
4
+ * Inspector metadata supplied by a trusted CopilotKit runtime.
5
+ *
6
+ * Each optional module is independent so clients can render partial metadata
7
+ * from runtimes that do not expose every module.
8
+ */
9
+ export interface InspectorMetadataV1 {
10
+ readonly schemaVersion: 1;
11
+ readonly identity?: {
12
+ readonly organizationName: string;
13
+ readonly projectName: string;
14
+ };
15
+ readonly plan?: {
16
+ readonly code: string;
17
+ readonly label: string;
18
+ };
19
+ readonly license?: {
20
+ readonly state: "valid" | "none" | "expired" | "unknown";
21
+ };
22
+ readonly action?:
23
+ | { readonly kind: "manage_plan"; readonly url: string }
24
+ | { readonly kind: "renew"; readonly url: string }
25
+ | { readonly kind: "enable_intelligence"; readonly url: string };
26
+ readonly usage?: {
27
+ readonly used: number;
28
+ readonly limit:
29
+ | { readonly kind: "finite"; readonly value: number }
30
+ | { readonly kind: "unlimited" }
31
+ | { readonly kind: "unknown" };
32
+ readonly expiringSoonCount?: number;
33
+ };
34
+ }
35
+
36
+ type UnknownRecord = Record<string, unknown>;
37
+ type InspectorIdentity = NonNullable<InspectorMetadataV1["identity"]>;
38
+ type InspectorPlan = NonNullable<InspectorMetadataV1["plan"]>;
39
+ type InspectorLicense = NonNullable<InspectorMetadataV1["license"]>;
40
+ type InspectorAction = NonNullable<InspectorMetadataV1["action"]>;
41
+ type InspectorUsage = NonNullable<InspectorMetadataV1["usage"]>;
42
+ type InspectorUsageLimit = InspectorUsage["limit"];
43
+
44
+ function isRecord(value: unknown): value is UnknownRecord {
45
+ if (typeof value !== "object" || value === null || Array.isArray(value)) {
46
+ return false;
47
+ }
48
+
49
+ try {
50
+ const prototype = Object.getPrototypeOf(value);
51
+ return prototype === Object.prototype || prototype === null;
52
+ } catch {
53
+ return false;
54
+ }
55
+ }
56
+
57
+ function readOwnDataProperty(value: UnknownRecord, key: string): unknown {
58
+ try {
59
+ const descriptor = Object.getOwnPropertyDescriptor(value, key);
60
+ return descriptor !== undefined && "value" in descriptor
61
+ ? descriptor.value
62
+ : undefined;
63
+ } catch {
64
+ return undefined;
65
+ }
66
+ }
67
+
68
+ function parseNonBlankString(value: unknown): string | undefined {
69
+ if (typeof value !== "string") {
70
+ return undefined;
71
+ }
72
+
73
+ const parsed = value.trim();
74
+ return parsed.length > 0 ? parsed : undefined;
75
+ }
76
+
77
+ function parseIdentity(value: unknown): InspectorIdentity | undefined {
78
+ if (!isRecord(value)) {
79
+ return undefined;
80
+ }
81
+
82
+ const organizationName = parseNonBlankString(value.organizationName);
83
+ const projectName = parseNonBlankString(value.projectName);
84
+ if (organizationName === undefined || projectName === undefined) {
85
+ return undefined;
86
+ }
87
+
88
+ return { organizationName, projectName };
89
+ }
90
+
91
+ function parsePlan(value: unknown): InspectorPlan | undefined {
92
+ if (!isRecord(value)) {
93
+ return undefined;
94
+ }
95
+
96
+ const code = parseNonBlankString(value.code);
97
+ const label = parseNonBlankString(value.label);
98
+ if (code === undefined || label === undefined) {
99
+ return undefined;
100
+ }
101
+
102
+ return { code, label };
103
+ }
104
+
105
+ function parseLicense(value: unknown): InspectorLicense | undefined {
106
+ if (!isRecord(value)) {
107
+ return undefined;
108
+ }
109
+
110
+ switch (value.state) {
111
+ case "valid":
112
+ case "none":
113
+ case "expired":
114
+ case "unknown":
115
+ return { state: value.state };
116
+ default:
117
+ return undefined;
118
+ }
119
+ }
120
+
121
+ function parseActionKind(value: unknown): InspectorAction["kind"] | undefined {
122
+ switch (value) {
123
+ case "manage_plan":
124
+ case "renew":
125
+ case "enable_intelligence":
126
+ return value;
127
+ default:
128
+ return undefined;
129
+ }
130
+ }
131
+
132
+ function parseSafeActionUrl(value: unknown): string | undefined {
133
+ const url = parseNonBlankString(value);
134
+ if (url === undefined || url.includes("?") || url.includes("#")) {
135
+ return undefined;
136
+ }
137
+
138
+ const authorityStart = url.indexOf("://");
139
+ if (authorityStart < 1) {
140
+ return undefined;
141
+ }
142
+
143
+ const authorityAndPath = url.slice(authorityStart + 3);
144
+ const pathStart = authorityAndPath.indexOf("/");
145
+ const authority =
146
+ pathStart === -1 ? authorityAndPath : authorityAndPath.slice(0, pathStart);
147
+ if (authority.includes("@")) {
148
+ return undefined;
149
+ }
150
+
151
+ let parsed: URL;
152
+ try {
153
+ parsed = new URL(url);
154
+ } catch {
155
+ return undefined;
156
+ }
157
+
158
+ if (parsed.hostname.length === 0 || parsed.username || parsed.password) {
159
+ return undefined;
160
+ }
161
+
162
+ return isSafeDashboardUrl(parsed) ? url : undefined;
163
+ }
164
+
165
+ function parseAction(value: unknown): InspectorAction | undefined {
166
+ if (!isRecord(value)) {
167
+ return undefined;
168
+ }
169
+
170
+ const kind = parseActionKind(value.kind);
171
+ const url = parseSafeActionUrl(value.url);
172
+ if (kind === undefined || url === undefined) {
173
+ return undefined;
174
+ }
175
+
176
+ return { kind, url };
177
+ }
178
+
179
+ function isFiniteNonnegativeInteger(value: unknown): value is number {
180
+ return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
181
+ }
182
+
183
+ function parseUsageLimit(value: unknown): InspectorUsageLimit | undefined {
184
+ if (!isRecord(value)) {
185
+ return undefined;
186
+ }
187
+
188
+ if (value.kind === "finite") {
189
+ if (
190
+ typeof value.value !== "number" ||
191
+ !Number.isSafeInteger(value.value) ||
192
+ value.value < 1
193
+ ) {
194
+ return undefined;
195
+ }
196
+
197
+ return { kind: "finite", value: value.value };
198
+ }
199
+
200
+ if (value.kind === "unlimited") {
201
+ return { kind: "unlimited" };
202
+ }
203
+
204
+ if (value.kind === "unknown") {
205
+ return { kind: "unknown" };
206
+ }
207
+
208
+ return undefined;
209
+ }
210
+
211
+ function parseUsage(value: unknown): InspectorUsage | undefined {
212
+ if (!isRecord(value)) {
213
+ return undefined;
214
+ }
215
+
216
+ const limit = parseUsageLimit(value.limit);
217
+ const used = value.used;
218
+ if (!isFiniteNonnegativeInteger(used) || limit === undefined) {
219
+ return undefined;
220
+ }
221
+
222
+ const rawExpiringSoonCount = readOwnDataProperty(value, "expiringSoonCount");
223
+ const expiringSoonCount = isFiniteNonnegativeInteger(rawExpiringSoonCount)
224
+ ? rawExpiringSoonCount
225
+ : undefined;
226
+
227
+ return {
228
+ used,
229
+ limit,
230
+ ...(expiringSoonCount === undefined ? {} : { expiringSoonCount }),
231
+ };
232
+ }
233
+
234
+ /**
235
+ * Parses untrusted inspector metadata without letting one invalid optional
236
+ * module hide the other valid modules.
237
+ *
238
+ * @param value - The decoded runtime response body.
239
+ * @returns Normalized version 1 metadata, or `undefined` for an unsupported
240
+ * top-level payload.
241
+ */
242
+ export function parseInspectorMetadataV1(
243
+ value: unknown,
244
+ ): InspectorMetadataV1 | undefined {
245
+ if (!isRecord(value) || value.schemaVersion !== 1) {
246
+ return undefined;
247
+ }
248
+
249
+ const identity = parseIdentity(value.identity);
250
+ const plan = parsePlan(value.plan);
251
+ const license = parseLicense(value.license);
252
+ const action = parseAction(value.action);
253
+ const usage = parseUsage(value.usage);
254
+
255
+ return {
256
+ schemaVersion: 1,
257
+ ...(identity === undefined ? {} : { identity }),
258
+ ...(plan === undefined ? {} : { plan }),
259
+ ...(license === undefined ? {} : { license }),
260
+ ...(action === undefined ? {} : { action }),
261
+ ...(usage === undefined ? {} : { usage }),
262
+ };
263
+ }
@@ -0,0 +1,43 @@
1
+ import { describe, expect, it } from "vitest";
2
+ import { shouldEnableInspector } from "./inspector-visibility";
3
+
4
+ describe("shouldEnableInspector", () => {
5
+ it("shows by default in a development browser", () => {
6
+ expect(
7
+ shouldEnableInspector({
8
+ isBrowser: true,
9
+ isDevelopment: true,
10
+ }),
11
+ ).toBe(true);
12
+ });
13
+
14
+ it("honors an explicit disable in development", () => {
15
+ expect(
16
+ shouldEnableInspector({
17
+ enableInspector: false,
18
+ isBrowser: true,
19
+ isDevelopment: true,
20
+ }),
21
+ ).toBe(false);
22
+ });
23
+
24
+ it("never shows in production, even when explicitly enabled", () => {
25
+ expect(
26
+ shouldEnableInspector({
27
+ enableInspector: true,
28
+ isBrowser: true,
29
+ isDevelopment: false,
30
+ }),
31
+ ).toBe(false);
32
+ });
33
+
34
+ it("never shows during server rendering", () => {
35
+ expect(
36
+ shouldEnableInspector({
37
+ enableInspector: true,
38
+ isBrowser: false,
39
+ isDevelopment: true,
40
+ }),
41
+ ).toBe(false);
42
+ });
43
+ });
@@ -0,0 +1,17 @@
1
+ export interface InspectorVisibilityOptions {
2
+ enableInspector?: boolean;
3
+ isBrowser: boolean;
4
+ isDevelopment: boolean;
5
+ }
6
+
7
+ /**
8
+ * The Inspector is a development-only browser tool. Consumers may disable it,
9
+ * but an explicit `true` never overrides a production or server environment.
10
+ */
11
+ export function shouldEnableInspector({
12
+ enableInspector,
13
+ isBrowser,
14
+ isDevelopment,
15
+ }: InspectorVisibilityOptions): boolean {
16
+ return isBrowser && isDevelopment && enableInspector !== false;
17
+ }
@@ -37,7 +37,9 @@ export type JSONSchema =
37
37
  | JSONSchemaObject
38
38
  | JSONSchemaArray;
39
39
 
40
- export function actionParametersToJsonSchema(actionParameters: Parameter[]): JSONSchema {
40
+ export function actionParametersToJsonSchema(
41
+ actionParameters: Parameter[],
42
+ ): JSONSchema {
41
43
  // Create the parameters object based on the argumentAnnotations
42
44
  let parameters: { [key: string]: any } = {};
43
45
  for (let parameter of actionParameters || []) {
@@ -60,7 +62,9 @@ export function actionParametersToJsonSchema(actionParameters: Parameter[]): JSO
60
62
  }
61
63
 
62
64
  // Convert JSONSchema to Parameter[]
63
- export function jsonSchemaToActionParameters(jsonSchema: JSONSchema): Parameter[] {
65
+ export function jsonSchemaToActionParameters(
66
+ jsonSchema: JSONSchema,
67
+ ): Parameter[] {
64
68
  if (jsonSchema.type !== "object" || !jsonSchema.properties) {
65
69
  return [];
66
70
  }
@@ -69,7 +73,11 @@ export function jsonSchemaToActionParameters(jsonSchema: JSONSchema): Parameter[
69
73
  const requiredFields = jsonSchema.required || [];
70
74
 
71
75
  for (const [name, schema] of Object.entries(jsonSchema.properties)) {
72
- const parameter = convertJsonSchemaToParameter(name, schema, requiredFields.includes(name));
76
+ const parameter = convertJsonSchemaToParameter(
77
+ name,
78
+ schema,
79
+ requiredFields.includes(name),
80
+ );
73
81
  parameters.push(parameter);
74
82
  }
75
83
 
@@ -91,6 +99,19 @@ function convertJsonSchemaToParameter(
91
99
  baseParameter.required = false;
92
100
  }
93
101
 
102
+ // Handle null-union types like ["string", "null"] by picking the non-null type
103
+ if (Array.isArray(schema.type)) {
104
+ const types = schema.type as string[];
105
+ const hasNull = types.includes("null");
106
+ const nonNullTypes = types.filter((t: string) => t !== "null");
107
+ const resolvedType = nonNullTypes.length > 0 ? nonNullTypes[0] : "string";
108
+ return convertJsonSchemaToParameter(
109
+ name,
110
+ { ...schema, type: resolvedType } as JSONSchema,
111
+ hasNull ? false : isRequired,
112
+ );
113
+ }
114
+
94
115
  switch (schema.type) {
95
116
  case "string":
96
117
  return {
@@ -109,9 +130,15 @@ function convertJsonSchemaToParameter(
109
130
  const attributes: Parameter[] = [];
110
131
  const requiredFields = schema.required || [];
111
132
 
112
- for (const [propName, propSchema] of Object.entries(schema.properties)) {
133
+ for (const [propName, propSchema] of Object.entries(
134
+ schema.properties,
135
+ )) {
113
136
  attributes.push(
114
- convertJsonSchemaToParameter(propName, propSchema, requiredFields.includes(propName)),
137
+ convertJsonSchemaToParameter(
138
+ propName,
139
+ propSchema,
140
+ requiredFields.includes(propName),
141
+ ),
115
142
  );
116
143
  }
117
144
 
@@ -130,9 +157,15 @@ function convertJsonSchemaToParameter(
130
157
  const attributes: Parameter[] = [];
131
158
  const requiredFields = schema.items.required || [];
132
159
 
133
- for (const [propName, propSchema] of Object.entries(schema.items.properties || {})) {
160
+ for (const [propName, propSchema] of Object.entries(
161
+ schema.items.properties || {},
162
+ )) {
134
163
  attributes.push(
135
- convertJsonSchemaToParameter(propName, propSchema, requiredFields.includes(propName)),
164
+ convertJsonSchemaToParameter(
165
+ propName,
166
+ propSchema,
167
+ requiredFields.includes(propName),
168
+ ),
136
169
  );
137
170
  }
138
171
 
@@ -218,7 +251,91 @@ function convertAttribute(attribute: Parameter): JSONSchema {
218
251
  }
219
252
  }
220
253
 
221
- export function convertJsonSchemaToZodSchema(jsonSchema: any, required: boolean): z.ZodSchema {
254
+ export function convertJsonSchemaToZodSchema(
255
+ jsonSchema: any,
256
+ required: boolean,
257
+ definitions?: Record<string, any>,
258
+ visitedRefs?: Set<string>,
259
+ ): z.ZodSchema {
260
+ // Resolve $ref references
261
+ if (jsonSchema.$ref && definitions) {
262
+ const refPath = jsonSchema.$ref.replace(
263
+ /^#\/\$defs\/|^#\/definitions\//,
264
+ "",
265
+ );
266
+
267
+ // Detect circular $ref cycles
268
+ const refs = visitedRefs ?? new Set<string>();
269
+ if (refs.has(refPath)) {
270
+ console.warn(
271
+ `[CopilotKit] Circular $ref detected for "${refPath}" — falling back to z.any()`,
272
+ );
273
+ let schema = z.any();
274
+ if (jsonSchema.description) {
275
+ schema = schema.describe(jsonSchema.description);
276
+ }
277
+ return required ? schema : schema.optional();
278
+ }
279
+
280
+ const resolved = definitions[refPath];
281
+ if (resolved) {
282
+ // Clone the set so sibling branches don't see each other's visited refs
283
+ const nextRefs = new Set(refs);
284
+ nextRefs.add(refPath);
285
+ return convertJsonSchemaToZodSchema(
286
+ resolved,
287
+ required,
288
+ definitions,
289
+ nextRefs,
290
+ );
291
+ }
292
+ }
293
+
294
+ // Collect top-level definitions for $ref resolution
295
+ const defs = definitions ?? jsonSchema.$defs ?? jsonSchema.definitions;
296
+
297
+ // Handle null-union types like ["string", "null"]
298
+ if (Array.isArray(jsonSchema.type)) {
299
+ const types = jsonSchema.type as string[];
300
+ const hasNull = types.includes("null");
301
+ const nonNullTypes = types.filter((t: string) => t !== "null");
302
+ const resolvedType = nonNullTypes.length > 0 ? nonNullTypes[0] : "string";
303
+ const innerSchema = convertJsonSchemaToZodSchema(
304
+ { ...jsonSchema, type: resolvedType },
305
+ true,
306
+ defs,
307
+ visitedRefs,
308
+ );
309
+ let schema = hasNull ? z.union([innerSchema, z.null()]) : innerSchema;
310
+ if (jsonSchema.description) {
311
+ schema = schema.describe(jsonSchema.description);
312
+ }
313
+ return required ? schema : schema.optional();
314
+ }
315
+
316
+ // Handle anyOf / oneOf as z.union
317
+ const unionVariants = jsonSchema.anyOf ?? jsonSchema.oneOf;
318
+ if (Array.isArray(unionVariants) && unionVariants.length > 0) {
319
+ if (unionVariants.length === 1) {
320
+ return convertJsonSchemaToZodSchema(
321
+ unionVariants[0],
322
+ required,
323
+ defs,
324
+ visitedRefs,
325
+ );
326
+ }
327
+ const schemas = unionVariants.map((v: any) =>
328
+ convertJsonSchemaToZodSchema(v, true, defs, visitedRefs),
329
+ );
330
+ let schema = z.union(
331
+ schemas as [z.ZodSchema, z.ZodSchema, ...z.ZodSchema[]],
332
+ );
333
+ if (jsonSchema.description) {
334
+ schema = schema.describe(jsonSchema.description);
335
+ }
336
+ return required ? schema : schema.optional();
337
+ }
338
+
222
339
  if (jsonSchema.type === "object") {
223
340
  const spec: { [key: string]: z.ZodSchema } = {};
224
341
 
@@ -230,28 +347,55 @@ export function convertJsonSchemaToZodSchema(jsonSchema: any, required: boolean)
230
347
  spec[key] = convertJsonSchemaToZodSchema(
231
348
  value,
232
349
  jsonSchema.required ? jsonSchema.required.includes(key) : false,
350
+ defs,
351
+ visitedRefs,
233
352
  );
234
353
  }
235
354
  let schema = z.object(spec).describe(jsonSchema.description);
236
355
  return required ? schema : schema.optional();
237
356
  } else if (jsonSchema.type === "string") {
357
+ if (jsonSchema.enum && jsonSchema.enum.length > 0) {
358
+ let schema = z
359
+ .enum(jsonSchema.enum as [string, ...string[]])
360
+ .describe(jsonSchema.description);
361
+ return required ? schema : schema.optional();
362
+ }
238
363
  let schema = z.string().describe(jsonSchema.description);
239
364
  return required ? schema : schema.optional();
240
- } else if (jsonSchema.type === "number") {
365
+ } else if (jsonSchema.type === "number" || jsonSchema.type === "integer") {
241
366
  let schema = z.number().describe(jsonSchema.description);
242
367
  return required ? schema : schema.optional();
243
368
  } else if (jsonSchema.type === "boolean") {
244
369
  let schema = z.boolean().describe(jsonSchema.description);
245
370
  return required ? schema : schema.optional();
246
371
  } else if (jsonSchema.type === "array") {
247
- let itemSchema = convertJsonSchemaToZodSchema(jsonSchema.items, true);
372
+ let itemSchema = convertJsonSchemaToZodSchema(
373
+ jsonSchema.items,
374
+ true,
375
+ defs,
376
+ visitedRefs,
377
+ );
248
378
  let schema = z.array(itemSchema).describe(jsonSchema.description);
249
379
  return required ? schema : schema.optional();
380
+ } else if (jsonSchema.type === "null") {
381
+ let schema = z.null().describe(jsonSchema.description);
382
+ return required ? schema : schema.optional();
383
+ }
384
+
385
+ // Fallback: accept any value rather than throwing
386
+ console.warn(
387
+ `[CopilotKit] Unsupported JSON schema type "${jsonSchema.type ?? "unknown"}" — falling back to z.any()`,
388
+ );
389
+ let schema = z.any();
390
+ if (jsonSchema.description) {
391
+ schema = schema.describe(jsonSchema.description);
250
392
  }
251
- throw new Error("Invalid JSON schema");
393
+ return required ? schema : schema.optional();
252
394
  }
253
395
 
254
- export function getZodParameters<T extends [] | Parameter[] | undefined>(parameters: T): any {
396
+ export function getZodParameters<T extends [] | Parameter[] | undefined>(
397
+ parameters: T,
398
+ ): any {
255
399
  if (!parameters) return z.object({});
256
400
  const jsonParams = actionParametersToJsonSchema(parameters);
257
401
  return convertJsonSchemaToZodSchema(jsonParams, true);
@@ -31,9 +31,12 @@ function toSerializable(value: unknown): unknown {
31
31
  export function dataToUUID(input: string | object, namespace?: string): string {
32
32
  const BASE_NAMESPACE = "e4b01160-ff74-4c6e-9b27-d53cd930fe8e";
33
33
  // Since namespace needs to be a uuid, we are creating a uuid for it.
34
- const boundNamespace = namespace ? uuidv5(namespace, BASE_NAMESPACE) : BASE_NAMESPACE;
34
+ const boundNamespace = namespace
35
+ ? uuidv5(namespace, BASE_NAMESPACE)
36
+ : BASE_NAMESPACE;
35
37
 
36
- const stringInput = typeof input === "string" ? input : JSON.stringify(toSerializable(input));
38
+ const stringInput =
39
+ typeof input === "string" ? input : JSON.stringify(toSerializable(input));
37
40
  return uuidv5(stringInput, boundNamespace);
38
41
  }
39
42
 
@@ -5,7 +5,9 @@
5
5
  * - Tries JSON first regardless of content-type
6
6
  * - Falls back to text and optionally parses when it "looks" like JSON
7
7
  */
8
- export async function readBody<T extends Response | Request>(r: T): Promise<unknown> {
8
+ export async function readBody<T extends Response | Request>(
9
+ r: T,
10
+ ): Promise<unknown> {
9
11
  // skip GET/HEAD requests (unchanged)
10
12
  const method = "method" in r ? r.method.toUpperCase() : undefined;
11
13
  if (method === "GET" || method === "HEAD") {