@copilotkit/react-core 1.57.2 → 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 -296
  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,403 +0,0 @@
1
- /**
2
- * Tests for MCP Apps ui/message handler behavior.
3
- *
4
- * Verifies the followUp logic that controls whether the agent is invoked
5
- * after an MCP app sends a ui/message request via JSON-RPC:
6
- *
7
- * shouldFollowUp = params.followUp ?? role === "user"
8
- *
9
- * - User-role messages invoke runAgent (default followUp = true)
10
- * - Assistant-role messages do NOT invoke runAgent (default followUp = false)
11
- * - followUp: false skips runAgent regardless of role
12
- * - followUp: true forces runAgent regardless of role
13
- * - addMessage is always called when textContent is present
14
- */
15
- import { fireEvent, screen, waitFor, act } from "@testing-library/react";
16
- import { vi } from "vitest";
17
- import {
18
- activitySnapshotEvent,
19
- renderWithCopilotKit,
20
- runFinishedEvent,
21
- runStartedEvent,
22
- testId,
23
- } from "../../../__tests__/utils/test-helpers";
24
- import { MCPAppsActivityType } from "../../../components/MCPAppsActivityRenderer";
25
- import {
26
- AbstractAgent,
27
- RunAgentInput,
28
- RunAgentResult,
29
- BaseEvent,
30
- EventType,
31
- } from "@ag-ui/client";
32
- import { Observable, Subject } from "rxjs";
33
-
34
- /**
35
- * MockMCPProxyAgent with spying support for ui/message tests.
36
- */
37
- class MockMCPProxyAgent extends AbstractAgent {
38
- private subject = new Subject<BaseEvent>();
39
- public runAgentCalls: Array<{ input: Partial<RunAgentInput> }> = [];
40
- public addMessageCalls: Array<{
41
- id: string;
42
- role: string;
43
- content: string;
44
- }> = [];
45
-
46
- private runAgentResponses: Map<string, unknown> = new Map();
47
-
48
- setRunAgentResponse(method: string, response: unknown) {
49
- this.runAgentResponses.set(method, response);
50
- }
51
-
52
- addMessage(msg: Parameters<AbstractAgent["addMessage"]>[0]) {
53
- this.addMessageCalls.push(msg as any);
54
- return super.addMessage(msg);
55
- }
56
-
57
- emit(event: BaseEvent) {
58
- if (event.type === EventType.RUN_STARTED) {
59
- this.isRunning = true;
60
- } else if (
61
- event.type === EventType.RUN_FINISHED ||
62
- event.type === EventType.RUN_ERROR
63
- ) {
64
- this.isRunning = false;
65
- }
66
- act(() => {
67
- this.subject.next(event);
68
- });
69
- }
70
-
71
- complete() {
72
- this.isRunning = false;
73
- act(() => {
74
- this.subject.complete();
75
- });
76
- }
77
-
78
- async detachActiveRun(): Promise<void> {}
79
-
80
- run(_input: RunAgentInput): Observable<BaseEvent> {
81
- return this.subject.asObservable();
82
- }
83
-
84
- async runAgent(input?: Partial<RunAgentInput>): Promise<RunAgentResult> {
85
- const proxiedRequest = input?.forwardedProps?.__proxiedMCPRequest as
86
- | {
87
- serverHash?: string;
88
- serverId?: string;
89
- method: string;
90
- params?: Record<string, unknown>;
91
- }
92
- | undefined;
93
-
94
- if (proxiedRequest) {
95
- if (input) {
96
- this.runAgentCalls.push({ input });
97
- }
98
- const method = proxiedRequest.method;
99
- const response = this.runAgentResponses.get(method);
100
- if (response !== undefined) {
101
- return { result: response, newMessages: [] };
102
- }
103
- if (method === "resources/read") {
104
- return {
105
- result: {
106
- contents: [
107
- {
108
- uri: proxiedRequest.params?.uri,
109
- mimeType: "text/html",
110
- text: "<html><body>Test content</body></html>",
111
- },
112
- ],
113
- },
114
- newMessages: [],
115
- };
116
- }
117
- return { result: {}, newMessages: [] };
118
- }
119
-
120
- return super.runAgent(input);
121
- }
122
- }
123
-
124
- function mcpAppsActivityContent(overrides: {
125
- resourceUri?: string;
126
- serverHash?: string;
127
- }) {
128
- return {
129
- resourceUri: overrides.resourceUri ?? "ui://test-server/test-resource",
130
- serverHash: overrides.serverHash ?? "abc123hash",
131
- toolInput: {},
132
- result: {
133
- content: [{ type: "text", text: "Tool output" }],
134
- isError: false,
135
- },
136
- };
137
- }
138
-
139
- /**
140
- * Set up the agent, render, emit MCP activity, wait for iframe creation,
141
- * then simulate sandbox-proxy-ready so the message handler gets installed.
142
- */
143
- async function setupMCPActivity(
144
- agent: MockMCPProxyAgent,
145
- agentId: string,
146
- userMessage: string,
147
- ): Promise<HTMLIFrameElement> {
148
- agent.setRunAgentResponse("resources/read", {
149
- contents: [
150
- {
151
- uri: "ui://test/app",
152
- mimeType: "text/html",
153
- text: "<html><body>App</body></html>",
154
- },
155
- ],
156
- });
157
-
158
- // Use a unique threadId per test to avoid module-level mcpAppsRequestQueue
159
- // state leaking between tests (the queue keys by threadId).
160
- const threadId = testId("thread");
161
-
162
- renderWithCopilotKit({
163
- agents: { [agentId]: agent },
164
- agentId,
165
- threadId,
166
- });
167
-
168
- const input = await screen.findByRole("textbox");
169
- fireEvent.change(input, { target: { value: userMessage } });
170
- fireEvent.keyDown(input, { key: "Enter", code: "Enter" });
171
-
172
- await waitFor(() => {
173
- expect(screen.getByText(userMessage)).toBeDefined();
174
- });
175
-
176
- agent.emit(runStartedEvent());
177
- agent.emit(
178
- activitySnapshotEvent({
179
- messageId: testId("mcp-activity"),
180
- activityType: MCPAppsActivityType,
181
- content: mcpAppsActivityContent({
182
- resourceUri: "ui://test/app",
183
- serverHash: "test-hash",
184
- }),
185
- }),
186
- );
187
- agent.emit(runFinishedEvent());
188
-
189
- // Wait for iframe to be created
190
- let iframe: HTMLIFrameElement | null = null;
191
- await waitFor(
192
- () => {
193
- iframe = document.querySelector("iframe[srcdoc]");
194
- expect(iframe).not.toBeNull();
195
- },
196
- { timeout: 3000 },
197
- );
198
-
199
- // Simulate sandbox-proxy-ready notification from the iframe.
200
- // The message handler checks event.source === iframe.contentWindow.
201
- // In jsdom, iframe.contentWindow exists for srcdoc iframes.
202
- const readyEvent = new MessageEvent("message", {
203
- data: {
204
- jsonrpc: "2.0",
205
- method: "ui/notifications/sandbox-proxy-ready",
206
- },
207
- source: iframe!.contentWindow,
208
- origin: "",
209
- });
210
-
211
- await act(async () => {
212
- window.dispatchEvent(readyEvent);
213
- // Give async setup() time to install the messageHandler
214
- await new Promise((resolve) => setTimeout(resolve, 100));
215
- });
216
-
217
- return iframe!;
218
- }
219
-
220
- /**
221
- * Send a ui/message JSON-RPC request as if coming from the iframe.
222
- */
223
- async function sendUiMessage(
224
- iframe: HTMLIFrameElement,
225
- params: {
226
- role?: string;
227
- content?: Array<{ type: string; text?: string }>;
228
- followUp?: boolean;
229
- },
230
- ) {
231
- const msg = new MessageEvent("message", {
232
- data: {
233
- jsonrpc: "2.0",
234
- id: testId("req"),
235
- method: "ui/message",
236
- params,
237
- },
238
- source: iframe.contentWindow,
239
- origin: "",
240
- });
241
-
242
- await act(async () => {
243
- window.dispatchEvent(msg);
244
- await new Promise((resolve) => setTimeout(resolve, 200));
245
- });
246
- }
247
-
248
- describe("MCP Apps ui/message followUp behavior", () => {
249
- beforeEach(() => {
250
- vi.clearAllMocks();
251
- });
252
-
253
- it("user-role message: addMessage IS called and runAgent IS invoked", async () => {
254
- const agent = new MockMCPProxyAgent();
255
- agent.agentId = "ui-msg-agent-user";
256
-
257
- const iframe = await setupMCPActivity(
258
- agent,
259
- "ui-msg-agent-user",
260
- "User role test",
261
- );
262
-
263
- const runSpy = vi.spyOn(agent, "run");
264
-
265
- await sendUiMessage(iframe, {
266
- role: "user",
267
- content: [{ type: "text", text: "Hello from MCP app" }],
268
- });
269
-
270
- // addMessage should have been called
271
- const userMsgCalls = agent.addMessageCalls.filter(
272
- (c) => c.content === "Hello from MCP app" && c.role === "user",
273
- );
274
- expect(userMsgCalls.length).toBeGreaterThanOrEqual(1);
275
-
276
- // runAgent should have been invoked (user role defaults to followUp: true)
277
- expect(runSpy.mock.calls.length).toBeGreaterThan(0);
278
- });
279
-
280
- it("assistant-role message: addMessage IS called but runAgent is NOT invoked", async () => {
281
- const agent = new MockMCPProxyAgent();
282
- agent.agentId = "ui-msg-agent-assist";
283
-
284
- const iframe = await setupMCPActivity(
285
- agent,
286
- "ui-msg-agent-assist",
287
- "Assist role test",
288
- );
289
-
290
- const runSpy = vi.spyOn(agent, "run");
291
-
292
- await sendUiMessage(iframe, {
293
- role: "assistant",
294
- content: [{ type: "text", text: "Response from MCP" }],
295
- });
296
-
297
- // addMessage should have been called
298
- const assistCalls = agent.addMessageCalls.filter(
299
- (c) => c.content === "Response from MCP" && c.role === "assistant",
300
- );
301
- expect(assistCalls.length).toBeGreaterThanOrEqual(1);
302
-
303
- // run() should NOT have been called
304
- expect(runSpy.mock.calls.length).toBe(0);
305
- });
306
-
307
- it("followUp: false on user-role message: addMessage IS called but runAgent is NOT invoked", async () => {
308
- const agent = new MockMCPProxyAgent();
309
- agent.agentId = "ui-msg-agent-nofollowup";
310
-
311
- const iframe = await setupMCPActivity(
312
- agent,
313
- "ui-msg-agent-nofollowup",
314
- "No followUp test",
315
- );
316
-
317
- const runSpy = vi.spyOn(agent, "run");
318
-
319
- await sendUiMessage(iframe, {
320
- role: "user",
321
- content: [{ type: "text", text: "Display only message" }],
322
- followUp: false,
323
- });
324
-
325
- // addMessage should have been called
326
- const calls = agent.addMessageCalls.filter(
327
- (c) => c.content === "Display only message",
328
- );
329
- expect(calls.length).toBeGreaterThanOrEqual(1);
330
-
331
- // run() should NOT have been called
332
- expect(runSpy.mock.calls.length).toBe(0);
333
- });
334
-
335
- it("followUp: true on assistant-role message: addMessage IS called AND runAgent IS invoked", async () => {
336
- const agent = new MockMCPProxyAgent();
337
- agent.agentId = "ui-msg-agent-force";
338
-
339
- const iframe = await setupMCPActivity(
340
- agent,
341
- "ui-msg-agent-force",
342
- "Force followUp test",
343
- );
344
-
345
- const runSpy = vi.spyOn(agent, "run");
346
-
347
- await sendUiMessage(iframe, {
348
- role: "assistant",
349
- content: [{ type: "text", text: "Assistant with followUp" }],
350
- followUp: true,
351
- });
352
-
353
- // addMessage should have been called
354
- const calls = agent.addMessageCalls.filter(
355
- (c) => c.content === "Assistant with followUp",
356
- );
357
- expect(calls.length).toBeGreaterThanOrEqual(1);
358
-
359
- // run() should have been called
360
- expect(runSpy.mock.calls.length).toBeGreaterThan(0);
361
- });
362
-
363
- it("message with text content always adds to agent messages regardless of followUp", async () => {
364
- const agent = new MockMCPProxyAgent();
365
- agent.agentId = "ui-msg-agent-all";
366
-
367
- const iframe = await setupMCPActivity(
368
- agent,
369
- "ui-msg-agent-all",
370
- "All messages test",
371
- );
372
-
373
- await sendUiMessage(iframe, {
374
- role: "user",
375
- content: [{ type: "text", text: "User msg" }],
376
- });
377
-
378
- await sendUiMessage(iframe, {
379
- role: "assistant",
380
- content: [{ type: "text", text: "Assistant msg" }],
381
- });
382
-
383
- await sendUiMessage(iframe, {
384
- role: "user",
385
- content: [{ type: "text", text: "No followUp msg" }],
386
- followUp: false,
387
- });
388
-
389
- const userCalls = agent.addMessageCalls.filter(
390
- (c) => c.content === "User msg",
391
- );
392
- const assistCalls = agent.addMessageCalls.filter(
393
- (c) => c.content === "Assistant msg",
394
- );
395
- const noFollowCalls = agent.addMessageCalls.filter(
396
- (c) => c.content === "No followUp msg",
397
- );
398
-
399
- expect(userCalls.length).toBeGreaterThanOrEqual(1);
400
- expect(assistCalls.length).toBeGreaterThanOrEqual(1);
401
- expect(noFollowCalls.length).toBeGreaterThanOrEqual(1);
402
- });
403
- });
@@ -1,137 +0,0 @@
1
- import React from "react";
2
- import { render } from "@testing-library/react";
3
- import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
4
- import { CopilotChat } from "../CopilotChat";
5
- import { useAgent } from "../../../hooks/use-agent";
6
- import { useCopilotKit } from "../../../providers/CopilotKitProvider";
7
- import { MockStepwiseAgent } from "../../../__tests__/utils/test-helpers";
8
- import { CopilotKitCoreRuntimeConnectionStatus } from "@copilotkit/core";
9
-
10
- // Mock useAgent to inspect the props it receives
11
- vi.mock("../../../hooks/use-agent", () => ({
12
- useAgent: vi.fn(() => ({
13
- agent: new MockStepwiseAgent(),
14
- })),
15
- }));
16
-
17
- vi.mock("../../../providers/CopilotKitProvider", () => ({
18
- useCopilotKit: vi.fn(),
19
- useLicenseContext: vi.fn(() => ({
20
- checkFeature: () => true,
21
- })),
22
- }));
23
-
24
- vi.mock(
25
- "../../../providers/CopilotChatConfigurationProvider",
26
- async (importOriginal) => {
27
- const actual =
28
- await importOriginal<
29
- typeof import("../../../providers/CopilotChatConfigurationProvider")
30
- >();
31
- return {
32
- ...actual,
33
- useCopilotChatConfiguration: vi.fn(() => undefined),
34
- CopilotChatConfigurationProvider: ({
35
- children,
36
- }: {
37
- children: React.ReactNode;
38
- }) => <>{children}</>,
39
- };
40
- },
41
- );
42
-
43
- // Mock suggestions hook
44
- vi.mock("../../../hooks/use-suggestions", () => ({
45
- useSuggestions: vi.fn(() => ({ suggestions: [] })),
46
- }));
47
-
48
- // Mock attachments hook
49
- vi.mock("../../../hooks/use-attachments", () => ({
50
- useAttachments: vi.fn(() => ({
51
- attachments: [],
52
- enabled: false,
53
- dragOver: false,
54
- fileInputRef: { current: null },
55
- containerRef: { current: null },
56
- handleFileUpload: vi.fn(),
57
- handleDragOver: vi.fn(),
58
- handleDragLeave: vi.fn(),
59
- handleDrop: vi.fn(),
60
- removeAttachment: vi.fn(),
61
- consumeAttachments: vi.fn(() => []),
62
- })),
63
- }));
64
-
65
- const mockUseAgent = useAgent as ReturnType<typeof vi.fn>;
66
- const mockUseCopilotKit = useCopilotKit as ReturnType<typeof vi.fn>;
67
-
68
- /** Factory for the mock return value of useCopilotKit in CopilotChat tests */
69
- function createMockChatContext(agent: MockStepwiseAgent) {
70
- return {
71
- copilotkit: {
72
- getAgent: () => agent,
73
- runtimeUrl: "http://localhost:3000/api/copilot",
74
- runtimeConnectionStatus: CopilotKitCoreRuntimeConnectionStatus.Connected,
75
- runtimeTransport: "rest",
76
- headers: {},
77
- agents: { [String(agent.agentId)]: agent },
78
- connectAgent: vi.fn().mockResolvedValue(undefined),
79
- subscribe: vi.fn(() => ({ unsubscribe: vi.fn() })),
80
- audioFileTranscriptionEnabled: false,
81
- },
82
- executingToolCallIds: new Set(),
83
- };
84
- }
85
-
86
- describe("CopilotChat throttleMs prop", () => {
87
- let mockAgent: MockStepwiseAgent;
88
-
89
- beforeEach(() => {
90
- mockAgent = new MockStepwiseAgent();
91
- mockAgent.agentId = "default";
92
-
93
- mockUseAgent.mockReturnValue({ agent: mockAgent });
94
- mockUseCopilotKit.mockReturnValue(createMockChatContext(mockAgent));
95
- });
96
-
97
- afterEach(() => {
98
- vi.restoreAllMocks();
99
- });
100
-
101
- it("passes throttleMs prop to useAgent", () => {
102
- render(<CopilotChat throttleMs={500} />);
103
-
104
- expect(mockUseAgent).toHaveBeenCalledWith(
105
- expect.objectContaining({
106
- throttleMs: 500,
107
- }),
108
- );
109
- });
110
-
111
- it("passes undefined throttleMs when prop is not set", () => {
112
- render(<CopilotChat />);
113
-
114
- expect(mockUseAgent).toHaveBeenCalledWith(
115
- expect.objectContaining({
116
- throttleMs: undefined,
117
- }),
118
- );
119
- });
120
- });
121
-
122
- describe("throttleMs type inheritance", () => {
123
- it("CopilotSidebarProps includes throttleMs via CopilotChatProps", () => {
124
- // Type-level assertion — if this compiles, the type includes throttleMs.
125
- const sidebarProps: import("../CopilotSidebar").CopilotSidebarProps = {
126
- throttleMs: 1000,
127
- };
128
- expect(sidebarProps.throttleMs).toBe(1000);
129
- });
130
-
131
- it("CopilotPopupProps includes throttleMs via CopilotChatProps", () => {
132
- const popupProps: import("../CopilotPopup").CopilotPopupProps = {
133
- throttleMs: 2000,
134
- };
135
- expect(popupProps.throttleMs).toBe(2000);
136
- });
137
- });
@@ -1,37 +0,0 @@
1
- import { describe, it, expect } from "vitest";
2
- import {
3
- normalizeAutoScroll,
4
- type AutoScrollMode,
5
- } from "../normalize-auto-scroll";
6
-
7
- describe("normalizeAutoScroll", () => {
8
- it("returns 'pin-to-bottom' for undefined (default)", () => {
9
- expect(normalizeAutoScroll(undefined)).toBe("pin-to-bottom");
10
- });
11
-
12
- it("maps true -> 'pin-to-bottom'", () => {
13
- expect(normalizeAutoScroll(true)).toBe("pin-to-bottom");
14
- });
15
-
16
- it("maps false -> 'none'", () => {
17
- expect(normalizeAutoScroll(false)).toBe("none");
18
- });
19
-
20
- it("passes 'pin-to-bottom' through", () => {
21
- expect(normalizeAutoScroll("pin-to-bottom")).toBe("pin-to-bottom");
22
- });
23
-
24
- it("passes 'pin-to-send' through", () => {
25
- expect(normalizeAutoScroll("pin-to-send")).toBe("pin-to-send");
26
- });
27
-
28
- it("passes 'none' through", () => {
29
- expect(normalizeAutoScroll("none")).toBe("none");
30
- });
31
-
32
- it("falls back to 'pin-to-bottom' for unknown strings", () => {
33
- expect(normalizeAutoScroll("bogus" as AutoScrollMode)).toBe(
34
- "pin-to-bottom",
35
- );
36
- });
37
- });
@@ -1 +0,0 @@
1
- import "@testing-library/jest-dom";
@@ -1,90 +0,0 @@
1
- export {
2
- default as CopilotChatInput,
3
- type CopilotChatInputProps,
4
- type ToolsMenuItem,
5
- } from "./CopilotChatInput";
6
-
7
- export {
8
- default as CopilotChatAssistantMessage,
9
- type CopilotChatAssistantMessageProps,
10
- } from "./CopilotChatAssistantMessage";
11
-
12
- export {
13
- default as CopilotChatUserMessage,
14
- type CopilotChatUserMessageProps,
15
- } from "./CopilotChatUserMessage";
16
-
17
- export {
18
- default as CopilotChatReasoningMessage,
19
- type CopilotChatReasoningMessageProps,
20
- } from "./CopilotChatReasoningMessage";
21
-
22
- export {
23
- CopilotChatAudioRecorder,
24
- type AudioRecorderState,
25
- AudioRecorderError,
26
- } from "./CopilotChatAudioRecorder";
27
-
28
- export {
29
- default as CopilotChatSuggestionPill,
30
- type CopilotChatSuggestionPillProps,
31
- } from "./CopilotChatSuggestionPill";
32
-
33
- export {
34
- default as CopilotChatSuggestionView,
35
- type CopilotChatSuggestionViewProps,
36
- } from "./CopilotChatSuggestionView";
37
-
38
- export {
39
- default as CopilotChatMessageView,
40
- type CopilotChatMessageViewProps,
41
- } from "./CopilotChatMessageView";
42
-
43
- export {
44
- default as CopilotChatToolCallsView,
45
- type CopilotChatToolCallsViewProps,
46
- } from "./CopilotChatToolCallsView";
47
-
48
- export {
49
- default as CopilotChatView,
50
- type CopilotChatViewProps,
51
- } from "./CopilotChatView";
52
-
53
- export { CopilotChat, type CopilotChatProps } from "./CopilotChat";
54
-
55
- export {
56
- CopilotChatToggleButton,
57
- type CopilotChatToggleButtonProps,
58
- CopilotChatToggleButtonOpenIcon,
59
- CopilotChatToggleButtonCloseIcon,
60
- } from "./CopilotChatToggleButton";
61
-
62
- export {
63
- CopilotSidebarView,
64
- type CopilotSidebarViewProps,
65
- } from "./CopilotSidebarView";
66
-
67
- export {
68
- CopilotPopupView,
69
- type CopilotPopupViewProps,
70
- } from "./CopilotPopupView";
71
-
72
- export {
73
- CopilotModalHeader,
74
- type CopilotModalHeaderProps,
75
- } from "./CopilotModalHeader";
76
-
77
- export { CopilotSidebar, type CopilotSidebarProps } from "./CopilotSidebar";
78
-
79
- export { CopilotPopup, type CopilotPopupProps } from "./CopilotPopup";
80
-
81
- export { CopilotChatAttachmentQueue } from "./CopilotChatAttachmentQueue";
82
- export { CopilotChatAttachmentRenderer } from "./CopilotChatAttachmentRenderer";
83
-
84
- export type {
85
- Attachment,
86
- AttachmentsConfig,
87
- AttachmentModality,
88
- } from "@copilotkit/shared";
89
-
90
- export type { AutoScrollMode } from "./normalize-auto-scroll";
@@ -1,21 +0,0 @@
1
- import React from "react";
2
-
3
- /**
4
- * Context used by `CopilotChatView` to announce the latest user message
5
- * to descendants (notably `usePinToSend`), so scroll logic can anchor
6
- * the viewport to the most recent user turn in "pin-to-send" mode.
7
- *
8
- * `sendNonce` increments on each new send so repeated IDs (e.g., message
9
- * edits that preserve the ID) still trigger dependent effects.
10
- */
11
- export type LastUserMessageState = {
12
- id: string | null;
13
- sendNonce: number;
14
- };
15
-
16
- export const LastUserMessageContext = React.createContext<LastUserMessageState>(
17
- {
18
- id: null,
19
- sendNonce: 0,
20
- },
21
- );
@@ -1,17 +0,0 @@
1
- export type AutoScrollMode = "pin-to-bottom" | "pin-to-send" | "none";
2
-
3
- const VALID: readonly AutoScrollMode[] = [
4
- "pin-to-bottom",
5
- "pin-to-send",
6
- "none",
7
- ];
8
-
9
- export function normalizeAutoScroll(
10
- value: AutoScrollMode | boolean | undefined,
11
- ): AutoScrollMode {
12
- if (value === undefined) return "pin-to-bottom";
13
- if (value === true) return "pin-to-bottom";
14
- if (value === false) return "none";
15
- if ((VALID as readonly string[]).includes(value)) return value;
16
- return "pin-to-bottom";
17
- }