@copilotkit/react-core 1.57.3 → 1.57.4

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 (266) hide show
  1. package/LICENSE +21 -0
  2. package/package.json +12 -13
  3. package/skills/react-core/SKILL.md +108 -0
  4. package/skills/react-core/references/agent-access.md +288 -0
  5. package/skills/react-core/references/attachments.md +291 -0
  6. package/skills/react-core/references/capabilities.md +138 -0
  7. package/skills/react-core/references/chat-components.md +221 -0
  8. package/skills/react-core/references/client-side-tools.md +358 -0
  9. package/skills/react-core/references/custom-message-renderers.md +226 -0
  10. package/skills/react-core/references/debug-mode.md +153 -0
  11. package/skills/react-core/references/human-in-the-loop.md +312 -0
  12. package/skills/react-core/references/provider-setup.md +326 -0
  13. package/skills/react-core/references/rendering-activity-messages.md +207 -0
  14. package/skills/react-core/references/rendering-tool-calls.md +319 -0
  15. package/skills/react-core/references/suggestions.md +211 -0
  16. package/skills/react-core/references/switching-agents-recipes.md +160 -0
  17. package/skills/react-core/references/switching-agents.md +231 -0
  18. package/skills/react-core/references/threads.md +226 -0
  19. package/.attw.json +0 -3
  20. package/CHANGELOG.md +0 -5043
  21. package/scripts/scope-preflight.mjs +0 -100
  22. package/src/components/CopilotListeners.tsx +0 -137
  23. package/src/components/__tests__/CopilotListeners.test.tsx +0 -38
  24. package/src/components/copilot-provider/__tests__/copilot-messages-key.test.tsx +0 -92
  25. package/src/components/copilot-provider/__tests__/copilotkit-error.test.tsx +0 -77
  26. package/src/components/copilot-provider/__tests__/error-visibility-prod.test.tsx +0 -70
  27. package/src/components/copilot-provider/__tests__/v1-explicit-threadid-bridge.test.tsx +0 -107
  28. package/src/components/copilot-provider/copilot-messages.tsx +0 -314
  29. package/src/components/copilot-provider/copilotkit-props.tsx +0 -214
  30. package/src/components/copilot-provider/copilotkit.tsx +0 -853
  31. package/src/components/copilot-provider/index.ts +0 -3
  32. package/src/components/dev-console/console-trigger.tsx +0 -283
  33. package/src/components/dev-console/developer-console-modal.tsx +0 -1016
  34. package/src/components/dev-console/icons.tsx +0 -106
  35. package/src/components/error-boundary/error-boundary.tsx +0 -99
  36. package/src/components/error-boundary/error-utils.tsx +0 -105
  37. package/src/components/index.ts +0 -1
  38. package/src/components/toast/exclamation-mark-icon.tsx +0 -27
  39. package/src/components/toast/toast-provider.tsx +0 -448
  40. package/src/components/usage-banner.tsx +0 -266
  41. package/src/context/__tests__/threads-context.test.tsx +0 -141
  42. package/src/context/coagent-state-renders-context.tsx +0 -89
  43. package/src/context/copilot-context.tsx +0 -365
  44. package/src/context/copilot-messages-context.tsx +0 -35
  45. package/src/context/index.ts +0 -22
  46. package/src/context/threads-context.tsx +0 -69
  47. package/src/hooks/__tests__/use-coagent-config.test.ts +0 -352
  48. package/src/hooks/__tests__/use-coagent-state-render-bridge.helpers.test.ts +0 -107
  49. package/src/hooks/__tests__/use-coagent-state-render.e2e.test.tsx +0 -1209
  50. package/src/hooks/__tests__/use-coagent-state-render.test.tsx +0 -356
  51. package/src/hooks/__tests__/use-copilot-chat-internal-connect.test.tsx +0 -241
  52. package/src/hooks/__tests__/use-frontend-tool-available.test.tsx +0 -72
  53. package/src/hooks/__tests__/use-frontend-tool-remount.e2e.test.tsx +0 -102
  54. package/src/hooks/index.ts +0 -33
  55. package/src/hooks/use-agent-nodename.ts +0 -33
  56. package/src/hooks/use-coagent-state-render-bridge.helpers.ts +0 -345
  57. package/src/hooks/use-coagent-state-render-bridge.tsx +0 -222
  58. package/src/hooks/use-coagent-state-render-registry.ts +0 -230
  59. package/src/hooks/use-coagent-state-render.ts +0 -163
  60. package/src/hooks/use-coagent.ts +0 -377
  61. package/src/hooks/use-configure-chat-suggestions.tsx +0 -96
  62. package/src/hooks/use-copilot-action.ts +0 -245
  63. package/src/hooks/use-copilot-additional-instructions.ts +0 -98
  64. package/src/hooks/use-copilot-authenticated-action.ts +0 -73
  65. package/src/hooks/use-copilot-chat-headless_c.ts +0 -264
  66. package/src/hooks/use-copilot-chat-suggestions.tsx +0 -134
  67. package/src/hooks/use-copilot-chat.ts +0 -132
  68. package/src/hooks/use-copilot-chat_internal.ts +0 -875
  69. package/src/hooks/use-copilot-readable.ts +0 -135
  70. package/src/hooks/use-copilot-runtime-client.ts +0 -178
  71. package/src/hooks/use-default-tool.ts +0 -13
  72. package/src/hooks/use-flat-category-store.ts +0 -109
  73. package/src/hooks/use-frontend-tool.ts +0 -113
  74. package/src/hooks/use-human-in-the-loop.ts +0 -138
  75. package/src/hooks/use-langgraph-interrupt.ts +0 -103
  76. package/src/hooks/use-lazy-tool-renderer.tsx +0 -30
  77. package/src/hooks/use-make-copilot-document-readable.ts +0 -30
  78. package/src/hooks/use-render-tool-call.ts +0 -89
  79. package/src/hooks/use-tree.ts +0 -222
  80. package/src/index.tsx +0 -7
  81. package/src/lib/copilot-task.ts +0 -215
  82. package/src/lib/index.ts +0 -1
  83. package/src/lib/status-checker.ts +0 -67
  84. package/src/setupTests.ts +0 -37
  85. package/src/test-helpers/copilot-context.ts +0 -91
  86. package/src/types/chat-suggestion-configuration.ts +0 -23
  87. package/src/types/coagent-action.ts +0 -35
  88. package/src/types/coagent-state.ts +0 -13
  89. package/src/types/crew.ts +0 -89
  90. package/src/types/document-pointer.ts +0 -7
  91. package/src/types/frontend-action.ts +0 -213
  92. package/src/types/index.ts +0 -17
  93. package/src/types/interrupt-action.ts +0 -58
  94. package/src/types/system-message.ts +0 -4
  95. package/src/utils/dev-console.ts +0 -19
  96. package/src/utils/index.ts +0 -2
  97. package/src/utils/suggestions-constants.ts +0 -8
  98. package/src/utils/utils.test.ts +0 -7
  99. package/src/utils/utils.ts +0 -6
  100. package/src/v2/__tests__/A2UIMessageRenderer.test.tsx +0 -240
  101. package/src/v2/__tests__/globalSetup.ts +0 -14
  102. package/src/v2/__tests__/setup.ts +0 -93
  103. package/src/v2/__tests__/utils/test-helpers.tsx +0 -570
  104. package/src/v2/a2ui/A2UICatalogContext.tsx +0 -79
  105. package/src/v2/a2ui/A2UIMessageRenderer.tsx +0 -294
  106. package/src/v2/a2ui/A2UIToolCallRenderer.tsx +0 -290
  107. package/src/v2/components/CopilotKitInspector.tsx +0 -52
  108. package/src/v2/components/MCPAppsActivityRenderer.tsx +0 -815
  109. package/src/v2/components/OpenGenerativeUIRenderer.tsx +0 -598
  110. package/src/v2/components/WildcardToolCallRender.tsx +0 -86
  111. package/src/v2/components/__tests__/OpenGenerativeUIRenderer.test.tsx +0 -665
  112. package/src/v2/components/chat/CopilotChat.tsx +0 -664
  113. package/src/v2/components/chat/CopilotChatAssistantMessage.tsx +0 -393
  114. package/src/v2/components/chat/CopilotChatAttachmentQueue.tsx +0 -374
  115. package/src/v2/components/chat/CopilotChatAttachmentRenderer.tsx +0 -159
  116. package/src/v2/components/chat/CopilotChatAudioRecorder.tsx +0 -350
  117. package/src/v2/components/chat/CopilotChatInput.tsx +0 -1412
  118. package/src/v2/components/chat/CopilotChatMessageView.tsx +0 -716
  119. package/src/v2/components/chat/CopilotChatReasoningMessage.tsx +0 -265
  120. package/src/v2/components/chat/CopilotChatSuggestionPill.tsx +0 -59
  121. package/src/v2/components/chat/CopilotChatSuggestionView.tsx +0 -134
  122. package/src/v2/components/chat/CopilotChatToggleButton.tsx +0 -171
  123. package/src/v2/components/chat/CopilotChatToolCallsView.tsx +0 -40
  124. package/src/v2/components/chat/CopilotChatUserMessage.tsx +0 -445
  125. package/src/v2/components/chat/CopilotChatView.tsx +0 -890
  126. package/src/v2/components/chat/CopilotModalHeader.tsx +0 -129
  127. package/src/v2/components/chat/CopilotPopup.tsx +0 -81
  128. package/src/v2/components/chat/CopilotPopupView.tsx +0 -317
  129. package/src/v2/components/chat/CopilotSidebar.tsx +0 -80
  130. package/src/v2/components/chat/CopilotSidebarView.tsx +0 -269
  131. package/src/v2/components/chat/Lightbox.tsx +0 -103
  132. package/src/v2/components/chat/__tests__/CopilotChat.absentThreadConnect.test.tsx +0 -66
  133. package/src/v2/components/chat/__tests__/CopilotChat.attachments.test.tsx +0 -168
  134. package/src/v2/components/chat/__tests__/CopilotChat.e2e.test.tsx +0 -1239
  135. package/src/v2/components/chat/__tests__/CopilotChat.onError.test.tsx +0 -73
  136. package/src/v2/components/chat/__tests__/CopilotChat.slots.e2e.test.tsx +0 -432
  137. package/src/v2/components/chat/__tests__/CopilotChat.suggestionsAlways.test.tsx +0 -183
  138. package/src/v2/components/chat/__tests__/CopilotChat.welcomeGate.test.tsx +0 -184
  139. package/src/v2/components/chat/__tests__/CopilotChatActivityRendering.e2e.test.tsx +0 -649
  140. package/src/v2/components/chat/__tests__/CopilotChatAssistantMessage.slots.e2e.test.tsx +0 -624
  141. package/src/v2/components/chat/__tests__/CopilotChatAssistantMessage.test.tsx +0 -702
  142. package/src/v2/components/chat/__tests__/CopilotChatAssistantMessage.thumbs.test.tsx +0 -72
  143. package/src/v2/components/chat/__tests__/CopilotChatCopyButton.clipboard.test.tsx +0 -241
  144. package/src/v2/components/chat/__tests__/CopilotChatCssClasses.test.tsx +0 -107
  145. package/src/v2/components/chat/__tests__/CopilotChatInput.slots.e2e.test.tsx +0 -929
  146. package/src/v2/components/chat/__tests__/CopilotChatInput.test.tsx +0 -1567
  147. package/src/v2/components/chat/__tests__/CopilotChatMessageView.slots.e2e.test.tsx +0 -1004
  148. package/src/v2/components/chat/__tests__/CopilotChatMessageView.test.tsx +0 -279
  149. package/src/v2/components/chat/__tests__/CopilotChatPerf.e2e.test.tsx +0 -336
  150. package/src/v2/components/chat/__tests__/CopilotChatPropsRerender.e2e.test.tsx +0 -249
  151. package/src/v2/components/chat/__tests__/CopilotChatSuggestionView.slots.e2e.test.tsx +0 -530
  152. package/src/v2/components/chat/__tests__/CopilotChatToolRendering.e2e.test.tsx +0 -785
  153. package/src/v2/components/chat/__tests__/CopilotChatToolRerenders.e2e.test.tsx +0 -2416
  154. package/src/v2/components/chat/__tests__/CopilotChatUserMessage.slots.e2e.test.tsx +0 -621
  155. package/src/v2/components/chat/__tests__/CopilotChatView.connectingGate.test.tsx +0 -56
  156. package/src/v2/components/chat/__tests__/CopilotChatView.inputOverlay.test.tsx +0 -264
  157. package/src/v2/components/chat/__tests__/CopilotChatView.onClick.e2e.test.tsx +0 -853
  158. package/src/v2/components/chat/__tests__/CopilotChatView.pinToSend.test.tsx +0 -94
  159. package/src/v2/components/chat/__tests__/CopilotChatView.slots.e2e.test.tsx +0 -1050
  160. package/src/v2/components/chat/__tests__/CopilotModalHeader.slots.e2e.test.tsx +0 -484
  161. package/src/v2/components/chat/__tests__/CopilotPopupView.slots.e2e.test.tsx +0 -612
  162. package/src/v2/components/chat/__tests__/CopilotSidebarView.position.test.tsx +0 -159
  163. package/src/v2/components/chat/__tests__/CopilotSidebarView.slots.e2e.test.tsx +0 -502
  164. package/src/v2/components/chat/__tests__/MCPAppsActivityRenderer.e2e.test.tsx +0 -1068
  165. package/src/v2/components/chat/__tests__/MCPAppsProxy.e2e.test.tsx +0 -589
  166. package/src/v2/components/chat/__tests__/MCPAppsUiMessage.e2e.test.tsx +0 -403
  167. package/src/v2/components/chat/__tests__/copilot-chat-throttle.test.tsx +0 -137
  168. package/src/v2/components/chat/__tests__/normalize-auto-scroll.test.ts +0 -37
  169. package/src/v2/components/chat/__tests__/setup.ts +0 -1
  170. package/src/v2/components/chat/index.ts +0 -90
  171. package/src/v2/components/chat/last-user-message-context.ts +0 -21
  172. package/src/v2/components/chat/normalize-auto-scroll.ts +0 -17
  173. package/src/v2/components/chat/scroll-element-context.ts +0 -13
  174. package/src/v2/components/index.ts +0 -8
  175. package/src/v2/components/intelligence-indicator/IntelligenceIndicator.tsx +0 -286
  176. package/src/v2/components/intelligence-indicator/__tests__/IntelligenceIndicator.e2e.test.tsx +0 -464
  177. package/src/v2/components/intelligence-indicator/index.ts +0 -2
  178. package/src/v2/components/license-warning-banner.tsx +0 -217
  179. package/src/v2/components/ui/button.tsx +0 -124
  180. package/src/v2/components/ui/dropdown-menu.tsx +0 -258
  181. package/src/v2/components/ui/tooltip.tsx +0 -60
  182. package/src/v2/context.ts +0 -62
  183. package/src/v2/headless.ts +0 -64
  184. package/src/v2/hooks/__tests__/standard-schema-types.test.tsx +0 -152
  185. package/src/v2/hooks/__tests__/standard-schema.test.tsx +0 -282
  186. package/src/v2/hooks/__tests__/use-agent-context-timing.e2e.test.tsx +0 -140
  187. package/src/v2/hooks/__tests__/use-agent-context.test.tsx +0 -401
  188. package/src/v2/hooks/__tests__/use-agent-error-state.test.tsx +0 -44
  189. package/src/v2/hooks/__tests__/use-agent-stability.test.tsx +0 -211
  190. package/src/v2/hooks/__tests__/use-agent-throttle.test.tsx +0 -1029
  191. package/src/v2/hooks/__tests__/use-agent.e2e.test.tsx +0 -159
  192. package/src/v2/hooks/__tests__/use-attachments.test.tsx +0 -169
  193. package/src/v2/hooks/__tests__/use-capabilities.test.tsx +0 -76
  194. package/src/v2/hooks/__tests__/use-component.test.tsx +0 -126
  195. package/src/v2/hooks/__tests__/use-configure-suggestions.e2e.test.tsx +0 -696
  196. package/src/v2/hooks/__tests__/use-default-render-tool.test.tsx +0 -153
  197. package/src/v2/hooks/__tests__/use-frontend-tool-available.test.tsx +0 -167
  198. package/src/v2/hooks/__tests__/use-frontend-tool.e2e.test.tsx +0 -2148
  199. package/src/v2/hooks/__tests__/use-human-in-the-loop.e2e.test.tsx +0 -1261
  200. package/src/v2/hooks/__tests__/use-interrupt.test.tsx +0 -397
  201. package/src/v2/hooks/__tests__/use-katex-styles.test.tsx +0 -56
  202. package/src/v2/hooks/__tests__/use-keyboard-height.test.tsx +0 -192
  203. package/src/v2/hooks/__tests__/use-pin-to-send.test.tsx +0 -219
  204. package/src/v2/hooks/__tests__/use-render-custom-messages.test.tsx +0 -55
  205. package/src/v2/hooks/__tests__/use-render-tool.test.tsx +0 -259
  206. package/src/v2/hooks/__tests__/use-suggestions.e2e.test.tsx +0 -524
  207. package/src/v2/hooks/__tests__/use-threads.test.tsx +0 -757
  208. package/src/v2/hooks/__tests__/zod-regression.test.tsx +0 -311
  209. package/src/v2/hooks/index.ts +0 -24
  210. package/src/v2/hooks/use-agent-context.tsx +0 -45
  211. package/src/v2/hooks/use-agent.tsx +0 -227
  212. package/src/v2/hooks/use-attachments.tsx +0 -269
  213. package/src/v2/hooks/use-capabilities.tsx +0 -25
  214. package/src/v2/hooks/use-component.tsx +0 -91
  215. package/src/v2/hooks/use-configure-suggestions.tsx +0 -236
  216. package/src/v2/hooks/use-default-render-tool.tsx +0 -271
  217. package/src/v2/hooks/use-frontend-tool.tsx +0 -46
  218. package/src/v2/hooks/use-human-in-the-loop.tsx +0 -81
  219. package/src/v2/hooks/use-interrupt.tsx +0 -305
  220. package/src/v2/hooks/use-keyboard-height.tsx +0 -67
  221. package/src/v2/hooks/use-pin-to-send.ts +0 -94
  222. package/src/v2/hooks/use-render-activity-message.tsx +0 -72
  223. package/src/v2/hooks/use-render-custom-messages.tsx +0 -93
  224. package/src/v2/hooks/use-render-tool-call.tsx +0 -208
  225. package/src/v2/hooks/use-render-tool.tsx +0 -184
  226. package/src/v2/hooks/use-suggestions.tsx +0 -91
  227. package/src/v2/hooks/use-threads.tsx +0 -325
  228. package/src/v2/hooks/useKatexStyles.ts +0 -27
  229. package/src/v2/index.css +0 -1
  230. package/src/v2/index.ts +0 -27
  231. package/src/v2/lib/__tests__/completePartialMarkdown.test.ts +0 -495
  232. package/src/v2/lib/__tests__/processPartialHtml.test.ts +0 -112
  233. package/src/v2/lib/__tests__/renderSlot.test.tsx +0 -588
  234. package/src/v2/lib/__tests__/slots.test.ts +0 -56
  235. package/src/v2/lib/processPartialHtml.ts +0 -45
  236. package/src/v2/lib/react-core.ts +0 -156
  237. package/src/v2/lib/slots.tsx +0 -184
  238. package/src/v2/lib/transcription-client.ts +0 -184
  239. package/src/v2/lib/utils.ts +0 -8
  240. package/src/v2/providers/CopilotChatConfigurationProvider.tsx +0 -196
  241. package/src/v2/providers/CopilotKitProvider.tsx +0 -800
  242. package/src/v2/providers/SandboxFunctionsContext.ts +0 -10
  243. package/src/v2/providers/__tests__/CopilotChatConfigurationProvider.test.tsx +0 -652
  244. package/src/v2/providers/__tests__/CopilotKitProvider.license.test.tsx +0 -101
  245. package/src/v2/providers/__tests__/CopilotKitProvider.onError.test.tsx +0 -69
  246. package/src/v2/providers/__tests__/CopilotKitProvider.renderCustomMessages.e2e.test.tsx +0 -881
  247. package/src/v2/providers/__tests__/CopilotKitProvider.sandboxFunctions.test.tsx +0 -198
  248. package/src/v2/providers/__tests__/CopilotKitProvider.stability.test.tsx +0 -740
  249. package/src/v2/providers/__tests__/CopilotKitProvider.test.tsx +0 -713
  250. package/src/v2/providers/__tests__/CopilotKitProvider.wildcard.test.tsx +0 -294
  251. package/src/v2/providers/index.ts +0 -21
  252. package/src/v2/styles/globals.css +0 -349
  253. package/src/v2/types/__tests__/defineToolCallRenderer.test.tsx +0 -525
  254. package/src/v2/types/defineToolCallRenderer.ts +0 -68
  255. package/src/v2/types/frontend-tool.ts +0 -8
  256. package/src/v2/types/human-in-the-loop.ts +0 -33
  257. package/src/v2/types/index.ts +0 -8
  258. package/src/v2/types/interrupt.ts +0 -15
  259. package/src/v2/types/react-activity-message-renderer.ts +0 -27
  260. package/src/v2/types/react-custom-message-renderer.ts +0 -17
  261. package/src/v2/types/react-tool-call-renderer.ts +0 -35
  262. package/src/v2/types/sandbox-function.ts +0 -11
  263. package/tsconfig.json +0 -8
  264. package/tsdown.config.ts +0 -193
  265. package/typedoc.json +0 -4
  266. package/vitest.config.mjs +0 -31
