@copilotkit/vue 1.57.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 (437) hide show
  1. package/AGENTS.md +50 -0
  2. package/CHANGELOG.md +13 -0
  3. package/PARITY.md +434 -0
  4. package/README.md +396 -0
  5. package/dist/components/copilot-provider/CopilotKit.vue.d.ts +20 -0
  6. package/dist/components/copilot-provider/CopilotKit.vue.d.ts.map +1 -0
  7. package/dist/components/copilot-provider/index.d.ts +3 -0
  8. package/dist/components/copilot-provider/index.d.ts.map +1 -0
  9. package/dist/components/copilot-provider/types.d.ts +22 -0
  10. package/dist/components/copilot-provider/types.d.ts.map +1 -0
  11. package/dist/hooks/index.d.ts +7 -0
  12. package/dist/hooks/index.d.ts.map +1 -0
  13. package/dist/hooks/use-copilot-action.d.ts +27 -0
  14. package/dist/hooks/use-copilot-action.d.ts.map +1 -0
  15. package/dist/hooks/use-copilot-readable.d.ts +20 -0
  16. package/dist/hooks/use-copilot-readable.d.ts.map +1 -0
  17. package/dist/hooks/use-frontend-tool.d.ts +21 -0
  18. package/dist/hooks/use-frontend-tool.d.ts.map +1 -0
  19. package/dist/index.cjs +2 -0
  20. package/dist/index.cjs.map +1 -0
  21. package/dist/index.d.cts +10 -0
  22. package/dist/index.d.mts +10 -0
  23. package/dist/index.d.ts +10 -0
  24. package/dist/index.d.ts.map +1 -0
  25. package/dist/index.mjs +252 -0
  26. package/dist/index.mjs.map +1 -0
  27. package/dist/styles.css +2 -0
  28. package/dist/use-render-activity-message-BRL1Rpl-.cjs +85 -0
  29. package/dist/use-render-activity-message-BRL1Rpl-.cjs.map +1 -0
  30. package/dist/use-render-activity-message-CqtxiFSs.js +8927 -0
  31. package/dist/use-render-activity-message-CqtxiFSs.js.map +1 -0
  32. package/dist/v2/components/A2UIMessageRenderer.d.ts +9 -0
  33. package/dist/v2/components/A2UIMessageRenderer.d.ts.map +1 -0
  34. package/dist/v2/components/A2UISurfaceActivityRenderer.vue.d.ts +16 -0
  35. package/dist/v2/components/A2UISurfaceActivityRenderer.vue.d.ts.map +1 -0
  36. package/dist/v2/components/CopilotKitInspector.vue.d.ts +7 -0
  37. package/dist/v2/components/CopilotKitInspector.vue.d.ts.map +1 -0
  38. package/dist/v2/components/InlineFeatureWarning.vue.d.ts +6 -0
  39. package/dist/v2/components/InlineFeatureWarning.vue.d.ts.map +1 -0
  40. package/dist/v2/components/LicenseWarningBanner.vue.d.ts +18 -0
  41. package/dist/v2/components/LicenseWarningBanner.vue.d.ts.map +1 -0
  42. package/dist/v2/components/MCPAppsActivityRenderer.d.ts +88 -0
  43. package/dist/v2/components/MCPAppsActivityRenderer.d.ts.map +1 -0
  44. package/dist/v2/components/OpenGenerativeUIRenderer.d.ts +154 -0
  45. package/dist/v2/components/OpenGenerativeUIRenderer.d.ts.map +1 -0
  46. package/dist/v2/components/a2ui/A2UIBuiltInToolCallRenderer.d.ts +19 -0
  47. package/dist/v2/components/a2ui/A2UIBuiltInToolCallRenderer.d.ts.map +1 -0
  48. package/dist/v2/components/a2ui/A2UICatalogContext.d.ts +16 -0
  49. package/dist/v2/components/a2ui/A2UICatalogContext.d.ts.map +1 -0
  50. package/dist/v2/components/a2ui/VueSurface.d.ts +62 -0
  51. package/dist/v2/components/a2ui/VueSurface.d.ts.map +1 -0
  52. package/dist/v2/components/a2ui/adapter.d.ts +38 -0
  53. package/dist/v2/components/a2ui/adapter.d.ts.map +1 -0
  54. package/dist/v2/components/a2ui/catalog.d.ts +29 -0
  55. package/dist/v2/components/a2ui/catalog.d.ts.map +1 -0
  56. package/dist/v2/components/a2ui/index.d.ts +5 -0
  57. package/dist/v2/components/a2ui/index.d.ts.map +1 -0
  58. package/dist/v2/components/a2ui/utils.d.ts +18 -0
  59. package/dist/v2/components/a2ui/utils.d.ts.map +1 -0
  60. package/dist/v2/components/a2ui.d.ts +12 -0
  61. package/dist/v2/components/a2ui.d.ts.map +1 -0
  62. package/dist/v2/components/chat/CopilotChat.vue.d.ts +50 -0
  63. package/dist/v2/components/chat/CopilotChat.vue.d.ts.map +1 -0
  64. package/dist/v2/components/chat/CopilotChatAssistantMessage.vue.d.ts +164 -0
  65. package/dist/v2/components/chat/CopilotChatAssistantMessage.vue.d.ts.map +1 -0
  66. package/dist/v2/components/chat/CopilotChatAttachmentQueue.vue.d.ts +12 -0
  67. package/dist/v2/components/chat/CopilotChatAttachmentQueue.vue.d.ts.map +1 -0
  68. package/dist/v2/components/chat/CopilotChatAttachmentRenderer.vue.d.ts +7 -0
  69. package/dist/v2/components/chat/CopilotChatAttachmentRenderer.vue.d.ts.map +1 -0
  70. package/dist/v2/components/chat/CopilotChatAudioRecorder.vue.d.ts +12 -0
  71. package/dist/v2/components/chat/CopilotChatAudioRecorder.vue.d.ts.map +1 -0
  72. package/dist/v2/components/chat/CopilotChatInput.vue.d.ts +290 -0
  73. package/dist/v2/components/chat/CopilotChatInput.vue.d.ts.map +1 -0
  74. package/dist/v2/components/chat/CopilotChatMessageView.vue.d.ts +72 -0
  75. package/dist/v2/components/chat/CopilotChatMessageView.vue.d.ts.map +1 -0
  76. package/dist/v2/components/chat/CopilotChatReasoningMessage.vue.d.ts +65 -0
  77. package/dist/v2/components/chat/CopilotChatReasoningMessage.vue.d.ts.map +1 -0
  78. package/dist/v2/components/chat/CopilotChatSuggestionPill.vue.d.ts +27 -0
  79. package/dist/v2/components/chat/CopilotChatSuggestionPill.vue.d.ts.map +1 -0
  80. package/dist/v2/components/chat/CopilotChatSuggestionView.vue.d.ts +26 -0
  81. package/dist/v2/components/chat/CopilotChatSuggestionView.vue.d.ts.map +1 -0
  82. package/dist/v2/components/chat/CopilotChatToggleButton.vue.d.ts +17 -0
  83. package/dist/v2/components/chat/CopilotChatToggleButton.vue.d.ts.map +1 -0
  84. package/dist/v2/components/chat/CopilotChatToggleButtonCloseIcon.d.ts +5 -0
  85. package/dist/v2/components/chat/CopilotChatToggleButtonCloseIcon.d.ts.map +1 -0
  86. package/dist/v2/components/chat/CopilotChatToggleButtonOpenIcon.d.ts +5 -0
  87. package/dist/v2/components/chat/CopilotChatToggleButtonOpenIcon.d.ts.map +1 -0
  88. package/dist/v2/components/chat/CopilotChatToolCallsView.vue.d.ts +21 -0
  89. package/dist/v2/components/chat/CopilotChatToolCallsView.vue.d.ts.map +1 -0
  90. package/dist/v2/components/chat/CopilotChatUserMessage.vue.d.ts +34 -0
  91. package/dist/v2/components/chat/CopilotChatUserMessage.vue.d.ts.map +1 -0
  92. package/dist/v2/components/chat/CopilotChatView.vue.d.ts +106 -0
  93. package/dist/v2/components/chat/CopilotChatView.vue.d.ts.map +1 -0
  94. package/dist/v2/components/chat/CopilotModalHeader.vue.d.ts +15 -0
  95. package/dist/v2/components/chat/CopilotModalHeader.vue.d.ts.map +1 -0
  96. package/dist/v2/components/chat/CopilotModalHeaderCloseButton.d.ts +5 -0
  97. package/dist/v2/components/chat/CopilotModalHeaderCloseButton.d.ts.map +1 -0
  98. package/dist/v2/components/chat/CopilotModalHeaderTitle.d.ts +5 -0
  99. package/dist/v2/components/chat/CopilotModalHeaderTitle.d.ts.map +1 -0
  100. package/dist/v2/components/chat/CopilotPopup.vue.d.ts +50 -0
  101. package/dist/v2/components/chat/CopilotPopup.vue.d.ts.map +1 -0
  102. package/dist/v2/components/chat/CopilotPopupView.vue.d.ts +55 -0
  103. package/dist/v2/components/chat/CopilotPopupView.vue.d.ts.map +1 -0
  104. package/dist/v2/components/chat/CopilotPopupViewInternal.vue.d.ts +55 -0
  105. package/dist/v2/components/chat/CopilotPopupViewInternal.vue.d.ts.map +1 -0
  106. package/dist/v2/components/chat/CopilotPopupWelcomeScreen.vue.d.ts +28 -0
  107. package/dist/v2/components/chat/CopilotPopupWelcomeScreen.vue.d.ts.map +1 -0
  108. package/dist/v2/components/chat/CopilotSidebar.vue.d.ts +48 -0
  109. package/dist/v2/components/chat/CopilotSidebar.vue.d.ts.map +1 -0
  110. package/dist/v2/components/chat/CopilotSidebarView.vue.d.ts +62 -0
  111. package/dist/v2/components/chat/CopilotSidebarView.vue.d.ts.map +1 -0
  112. package/dist/v2/components/chat/CopilotSidebarViewInternal.vue.d.ts +53 -0
  113. package/dist/v2/components/chat/CopilotSidebarViewInternal.vue.d.ts.map +1 -0
  114. package/dist/v2/components/chat/CopilotSidebarWelcomeScreen.vue.d.ts +28 -0
  115. package/dist/v2/components/chat/CopilotSidebarWelcomeScreen.vue.d.ts.map +1 -0
  116. package/dist/v2/components/chat/audioRecorder.d.ts +11 -0
  117. package/dist/v2/components/chat/audioRecorder.d.ts.map +1 -0
  118. package/dist/v2/components/chat/index.d.ts +682 -0
  119. package/dist/v2/components/chat/index.d.ts.map +1 -0
  120. package/dist/v2/components/chat/last-user-message-context.d.ts +29 -0
  121. package/dist/v2/components/chat/last-user-message-context.d.ts.map +1 -0
  122. package/dist/v2/components/chat/normalize-auto-scroll.d.ts +3 -0
  123. package/dist/v2/components/chat/normalize-auto-scroll.d.ts.map +1 -0
  124. package/dist/v2/components/chat/types.d.ts +380 -0
  125. package/dist/v2/components/chat/types.d.ts.map +1 -0
  126. package/dist/v2/components/icons/index.d.ts +2 -0
  127. package/dist/v2/components/icons/index.d.ts.map +1 -0
  128. package/dist/v2/components/index.d.ts +8 -0
  129. package/dist/v2/components/index.d.ts.map +1 -0
  130. package/dist/v2/hooks/index.d.ts +24 -0
  131. package/dist/v2/hooks/index.d.ts.map +1 -0
  132. package/dist/v2/hooks/use-agent-context.d.ts +24 -0
  133. package/dist/v2/hooks/use-agent-context.d.ts.map +1 -0
  134. package/dist/v2/hooks/use-agent.d.ts +53 -0
  135. package/dist/v2/hooks/use-agent.d.ts.map +1 -0
  136. package/dist/v2/hooks/use-attachments.d.ts +21 -0
  137. package/dist/v2/hooks/use-attachments.d.ts.map +1 -0
  138. package/dist/v2/hooks/use-capabilities.d.ts +16 -0
  139. package/dist/v2/hooks/use-capabilities.d.ts.map +1 -0
  140. package/dist/v2/hooks/use-component.d.ts +13 -0
  141. package/dist/v2/hooks/use-component.d.ts.map +1 -0
  142. package/dist/v2/hooks/use-configure-suggestions.d.ts +24 -0
  143. package/dist/v2/hooks/use-configure-suggestions.d.ts.map +1 -0
  144. package/dist/v2/hooks/use-default-render-tool.d.ts +14 -0
  145. package/dist/v2/hooks/use-default-render-tool.d.ts.map +1 -0
  146. package/dist/v2/hooks/use-frontend-tool.d.ts +19 -0
  147. package/dist/v2/hooks/use-frontend-tool.d.ts.map +1 -0
  148. package/dist/v2/hooks/use-human-in-the-loop.d.ts +19 -0
  149. package/dist/v2/hooks/use-human-in-the-loop.d.ts.map +1 -0
  150. package/dist/v2/hooks/use-interrupt.d.ts +36 -0
  151. package/dist/v2/hooks/use-interrupt.d.ts.map +1 -0
  152. package/dist/v2/hooks/use-katex-styles.d.ts +22 -0
  153. package/dist/v2/hooks/use-katex-styles.d.ts.map +1 -0
  154. package/dist/v2/hooks/use-keyboard-height.d.ts +33 -0
  155. package/dist/v2/hooks/use-keyboard-height.d.ts.map +1 -0
  156. package/dist/v2/hooks/use-pin-to-send.d.ts +28 -0
  157. package/dist/v2/hooks/use-pin-to-send.d.ts.map +1 -0
  158. package/dist/v2/hooks/use-render-activity-message.d.ts +21 -0
  159. package/dist/v2/hooks/use-render-activity-message.d.ts.map +1 -0
  160. package/dist/v2/hooks/use-render-custom-messages.d.ts +27 -0
  161. package/dist/v2/hooks/use-render-custom-messages.d.ts.map +1 -0
  162. package/dist/v2/hooks/use-render-tool.d.ts +36 -0
  163. package/dist/v2/hooks/use-render-tool.d.ts.map +1 -0
  164. package/dist/v2/hooks/use-suggestions.d.ts +26 -0
  165. package/dist/v2/hooks/use-suggestions.d.ts.map +1 -0
  166. package/dist/v2/hooks/use-threads.d.ts +42 -0
  167. package/dist/v2/hooks/use-threads.d.ts.map +1 -0
  168. package/dist/v2/index.cjs +2 -0
  169. package/dist/v2/index.cjs.map +1 -0
  170. package/dist/v2/index.d.cts +9 -0
  171. package/dist/v2/index.d.mts +9 -0
  172. package/dist/v2/index.d.ts +9 -0
  173. package/dist/v2/index.d.ts.map +1 -0
  174. package/dist/v2/index.mjs +75 -0
  175. package/dist/v2/index.mjs.map +1 -0
  176. package/dist/v2/lib/processPartialHtml.d.ts +3 -0
  177. package/dist/v2/lib/processPartialHtml.d.ts.map +1 -0
  178. package/dist/v2/lib/shallow-stable.d.ts +7 -0
  179. package/dist/v2/lib/shallow-stable.d.ts.map +1 -0
  180. package/dist/v2/lib/transcription-client.d.ts +19 -0
  181. package/dist/v2/lib/transcription-client.d.ts.map +1 -0
  182. package/dist/v2/lib/vue-core.d.ts +47 -0
  183. package/dist/v2/lib/vue-core.d.ts.map +1 -0
  184. package/dist/v2/providers/CopilotChatConfigurationProvider.types.d.ts +15 -0
  185. package/dist/v2/providers/CopilotChatConfigurationProvider.types.d.ts.map +1 -0
  186. package/dist/v2/providers/CopilotChatConfigurationProvider.vue.d.ts +17 -0
  187. package/dist/v2/providers/CopilotChatConfigurationProvider.vue.d.ts.map +1 -0
  188. package/dist/v2/providers/CopilotKitProvider.types.d.ts +61 -0
  189. package/dist/v2/providers/CopilotKitProvider.types.d.ts.map +1 -0
  190. package/dist/v2/providers/CopilotKitProvider.vue.d.ts +37 -0
  191. package/dist/v2/providers/CopilotKitProvider.vue.d.ts.map +1 -0
  192. package/dist/v2/providers/SandboxFunctionsContext.d.ts +4 -0
  193. package/dist/v2/providers/SandboxFunctionsContext.d.ts.map +1 -0
  194. package/dist/v2/providers/index.d.ts +13 -0
  195. package/dist/v2/providers/index.d.ts.map +1 -0
  196. package/dist/v2/providers/keys.d.ts +17 -0
  197. package/dist/v2/providers/keys.d.ts.map +1 -0
  198. package/dist/v2/providers/license-context.d.ts +7 -0
  199. package/dist/v2/providers/license-context.d.ts.map +1 -0
  200. package/dist/v2/providers/types.d.ts +38 -0
  201. package/dist/v2/providers/types.d.ts.map +1 -0
  202. package/dist/v2/providers/useCopilotChatConfiguration.d.ts +4 -0
  203. package/dist/v2/providers/useCopilotChatConfiguration.d.ts.map +1 -0
  204. package/dist/v2/providers/useCopilotKit.d.ts +2 -0
  205. package/dist/v2/providers/useCopilotKit.d.ts.map +1 -0
  206. package/dist/v2/providers/useLicenseContext.d.ts +14 -0
  207. package/dist/v2/providers/useLicenseContext.d.ts.map +1 -0
  208. package/dist/v2/types/a2ui.d.ts +5 -0
  209. package/dist/v2/types/a2ui.d.ts.map +1 -0
  210. package/dist/v2/types/defineToolCallRenderer.d.ts +15 -0
  211. package/dist/v2/types/defineToolCallRenderer.d.ts.map +1 -0
  212. package/dist/v2/types/frontend-tool.d.ts +6 -0
  213. package/dist/v2/types/frontend-tool.d.ts.map +1 -0
  214. package/dist/v2/types/human-in-the-loop.d.ts +29 -0
  215. package/dist/v2/types/human-in-the-loop.d.ts.map +1 -0
  216. package/dist/v2/types/index.d.ts +10 -0
  217. package/dist/v2/types/index.d.ts.map +1 -0
  218. package/dist/v2/types/interrupt.d.ts +14 -0
  219. package/dist/v2/types/interrupt.d.ts.map +1 -0
  220. package/dist/v2/types/sandbox-function.d.ts +8 -0
  221. package/dist/v2/types/sandbox-function.d.ts.map +1 -0
  222. package/dist/v2/types/vue-activity-message-renderer.d.ts +18 -0
  223. package/dist/v2/types/vue-activity-message-renderer.d.ts.map +1 -0
  224. package/dist/v2/types/vue-custom-message-renderer.d.ts +19 -0
  225. package/dist/v2/types/vue-custom-message-renderer.d.ts.map +1 -0
  226. package/dist/v2/types/vue-tool-call-renderer.d.ts +37 -0
  227. package/dist/v2/types/vue-tool-call-renderer.d.ts.map +1 -0
  228. package/env.d.ts +7 -0
  229. package/eslint.config.mjs +42 -0
  230. package/package.json +130 -0
  231. package/scripts/scope-preflight.mjs +100 -0
  232. package/src/components/copilot-provider/CopilotKit.vue +18 -0
  233. package/src/components/copilot-provider/index.ts +2 -0
  234. package/src/components/copilot-provider/types.ts +24 -0
  235. package/src/hooks/index.ts +9 -0
  236. package/src/hooks/use-copilot-action.ts +168 -0
  237. package/src/hooks/use-copilot-readable.ts +75 -0
  238. package/src/hooks/use-frontend-tool.ts +76 -0
  239. package/src/index.ts +12 -0
  240. package/src/styles/globals.css +314 -0
  241. package/src/v2/__tests__/exports.test.ts +35 -0
  242. package/src/v2/__tests__/mocks/web-inspector.ts +5 -0
  243. package/src/v2/__tests__/setup.ts +141 -0
  244. package/src/v2/__tests__/utils/agents.ts +391 -0
  245. package/src/v2/__tests__/utils/mount.ts +83 -0
  246. package/src/v2/__tests__/utils/test-helpers.ts +712 -0
  247. package/src/v2/components/A2UIMessageRenderer.ts +125 -0
  248. package/src/v2/components/A2UISurfaceActivityRenderer.vue +186 -0
  249. package/src/v2/components/CopilotKitInspector.vue +42 -0
  250. package/src/v2/components/InlineFeatureWarning.vue +35 -0
  251. package/src/v2/components/LicenseWarningBanner.vue +196 -0
  252. package/src/v2/components/MCPAppsActivityRenderer.ts +778 -0
  253. package/src/v2/components/OpenGenerativeUIRenderer.ts +550 -0
  254. package/src/v2/components/__tests__/A2UIMessageRenderer.test.ts +271 -0
  255. package/src/v2/components/__tests__/CopilotKitInspector.test.ts +57 -0
  256. package/src/v2/components/__tests__/MCPAppsActivityRenderer.e2e.test.ts +851 -0
  257. package/src/v2/components/__tests__/MCPAppsActivityRenderer.test.ts +237 -0
  258. package/src/v2/components/__tests__/OpenGenerativeUIRenderer.test.ts +516 -0
  259. package/src/v2/components/a2ui/A2UIBuiltInToolCallRenderer.ts +295 -0
  260. package/src/v2/components/a2ui/A2UICatalogContext.ts +190 -0
  261. package/src/v2/components/a2ui/VueSurface.ts +144 -0
  262. package/src/v2/components/a2ui/adapter.ts +156 -0
  263. package/src/v2/components/a2ui/catalog.ts +858 -0
  264. package/src/v2/components/a2ui/index.ts +7 -0
  265. package/src/v2/components/a2ui/utils.ts +67 -0
  266. package/src/v2/components/a2ui.ts +30 -0
  267. package/src/v2/components/chat/CopilotChat.vue +777 -0
  268. package/src/v2/components/chat/CopilotChatAssistantMessage.vue +891 -0
  269. package/src/v2/components/chat/CopilotChatAttachmentQueue.vue +411 -0
  270. package/src/v2/components/chat/CopilotChatAttachmentRenderer.vue +87 -0
  271. package/src/v2/components/chat/CopilotChatAudioRecorder.vue +269 -0
  272. package/src/v2/components/chat/CopilotChatInput.vue +1271 -0
  273. package/src/v2/components/chat/CopilotChatMessageView.vue +476 -0
  274. package/src/v2/components/chat/CopilotChatReasoningMessage.vue +247 -0
  275. package/src/v2/components/chat/CopilotChatSuggestionPill.vue +56 -0
  276. package/src/v2/components/chat/CopilotChatSuggestionView.vue +93 -0
  277. package/src/v2/components/chat/CopilotChatToggleButton.vue +145 -0
  278. package/src/v2/components/chat/CopilotChatToggleButtonCloseIcon.ts +17 -0
  279. package/src/v2/components/chat/CopilotChatToggleButtonOpenIcon.ts +18 -0
  280. package/src/v2/components/chat/CopilotChatToolCallsView.vue +161 -0
  281. package/src/v2/components/chat/CopilotChatUserMessage.vue +322 -0
  282. package/src/v2/components/chat/CopilotChatView.vue +740 -0
  283. package/src/v2/components/chat/CopilotModalHeader.vue +73 -0
  284. package/src/v2/components/chat/CopilotModalHeaderCloseButton.ts +38 -0
  285. package/src/v2/components/chat/CopilotModalHeaderTitle.ts +22 -0
  286. package/src/v2/components/chat/CopilotPopup.vue +182 -0
  287. package/src/v2/components/chat/CopilotPopupView.vue +168 -0
  288. package/src/v2/components/chat/CopilotPopupViewInternal.vue +453 -0
  289. package/src/v2/components/chat/CopilotPopupWelcomeScreen.vue +140 -0
  290. package/src/v2/components/chat/CopilotSidebar.vue +178 -0
  291. package/src/v2/components/chat/CopilotSidebarView.vue +172 -0
  292. package/src/v2/components/chat/CopilotSidebarViewInternal.vue +366 -0
  293. package/src/v2/components/chat/CopilotSidebarWelcomeScreen.vue +142 -0
  294. package/src/v2/components/chat/__tests__/CopilotChat.attachments.test.ts +237 -0
  295. package/src/v2/components/chat/__tests__/CopilotChat.e2e.test.ts +1240 -0
  296. package/src/v2/components/chat/__tests__/CopilotChat.licenseWarning.test.ts +138 -0
  297. package/src/v2/components/chat/__tests__/CopilotChat.onError.test.ts +85 -0
  298. package/src/v2/components/chat/__tests__/CopilotChat.slots.e2e.test.ts +141 -0
  299. package/src/v2/components/chat/__tests__/CopilotChat.test.ts +652 -0
  300. package/src/v2/components/chat/__tests__/CopilotChatActivityRendering.e2e.test.ts +683 -0
  301. package/src/v2/components/chat/__tests__/CopilotChatAssistantMessage.slots.e2e.test.ts +768 -0
  302. package/src/v2/components/chat/__tests__/CopilotChatAssistantMessage.test.ts +1108 -0
  303. package/src/v2/components/chat/__tests__/CopilotChatAssistantMessage.thumbs.test.ts +87 -0
  304. package/src/v2/components/chat/__tests__/CopilotChatAttachmentQueue.test.ts +277 -0
  305. package/src/v2/components/chat/__tests__/CopilotChatAttachmentRenderer.test.ts +124 -0
  306. package/src/v2/components/chat/__tests__/CopilotChatCopyButton.clipboard.test.ts +230 -0
  307. package/src/v2/components/chat/__tests__/CopilotChatInput.bottomAnchored.test.ts +83 -0
  308. package/src/v2/components/chat/__tests__/CopilotChatInput.slots.e2e.test.ts +1139 -0
  309. package/src/v2/components/chat/__tests__/CopilotChatInput.test.ts +1051 -0
  310. package/src/v2/components/chat/__tests__/CopilotChatMessageView.slots.e2e.test.ts +141 -0
  311. package/src/v2/components/chat/__tests__/CopilotChatMessageView.test.ts +494 -0
  312. package/src/v2/components/chat/__tests__/CopilotChatPropsRerender.e2e.test.ts +181 -0
  313. package/src/v2/components/chat/__tests__/CopilotChatReasoningMessage.test.ts +73 -0
  314. package/src/v2/components/chat/__tests__/CopilotChatSuggestionPill.test.ts +73 -0
  315. package/src/v2/components/chat/__tests__/CopilotChatSuggestionView.slots.e2e.test.ts +674 -0
  316. package/src/v2/components/chat/__tests__/CopilotChatSuggestionView.test.ts +91 -0
  317. package/src/v2/components/chat/__tests__/CopilotChatToggleButton.test.ts +93 -0
  318. package/src/v2/components/chat/__tests__/CopilotChatToolCallsView.test.ts +382 -0
  319. package/src/v2/components/chat/__tests__/CopilotChatToolRendering.e2e.test.ts +1019 -0
  320. package/src/v2/components/chat/__tests__/CopilotChatToolRerenders.e2e.test.ts +516 -0
  321. package/src/v2/components/chat/__tests__/CopilotChatUserMessage.slots.e2e.test.ts +701 -0
  322. package/src/v2/components/chat/__tests__/CopilotChatUserMessage.test.ts +337 -0
  323. package/src/v2/components/chat/__tests__/CopilotChatView.connectingGate.test.ts +135 -0
  324. package/src/v2/components/chat/__tests__/CopilotChatView.inputOverlay.test.ts +278 -0
  325. package/src/v2/components/chat/__tests__/CopilotChatView.onClick.e2e.test.ts +1082 -0
  326. package/src/v2/components/chat/__tests__/CopilotChatView.pinToSend.test.ts +166 -0
  327. package/src/v2/components/chat/__tests__/CopilotChatView.slots.e2e.test.ts +1145 -0
  328. package/src/v2/components/chat/__tests__/CopilotChatView.test.ts +374 -0
  329. package/src/v2/components/chat/__tests__/CopilotModalHeader.slots.e2e.test.ts +636 -0
  330. package/src/v2/components/chat/__tests__/CopilotModalHeader.test.ts +112 -0
  331. package/src/v2/components/chat/__tests__/CopilotPopup.test.ts +58 -0
  332. package/src/v2/components/chat/__tests__/CopilotPopupView.slots.e2e.test.ts +725 -0
  333. package/src/v2/components/chat/__tests__/CopilotPopupView.test.ts +112 -0
  334. package/src/v2/components/chat/__tests__/CopilotSidebar.test.ts +58 -0
  335. package/src/v2/components/chat/__tests__/CopilotSidebarView.slots.e2e.test.ts +603 -0
  336. package/src/v2/components/chat/__tests__/CopilotSidebarView.test.ts +214 -0
  337. package/src/v2/components/chat/__tests__/MCPAppsUiMessage.e2e.test.ts +394 -0
  338. package/src/v2/components/chat/__tests__/copilot-chat-throttle.test.ts +82 -0
  339. package/src/v2/components/chat/__tests__/normalize-auto-scroll.test.ts +39 -0
  340. package/src/v2/components/chat/audioRecorder.ts +15 -0
  341. package/src/v2/components/chat/index.ts +52 -0
  342. package/src/v2/components/chat/last-user-message-context.ts +39 -0
  343. package/src/v2/components/chat/normalize-auto-scroll.ts +17 -0
  344. package/src/v2/components/chat/types.ts +481 -0
  345. package/src/v2/components/icons/__tests__/icons.test.ts +86 -0
  346. package/src/v2/components/icons/index.ts +22 -0
  347. package/src/v2/components/index.ts +7 -0
  348. package/src/v2/hooks/__tests__/standard-schema-types.test.ts +149 -0
  349. package/src/v2/hooks/__tests__/standard-schema.test.ts +315 -0
  350. package/src/v2/hooks/__tests__/use-agent-context-timing.e2e.test.ts +144 -0
  351. package/src/v2/hooks/__tests__/use-agent-context.test.ts +271 -0
  352. package/src/v2/hooks/__tests__/use-agent-error-state.test.ts +64 -0
  353. package/src/v2/hooks/__tests__/use-agent-stability.test.ts +268 -0
  354. package/src/v2/hooks/__tests__/use-agent-thread-isolation.test.ts +433 -0
  355. package/src/v2/hooks/__tests__/use-agent-throttle.test.ts +747 -0
  356. package/src/v2/hooks/__tests__/use-agent.e2e.test.ts +187 -0
  357. package/src/v2/hooks/__tests__/use-agent.test.ts +126 -0
  358. package/src/v2/hooks/__tests__/use-attachments.test.ts +181 -0
  359. package/src/v2/hooks/__tests__/use-component.test.ts +145 -0
  360. package/src/v2/hooks/__tests__/use-configure-suggestions.e2e.test.ts +527 -0
  361. package/src/v2/hooks/__tests__/use-configure-suggestions.test.ts +399 -0
  362. package/src/v2/hooks/__tests__/use-default-render-tool.test.ts +214 -0
  363. package/src/v2/hooks/__tests__/use-frontend-tool-available.test.ts +220 -0
  364. package/src/v2/hooks/__tests__/use-frontend-tool.e2e.test.ts +2320 -0
  365. package/src/v2/hooks/__tests__/use-frontend-tool.test.ts +648 -0
  366. package/src/v2/hooks/__tests__/use-human-in-the-loop.e2e.test.ts +1379 -0
  367. package/src/v2/hooks/__tests__/use-human-in-the-loop.test.ts +282 -0
  368. package/src/v2/hooks/__tests__/use-interrupt.test.ts +345 -0
  369. package/src/v2/hooks/__tests__/use-katex-styles.test.ts +69 -0
  370. package/src/v2/hooks/__tests__/use-keyboard-height.test.ts +199 -0
  371. package/src/v2/hooks/__tests__/use-pin-to-send.test.ts +363 -0
  372. package/src/v2/hooks/__tests__/use-render-tool.test.ts +329 -0
  373. package/src/v2/hooks/__tests__/use-suggestions.e2e.test.ts +397 -0
  374. package/src/v2/hooks/__tests__/use-suggestions.test.ts +198 -0
  375. package/src/v2/hooks/__tests__/use-threads.test.ts +1041 -0
  376. package/src/v2/hooks/__tests__/zod-regression.test.ts +339 -0
  377. package/src/v2/hooks/index.ts +29 -0
  378. package/src/v2/hooks/use-agent-context.ts +55 -0
  379. package/src/v2/hooks/use-agent.ts +345 -0
  380. package/src/v2/hooks/use-attachments.ts +261 -0
  381. package/src/v2/hooks/use-capabilities.ts +30 -0
  382. package/src/v2/hooks/use-component.ts +46 -0
  383. package/src/v2/hooks/use-configure-suggestions.ts +252 -0
  384. package/src/v2/hooks/use-default-render-tool.ts +130 -0
  385. package/src/v2/hooks/use-frontend-tool.ts +68 -0
  386. package/src/v2/hooks/use-human-in-the-loop.ts +90 -0
  387. package/src/v2/hooks/use-interrupt.ts +257 -0
  388. package/src/v2/hooks/use-katex-styles.ts +44 -0
  389. package/src/v2/hooks/use-keyboard-height.ts +87 -0
  390. package/src/v2/hooks/use-pin-to-send.ts +160 -0
  391. package/src/v2/hooks/use-render-activity-message.ts +92 -0
  392. package/src/v2/hooks/use-render-custom-messages.ts +129 -0
  393. package/src/v2/hooks/use-render-tool.ts +128 -0
  394. package/src/v2/hooks/use-suggestions.ts +98 -0
  395. package/src/v2/hooks/use-threads.ts +208 -0
  396. package/src/v2/index.ts +11 -0
  397. package/src/v2/lib/__tests__/processPartialHtml.test.ts +84 -0
  398. package/src/v2/lib/__tests__/transcription-client.test.ts +65 -0
  399. package/src/v2/lib/processPartialHtml.ts +21 -0
  400. package/src/v2/lib/shallow-stable.ts +54 -0
  401. package/src/v2/lib/transcription-client.ts +151 -0
  402. package/src/v2/lib/vue-core.ts +161 -0
  403. package/src/v2/providers/CopilotChatConfigurationProvider.types.ts +15 -0
  404. package/src/v2/providers/CopilotChatConfigurationProvider.vue +95 -0
  405. package/src/v2/providers/CopilotKitProvider.types.ts +66 -0
  406. package/src/v2/providers/CopilotKitProvider.vue +653 -0
  407. package/src/v2/providers/SandboxFunctionsContext.ts +11 -0
  408. package/src/v2/providers/__tests__/CopilotChatConfigurationProvider.test.ts +309 -0
  409. package/src/v2/providers/__tests__/CopilotKitProvider.debug.test.ts +295 -0
  410. package/src/v2/providers/__tests__/CopilotKitProvider.license.test.ts +110 -0
  411. package/src/v2/providers/__tests__/CopilotKitProvider.onError.test.ts +67 -0
  412. package/src/v2/providers/__tests__/CopilotKitProvider.renderCustomMessages.e2e.test.ts +901 -0
  413. package/src/v2/providers/__tests__/CopilotKitProvider.sandboxFunctions.test.ts +141 -0
  414. package/src/v2/providers/__tests__/CopilotKitProvider.stability.test.ts +871 -0
  415. package/src/v2/providers/__tests__/CopilotKitProvider.test.ts +603 -0
  416. package/src/v2/providers/__tests__/CopilotKitProvider.wildcard.test.ts +104 -0
  417. package/src/v2/providers/index.ts +21 -0
  418. package/src/v2/providers/keys.ts +25 -0
  419. package/src/v2/providers/license-context.ts +16 -0
  420. package/src/v2/providers/types.ts +40 -0
  421. package/src/v2/providers/useCopilotChatConfiguration.ts +11 -0
  422. package/src/v2/providers/useCopilotKit.ts +11 -0
  423. package/src/v2/providers/useLicenseContext.ts +21 -0
  424. package/src/v2/types/__tests__/defineToolCallRenderer.test.ts +157 -0
  425. package/src/v2/types/a2ui.ts +5 -0
  426. package/src/v2/types/defineToolCallRenderer.ts +32 -0
  427. package/src/v2/types/frontend-tool.ts +8 -0
  428. package/src/v2/types/human-in-the-loop.ts +38 -0
  429. package/src/v2/types/index.ts +9 -0
  430. package/src/v2/types/interrupt.ts +15 -0
  431. package/src/v2/types/sandbox-function.ts +8 -0
  432. package/src/v2/types/vue-activity-message-renderer.ts +22 -0
  433. package/src/v2/types/vue-custom-message-renderer.ts +24 -0
  434. package/src/v2/types/vue-tool-call-renderer.ts +44 -0
  435. package/tsconfig.json +27 -0
  436. package/vite.config.ts +49 -0
  437. package/vitest.config.ts +23 -0
