@copilotkit/react-core 1.57.3 → 1.58.0-canary.thread-id-propagation

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 (292) hide show
  1. package/LICENSE +21 -0
  2. package/dist/{copilotkit-CtXcs1ea.cjs → copilotkit-B4ouY7qC.cjs} +14 -3
  3. package/dist/copilotkit-B4ouY7qC.cjs.map +1 -0
  4. package/dist/copilotkit-BK9CVq9A.d.cts.map +1 -1
  5. package/dist/{copilotkit-CC8DjOiC.mjs → copilotkit-L4mM_JqG.mjs} +14 -3
  6. package/dist/copilotkit-L4mM_JqG.mjs.map +1 -0
  7. package/dist/copilotkit-WlmeVijs.d.mts.map +1 -1
  8. package/dist/index.cjs +3 -77
  9. package/dist/index.cjs.map +1 -1
  10. package/dist/index.d.cts +2 -2
  11. package/dist/index.d.mts +2 -2
  12. package/dist/index.mjs +3 -77
  13. package/dist/index.mjs.map +1 -1
  14. package/dist/index.umd.js +15 -78
  15. package/dist/index.umd.js.map +1 -1
  16. package/dist/v2/headless.cjs +11 -0
  17. package/dist/v2/headless.cjs.map +1 -1
  18. package/dist/v2/headless.d.cts.map +1 -1
  19. package/dist/v2/headless.d.mts.map +1 -1
  20. package/dist/v2/headless.mjs +11 -0
  21. package/dist/v2/headless.mjs.map +1 -1
  22. package/dist/v2/index.cjs +1 -1
  23. package/dist/v2/index.mjs +1 -1
  24. package/dist/v2/index.umd.js +13 -2
  25. package/dist/v2/index.umd.js.map +1 -1
  26. package/package.json +12 -13
  27. package/skills/react-core/SKILL.md +108 -0
  28. package/skills/react-core/references/agent-access.md +288 -0
  29. package/skills/react-core/references/attachments.md +291 -0
  30. package/skills/react-core/references/capabilities.md +138 -0
  31. package/skills/react-core/references/chat-components.md +221 -0
  32. package/skills/react-core/references/client-side-tools.md +358 -0
  33. package/skills/react-core/references/custom-message-renderers.md +226 -0
  34. package/skills/react-core/references/debug-mode.md +153 -0
  35. package/skills/react-core/references/human-in-the-loop.md +312 -0
  36. package/skills/react-core/references/provider-setup.md +326 -0
  37. package/skills/react-core/references/rendering-activity-messages.md +207 -0
  38. package/skills/react-core/references/rendering-tool-calls.md +319 -0
  39. package/skills/react-core/references/suggestions.md +211 -0
  40. package/skills/react-core/references/switching-agents-recipes.md +160 -0
  41. package/skills/react-core/references/switching-agents.md +231 -0
  42. package/skills/react-core/references/threads.md +226 -0
  43. package/.attw.json +0 -3
  44. package/CHANGELOG.md +0 -5043
  45. package/dist/copilotkit-CC8DjOiC.mjs.map +0 -1
  46. package/dist/copilotkit-CtXcs1ea.cjs.map +0 -1
  47. package/scripts/scope-preflight.mjs +0 -100
  48. package/src/components/CopilotListeners.tsx +0 -137
  49. package/src/components/__tests__/CopilotListeners.test.tsx +0 -38
  50. package/src/components/copilot-provider/__tests__/copilot-messages-key.test.tsx +0 -92
  51. package/src/components/copilot-provider/__tests__/copilotkit-error.test.tsx +0 -77
  52. package/src/components/copilot-provider/__tests__/error-visibility-prod.test.tsx +0 -70
  53. package/src/components/copilot-provider/__tests__/v1-explicit-threadid-bridge.test.tsx +0 -107
  54. package/src/components/copilot-provider/copilot-messages.tsx +0 -314
  55. package/src/components/copilot-provider/copilotkit-props.tsx +0 -214
  56. package/src/components/copilot-provider/copilotkit.tsx +0 -853
  57. package/src/components/copilot-provider/index.ts +0 -3
  58. package/src/components/dev-console/console-trigger.tsx +0 -283
  59. package/src/components/dev-console/developer-console-modal.tsx +0 -1016
  60. package/src/components/dev-console/icons.tsx +0 -106
  61. package/src/components/error-boundary/error-boundary.tsx +0 -99
  62. package/src/components/error-boundary/error-utils.tsx +0 -105
  63. package/src/components/index.ts +0 -1
  64. package/src/components/toast/exclamation-mark-icon.tsx +0 -27
  65. package/src/components/toast/toast-provider.tsx +0 -448
  66. package/src/components/usage-banner.tsx +0 -266
  67. package/src/context/__tests__/threads-context.test.tsx +0 -141
  68. package/src/context/coagent-state-renders-context.tsx +0 -89
  69. package/src/context/copilot-context.tsx +0 -365
  70. package/src/context/copilot-messages-context.tsx +0 -35
  71. package/src/context/index.ts +0 -22
  72. package/src/context/threads-context.tsx +0 -69
  73. package/src/hooks/__tests__/use-coagent-config.test.ts +0 -352
  74. package/src/hooks/__tests__/use-coagent-state-render-bridge.helpers.test.ts +0 -107
  75. package/src/hooks/__tests__/use-coagent-state-render.e2e.test.tsx +0 -1209
  76. package/src/hooks/__tests__/use-coagent-state-render.test.tsx +0 -356
  77. package/src/hooks/__tests__/use-copilot-chat-internal-connect.test.tsx +0 -241
  78. package/src/hooks/__tests__/use-frontend-tool-available.test.tsx +0 -72
  79. package/src/hooks/__tests__/use-frontend-tool-remount.e2e.test.tsx +0 -102
  80. package/src/hooks/index.ts +0 -33
  81. package/src/hooks/use-agent-nodename.ts +0 -33
  82. package/src/hooks/use-coagent-state-render-bridge.helpers.ts +0 -345
  83. package/src/hooks/use-coagent-state-render-bridge.tsx +0 -222
  84. package/src/hooks/use-coagent-state-render-registry.ts +0 -230
  85. package/src/hooks/use-coagent-state-render.ts +0 -163
  86. package/src/hooks/use-coagent.ts +0 -377
  87. package/src/hooks/use-configure-chat-suggestions.tsx +0 -96
  88. package/src/hooks/use-copilot-action.ts +0 -245
  89. package/src/hooks/use-copilot-additional-instructions.ts +0 -98
  90. package/src/hooks/use-copilot-authenticated-action.ts +0 -73
  91. package/src/hooks/use-copilot-chat-headless_c.ts +0 -264
  92. package/src/hooks/use-copilot-chat-suggestions.tsx +0 -134
  93. package/src/hooks/use-copilot-chat.ts +0 -132
  94. package/src/hooks/use-copilot-chat_internal.ts +0 -875
  95. package/src/hooks/use-copilot-readable.ts +0 -135
  96. package/src/hooks/use-copilot-runtime-client.ts +0 -178
  97. package/src/hooks/use-default-tool.ts +0 -13
  98. package/src/hooks/use-flat-category-store.ts +0 -109
  99. package/src/hooks/use-frontend-tool.ts +0 -113
  100. package/src/hooks/use-human-in-the-loop.ts +0 -138
  101. package/src/hooks/use-langgraph-interrupt.ts +0 -103
  102. package/src/hooks/use-lazy-tool-renderer.tsx +0 -30
  103. package/src/hooks/use-make-copilot-document-readable.ts +0 -30
  104. package/src/hooks/use-render-tool-call.ts +0 -89
  105. package/src/hooks/use-tree.ts +0 -222
  106. package/src/index.tsx +0 -7
  107. package/src/lib/copilot-task.ts +0 -215
  108. package/src/lib/index.ts +0 -1
  109. package/src/lib/status-checker.ts +0 -67
  110. package/src/setupTests.ts +0 -37
  111. package/src/test-helpers/copilot-context.ts +0 -91
  112. package/src/types/chat-suggestion-configuration.ts +0 -23
  113. package/src/types/coagent-action.ts +0 -35
  114. package/src/types/coagent-state.ts +0 -13
  115. package/src/types/crew.ts +0 -89
  116. package/src/types/document-pointer.ts +0 -7
  117. package/src/types/frontend-action.ts +0 -213
  118. package/src/types/index.ts +0 -17
  119. package/src/types/interrupt-action.ts +0 -58
  120. package/src/types/system-message.ts +0 -4
  121. package/src/utils/dev-console.ts +0 -19
  122. package/src/utils/index.ts +0 -2
  123. package/src/utils/suggestions-constants.ts +0 -8
  124. package/src/utils/utils.test.ts +0 -7
  125. package/src/utils/utils.ts +0 -6
  126. package/src/v2/__tests__/A2UIMessageRenderer.test.tsx +0 -240
  127. package/src/v2/__tests__/globalSetup.ts +0 -14
  128. package/src/v2/__tests__/setup.ts +0 -93
  129. package/src/v2/__tests__/utils/test-helpers.tsx +0 -570
  130. package/src/v2/a2ui/A2UICatalogContext.tsx +0 -79
  131. package/src/v2/a2ui/A2UIMessageRenderer.tsx +0 -294
  132. package/src/v2/a2ui/A2UIToolCallRenderer.tsx +0 -290
  133. package/src/v2/components/CopilotKitInspector.tsx +0 -52
  134. package/src/v2/components/MCPAppsActivityRenderer.tsx +0 -815
  135. package/src/v2/components/OpenGenerativeUIRenderer.tsx +0 -598
  136. package/src/v2/components/WildcardToolCallRender.tsx +0 -86
  137. package/src/v2/components/__tests__/OpenGenerativeUIRenderer.test.tsx +0 -665
  138. package/src/v2/components/chat/CopilotChat.tsx +0 -664
  139. package/src/v2/components/chat/CopilotChatAssistantMessage.tsx +0 -393
  140. package/src/v2/components/chat/CopilotChatAttachmentQueue.tsx +0 -374
  141. package/src/v2/components/chat/CopilotChatAttachmentRenderer.tsx +0 -159
  142. package/src/v2/components/chat/CopilotChatAudioRecorder.tsx +0 -350
  143. package/src/v2/components/chat/CopilotChatInput.tsx +0 -1412
  144. package/src/v2/components/chat/CopilotChatMessageView.tsx +0 -716
  145. package/src/v2/components/chat/CopilotChatReasoningMessage.tsx +0 -265
  146. package/src/v2/components/chat/CopilotChatSuggestionPill.tsx +0 -59
  147. package/src/v2/components/chat/CopilotChatSuggestionView.tsx +0 -134
  148. package/src/v2/components/chat/CopilotChatToggleButton.tsx +0 -171
  149. package/src/v2/components/chat/CopilotChatToolCallsView.tsx +0 -40
  150. package/src/v2/components/chat/CopilotChatUserMessage.tsx +0 -445
  151. package/src/v2/components/chat/CopilotChatView.tsx +0 -890
  152. package/src/v2/components/chat/CopilotModalHeader.tsx +0 -129
  153. package/src/v2/components/chat/CopilotPopup.tsx +0 -81
  154. package/src/v2/components/chat/CopilotPopupView.tsx +0 -317
  155. package/src/v2/components/chat/CopilotSidebar.tsx +0 -80
  156. package/src/v2/components/chat/CopilotSidebarView.tsx +0 -269
  157. package/src/v2/components/chat/Lightbox.tsx +0 -103
  158. package/src/v2/components/chat/__tests__/CopilotChat.absentThreadConnect.test.tsx +0 -66
  159. package/src/v2/components/chat/__tests__/CopilotChat.attachments.test.tsx +0 -168
  160. package/src/v2/components/chat/__tests__/CopilotChat.e2e.test.tsx +0 -1239
  161. package/src/v2/components/chat/__tests__/CopilotChat.onError.test.tsx +0 -73
  162. package/src/v2/components/chat/__tests__/CopilotChat.slots.e2e.test.tsx +0 -432
  163. package/src/v2/components/chat/__tests__/CopilotChat.suggestionsAlways.test.tsx +0 -183
  164. package/src/v2/components/chat/__tests__/CopilotChat.welcomeGate.test.tsx +0 -184
  165. package/src/v2/components/chat/__tests__/CopilotChatActivityRendering.e2e.test.tsx +0 -649
  166. package/src/v2/components/chat/__tests__/CopilotChatAssistantMessage.slots.e2e.test.tsx +0 -624
  167. package/src/v2/components/chat/__tests__/CopilotChatAssistantMessage.test.tsx +0 -702
  168. package/src/v2/components/chat/__tests__/CopilotChatAssistantMessage.thumbs.test.tsx +0 -72
  169. package/src/v2/components/chat/__tests__/CopilotChatCopyButton.clipboard.test.tsx +0 -241
  170. package/src/v2/components/chat/__tests__/CopilotChatCssClasses.test.tsx +0 -107
  171. package/src/v2/components/chat/__tests__/CopilotChatInput.slots.e2e.test.tsx +0 -929
  172. package/src/v2/components/chat/__tests__/CopilotChatInput.test.tsx +0 -1567
  173. package/src/v2/components/chat/__tests__/CopilotChatMessageView.slots.e2e.test.tsx +0 -1004
  174. package/src/v2/components/chat/__tests__/CopilotChatMessageView.test.tsx +0 -279
  175. package/src/v2/components/chat/__tests__/CopilotChatPerf.e2e.test.tsx +0 -336
  176. package/src/v2/components/chat/__tests__/CopilotChatPropsRerender.e2e.test.tsx +0 -249
  177. package/src/v2/components/chat/__tests__/CopilotChatSuggestionView.slots.e2e.test.tsx +0 -530
  178. package/src/v2/components/chat/__tests__/CopilotChatToolRendering.e2e.test.tsx +0 -785
  179. package/src/v2/components/chat/__tests__/CopilotChatToolRerenders.e2e.test.tsx +0 -2416
  180. package/src/v2/components/chat/__tests__/CopilotChatUserMessage.slots.e2e.test.tsx +0 -621
  181. package/src/v2/components/chat/__tests__/CopilotChatView.connectingGate.test.tsx +0 -56
  182. package/src/v2/components/chat/__tests__/CopilotChatView.inputOverlay.test.tsx +0 -264
  183. package/src/v2/components/chat/__tests__/CopilotChatView.onClick.e2e.test.tsx +0 -853
  184. package/src/v2/components/chat/__tests__/CopilotChatView.pinToSend.test.tsx +0 -94
  185. package/src/v2/components/chat/__tests__/CopilotChatView.slots.e2e.test.tsx +0 -1050
  186. package/src/v2/components/chat/__tests__/CopilotModalHeader.slots.e2e.test.tsx +0 -484
  187. package/src/v2/components/chat/__tests__/CopilotPopupView.slots.e2e.test.tsx +0 -612
  188. package/src/v2/components/chat/__tests__/CopilotSidebarView.position.test.tsx +0 -159
  189. package/src/v2/components/chat/__tests__/CopilotSidebarView.slots.e2e.test.tsx +0 -502
  190. package/src/v2/components/chat/__tests__/MCPAppsActivityRenderer.e2e.test.tsx +0 -1068
  191. package/src/v2/components/chat/__tests__/MCPAppsProxy.e2e.test.tsx +0 -589
  192. package/src/v2/components/chat/__tests__/MCPAppsUiMessage.e2e.test.tsx +0 -403
  193. package/src/v2/components/chat/__tests__/copilot-chat-throttle.test.tsx +0 -137
  194. package/src/v2/components/chat/__tests__/normalize-auto-scroll.test.ts +0 -37
  195. package/src/v2/components/chat/__tests__/setup.ts +0 -1
  196. package/src/v2/components/chat/index.ts +0 -90
  197. package/src/v2/components/chat/last-user-message-context.ts +0 -21
  198. package/src/v2/components/chat/normalize-auto-scroll.ts +0 -17
  199. package/src/v2/components/chat/scroll-element-context.ts +0 -13
  200. package/src/v2/components/index.ts +0 -8
  201. package/src/v2/components/intelligence-indicator/IntelligenceIndicator.tsx +0 -286
  202. package/src/v2/components/intelligence-indicator/__tests__/IntelligenceIndicator.e2e.test.tsx +0 -464
  203. package/src/v2/components/intelligence-indicator/index.ts +0 -2
  204. package/src/v2/components/license-warning-banner.tsx +0 -217
  205. package/src/v2/components/ui/button.tsx +0 -124
  206. package/src/v2/components/ui/dropdown-menu.tsx +0 -258
  207. package/src/v2/components/ui/tooltip.tsx +0 -60
  208. package/src/v2/context.ts +0 -62
  209. package/src/v2/headless.ts +0 -64
  210. package/src/v2/hooks/__tests__/standard-schema-types.test.tsx +0 -152
  211. package/src/v2/hooks/__tests__/standard-schema.test.tsx +0 -282
  212. package/src/v2/hooks/__tests__/use-agent-context-timing.e2e.test.tsx +0 -140
  213. package/src/v2/hooks/__tests__/use-agent-context.test.tsx +0 -401
  214. package/src/v2/hooks/__tests__/use-agent-error-state.test.tsx +0 -44
  215. package/src/v2/hooks/__tests__/use-agent-stability.test.tsx +0 -211
  216. package/src/v2/hooks/__tests__/use-agent-throttle.test.tsx +0 -1029
  217. package/src/v2/hooks/__tests__/use-agent.e2e.test.tsx +0 -159
  218. package/src/v2/hooks/__tests__/use-attachments.test.tsx +0 -169
  219. package/src/v2/hooks/__tests__/use-capabilities.test.tsx +0 -76
  220. package/src/v2/hooks/__tests__/use-component.test.tsx +0 -126
  221. package/src/v2/hooks/__tests__/use-configure-suggestions.e2e.test.tsx +0 -696
  222. package/src/v2/hooks/__tests__/use-default-render-tool.test.tsx +0 -153
  223. package/src/v2/hooks/__tests__/use-frontend-tool-available.test.tsx +0 -167
  224. package/src/v2/hooks/__tests__/use-frontend-tool.e2e.test.tsx +0 -2148
  225. package/src/v2/hooks/__tests__/use-human-in-the-loop.e2e.test.tsx +0 -1261
  226. package/src/v2/hooks/__tests__/use-interrupt.test.tsx +0 -397
  227. package/src/v2/hooks/__tests__/use-katex-styles.test.tsx +0 -56
  228. package/src/v2/hooks/__tests__/use-keyboard-height.test.tsx +0 -192
  229. package/src/v2/hooks/__tests__/use-pin-to-send.test.tsx +0 -219
  230. package/src/v2/hooks/__tests__/use-render-custom-messages.test.tsx +0 -55
  231. package/src/v2/hooks/__tests__/use-render-tool.test.tsx +0 -259
  232. package/src/v2/hooks/__tests__/use-suggestions.e2e.test.tsx +0 -524
  233. package/src/v2/hooks/__tests__/use-threads.test.tsx +0 -757
  234. package/src/v2/hooks/__tests__/zod-regression.test.tsx +0 -311
  235. package/src/v2/hooks/index.ts +0 -24
  236. package/src/v2/hooks/use-agent-context.tsx +0 -45
  237. package/src/v2/hooks/use-agent.tsx +0 -227
  238. package/src/v2/hooks/use-attachments.tsx +0 -269
  239. package/src/v2/hooks/use-capabilities.tsx +0 -25
  240. package/src/v2/hooks/use-component.tsx +0 -91
  241. package/src/v2/hooks/use-configure-suggestions.tsx +0 -236
  242. package/src/v2/hooks/use-default-render-tool.tsx +0 -271
  243. package/src/v2/hooks/use-frontend-tool.tsx +0 -46
  244. package/src/v2/hooks/use-human-in-the-loop.tsx +0 -81
  245. package/src/v2/hooks/use-interrupt.tsx +0 -305
  246. package/src/v2/hooks/use-keyboard-height.tsx +0 -67
  247. package/src/v2/hooks/use-pin-to-send.ts +0 -94
  248. package/src/v2/hooks/use-render-activity-message.tsx +0 -72
  249. package/src/v2/hooks/use-render-custom-messages.tsx +0 -93
  250. package/src/v2/hooks/use-render-tool-call.tsx +0 -208
  251. package/src/v2/hooks/use-render-tool.tsx +0 -184
  252. package/src/v2/hooks/use-suggestions.tsx +0 -91
  253. package/src/v2/hooks/use-threads.tsx +0 -325
  254. package/src/v2/hooks/useKatexStyles.ts +0 -27
  255. package/src/v2/index.css +0 -1
  256. package/src/v2/index.ts +0 -27
  257. package/src/v2/lib/__tests__/completePartialMarkdown.test.ts +0 -495
  258. package/src/v2/lib/__tests__/processPartialHtml.test.ts +0 -112
  259. package/src/v2/lib/__tests__/renderSlot.test.tsx +0 -588
  260. package/src/v2/lib/__tests__/slots.test.ts +0 -56
  261. package/src/v2/lib/processPartialHtml.ts +0 -45
  262. package/src/v2/lib/react-core.ts +0 -156
  263. package/src/v2/lib/slots.tsx +0 -184
  264. package/src/v2/lib/transcription-client.ts +0 -184
  265. package/src/v2/lib/utils.ts +0 -8
  266. package/src/v2/providers/CopilotChatConfigurationProvider.tsx +0 -196
  267. package/src/v2/providers/CopilotKitProvider.tsx +0 -800
  268. package/src/v2/providers/SandboxFunctionsContext.ts +0 -10
  269. package/src/v2/providers/__tests__/CopilotChatConfigurationProvider.test.tsx +0 -652
  270. package/src/v2/providers/__tests__/CopilotKitProvider.license.test.tsx +0 -101
  271. package/src/v2/providers/__tests__/CopilotKitProvider.onError.test.tsx +0 -69
  272. package/src/v2/providers/__tests__/CopilotKitProvider.renderCustomMessages.e2e.test.tsx +0 -881
  273. package/src/v2/providers/__tests__/CopilotKitProvider.sandboxFunctions.test.tsx +0 -198
  274. package/src/v2/providers/__tests__/CopilotKitProvider.stability.test.tsx +0 -740
  275. package/src/v2/providers/__tests__/CopilotKitProvider.test.tsx +0 -713
  276. package/src/v2/providers/__tests__/CopilotKitProvider.wildcard.test.tsx +0 -294
  277. package/src/v2/providers/index.ts +0 -21
  278. package/src/v2/styles/globals.css +0 -349
  279. package/src/v2/types/__tests__/defineToolCallRenderer.test.tsx +0 -525
  280. package/src/v2/types/defineToolCallRenderer.ts +0 -68
  281. package/src/v2/types/frontend-tool.ts +0 -8
  282. package/src/v2/types/human-in-the-loop.ts +0 -33
  283. package/src/v2/types/index.ts +0 -8
  284. package/src/v2/types/interrupt.ts +0 -15
  285. package/src/v2/types/react-activity-message-renderer.ts +0 -27
  286. package/src/v2/types/react-custom-message-renderer.ts +0 -17
  287. package/src/v2/types/react-tool-call-renderer.ts +0 -35
  288. package/src/v2/types/sandbox-function.ts +0 -11
  289. package/tsconfig.json +0 -8
  290. package/tsdown.config.ts +0 -193
  291. package/typedoc.json +0 -4
  292. package/vitest.config.mjs +0 -31
