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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (592) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +93 -12
  3. package/dist/_virtual/_rolldown/runtime.cjs +29 -0
  4. package/dist/a2ui-envelope.cjs +154 -0
  5. package/dist/a2ui-envelope.cjs.map +1 -0
  6. package/dist/a2ui-envelope.d.cts +101 -0
  7. package/dist/a2ui-envelope.d.cts.map +1 -0
  8. package/dist/a2ui-envelope.d.mts +101 -0
  9. package/dist/a2ui-envelope.d.mts.map +1 -0
  10. package/dist/a2ui-envelope.mjs +151 -0
  11. package/dist/a2ui-envelope.mjs.map +1 -0
  12. package/dist/a2ui-prompts.cjs +259 -0
  13. package/dist/a2ui-prompts.cjs.map +1 -0
  14. package/dist/a2ui-prompts.d.cts +79 -0
  15. package/dist/a2ui-prompts.d.cts.map +1 -0
  16. package/dist/a2ui-prompts.d.mts +79 -0
  17. package/dist/a2ui-prompts.d.mts.map +1 -0
  18. package/dist/a2ui-prompts.mjs +251 -0
  19. package/dist/a2ui-prompts.mjs.map +1 -0
  20. package/dist/attachments/content.cjs +17 -0
  21. package/dist/attachments/content.cjs.map +1 -0
  22. package/dist/attachments/content.d.cts +9 -0
  23. package/dist/attachments/content.d.cts.map +1 -0
  24. package/dist/attachments/content.d.mts +9 -0
  25. package/dist/attachments/content.d.mts.map +1 -0
  26. package/dist/attachments/content.mjs +16 -0
  27. package/dist/attachments/content.mjs.map +1 -0
  28. package/dist/attachments/types.d.cts +64 -0
  29. package/dist/attachments/types.d.cts.map +1 -0
  30. package/dist/attachments/types.d.mts +64 -0
  31. package/dist/attachments/types.d.mts.map +1 -0
  32. package/dist/attachments/utils.cjs +137 -0
  33. package/dist/attachments/utils.cjs.map +1 -0
  34. package/dist/attachments/utils.d.cts +44 -0
  35. package/dist/attachments/utils.d.cts.map +1 -0
  36. package/dist/attachments/utils.d.mts +44 -0
  37. package/dist/attachments/utils.d.mts.map +1 -0
  38. package/dist/attachments/utils.mjs +129 -0
  39. package/dist/attachments/utils.mjs.map +1 -0
  40. package/dist/constants/index.cjs +25 -0
  41. package/dist/constants/index.cjs.map +1 -0
  42. package/dist/constants/index.d.cts +17 -0
  43. package/dist/constants/index.d.cts.map +1 -0
  44. package/dist/constants/index.d.mts +17 -0
  45. package/dist/constants/index.d.mts.map +1 -0
  46. package/dist/constants/index.mjs +17 -12
  47. package/dist/constants/index.mjs.map +1 -1
  48. package/dist/debug-event-envelope.d.cts +13 -0
  49. package/dist/debug-event-envelope.d.cts.map +1 -0
  50. package/dist/debug-event-envelope.d.mts +13 -0
  51. package/dist/debug-event-envelope.d.mts.map +1 -0
  52. package/dist/debug.cjs +38 -0
  53. package/dist/debug.cjs.map +1 -0
  54. package/dist/debug.d.cts +29 -0
  55. package/dist/debug.d.cts.map +1 -0
  56. package/dist/debug.d.mts +29 -0
  57. package/dist/debug.d.mts.map +1 -0
  58. package/dist/debug.mjs +37 -0
  59. package/dist/debug.mjs.map +1 -0
  60. package/dist/event-transforms/index.cjs +15 -0
  61. package/dist/event-transforms/index.d.cts +4 -0
  62. package/dist/event-transforms/index.d.mts +4 -0
  63. package/dist/event-transforms/index.mjs +5 -0
  64. package/dist/event-transforms/open-generative-ui-middleware.cjs +286 -0
  65. package/dist/event-transforms/open-generative-ui-middleware.cjs.map +1 -0
  66. package/dist/event-transforms/open-generative-ui-middleware.d.cts +60 -0
  67. package/dist/event-transforms/open-generative-ui-middleware.d.cts.map +1 -0
  68. package/dist/event-transforms/open-generative-ui-middleware.d.mts +60 -0
  69. package/dist/event-transforms/open-generative-ui-middleware.d.mts.map +1 -0
  70. package/dist/event-transforms/open-generative-ui-middleware.mjs +283 -0
  71. package/dist/event-transforms/open-generative-ui-middleware.mjs.map +1 -0
  72. package/dist/event-transforms/recorded-events.cjs +59 -0
  73. package/dist/event-transforms/recorded-events.cjs.map +1 -0
  74. package/dist/event-transforms/recorded-events.d.cts +23 -0
  75. package/dist/event-transforms/recorded-events.d.cts.map +1 -0
  76. package/dist/event-transforms/recorded-events.d.mts +23 -0
  77. package/dist/event-transforms/recorded-events.d.mts.map +1 -0
  78. package/dist/event-transforms/recorded-events.mjs +58 -0
  79. package/dist/event-transforms/recorded-events.mjs.map +1 -0
  80. package/dist/finalize-events.cjs +186 -0
  81. package/dist/finalize-events.cjs.map +1 -0
  82. package/dist/finalize-events.d.cts +40 -0
  83. package/dist/finalize-events.d.cts.map +1 -0
  84. package/dist/finalize-events.d.mts +40 -0
  85. package/dist/finalize-events.d.mts.map +1 -0
  86. package/dist/finalize-events.mjs +184 -0
  87. package/dist/finalize-events.mjs.map +1 -0
  88. package/dist/generative-ui/basic-functions.cjs +177 -0
  89. package/dist/generative-ui/basic-functions.cjs.map +1 -0
  90. package/dist/generative-ui/basic-functions.d.cts +108 -0
  91. package/dist/generative-ui/basic-functions.d.cts.map +1 -0
  92. package/dist/generative-ui/basic-functions.d.mts +108 -0
  93. package/dist/generative-ui/basic-functions.d.mts.map +1 -0
  94. package/dist/generative-ui/basic-functions.mjs +167 -0
  95. package/dist/generative-ui/basic-functions.mjs.map +1 -0
  96. package/dist/generative-ui/child-refs.cjs +161 -0
  97. package/dist/generative-ui/child-refs.cjs.map +1 -0
  98. package/dist/generative-ui/child-refs.d.cts +68 -0
  99. package/dist/generative-ui/child-refs.d.cts.map +1 -0
  100. package/dist/generative-ui/child-refs.d.mts +68 -0
  101. package/dist/generative-ui/child-refs.d.mts.map +1 -0
  102. package/dist/generative-ui/child-refs.mjs +152 -0
  103. package/dist/generative-ui/child-refs.mjs.map +1 -0
  104. package/dist/generative-ui/is-record.cjs +10 -0
  105. package/dist/generative-ui/is-record.cjs.map +1 -0
  106. package/dist/generative-ui/is-record.mjs +9 -0
  107. package/dist/generative-ui/is-record.mjs.map +1 -0
  108. package/dist/generative-ui/prompt.cjs +91 -0
  109. package/dist/generative-ui/prompt.cjs.map +1 -0
  110. package/dist/generative-ui/prompt.d.cts +13 -0
  111. package/dist/generative-ui/prompt.d.cts.map +1 -0
  112. package/dist/generative-ui/prompt.d.mts +13 -0
  113. package/dist/generative-ui/prompt.d.mts.map +1 -0
  114. package/dist/generative-ui/prompt.mjs +90 -0
  115. package/dist/generative-ui/prompt.mjs.map +1 -0
  116. package/dist/generative-ui/render-ui-args.cjs +160 -0
  117. package/dist/generative-ui/render-ui-args.cjs.map +1 -0
  118. package/dist/generative-ui/render-ui-args.d.cts +40 -0
  119. package/dist/generative-ui/render-ui-args.d.cts.map +1 -0
  120. package/dist/generative-ui/render-ui-args.d.mts +40 -0
  121. package/dist/generative-ui/render-ui-args.d.mts.map +1 -0
  122. package/dist/generative-ui/render-ui-args.mjs +159 -0
  123. package/dist/generative-ui/render-ui-args.mjs.map +1 -0
  124. package/dist/generative-ui/types.cjs +101 -0
  125. package/dist/generative-ui/types.cjs.map +1 -0
  126. package/dist/generative-ui/types.d.cts +270 -0
  127. package/dist/generative-ui/types.d.cts.map +1 -0
  128. package/dist/generative-ui/types.d.mts +270 -0
  129. package/dist/generative-ui/types.d.mts.map +1 -0
  130. package/dist/generative-ui/types.mjs +86 -0
  131. package/dist/generative-ui/types.mjs.map +1 -0
  132. package/dist/generative-ui/validate-operation.cjs +405 -0
  133. package/dist/generative-ui/validate-operation.cjs.map +1 -0
  134. package/dist/generative-ui/validate-operation.d.cts +86 -0
  135. package/dist/generative-ui/validate-operation.d.cts.map +1 -0
  136. package/dist/generative-ui/validate-operation.d.mts +86 -0
  137. package/dist/generative-ui/validate-operation.d.mts.map +1 -0
  138. package/dist/generative-ui/validate-operation.mjs +399 -0
  139. package/dist/generative-ui/validate-operation.mjs.map +1 -0
  140. package/dist/index.cjs +233 -0
  141. package/dist/index.cjs.map +1 -0
  142. package/dist/index.d.cts +80 -0
  143. package/dist/index.d.cts.map +1 -0
  144. package/dist/index.d.mts +80 -0
  145. package/dist/index.d.mts.map +1 -0
  146. package/dist/index.mjs +78 -123
  147. package/dist/index.mjs.map +1 -1
  148. package/dist/index.umd.js +3979 -0
  149. package/dist/index.umd.js.map +1 -0
  150. package/dist/intelligence-routing-fields.cjs +35 -0
  151. package/dist/intelligence-routing-fields.cjs.map +1 -0
  152. package/dist/intelligence-routing-fields.d.cts +18 -0
  153. package/dist/intelligence-routing-fields.d.cts.map +1 -0
  154. package/dist/intelligence-routing-fields.d.mts +18 -0
  155. package/dist/intelligence-routing-fields.d.mts.map +1 -0
  156. package/dist/intelligence-routing-fields.mjs +34 -0
  157. package/dist/intelligence-routing-fields.mjs.map +1 -0
  158. package/dist/logger.cjs +7 -0
  159. package/dist/logger.cjs.map +1 -0
  160. package/dist/logger.d.cts +5 -0
  161. package/dist/logger.d.cts.map +1 -0
  162. package/dist/logger.d.mts +5 -0
  163. package/dist/logger.d.mts.map +1 -0
  164. package/dist/logger.mjs +6 -0
  165. package/dist/logger.mjs.map +1 -0
  166. package/dist/open-generative-ui-prompts.cjs +8 -0
  167. package/dist/open-generative-ui-prompts.cjs.map +1 -0
  168. package/dist/open-generative-ui-prompts.d.cts +6 -0
  169. package/dist/open-generative-ui-prompts.d.cts.map +1 -0
  170. package/dist/open-generative-ui-prompts.d.mts +6 -0
  171. package/dist/open-generative-ui-prompts.d.mts.map +1 -0
  172. package/dist/open-generative-ui-prompts.mjs +7 -0
  173. package/dist/open-generative-ui-prompts.mjs.map +1 -0
  174. package/dist/package.cjs +12 -0
  175. package/dist/package.cjs.map +1 -0
  176. package/dist/package.mjs +6 -0
  177. package/dist/package.mjs.map +1 -0
  178. package/dist/standard-schema.cjs +31 -0
  179. package/dist/standard-schema.cjs.map +1 -0
  180. package/dist/standard-schema.d.cts +33 -0
  181. package/dist/standard-schema.d.cts.map +1 -0
  182. package/dist/standard-schema.d.mts +33 -0
  183. package/dist/standard-schema.d.mts.map +1 -0
  184. package/dist/standard-schema.mjs +30 -0
  185. package/dist/standard-schema.mjs.map +1 -0
  186. package/dist/telemetry/events.d.cts +72 -0
  187. package/dist/telemetry/events.d.cts.map +1 -0
  188. package/dist/telemetry/events.d.mts +72 -0
  189. package/dist/telemetry/events.d.mts.map +1 -0
  190. package/dist/telemetry/index.cjs +18 -0
  191. package/dist/telemetry/index.d.cts +5 -0
  192. package/dist/telemetry/index.d.mts +5 -0
  193. package/dist/telemetry/index.mjs +6 -12
  194. package/dist/telemetry/lambda-client.cjs +91 -0
  195. package/dist/telemetry/lambda-client.cjs.map +1 -0
  196. package/dist/telemetry/lambda-client.d.cts +31 -0
  197. package/dist/telemetry/lambda-client.d.cts.map +1 -0
  198. package/dist/telemetry/lambda-client.d.mts +31 -0
  199. package/dist/telemetry/lambda-client.d.mts.map +1 -0
  200. package/dist/telemetry/lambda-client.mjs +87 -0
  201. package/dist/telemetry/lambda-client.mjs.map +1 -0
  202. package/dist/telemetry/model-host.cjs +104 -0
  203. package/dist/telemetry/model-host.cjs.map +1 -0
  204. package/dist/telemetry/model-host.d.cts +26 -0
  205. package/dist/telemetry/model-host.d.cts.map +1 -0
  206. package/dist/telemetry/model-host.d.mts +26 -0
  207. package/dist/telemetry/model-host.d.mts.map +1 -0
  208. package/dist/telemetry/model-host.mjs +102 -0
  209. package/dist/telemetry/model-host.mjs.map +1 -0
  210. package/dist/telemetry/sampling.cjs +50 -0
  211. package/dist/telemetry/sampling.cjs.map +1 -0
  212. package/dist/telemetry/sampling.d.cts +57 -0
  213. package/dist/telemetry/sampling.d.cts.map +1 -0
  214. package/dist/telemetry/sampling.d.mts +57 -0
  215. package/dist/telemetry/sampling.d.mts.map +1 -0
  216. package/dist/telemetry/sampling.mjs +44 -0
  217. package/dist/telemetry/sampling.mjs.map +1 -0
  218. package/dist/telemetry/telemetry-client.cjs +165 -0
  219. package/dist/telemetry/telemetry-client.cjs.map +1 -0
  220. package/dist/telemetry/telemetry-client.d.cts +87 -0
  221. package/dist/telemetry/telemetry-client.d.cts.map +1 -0
  222. package/dist/telemetry/telemetry-client.d.mts +87 -0
  223. package/dist/telemetry/telemetry-client.d.mts.map +1 -0
  224. package/dist/telemetry/telemetry-client.mjs +162 -9
  225. package/dist/telemetry/telemetry-client.mjs.map +1 -1
  226. package/dist/telemetry/telemetry-disabled.cjs +20 -0
  227. package/dist/telemetry/telemetry-disabled.cjs.map +1 -0
  228. package/dist/telemetry/telemetry-disabled.d.cts +16 -0
  229. package/dist/telemetry/telemetry-disabled.d.cts.map +1 -0
  230. package/dist/telemetry/telemetry-disabled.d.mts +16 -0
  231. package/dist/telemetry/telemetry-disabled.d.mts.map +1 -0
  232. package/dist/telemetry/telemetry-disabled.mjs +19 -0
  233. package/dist/telemetry/telemetry-disabled.mjs.map +1 -0
  234. package/dist/telemetry/utils.cjs +14 -0
  235. package/dist/telemetry/utils.cjs.map +1 -0
  236. package/dist/telemetry/utils.mjs +12 -8
  237. package/dist/telemetry/utils.mjs.map +1 -1
  238. package/dist/transcription-errors.cjs +84 -0
  239. package/dist/transcription-errors.cjs.map +1 -0
  240. package/dist/transcription-errors.d.cts +52 -0
  241. package/dist/transcription-errors.d.cts.map +1 -0
  242. package/dist/transcription-errors.d.mts +52 -0
  243. package/dist/transcription-errors.d.mts.map +1 -0
  244. package/dist/transcription-errors.mjs +82 -0
  245. package/dist/transcription-errors.mjs.map +1 -0
  246. package/dist/types/{action.d.ts → action.d.cts} +32 -32
  247. package/dist/types/action.d.cts.map +1 -0
  248. package/dist/types/action.d.mts +59 -0
  249. package/dist/types/action.d.mts.map +1 -0
  250. package/dist/types/copilot-cloud-config.d.cts +15 -0
  251. package/dist/types/copilot-cloud-config.d.cts.map +1 -0
  252. package/dist/types/copilot-cloud-config.d.mts +15 -0
  253. package/dist/types/copilot-cloud-config.d.mts.map +1 -0
  254. package/dist/types/error.d.cts +57 -0
  255. package/dist/types/error.d.cts.map +1 -0
  256. package/dist/types/error.d.mts +57 -0
  257. package/dist/types/error.d.mts.map +1 -0
  258. package/dist/types/message.d.cts +42 -0
  259. package/dist/types/message.d.cts.map +1 -0
  260. package/dist/types/message.d.mts +42 -0
  261. package/dist/types/message.d.mts.map +1 -0
  262. package/dist/types/openai-assistant.d.cts +55 -0
  263. package/dist/types/openai-assistant.d.cts.map +1 -0
  264. package/dist/types/openai-assistant.d.mts +55 -0
  265. package/dist/types/openai-assistant.d.mts.map +1 -0
  266. package/dist/types/utility.d.cts +6 -0
  267. package/dist/types/utility.d.cts.map +1 -0
  268. package/dist/types/utility.d.mts +6 -0
  269. package/dist/types/utility.d.mts.map +1 -0
  270. package/dist/utils/clipboard.cjs +28 -0
  271. package/dist/utils/clipboard.cjs.map +1 -0
  272. package/dist/utils/clipboard.d.cts +14 -0
  273. package/dist/utils/clipboard.d.cts.map +1 -0
  274. package/dist/utils/clipboard.d.mts +14 -0
  275. package/dist/utils/clipboard.d.mts.map +1 -0
  276. package/dist/utils/clipboard.mjs +27 -0
  277. package/dist/utils/clipboard.mjs.map +1 -0
  278. package/dist/utils/conditions.cjs +32 -0
  279. package/dist/utils/conditions.cjs.map +1 -0
  280. package/dist/utils/{conditions.d.ts → conditions.d.cts} +16 -11
  281. package/dist/utils/conditions.d.cts.map +1 -0
  282. package/dist/utils/conditions.d.mts +31 -0
  283. package/dist/utils/conditions.d.mts.map +1 -0
  284. package/dist/utils/conditions.mjs +30 -6
  285. package/dist/utils/conditions.mjs.map +1 -1
  286. package/dist/utils/console-styling.cjs +91 -0
  287. package/dist/utils/console-styling.cjs.map +1 -0
  288. package/dist/utils/console-styling.d.cts +65 -0
  289. package/dist/utils/console-styling.d.cts.map +1 -0
  290. package/dist/utils/console-styling.d.mts +65 -0
  291. package/dist/utils/console-styling.d.mts.map +1 -0
  292. package/dist/utils/console-styling.mjs +83 -15
  293. package/dist/utils/console-styling.mjs.map +1 -1
  294. package/dist/utils/dashboard-url.cjs +19 -0
  295. package/dist/utils/dashboard-url.cjs.map +1 -0
  296. package/dist/utils/dashboard-url.mjs +18 -0
  297. package/dist/utils/dashboard-url.mjs.map +1 -0
  298. package/dist/utils/errors.cjs +439 -0
  299. package/dist/utils/errors.cjs.map +1 -0
  300. package/dist/utils/{errors.d.ts → errors.d.cts} +188 -156
  301. package/dist/utils/errors.d.cts.map +1 -0
  302. package/dist/utils/errors.d.mts +312 -0
  303. package/dist/utils/errors.d.mts.map +1 -0
  304. package/dist/utils/errors.mjs +416 -63
  305. package/dist/utils/errors.mjs.map +1 -1
  306. package/dist/utils/index.cjs +105 -0
  307. package/dist/utils/index.cjs.map +1 -0
  308. package/dist/utils/index.d.cts +58 -0
  309. package/dist/utils/index.d.cts.map +1 -0
  310. package/dist/utils/index.d.mts +58 -0
  311. package/dist/utils/index.d.mts.map +1 -0
  312. package/dist/utils/index.mjs +97 -107
  313. package/dist/utils/index.mjs.map +1 -1
  314. package/dist/utils/inspector-learning.cjs +217 -0
  315. package/dist/utils/inspector-learning.cjs.map +1 -0
  316. package/dist/utils/inspector-learning.d.cts +104 -0
  317. package/dist/utils/inspector-learning.d.cts.map +1 -0
  318. package/dist/utils/inspector-learning.d.mts +104 -0
  319. package/dist/utils/inspector-learning.d.mts.map +1 -0
  320. package/dist/utils/inspector-learning.mjs +215 -0
  321. package/dist/utils/inspector-learning.mjs.map +1 -0
  322. package/dist/utils/inspector-metadata.cjs +146 -0
  323. package/dist/utils/inspector-metadata.cjs.map +1 -0
  324. package/dist/utils/inspector-metadata.d.cts +55 -0
  325. package/dist/utils/inspector-metadata.d.cts.map +1 -0
  326. package/dist/utils/inspector-metadata.d.mts +55 -0
  327. package/dist/utils/inspector-metadata.d.mts.map +1 -0
  328. package/dist/utils/inspector-metadata.mjs +146 -0
  329. package/dist/utils/inspector-metadata.mjs.map +1 -0
  330. package/dist/utils/inspector-visibility.cjs +13 -0
  331. package/dist/utils/inspector-visibility.cjs.map +1 -0
  332. package/dist/utils/inspector-visibility.d.cts +18 -0
  333. package/dist/utils/inspector-visibility.d.cts.map +1 -0
  334. package/dist/utils/inspector-visibility.d.mts +18 -0
  335. package/dist/utils/inspector-visibility.d.mts.map +1 -0
  336. package/dist/utils/inspector-visibility.mjs +12 -0
  337. package/dist/utils/inspector-visibility.mjs.map +1 -0
  338. package/dist/utils/json-schema.cjs +215 -0
  339. package/dist/utils/json-schema.cjs.map +1 -0
  340. package/dist/utils/{json-schema.d.ts → json-schema.d.cts} +20 -18
  341. package/dist/utils/json-schema.d.cts.map +1 -0
  342. package/dist/utils/json-schema.d.mts +36 -0
  343. package/dist/utils/json-schema.d.mts.map +1 -0
  344. package/dist/utils/json-schema.mjs +210 -12
  345. package/dist/utils/json-schema.mjs.map +1 -1
  346. package/dist/utils/random-id.cjs +38 -0
  347. package/dist/utils/random-id.cjs.map +1 -0
  348. package/dist/utils/{random-id.d.ts → random-id.d.cts} +3 -1
  349. package/dist/utils/random-id.d.cts.map +1 -0
  350. package/dist/utils/random-id.d.mts +8 -0
  351. package/dist/utils/random-id.d.mts.map +1 -0
  352. package/dist/utils/random-id.mjs +33 -12
  353. package/dist/utils/random-id.mjs.map +1 -1
  354. package/dist/utils/requests.cjs +58 -0
  355. package/dist/utils/requests.cjs.map +1 -0
  356. package/dist/utils/{requests.d.ts → requests.d.cts} +3 -1
  357. package/dist/utils/requests.d.cts.map +1 -0
  358. package/dist/utils/requests.d.mts +12 -0
  359. package/dist/utils/requests.d.mts.map +1 -0
  360. package/dist/utils/requests.mjs +56 -6
  361. package/dist/utils/requests.mjs.map +1 -1
  362. package/dist/utils/row-render-keys.cjs +206 -0
  363. package/dist/utils/row-render-keys.cjs.map +1 -0
  364. package/dist/utils/row-render-keys.d.cts +65 -0
  365. package/dist/utils/row-render-keys.d.cts.map +1 -0
  366. package/dist/utils/row-render-keys.d.mts +65 -0
  367. package/dist/utils/row-render-keys.d.mts.map +1 -0
  368. package/dist/utils/row-render-keys.mjs +201 -0
  369. package/dist/utils/row-render-keys.mjs.map +1 -0
  370. package/dist/utils/types.cjs +9 -0
  371. package/dist/utils/types.cjs.map +1 -0
  372. package/dist/utils/types.d.cts +122 -0
  373. package/dist/utils/types.d.cts.map +1 -0
  374. package/dist/utils/types.d.mts +122 -0
  375. package/dist/utils/types.d.mts.map +1 -0
  376. package/dist/utils/types.mjs +6 -1
  377. package/dist/utils/types.mjs.map +1 -1
  378. package/package.json +74 -40
  379. package/scripts/verify-cjs-exports.cjs +16 -0
  380. package/src/__tests__/a2ui-envelope.test.ts +434 -0
  381. package/src/__tests__/a2ui-prompts.test.ts +362 -0
  382. package/src/__tests__/debug.test.ts +116 -0
  383. package/src/__tests__/license-context.test.ts +253 -0
  384. package/src/__tests__/root-entry-browser-safety.test.ts +91 -0
  385. package/src/__tests__/standard-schema-types.test.ts +144 -0
  386. package/src/__tests__/standard-schema.test.ts +359 -0
  387. package/src/__tests__/zod-regression.test.ts +319 -0
  388. package/src/a2ui-envelope.ts +309 -0
  389. package/src/a2ui-prompts.ts +322 -0
  390. package/src/attachments/__tests__/utils.test.ts +214 -0
  391. package/src/attachments/content.test.ts +48 -0
  392. package/src/attachments/content.ts +16 -0
  393. package/src/attachments/index.ts +21 -0
  394. package/src/attachments/types.ts +77 -0
  395. package/src/attachments/utils.ts +169 -0
  396. package/src/constants/index.ts +14 -1
  397. package/src/debug-event-envelope.ts +9 -0
  398. package/src/debug.ts +55 -0
  399. package/src/event-transforms/index.ts +5 -0
  400. package/src/event-transforms/open-generative-ui-middleware.ts +392 -0
  401. package/src/event-transforms/recorded-events.test.ts +166 -0
  402. package/src/event-transforms/recorded-events.ts +74 -0
  403. package/src/finalize-events.test.ts +284 -0
  404. package/src/finalize-events.ts +260 -0
  405. package/src/generative-ui/__tests__/render-ui-args.test.ts +175 -0
  406. package/src/generative-ui/__tests__/validate-operation.test.ts +977 -0
  407. package/src/generative-ui/basic-functions.ts +282 -0
  408. package/src/generative-ui/child-refs.ts +210 -0
  409. package/src/generative-ui/index.ts +6 -0
  410. package/src/generative-ui/is-record.ts +4 -0
  411. package/src/generative-ui/prompt.ts +174 -0
  412. package/src/generative-ui/render-ui-args.ts +199 -0
  413. package/src/generative-ui/types.ts +314 -0
  414. package/src/generative-ui/validate-operation.ts +723 -0
  415. package/src/index.ts +190 -1
  416. package/src/intelligence-routing-fields.test.ts +51 -0
  417. package/src/intelligence-routing-fields.ts +40 -0
  418. package/src/logger.ts +1 -0
  419. package/src/open-generative-ui-prompts.ts +20 -0
  420. package/src/standard-schema.ts +82 -0
  421. package/src/telemetry/events.ts +37 -10
  422. package/src/telemetry/index.ts +8 -0
  423. package/src/telemetry/lambda-client.test.ts +446 -0
  424. package/src/telemetry/lambda-client.ts +194 -0
  425. package/src/telemetry/model-host.test.ts +145 -0
  426. package/src/telemetry/model-host.ts +156 -0
  427. package/src/telemetry/sampling.test.ts +65 -0
  428. package/src/telemetry/sampling.ts +103 -0
  429. package/src/telemetry/telemetry-blank-license-identity.test.ts +128 -0
  430. package/src/telemetry/telemetry-client.test.ts +798 -0
  431. package/src/telemetry/telemetry-client.ts +223 -37
  432. package/src/telemetry/telemetry-disabled.ts +22 -0
  433. package/src/telemetry/utils.ts +0 -24
  434. package/src/transcription-errors.ts +99 -0
  435. package/src/types/__tests__/message.test.ts +62 -0
  436. package/src/types/action.ts +9 -5
  437. package/src/types/error.ts +11 -2
  438. package/src/types/message.ts +33 -5
  439. package/src/types/openai-assistant.ts +6 -2
  440. package/src/utils/__tests__/clipboard.test.ts +87 -0
  441. package/src/utils/__tests__/conditions.test.ts +161 -0
  442. package/src/utils/__tests__/json-schema.test.ts +812 -0
  443. package/src/utils/__tests__/row-render-keys.test.ts +388 -0
  444. package/src/utils/clipboard.ts +23 -0
  445. package/src/utils/conditions.ts +27 -9
  446. package/src/utils/console-styling.ts +10 -8
  447. package/src/utils/dashboard-url.ts +17 -0
  448. package/src/utils/errors.ts +55 -22
  449. package/src/utils/index.ts +70 -1
  450. package/src/utils/inspector-learning.test.ts +423 -0
  451. package/src/utils/inspector-learning.ts +523 -0
  452. package/src/utils/inspector-metadata.test.ts +743 -0
  453. package/src/utils/inspector-metadata.ts +263 -0
  454. package/src/utils/inspector-visibility.test.ts +43 -0
  455. package/src/utils/inspector-visibility.ts +17 -0
  456. package/src/utils/json-schema.ts +156 -12
  457. package/src/utils/random-id.ts +5 -2
  458. package/src/utils/requests.ts +3 -1
  459. package/src/utils/row-render-keys.ts +263 -0
  460. package/src/utils/types.ts +128 -1
  461. package/src/utils.test.ts +137 -0
  462. package/tsconfig.json +10 -2
  463. package/tsdown.config.ts +49 -0
  464. package/vitest.config.mjs +11 -0
  465. package/CHANGELOG.md +0 -1817
  466. package/dist/chunk-2OJ5OJ2D.mjs +0 -1
  467. package/dist/chunk-2OJ5OJ2D.mjs.map +0 -1
  468. package/dist/chunk-64DYJ27R.mjs +0 -201
  469. package/dist/chunk-64DYJ27R.mjs.map +0 -1
  470. package/dist/chunk-6QGXWNS5.mjs +0 -34
  471. package/dist/chunk-6QGXWNS5.mjs.map +0 -1
  472. package/dist/chunk-6W2UEO2M.mjs +0 -94
  473. package/dist/chunk-6W2UEO2M.mjs.map +0 -1
  474. package/dist/chunk-7DJDTRNX.mjs +0 -426
  475. package/dist/chunk-7DJDTRNX.mjs.map +0 -1
  476. package/dist/chunk-A66772CV.mjs +0 -107
  477. package/dist/chunk-A66772CV.mjs.map +0 -1
  478. package/dist/chunk-BOKE4OKY.mjs +0 -41
  479. package/dist/chunk-BOKE4OKY.mjs.map +0 -1
  480. package/dist/chunk-FCCOSO5L.mjs +0 -1
  481. package/dist/chunk-FCCOSO5L.mjs.map +0 -1
  482. package/dist/chunk-GYZIHHE6.mjs +0 -13
  483. package/dist/chunk-GYZIHHE6.mjs.map +0 -1
  484. package/dist/chunk-IAFBVORQ.mjs +0 -1
  485. package/dist/chunk-IAFBVORQ.mjs.map +0 -1
  486. package/dist/chunk-JAAUCDUR.mjs +0 -38
  487. package/dist/chunk-JAAUCDUR.mjs.map +0 -1
  488. package/dist/chunk-MSUB6DGR.mjs +0 -1
  489. package/dist/chunk-MSUB6DGR.mjs.map +0 -1
  490. package/dist/chunk-N5EP5OD5.mjs +0 -1
  491. package/dist/chunk-N5EP5OD5.mjs.map +0 -1
  492. package/dist/chunk-NAFEBKSO.mjs +0 -1
  493. package/dist/chunk-NAFEBKSO.mjs.map +0 -1
  494. package/dist/chunk-P7STFMPO.mjs +0 -1
  495. package/dist/chunk-P7STFMPO.mjs.map +0 -1
  496. package/dist/chunk-PL5WNHFZ.mjs +0 -50
  497. package/dist/chunk-PL5WNHFZ.mjs.map +0 -1
  498. package/dist/chunk-UYARLQNA.mjs +0 -1
  499. package/dist/chunk-UYARLQNA.mjs.map +0 -1
  500. package/dist/chunk-XEMZTHQZ.mjs +0 -67
  501. package/dist/chunk-XEMZTHQZ.mjs.map +0 -1
  502. package/dist/chunk-XTHC46M2.mjs +0 -1
  503. package/dist/chunk-XTHC46M2.mjs.map +0 -1
  504. package/dist/constants/index.d.ts +0 -6
  505. package/dist/constants/index.js +0 -40
  506. package/dist/constants/index.js.map +0 -1
  507. package/dist/index.d.ts +0 -25
  508. package/dist/index.js +0 -1098
  509. package/dist/index.js.map +0 -1
  510. package/dist/telemetry/events.d.ts +0 -45
  511. package/dist/telemetry/events.js +0 -19
  512. package/dist/telemetry/events.js.map +0 -1
  513. package/dist/telemetry/events.mjs +0 -1
  514. package/dist/telemetry/events.mjs.map +0 -1
  515. package/dist/telemetry/index.d.ts +0 -3
  516. package/dist/telemetry/index.js +0 -188
  517. package/dist/telemetry/index.js.map +0 -1
  518. package/dist/telemetry/index.mjs.map +0 -1
  519. package/dist/telemetry/scarf-client.d.ts +0 -7
  520. package/dist/telemetry/scarf-client.js +0 -59
  521. package/dist/telemetry/scarf-client.js.map +0 -1
  522. package/dist/telemetry/scarf-client.mjs +0 -7
  523. package/dist/telemetry/scarf-client.mjs.map +0 -1
  524. package/dist/telemetry/security-check.d.ts +0 -2
  525. package/dist/telemetry/security-check.js +0 -2
  526. package/dist/telemetry/security-check.js.map +0 -1
  527. package/dist/telemetry/security-check.mjs +0 -1
  528. package/dist/telemetry/security-check.mjs.map +0 -1
  529. package/dist/telemetry/telemetry-client.d.ts +0 -40
  530. package/dist/telemetry/telemetry-client.js +0 -186
  531. package/dist/telemetry/telemetry-client.js.map +0 -1
  532. package/dist/telemetry/utils.d.ts +0 -8
  533. package/dist/telemetry/utils.js +0 -69
  534. package/dist/telemetry/utils.js.map +0 -1
  535. package/dist/types/action.js +0 -19
  536. package/dist/types/action.js.map +0 -1
  537. package/dist/types/action.mjs +0 -2
  538. package/dist/types/action.mjs.map +0 -1
  539. package/dist/types/copilot-cloud-config.d.ts +0 -13
  540. package/dist/types/copilot-cloud-config.js +0 -19
  541. package/dist/types/copilot-cloud-config.js.map +0 -1
  542. package/dist/types/copilot-cloud-config.mjs +0 -2
  543. package/dist/types/copilot-cloud-config.mjs.map +0 -1
  544. package/dist/types/error.d.ts +0 -55
  545. package/dist/types/error.js +0 -19
  546. package/dist/types/error.js.map +0 -1
  547. package/dist/types/error.mjs +0 -2
  548. package/dist/types/error.mjs.map +0 -1
  549. package/dist/types/index.d.ts +0 -7
  550. package/dist/types/index.js +0 -19
  551. package/dist/types/index.js.map +0 -1
  552. package/dist/types/index.mjs +0 -8
  553. package/dist/types/index.mjs.map +0 -1
  554. package/dist/types/message.d.ts +0 -26
  555. package/dist/types/message.js +0 -19
  556. package/dist/types/message.js.map +0 -1
  557. package/dist/types/message.mjs +0 -2
  558. package/dist/types/message.mjs.map +0 -1
  559. package/dist/types/openai-assistant.d.ts +0 -53
  560. package/dist/types/openai-assistant.js +0 -19
  561. package/dist/types/openai-assistant.js.map +0 -1
  562. package/dist/types/openai-assistant.mjs +0 -2
  563. package/dist/types/openai-assistant.mjs.map +0 -1
  564. package/dist/types/utility.d.ts +0 -6
  565. package/dist/types/utility.js +0 -19
  566. package/dist/types/utility.js.map +0 -1
  567. package/dist/types/utility.mjs +0 -2
  568. package/dist/types/utility.mjs.map +0 -1
  569. package/dist/utils/conditions.js +0 -74
  570. package/dist/utils/conditions.js.map +0 -1
  571. package/dist/utils/console-styling.d.ts +0 -84
  572. package/dist/utils/console-styling.js +0 -123
  573. package/dist/utils/console-styling.js.map +0 -1
  574. package/dist/utils/errors.js +0 -443
  575. package/dist/utils/errors.js.map +0 -1
  576. package/dist/utils/index.d.ts +0 -32
  577. package/dist/utils/index.js +0 -927
  578. package/dist/utils/index.js.map +0 -1
  579. package/dist/utils/json-schema.js +0 -228
  580. package/dist/utils/json-schema.js.map +0 -1
  581. package/dist/utils/random-id.js +0 -68
  582. package/dist/utils/random-id.js.map +0 -1
  583. package/dist/utils/requests.js +0 -91
  584. package/dist/utils/requests.js.map +0 -1
  585. package/dist/utils/types.d.ts +0 -20
  586. package/dist/utils/types.js +0 -19
  587. package/dist/utils/types.js.map +0 -1
  588. package/jest.config.js +0 -5
  589. package/src/telemetry/scarf-client.ts +0 -39
  590. package/src/telemetry/security-check.ts +0 -0
  591. package/src/utils/json-schema.test.ts +0 -383
  592. package/tsup.config.ts +0 -11
