@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
package/src/index.ts CHANGED
@@ -1,7 +1,196 @@
1
1
  export * from "./types";
2
2
  export * from "./utils";
3
3
  export * from "./constants";
4
- export * from "./telemetry";
4
+ // Telemetry is split deliberately. `TelemetryClient` imports
5
+ // `@segment/analytics-node`, which imports `node-fetch`, which imports the
6
+ // Node built-ins `stream`, `http`, `https` and `zlib`. Browser bundlers
7
+ // resolve the whole module graph before they tree-shake, so re-exporting
8
+ // that module here made every browser build of a dependent package print
9
+ // "Module ... has been externalized for browser compatibility" warnings,
10
+ // even when the consumer never touched telemetry (#4151). Only the
11
+ // browser-safe telemetry surface is re-exported from this entry. Server
12
+ // code that needs the client imports it from `@copilotkit/shared/telemetry`.
13
+ // This mirrors the license-verifier note below.
14
+ export { isTelemetryDisabled } from "./telemetry/telemetry-disabled";
15
+ export * from "./telemetry/sampling";
16
+ // Pure string classification with no imports, so it carries no runtime edge
17
+ // into browser builds — same reasoning as `sampling` above.
18
+ export * from "./telemetry/model-host";
19
+ export {
20
+ firstNonBlankTelemetryId,
21
+ lambdaClient,
22
+ parseTelemetryIdFromLicense,
23
+ parseAndWarnTelemetryId,
24
+ } from "./telemetry/lambda-client";
25
+ export type { LambdaSendOptions } from "./telemetry/lambda-client";
26
+ // Types only: erased at build time, so they add no runtime edge to
27
+ // `telemetry-client.ts` and therefore none to @segment/analytics-node.
28
+ export type {
29
+ TelemetryCapture,
30
+ TelemetryIdentity,
31
+ } from "./telemetry/telemetry-client";
32
+ export * from "./debug";
33
+ export * from "./standard-schema";
34
+ export * from "./attachments";
35
+
36
+ export { logger } from "./logger";
37
+ export {
38
+ createRunEventFinalizer,
39
+ finalizeRunEvents,
40
+ type FinalizeRunOptions,
41
+ type RunEventFinalizer,
42
+ } from "./finalize-events";
43
+ export { stripIntelligenceRoutingFields } from "./intelligence-routing-fields";
44
+
45
+ export {
46
+ TranscriptionErrorCode,
47
+ TranscriptionErrors,
48
+ type TranscriptionErrorResponse,
49
+ } from "./transcription-errors";
5
50
 
6
51
  import * as packageJson from "../package.json";
7
52
  export const COPILOTKIT_VERSION = packageJson.version;