@@ -1,73 +0,0 @@
1
- import React from "react";
2
- import { describe, it, expect, vi } from "vitest";
3
- import {
4
- MockStepwiseAgent,
5
- renderWithCopilotKit,
6
- } from "../../../__tests__/utils/test-helpers";
7
- import { CopilotChat } from "../CopilotChat";
8
- import { CopilotKitCoreErrorCode } from "@copilotkit/core";
9
- import { type BaseEvent, type RunAgentInput } from "@ag-ui/client";
10
- import { Observable, EMPTY } from "rxjs";
11
-
12
- /**
13
- * Mock agent whose connect() always fails
14
- */
15
- class FailingConnectAgent extends MockStepwiseAgent {
16
- run(input: RunAgentInput): Observable<BaseEvent> {
17
- return super.run(input);
18
- }
19
-
20
- connect(_input: RunAgentInput): Observable<BaseEvent> {
21
- return new Observable((subscriber) => {
22
- subscriber.error(new Error("connect failed"));
23
- });
24
- }
25
- }
26
-
27
- /**
28
- * Mock agent whose connect() succeeds (returns empty observable)
29
- */
30
- class HealthyConnectAgent extends MockStepwiseAgent {
31
- run(input: RunAgentInput): Observable<BaseEvent> {
32
- return super.run(input);
33
- }
34
-
35
- connect(_input: RunAgentInput): Observable<BaseEvent> {
36
- return EMPTY;
37
- }
38
- }
39
-
40
- describe("CopilotChat onError", () => {
41
- it("connectAgent failure fires onError on CopilotChat and does not crash", async () => {
42
- const agent = new FailingConnectAgent();
43
- const chatOnError = vi.fn();
44
-
45
- renderWithCopilotKit({
46
- agent,
47
- children: <CopilotChat welcomeScreen={false} onError={chatOnError} />,
48
- });
49
-
50
- // Wait for the connectAgent error to propagate
51
- await vi.waitFor(() => {
52
- expect(chatOnError).toHaveBeenCalled();
53
- });
54
-
55
- // Check that AGENT_CONNECT_FAILED is among the errors
56
- const allCodes = chatOnError.mock.calls.map((c: any) => c[0].code);
57
- expect(allCodes).toContain(CopilotKitCoreErrorCode.AGENT_CONNECT_FAILED);
58
- });
59
-
60
- it("onError on CopilotChat does not fire for a healthy agent", async () => {
61
- const agent = new HealthyConnectAgent();
62
- const chatOnError = vi.fn();
63
-
64
- renderWithCopilotKit({
65
- agent,
66
- children: <CopilotChat welcomeScreen={false} onError={chatOnError} />,
67
- });
68
-
69
- // No errors should fire for a healthy agent
70
- await new Promise((r) => setTimeout(r, 50));
71
- expect(chatOnError).not.toHaveBeenCalled();
72
- });
73
- });
@@ -1,432 +0,0 @@
1
- import React from "react";
2
- import { render, screen } from "@testing-library/react";
3
- import { describe, it, expect, vi } from "vitest";
4
- import { CopilotChat } from "../CopilotChat";
5
- import { CopilotChatView } from "../CopilotChatView";
6
- import { CopilotKitProvider } from "../../../providers/CopilotKitProvider";
7
- import { CopilotChatConfigurationProvider } from "../../../providers/CopilotChatConfigurationProvider";
8
- import { MockStepwiseAgent } from "../../../__tests__/utils/test-helpers";
9
-
10
- // Create a mock agent for testing
11
- const createMockAgent = () => new MockStepwiseAgent();
12
-
13
- // Wrapper to provide required context with mock agent
14
- const TestWrapper: React.FC<{ children: React.ReactNode }> = ({ children }) => {
15
- const mockAgent = createMockAgent();
16
- return (
17
- <CopilotKitProvider agents__unsafe_dev_only={{ default: mockAgent }}>
18
- <CopilotChatConfigurationProvider threadId="test-thread">
19
- {children}
20
- </CopilotChatConfigurationProvider>
21
- </CopilotKitProvider>
22
- );
23
- };
24
-
25
- describe("CopilotChat Slot System E2E Tests", () => {
26
- // ============================================================================
27
- // 1. TAILWIND CLASS TESTS - CHATVIEW SLOT
28
- // ============================================================================
29
- describe("1. Tailwind Class Slot Override - chatView Slot", () => {
30
- describe("chatView slot", () => {
31
- it("should apply tailwind class string to chatView", () => {
32
- const { container } = render(
33
- <TestWrapper>
34
- <CopilotChat chatView="bg-gradient-to-b from-white to-gray-50 rounded-xl shadow-2xl" />
35
- </TestWrapper>,
36
- );
37
-
38
- const chatView = container.querySelector(".bg-gradient-to-b");
39
- expect(chatView).toBeDefined();
40
- expect(chatView?.classList.contains("rounded-xl")).toBe(true);
41
- expect(chatView?.classList.contains("shadow-2xl")).toBe(true);
42
- });
43
-
44
- it("should apply custom background color via tailwind class", () => {
45
- const { container } = render(
46
- <TestWrapper>
47
- <CopilotChat chatView="bg-blue-50" />
48
- </TestWrapper>,
49
- );
50
-
51
- const chatView = container.querySelector(".bg-blue-50");
52
- expect(chatView).toBeDefined();
53
- });
54
- });
55
- });
56
-
57
- // ============================================================================
58
- // 2. PROPERTY PASSING TESTS - CHATVIEW SLOT
59
- // ============================================================================
60
- describe("2. Property Passing - chatView Slot", () => {
61
- describe("chatView slot", () => {
62
- it("should pass custom props to chatView", () => {
63
- render(
64
- <TestWrapper>
65
- <CopilotChat chatView={{ "data-testid": "custom-chat-view" }} />
66
- </TestWrapper>,
67
- );
68
-
69
- const chatView = screen.queryByTestId("custom-chat-view");
70
- expect(chatView).toBeDefined();
71
- });
72
-
73
- it("should pass className through props object", () => {
74
- const { container } = render(
75
- <TestWrapper>
76
- <CopilotChat chatView={{ className: "custom-class-from-props" }} />
77
- </TestWrapper>,
78
- );
79
-
80
- const chatView = container.querySelector(".custom-class-from-props");
81
- expect(chatView).toBeDefined();
82
- });
83
- });
84
- });
85
-
86
- // ============================================================================
87
- // 3. CUSTOM COMPONENT TESTS - CHATVIEW SLOT
88
- // ============================================================================
89
- describe("3. Custom Component - chatView Slot", () => {
90
- it("should allow custom component for chatView", () => {
91
- const CustomChatView: React.FC<any> = ({
92
- messages,
93
- isRunning,
94
- ...props
95
- }) => (
96
- <div data-testid="custom-chat-view-component" {...props}>
97
- <div className="custom-header">Custom Chat Interface</div>
98
- <div className="messages-area">
99
- {messages?.map((m: any) => (
100
- <div key={m.id} className="message">
101
- {m.content}
102
- </div>
103
- ))}
104
- </div>
105
- <div className="custom-footer">
106
- {isRunning ? "Processing..." : "Ready"}
107
- </div>
108
- </div>
109
- );
110
-
111
- render(
112
- <TestWrapper>
113
- <CopilotChat chatView={CustomChatView as any} />
114
- </TestWrapper>,
115
- );
116
-
117
- const custom = screen.queryByTestId("custom-chat-view-component");
118
- expect(custom).toBeDefined();
119
- expect(custom?.textContent).toContain("Custom Chat Interface");
120
- });
121
-
122
- it("should pass messages to custom chatView component", () => {
123
- const receivedProps: any[] = [];
124
- const CustomChatView: React.FC<any> = (props) => {
125
- receivedProps.push(props);
126
- return (
127
- <div data-testid="custom-view">
128
- Messages: {props.messages?.length ?? 0}
129
- </div>
130
- );
131
- };
132
-
133
- render(
134
- <TestWrapper>
135
- <CopilotChat chatView={CustomChatView as any} />
136
- </TestWrapper>,
137
- );
138
-
139
- expect(receivedProps.length).toBeGreaterThan(0);
140
- expect(receivedProps[0]).toHaveProperty("messages");
141
- expect(receivedProps[0]).toHaveProperty("isRunning");
142
- });
143
-
144
- it("should pass all CopilotChatView props to custom component", () => {
145
- const receivedProps: any[] = [];
146
- const CustomChatView: React.FC<any> = (props) => {
147
- receivedProps.push(props);
148
- return <div data-testid="custom-view" />;
149
- };
150
-
151
- render(
152
- <TestWrapper>
153
- <CopilotChat chatView={CustomChatView as any} />
154
- </TestWrapper>,
155
- );
156
-
157
- expect(receivedProps.length).toBeGreaterThan(0);
158
- const props = receivedProps[0];
159
- // Check that standard CopilotChatViewProps are passed
160
- expect(props).toHaveProperty("messages");
161
- expect(props).toHaveProperty("isRunning");
162
- expect(props).toHaveProperty("onSubmitMessage");
163
- });
164
- });
165
-
166
- // ============================================================================
167
- // 4. DRILL-DOWN INTO CHATVIEW SUB-SLOTS VIA PROPS OBJECT
168
- // ============================================================================
169
- describe("4. Drill-down into CopilotChatView Sub-slots via Props Object", () => {
170
- it("should allow customizing nested messageView slot via props", () => {
171
- const { container } = render(
172
- <TestWrapper>
173
- <CopilotChat
174
- chatView={{
175
- messageView: "custom-message-view-class",
176
- }}
177
- />
178
- </TestWrapper>,
179
- );
180
-
181
- const messageView = container.querySelector(".custom-message-view-class");
182
- expect(messageView).toBeDefined();
183
- });
184
-
185
- it("should allow customizing nested input slot via props", () => {
186
- const { container } = render(
187
- <TestWrapper>
188
- <CopilotChat
189
- chatView={{
190
- input: "custom-input-class border-2 border-green-400",
191
- }}
192
- />
193
- </TestWrapper>,
194
- );
195
-
196
- const input = container.querySelector(".custom-input-class");
197
- expect(input).toBeDefined();
198
- });
199
-
200
- it("should allow customizing nested scrollView slot via props", () => {
201
- const { container } = render(
202
- <TestWrapper>
203
- <CopilotChat
204
- chatView={{
205
- scrollView: "custom-scroll-view",
206
- }}
207
- />
208
- </TestWrapper>,
209
- );
210
-
211
- const scrollView = container.querySelector(".custom-scroll-view");
212
- expect(scrollView).toBeDefined();
213
- });
214
-
215
- it("should allow customizing nested input slot via props", () => {
216
- const { container } = render(
217
- <TestWrapper>
218
- <CopilotChat
219
- chatView={{
220
- input: "custom-input bg-slate-100",
221
- }}
222
- />
223
- </TestWrapper>,
224
- );
225
-
226
- const input = container.querySelector(".custom-input");
227
- expect(input).toBeDefined();
228
- });
229
- });
230
-
231
- // ============================================================================
232
- // 5. CUSTOM CHATVIEW COMPONENT
233
- // ============================================================================
234
- describe("5. Custom ChatView Component for Complex Customization", () => {
235
- it("should allow custom chatView component with full control", () => {
236
- const CustomChatView: React.FC<any> = (props) => (
237
- <div data-testid="fully-custom-chat" className="custom-chat-layout">
238
- <CopilotChatView
239
- {...props}
240
- messageView="custom-message-from-wrapper"
241
- input="custom-input-from-wrapper"
242
- />
243
- </div>
244
- );
245
-
246
- const { container } = render(
247
- <TestWrapper>
248
- <CopilotChat chatView={CustomChatView as any} />
249
- </TestWrapper>,
250
- );
251
-
252
- expect(screen.queryByTestId("fully-custom-chat")).toBeDefined();
253
- expect(container.querySelector(".custom-chat-layout")).toBeDefined();
254
- });
255
- });
256
-
257
- // ============================================================================
258
- // 6. CLASSNAME OVERRIDE TESTS
259
- // ============================================================================
260
- describe("6. className Override with Tailwind Strings", () => {
261
- it("should apply tailwind string to chatView as className", () => {
262
- const { container } = render(
263
- <TestWrapper>
264
- <CopilotChat chatView="h-full min-h-0 flex flex-col" />
265
- </TestWrapper>,
266
- );
267
-
268
- const chatView = container.querySelector(".h-full");
269
- expect(chatView).toBeDefined();
270
- expect(chatView?.classList.contains("min-h-0")).toBe(true);
271
- expect(chatView?.classList.contains("flex-col")).toBe(true);
272
- });
273
-
274
- it("should merge chatView tailwind classes with CopilotChatView defaults", () => {
275
- const { container } = render(
276
- <TestWrapper>
277
- <CopilotChat chatView="custom-override-class" />
278
- </TestWrapper>,
279
- );
280
-
281
- const chatView = container.querySelector(".custom-override-class");
282
- expect(chatView).toBeDefined();
283
- });
284
- });
285
-
286
- // ============================================================================
287
- // 7. COPILOTCHAT-SPECIFIC PROPS
288
- // ============================================================================
289
- describe("7. CopilotChat-specific Props", () => {
290
- it("should support agentId prop", () => {
291
- // Create wrapper with the custom-agent registered
292
- const customAgent = createMockAgent();
293
- const { container } = render(
294
- <CopilotKitProvider
295
- agents__unsafe_dev_only={{
296
- default: createMockAgent(),
297
- "custom-agent": customAgent,
298
- }}
299
- >
300
- <CopilotChatConfigurationProvider threadId="test-thread">
301
- <CopilotChat agentId="custom-agent" />
302
- </CopilotChatConfigurationProvider>
303
- </CopilotKitProvider>,
304
- );
305
-
306
- // Component should render without errors
307
- expect(container.firstChild).toBeDefined();
308
- });
309
-
310
- it("should support threadId prop", () => {
311
- const { container } = render(
312
- <TestWrapper>
313
- <CopilotChat threadId="custom-thread-123" />
314
- </TestWrapper>,
315
- );
316
-
317
- expect(container.firstChild).toBeDefined();
318
- });
319
-
320
- it("should support labels prop for customization", () => {
321
- render(
322
- <TestWrapper>
323
- <CopilotChat
324
- labels={{
325
- chatInputPlaceholder: "Custom placeholder text...",
326
- }}
327
- />
328
- </TestWrapper>,
329
- );
330
-
331
- const input = screen.queryByPlaceholderText("Custom placeholder text...");
332
- expect(input).toBeDefined();
333
- });
334
- });
335
-
336
- // ============================================================================
337
- // 8. INTEGRATION TESTS
338
- // ============================================================================
339
- describe("8. Integration Tests", () => {
340
- it("should render CopilotChat with all default components", () => {
341
- const { container } = render(
342
- <TestWrapper>
343
- <CopilotChat />
344
- </TestWrapper>,
345
- );
346
-
347
- // Should render the chat interface
348
- expect(container.firstChild).toBeDefined();
349
- });
350
-
351
- it("should combine chatView customization with nested slot customization via props", () => {
352
- const { container } = render(
353
- <TestWrapper>
354
- <CopilotChat
355
- chatView={{
356
- className: "root-chat-view",
357
- messageView: "custom-messages",
358
- input: "custom-input",
359
- scrollView: "custom-scroll",
360
- }}
361
- />
362
- </TestWrapper>,
363
- );
364
-
365
- expect(container.querySelector(".root-chat-view")).toBeDefined();
366
- expect(container.querySelector(".custom-messages")).toBeDefined();
367
- expect(container.querySelector(".custom-input")).toBeDefined();
368
- expect(container.querySelector(".custom-scroll")).toBeDefined();
369
- });
370
-
371
- it("should work with mixed props and tailwind classes", () => {
372
- const { container } = render(
373
- <TestWrapper>
374
- <CopilotChat
375
- chatView={{
376
- className: "mixed-class",
377
- }}
378
- />
379
- </TestWrapper>,
380
- );
381
-
382
- const chatView = container.querySelector(".mixed-class");
383
- expect(chatView).toBeDefined();
384
- });
385
-
386
- it("should handle transcription-related props", () => {
387
- const { container } = render(
388
- <TestWrapper>
389
- <CopilotChat />
390
- </TestWrapper>,
391
- );
392
-
393
- // Component should render without errors even with transcription features
394
- expect(container.firstChild).toBeDefined();
395
- });
396
- });
397
-
398
- // ============================================================================
399
- // 9. CALLBACK AND HANDLER TESTS
400
- // ============================================================================
401
- describe("9. Callback and Handler Tests", () => {
402
- it("should render CopilotChat and allow callback customization via custom component", () => {
403
- const onSubmitMessage = vi.fn();
404
- const CustomChatView: React.FC<any> = (props) => {
405
- // Use the provided onSubmitMessage or our custom one
406
- return <CopilotChatView {...props} onSubmitMessage={onSubmitMessage} />;
407
- };
408
-
409
- render(
410
- <TestWrapper>
411
- <CopilotChat chatView={CustomChatView as any} />
412
- </TestWrapper>,
413
- );
414
-
415
- // The component should render without errors
416
- expect(onSubmitMessage).not.toHaveBeenCalled();
417
- });
418
-
419
- it("should support suggestions rendering", () => {
420
- // Note: CopilotChat manages suggestions internally via useAutoSuggestions
421
- // We test that the chatView slot receives and renders suggestions
422
- render(
423
- <TestWrapper>
424
- <CopilotChat />
425
- </TestWrapper>,
426
- );
427
-
428
- // CopilotChat should render without errors
429
- // Actual suggestion rendering depends on agent state
430
- });
431
- });
432
- });
@@ -1,183 +0,0 @@
1
- import React from "react";
2
- import { render, screen, fireEvent, waitFor } from "@testing-library/react";
3
- import { beforeEach, vi } from "vitest";
4
- import { useConfigureSuggestions } from "../../../hooks/use-configure-suggestions";
5
- import { CopilotChat } from "../CopilotChat";
6
- import { CopilotKitProvider } from "../../../providers/CopilotKitProvider";
7
- import {
8
- MockStepwiseAgent,
9
- runStartedEvent,
10
- runFinishedEvent,
11
- textChunkEvent,
12
- testId,
13
- } from "../../../__tests__/utils/test-helpers";
14
- import type { AutoScrollMode } from "../normalize-auto-scroll";
15
-
16
- // jsdom doesn't implement scrollTo; pin-to-send mode calls it from a rAF
17
- // callback, so without this stub the cleanup throws an unhandled error.
18
- beforeEach(() => {
19
- HTMLElement.prototype.scrollTo = vi.fn();
20
- });
21
-
22
- const STATIC_SUGGESTIONS = [
23
- { title: "Say hello", message: "Hello there!" },
24
- { title: "Get help", message: "Can you help me?" },
25
- ];
26
-
27
- const ChatWithStaticAlwaysSuggestions: React.FC<{
28
- autoScroll?: AutoScrollMode | boolean;
29
- consumerAgentId?: string;
30
- }> = ({ autoScroll, consumerAgentId }) => {
31
- useConfigureSuggestions({
32
- suggestions: STATIC_SUGGESTIONS,
33
- available: "always",
34
- ...(consumerAgentId ? { consumerAgentId } : {}),
35
- });
36
-
37
- return <CopilotChat autoScroll={autoScroll} />;
38
- };
39
-
40
- function renderChat({
41
- agent,
42
- autoScroll,
43
- consumerAgentId,
44
- }: {
45
- agent: MockStepwiseAgent;
46
- autoScroll?: AutoScrollMode | boolean;
47
- consumerAgentId?: string;
48
- }) {
49
- return render(
50
- <CopilotKitProvider agents__unsafe_dev_only={{ default: agent }}>
51
- <div style={{ height: 400 }}>
52
- <ChatWithStaticAlwaysSuggestions
53
- autoScroll={autoScroll}
54
- consumerAgentId={consumerAgentId}
55
- />
56
- </div>
57
- </CopilotKitProvider>,
58
- );
59
- }
60
-
61
- describe("CopilotChat - static suggestions with available:'always'", () => {
62
- it("should show suggestions on the welcome screen", async () => {
63
- const agent = new MockStepwiseAgent();
64
- renderChat({ agent, consumerAgentId: "default" });
65
-
66
- await waitFor(() => {
67
- expect(screen.getByTestId("copilot-welcome-screen")).toBeDefined();
68
- });
69
-
70
- await waitFor(() => {
71
- expect(screen.getByText("Say hello")).toBeDefined();
72
- expect(screen.getByText("Get help")).toBeDefined();
73
- });
74
- });
75
-
76
- it("should show suggestions on the welcome screen with global config (no consumerAgentId)", async () => {
77
- const agent = new MockStepwiseAgent();
78
- renderChat({ agent });
79
-
80
- await waitFor(() => {
81
- expect(screen.getByTestId("copilot-welcome-screen")).toBeDefined();
82
- });
83
-
84
- await waitFor(() => {
85
- expect(screen.getByText("Say hello")).toBeDefined();
86
- expect(screen.getByText("Get help")).toBeDefined();
87
- });
88
- });
89
-
90
- it("should hide suggestions during a run and restore them after", async () => {
91
- const agent = new MockStepwiseAgent();
92
- renderChat({ agent, consumerAgentId: "default" });
93
-
94
- await waitFor(() => {
95
- expect(screen.getByTestId("copilot-welcome-screen")).toBeDefined();
96
- });
97
-
98
- await waitFor(() => {
99
- expect(screen.getByText("Say hello")).toBeDefined();
100
- });
101
-
102
- const input = await screen.findByRole("textbox");
103
- fireEvent.change(input, { target: { value: "Hi!" } });
104
- fireEvent.keyDown(input, { key: "Enter", code: "Enter" });
105
-
106
- await waitFor(() => {
107
- expect(screen.getByText("Hi!")).toBeDefined();
108
- });
109
-
110
- const messageId = testId("msg");
111
- agent.emit(runStartedEvent());
112
- agent.emit(textChunkEvent(messageId, "Hello! How can I help?"));
113
-
114
- // While the run is in flight, suggestions should be hidden — every run
115
- // changes the conversation context, so we wait for the end-of-run reload
116
- // before showing them again.
117
- await waitFor(() => {
118
- expect(screen.queryByText("Say hello")).toBeNull();
119
- expect(screen.queryByText("Get help")).toBeNull();
120
- });
121
-
122
- agent.emit(runFinishedEvent());
123
- agent.complete();
124
-
125
- await waitFor(() => {
126
- expect(screen.getByText("Hello! How can I help?")).toBeDefined();
127
- });
128
-
129
- // After the run, the static "always" config repopulates them.
130
- await waitFor(
131
- () => {
132
- expect(screen.getByText("Say hello")).toBeDefined();
133
- expect(screen.getByText("Get help")).toBeDefined();
134
- },
135
- { timeout: 3000 },
136
- );
137
- });
138
-
139
- it("should hide suggestions during a run in pin-to-send mode", async () => {
140
- const agent = new MockStepwiseAgent();
141
- renderChat({ agent, autoScroll: "pin-to-send" });
142
-
143
- await waitFor(() => {
144
- expect(screen.getByTestId("copilot-welcome-screen")).toBeDefined();
145
- });
146
-
147
- await waitFor(() => {
148
- expect(screen.getByText("Say hello")).toBeDefined();
149
- });
150
-
151
- const input = await screen.findByRole("textbox");
152
- fireEvent.change(input, { target: { value: "Hi!" } });
153
- fireEvent.keyDown(input, { key: "Enter", code: "Enter" });
154
-
155
- await waitFor(() => {
156
- expect(screen.getByText("Hi!")).toBeDefined();
157
- });
158
-
159
- const messageId = testId("msg");
160
- agent.emit(runStartedEvent());
161
- agent.emit(textChunkEvent(messageId, "Hello! How can I help?"));
162
-
163
- await waitFor(() => {
164
- expect(screen.queryByText("Say hello")).toBeNull();
165
- expect(screen.queryByText("Get help")).toBeNull();
166
- });
167
-
168
- agent.emit(runFinishedEvent());
169
- agent.complete();
170
-
171
- await waitFor(() => {
172
- expect(screen.getByText("Hello! How can I help?")).toBeDefined();
173
- });
174
-
175
- await waitFor(
176
- () => {
177
- expect(screen.getByText("Say hello")).toBeDefined();
178
- expect(screen.getByText("Get help")).toBeDefined();
179
- },
180
- { timeout: 3000 },
181
- );
182
- });
183
- });