@@ -0,0 +1,214 @@
1
+ import {
2
+ getModalityFromMimeType,
3
+ formatFileSize,
4
+ exceedsMaxSize,
5
+ matchesAcceptFilter,
6
+ getSourceUrl,
7
+ } from "../utils";
8
+
9
+ // ---------------------------------------------------------------------------
10
+ // Helpers
11
+ // ---------------------------------------------------------------------------
12
+
13
+ function mockFile(size: number): File {
14
+ return { size } as File;
15
+ }
16
+
17
+ function mockFileWithType(type: string, name = "test"): File {
18
+ return { type, name } as File;
19
+ }
20
+
21
+ // ---------------------------------------------------------------------------
22
+ // getModalityFromMimeType
23
+ // ---------------------------------------------------------------------------
24
+
25
+ describe("getModalityFromMimeType", () => {
26
+ it('returns "image" for image/png', () => {
27
+ expect(getModalityFromMimeType("image/png")).toBe("image");
28
+ });
29
+
30
+ it('returns "image" for image/jpeg', () => {
31
+ expect(getModalityFromMimeType("image/jpeg")).toBe("image");
32
+ });
33
+
34
+ it('returns "audio" for audio/mp3', () => {
35
+ expect(getModalityFromMimeType("audio/mp3")).toBe("audio");
36
+ });
37
+
38
+ it('returns "audio" for audio/wav', () => {
39
+ expect(getModalityFromMimeType("audio/wav")).toBe("audio");
40
+ });
41
+
42
+ it('returns "video" for video/mp4', () => {
43
+ expect(getModalityFromMimeType("video/mp4")).toBe("video");
44
+ });
45
+
46
+ it('returns "video" for video/webm', () => {
47
+ expect(getModalityFromMimeType("video/webm")).toBe("video");
48
+ });
49
+
50
+ it('returns "document" for application/pdf', () => {
51
+ expect(getModalityFromMimeType("application/pdf")).toBe("document");
52
+ });
53
+
54
+ it('returns "document" for text/plain', () => {
55
+ expect(getModalityFromMimeType("text/plain")).toBe("document");
56
+ });
57
+
58
+ it('returns "document" for empty string (fallback)', () => {
59
+ expect(getModalityFromMimeType("")).toBe("document");
60
+ });
61
+ });
62
+
63
+ // ---------------------------------------------------------------------------
64
+ // formatFileSize
65
+ // ---------------------------------------------------------------------------
66
+
67
+ describe("formatFileSize", () => {
68
+ it('formats 0 bytes as "0 B"', () => {
69
+ expect(formatFileSize(0)).toBe("0 B");
70
+ });
71
+
72
+ it('formats 512 bytes as "512 B"', () => {
73
+ expect(formatFileSize(512)).toBe("512 B");
74
+ });
75
+
76
+ it('formats 1023 bytes as "1023 B"', () => {
77
+ expect(formatFileSize(1023)).toBe("1023 B");
78
+ });
79
+
80
+ it('formats 1024 bytes as "1.0 KB"', () => {
81
+ expect(formatFileSize(1024)).toBe("1.0 KB");
82
+ });
83
+
84
+ it('formats 1536 bytes as "1.5 KB"', () => {
85
+ expect(formatFileSize(1536)).toBe("1.5 KB");
86
+ });
87
+
88
+ it('formats 1048575 bytes as "1024.0 KB" (one byte under 1 MB)', () => {
89
+ expect(formatFileSize(1048575)).toBe("1024.0 KB");
90
+ });
91
+
92
+ it('formats 1048576 bytes as "1.0 MB"', () => {
93
+ expect(formatFileSize(1048576)).toBe("1.0 MB");
94
+ });
95
+
96
+ it('formats 10485760 bytes as "10.0 MB"', () => {
97
+ expect(formatFileSize(10485760)).toBe("10.0 MB");
98
+ });
99
+ });
100
+
101
+ // ---------------------------------------------------------------------------
102
+ // exceedsMaxSize
103
+ // ---------------------------------------------------------------------------
104
+
105
+ const MB_20 = 20 * 1024 * 1024;
106
+
107
+ describe("exceedsMaxSize", () => {
108
+ it("returns false for a file exactly at the 20 MB default limit", () => {
109
+ expect(exceedsMaxSize(mockFile(MB_20))).toBe(false);
110
+ });
111
+
112
+ it("returns true for a file one byte over the 20 MB default limit", () => {
113
+ expect(exceedsMaxSize(mockFile(MB_20 + 1))).toBe(true);
114
+ });
115
+
116
+ it("returns false for a file well under the default limit", () => {
117
+ expect(exceedsMaxSize(mockFile(1024))).toBe(false);
118
+ });
119
+
120
+ it("returns true when file exceeds a custom maxSize", () => {
121
+ const MB_5 = 5 * 1024 * 1024;
122
+ const MB_10 = 10 * 1024 * 1024;
123
+ expect(exceedsMaxSize(mockFile(MB_10), MB_5)).toBe(true);
124
+ });
125
+ });
126
+
127
+ // ---------------------------------------------------------------------------
128
+ // matchesAcceptFilter
129
+ // ---------------------------------------------------------------------------
130
+
131
+ describe("matchesAcceptFilter", () => {
132
+ it('returns true for accept "*/*" regardless of file type', () => {
133
+ expect(matchesAcceptFilter(mockFileWithType("image/png"), "*/*")).toBe(
134
+ true,
135
+ );
136
+ });
137
+
138
+ it("returns true for empty accept string (accept all)", () => {
139
+ expect(matchesAcceptFilter(mockFileWithType("image/png"), "")).toBe(true);
140
+ });
141
+
142
+ it('returns true when accept "image/*" matches "image/png"', () => {
143
+ expect(matchesAcceptFilter(mockFileWithType("image/png"), "image/*")).toBe(
144
+ true,
145
+ );
146
+ });
147
+
148
+ it('returns false when accept "image/*" rejects "audio/mp3"', () => {
149
+ expect(matchesAcceptFilter(mockFileWithType("audio/mp3"), "image/*")).toBe(
150
+ false,
151
+ );
152
+ });
153
+
154
+ it('returns true for exact match accept "application/pdf"', () => {
155
+ expect(
156
+ matchesAcceptFilter(
157
+ mockFileWithType("application/pdf"),
158
+ "application/pdf",
159
+ ),
160
+ ).toBe(true);
161
+ });
162
+
163
+ it('returns false when exact accept "application/pdf" rejects "image/png"', () => {
164
+ expect(
165
+ matchesAcceptFilter(mockFileWithType("image/png"), "application/pdf"),
166
+ ).toBe(false);
167
+ });
168
+
169
+ it('returns true for comma-separated accept "image/*,application/pdf" with "image/jpeg"', () => {
170
+ expect(
171
+ matchesAcceptFilter(
172
+ mockFileWithType("image/jpeg"),
173
+ "image/*,application/pdf",
174
+ ),
175
+ ).toBe(true);
176
+ });
177
+
178
+ it('returns true for comma-separated accept "image/*,application/pdf" with "application/pdf"', () => {
179
+ expect(
180
+ matchesAcceptFilter(
181
+ mockFileWithType("application/pdf"),
182
+ "image/*,application/pdf",
183
+ ),
184
+ ).toBe(true);
185
+ });
186
+
187
+ it("handles whitespace in comma-separated accept values", () => {
188
+ expect(
189
+ matchesAcceptFilter(
190
+ mockFileWithType("application/pdf"),
191
+ "image/* , application/pdf",
192
+ ),
193
+ ).toBe(true);
194
+ });
195
+
196
+ it("returns false for empty file type against a specific filter", () => {
197
+ expect(matchesAcceptFilter(mockFileWithType(""), "image/*")).toBe(false);
198
+ });
199
+ });
200
+
201
+ describe("getSourceUrl", () => {
202
+ it("returns a URL source as is and builds a data URL for inline data", () => {
203
+ expect(getSourceUrl({ type: "url", value: "https://x.test/a.png" })).toBe(
204
+ "https://x.test/a.png",
205
+ );
206
+ expect(
207
+ getSourceUrl({ type: "data", value: "aGk=", mimeType: "image/png" }),
208
+ ).toBe("data:image/png;base64,aGk=");
209
+ });
210
+
211
+ it("returns no address for a provider file handle", () => {
212
+ expect(getSourceUrl({ type: "file", value: "file-abc123" })).toBe("");
213
+ });
214
+ });
@@ -0,0 +1,48 @@
1
+ import { describe, expect, it } from "vitest";
2
+ import { createAttachmentContent } from "./content";
3
+
4
+ describe("createAttachmentContent", () => {
5
+ it.each(["image", "audio", "video", "document"] as const)(
6
+ "preserves %s bytes, source, and metadata precedence",
7
+ (type) => {
8
+ const source = {
9
+ type: "data",
10
+ value: "AAEC",
11
+ mimeType: "application/octet-stream",
12
+ } as const;
13
+ const part = createAttachmentContent({
14
+ type,
15
+ source,
16
+ filename: "upload.bin",
17
+ metadata: { filename: "custom.bin", custom: { value: 1 } },
18
+ });
19
+ expect(part).toEqual({
20
+ type,
21
+ source,
22
+ metadata: { filename: "custom.bin", custom: { value: 1 } },
23
+ });
24
+ expect("source" in part && part.source).toBe(source);
25
+ },
26
+ );
27
+
28
+ it("preserves URL sources and always includes metadata", () => {
29
+ const source = {
30
+ type: "url",
31
+ value: "https://example.test/image.png",
32
+ } as const;
33
+ expect(
34
+ createAttachmentContent({ type: "image", source, filename: "" }),
35
+ ).toEqual({
36
+ type: "image",
37
+ source,
38
+ metadata: {},
39
+ });
40
+ expect(
41
+ createAttachmentContent({ type: "image", source, filename: "image.png" }),
42
+ ).toEqual({
43
+ type: "image",
44
+ source,
45
+ metadata: { filename: "image.png" },
46
+ });
47
+ });
48
+ });
@@ -0,0 +1,16 @@
1
+ import type { InputContent } from "@ag-ui/core";
2
+ import type { Attachment } from "./types";
3
+
4
+ /** Build the AG-UI content part used when sending a ready attachment. */
5
+ export function createAttachmentContent(
6
+ attachment: Pick<Attachment, "type" | "source" | "filename" | "metadata">,
7
+ ): InputContent {
8
+ return {
9
+ type: attachment.type,
10
+ source: attachment.source,
11
+ metadata: {
12
+ ...(attachment.filename ? { filename: attachment.filename } : {}),
13
+ ...attachment.metadata,
14
+ },
15
+ };
16
+ }
@@ -0,0 +1,21 @@
1
+ export type {
2
+ AttachmentsConfig,
3
+ AttachmentUploadResult,
4
+ AttachmentUploadError,
5
+ AttachmentUploadErrorReason,
6
+ Attachment,
7
+ AttachmentModality,
8
+ } from "./types";
9
+
10
+ export { createAttachmentContent } from "./content";
11
+
12
+ export {
13
+ getModalityFromMimeType,
14
+ formatFileSize,
15
+ exceedsMaxSize,
16
+ readFileAsBase64,
17
+ generateVideoThumbnail,
18
+ matchesAcceptFilter,
19
+ getSourceUrl,
20
+ getDocumentIcon,
21
+ } from "./utils";
@@ -0,0 +1,77 @@
1
+ import type {
2
+ InputContentDataSource,
3
+ InputContentUrlSource,
4
+ } from "@ag-ui/core";
5
+
6
+ export interface AttachmentUploadDataResult {
7
+ type: "data";
8
+ value: string;
9
+ mimeType: string;
10
+ /** Custom metadata to include in the InputContent part (merged with auto-generated metadata like filename). */
11
+ metadata?: Record<string, unknown>;
12
+ }
13
+
14
+ export interface AttachmentUploadUrlResult {
15
+ type: "url";
16
+ value: string;
17
+ mimeType?: string;
18
+ /** Custom metadata to include in the InputContent part (merged with auto-generated metadata like filename). */
19
+ metadata?: Record<string, unknown>;
20
+ }
21
+
22
+ export type AttachmentUploadResult =
23
+ | AttachmentUploadDataResult
24
+ | AttachmentUploadUrlResult;
25
+
26
+ export type AttachmentUploadErrorReason =
27
+ | "file-too-large"
28
+ | "invalid-type"
29
+ | "upload-failed";
30
+
31
+ export interface AttachmentUploadError {
32
+ /** Why the upload failed. */
33
+ reason: AttachmentUploadErrorReason;
34
+ /** The file that failed to upload. */
35
+ file: File;
36
+ /** Human-readable error message. */
37
+ message: string;
38
+ }
39
+
40
+ export interface AttachmentsConfig {
41
+ /** Enable file attachments in the chat input */
42
+ enabled: boolean;
43
+ /** MIME type filter for the file input, default all files */
44
+ accept?: string;
45
+ /** Maximum file size in bytes, default 20MB (20 * 1024 * 1024) */
46
+ maxSize?: number;
47
+ /**
48
+ * How many files may upload at the same time, default 1 — `onUpload` is not
49
+ * called concurrently unless you raise this. Files past the limit wait for a
50
+ * free slot; `Infinity` lifts it. The limit covers everything in flight, so
51
+ * two selections dropped or pasted at once share the slots rather than each
52
+ * taking the full number.
53
+ * Honored by the React `useAttachments` hook — the Vue and Angular bindings
54
+ * still upload serially.
55
+ */
56
+ maxConcurrentUploads?: number;
57
+ /** Custom upload handler. Return an InputContentSource with optional metadata. */
58
+ onUpload?: (
59
+ file: File,
60
+ ) => AttachmentUploadResult | Promise<AttachmentUploadResult>;
61
+ /** Called when an attachment fails validation or upload. Use this to show a toast or inline error. */
62
+ onUploadFailed?: (error: AttachmentUploadError) => void;
63
+ }
64
+
65
+ export type AttachmentModality = "image" | "audio" | "video" | "document";
66
+
67
+ export interface Attachment {
68
+ id: string;
69
+ type: AttachmentModality;
70
+ source: InputContentDataSource | InputContentUrlSource;
71
+ filename?: string;
72
+ size?: number;
73
+ status: "uploading" | "ready";
74
+ thumbnail?: string;
75
+ /** Custom metadata from onUpload, included in the InputContent part. */
76
+ metadata?: Record<string, unknown>;
77
+ }
@@ -0,0 +1,169 @@
1
+ import type { AttachmentModality } from "./types";
2
+ import type { InputContentSource } from "../types/message";
3
+
4
+ const DEFAULT_MAX_SIZE = 20 * 1024 * 1024; // 20MB
5
+
6
+ /**
7
+ * Derive the attachment modality from a MIME type string.
8
+ */
9
+ export function getModalityFromMimeType(mimeType: string): AttachmentModality {
10
+ if (mimeType.startsWith("image/")) return "image";
11
+ if (mimeType.startsWith("audio/")) return "audio";
12
+ if (mimeType.startsWith("video/")) return "video";
13
+ return "document";
14
+ }
15
+
16
+ /**
17
+ * Format a byte count as a human-readable file size string.
18
+ */
19
+ export function formatFileSize(bytes: number): string {
20
+ if (bytes < 1024) return `${bytes} B`;
21
+ if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
22
+ return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
23
+ }
24
+
25
+ /**
26
+ * Check if a file exceeds the maximum allowed size.
27
+ */
28
+ export function exceedsMaxSize(
29
+ file: File,
30
+ maxSize: number = DEFAULT_MAX_SIZE,
31
+ ): boolean {
32
+ return file.size > maxSize;
33
+ }
34
+
35
+ /**
36
+ * Read a File as a base64 string (without the data URL prefix).
37
+ */
38
+ export function readFileAsBase64(file: File): Promise<string> {
39
+ return new Promise((resolve, reject) => {
40
+ const reader = new FileReader();
41
+ reader.onload = (e) => {
42
+ const result = e.target?.result as string;
43
+ const base64 = result?.split(",")[1];
44
+ if (base64) {
45
+ resolve(base64);
46
+ } else {
47
+ reject(new Error("Failed to read file as base64"));
48
+ }
49
+ };
50
+ reader.onerror = reject;
51
+ reader.readAsDataURL(file);
52
+ });
53
+ }
54
+
55
+ /**
56
+ * Generate a thumbnail data URL from a video file by capturing a frame near the start (at 0.1s).
57
+ * Returns undefined if thumbnail generation fails or if called outside a browser environment.
58
+ */
59
+ export function generateVideoThumbnail(
60
+ file: File,
61
+ ): Promise<string | undefined> {
62
+ if (typeof document === "undefined") {
63
+ return Promise.resolve(undefined);
64
+ }
65
+ return new Promise((resolve) => {
66
+ let resolved = false;
67
+ const video = document.createElement("video");
68
+ const canvas = document.createElement("canvas");
69
+ const url = URL.createObjectURL(file);
70
+
71
+ const cleanup = (result: string | undefined) => {
72
+ if (resolved) return;
73
+ resolved = true;
74
+ URL.revokeObjectURL(url);
75
+ resolve(result);
76
+ };
77
+
78
+ const timeout = setTimeout(() => {
79
+ console.warn(
80
+ `[CopilotKit] generateVideoThumbnail: timed out for file "${file.name}"`,
81
+ );
82
+ cleanup(undefined);
83
+ }, 10000);
84
+
85
+ video.preload = "metadata";
86
+ video.muted = true;
87
+ video.playsInline = true;
88
+
89
+ video.onloadeddata = () => {
90
+ video.currentTime = 0.1;
91
+ };
92
+
93
+ video.onseeked = () => {
94
+ clearTimeout(timeout);
95
+ canvas.width = video.videoWidth;
96
+ canvas.height = video.videoHeight;
97
+ const ctx = canvas.getContext("2d");
98
+ if (ctx) {
99
+ ctx.drawImage(video, 0, 0);
100
+ const thumbnail = canvas.toDataURL("image/jpeg", 0.7);
101
+ cleanup(thumbnail);
102
+ } else {
103
+ console.warn(
104
+ "[CopilotKit] generateVideoThumbnail: could not get 2d canvas context",
105
+ );
106
+ cleanup(undefined);
107
+ }
108
+ };
109
+
110
+ video.onerror = () => {
111
+ clearTimeout(timeout);
112
+ console.warn(
113
+ `[CopilotKit] generateVideoThumbnail: video element error for file "${file.name}"`,
114
+ );
115
+ cleanup(undefined);
116
+ };
117
+
118
+ video.src = url;
119
+ });
120
+ }
121
+
122
+ /**
123
+ * Check if a file's MIME type matches an accept filter string.
124
+ * Handles file extensions (e.g. ".pdf"), MIME wildcards ("image/*"), and comma-separated lists.
125
+ */
126
+ export function matchesAcceptFilter(file: File, accept: string): boolean {
127
+ if (!accept || accept === "*/*") return true;
128
+
129
+ const filters = accept.split(",").map((f) => f.trim());
130
+ return filters.some((filter) => {
131
+ if (filter.startsWith(".")) {
132
+ return (file.name ?? "").toLowerCase().endsWith(filter.toLowerCase());
133
+ }
134
+ if (filter.endsWith("/*")) {
135
+ const prefix = filter.slice(0, -2);
136
+ return file.type.startsWith(prefix + "/");
137
+ }
138
+ return file.type === filter;
139
+ });
140
+ }
141
+
142
+ /**
143
+ * Convert an InputContentSource to a usable URL string.
144
+ * For data sources, returns a base64 data URL; for URL sources, returns the URL directly.
145
+ * A provider file handle (AG-UI 1.0 `file` source) has no address a browser
146
+ * can load, so it returns an empty string and the caller shows no preview.
147
+ */
148
+ export function getSourceUrl(source: InputContentSource): string {
149
+ if (source.type === "url") {
150
+ return source.value;
151
+ }
152
+ if (source.type === "file") {
153
+ return "";
154
+ }
155
+ return `data:${source.mimeType};base64,${source.value}`;
156
+ }
157
+
158
+ /**
159
+ * Return a short human-readable label for a document MIME type (e.g. "PDF", "DOC").
160
+ */
161
+ export function getDocumentIcon(mimeType: string): string {
162
+ if (mimeType.includes("pdf")) return "PDF";
163
+ if (mimeType.includes("sheet") || mimeType.includes("excel")) return "XLS";
164
+ if (mimeType.includes("presentation") || mimeType.includes("powerpoint"))
165
+ return "PPT";
166
+ if (mimeType.includes("word") || mimeType.includes("document")) return "DOC";
167
+ if (mimeType.includes("text/")) return "TXT";
168
+ return "FILE";
169
+ }
@@ -1,4 +1,17 @@
1
1
  export const COPILOT_CLOUD_API_URL = "https://api.cloud.copilotkit.ai";
