@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,743 @@
1
+ import { expect, test, vi } from "vitest";
2
+
3
+ import { parseInspectorMetadataV1 } from "./inspector-metadata";
4
+
5
+ function metadataWithUsage(usage: unknown): Record<string, unknown> {
6
+ return {
7
+ schemaVersion: 1,
8
+ identity: {
9
+ organizationName: "Acme",
10
+ projectName: "Support",
11
+ },
12
+ usage,
13
+ };
14
+ }
15
+
16
+ function validUsage(limit: unknown = { kind: "finite", value: 100 }) {
17
+ return {
18
+ used: 12,
19
+ limit,
20
+ };
21
+ }
22
+
23
+ function nullPrototypeRecord(
24
+ fields: Record<string, unknown>,
25
+ ): Record<string, unknown> {
26
+ return Object.assign(Object.create(null), fields);
27
+ }
28
+
29
+ test("parses complete metadata and strips unknown fields", () => {
30
+ const value = {
31
+ schemaVersion: 1,
32
+ identity: {
33
+ organizationName: " Acme Inc. ",
34
+ projectName: " Support ",
35
+ organizationId: "org-secret",
36
+ },
37
+ plan: {
38
+ code: " enterprise ",
39
+ label: " Enterprise ",
40
+ internalPriceId: "price-secret",
41
+ },
42
+ license: {
43
+ state: "valid",
44
+ expiresAt: "2030-01-01T00:00:00.000Z",
45
+ },
46
+ action: {
47
+ kind: "manage_plan",
48
+ url: " https://cloud.copilotkit.ai/manage ",
49
+ method: "POST",
50
+ },
51
+ usage: {
52
+ used: 12,
53
+ limit: {
54
+ kind: "finite",
55
+ value: 100,
56
+ unit: "threads",
57
+ },
58
+ internalThreadIds: ["thread-secret"],
59
+ },
60
+ internalOrganizationId: "org-secret",
61
+ };
62
+
63
+ const result = parseInspectorMetadataV1(value);
64
+
65
+ expect(result).toStrictEqual({
66
+ schemaVersion: 1,
67
+ identity: {
68
+ organizationName: "Acme Inc.",
69
+ projectName: "Support",
70
+ },
71
+ plan: {
72
+ code: "enterprise",
73
+ label: "Enterprise",
74
+ },
75
+ license: {
76
+ state: "valid",
77
+ },
78
+ action: {
79
+ kind: "manage_plan",
80
+ url: "https://cloud.copilotkit.ai/manage",
81
+ },
82
+ usage: {
83
+ used: 12,
84
+ limit: {
85
+ kind: "finite",
86
+ value: 100,
87
+ },
88
+ },
89
+ });
90
+ });
91
+
92
+ test("parses identity when it is the only metadata module", () => {
93
+ const value = {
94
+ schemaVersion: 1,
95
+ identity: {
96
+ organizationName: "Acme",
97
+ projectName: "Support",
98
+ },
99
+ };
100
+
101
+ const result = parseInspectorMetadataV1(value);
102
+
103
+ expect(result).toStrictEqual({
104
+ schemaVersion: 1,
105
+ identity: {
106
+ organizationName: "Acme",
107
+ projectName: "Support",
108
+ },
109
+ });
110
+ });
111
+
112
+ test("parses plan when it is the only metadata module", () => {
113
+ const value = {
114
+ schemaVersion: 1,
115
+ plan: {
116
+ code: "enterprise",
117
+ label: "Enterprise",
118
+ },
119
+ };
120
+
121
+ const result = parseInspectorMetadataV1(value);
122
+
123
+ expect(result).toStrictEqual({
124
+ schemaVersion: 1,
125
+ plan: {
126
+ code: "enterprise",
127
+ label: "Enterprise",
128
+ },
129
+ });
130
+ });
131
+
132
+ test("parses license when it is the only metadata module", () => {
133
+ const value = {
134
+ schemaVersion: 1,
135
+ license: {
136
+ state: "expired",
137
+ },
138
+ };
139
+
140
+ const result = parseInspectorMetadataV1(value);
141
+
142
+ expect(result).toStrictEqual({
143
+ schemaVersion: 1,
144
+ license: {
145
+ state: "expired",
146
+ },
147
+ });
148
+ });
149
+
150
+ test("parses action when it is the only metadata module", () => {
151
+ const value = {
152
+ schemaVersion: 1,
153
+ action: {
154
+ kind: "renew",
155
+ url: "https://cloud.copilotkit.ai/renew",
156
+ },
157
+ };
158
+
159
+ const result = parseInspectorMetadataV1(value);
160
+
161
+ expect(result).toStrictEqual({
162
+ schemaVersion: 1,
163
+ action: {
164
+ kind: "renew",
165
+ url: "https://cloud.copilotkit.ai/renew",
166
+ },
167
+ });
168
+ });
169
+
170
+ test("parses usage when it is the only metadata module", () => {
171
+ const value = {
172
+ schemaVersion: 1,
173
+ usage: validUsage(),
174
+ };
175
+
176
+ const result = parseInspectorMetadataV1(value);
177
+
178
+ expect(result).toStrictEqual({
179
+ schemaVersion: 1,
180
+ usage: validUsage(),
181
+ });
182
+ });
183
+
184
+ test.each([
185
+ {
186
+ name: "identity",
187
+ value: {
188
+ schemaVersion: 1,
189
+ identity: { organizationName: " ", projectName: "Support" },
190
+ plan: { code: "developer", label: "Developer" },
191
+ },
192
+ expected: {
193
+ schemaVersion: 1,
194
+ plan: { code: "developer", label: "Developer" },
195
+ },
196
+ },
197
+ {
198
+ name: "plan",
199
+ value: {
200
+ schemaVersion: 1,
201
+ identity: { organizationName: "Acme", projectName: "Support" },
202
+ plan: { code: "enterprise", label: "" },
203
+ },
204
+ expected: {
205
+ schemaVersion: 1,
206
+ identity: { organizationName: "Acme", projectName: "Support" },
207
+ },
208
+ },
209
+ {
210
+ name: "license",
211
+ value: {
212
+ schemaVersion: 1,
213
+ plan: { code: "developer", label: "Developer" },
214
+ license: { state: "revoked" },
215
+ },
216
+ expected: {
217
+ schemaVersion: 1,
218
+ plan: { code: "developer", label: "Developer" },
219
+ },
220
+ },
221
+ {
222
+ name: "action",
223
+ value: {
224
+ schemaVersion: 1,
225
+ plan: { code: "developer", label: "Developer" },
226
+ action: {
227
+ kind: "manage_plan",
228
+ url: "http://cloud.copilotkit.ai/manage",
229
+ },
230
+ },
231
+ expected: {
232
+ schemaVersion: 1,
233
+ plan: { code: "developer", label: "Developer" },
234
+ },
235
+ },
236
+ {
237
+ name: "usage",
238
+ value: {
239
+ schemaVersion: 1,
240
+ plan: { code: "developer", label: "Developer" },
241
+ usage: validUsage({ kind: "finite", value: 0 }),
242
+ },
243
+ expected: {
244
+ schemaVersion: 1,
245
+ plan: { code: "developer", label: "Developer" },
246
+ },
247
+ },
248
+ ])(
249
+ "omits an invalid $name module while retaining valid metadata",
250
+ (testCase) => {
251
+ const result = parseInspectorMetadataV1(testCase.value);
252
+
253
+ expect(result).toStrictEqual(testCase.expected);
254
+ },
255
+ );
256
+
257
+ test.each([undefined, null, "metadata", 1, true, [], new Date()])(
258
+ "rejects non-record top-level input: %s",
259
+ (value) => {
260
+ const result = parseInspectorMetadataV1(value);
261
+
262
+ expect(result).toBeUndefined();
263
+ },
264
+ );
265
+
266
+ test("rejects a Date instance with an own schema version", () => {
267
+ const value = Object.assign(new Date(), { schemaVersion: 1 });
268
+
269
+ const result = parseInspectorMetadataV1(value);
270
+
271
+ expect(result).toBeUndefined();
272
+ });
273
+
274
+ test("rejects a class instance with metadata fields", () => {
275
+ class MetadataEnvelope {
276
+ readonly schemaVersion = 1;
277
+ readonly identity = {
278
+ organizationName: "Acme",
279
+ projectName: "Support",
280
+ };
281
+ }
282
+ const value = new MetadataEnvelope();
283
+
284
+ const result = parseInspectorMetadataV1(value);
285
+
286
+ expect(result).toBeUndefined();
287
+ });
288
+
289
+ test("rejects a top-level object with an inherited schema version", () => {
290
+ const value = Object.create({
291
+ schemaVersion: 1,
292
+ identity: {
293
+ organizationName: "Acme",
294
+ projectName: "Support",
295
+ },
296
+ });
297
+
298
+ const result = parseInspectorMetadataV1(value);
299
+
300
+ expect(result).toBeUndefined();
301
+ });
302
+
303
+ test("omits a module whose fields come from its prototype", () => {
304
+ const value = {
305
+ schemaVersion: 1,
306
+ identity: Object.create({
307
+ organizationName: "Acme",
308
+ projectName: "Support",
309
+ }),
310
+ plan: {
311
+ code: "developer",
312
+ label: "Developer",
313
+ },
314
+ };
315
+
316
+ const result = parseInspectorMetadataV1(value);
317
+
318
+ expect(result).toStrictEqual({
319
+ schemaVersion: 1,
320
+ plan: {
321
+ code: "developer",
322
+ label: "Developer",
323
+ },
324
+ });
325
+ });
326
+
327
+ test("accepts null-prototype metadata records", () => {
328
+ const identity = nullPrototypeRecord({
329
+ organizationName: "Acme",
330
+ projectName: "Support",
331
+ });
332
+ const value = nullPrototypeRecord({
333
+ schemaVersion: 1,
334
+ identity,
335
+ });
336
+
337
+ const result = parseInspectorMetadataV1(value);
338
+
339
+ expect(result).toStrictEqual({
340
+ schemaVersion: 1,
341
+ identity: {
342
+ organizationName: "Acme",
343
+ projectName: "Support",
344
+ },
345
+ });
346
+ });
347
+
348
+ test("rejects a proxy that throws while its prototype is inspected", () => {
349
+ const value = new Proxy(
350
+ {},
351
+ {
352
+ getPrototypeOf() {
353
+ throw new Error("prototype unavailable");
354
+ },
355
+ },
356
+ );
357
+
358
+ const parse = () => parseInspectorMetadataV1(value);
359
+
360
+ expect(parse).not.toThrow();
361
+ expect(parse()).toBeUndefined();
362
+ });
363
+
364
+ test.each([undefined, null, 0, 2, "1", true])(
365
+ "rejects an unknown or missing schema version: %s",
366
+ (schemaVersion) => {
367
+ const result = parseInspectorMetadataV1({ schemaVersion });
368
+
369
+ expect(result).toBeUndefined();
370
+ },
371
+ );
372
+
373
+ test.each([
374
+ "https://cloud.copilotkit.ai/manage",
375
+ "https://cloud.copilotkit.ai/manage/plan",
376
+ "http://localhost/manage",
377
+ "http://sub.localhost/manage",
378
+ "http://cpk.localhost:7066/manage",
379
+ "http://localhost:3000/manage",
380
+ "http://127.0.0.1:3000/manage",
381
+ "http://[::1]:3000/manage",
382
+ ])("accepts a safe action URL: %s", (url) => {
383
+ const value = {
384
+ schemaVersion: 1,
385
+ action: {
386
+ kind: "enable_intelligence",
387
+ url,
388
+ },
389
+ };
390
+
391
+ const result = parseInspectorMetadataV1(value);
392
+
393
+ expect(result?.action).toStrictEqual({
394
+ kind: "enable_intelligence",
395
+ url,
396
+ });
397
+ });
398
+
399
+ test.each([
400
+ "",
401
+ " ",
402
+ "/manage",
403
+ "mailto:billing@copilotkit.ai",
404
+ "ftp://cloud.copilotkit.ai/manage",
405
+ "http://cloud.copilotkit.ai/manage",
406
+ "http://localhost.example.com/manage",
407
+ "http://127.0.0.2/manage",
408
+ "http://[::2]/manage",
409
+ "http://0.0.0.0/manage",
410
+ "https://@cloud.copilotkit.ai/manage",
411
+ "https://user@cloud.copilotkit.ai/manage",
412
+ "https://user:password@cloud.copilotkit.ai/manage",
413
+ "https://cloud.copilotkit.ai/manage?source=inspector",
414
+ "https://cloud.copilotkit.ai/manage?",
415
+ "https://cloud.copilotkit.ai/manage#billing",
416
+ "https://cloud.copilotkit.ai/manage#",
417
+ ])("rejects an unsafe action URL: %s", (url) => {
418
+ const value = {
419
+ schemaVersion: 1,
420
+ plan: {
421
+ code: "developer",
422
+ label: "Developer",
423
+ },
424
+ action: {
425
+ kind: "renew",
426
+ url,
427
+ },
428
+ };
429
+
430
+ const result = parseInspectorMetadataV1(value);
431
+
432
+ expect(result).toStrictEqual({
433
+ schemaVersion: 1,
434
+ plan: {
435
+ code: "developer",
436
+ label: "Developer",
437
+ },
438
+ });
439
+ });
440
+
441
+ test.each([
442
+ { kind: "finite", value: 100 },
443
+ { kind: "unlimited" },
444
+ { kind: "unknown" },
445
+ ])("parses the $kind usage limit", (limit) => {
446
+ const value = {
447
+ schemaVersion: 1,
448
+ usage: validUsage(limit),
449
+ };
450
+
451
+ const result = parseInspectorMetadataV1(value);
452
+
453
+ expect(result?.usage?.limit).toStrictEqual(limit);
454
+ });
455
+
456
+ test.each([
457
+ {
458
+ name: "finite absent",
459
+ limit: { kind: "finite", value: 200 },
460
+ expiringSoonCount: undefined,
461
+ },
462
+ {
463
+ name: "finite zero",
464
+ limit: { kind: "finite", value: 200 },
465
+ expiringSoonCount: 0,
466
+ },
467
+ {
468
+ name: "finite positive",
469
+ limit: { kind: "finite", value: 200 },
470
+ expiringSoonCount: 37,
471
+ },
472
+ {
473
+ name: "unlimited absent",
474
+ limit: { kind: "unlimited" },
475
+ expiringSoonCount: undefined,
476
+ },
477
+ {
478
+ name: "unlimited zero",
479
+ limit: { kind: "unlimited" },
480
+ expiringSoonCount: 0,
481
+ },
482
+ {
483
+ name: "unlimited positive",
484
+ limit: { kind: "unlimited" },
485
+ expiringSoonCount: 37,
486
+ },
487
+ {
488
+ name: "unknown absent",
489
+ limit: { kind: "unknown" },
490
+ expiringSoonCount: undefined,
491
+ },
492
+ {
493
+ name: "unknown zero",
494
+ limit: { kind: "unknown" },
495
+ expiringSoonCount: 0,
496
+ },
497
+ {
498
+ name: "unknown positive",
499
+ limit: { kind: "unknown" },
500
+ expiringSoonCount: 37,
501
+ },
502
+ ])("parses $name expiring-soon usage", ({ limit, expiringSoonCount }) => {
503
+ const expiry = expiringSoonCount === undefined ? {} : { expiringSoonCount };
504
+ const value = {
505
+ schemaVersion: 1,
506
+ usage: { used: 148, limit, ...expiry },
507
+ };
508
+
509
+ const result = parseInspectorMetadataV1(value);
510
+
511
+ expect(result).toStrictEqual({
512
+ schemaVersion: 1,
513
+ usage: { used: 148, limit, ...expiry },
514
+ });
515
+ expect(
516
+ Object.prototype.hasOwnProperty.call(
517
+ result?.usage ?? {},
518
+ "expiringSoonCount",
519
+ ),
520
+ ).toBe(expiringSoonCount !== undefined);
521
+ });
522
+
523
+ test("parses the maximum safe expiring-soon count", () => {
524
+ const value = {
525
+ schemaVersion: 1,
526
+ usage: {
527
+ used: 148,
528
+ limit: { kind: "finite", value: 200 },
529
+ expiringSoonCount: Number.MAX_SAFE_INTEGER,
530
+ },
531
+ };
532
+
533
+ const result = parseInspectorMetadataV1(value);
534
+
535
+ expect(result?.usage).toStrictEqual({
536
+ used: 148,
537
+ limit: { kind: "finite", value: 200 },
538
+ expiringSoonCount: Number.MAX_SAFE_INTEGER,
539
+ });
540
+ });
541
+
542
+ test.each([
543
+ { name: "negative", expiringSoonCount: -1 },
544
+ { name: "fractional", expiringSoonCount: 1.5 },
545
+ {
546
+ name: "unsafe",
547
+ expiringSoonCount: Number.MAX_SAFE_INTEGER + 1,
548
+ },
549
+ { name: "string", expiringSoonCount: "37" },
550
+ { name: "NaN", expiringSoonCount: Number.NaN },
551
+ { name: "infinite", expiringSoonCount: Number.POSITIVE_INFINITY },
552
+ ])(
553
+ "drops a $name expiring-soon leaf without dropping usage",
554
+ ({ expiringSoonCount }) => {
555
+ const value = {
556
+ schemaVersion: 1,
557
+ usage: {
558
+ used: 148,
559
+ limit: { kind: "finite", value: 200 },
560
+ expiringSoonCount,
561
+ },
562
+ plan: { code: "free", label: "Free" },
563
+ };
564
+
565
+ const result = parseInspectorMetadataV1(value);
566
+
567
+ expect(result).toStrictEqual({
568
+ schemaVersion: 1,
569
+ usage: {
570
+ used: 148,
571
+ limit: { kind: "finite", value: 200 },
572
+ },
573
+ plan: { code: "free", label: "Free" },
574
+ });
575
+ },
576
+ );
577
+
578
+ test("ignores an inherited expiring-soon count", () => {
579
+ const prototype = { expiringSoonCount: 37 };
580
+ const target = Object.assign(
581
+ Object.create(prototype),
582
+ validUsage({ kind: "finite", value: 200 }),
583
+ );
584
+ const usage = new Proxy(target, {
585
+ getPrototypeOf() {
586
+ return Object.prototype;
587
+ },
588
+ });
589
+ const value = { schemaVersion: 1, usage };
590
+
591
+ const result = parseInspectorMetadataV1(value);
592
+
593
+ expect(result?.usage).toStrictEqual(
594
+ validUsage({ kind: "finite", value: 200 }),
595
+ );
596
+ });
597
+
598
+ test("does not invoke an expiring-soon getter", () => {
599
+ const readExpiringSoonCount = vi.fn(() => 37);
600
+ const usage = validUsage({ kind: "finite", value: 200 });
601
+ Object.defineProperty(usage, "expiringSoonCount", {
602
+ enumerable: true,
603
+ get: readExpiringSoonCount,
604
+ });
605
+ const value = { schemaVersion: 1, usage };
606
+
607
+ const result = parseInspectorMetadataV1(value);
608
+
609
+ expect(result?.usage).toStrictEqual(
610
+ validUsage({ kind: "finite", value: 200 }),
611
+ );
612
+ expect(readExpiringSoonCount).not.toHaveBeenCalled();
613
+ });
614
+
615
+ test("keeps usage when the expiring-soon descriptor cannot be read", () => {
616
+ const usage = new Proxy(validUsage({ kind: "finite", value: 200 }), {
617
+ getOwnPropertyDescriptor(target, property) {
618
+ if (property === "expiringSoonCount") {
619
+ throw new Error("descriptor unavailable");
620
+ }
621
+
622
+ return Reflect.getOwnPropertyDescriptor(target, property);
623
+ },
624
+ });
625
+ const value = { schemaVersion: 1, usage };
626
+
627
+ const result = parseInspectorMetadataV1(value);
628
+
629
+ expect(result?.usage).toStrictEqual(
630
+ validUsage({ kind: "finite", value: 200 }),
631
+ );
632
+ });
633
+
634
+ test("returns validated usage when expiry descriptor work mutates input", () => {
635
+ const usage = new Proxy(validUsage({ kind: "finite", value: 200 }), {
636
+ getOwnPropertyDescriptor(target, property) {
637
+ if (property === "expiringSoonCount") {
638
+ target.used = -1;
639
+ throw new Error("descriptor unavailable");
640
+ }
641
+
642
+ return Reflect.getOwnPropertyDescriptor(target, property);
643
+ },
644
+ });
645
+ const value = { schemaVersion: 1, usage };
646
+
647
+ const result = parseInspectorMetadataV1(value);
648
+
649
+ expect(result?.usage).toStrictEqual(
650
+ validUsage({ kind: "finite", value: 200 }),
651
+ );
652
+ });
653
+
654
+ test.each([
655
+ -1,
656
+ 0.5,
657
+ Number.NaN,
658
+ Number.POSITIVE_INFINITY,
659
+ Number.MAX_SAFE_INTEGER + 1,
660
+ "12",
661
+ null,
662
+ ])("omits usage when used is not a finite nonnegative integer: %s", (used) => {
663
+ const value = metadataWithUsage({
664
+ ...validUsage(),
665
+ used,
666
+ });
667
+
668
+ const result = parseInspectorMetadataV1(value);
669
+
670
+ expect(result).toStrictEqual({
671
+ schemaVersion: 1,
672
+ identity: {
673
+ organizationName: "Acme",
674
+ projectName: "Support",
675
+ },
676
+ });
677
+ });
678
+
679
+ test.each([
680
+ 0,
681
+ -1,
682
+ 1.5,
683
+ Number.NaN,
684
+ Number.POSITIVE_INFINITY,
685
+ Number.MAX_SAFE_INTEGER + 1,
686
+ "100",
687
+ null,
688
+ ])("omits usage when a finite limit value is invalid: %s", (limitValue) => {
689
+ const value = metadataWithUsage(
690
+ validUsage({
691
+ kind: "finite",
692
+ value: limitValue,
693
+ }),
694
+ );
695
+
696
+ const result = parseInspectorMetadataV1(value);
697
+
698
+ expect(result).toStrictEqual({
699
+ schemaVersion: 1,
700
+ identity: {
701
+ organizationName: "Acme",
702
+ projectName: "Support",
703
+ },
704
+ });
705
+ });
706
+
707
+ test.each([
708
+ { kind: "finite" },
709
+ { kind: "unlimited", value: 100 },
710
+ { kind: "unknown", reason: "hidden" },
711
+ { kind: "metered" },
712
+ ])("normalizes or rejects the usage limit shape: $kind", (limit) => {
713
+ const value = {
714
+ schemaVersion: 1,
715
+ usage: validUsage(limit),
716
+ };
717
+
718
+ const result = parseInspectorMetadataV1(value);
719
+
720
+ if (limit.kind === "finite" || limit.kind === "metered") {
721
+ expect(result).toStrictEqual({ schemaVersion: 1 });
722
+ return;
723
+ }
724
+
725
+ expect(result?.usage?.limit).toStrictEqual({ kind: limit.kind });
726
+ });
727
+
728
+ test.each(["", " ", "manage-plan", null, 1])(
729
+ "omits an action with an unsupported kind: %s",
730
+ (kind) => {
731
+ const value = {
732
+ schemaVersion: 1,
733
+ action: {
734
+ kind,
735
+ url: "https://cloud.copilotkit.ai/manage",
736
+ },
737
+ };
738
+
739
+ const result = parseInspectorMetadataV1(value);
740
+
741
+ expect(result).toStrictEqual({ schemaVersion: 1 });
742
+ },
743
+ );