@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,69 +0,0 @@
1
- import React, {
2
- createContext,
3
- useCallback,
4
- useContext,
5
- useState,
6
- ReactNode,
7
- SetStateAction,
8
- } from "react";
9
- import { randomUUID } from "@copilotkit/shared";
10
-
11
- export interface ThreadsContextValue {
12
- threadId: string;
13
- setThreadId: (value: SetStateAction<string>) => void;
14
- // True when the current threadId was chosen by the caller — either via
15
- // the `threadId` prop on <CopilotKit> / <ThreadsProvider>, or via a later
16
- // setThreadId() call. False when the provider minted a UUID on first
17
- // mount so downstream consumers don't have to treat that placeholder as
18
- // a real backend thread.
19
- isThreadIdExplicit: boolean;
20
- }
21
-
22
- const ThreadsContext = createContext<ThreadsContextValue | undefined>(
23
- undefined,
24
- );
25
-
26
- export interface ThreadsProviderProps {
27
- children: ReactNode;
28
- threadId?: string;
29
- }
30
-
31
- export function ThreadsProvider({
32
- children,
33
- threadId: explicitThreadId,
34
- }: ThreadsProviderProps) {
35
- const [internalThreadId, setInternalThreadId] = useState<string>(() =>
36
- randomUUID(),
37
- );
38
- const [internalIsExplicit, setInternalIsExplicit] = useState<boolean>(false);
39
-
40
- const threadId = explicitThreadId ?? internalThreadId;
41
- const isThreadIdExplicit = explicitThreadId != null || internalIsExplicit;
42
-
43
- const setThreadId = useCallback((value: SetStateAction<string>) => {
44
- setInternalThreadId(value);
45
- setInternalIsExplicit(true);
46
- }, []);
47
-
48
- return (
49
- <ThreadsContext.Provider
50
- value={{
51
- threadId,
52
- setThreadId,
53
- isThreadIdExplicit,
54
- }}
55
- >
56
- {children}
57
- </ThreadsContext.Provider>
58
- );
59
- }
60
-
61
- export function useThreads() {
62
- const context = useContext(ThreadsContext);
63
- if (!context) {
64
- throw new Error("useThreads must be used within ThreadsProvider");
65
- }
66
- return context;
67
- }
68
-
69
- export { ThreadsContext };
@@ -1,352 +0,0 @@
1
- import { vi } from "vitest";
2
- import { renderHook, waitFor } from "@testing-library/react";
3
- import { useCoAgent } from "../use-coagent";
4
- import type { AgentSubscriber } from "@ag-ui/client";
5
-
6
- // Mock functions for v2
7
- const mockSetState = vi.fn();
8
- const mockRunAgent = vi.fn();
9
- const mockAbortRun = vi.fn();
10
- const mockSubscribe = vi.fn();
11
- const mockSetProperties = vi.fn();
12
-
13
- // Store the last subscriber for triggering events
14
- let lastSubscriber: AgentSubscriber | null = null;
15
-
16
- const mockAgent = {
17
- agentId: "test-agent",
18
- state: { count: 0 },
19
- isRunning: false,
20
- threadId: "thread-123",
21
- setState: mockSetState,
22
- runAgent: mockRunAgent,
23
- abortRun: mockAbortRun,
24
- subscribe: mockSubscribe.mockImplementation((subscriber: AgentSubscriber) => {
25
- lastSubscriber = subscriber;
26
- return {
27
- unsubscribe: vi.fn(),
28
- };
29
- }),
30
- };
31
-
32
- vi.mock("../../v2", () => ({
33
- useAgent: vi.fn(() => ({ agent: mockAgent })),
34
- useCopilotKit: vi.fn(() => ({
35
- copilotkit: {
36
- setProperties: mockSetProperties,
37
- },
38
- })),
39
- }));
40
-
41
- // Mock other dependencies
42
- const mockAppendMessage = vi.fn();
43
- const mockRunChatCompletion = vi.fn();
44
-
45
- vi.mock("../use-copilot-chat_internal", () => ({
46
- useCopilotChat: () => ({
47
- appendMessage: mockAppendMessage,
48
- runChatCompletion: mockRunChatCompletion,
49
- }),
50
- }));
51
-
52
- vi.mock("../use-copilot-runtime-client", () => ({
53
- useCopilotRuntimeClient: () => ({
54
- loadAgentState: vi.fn().mockResolvedValue({
55
- data: { loadAgentState: { state: "{}", threadExists: false } },
56
- error: null,
57
- }),
58
- }),
59
- }));
60
-
61
- vi.mock("../../context", () => ({
62
- useCopilotContext: () => ({
63
- availableAgents: [],
64
- coagentStates: {},
65
- coagentStatesRef: { current: {} },
66
- threadId: "test-thread",
67
- copilotApiConfig: {
68
- headers: {},
69
- chatApiEndpoint: "test-endpoint",
70
- publicApiKey: "test-key",
71
- },
72
- showDevConsole: false,
73
- }),
74
- useCopilotMessagesContext: () => ({
75
- messages: [],
76
- }),
77
- }));
78
-
79
- vi.mock("../../components/toast/toast-provider", () => ({
80
- useToast: () => ({
81
- setBannerError: vi.fn(),
82
- }),
83
- }));
84
-
85
- vi.mock("../../components/error-boundary/error-utils", () => ({
86
- useAsyncCallback: (fn: any) => fn,
87
- }));
88
-
89
- vi.mock("../../components/copilot-provider/copilot-messages", () => ({
90
- useMessagesTap: () => ({
91
- getMessagesFromTap: vi.fn(() => []),
92
- updateTapMessages: vi.fn(),
93
- }),
94
- }));
95
-
96
- describe("useCoAgent config synchronization", () => {
97
- beforeEach(() => {
98
- vi.clearAllMocks();
99
- lastSubscriber = null;
100
- });
101
-
102
- it("should call setProperties when config changes", async () => {
103
- const { rerender } = renderHook(
104
- ({ config }) =>
105
- useCoAgent({
106
- name: "test-agent",
107
- initialState: { count: 0 },
108
- config,
109
- }),
110
- {
111
- initialProps: { config: { configurable: { model: "gpt-4" } } },
112
- },
113
- );
114
-
115
- // Clear the initial calls
116
- mockSetProperties.mockClear();
117
-
118
- // Change config
119
- rerender({ config: { configurable: { model: "gpt-4o" } } });
120
-
121
- // Wait for effect to complete and verify setProperties was called
122
- await waitFor(() => {
123
- expect(mockSetProperties).toHaveBeenCalledWith({
124
- configurable: { model: "gpt-4o" },
125
- });
126
- });
127
- });
128
-
129
- it("should not call setProperties when config is unchanged", () => {
130
- const config = { configurable: { model: "gpt-4" } };
131
-
132
- const { rerender } = renderHook(
133
- ({ config }) =>
134
- useCoAgent({
135
- name: "test-agent",
136
- initialState: { count: 0 },
137
- config,
138
- }),
139
- {
140
- initialProps: { config },
141
- },
142
- );
143
-
144
- // Clear the initial calls
145
- mockSetProperties.mockClear();
146
-
147
- // Re-render with same config reference
148
- rerender({ config });
149
-
150
- // Should not have called setProperties
151
- expect(mockSetProperties).not.toHaveBeenCalled();
152
- });
153
-
154
- it("should handle backward compatibility with configurable prop", async () => {
155
- const { rerender } = renderHook(
156
- ({ configurable }) =>
157
- useCoAgent({
158
- name: "test-agent",
159
- initialState: { count: 0 },
160
- configurable,
161
- }),
162
- {
163
- initialProps: { configurable: { model: "gpt-4" } },
164
- },
165
- );
166
-
167
- // Clear the initial calls
168
- mockSetProperties.mockClear();
169
-
170
- // Change configurable prop
171
- rerender({ configurable: { model: "gpt-4o" } });
172
-
173
- // Wait for effect to complete and verify setProperties was called
174
- await waitFor(() => {
175
- expect(mockSetProperties).toHaveBeenCalledWith({
176
- configurable: { model: "gpt-4o" },
177
- });
178
- });
179
- });
180
-
181
- it("should not call setProperties when both config and configurable are undefined", () => {
182
- renderHook(() =>
183
- useCoAgent({
184
- name: "test-agent",
185
- initialState: { count: 0 },
186
- }),
187
- );
188
-
189
- // Should not have called setProperties
190
- expect(mockSetProperties).not.toHaveBeenCalled();
191
- });
192
-
193
- it("should handle deeply nested config changes", async () => {
194
- const { rerender } = renderHook(
195
- ({ config }) =>
196
- useCoAgent({
197
- name: "test-agent",
198
- initialState: { count: 0 },
199
- config,
200
- }),
201
- {
202
- initialProps: {
203
- config: {
204
- configurable: {
205
- model: "gpt-4",
206
- settings: { temperature: 0.5 },
207
- },
208
- },
209
- },
210
- },
211
- );
212
-
213
- // Clear the initial calls
214
- mockSetProperties.mockClear();
215
-
216
- // Change nested config
217
- rerender({
218
- config: {
219
- configurable: {
220
- model: "gpt-4",
221
- settings: { temperature: 0.7 }, // Only nested property changed
222
- },
223
- },
224
- });
225
-
226
- // Wait for effect to complete and verify setProperties was called
227
- await waitFor(() => {
228
- expect(mockSetProperties).toHaveBeenCalledWith({
229
- configurable: {
230
- model: "gpt-4",
231
- settings: { temperature: 0.7 },
232
- },
233
- });
234
- });
235
- });
236
-
237
- describe("State Management", () => {
238
- // Helper to create mock subscriber params
239
- const createMockParams = (stateOverride: any = {}) => ({
240
- messages: [],
241
- state: stateOverride,
242
- agent: mockAgent as any,
243
- input: {} as any,
244
- });
245
-
246
- it("should initialize agent state via onRunInitialized event", () => {
247
- // Set agent to have NO state (empty object)
248
- mockAgent.state = {} as any;
249
-
250
- renderHook(() =>
251
- useCoAgent({
252
- name: "test-agent",
253
- initialState: { count: 42 },
254
- }),
255
- );
256
-
257
- // Verify subscription was created
258
- expect(mockSubscribe).toHaveBeenCalled();
259
- expect(lastSubscriber).toBeTruthy();
260
-
261
- // Clear any initial state calls
262
- mockSetState.mockClear();
263
-
264
- // Trigger onRunInitialized with no run state
265
- lastSubscriber?.onRunInitialized?.(createMockParams({}));
266
-
267
- // Should set state to initialState
268
- expect(mockSetState).toHaveBeenCalledWith({ count: 42 });
269
-
270
- // Reset agent state
271
- mockAgent.state = { count: 0 };
272
- });
273
-
274
- it("should preserve existing agent state on onRunInitialized", () => {
275
- // Set agent to have existing state
276
- mockAgent.state = { count: 100 };
277
-
278
- renderHook(() =>
279
- useCoAgent({
280
- name: "test-agent",
281
- initialState: { count: 42 },
282
- }),
283
- );
284
-
285
- // Clear any initial state calls
286
- mockSetState.mockClear();
287
-
288
- // Trigger onRunInitialized with no new state
289
- lastSubscriber?.onRunInitialized?.(createMockParams({}));
290
-
291
- // Should NOT override existing state
292
- expect(mockSetState).not.toHaveBeenCalled();
293
-
294
- // Reset agent state
295
- mockAgent.state = { count: 0 };
296
- });
297
-
298
- it("should prioritize run state over initialState", () => {
299
- renderHook(() =>
300
- useCoAgent({
301
- name: "test-agent",
302
- initialState: { count: 42 },
303
- }),
304
- );
305
-
306
- // Clear any initial state calls
307
- mockSetState.mockClear();
308
-
309
- // Trigger onRunInitialized with state from the run
310
- lastSubscriber?.onRunInitialized?.(createMockParams({ count: 999 }));
311
-
312
- // Should use run state, not initialState
313
- expect(mockSetState).toHaveBeenCalledWith({ count: 999 });
314
- });
315
-
316
- it("should handle setState with object updates", () => {
317
- const { result } = renderHook(() =>
318
- useCoAgent({
319
- name: "test-agent",
320
- initialState: { count: 0 },
321
- }),
322
- );
323
-
324
- // Update state with object
325
- result.current.setState({ count: 5 });
326
-
327
- // Should merge with existing state
328
- expect(mockSetState).toHaveBeenCalledWith({ count: 5 });
329
- });
330
-
331
- it("should handle setState with function updaters", () => {
332
- // Set current agent state
333
- mockAgent.state = { count: 10 };
334
-
335
- const { result } = renderHook(() =>
336
- useCoAgent({
337
- name: "test-agent",
338
- initialState: { count: 0 },
339
- }),
340
- );
341
-
342
- // Update state with function
343
- result.current.setState((prev) => ({ count: (prev?.count || 0) + 5 }));
344
-
345
- // Should call function with current state and set result
346
- expect(mockSetState).toHaveBeenCalledWith({ count: 15 });
347
-
348
- // Reset agent state
349
- mockAgent.state = { count: 0 };
350
- });
351
- });
352
- });
@@ -1,107 +0,0 @@
1
- import {
2
- ClaimAction,
3
- resolveClaim,
4
- selectSnapshot,
5
- type ClaimsByMessageId,
6
- type SnapshotCaches,
7
- type StateRenderContext,
8
- } from "../use-coagent-state-render-bridge.helpers";
9
-
10
- describe("useCoAgentStateRenderBridge helpers", () => {
11
- describe("resolveClaim", () => {
12
- it("updates runId for an existing claim", () => {
13
- const claims: ClaimsByMessageId = {
14
- msg1: { stateRenderId: "render-a", runId: "pending" },
15
- };
16
- const context: StateRenderContext = {
17
- agentId: "agent-1",
18
- stateRenderId: "render-a",
19
- messageId: "msg1",
20
- runId: "run-123",
21
- };
22
-
23
- const result = resolveClaim({
24
- claims,
25
- context,
26
- stateSnapshot: { step: 1 },
27
- });
28
- expect(result.action).toBe(ClaimAction.Existing);
29
- expect(result.canRender).toBe(true);
30
- expect(result.updateRunId).toBe("run-123");
31
- });
32
-
33
- it("overrides when a newer message index arrives", () => {
34
- const claims: ClaimsByMessageId = {
35
- msg1: {
36
- stateRenderId: "render-a",
37
- runId: "run-1",
38
- messageIndex: 0,
39
- stateSnapshot: { step: 2 },
40
- },
41
- };
42
- const context: StateRenderContext = {
43
- agentId: "agent-1",
44
- stateRenderId: "render-a",
45
- messageId: "msg2",
46
- runId: "run-1",
47
- messageIndex: 1,
48
- };
49
-
50
- const result = resolveClaim({
51
- claims,
52
- context,
53
- stateSnapshot: { step: 2 },
54
- });
55
- expect(result.action).toBe(ClaimAction.Override);
56
- expect(result.canRender).toBe(true);
57
- expect(result.nextClaim).toMatchObject({
58
- stateRenderId: "render-a",
59
- runId: "run-1",
60
- messageIndex: 1,
61
- });
62
- expect(result.lockOthers).toBe(true);
63
- });
64
- });
65
-
66
- describe("selectSnapshot", () => {
67
- const caches: SnapshotCaches = {
68
- byStateRenderAndRun: {},
69
- byMessageId: {},
70
- };
71
-
72
- it("prefers the explicit state snapshot prop", () => {
73
- const result = selectSnapshot({
74
- messageId: "msg1",
75
- stateRenderId: "render-a",
76
- effectiveRunId: "run-1",
77
- stateSnapshotProp: '{"phase":"planning"}',
78
- agentState: { phase: "ignored" },
79
- agentMessages: [{ id: "assistant-1", role: "assistant" }],
80
- caches,
81
- });
82
-
83
- expect(result.snapshot).toEqual({ phase: "planning" });
84
- expect(result.hasSnapshotKeys).toBe(true);
85
- });
86
-
87
- it("falls back to cached snapshots for non-latest assistant messages", () => {
88
- const result = selectSnapshot({
89
- messageId: "msg-old",
90
- stateRenderId: "render-a",
91
- effectiveRunId: "run-1",
92
- agentState: { phase: "live" },
93
- agentMessages: [{ id: "assistant-latest", role: "assistant" }],
94
- caches: {
95
- byStateRenderAndRun: {
96
- "render-a::run-1": { phase: "cached" },
97
- },
98
- byMessageId: {},
99
- },
100
- });
101
-
102
- expect(result.snapshot).toBeUndefined();
103
- expect(result.cachedSnapshot).toEqual({ phase: "cached" });
104
- expect(result.snapshotForClaim).toEqual({ phase: "cached" });
105
- });
106
- });
107
- });