@@ -1,350 +0,0 @@
1
- import {
2
- useRef,
3
- useEffect,
4
- useImperativeHandle,
5
- forwardRef,
6
- useCallback,
7
- useState,
8
- } from "react";
9
- import { twMerge } from "tailwind-merge";
10
-
11
- /** Finite-state machine for every recorder implementation */
12
- export type AudioRecorderState = "idle" | "recording" | "processing";
13
-
14
- /** Error subclass so callers can `instanceof`-guard recorder failures */
15
- export class AudioRecorderError extends Error {
16
- constructor(message: string) {
17
- super(message);
18
- this.name = "AudioRecorderError";
19
- }
20
- }
21
-
22
- export interface AudioRecorderRef {
23
- state: AudioRecorderState;
24
- start: () => Promise<void>;
25
- stop: () => Promise<Blob>;
26
- dispose: () => void;
27
- }
28
-
29
- export const CopilotChatAudioRecorder = forwardRef<
30
- AudioRecorderRef,
31
- React.HTMLAttributes<HTMLDivElement>
32
- >((props, ref) => {
33
- const { className, ...divProps } = props;
34
- const canvasRef = useRef<HTMLCanvasElement>(null);
35
-
36
- // Recording state
37
- const [recorderState, setRecorderState] =
38
- useState<AudioRecorderState>("idle");
39
- const mediaRecorderRef = useRef<MediaRecorder | null>(null);
40
- const audioChunksRef = useRef<Blob[]>([]);
41
- const streamRef = useRef<MediaStream | null>(null);
42
- const analyserRef = useRef<AnalyserNode | null>(null);
43
- const audioContextRef = useRef<AudioContext | null>(null);
44
- const animationIdRef = useRef<number | null>(null);
45
-
46
- // Amplitude history buffer for scrolling waveform
47
- const amplitudeHistoryRef = useRef<number[]>([]);
48
- const frameCountRef = useRef<number>(0);
49
- const scrollOffsetRef = useRef<number>(0);
50
- const smoothedAmplitudeRef = useRef<number>(0);
51
- const fadeOpacityRef = useRef<number>(0);
52
-
53
- // Clean up all resources
54
- const cleanup = useCallback(() => {
55
- if (animationIdRef.current) {
56
- cancelAnimationFrame(animationIdRef.current);
57
- animationIdRef.current = null;
58
- }
59
- if (
60
- mediaRecorderRef.current &&
61
- mediaRecorderRef.current.state !== "inactive"
62
- ) {
63
- try {
64
- mediaRecorderRef.current.stop();
65
- } catch {
66
- // Ignore errors during cleanup
67
- }
68
- }
69
- if (streamRef.current) {
70
- streamRef.current.getTracks().forEach((track) => track.stop());
71
- streamRef.current = null;
72
- }
73
- if (audioContextRef.current && audioContextRef.current.state !== "closed") {
74
- audioContextRef.current.close().catch(() => {
75
- // Ignore close errors
76
- });
77
- audioContextRef.current = null;
78
- }
79
- mediaRecorderRef.current = null;
80
- analyserRef.current = null;
81
- audioChunksRef.current = [];
82
- amplitudeHistoryRef.current = [];
83
- frameCountRef.current = 0;
84
- scrollOffsetRef.current = 0;
85
- smoothedAmplitudeRef.current = 0;
86
- fadeOpacityRef.current = 0;
87
- }, []);
88
-
89
- // Start recording
90
- const start = useCallback(async () => {
91
- if (recorderState !== "idle") {
92
- throw new AudioRecorderError("Recorder is already active");
93
- }
94
-
95
- try {
96
- // Request microphone access
97
- const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
98
- streamRef.current = stream;
99
-
100
- // Set up audio context for visualization
101
- const audioContext = new AudioContext();
102
- audioContextRef.current = audioContext;
103
- const source = audioContext.createMediaStreamSource(stream);
104
- const analyser = audioContext.createAnalyser();
105
- analyser.fftSize = 2048; // Higher resolution for time-domain waveform
106
- source.connect(analyser);
107
- analyserRef.current = analyser;
108
-
109
- // Determine best MIME type for recording
110
- const mimeType = MediaRecorder.isTypeSupported("audio/webm;codecs=opus")
111
- ? "audio/webm;codecs=opus"
112
- : MediaRecorder.isTypeSupported("audio/webm")
113
- ? "audio/webm"
114
- : MediaRecorder.isTypeSupported("audio/mp4")
115
- ? "audio/mp4"
116
- : "";
117
-
118
- const options: MediaRecorderOptions = mimeType ? { mimeType } : {};
119
- const mediaRecorder = new MediaRecorder(stream, options);
120
- mediaRecorderRef.current = mediaRecorder;
121
- audioChunksRef.current = [];
122
-
123
- mediaRecorder.ondataavailable = (event) => {
124
- if (event.data.size > 0) {
125
- audioChunksRef.current.push(event.data);
126
- }
127
- };
128
-
129
- // Start recording with timeslice to collect data periodically
130
- mediaRecorder.start(100);
131
- setRecorderState("recording");
132
- } catch (error) {
133
- cleanup();
134
- if (error instanceof Error && error.name === "NotAllowedError") {
135
- throw new AudioRecorderError("Microphone permission denied");
136
- }
137
- if (error instanceof Error && error.name === "NotFoundError") {
138
- throw new AudioRecorderError("No microphone found");
139
- }
140
- throw new AudioRecorderError(
141
- error instanceof Error ? error.message : "Failed to start recording",
142
- );
143
- }
144
- }, [recorderState, cleanup]);
145
-
146
- // Stop recording and return audio blob
147
- const stop = useCallback((): Promise<Blob> => {
148
- return new Promise((resolve, reject) => {
149
- const mediaRecorder = mediaRecorderRef.current;
150
- if (!mediaRecorder || recorderState !== "recording") {
151
- reject(new AudioRecorderError("No active recording"));
152
- return;
153
- }
154
-
155
- setRecorderState("processing");
156
-
157
- mediaRecorder.onstop = () => {
158
- const mimeType = mediaRecorder.mimeType || "audio/webm";
159
- const audioBlob = new Blob(audioChunksRef.current, { type: mimeType });
160
-
161
- // Clean up but keep the blob
162
- cleanup();
163
- setRecorderState("idle");
164
- resolve(audioBlob);
165
- };
166
-
167
- mediaRecorder.onerror = () => {
168
- cleanup();
169
- setRecorderState("idle");
170
- reject(new AudioRecorderError("Recording failed"));
171
- };
172
-
173
- mediaRecorder.stop();
174
- });
175
- }, [recorderState, cleanup]);
176
-
177
- // Calculate RMS amplitude from time-domain data
178
- const calculateAmplitude = (dataArray: Uint8Array): number => {
179
- let sum = 0;
180
- for (let i = 0; i < dataArray.length; i++) {
181
- // Normalize to -1 to 1 range (128 is center/silence)
182
- const sample = (dataArray[i] ?? 128) / 128 - 1;
183
- sum += sample * sample;
184
- }
185
- return Math.sqrt(sum / dataArray.length);
186
- };
187
-
188
- // Canvas rendering with animation
189
- useEffect(() => {
190
- const canvas = canvasRef.current;
191
- if (!canvas) return;
192
-
193
- const ctx = canvas.getContext("2d");
194
- if (!ctx) return;
195
-
196
- // Configuration
197
- const barWidth = 2;
198
- const barGap = 1;
199
- const barSpacing = barWidth + barGap;
200
- const scrollSpeed = 1 / 3; // Pixels per frame
201
-
202
- const draw = () => {
203
- const rect = canvas.getBoundingClientRect();
204
- const dpr = window.devicePixelRatio || 1;
205
-
206
- // Update canvas dimensions if container resized
207
- if (
208
- canvas.width !== rect.width * dpr ||
209
- canvas.height !== rect.height * dpr
210
- ) {
211
- canvas.width = rect.width * dpr;
212
- canvas.height = rect.height * dpr;
213
- ctx.scale(dpr, dpr);
214
- }
215
-
216
- // Calculate how many bars fit in the canvas (plus extra for smooth scrolling)
217
- const maxBars = Math.floor(rect.width / barSpacing) + 2;
218
-
219
- // Get current amplitude if recording
220
- if (analyserRef.current && recorderState === "recording") {
221
- // Pre-fill history with zeros on first frame so line is visible immediately
222
- if (amplitudeHistoryRef.current.length === 0) {
223
- amplitudeHistoryRef.current = new Array(maxBars).fill(0);
224
- }
225
-
226
- // Fade in the waveform smoothly
227
- if (fadeOpacityRef.current < 1) {
228
- fadeOpacityRef.current = Math.min(1, fadeOpacityRef.current + 0.03);
229
- }
230
-
231
- // Smooth scrolling - increment offset every frame
232
- scrollOffsetRef.current += scrollSpeed;
233
-
234
- // Sample amplitude every frame for smoothing
235
- const bufferLength = analyserRef.current.fftSize;
236
- const dataArray = new Uint8Array(bufferLength);
237
- analyserRef.current.getByteTimeDomainData(dataArray);
238
- const rawAmplitude = calculateAmplitude(dataArray);
239
-
240
- // Smoothing: gradual attack and decay
241
- const attackSpeed = 0.12; // Smooth rise
242
- const decaySpeed = 0.08; // Smooth fade out
243
- const speed =
244
- rawAmplitude > smoothedAmplitudeRef.current
245
- ? attackSpeed
246
- : decaySpeed;
247
- smoothedAmplitudeRef.current +=
248
- (rawAmplitude - smoothedAmplitudeRef.current) * speed;
249
-
250
- // When offset reaches a full bar width, add a new sample and reset offset
251
- if (scrollOffsetRef.current >= barSpacing) {
252
- scrollOffsetRef.current -= barSpacing;
253
- amplitudeHistoryRef.current.push(smoothedAmplitudeRef.current);
254
-
255
- // Trim history to fit canvas
256
- if (amplitudeHistoryRef.current.length > maxBars) {
257
- amplitudeHistoryRef.current =
258
- amplitudeHistoryRef.current.slice(-maxBars);
259
- }
260
- }
261
- }
262
-
263
- // Clear canvas
264
- ctx.clearRect(0, 0, rect.width, rect.height);
265
-
266
- // Get current foreground color
267
- const computedStyle = getComputedStyle(canvas);
268
- ctx.fillStyle = computedStyle.color;
269
- ctx.globalAlpha = fadeOpacityRef.current;
270
-
271
- const centerY = rect.height / 2;
272
- const maxAmplitude = rect.height / 2 - 2; // Leave some padding
273
-
274
- const history = amplitudeHistoryRef.current;
275
-
276
- // Only draw when recording (history has data)
277
- if (history.length > 0) {
278
- const offset = scrollOffsetRef.current;
279
- const edgeFadeWidth = 12; // Pixels to fade at each edge
280
-
281
- for (let i = 0; i < history.length; i++) {
282
- const amplitude = history[i] ?? 0;
283
- // Scale amplitude (RMS is typically 0-0.5 for normal speech)
284
- const scaledAmplitude = Math.min(amplitude * 4, 1);
285
- const barHeight = Math.max(2, scaledAmplitude * maxAmplitude * 2);
286
-
287
- // Position: right-aligned with smooth scroll offset
288
- const x = rect.width - (history.length - i) * barSpacing - offset;
289
- const y = centerY - barHeight / 2;
290
-
291
- // Only draw if visible
292
- if (x + barWidth > 0 && x < rect.width) {
293
- // Calculate edge fade opacity
294
- let edgeOpacity = 1;
295
- if (x < edgeFadeWidth) {
296
- // Fade out on left edge
297
- edgeOpacity = Math.max(0, x / edgeFadeWidth);
298
- } else if (x > rect.width - edgeFadeWidth) {
299
- // Fade in on right edge
300
- edgeOpacity = Math.max(0, (rect.width - x) / edgeFadeWidth);
301
- }
302
-
303
- ctx.globalAlpha = fadeOpacityRef.current * edgeOpacity;
304
- ctx.fillRect(x, y, barWidth, barHeight);
305
- }
306
- }
307
- }
308
-
309
- animationIdRef.current = requestAnimationFrame(draw);
310
- };
311
-
312
- draw();
313
-
314
- return () => {
315
- if (animationIdRef.current) {
316
- cancelAnimationFrame(animationIdRef.current);
317
- }
318
- };
319
- }, [recorderState]);
320
-
321
- // Cleanup on unmount
322
- useEffect(() => {
323
- return cleanup;
324
- }, [cleanup]);
325
-
326
- // Expose AudioRecorder API via ref
327
- useImperativeHandle(
328
- ref,
329
- () => ({
330
- get state() {
331
- return recorderState;
332
- },
333
- start,
334
- stop,
335
- dispose: cleanup,
336
- }),
337
- [recorderState, start, stop, cleanup],
338
- );
339
-
340
- return (
341
- <div
342
- className={twMerge("cpk:w-full cpk:py-3 cpk:px-5", className)}
343
- {...divProps}
344
- >
345
- <canvas ref={canvasRef} className="cpk:block cpk:w-full cpk:h-[26px]" />
346
- </div>
347
- );
348
- });
349
-
350
- CopilotChatAudioRecorder.displayName = "CopilotChatAudioRecorder";