53
+
54
+ // Re-export only types from license-verifier (types are erased at compile time,
55
+ // so they don't pull in the Node-only `crypto` dependency into client bundles).
56
+ // Server-side packages (e.g. @copilotkit/runtime) should import runtime functions
57
+ // like createLicenseChecker and getLicenseWarningHeader directly from
58
+ // @copilotkit/license-verifier.
59
+ export type {
60
+ LicenseChecker,
61
+ LicenseStatus,
62
+ LicensePayload,
63
+ LicenseFeatures,
64
+ LicenseTier,
65
+ LicenseOwner,
66
+ } from "@copilotkit/license-verifier";
67
+
68
+ import type { LicensePayload } from "@copilotkit/license-verifier";
69
+ import type {
70
+ RuntimeEntitlementResponse,
71
+ RuntimeLicenseStatus,
72
+ } from "./utils/types";
73
+
74
+ // LicenseContextValue was dropped from license-verifier's public API in
75
+ // 0.3.0, so it is defined here. The context shape is owned by this package
76
+ // anyway via createLicenseContextValue below.
77
+
78
+ /**
79
+ * License context value exposed to child components.
80
+ * Frontend providers create their own context using this shape.
81
+ */
82
+ export interface LicenseContextValue {
83
+ /** Effective license status after structured entitlement precedence. Null until known. */
84
+ status: RuntimeLicenseStatus | null;
85
+ /** The license payload if available. Always null on the client; the payload stays server-side. */
86
+ license: LicensePayload | null;
87
+ /** Whether a feature is licensed. Ready entitlements override legacy status behavior. */
88
+ checkFeature: (feature: string) => boolean;
89
+ /** Get a numeric feature limit. Zero means unlimited; null means not applicable. */
90
+ getLimit: (feature: string) => number | null;
91
+ }
92
+
93
+ /** Read a record value without traversing its prototype chain. */
94
+ function getOwnRecordValue<Value>(
95
+ record: Readonly<Record<string, Value>>,
96
+ key: string,
97
+ ): Value | undefined {
98
+ return Object.prototype.hasOwnProperty.call(record, key)
99
+ ? record[key]
100
+ : undefined;
101
+ }
102
+
103
+ /** Legacy UI surfaces that remain available for every active entitlement. */
104
+ function isLegacyUiFeature(feature: string): boolean {
105
+ return feature === "chat" || feature === "popup" || feature === "sidebar";
106
+ }
107
+
108
+ /**
109
+ * Client-safe license context factory, driven by the license authority the
110
+ * runtime reports via /info.
111
+ *
112
+ * A ready managed entitlement is authoritative in both directions. A ready
113
+ * active self-hosted entitlement is also authoritative, while an inactive
114
+ * self-hosted response preserves the legacy signed-license fallback. Active
115
+ * entitlements supply feature grants and limits; authoritative inactive
116
+ * entitlements deny every feature and limit. Older runtimes that report only a
117
+ * status retain the legacy behavior: features are enabled unless the status is
118
+ * "expired" or "invalid", and no limits are reported. This is inlined here to
119
+ * avoid importing the full license-verifier bundle (which depends on Node's
120
+ * `crypto`) into browser bundles.
121
+ */
122
+ export function createLicenseContextValue(
123
+ status: RuntimeLicenseStatus | null | undefined,
124
+ runtimeEntitlements?: RuntimeEntitlementResponse,
125
+ ): LicenseContextValue {
126
+ const readyEntitlement =
127
+ runtimeEntitlements?.status === "ready"
128
+ ? runtimeEntitlements.entitlement
129
+ : null;
130
+ const hasUsableSelfHostedLegacyFallback =
131
+ readyEntitlement &&
132
+ !readyEntitlement.active &&
133
+ readyEntitlement.source === "selfHostedDeploymentLicense" &&
134
+ (status === "valid" || status === "expiring");
135
+ const featureAuthority =
136
+ readyEntitlement && !hasUsableSelfHostedLegacyFallback
137
+ ? readyEntitlement
138
+ : null;
139
+ const activeEntitlement = featureAuthority?.active ? featureAuthority : null;
140
+ const resolvedStatus = activeEntitlement
141
+ ? "valid"
142
+ : readyEntitlement?.source === "managedOrgSubscription" ||
143
+ readyEntitlement?.source === "awsMarketplaceDeploymentLicense"
144
+ ? "none"
145
+ : featureAuthority
146
+ ? (status ?? "none")
147
+ : (status ?? null);
148
+ const featuresEnabled =
149
+ resolvedStatus !== "expired" && resolvedStatus !== "invalid";
150
+
151
+ return {
152
+ status: resolvedStatus,
153
+ license: null,
154
+ checkFeature: (feature) =>
155
+ featureAuthority
156
+ ? activeEntitlement
157
+ ? feature === "threads" &&
158
+ Object.prototype.hasOwnProperty.call(
159
+ activeEntitlement.limits,
160
+ "threads.max_count",
161
+ )
162
+ ? true
163
+ : (getOwnRecordValue(activeEntitlement.features, feature) ??
164
+ isLegacyUiFeature(feature))
165
+ : false
166
+ : featuresEnabled,
167
+ getLimit: (feature) =>
168
+ activeEntitlement
169
+ ? (getOwnRecordValue(activeEntitlement.limits, feature) ?? null)
170
+ : null,
171
+ };
172
+ }
173
+
174
+ export {
175
+ A2UI_DEFAULT_GENERATION_GUIDELINES,
176
+ A2UI_DEFAULT_DESIGN_GUIDELINES,
177
+ ALL_GENERATIVE_UI_GUIDE_FEATURES,
178
+ buildGenerativeUIMarkdownGuidelines,
179
+ generativeUIGuideFeatures,
180
+ GENERATIVE_UI_MARKDOWN_GUIDELINES,
181
+ GENERATIVE_UI_MARKDOWN_GUIDELINES_DESCRIPTION,
182
+ GENERATIVE_UI_MARKDOWN_SCHEMA_CONTEXT_DESCRIPTION,
183
+ } from "./a2ui-prompts";
184
+ export type { GenerativeUIGuideFeatures } from "./a2ui-prompts";
185
+ export {
186
+ COPILOTKIT_FORWARDED_PROPS_KEY,
187
+ COPILOTKIT_UI_ENVELOPE_FORMAT,
188
+ envelopeToManifest,
189
+ readCopilotKitUIEnvelope,
190
+ } from "./a2ui-envelope";
191
+ export type { CopilotKitUIEnvelope } from "./a2ui-envelope";
192
+
193
+ export type { DebugEventEnvelope } from "./debug-event-envelope";
194
+
195
+ export { GENERATE_SANDBOXED_UI_DESCRIPTION } from "./open-generative-ui-prompts";
196
+ export * from "./generative-ui";
@@ -0,0 +1,51 @@
1
+ import type { BaseEvent } from "@ag-ui/client";
2
+ import { EventType } from "@ag-ui/client";
3
+ import { describe, expect, it } from "vitest";
4
+ import { stripIntelligenceRoutingFields } from "./intelligence-routing-fields";
5
+
6
+ const stamped = {
7
+ threadId: "t1",
8
+ runId: "r1",
9
+ thread_id: "t1",
10
+ run_id: "r1",
11
+ metadata: { cpki_event_id: "e1" },
12
+ };
13
+
14
+ describe("stripIntelligenceRoutingFields", () => {
15
+ it("removes all routing fields from an event that does not declare them", () => {
16
+ const event = {
17
+ type: EventType.TEXT_MESSAGE_CONTENT,
18
+ messageId: "m1",
19
+ delta: "hi",
20
+ ...stamped,
21
+ } as BaseEvent;
22
+
23
+ expect(stripIntelligenceRoutingFields(event)).toEqual({
24
+ type: EventType.TEXT_MESSAGE_CONTENT,
25
+ messageId: "m1",
26
+ delta: "hi",
27
+ metadata: { cpki_event_id: "e1" },
28
+ });
29
+ });
30
+
31
+ it("keeps threadId and runId on the run events that declare them", () => {
32
+ const event = { type: EventType.RUN_FINISHED, ...stamped } as BaseEvent;
33
+
34
+ expect(stripIntelligenceRoutingFields(event)).toEqual({
35
+ type: EventType.RUN_FINISHED,
36
+ threadId: "t1",
37
+ runId: "r1",
38
+ metadata: { cpki_event_id: "e1" },
39
+ });
40
+ });
41
+
42
+ it("returns an event without routing fields unchanged", () => {
43
+ const event = {
44
+ type: EventType.RUN_STARTED,
45
+ threadId: "t1",
46
+ runId: "r1",
47
+ } as BaseEvent;
48
+
49
+ expect(stripIntelligenceRoutingFields(event)).toBe(event);
50
+ });
51
+ });
@@ -0,0 +1,40 @@
1
+ import type { BaseEvent } from "@ag-ui/client";
2
+
3
+ /**
4
+ * The only AG-UI 1.0 events whose schema declares `threadId` and `runId`.
5
+ * Plain literals, not `EventType`: a value import of `@ag-ui/client` here put
6
+ * the client and its zod validators into the initial chunk of every app that
7
+ * imports `@copilotkit/shared`.
8
+ */
9
+ const RUN_IDENTITY_EVENTS = new Set<string>(["RUN_STARTED", "RUN_FINISHED"]);
10
+
11
+ /**
12
+ * Removes the routing fields that the Intelligence runner stamps on every
13
+ * event it sends to the gateway (`thread_id`, `run_id`, and `threadId` /
14
+ * `runId` on events that do not declare them).
15
+ *
16
+ * The gateway relays these payloads unchanged. AG-UI 1.0 strips unknown
17
+ * fields before subscribers see them and warns once per field, per event,
18
+ * so a streamed answer would log hundreds of warnings. Call this where a
19
+ * gateway payload enters an AG-UI pipeline. The gateway still receives the
20
+ * fields, because the runner adds them after this point.
21
+ */
22
+ export function stripIntelligenceRoutingFields<T extends BaseEvent>(
23
+ event: T,
24
+ ): T {
25
+ const record = event as T & Record<string, unknown>;
26
+ const keepRunIdentity = RUN_IDENTITY_EVENTS.has(record.type);
27
+ if (
28
+ !("thread_id" in record) &&
29
+ !("run_id" in record) &&
30
+ (keepRunIdentity || (!("threadId" in record) && !("runId" in record)))
31
+ ) {
32
+ return event;
33
+ }
34
+ const { thread_id: _t, run_id: _r, ...rest } = record;
35
+ if (!keepRunIdentity) {
36
+ delete rest.threadId;
37
+ delete rest.runId;
38
+ }
39
+ return rest as unknown as T;
40
+ }
package/src/logger.ts ADDED
@@ -0,0 +1 @@
1
+ export const logger = console;
@@ -0,0 +1,20 @@
1
+ /** Shared generation contract for all Open Generative UI renderers. */
2
+ export const GENERATE_SANDBOXED_UI_DESCRIPTION =
3
+ "Generate sandboxed UI. " +
4
+ "IMPORTANT: The generated code runs in a sandboxed iframe WITHOUT same-origin access. " +
5
+ "Do NOT use localStorage, sessionStorage, document.cookie, IndexedDB, or fetch/XMLHttpRequest to same-origin URLs. " +
6
+ "To communicate with the host application, use Websandbox.connection.remote.<functionName>(args) which returns a Promise.\n\n" +
7
+ "You CAN use external libraries from CDNs by including <script> or <link> tags in the HTML <head> (e.g., Chart.js, D3, Three.js, x-data-spreadsheet, etc.). " +
8
+ "CDN resources load normally inside the sandbox.\n\n" +
9
+ "PARAMETER ORDER IS CRITICAL — generate parameters in exactly this order:\n" +
10
+ "1. initialHeight + placeholderMessages (shown to user while generating)\n" +
11
+ "2. css (all styles FIRST — the user sees a placeholder until CSS is complete)\n" +
12
+ "3. html (streams in live — the user watches the UI build as HTML is generated)\n" +
13
+ "4. jsFunctions (reusable helper functions)\n" +
14
+ "5. jsExpressions (applied one-by-one — the user sees each expression take effect)" +
15
+ "\n\nINITIALIZATION CONTRACT: jsFunctions and jsExpressions run after the final HTML DOM is ready, in both live generation and saved-thread replay. " +
16
+ "Define reusable functions in jsFunctions, then initialize the UI directly in the first jsExpressions entry (for example, initializeCalculator()). " +
17
+ "Attach click/keyboard handlers and set initial display values there. Do NOT wait for DOMContentLoaded, window.onload, or the load event in jsFunctions or jsExpressions: these events may already have fired. " +
18
+ "Each expression is executed once per rendered sandbox; later expressions must not repeat initialization or reattach the same handlers. " +
19
+ "Keep initialization self-contained so a new sandbox can reconstruct the UI when a saved thread is opened. If a library loads asynchronously, initialize from its explicit load promise instead of waiting for document readiness.\n\n" +
20
+ "INTERACTION CONTRACT: Every visible interactive control needs a working handler, including controls created during initialization. If the handlers are supplied through jsFunctions/jsExpressions, initialize them in the first expression; if supplied by an inline HTML script, ensure it runs when the final sandbox mounts and replays. Every user action must update the visible UI to reflect its completed result, including success and error paths. Changing a JavaScript variable alone does not update the DOM. After changing state, call the rendering function or update the displayed element directly. When delegating clicks from a parent element, resolve the clicked control with closest('button') so clicks on nested labels and values work. For a calculator, pressing = must replace the visible expression with the computed answer; metric shortcuts must visibly insert their values. Trace each button handler through its final display update before emitting the tool call.";
@@ -0,0 +1,82 @@
1
+ import type {
2
+ StandardSchemaV1,
3
+ StandardJSONSchemaV1,
4
+ } from "@standard-schema/spec";
5
+
6
+ export type { StandardSchemaV1, StandardJSONSchemaV1 };
7
+
8
+ /**
9
+ * Extract the Output type from a StandardSchemaV1 schema.
10
+ * Replaces `z.infer<S>` for generic schema inference.
11
+ */
12
+ export type InferSchemaOutput<S> =
13
+ S extends StandardSchemaV1<any, infer O> ? O : never;
14
+
15
+ export interface SchemaToJsonSchemaOptions {
16
+ /**
17
+ * Injected `zodToJsonSchema` function so that `shared` does not depend on
18
+ * `zod-to-json-schema`. Required when the schema is a Zod v3 schema that
19
+ * does not implement Standard JSON Schema V1.
20
+ */
21
+ zodToJsonSchema?: (
22
+ schema: unknown,
23
+ options?: { $refStrategy?: string },
24
+ ) => Record<string, unknown>;
25
+ }
26
+
27
+ /**
28
+ * Check whether a schema implements the Standard JSON Schema V1 protocol.
29
+ */
30
+ function hasStandardJsonSchema(
31
+ schema: StandardSchemaV1,
32
+ ): schema is StandardSchemaV1 & StandardJSONSchemaV1 {
33
+ const props = schema["~standard"];
34
+ return (
35
+ props != null &&
36
+ typeof props === "object" &&
37
+ "jsonSchema" in props &&
38
+ props.jsonSchema != null &&
39
+ typeof props.jsonSchema === "object" &&
40
+ "input" in props.jsonSchema &&
41
+ typeof props.jsonSchema.input === "function"
42
+ );
43
+ }
44
+
45
+ /**
46
+ * Convert any StandardSchemaV1-compatible schema to a JSON Schema object.
47
+ *
48
+ * Strategy:
49
+ * 1. If the schema implements Standard JSON Schema V1 (`~standard.jsonSchema`),
50
+ * call `schema['~standard'].jsonSchema.input({ target: 'draft-07' })`.
51
+ * 2. If the schema exposes a `toJSONSchema()` method (Zod v4), call it directly.
52
+ * 3. If the schema is a Zod v3 schema (`~standard.vendor === 'zod'`), use the
53
+ * injected `zodToJsonSchema()` function.
54
+ * 4. Otherwise throw a descriptive error.
55
+ */
56
+ export function schemaToJsonSchema(
57
+ schema: StandardSchemaV1,
58
+ options?: SchemaToJsonSchemaOptions,
59
+ ): Record<string, unknown> {
60
+ // 1. Standard JSON Schema V1
61
+ if (hasStandardJsonSchema(schema)) {
62
+ return schema["~standard"].jsonSchema.input({ target: "draft-07" });
63
+ }
64
+
65
+ // 2. Zod v4 native — exposes toJSONSchema() on the schema itself
66
+ if (typeof (schema as any).toJSONSchema === "function") {
67
+ return (schema as any).toJSONSchema() as Record<string, unknown>;
68
+ }
69
+
70
+ // 3. Zod v3 fallback
71
+ const vendor = schema["~standard"].vendor;
72
+ if (vendor === "zod" && options?.zodToJsonSchema) {
73
+ return options.zodToJsonSchema(schema, { $refStrategy: "none" });
74
+ }
75
+
76
+ throw new Error(
77
+ `Cannot convert schema to JSON Schema. The schema (vendor: "${vendor}") does not implement Standard JSON Schema V1 ` +
78
+ `and no zodToJsonSchema fallback is available. ` +
79
+ `Use a library that supports Standard JSON Schema (e.g., Zod 3.24+, Valibot v1+, ArkType v2+) ` +
80
+ `or pass a zodToJsonSchema function in options.`,
81
+ );
82
+ }
@@ -1,3 +1,5 @@
1
+ import type { ModelHostClass } from "./model-host";
2
+
1
3
  export type AnalyticsEvents = {
2
4
  "oss.runtime.instance_created": RuntimeInstanceCreatedInfo;
3
5
  "oss.runtime.copilot_request_created": {
@@ -7,13 +9,35 @@ export type AnalyticsEvents = {
7
9
  "cloud.public_api_key"?: string;
8
10
  "cloud.base_url"?: string;
9
11
  };
10
- "oss.runtime.server_action_executed": {};
11
- "oss.runtime.remote_action_executed": RemoteActionExecutionInfo;
12
12
  "oss.runtime.agent_execution_stream_started": { hashedLgcKey?: string };
13
13
  "oss.runtime.agent_execution_stream_ended": AgentExecutionResponseInfo;
14
- "oss.runtime.agent_execution_stream_errored": { hashedLgcKey?: string; error?: string };
14
+ "oss.runtime.agent_execution_stream_errored": {
15
+ hashedLgcKey?: string;
16
+ error?: string;
17
+ };
18
+ /**
19
+ * A managed Channel lost its gateway link. Carries only the cause we already
20
+ * compute for the log line — never the Channel name, which is a
21
+ * customer-chosen identifier, and never message content.
22
+ */
23
+ "oss.runtime.channel_session_dropped": ChannelSessionDroppedInfo;
24
+ /** A managed Channel's gateway link came back, and how long it was gone. */
25
+ "oss.runtime.channel_session_recovered": { downForMs: number };
15
26
  };
16
27
 
28
+ /**
29
+ * Kept identical to the v2 runtime's catalog in
30
+ * `packages/runtime/src/runtime/telemetry/events.ts`. The v1 entrypoint
31
+ * hands its capture scope to the V2 runtime it builds, so that scope has to
32
+ * accept every event the V2 runtime can send, channel events included.
33
+ */
34
+ export interface ChannelSessionDroppedInfo {
35
+ /** Diagnosis of the drop, e.g. `the gateway host answered HTTP 502`. */
36
+ reason?: string;
37
+ /** Transport/OS code when the transport named one, e.g. `ECONNRESET`. */
38
+ code?: string;
39
+ }
40
+
17
41
  export interface RuntimeInstanceCreatedInfo {
18
42
  actionsAmount: number;
19
43
  endpointTypes: string[];
@@ -25,14 +49,17 @@ export interface RuntimeInstanceCreatedInfo {
25
49
  "cloud.base_url"?: string;
26
50
  }
27
51
 
28
- export interface RemoteActionExecutionInfo {
29
- agentExecution: boolean;
30
- type: "self-hosted" | "langgraph-platform";
31
- agentsAmount?: number | null;
32
- hashedLgcKey?: string;
33
- }
34
-
35
52
  export interface AgentExecutionResponseInfo {
53
+ /**
54
+ * Which vendor the runtime actually sent the completion to, as a closed
55
+ * vocabulary — see `classifyModelHost`. Distinct from `provider` below,
56
+ * which the upstream reports as a model name and which cannot tell Azure,
57
+ * OpenRouter or a local server apart from OpenAI.
58
+ *
59
+ * `unknown` when the developer handed us an already-built model, because
60
+ * the endpoint is unrecoverable from one.
61
+ */
62
+ llmHostClass?: ModelHostClass;
36
63
  provider?: string;
37
64
  model?: string;
38
65
  langGraphHost?: string;
@@ -1 +1,9 @@
1
1
  export * from "./telemetry-client";
2
+ export * from "./sampling";
3
+ export {
4
+ firstNonBlankTelemetryId,
5
+ lambdaClient,
6
+ parseTelemetryIdFromLicense,
7
+ parseAndWarnTelemetryId,
8
+ } from "./lambda-client";
9
+ export type { LambdaSendOptions } from "./lambda-client";