2
2
  export const COPILOT_CLOUD_VERSION = "v1";
3
3
  export const COPILOT_CLOUD_CHAT_URL = `${COPILOT_CLOUD_API_URL}/copilotkit/${COPILOT_CLOUD_VERSION}`;
4
- export const COPILOT_CLOUD_PUBLIC_API_KEY_HEADER = "X-CopilotCloud-Public-Api-Key";
4
+ export const COPILOT_CLOUD_PUBLIC_API_KEY_HEADER =
5
+ "X-CopilotCloud-Public-Api-Key";
6
+
7
+ export const DEFAULT_AGENT_ID = "default";
8
+
9
+ /**
10
+ * `RUN_ERROR` code the runtime sends when a run is rejected because the
11
+ * thread already has one in flight. CopilotKit core reports it as
12
+ * `agent_thread_locked`.
13
+ */
14
+ export const THREAD_ALREADY_RUNNING_ERROR_CODE = "THREAD_ALREADY_RUNNING";
15
+
16
+ /** Phoenix channel event name used for all AG-UI events. */
17
+ export const AG_UI_CHANNEL_EVENT = "ag-ui";
@@ -0,0 +1,9 @@
1
+ import { BaseEvent } from "@ag-ui/client";
2
+
3
+ export interface DebugEventEnvelope {
4
+ timestamp: number;
5
+ agentId: string;
6
+ threadId: string;
7
+ runId: string;
8
+ event: BaseEvent;
9
+ }
package/src/debug.ts ADDED
@@ -0,0 +1,55 @@
1
+ /**
2
+ * Granular debug configuration for CopilotKit runtime and client.
3
+ * Pass `true` to enable events + lifecycle logging (but NOT verbose payloads),
4
+ * or an object for granular control including `verbose: true` for full payloads.
5
+ */
6
+ export type DebugConfig =
7
+ | boolean
8
+ | {
9
+ /** Log every event emitted/received. Default: true */
10
+ events?: boolean;
11
+ /** Log request/run lifecycle. Default: true */
12
+ lifecycle?: boolean;
13
+ /** Log full event payloads instead of summaries. Default: false — must be explicitly opted in */
14
+ verbose?: boolean;
15
+ };
16
+
17
+ /** Normalized debug configuration — all fields resolved to booleans. */
18
+ export interface ResolvedDebugConfig {
19
+ enabled: boolean;
20
+ events: boolean;
21
+ lifecycle: boolean;
22
+ verbose: boolean;
23
+ }
24
+
25
+ /** The all-off config used when debug is falsy. */
26
+ const DEBUG_OFF: ResolvedDebugConfig = {
27
+ enabled: false,
28
+ events: false,
29
+ lifecycle: false,
30
+ verbose: false,
31
+ };
32
+
33
+ /**
34
+ * Normalizes a DebugConfig value into a ResolvedDebugConfig.
35
+ *
36
+ * - `false` / `undefined` → all off
37
+ * - `true` → events + lifecycle on, verbose off (no PII in logs)
38
+ * - object → merges with defaults (events: true, lifecycle: true, verbose: false)
39
+ */
40
+ export function resolveDebugConfig(
41
+ debug: DebugConfig | undefined,
42
+ ): ResolvedDebugConfig {
43
+ if (!debug) return DEBUG_OFF;
44
+
45
+ if (debug === true) {
46
+ return { enabled: true, events: true, lifecycle: true, verbose: false };
47
+ }
48
+
49
+ const events = debug.events ?? true;
50
+ const lifecycle = debug.lifecycle ?? true;
51
+ const enabled = events || lifecycle;
52
+ const verbose = enabled && (debug.verbose ?? false);
53
+
54
+ return { enabled, events, lifecycle, verbose };
55
+ }
@@ -0,0 +1,5 @@
1
+ // Server-only entry: A2UI depends on node:crypto. Do not re-export from the root.
2
+ export { A2UIMiddleware } from "@ag-ui/a2ui-middleware";
3
+ export type { A2UIMiddlewareConfig } from "@ag-ui/a2ui-middleware";
4
+ export * from "./open-generative-ui-middleware";
5
+ export * from "./recorded-events";