@@ -0,0 +1,871 @@
1
+ import { cleanup, render } from "@testing-library/vue";
2
+ import { defineComponent, nextTick, ref, watchEffect } from "vue";
3
+ import type { Component, PropType } from "vue";
4
+ import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
5
+ import { z } from "zod";
6
+ import type { VueFrontendTool } from "../../types";
7
+ import type { CopilotKitCoreVue } from "../../lib/vue-core";
8
+ import CopilotKitProvider from "../CopilotKitProvider.vue";
9
+ import { useCopilotKit } from "../useCopilotKit";
10
+ import type { CopilotKitContextValue } from "../keys";
11
+ import { useFrontendTool } from "../../hooks/use-frontend-tool";
12
+
13
+ let consoleErrorSpy: ReturnType<typeof vi.spyOn>;
14
+ let consoleWarnSpy: ReturnType<typeof vi.spyOn>;
15
+
16
+ function renderProvider(args: {
17
+ child: Component;
18
+ frontendTools?: VueFrontendTool[];
19
+ runtimeUrl?: string;
20
+ }) {
21
+ const Host = defineComponent({
22
+ components: {
23
+ CopilotKitProvider,
24
+ ChildComponent: args.child,
25
+ },
26
+ props: {
27
+ frontendTools: {
28
+ type: Array as PropType<VueFrontendTool[]>,
29
+ required: false,
30
+ },
31
+ runtimeUrl: {
32
+ type: String,
33
+ required: false,
34
+ },
35
+ },
36
+ template: `
37
+ <CopilotKitProvider :runtime-url="runtimeUrl" :frontend-tools="frontendTools">
38
+ <ChildComponent />
39
+ </CopilotKitProvider>
40
+ `,
41
+ });
42
+
43
+ return render(Host, {
44
+ props: {
45
+ frontendTools: args.frontendTools,
46
+ runtimeUrl: args.runtimeUrl,
47
+ },
48
+ });
49
+ }
50
+
51
+ describe("CopilotKitProvider stability", () => {
52
+ const originalFetch = global.fetch;
53
+
54
+ beforeEach(() => {
55
+ consoleErrorSpy = vi.spyOn(console, "error").mockImplementation(() => {});
56
+ consoleWarnSpy = vi.spyOn(console, "warn").mockImplementation(() => {});
57
+ });
58
+
59
+ afterEach(() => {
60
+ cleanup();
61
+ consoleErrorSpy.mockRestore();
62
+ consoleWarnSpy.mockRestore();
63
+ global.fetch = originalFetch;
64
+ });
65
+
66
+ describe("instance stability", () => {
67
+ it("returns the same copilotkit instance after re-render with new renderToolCalls array", async () => {
68
+ const instances: CopilotKitCoreVue[] = [];
69
+
70
+ const Collector = defineComponent({
71
+ setup() {
72
+ const { copilotkit } = useCopilotKit();
73
+ watchEffect(() => {
74
+ instances.push(copilotkit.value);
75
+ });
76
+ return () => null;
77
+ },
78
+ });
79
+
80
+ const Renderer1 = defineComponent({ template: "<div>Tool 1</div>" });
81
+ const Renderer2 = defineComponent({
82
+ template: "<div>Tool 1 updated</div>",
83
+ });
84
+
85
+ const renderToolCalls1: VueFrontendTool[] = [
86
+ {
87
+ name: "tool1",
88
+ description: "Tool 1",
89
+ parameters: z.object({ a: z.string() }),
90
+ render: Renderer1,
91
+ },
92
+ ];
93
+
94
+ const renderToolCalls2: VueFrontendTool[] = [
95
+ {
96
+ name: "tool1",
97
+ description: "Tool 1",
98
+ parameters: z.object({ a: z.string() }),
99
+ render: Renderer2,
100
+ },
101
+ ];
102
+
103
+ const view = renderProvider({
104
+ child: Collector,
105
+ runtimeUrl: "/api/copilotkit",
106
+ frontendTools: renderToolCalls1,
107
+ });
108
+
109
+ await nextTick();
110
+ await view.rerender({
111
+ runtimeUrl: "/api/copilotkit",
112
+ frontendTools: renderToolCalls2,
113
+ });
114
+ await nextTick();
115
+
116
+ expect(instances.length).toBeGreaterThanOrEqual(2);
117
+ const first = instances[0];
118
+ for (const instance of instances) {
119
+ expect(instance).toBe(first);
120
+ }
121
+ });
122
+
123
+ it("returns the same copilotkit instance after re-render with new frontendTools array", async () => {
124
+ const instances: CopilotKitCoreVue[] = [];
125
+
126
+ const Collector = defineComponent({
127
+ setup() {
128
+ const { copilotkit } = useCopilotKit();
129
+ watchEffect(() => {
130
+ instances.push(copilotkit.value);
131
+ });
132
+ return () => null;
133
+ },
134
+ });
135
+
136
+ const tools1: VueFrontendTool[] = [
137
+ { name: "toolA", description: "Tool A", handler: vi.fn() },
138
+ ];
139
+ const tools2: VueFrontendTool[] = [
140
+ { name: "toolB", description: "Tool B", handler: vi.fn() },
141
+ ];
142
+
143
+ const view = renderProvider({
144
+ child: Collector,
145
+ runtimeUrl: "/api/copilotkit",
146
+ frontendTools: tools1,
147
+ });
148
+
149
+ await nextTick();
150
+ await view.rerender({
151
+ runtimeUrl: "/api/copilotkit",
152
+ frontendTools: tools2,
153
+ });
154
+ await nextTick();
155
+
156
+ expect(instances.length).toBeGreaterThanOrEqual(2);
157
+ const first = instances[0];
158
+ for (const instance of instances) {
159
+ expect(instance).toBe(first);
160
+ }
161
+ });
162
+ });
163
+
164
+ describe("context value stability", () => {
165
+ it("does not change context value reference when only tools change", async () => {
166
+ const contextValues: CopilotKitContextValue[] = [];
167
+
168
+ const Collector = defineComponent({
169
+ setup() {
170
+ const context = useCopilotKit();
171
+ watchEffect(() => {
172
+ void context.copilotkit.value;
173
+ void context.executingToolCallIds.value;
174
+ contextValues.push(context);
175
+ });
176
+ return () => null;
177
+ },
178
+ });
179
+
180
+ const tools1: VueFrontendTool[] = [
181
+ { name: "toolA", description: "Tool A" },
182
+ ];
183
+ const tools2: VueFrontendTool[] = [
184
+ { name: "toolB", description: "Tool B" },
185
+ ];
186
+
187
+ const view = renderProvider({
188
+ child: Collector,
189
+ runtimeUrl: "/api/copilotkit",
190
+ frontendTools: tools1,
191
+ });
192
+
193
+ await nextTick();
194
+ const initialContext = contextValues[contextValues.length - 1];
195
+
196
+ await view.rerender({
197
+ runtimeUrl: "/api/copilotkit",
198
+ frontendTools: tools2,
199
+ });
200
+ await nextTick();
201
+
202
+ const afterRerender = contextValues[contextValues.length - 1];
203
+ expect(afterRerender?.copilotkit).toBe(initialContext?.copilotkit);
204
+ expect(afterRerender?.executingToolCallIds).toBe(
205
+ initialContext?.executingToolCallIds,
206
+ );
207
+ });
208
+ });
209
+
210
+ describe("setter calls on prop changes", () => {
211
+ it("calls setTools when frontendTools change instead of recreating instance", async () => {
212
+ const setToolsSpy = vi.fn();
213
+ let spyAttached = false;
214
+
215
+ const SpyAttacher = defineComponent({
216
+ setup() {
217
+ const { copilotkit } = useCopilotKit();
218
+ if (!spyAttached) {
219
+ const originalSetTools = copilotkit.value.setTools.bind(
220
+ copilotkit.value,
221
+ );
222
+ copilotkit.value.setTools = (tools) => {
223
+ setToolsSpy(tools);
224
+ return originalSetTools(tools);
225
+ };
226
+ spyAttached = true;
227
+ }
228
+ return () => null;
229
+ },
230
+ });
231
+
232
+ const tools1: VueFrontendTool[] = [
233
+ { name: "toolA", description: "Tool A", handler: vi.fn() },
234
+ ];
235
+ const tools2: VueFrontendTool[] = [
236
+ { name: "toolB", description: "Tool B", handler: vi.fn() },
237
+ ];
238
+
239
+ const view = renderProvider({
240
+ child: SpyAttacher,
241
+ runtimeUrl: "/api/copilotkit",
242
+ frontendTools: tools1,
243
+ });
244
+
245
+ await nextTick();
246
+ setToolsSpy.mockClear();
247
+
248
+ await view.rerender({
249
+ runtimeUrl: "/api/copilotkit",
250
+ frontendTools: tools2,
251
+ });
252
+ await nextTick();
253
+
254
+ expect(setToolsSpy).toHaveBeenCalled();
255
+ });
256
+
257
+ it("calls setRenderToolCalls when renderToolCalls change", async () => {
258
+ const setRenderToolCallsSpy = vi.fn();
259
+ let spyAttached = false;
260
+
261
+ const SpyAttacher = defineComponent({
262
+ setup() {
263
+ const { copilotkit } = useCopilotKit();
264
+ if (!spyAttached) {
265
+ const original = copilotkit.value.setRenderToolCalls.bind(
266
+ copilotkit.value,
267
+ );
268
+ copilotkit.value.setRenderToolCalls = (renderToolCalls) => {
269
+ setRenderToolCallsSpy(renderToolCalls);
270
+ return original(renderToolCalls);
271
+ };
272
+ spyAttached = true;
273
+ }
274
+ return () => null;
275
+ },
276
+ });
277
+
278
+ const Renderer1 = defineComponent({ template: "<div>R1</div>" });
279
+ const Renderer2 = defineComponent({ template: "<div>R2</div>" });
280
+
281
+ const rtc1: VueFrontendTool[] = [
282
+ {
283
+ name: "render1",
284
+ description: "Render 1",
285
+ parameters: z.object({ x: z.string() }),
286
+ render: Renderer1,
287
+ },
288
+ ];
289
+ const rtc2: VueFrontendTool[] = [
290
+ {
291
+ name: "render2",
292
+ description: "Render 2",
293
+ parameters: z.object({ y: z.string() }),
294
+ render: Renderer2,
295
+ },
296
+ ];
297
+
298
+ const view = renderProvider({
299
+ child: SpyAttacher,
300
+ runtimeUrl: "/api/copilotkit",
301
+ frontendTools: rtc1,
302
+ });
303
+
304
+ await nextTick();
305
+ setRenderToolCallsSpy.mockClear();
306
+
307
+ await view.rerender({
308
+ runtimeUrl: "/api/copilotkit",
309
+ frontendTools: rtc2,
310
+ });
311
+ await nextTick();
312
+
313
+ expect(setRenderToolCallsSpy).toHaveBeenCalled();
314
+ });
315
+ });
316
+
317
+ describe("no unnecessary re-renders from stable props", () => {
318
+ it("does not re-render children when provider re-renders with same stable props", async () => {
319
+ let childRenderCount = 0;
320
+
321
+ const Child = defineComponent({
322
+ setup() {
323
+ childRenderCount++;
324
+ useCopilotKit();
325
+ return () => "child";
326
+ },
327
+ });
328
+
329
+ const stableTools: VueFrontendTool[] = [
330
+ { name: "tool1", description: "Tool 1" },
331
+ ];
332
+
333
+ const view = renderProvider({
334
+ child: Child,
335
+ runtimeUrl: "/api/copilotkit",
336
+ frontendTools: stableTools,
337
+ });
338
+
339
+ await nextTick();
340
+ const initialCount = childRenderCount;
341
+
342
+ await view.rerender({
343
+ runtimeUrl: "/api/copilotkit",
344
+ frontendTools: stableTools,
345
+ });
346
+ await nextTick();
347
+
348
+ expect(childRenderCount - initialCount).toBeLessThanOrEqual(1);
349
+ });
350
+ });
351
+
352
+ describe("setter effects skip initial mount (didMountRef guard)", () => {
353
+ it("does not call setTools on initial mount (constructor handles it)", async () => {
354
+ const tools: VueFrontendTool[] = [
355
+ { name: "tool1", description: "Tool 1" },
356
+ ];
357
+ const setToolsCalls: unknown[][] = [];
358
+ let spyAttached = false;
359
+
360
+ const SpyAttacher = defineComponent({
361
+ setup() {
362
+ const { copilotkit } = useCopilotKit();
363
+ if (!spyAttached) {
364
+ const originalSetTools = copilotkit.value.setTools.bind(
365
+ copilotkit.value,
366
+ );
367
+ copilotkit.value.setTools = (nextTools) => {
368
+ setToolsCalls.push([nextTools]);
369
+ return originalSetTools(nextTools);
370
+ };
371
+ spyAttached = true;
372
+ }
373
+ return () => null;
374
+ },
375
+ });
376
+
377
+ renderProvider({
378
+ child: SpyAttacher,
379
+ runtimeUrl: "/api/copilotkit",
380
+ frontendTools: tools,
381
+ });
382
+
383
+ await nextTick();
384
+ expect(setToolsCalls).toHaveLength(0);
385
+ });
386
+
387
+ it("does not call setRenderToolCalls on initial mount", async () => {
388
+ const calls: unknown[][] = [];
389
+ let spyAttached = false;
390
+
391
+ const SpyAttacher = defineComponent({
392
+ setup() {
393
+ const { copilotkit } = useCopilotKit();
394
+ if (!spyAttached) {
395
+ const original = copilotkit.value.setRenderToolCalls.bind(
396
+ copilotkit.value,
397
+ );
398
+ copilotkit.value.setRenderToolCalls = (renderToolCalls) => {
399
+ calls.push([renderToolCalls]);
400
+ return original(renderToolCalls);
401
+ };
402
+ spyAttached = true;
403
+ }
404
+ return () => null;
405
+ },
406
+ });
407
+
408
+ const Renderer = defineComponent({ template: "<div>R1</div>" });
409
+
410
+ const rtc: VueFrontendTool[] = [
411
+ {
412
+ name: "render1",
413
+ description: "Render 1",
414
+ parameters: z.object({ x: z.string() }),
415
+ render: Renderer,
416
+ },
417
+ ];
418
+
419
+ renderProvider({
420
+ child: SpyAttacher,
421
+ runtimeUrl: "/api/copilotkit",
422
+ frontendTools: rtc,
423
+ });
424
+
425
+ await nextTick();
426
+ expect(calls).toHaveLength(0);
427
+ });
428
+ });
429
+
430
+ describe("dynamic tool preservation on mount", () => {
431
+ it("preserves dynamically registered tools from child hooks after provider mounts", async () => {
432
+ let core: CopilotKitCoreVue | null = null;
433
+
434
+ const DynamicToolChild = defineComponent({
435
+ setup() {
436
+ const { copilotkit } = useCopilotKit();
437
+ core = copilotkit.value;
438
+ useFrontendTool({
439
+ name: "dynamicTool",
440
+ description: "A dynamically registered tool",
441
+ handler: async () => "result",
442
+ });
443
+ return () => null;
444
+ },
445
+ });
446
+
447
+ const providerTools: VueFrontendTool[] = [
448
+ {
449
+ name: "providerTool",
450
+ description: "From provider props",
451
+ handler: vi.fn(),
452
+ },
453
+ ];
454
+
455
+ renderProvider({
456
+ child: DynamicToolChild,
457
+ runtimeUrl: "/api/copilotkit",
458
+ frontendTools: providerTools,
459
+ });
460
+
461
+ await nextTick();
462
+ expect(core).toBeTruthy();
463
+ expect(core?.getTool({ toolName: "dynamicTool" })).toBeDefined();
464
+ expect(core?.getTool({ toolName: "providerTool" })).toBeDefined();
465
+ });
466
+
467
+ it("preserves dynamically registered render tool calls from child hooks after provider mounts", async () => {
468
+ let core: CopilotKitCoreVue | null = null;
469
+
470
+ const DynamicRenderChild = defineComponent({
471
+ setup() {
472
+ const { copilotkit } = useCopilotKit();
473
+ core = copilotkit.value;
474
+ useFrontendTool({
475
+ name: "renderableTool",
476
+ description: "Has a render function",
477
+ parameters: z.object({ msg: z.string() }),
478
+ handler: async () => "ok",
479
+ render: defineComponent({ template: "<div>Rendered!</div>" }),
480
+ });
481
+ return () => null;
482
+ },
483
+ });
484
+
485
+ const providerRtc: VueFrontendTool[] = [
486
+ {
487
+ name: "providerRenderer",
488
+ description: "Provider render",
489
+ parameters: z.object({ x: z.string() }),
490
+ render: defineComponent({ template: "<div>Provider Render</div>" }),
491
+ },
492
+ ];
493
+
494
+ renderProvider({
495
+ child: DynamicRenderChild,
496
+ runtimeUrl: "/api/copilotkit",
497
+ frontendTools: providerRtc,
498
+ });
499
+
500
+ await nextTick();
501
+ expect(core).toBeTruthy();
502
+ const renderToolCalls = core?.renderToolCalls ?? [];
503
+ expect(
504
+ renderToolCalls.find((t) => t.name === "providerRenderer"),
505
+ ).toBeDefined();
506
+ expect(
507
+ renderToolCalls.find((t) => t.name === "renderableTool"),
508
+ ).toBeDefined();
509
+ });
510
+ });
511
+
512
+ describe("Vue remount lifecycle", () => {
513
+ it("creates a fresh copilotkit instance on remount", async () => {
514
+ const instances: CopilotKitCoreVue[] = [];
515
+
516
+ const Collector = defineComponent({
517
+ setup() {
518
+ const { copilotkit } = useCopilotKit();
519
+ instances.push(copilotkit.value);
520
+ return () => null;
521
+ },
522
+ });
523
+
524
+ const view1 = renderProvider({
525
+ child: Collector,
526
+ runtimeUrl: "/api/copilotkit",
527
+ });
528
+ await nextTick();
529
+ view1.unmount();
530
+
531
+ const view2 = renderProvider({
532
+ child: Collector,
533
+ runtimeUrl: "/api/copilotkit",
534
+ });
535
+ await nextTick();
536
+ view2.unmount();
537
+
538
+ expect(instances).toHaveLength(2);
539
+ expect(instances[1]).not.toBe(instances[0]);
540
+ });
541
+
542
+ it("creates fresh context references on remount", async () => {
543
+ const contextValues: CopilotKitContextValue[] = [];
544
+
545
+ const Collector = defineComponent({
546
+ setup() {
547
+ contextValues.push(useCopilotKit());
548
+ return () => null;
549
+ },
550
+ });
551
+
552
+ const view1 = renderProvider({
553
+ child: Collector,
554
+ runtimeUrl: "/api/copilotkit",
555
+ });
556
+ await nextTick();
557
+ view1.unmount();
558
+
559
+ const view2 = renderProvider({
560
+ child: Collector,
561
+ runtimeUrl: "/api/copilotkit",
562
+ });
563
+ await nextTick();
564
+ view2.unmount();
565
+
566
+ expect(contextValues).toHaveLength(2);
567
+ expect(contextValues[1]?.copilotkit).not.toBe(
568
+ contextValues[0]?.copilotkit,
569
+ );
570
+ expect(contextValues[1]?.executingToolCallIds).not.toBe(
571
+ contextValues[0]?.executingToolCallIds,
572
+ );
573
+ });
574
+
575
+ it("preserves dynamically registered tools after remount", async () => {
576
+ const capturedInstances: CopilotKitCoreVue[] = [];
577
+
578
+ const DynamicToolChild = defineComponent({
579
+ setup() {
580
+ const { copilotkit } = useCopilotKit();
581
+ capturedInstances.push(copilotkit.value);
582
+
583
+ useFrontendTool({
584
+ name: "remountTool",
585
+ description: "Registered after remount",
586
+ handler: async () => "ok",
587
+ });
588
+
589
+ return () => null;
590
+ },
591
+ });
592
+
593
+ const view1 = renderProvider({
594
+ child: DynamicToolChild,
595
+ runtimeUrl: "/api/copilotkit",
596
+ });
597
+ await nextTick();
598
+ expect(
599
+ capturedInstances[0]?.getTool({ toolName: "remountTool" }),
600
+ ).toBeDefined();
601
+ view1.unmount();
602
+
603
+ const view2 = renderProvider({
604
+ child: DynamicToolChild,
605
+ runtimeUrl: "/api/copilotkit",
606
+ });
607
+ await nextTick();
608
+ expect(
609
+ capturedInstances[1]?.getTool({ toolName: "remountTool" }),
610
+ ).toBeDefined();
611
+ expect(capturedInstances[1]).not.toBe(capturedInstances[0]);
612
+ view2.unmount();
613
+ });
614
+
615
+ it("preserves dynamically registered render tool calls after remount", async () => {
616
+ const capturedInstances: CopilotKitCoreVue[] = [];
617
+
618
+ const DynamicRenderChild = defineComponent({
619
+ setup() {
620
+ const { copilotkit } = useCopilotKit();
621
+ capturedInstances.push(copilotkit.value);
622
+
623
+ useFrontendTool({
624
+ name: "remountRenderTool",
625
+ description: "Render survives remount",
626
+ parameters: z.object({ topic: z.string() }),
627
+ handler: async () => "ok",
628
+ render: defineComponent({ template: "<div>Rendered!</div>" }),
629
+ });
630
+
631
+ return () => null;
632
+ },
633
+ });
634
+
635
+ const view1 = renderProvider({
636
+ child: DynamicRenderChild,
637
+ runtimeUrl: "/api/copilotkit",
638
+ });
639
+ await nextTick();
640
+ expect(
641
+ capturedInstances[0]?.renderToolCalls.find(
642
+ (r) => r.name === "remountRenderTool",
643
+ ),
644
+ ).toBeDefined();
645
+ view1.unmount();
646
+
647
+ const view2 = renderProvider({
648
+ child: DynamicRenderChild,
649
+ runtimeUrl: "/api/copilotkit",
650
+ });
651
+ await nextTick();
652
+ expect(
653
+ capturedInstances[1]?.renderToolCalls.find(
654
+ (r) => r.name === "remountRenderTool",
655
+ ),
656
+ ).toBeDefined();
657
+ expect(capturedInstances[1]).not.toBe(capturedInstances[0]);
658
+ view2.unmount();
659
+ });
660
+
661
+ it("hook render entries coexist with prop render entries after remount", async () => {
662
+ const capturedInstances: CopilotKitCoreVue[] = [];
663
+
664
+ const DynamicRenderChild = defineComponent({
665
+ setup() {
666
+ const { copilotkit } = useCopilotKit();
667
+ capturedInstances.push(copilotkit.value);
668
+
669
+ useFrontendTool({
670
+ name: "hookTool",
671
+ description: "Registered via hook",
672
+ parameters: z.object({ x: z.string() }),
673
+ handler: async () => "ok",
674
+ render: defineComponent({ template: "<div>Hook render</div>" }),
675
+ });
676
+
677
+ return () => null;
678
+ },
679
+ });
680
+
681
+ const propRtc: VueFrontendTool[] = [
682
+ {
683
+ name: "propTool",
684
+ description: "Prop tool",
685
+ parameters: z.object({ y: z.string() }),
686
+ render: defineComponent({ template: "<div>Prop render</div>" }),
687
+ },
688
+ ];
689
+
690
+ const view1 = renderProvider({
691
+ child: DynamicRenderChild,
692
+ runtimeUrl: "/api/copilotkit",
693
+ frontendTools: propRtc,
694
+ });
695
+ await nextTick();
696
+ expect(
697
+ capturedInstances[0]?.renderToolCalls.find(
698
+ (r) => r.name === "propTool",
699
+ ),
700
+ ).toBeDefined();
701
+ expect(
702
+ capturedInstances[0]?.renderToolCalls.find(
703
+ (r) => r.name === "hookTool",
704
+ ),
705
+ ).toBeDefined();
706
+ view1.unmount();
707
+
708
+ const view2 = renderProvider({
709
+ child: DynamicRenderChild,
710
+ runtimeUrl: "/api/copilotkit",
711
+ frontendTools: propRtc,
712
+ });
713
+ await nextTick();
714
+ expect(
715
+ capturedInstances[1]?.renderToolCalls.find(
716
+ (r) => r.name === "propTool",
717
+ ),
718
+ ).toBeDefined();
719
+ expect(
720
+ capturedInstances[1]?.renderToolCalls.find(
721
+ (r) => r.name === "hookTool",
722
+ ),
723
+ ).toBeDefined();
724
+ expect(capturedInstances[1]).not.toBe(capturedInstances[0]);
725
+ view2.unmount();
726
+ });
727
+
728
+ it("does not leak executing state from prior mount", async () => {
729
+ let firstMountSize = -1;
730
+ let secondMountSize = -1;
731
+
732
+ const FirstMountChild = defineComponent({
733
+ setup() {
734
+ const context = useCopilotKit();
735
+ context.executingToolCallIds.value = new Set(["leaked-tool-call-id"]);
736
+ firstMountSize = context.executingToolCallIds.value.size;
737
+ return () => null;
738
+ },
739
+ });
740
+
741
+ const SecondMountChild = defineComponent({
742
+ setup() {
743
+ const context = useCopilotKit();
744
+ secondMountSize = context.executingToolCallIds.value.size;
745
+ return () => null;
746
+ },
747
+ });
748
+
749
+ const view1 = renderProvider({
750
+ child: FirstMountChild,
751
+ runtimeUrl: "/api/copilotkit",
752
+ });
753
+ await nextTick();
754
+ view1.unmount();
755
+
756
+ const view2 = renderProvider({
757
+ child: SecondMountChild,
758
+ runtimeUrl: "/api/copilotkit",
759
+ });
760
+ await nextTick();
761
+ view2.unmount();
762
+
763
+ expect(firstMountSize).toBe(1);
764
+ expect(secondMountSize).toBe(0);
765
+ });
766
+ });
767
+
768
+ describe("hook render entries survive prop changes", () => {
769
+ it("preserves hook-registered render entries when provider renderToolCalls prop changes", async () => {
770
+ let capturedInstance: CopilotKitCoreVue | null = null;
771
+ const currentRenderToolCalls = ref<VueFrontendTool[]>([]);
772
+
773
+ const DynamicRenderChild = defineComponent({
774
+ setup() {
775
+ const { copilotkit } = useCopilotKit();
776
+ capturedInstance = copilotkit.value;
777
+
778
+ useFrontendTool(
779
+ {
780
+ name: "hookTool",
781
+ description: "Registered via hook",
782
+ parameters: z.object({ x: z.string() }),
783
+ handler: async () => "ok",
784
+ render: defineComponent({ template: "<div>Hook render</div>" }),
785
+ },
786
+ [currentRenderToolCalls],
787
+ );
788
+
789
+ return () => null;
790
+ },
791
+ });
792
+
793
+ const rtc1: VueFrontendTool[] = [
794
+ {
795
+ name: "propToolA",
796
+ description: "A",
797
+ parameters: z.object({ a: z.string() }),
798
+ render: defineComponent({ template: "<div>A</div>" }),
799
+ },
800
+ ];
801
+ const rtc2: VueFrontendTool[] = [
802
+ {
803
+ name: "propToolB",
804
+ description: "B",
805
+ parameters: z.object({ b: z.string() }),
806
+ render: defineComponent({ template: "<div>B</div>" }),
807
+ },
808
+ ];
809
+
810
+ const view = renderProvider({
811
+ child: DynamicRenderChild,
812
+ runtimeUrl: "/api/copilotkit",
813
+ frontendTools: rtc1,
814
+ });
815
+
816
+ currentRenderToolCalls.value = rtc2;
817
+ await view.rerender({
818
+ runtimeUrl: "/api/copilotkit",
819
+ frontendTools: rtc2,
820
+ });
821
+ await nextTick();
822
+
823
+ expect(capturedInstance).not.toBeNull();
824
+ const renderToolCalls = capturedInstance!.renderToolCalls;
825
+ expect(
826
+ renderToolCalls.find((r) => r.name === "propToolA"),
827
+ ).toBeUndefined();
828
+ expect(renderToolCalls.find((r) => r.name === "propToolB")).toBeDefined();
829
+ expect(renderToolCalls.find((r) => r.name === "hookTool")).toBeDefined();
830
+ });
831
+ });
832
+
833
+ describe("runtimeUrl deduplication", () => {
834
+ it("always calls setRuntimeUrl with the same URL on re-render (AgentRegistry deduplicates)", async () => {
835
+ const setRuntimeUrlCalls: unknown[] = [];
836
+ let spyAttached = false;
837
+
838
+ const SpyAttacher = defineComponent({
839
+ setup() {
840
+ const { copilotkit } = useCopilotKit();
841
+ if (!spyAttached) {
842
+ const original = copilotkit.value.setRuntimeUrl.bind(
843
+ copilotkit.value,
844
+ );
845
+ copilotkit.value.setRuntimeUrl = (
846
+ ...args: [string | undefined]
847
+ ) => {
848
+ setRuntimeUrlCalls.push(args[0]);
849
+ return original(...args);
850
+ };
851
+ spyAttached = true;
852
+ }
853
+ return () => null;
854
+ },
855
+ });
856
+
857
+ const view = renderProvider({
858
+ child: SpyAttacher,
859
+ runtimeUrl: "http://localhost:3000/api",
860
+ });
861
+
862
+ await view.rerender({ runtimeUrl: "http://localhost:3000/api" });
863
+ await nextTick();
864
+
865
+ expect(setRuntimeUrlCalls.length).toBeGreaterThanOrEqual(1);
866
+ for (const url of setRuntimeUrlCalls) {
867
+ expect(url).toBe("http://localhost:3000/api");
868
+ }
869
+ });
870
+ });
871
+ });