@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,423 @@
1
+ import { describe, expect, it } from "vitest";
2
+ import {
3
+ parseInspectorLearningRequestV1,
4
+ parseInspectorLearningSnapshotV1,
5
+ parseInspectorLearningUrl,
6
+ } from "./inspector-learning";
7
+
8
+ const emptySnapshot = () => ({
9
+ schemaVersion: 1,
10
+ projectKey: "project-safe-key",
11
+ snapshotVersion: "snapshot-1",
12
+ webAppOrigin: "https://app.copilotkit.ai",
13
+ configuration: { state: "not_configured" },
14
+ pendingThreadCount: 0,
15
+ run: { hasActiveRun: false, hasEverSucceeded: false, latest: null },
16
+ pendingCandidateCount: 0,
17
+ skillsPage: {
18
+ page: 1,
19
+ pageSize: 3,
20
+ total: 0,
21
+ totalPages: 0,
22
+ items: [],
23
+ },
24
+ insightsPage: {
25
+ page: 1,
26
+ pageSize: 4,
27
+ total: 0,
28
+ totalPages: 0,
29
+ items: [],
30
+ },
31
+ links: {
32
+ learning: "https://app.copilotkit.ai/learning",
33
+ candidates: null,
34
+ runs: null,
35
+ },
36
+ });
37
+
38
+ /** One available Trajectory citation, with fields overridden per case. */
39
+ const trajectoryEntry = (overrides: Record<string, unknown>) => ({
40
+ status: "available",
41
+ trajectoryId: "trajectory-1",
42
+ eventCount: 1,
43
+ url: "https://app.copilotkit.ai/o/acme/support/trajectories/trajectory-1",
44
+ ...overrides,
45
+ });
46
+
47
+ /** Builds a configured snapshot whose Insight and Skill source cite Trajectories. */
48
+ const snapshotWithTrajectoryEvidence = (trajectoryEvidence: unknown[]) => {
49
+ const insight = {
50
+ id: "insight-1",
51
+ statement: "Users switch the theme first.",
52
+ impact: "Default to dark mode.",
53
+ totalThreadCount: 0,
54
+ evidenceTruncated: false,
55
+ evidence: [],
56
+ totalTrajectoryCount: trajectoryEvidence.length,
57
+ trajectoryEvidence,
58
+ };
59
+ return {
60
+ ...emptySnapshot(),
61
+ configuration: {
62
+ state: "configured",
63
+ container: { id: "support", name: "Support" },
64
+ },
65
+ skillsPage: {
66
+ page: 1,
67
+ pageSize: 3,
68
+ total: 1,
69
+ totalPages: 1,
70
+ items: [
71
+ {
72
+ id: "skill-1",
73
+ name: "dark-mode",
74
+ description: "Offer dark mode.",
75
+ revision: 1,
76
+ skillMd: "# Dark mode",
77
+ sourceInsight: { ...insight, id: "source-1" },
78
+ },
79
+ ],
80
+ },
81
+ insightsPage: {
82
+ page: 1,
83
+ pageSize: 4,
84
+ total: 1,
85
+ totalPages: 1,
86
+ items: [insight],
87
+ },
88
+ };
89
+ };
90
+
91
+ describe("Inspector Learning wire validation", () => {
92
+ it("accepts and copies a bounded V1 snapshot", () => {
93
+ const source = emptySnapshot();
94
+ const parsed = parseInspectorLearningSnapshotV1(source);
95
+
96
+ expect(parsed).toEqual(source);
97
+ expect(parsed).not.toBe(source);
98
+ });
99
+
100
+ it("copies only the supported fields from the latest Learning run", () => {
101
+ const source = {
102
+ ...emptySnapshot(),
103
+ run: {
104
+ hasActiveRun: false,
105
+ hasEverSucceeded: true,
106
+ latest: {
107
+ status: "succeeded",
108
+ completedAt: "2026-09-04T12:00:00.000Z",
109
+ internalPayload: "must-not-cross-the-boundary",
110
+ },
111
+ },
112
+ };
113
+
114
+ expect(parseInspectorLearningSnapshotV1(source)?.run.latest).toEqual({
115
+ status: "succeeded",
116
+ completedAt: "2026-09-04T12:00:00.000Z",
117
+ });
118
+ });
119
+
120
+ it("rejects unsafe links and oversized evidence", () => {
121
+ expect(
122
+ parseInspectorLearningUrl(
123
+ "javascript:alert(1)",
124
+ "https://app.copilotkit.ai",
125
+ ),
126
+ ).toBeUndefined();
127
+ expect(
128
+ parseInspectorLearningUrl(
129
+ "http://example.com/learning",
130
+ "https://app.copilotkit.ai",
131
+ ),
132
+ ).toBeUndefined();
133
+ expect(
134
+ parseInspectorLearningUrl(
135
+ "https://attacker.example/learning",
136
+ "https://app.copilotkit.ai",
137
+ ),
138
+ ).toBeUndefined();
139
+ expect(
140
+ parseInspectorLearningUrl(
141
+ "https://app.copilotkit.ai.evil.test/learning",
142
+ "https://app.copilotkit.ai",
143
+ ),
144
+ ).toBeUndefined();
145
+ expect(
146
+ parseInspectorLearningUrl(
147
+ "http://localhost:3000/learning",
148
+ "http://localhost:3000",
149
+ ),
150
+ ).toBe("http://localhost:3000/learning");
151
+ expect(
152
+ parseInspectorLearningUrl(
153
+ "https://intelligence.customer.example/learning",
154
+ "https://intelligence.customer.example",
155
+ ),
156
+ ).toBe("https://intelligence.customer.example/learning");
157
+
158
+ const snapshot = emptySnapshot();
159
+ snapshot.insightsPage = {
160
+ page: 1,
161
+ pageSize: 4,
162
+ total: 1,
163
+ totalPages: 1,
164
+ items: [
165
+ {
166
+ id: "insight-1",
167
+ statement: "A bounded pattern",
168
+ impact: "A bounded impact",
169
+ totalThreadCount: 101,
170
+ evidenceTruncated: true,
171
+ evidence: Array.from({ length: 101 }, (_, index) => ({
172
+ status: "available",
173
+ threadId: `thread-${index}`,
174
+ threadName: null,
175
+ messageIds: [],
176
+ updatedAt: "2026-09-03T00:00:00.000Z",
177
+ })),
178
+ },
179
+ ],
180
+ };
181
+ expect(parseInspectorLearningSnapshotV1(snapshot)).toBeUndefined();
182
+ });
183
+
184
+ it("rejects required actions that are absent or point at another origin", () => {
185
+ const missingRuns = emptySnapshot();
186
+ missingRuns.pendingThreadCount = 1;
187
+ expect(parseInspectorLearningSnapshotV1(missingRuns)).toBeUndefined();
188
+
189
+ const missingCandidates = emptySnapshot();
190
+ missingCandidates.pendingCandidateCount = 1;
191
+ expect(parseInspectorLearningSnapshotV1(missingCandidates)).toBeUndefined();
192
+
193
+ const arbitraryOrigin = emptySnapshot();
194
+ arbitraryOrigin.links.learning = "https://attacker.example/learning";
195
+ expect(parseInspectorLearningSnapshotV1(arbitraryOrigin)).toBeUndefined();
196
+
197
+ const configuredOrigin = emptySnapshot();
198
+ configuredOrigin.webAppOrigin = "https://intelligence.customer.example";
199
+ configuredOrigin.links.learning =
200
+ "https://intelligence.customer.example/learning";
201
+ expect(parseInspectorLearningSnapshotV1(configuredOrigin)).toBeDefined();
202
+ });
203
+
204
+ it("accepts identifier-free unavailable evidence separately from unnamed evidence", () => {
205
+ const snapshot = emptySnapshot();
206
+ snapshot.insightsPage = {
207
+ page: 1,
208
+ pageSize: 4,
209
+ total: 1,
210
+ totalPages: 1,
211
+ items: [
212
+ {
213
+ id: "insight-1",
214
+ statement: "Verify the order.",
215
+ impact: "Avoids incorrect guidance.",
216
+ totalThreadCount: 2,
217
+ evidenceTruncated: false,
218
+ evidence: [
219
+ { status: "unavailable" },
220
+ {
221
+ status: "available",
222
+ threadId: "thread-2",
223
+ threadName: null,
224
+ messageIds: ["message-2"],
225
+ updatedAt: "2026-09-03T00:00:00.000Z",
226
+ },
227
+ ],
228
+ },
229
+ ],
230
+ };
231
+
232
+ expect(parseInspectorLearningSnapshotV1(snapshot)).toBeDefined();
233
+ snapshot.insightsPage.items[0].evidence[0] = {
234
+ status: "unavailable",
235
+ threadId: "former-id",
236
+ };
237
+ expect(parseInspectorLearningSnapshotV1(snapshot)).toBeUndefined();
238
+ });
239
+
240
+ it("rejects inconsistent server pagination", () => {
241
+ const snapshot = emptySnapshot();
242
+ snapshot.insightsPage = {
243
+ page: 2,
244
+ pageSize: 4,
245
+ total: 1,
246
+ totalPages: 1,
247
+ items: [],
248
+ };
249
+
250
+ expect(parseInspectorLearningSnapshotV1(snapshot)).toBeUndefined();
251
+ });
252
+
253
+ it("copies Trajectory evidence next to the Thread evidence", () => {
254
+ const snapshot = snapshotWithTrajectoryEvidence([
255
+ {
256
+ status: "available",
257
+ trajectoryId: "0190a3b4-0000-7000-8000-000000000001",
258
+ eventCount: 2,
259
+ url: "https://app.copilotkit.ai/o/acme/support/trajectories/0190a3b4-0000-7000-8000-000000000001?event=901",
260
+ },
261
+ { status: "unavailable" },
262
+ ]);
263
+
264
+ const parsed = parseInspectorLearningSnapshotV1(snapshot);
265
+
266
+ expect(parsed?.insightsPage.items[0]).toEqual(
267
+ snapshot.insightsPage.items[0],
268
+ );
269
+ expect(
270
+ parseInspectorLearningSnapshotV1(
271
+ snapshotWithTrajectoryEvidence([
272
+ {
273
+ status: "available",
274
+ trajectoryId: "trajectory-1",
275
+ eventCount: 1,
276
+ url: "https://app.copilotkit.ai/o/acme/support/trajectories/trajectory-1",
277
+ addedLater: "ignored",
278
+ },
279
+ ]),
280
+ )?.insightsPage.items[0]?.trajectoryEvidence,
281
+ ).toEqual([
282
+ {
283
+ status: "available",
284
+ trajectoryId: "trajectory-1",
285
+ eventCount: 1,
286
+ url: "https://app.copilotkit.ai/o/acme/support/trajectories/trajectory-1",
287
+ },
288
+ ]);
289
+ expect(parsed?.skillsPage.items[0]?.sourceInsight).toEqual(
290
+ snapshot.skillsPage.items[0]?.sourceInsight,
291
+ );
292
+ });
293
+
294
+ it("accepts Insights from producers that omit Trajectory evidence", () => {
295
+ const snapshot = snapshotWithTrajectoryEvidence([]);
296
+ const [insight] = snapshot.insightsPage.items;
297
+ delete (insight as { totalTrajectoryCount?: number }).totalTrajectoryCount;
298
+ delete (insight as { trajectoryEvidence?: unknown }).trajectoryEvidence;
299
+
300
+ const parsed = parseInspectorLearningSnapshotV1(snapshot);
301
+
302
+ expect(parsed?.insightsPage.items[0]).toEqual(insight);
303
+ expect(parsed?.insightsPage.items[0]).not.toHaveProperty(
304
+ "trajectoryEvidence",
305
+ );
306
+ });
307
+
308
+ it("keeps either Trajectory field when the producer sends only one", () => {
309
+ const evidence = [trajectoryEntry({}), { status: "unavailable" }];
310
+ const countOnly = snapshotWithTrajectoryEvidence(evidence);
311
+ delete (countOnly.insightsPage.items[0] as { trajectoryEvidence?: unknown })
312
+ .trajectoryEvidence;
313
+ const evidenceOnly = snapshotWithTrajectoryEvidence(evidence);
314
+ delete (
315
+ evidenceOnly.insightsPage.items[0] as { totalTrajectoryCount?: number }
316
+ ).totalTrajectoryCount;
317
+
318
+ const parsedCountOnly = parseInspectorLearningSnapshotV1(countOnly);
319
+ const parsedEvidenceOnly = parseInspectorLearningSnapshotV1(evidenceOnly);
320
+
321
+ expect(parsedCountOnly?.insightsPage.items[0]).toEqual(
322
+ countOnly.insightsPage.items[0],
323
+ );
324
+ expect(parsedEvidenceOnly?.insightsPage.items[0]).toEqual(
325
+ evidenceOnly.insightsPage.items[0],
326
+ );
327
+ });
328
+
329
+ it("rejects Trajectory evidence with foreign links or unknown fields", () => {
330
+ for (const invalid of [
331
+ trajectoryEntry({
332
+ url: "https://attacker.example/o/acme/support/trajectories/t",
333
+ }),
334
+ trajectoryEntry({ url: "javascript:alert(1)" }),
335
+ trajectoryEntry({ eventCount: -1 }),
336
+ trajectoryEntry({ trajectoryId: "" }),
337
+ { status: "unavailable", trajectoryId: "former-id" },
338
+ { status: "pending" },
339
+ ]) {
340
+ expect(
341
+ parseInspectorLearningSnapshotV1(
342
+ snapshotWithTrajectoryEvidence([invalid]),
343
+ ),
344
+ ).toBeUndefined();
345
+ }
346
+ const tooMany = snapshotWithTrajectoryEvidence(
347
+ Array.from({ length: 101 }, () => ({ status: "unavailable" })),
348
+ );
349
+ expect(parseInspectorLearningSnapshotV1(tooMany)).toBeUndefined();
350
+ });
351
+
352
+ it("accepts only the browser-owned scope and pagination fields", () => {
353
+ expect(
354
+ parseInspectorLearningRequestV1({
355
+ agentId: "support",
356
+ skillsPage: 2,
357
+ insightsPage: 3,
358
+ }),
359
+ ).toEqual({ agentId: "support", skillsPage: 2, insightsPage: 3 });
360
+ expect(
361
+ parseInspectorLearningRequestV1({ runtimeContainerId: "attacker-scope" }),
362
+ ).toBeUndefined();
363
+ expect(parseInspectorLearningRequestV1({ skillsPage: 0 })).toBeUndefined();
364
+ });
365
+ });
366
+
367
+ it.each([
368
+ "http://localhost:7066",
369
+ "http://127.0.0.1:7066",
370
+ "http://[::1]:7066",
371
+ "http://cpk.localhost:7066",
372
+ "http://team.cpk.localhost:7066",
373
+ "https://dashboard.example.com",
374
+ ])("accepts Learning links on configured dashboard origin %s", (origin) => {
375
+ const url = `${origin}/o/acme/support/learning`;
376
+
377
+ expect(parseInspectorLearningUrl(url, origin)).toBe(url);
378
+ });
379
+
380
+ it.each([
381
+ "http://remote.example.com",
382
+ "http://cpk.localhost.example.com",
383
+ "http://-bad.localhost",
384
+ "http://bad_.localhost",
385
+ "http://bad..localhost",
386
+ "http://user:password@cpk.localhost",
387
+ "ftp://cpk.localhost",
388
+ "javascript:alert(1)",
389
+ ])("rejects unsafe dashboard origin %s", (origin) => {
390
+ expect(
391
+ parseInspectorLearningUrl(`${origin}/o/acme/support/learning`, origin),
392
+ ).toBeUndefined();
393
+ });
394
+
395
+ it.each([
396
+ "http://localhost:7066",
397
+ "http://cpk.localhost:7067",
398
+ "https://cpk.localhost:7066",
399
+ "https://other.example.com",
400
+ ])("rejects a Learning link to another origin %s", (origin) => {
401
+ expect(
402
+ parseInspectorLearningUrl(
403
+ `${origin}/o/acme/support/learning`,
404
+ "http://cpk.localhost:7066",
405
+ ),
406
+ ).toBeUndefined();
407
+ });
408
+
409
+ it.each([
410
+ ["learning", "/account"],
411
+ ["learning", "/o/acme/support/learning?redirect=elsewhere"],
412
+ ["candidates", "/o/acme/support/learning/quality/analysis-results"],
413
+ ["runs", "/o/acme/support/learning/quality/skills"],
414
+ ["runs", "/o/acme/support/learning/quality/analysis-results#fragment"],
415
+ ])("rejects invalid %s Learning path %s", (field, path) => {
416
+ const snapshot = emptySnapshot();
417
+ expect(
418
+ parseInspectorLearningSnapshotV1({
419
+ ...snapshot,
420
+ links: { ...snapshot.links, [field]: `${snapshot.webAppOrigin}${path}` },
421
+ }),
422
+ ).toBeUndefined();
423
+ });