@assistant-ui/mcp-docs-server 0.2.3 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (452) hide show
  1. package/README.md +16 -43
  2. package/dist/index.d.ts +2 -3
  3. package/dist/index.d.ts.map +1 -1
  4. package/dist/index.js +3 -91
  5. package/dist/index.js.map +1 -1
  6. package/dist/proxy.d.ts +9 -0
  7. package/dist/proxy.d.ts.map +1 -0
  8. package/dist/proxy.js +91 -0
  9. package/dist/proxy.js.map +1 -0
  10. package/package.json +8 -12
  11. package/src/index.ts +3 -115
  12. package/src/proxy.test.ts +385 -0
  13. package/src/proxy.ts +126 -0
  14. package/.docs/organized/code-examples/waterfall.md +0 -807
  15. package/.docs/organized/code-examples/with-a2a.md +0 -675
  16. package/.docs/organized/code-examples/with-ag-ui.md +0 -553
  17. package/.docs/organized/code-examples/with-ai-sdk-v7.md +0 -466
  18. package/.docs/organized/code-examples/with-artifacts.md +0 -815
  19. package/.docs/organized/code-examples/with-assistant-transport.md +0 -576
  20. package/.docs/organized/code-examples/with-browser-extension.md +0 -371
  21. package/.docs/organized/code-examples/with-chain-of-thought.md +0 -962
  22. package/.docs/organized/code-examples/with-cloud-standalone.md +0 -681
  23. package/.docs/organized/code-examples/with-cloud.md +0 -439
  24. package/.docs/organized/code-examples/with-custom-thread-list.md +0 -569
  25. package/.docs/organized/code-examples/with-elevenlabs-conversational.md +0 -527
  26. package/.docs/organized/code-examples/with-elevenlabs-scribe.md +0 -697
  27. package/.docs/organized/code-examples/with-eve.md +0 -405
  28. package/.docs/organized/code-examples/with-expo.md +0 -2246
  29. package/.docs/organized/code-examples/with-external-store.md +0 -421
  30. package/.docs/organized/code-examples/with-ffmpeg.md +0 -829
  31. package/.docs/organized/code-examples/with-generative-ui.md +0 -1810
  32. package/.docs/organized/code-examples/with-google-adk.md +0 -368
  33. package/.docs/organized/code-examples/with-heat-graph.md +0 -304
  34. package/.docs/organized/code-examples/with-image-generation.md +0 -463
  35. package/.docs/organized/code-examples/with-interactables.md +0 -733
  36. package/.docs/organized/code-examples/with-langchain.md +0 -446
  37. package/.docs/organized/code-examples/with-langgraph.md +0 -855
  38. package/.docs/organized/code-examples/with-livekit.md +0 -643
  39. package/.docs/organized/code-examples/with-mcp.md +0 -782
  40. package/.docs/organized/code-examples/with-nuxt.md +0 -2428
  41. package/.docs/organized/code-examples/with-opencode.md +0 -1974
  42. package/.docs/organized/code-examples/with-openui.md +0 -450
  43. package/.docs/organized/code-examples/with-pi.md +0 -2084
  44. package/.docs/organized/code-examples/with-react-hook-form.md +0 -727
  45. package/.docs/organized/code-examples/with-react-ink-web.md +0 -740
  46. package/.docs/organized/code-examples/with-react-ink.md +0 -473
  47. package/.docs/organized/code-examples/with-react-router.md +0 -936
  48. package/.docs/organized/code-examples/with-resumable-stream.md +0 -668
  49. package/.docs/organized/code-examples/with-store.md +0 -679
  50. package/.docs/organized/code-examples/with-svelte.md +0 -415
  51. package/.docs/organized/code-examples/with-sveltekit.md +0 -1061
  52. package/.docs/organized/code-examples/with-tanstack.md +0 -812
  53. package/.docs/organized/code-examples/with-tap-runtime.md +0 -813
  54. package/.docs/organized/code-examples/with-virtualized-thread.md +0 -681
  55. package/.docs/organized/code-examples/with-vue.md +0 -408
  56. package/.docs/raw/docs/(getting-started)/architecture.mdx +0 -146
  57. package/.docs/raw/docs/(getting-started)/base-ui.mdx +0 -39
  58. package/.docs/raw/docs/(getting-started)/cli.mdx +0 -542
  59. package/.docs/raw/docs/(getting-started)/devtools.mdx +0 -79
  60. package/.docs/raw/docs/(getting-started)/index.mdx +0 -23
  61. package/.docs/raw/docs/(getting-started)/installation.mdx +0 -483
  62. package/.docs/raw/docs/(getting-started)/llm.mdx +0 -211
  63. package/.docs/raw/docs/(getting-started)/rtl.mdx +0 -78
  64. package/.docs/raw/docs/(reference)/api-reference/adapters/attachments.mdx +0 -36
  65. package/.docs/raw/docs/(reference)/api-reference/adapters/feedback.mdx +0 -20
  66. package/.docs/raw/docs/(reference)/api-reference/adapters/index.mdx +0 -34
  67. package/.docs/raw/docs/(reference)/api-reference/adapters/model.mdx +0 -44
  68. package/.docs/raw/docs/(reference)/api-reference/adapters/persistence.mdx +0 -59
  69. package/.docs/raw/docs/(reference)/api-reference/adapters/runtime.mdx +0 -20
  70. package/.docs/raw/docs/(reference)/api-reference/adapters/suggestions.mdx +0 -26
  71. package/.docs/raw/docs/(reference)/api-reference/context-providers/assistant-runtime-provider.mdx +0 -84
  72. package/.docs/raw/docs/(reference)/api-reference/context-providers/index.mdx +0 -22
  73. package/.docs/raw/docs/(reference)/api-reference/context-providers/scoped-providers.mdx +0 -64
  74. package/.docs/raw/docs/(reference)/api-reference/external-store/index.mdx +0 -22
  75. package/.docs/raw/docs/(reference)/api-reference/external-store/message-conversion.mdx +0 -57
  76. package/.docs/raw/docs/(reference)/api-reference/external-store/runtime.mdx +0 -49
  77. package/.docs/raw/docs/(reference)/api-reference/generative-ui/a2ui.mdx +0 -40
  78. package/.docs/raw/docs/(reference)/api-reference/generative-ui/actions.mdx +0 -56
  79. package/.docs/raw/docs/(reference)/api-reference/generative-ui/components.mdx +0 -86
  80. package/.docs/raw/docs/(reference)/api-reference/generative-ui/index.mdx +0 -39
  81. package/.docs/raw/docs/(reference)/api-reference/generative-ui/json-generative-ui.mdx +0 -42
  82. package/.docs/raw/docs/(reference)/api-reference/generative-ui/rendering.mdx +0 -84
  83. package/.docs/raw/docs/(reference)/api-reference/generative-ui/slack.mdx +0 -85
  84. package/.docs/raw/docs/(reference)/api-reference/generative-ui/spec.mdx +0 -45
  85. package/.docs/raw/docs/(reference)/api-reference/generative-ui/teams.mdx +0 -93
  86. package/.docs/raw/docs/(reference)/api-reference/generative-ui/tokens.mdx +0 -62
  87. package/.docs/raw/docs/(reference)/api-reference/hooks/composer-triggers.mdx +0 -129
  88. package/.docs/raw/docs/(reference)/api-reference/hooks/index.mdx +0 -31
  89. package/.docs/raw/docs/(reference)/api-reference/hooks/model-context.mdx +0 -34
  90. package/.docs/raw/docs/(reference)/api-reference/hooks/primitives.mdx +0 -350
  91. package/.docs/raw/docs/(reference)/api-reference/hooks/runtimes.mdx +0 -28
  92. package/.docs/raw/docs/(reference)/api-reference/hooks/state.mdx +0 -97
  93. package/.docs/raw/docs/(reference)/api-reference/integrations/ai-sdk.mdx +0 -200
  94. package/.docs/raw/docs/(reference)/api-reference/integrations/cloud-ai-sdk.mdx +0 -24
  95. package/.docs/raw/docs/(reference)/api-reference/integrations/eve.mdx +0 -118
  96. package/.docs/raw/docs/(reference)/api-reference/integrations/index.mdx +0 -28
  97. package/.docs/raw/docs/(reference)/api-reference/integrations/react-data-stream.mdx +0 -37
  98. package/.docs/raw/docs/(reference)/api-reference/model-context/context.mdx +0 -50
  99. package/.docs/raw/docs/(reference)/api-reference/model-context/index.mdx +0 -22
  100. package/.docs/raw/docs/(reference)/api-reference/model-context/registry.mdx +0 -20
  101. package/.docs/raw/docs/(reference)/api-reference/overview.mdx +0 -566
  102. package/.docs/raw/docs/(reference)/api-reference/primitives/action-bar-more.mdx +0 -152
  103. package/.docs/raw/docs/(reference)/api-reference/primitives/action-bar.mdx +0 -239
  104. package/.docs/raw/docs/(reference)/api-reference/primitives/assistant-if.mdx +0 -208
  105. package/.docs/raw/docs/(reference)/api-reference/primitives/assistant-modal.mdx +0 -108
  106. package/.docs/raw/docs/(reference)/api-reference/primitives/attachment.mdx +0 -99
  107. package/.docs/raw/docs/(reference)/api-reference/primitives/branch-picker.mdx +0 -145
  108. package/.docs/raw/docs/(reference)/api-reference/primitives/chain-of-thought.mdx +0 -82
  109. package/.docs/raw/docs/(reference)/api-reference/primitives/composer.mdx +0 -637
  110. package/.docs/raw/docs/(reference)/api-reference/primitives/composition.mdx +0 -22
  111. package/.docs/raw/docs/(reference)/api-reference/primitives/error.mdx +0 -65
  112. package/.docs/raw/docs/(reference)/api-reference/primitives/index.mdx +0 -73
  113. package/.docs/raw/docs/(reference)/api-reference/primitives/message-part.mdx +0 -117
  114. package/.docs/raw/docs/(reference)/api-reference/primitives/message.mdx +0 -339
  115. package/.docs/raw/docs/(reference)/api-reference/primitives/queue-item.mdx +0 -77
  116. package/.docs/raw/docs/(reference)/api-reference/primitives/selection-toolbar.mdx +0 -88
  117. package/.docs/raw/docs/(reference)/api-reference/primitives/suggestion.mdx +0 -81
  118. package/.docs/raw/docs/(reference)/api-reference/primitives/thread-list-item-more.mdx +0 -129
  119. package/.docs/raw/docs/(reference)/api-reference/primitives/thread-list-item.mdx +0 -138
  120. package/.docs/raw/docs/(reference)/api-reference/primitives/thread-list.mdx +0 -122
  121. package/.docs/raw/docs/(reference)/api-reference/primitives/thread.mdx +0 -289
  122. package/.docs/raw/docs/(reference)/api-reference/runtimes/assistant-runtime.mdx +0 -20
  123. package/.docs/raw/docs/(reference)/api-reference/runtimes/attachment-runtime.mdx +0 -24
  124. package/.docs/raw/docs/(reference)/api-reference/runtimes/composer-runtime.mdx +0 -32
  125. package/.docs/raw/docs/(reference)/api-reference/runtimes/index.mdx +0 -43
  126. package/.docs/raw/docs/(reference)/api-reference/runtimes/message-part-runtime.mdx +0 -43
  127. package/.docs/raw/docs/(reference)/api-reference/runtimes/message-runtime.mdx +0 -24
  128. package/.docs/raw/docs/(reference)/api-reference/runtimes/queue-state.mdx +0 -20
  129. package/.docs/raw/docs/(reference)/api-reference/runtimes/thread-list-item-runtime.mdx +0 -24
  130. package/.docs/raw/docs/(reference)/api-reference/runtimes/thread-list-runtime.mdx +0 -24
  131. package/.docs/raw/docs/(reference)/api-reference/runtimes/thread-runtime.mdx +0 -36
  132. package/.docs/raw/docs/(reference)/api-reference/tools/component-tools.mdx +0 -85
  133. package/.docs/raw/docs/(reference)/api-reference/tools/index.mdx +0 -45
  134. package/.docs/raw/docs/(reference)/api-reference/tools/interactables-legacy.mdx +0 -55
  135. package/.docs/raw/docs/(reference)/api-reference/tools/interactables.mdx +0 -151
  136. package/.docs/raw/docs/(reference)/api-reference/tools/rendering.mdx +0 -106
  137. package/.docs/raw/docs/(reference)/api-reference/tools/status.mdx +0 -62
  138. package/.docs/raw/docs/(reference)/api-reference/tools/toolkits.mdx +0 -178
  139. package/.docs/raw/docs/(reference)/api-reference/transport/assistant-transport.mdx +0 -48
  140. package/.docs/raw/docs/(reference)/api-reference/transport/frame.mdx +0 -62
  141. package/.docs/raw/docs/(reference)/api-reference/transport/index.mdx +0 -22
  142. package/.docs/raw/docs/(reference)/api-reference/utilities/index.mdx +0 -19
  143. package/.docs/raw/docs/(reference)/api-reference/utilities/miscellaneous.mdx +0 -152
  144. package/.docs/raw/docs/(reference)/api-reference/voice/index.mdx +0 -22
  145. package/.docs/raw/docs/(reference)/api-reference/voice/session.mdx +0 -54
  146. package/.docs/raw/docs/(reference)/api-reference/voice/speech-dictation.mdx +0 -36
  147. package/.docs/raw/docs/cloud/ai-sdk-assistant-ui.mdx +0 -527
  148. package/.docs/raw/docs/cloud/ai-sdk.mdx +0 -604
  149. package/.docs/raw/docs/cloud/authorization.mdx +0 -252
  150. package/.docs/raw/docs/cloud/index.mdx +0 -46
  151. package/.docs/raw/docs/cloud/langgraph.mdx +0 -554
  152. package/.docs/raw/docs/copilots/assistant-frame.mdx +0 -411
  153. package/.docs/raw/docs/copilots/make-assistant-visible.mdx +0 -82
  154. package/.docs/raw/docs/copilots/model-context.mdx +0 -156
  155. package/.docs/raw/docs/copilots/motivation.mdx +0 -202
  156. package/.docs/raw/docs/copilots/use-assistant-instructions.mdx +0 -64
  157. package/.docs/raw/docs/guides/attachments.mdx +0 -619
  158. package/.docs/raw/docs/guides/branching.mdx +0 -76
  159. package/.docs/raw/docs/guides/chain-of-thought.mdx +0 -164
  160. package/.docs/raw/docs/guides/chatgpt-subscription.mdx +0 -108
  161. package/.docs/raw/docs/guides/context-api.mdx +0 -619
  162. package/.docs/raw/docs/guides/dictation.mdx +0 -298
  163. package/.docs/raw/docs/guides/editing.mdx +0 -102
  164. package/.docs/raw/docs/guides/electron.mdx +0 -369
  165. package/.docs/raw/docs/guides/headless-composer-input.mdx +0 -113
  166. package/.docs/raw/docs/guides/image-generation.mdx +0 -74
  167. package/.docs/raw/docs/guides/index.mdx +0 -117
  168. package/.docs/raw/docs/guides/input-history.mdx +0 -55
  169. package/.docs/raw/docs/guides/latex.mdx +0 -158
  170. package/.docs/raw/docs/guides/mentions.mdx +0 -575
  171. package/.docs/raw/docs/guides/message-timing.mdx +0 -215
  172. package/.docs/raw/docs/guides/quoting.mdx +0 -169
  173. package/.docs/raw/docs/guides/resumable-stream-deployment.mdx +0 -212
  174. package/.docs/raw/docs/guides/resumable-stream-stores.mdx +0 -152
  175. package/.docs/raw/docs/guides/resumable-streams.mdx +0 -292
  176. package/.docs/raw/docs/guides/slash-commands.mdx +0 -358
  177. package/.docs/raw/docs/guides/speech.mdx +0 -172
  178. package/.docs/raw/docs/guides/suggestions.mdx +0 -384
  179. package/.docs/raw/docs/guides/virtualization.mdx +0 -133
  180. package/.docs/raw/docs/guides/voice.mdx +0 -310
  181. package/.docs/raw/docs/ink/adapters.mdx +0 -99
  182. package/.docs/raw/docs/ink/custom-backend.mdx +0 -254
  183. package/.docs/raw/docs/ink/hooks.mdx +0 -469
  184. package/.docs/raw/docs/ink/index.mdx +0 -237
  185. package/.docs/raw/docs/ink/migration.mdx +0 -138
  186. package/.docs/raw/docs/ink/primitives.mdx +0 -1259
  187. package/.docs/raw/docs/integrations/attachments/custom-adapter.mdx +0 -528
  188. package/.docs/raw/docs/integrations/auth/better-auth.mdx +0 -188
  189. package/.docs/raw/docs/integrations/auth/clerk.mdx +0 -166
  190. package/.docs/raw/docs/integrations/auth/next-auth.mdx +0 -191
  191. package/.docs/raw/docs/integrations/frameworks/ai-sdk.mdx +0 -88
  192. package/.docs/raw/docs/integrations/frameworks/cloudflare-agents.mdx +0 -283
  193. package/.docs/raw/docs/integrations/frameworks/mastra/full-stack.mdx +0 -188
  194. package/.docs/raw/docs/integrations/frameworks/mastra/overview.mdx +0 -57
  195. package/.docs/raw/docs/integrations/frameworks/mastra/separate-server.mdx +0 -201
  196. package/.docs/raw/docs/integrations/gateways/index.mdx +0 -162
  197. package/.docs/raw/docs/integrations/index.mdx +0 -178
  198. package/.docs/raw/docs/integrations/observability/helicone.mdx +0 -129
  199. package/.docs/raw/docs/integrations/observability/langfuse.mdx +0 -161
  200. package/.docs/raw/docs/integrations/observability/langsmith.mdx +0 -151
  201. package/.docs/raw/docs/integrations/persistence/custom-adapter.mdx +0 -773
  202. package/.docs/raw/docs/migrations/deprecation-policy.mdx +0 -42
  203. package/.docs/raw/docs/migrations/index.mdx +0 -50
  204. package/.docs/raw/docs/migrations/react-compatibility.mdx +0 -74
  205. package/.docs/raw/docs/migrations/react-langgraph-v0-7.mdx +0 -328
  206. package/.docs/raw/docs/migrations/toolkit-tools.mdx +0 -236
  207. package/.docs/raw/docs/migrations/v0-11.mdx +0 -172
  208. package/.docs/raw/docs/migrations/v0-12.mdx +0 -302
  209. package/.docs/raw/docs/migrations/v0-14.mdx +0 -297
  210. package/.docs/raw/docs/migrations/v0-15.mdx +0 -270
  211. package/.docs/raw/docs/primitives/action-bar.mdx +0 -352
  212. package/.docs/raw/docs/primitives/assistant-modal.mdx +0 -216
  213. package/.docs/raw/docs/primitives/attachment.mdx +0 -217
  214. package/.docs/raw/docs/primitives/branch-picker.mdx +0 -222
  215. package/.docs/raw/docs/primitives/chain-of-thought.mdx +0 -315
  216. package/.docs/raw/docs/primitives/composer.mdx +0 -659
  217. package/.docs/raw/docs/primitives/error.mdx +0 -142
  218. package/.docs/raw/docs/primitives/index.mdx +0 -99
  219. package/.docs/raw/docs/primitives/message.mdx +0 -618
  220. package/.docs/raw/docs/primitives/selection-toolbar.mdx +0 -191
  221. package/.docs/raw/docs/primitives/suggestion.mdx +0 -254
  222. package/.docs/raw/docs/primitives/thread-list.mdx +0 -467
  223. package/.docs/raw/docs/primitives/thread.mdx +0 -509
  224. package/.docs/raw/docs/react-native/adapters.mdx +0 -94
  225. package/.docs/raw/docs/react-native/custom-backend.mdx +0 -207
  226. package/.docs/raw/docs/react-native/hooks.mdx +0 -339
  227. package/.docs/raw/docs/react-native/index.mdx +0 -289
  228. package/.docs/raw/docs/react-native/migration.mdx +0 -142
  229. package/.docs/raw/docs/react-native/primitives.mdx +0 -976
  230. package/.docs/raw/docs/runtimes/a2a/client-and-hooks.mdx +0 -399
  231. package/.docs/raw/docs/runtimes/a2a/overview.mdx +0 -60
  232. package/.docs/raw/docs/runtimes/a2a/quickstart.mdx +0 -216
  233. package/.docs/raw/docs/runtimes/ag-ui/agent-state.mdx +0 -124
  234. package/.docs/raw/docs/runtimes/ag-ui/overview.mdx +0 -70
  235. package/.docs/raw/docs/runtimes/ag-ui/quickstart.mdx +0 -243
  236. package/.docs/raw/docs/runtimes/ag-ui/runtime-options.mdx +0 -267
  237. package/.docs/raw/docs/runtimes/ai-sdk/overview.mdx +0 -61
  238. package/.docs/raw/docs/runtimes/ai-sdk/v4-legacy.mdx +0 -122
  239. package/.docs/raw/docs/runtimes/ai-sdk/v5-legacy.mdx +0 -135
  240. package/.docs/raw/docs/runtimes/ai-sdk/v6-legacy.mdx +0 -636
  241. package/.docs/raw/docs/runtimes/ai-sdk/v7.mdx +0 -731
  242. package/.docs/raw/docs/runtimes/claude-managed-agents.mdx +0 -118
  243. package/.docs/raw/docs/runtimes/concepts/adapters.mdx +0 -265
  244. package/.docs/raw/docs/runtimes/concepts/architecture.mdx +0 -167
  245. package/.docs/raw/docs/runtimes/concepts/stability.mdx +0 -68
  246. package/.docs/raw/docs/runtimes/concepts/threads.mdx +0 -513
  247. package/.docs/raw/docs/runtimes/custom/assistant-transport.mdx +0 -763
  248. package/.docs/raw/docs/runtimes/custom/data-stream.mdx +0 -339
  249. package/.docs/raw/docs/runtimes/custom/external-store.mdx +0 -957
  250. package/.docs/raw/docs/runtimes/custom/local-runtime.mdx +0 -902
  251. package/.docs/raw/docs/runtimes/custom/overview.mdx +0 -71
  252. package/.docs/raw/docs/runtimes/eve/overview.mdx +0 -151
  253. package/.docs/raw/docs/runtimes/eve/quickstart.mdx +0 -192
  254. package/.docs/raw/docs/runtimes/google-adk/api.mdx +0 -256
  255. package/.docs/raw/docs/runtimes/google-adk/hooks.mdx +0 -784
  256. package/.docs/raw/docs/runtimes/google-adk/overview.mdx +0 -69
  257. package/.docs/raw/docs/runtimes/google-adk/quickstart.mdx +0 -229
  258. package/.docs/raw/docs/runtimes/langchain.mdx +0 -901
  259. package/.docs/raw/docs/runtimes/langgraph/agent-state.mdx +0 -181
  260. package/.docs/raw/docs/runtimes/langgraph/generative-ui.mdx +0 -305
  261. package/.docs/raw/docs/runtimes/langgraph/interrupts.mdx +0 -104
  262. package/.docs/raw/docs/runtimes/langgraph/overview.mdx +0 -84
  263. package/.docs/raw/docs/runtimes/langgraph/quickstart.mdx +0 -496
  264. package/.docs/raw/docs/runtimes/langgraph/streaming.mdx +0 -144
  265. package/.docs/raw/docs/runtimes/langgraph/threads.mdx +0 -113
  266. package/.docs/raw/docs/runtimes/langgraph/tutorial/introduction.mdx +0 -29
  267. package/.docs/raw/docs/runtimes/langgraph/tutorial/part-1.mdx +0 -93
  268. package/.docs/raw/docs/runtimes/langgraph/tutorial/part-2.mdx +0 -347
  269. package/.docs/raw/docs/runtimes/langgraph/tutorial/part-3.mdx +0 -393
  270. package/.docs/raw/docs/runtimes/opencode/hooks.mdx +0 -194
  271. package/.docs/raw/docs/runtimes/opencode/overview.mdx +0 -58
  272. package/.docs/raw/docs/runtimes/opencode/quickstart.mdx +0 -119
  273. package/.docs/raw/docs/runtimes/pick-a-runtime.mdx +0 -133
  274. package/.docs/raw/docs/tools/a2ui.mdx +0 -107
  275. package/.docs/raw/docs/tools/backend.mdx +0 -147
  276. package/.docs/raw/docs/tools/defining-tools.mdx +0 -574
  277. package/.docs/raw/docs/tools/dynamic-tools.mdx +0 -112
  278. package/.docs/raw/docs/tools/generative-ui-primitive.mdx +0 -180
  279. package/.docs/raw/docs/tools/generative-ui-slack.mdx +0 -167
  280. package/.docs/raw/docs/tools/generative-ui-teams.mdx +0 -160
  281. package/.docs/raw/docs/tools/generative-ui.mdx +0 -322
  282. package/.docs/raw/docs/tools/index.mdx +0 -72
  283. package/.docs/raw/docs/tools/interactables.mdx +0 -1084
  284. package/.docs/raw/docs/tools/mcp-apps.mdx +0 -363
  285. package/.docs/raw/docs/tools/mcp.mdx +0 -466
  286. package/.docs/raw/docs/tools/multi-agent.mdx +0 -237
  287. package/.docs/raw/docs/tools/openui.mdx +0 -175
  288. package/.docs/raw/docs/tools/tool-ui.mdx +0 -1020
  289. package/.docs/raw/docs/tools/user-managed-mcp.mdx +0 -428
  290. package/.docs/raw/docs/ui/assistant-modal.mdx +0 -166
  291. package/.docs/raw/docs/ui/assistant-sidebar.mdx +0 -89
  292. package/.docs/raw/docs/ui/attachment.mdx +0 -279
  293. package/.docs/raw/docs/ui/composer-trigger-popover.mdx +0 -247
  294. package/.docs/raw/docs/ui/context-display.mdx +0 -148
  295. package/.docs/raw/docs/ui/directive-text.mdx +0 -114
  296. package/.docs/raw/docs/ui/file.mdx +0 -159
  297. package/.docs/raw/docs/ui/follow-up-suggestions.mdx +0 -82
  298. package/.docs/raw/docs/ui/image.mdx +0 -102
  299. package/.docs/raw/docs/ui/markdown.mdx +0 -103
  300. package/.docs/raw/docs/ui/mcp-config.mdx +0 -107
  301. package/.docs/raw/docs/ui/mermaid.mdx +0 -92
  302. package/.docs/raw/docs/ui/message-timing.mdx +0 -93
  303. package/.docs/raw/docs/ui/model-selector.mdx +0 -455
  304. package/.docs/raw/docs/ui/part-grouping.mdx +0 -614
  305. package/.docs/raw/docs/ui/quote.mdx +0 -211
  306. package/.docs/raw/docs/ui/reasoning.mdx +0 -214
  307. package/.docs/raw/docs/ui/scrollbar.mdx +0 -77
  308. package/.docs/raw/docs/ui/sources.mdx +0 -186
  309. package/.docs/raw/docs/ui/streamdown.mdx +0 -392
  310. package/.docs/raw/docs/ui/syntax-highlighting.mdx +0 -205
  311. package/.docs/raw/docs/ui/thread-list.mdx +0 -411
  312. package/.docs/raw/docs/ui/thread.mdx +0 -559
  313. package/.docs/raw/docs/ui/tool-fallback.mdx +0 -141
  314. package/.docs/raw/docs/ui/tool-group.mdx +0 -240
  315. package/.docs/raw/docs/ui/voice.mdx +0 -173
  316. package/.docs/raw/docs/utilities/heat-graph.mdx +0 -237
  317. package/.docs/raw/docs/utilities/react-o11y.mdx +0 -362
  318. package/.docs/raw/docs/utilities/tw-shimmer.mdx +0 -212
  319. package/dist/constants.d.ts +0 -14
  320. package/dist/constants.d.ts.map +0 -1
  321. package/dist/constants.js +0 -19
  322. package/dist/constants.js.map +0 -1
  323. package/dist/prepare-docs/code-examples.d.ts +0 -5
  324. package/dist/prepare-docs/code-examples.d.ts.map +0 -1
  325. package/dist/prepare-docs/code-examples.js +0 -117
  326. package/dist/prepare-docs/code-examples.js.map +0 -1
  327. package/dist/prepare-docs/copy-raw.d.ts +0 -5
  328. package/dist/prepare-docs/copy-raw.d.ts.map +0 -1
  329. package/dist/prepare-docs/copy-raw.js +0 -49
  330. package/dist/prepare-docs/copy-raw.js.map +0 -1
  331. package/dist/prepare-docs/prepare.d.ts +0 -1
  332. package/dist/prepare-docs/prepare.js +0 -22
  333. package/dist/prepare-docs/prepare.js.map +0 -1
  334. package/dist/prompts/xulux-playground.d.ts +0 -12
  335. package/dist/prompts/xulux-playground.d.ts.map +0 -1
  336. package/dist/prompts/xulux-playground.js +0 -33
  337. package/dist/prompts/xulux-playground.js.map +0 -1
  338. package/dist/tools/docs.d.ts +0 -22
  339. package/dist/tools/docs.d.ts.map +0 -1
  340. package/dist/tools/docs.js +0 -177
  341. package/dist/tools/docs.js.map +0 -1
  342. package/dist/tools/examples.d.ts +0 -24
  343. package/dist/tools/examples.d.ts.map +0 -1
  344. package/dist/tools/examples.js +0 -87
  345. package/dist/tools/examples.js.map +0 -1
  346. package/dist/tools/resources.d.ts +0 -6
  347. package/dist/tools/resources.d.ts.map +0 -1
  348. package/dist/tools/resources.js +0 -75
  349. package/dist/tools/resources.js.map +0 -1
  350. package/dist/tools/search.d.ts +0 -24
  351. package/dist/tools/search.d.ts.map +0 -1
  352. package/dist/tools/search.js +0 -39
  353. package/dist/tools/search.js.map +0 -1
  354. package/dist/tools/tests/mcp-test-client.d.ts +0 -15
  355. package/dist/tools/tests/mcp-test-client.d.ts.map +0 -1
  356. package/dist/tools/tests/mcp-test-client.js +0 -68
  357. package/dist/tools/tests/mcp-test-client.js.map +0 -1
  358. package/dist/tools/tests/test-setup.d.ts +0 -7
  359. package/dist/tools/tests/test-setup.d.ts.map +0 -1
  360. package/dist/tools/tests/test-setup.js +0 -36
  361. package/dist/tools/tests/test-setup.js.map +0 -1
  362. package/dist/tools/xulux-templates.d.ts +0 -58
  363. package/dist/tools/xulux-templates.d.ts.map +0 -1
  364. package/dist/tools/xulux-templates.js +0 -84
  365. package/dist/tools/xulux-templates.js.map +0 -1
  366. package/dist/utils/cache.d.ts +0 -5
  367. package/dist/utils/cache.d.ts.map +0 -1
  368. package/dist/utils/cache.js +0 -18
  369. package/dist/utils/cache.js.map +0 -1
  370. package/dist/utils/logger.d.ts +0 -10
  371. package/dist/utils/logger.d.ts.map +0 -1
  372. package/dist/utils/logger.js +0 -20
  373. package/dist/utils/logger.js.map +0 -1
  374. package/dist/utils/mcp-format.d.ts +0 -11
  375. package/dist/utils/mcp-format.d.ts.map +0 -1
  376. package/dist/utils/mcp-format.js +0 -14
  377. package/dist/utils/mcp-format.js.map +0 -1
  378. package/dist/utils/mdx.d.ts +0 -12
  379. package/dist/utils/mdx.d.ts.map +0 -1
  380. package/dist/utils/mdx.js +0 -45
  381. package/dist/utils/mdx.js.map +0 -1
  382. package/dist/utils/paths.d.ts +0 -12
  383. package/dist/utils/paths.d.ts.map +0 -1
  384. package/dist/utils/paths.js +0 -93
  385. package/dist/utils/paths.js.map +0 -1
  386. package/dist/utils/search.d.ts +0 -10
  387. package/dist/utils/search.d.ts.map +0 -1
  388. package/dist/utils/search.js +0 -97
  389. package/dist/utils/search.js.map +0 -1
  390. package/dist/utils/security.d.ts +0 -5
  391. package/dist/utils/security.d.ts.map +0 -1
  392. package/dist/utils/security.js +0 -22
  393. package/dist/utils/security.js.map +0 -1
  394. package/dist/xulux/catalog-client.d.ts +0 -14
  395. package/dist/xulux/catalog-client.d.ts.map +0 -1
  396. package/dist/xulux/catalog-client.js +0 -112
  397. package/dist/xulux/catalog-client.js.map +0 -1
  398. package/dist/xulux/fallback-catalog.d.ts +0 -7
  399. package/dist/xulux/fallback-catalog.d.ts.map +0 -1
  400. package/dist/xulux/fallback-catalog.js +0 -47
  401. package/dist/xulux/fallback-catalog.js.map +0 -1
  402. package/dist/xulux/fetch-sandbox.d.ts +0 -5
  403. package/dist/xulux/fetch-sandbox.d.ts.map +0 -1
  404. package/dist/xulux/fetch-sandbox.js +0 -40
  405. package/dist/xulux/fetch-sandbox.js.map +0 -1
  406. package/dist/xulux/template-service.d.ts +0 -84
  407. package/dist/xulux/template-service.d.ts.map +0 -1
  408. package/dist/xulux/template-service.js +0 -223
  409. package/dist/xulux/template-service.js.map +0 -1
  410. package/dist/xulux/types.d.ts +0 -55
  411. package/dist/xulux/types.d.ts.map +0 -1
  412. package/dist/xulux/types.js +0 -6
  413. package/dist/xulux/types.js.map +0 -1
  414. package/src/constants.ts +0 -24
  415. package/src/prepare-docs/code-examples.ts +0 -158
  416. package/src/prepare-docs/copy-raw.ts +0 -50
  417. package/src/prepare-docs/prepare.ts +0 -24
  418. package/src/prompts/xulux-playground.ts +0 -36
  419. package/src/tools/docs.ts +0 -255
  420. package/src/tools/examples.ts +0 -114
  421. package/src/tools/resources.ts +0 -111
  422. package/src/tools/search.ts +0 -46
  423. package/src/tools/tests/completions.test.ts +0 -60
  424. package/src/tools/tests/directory-size-cap.test.ts +0 -50
  425. package/src/tools/tests/docs.test.ts +0 -147
  426. package/src/tools/tests/examples.test.ts +0 -94
  427. package/src/tools/tests/integration.test.ts +0 -45
  428. package/src/tools/tests/json-parsing.test.ts +0 -23
  429. package/src/tools/tests/listings-cache.test.ts +0 -19
  430. package/src/tools/tests/mcp-protocol.test.ts +0 -216
  431. package/src/tools/tests/mcp-test-client.ts +0 -111
  432. package/src/tools/tests/path-traversal.test.ts +0 -84
  433. package/src/tools/tests/resources.test.ts +0 -133
  434. package/src/tools/tests/search.test.ts +0 -37
  435. package/src/tools/tests/test-setup.ts +0 -50
  436. package/src/tools/tests/xulux-templates.test.ts +0 -325
  437. package/src/tools/xulux-templates.ts +0 -141
  438. package/src/utils/cache.ts +0 -20
  439. package/src/utils/logger.ts +0 -20
  440. package/src/utils/mcp-format.ts +0 -14
  441. package/src/utils/mdx.ts +0 -59
  442. package/src/utils/paths.ts +0 -139
  443. package/src/utils/search.ts +0 -131
  444. package/src/utils/security.ts +0 -52
  445. package/src/utils/tests/cache.test.ts +0 -51
  446. package/src/utils/tests/mcp-format.test.ts +0 -22
  447. package/src/utils/tests/security.test.ts +0 -119
  448. package/src/xulux/catalog-client.ts +0 -150
  449. package/src/xulux/fallback-catalog.ts +0 -63
  450. package/src/xulux/fetch-sandbox.ts +0 -56
  451. package/src/xulux/template-service.ts +0 -406
  452. package/src/xulux/types.ts +0 -64
@@ -1,855 +0,0 @@
1
- # Example: with-langgraph
2
-
3
- ## app/api/[..._path]/route.ts
4
-
5
- ```typescript
6
- import { type NextRequest, NextResponse } from "next/server";
7
-
8
- function getCorsHeaders() {
9
- return {
10
- "Access-Control-Allow-Origin": "*",
11
- "Access-Control-Allow-Methods": "GET, POST, PUT, PATCH, DELETE, OPTIONS",
12
- "Access-Control-Allow-Headers": "*",
13
- };
14
- }
15
-
16
- async function handleRequest(req: NextRequest, method: string) {
17
- try {
18
- const path = req.nextUrl.pathname.replace(/^\/?api\//, "");
19
- const url = new URL(req.url);
20
- const searchParams = new URLSearchParams(url.search);
21
- searchParams.delete("_path");
22
- searchParams.delete("nxtP_path");
23
- const queryString = searchParams.toString()
24
- ? `?${searchParams.toString()}`
25
- : "";
26
-
27
- const options: RequestInit = {
28
- method,
29
- headers: {
30
- "x-api-key": process.env.LANGCHAIN_API_KEY || "",
31
- },
32
- };
33
-
34
- if (["POST", "PUT", "PATCH"].includes(method)) {
35
- options.body = await req.text();
36
- }
37
-
38
- const res = await fetch(
39
- `${process.env.LANGGRAPH_API_URL}/${path}${queryString}`,
40
- options,
41
- );
42
-
43
- const headers = new Headers(res.headers);
44
- headers.delete("content-encoding");
45
- headers.delete("content-length");
46
- headers.delete("transfer-encoding");
47
- const corsHeaders = getCorsHeaders();
48
- for (const [key, value] of Object.entries(corsHeaders)) {
49
- headers.set(key, value);
50
- }
51
-
52
- return new NextResponse(res.body, {
53
- status: res.status,
54
- statusText: res.statusText,
55
- headers,
56
- });
57
- } catch (e: unknown) {
58
- if (e instanceof Error) {
59
- const typedError = e as Error & { status?: number };
60
- return NextResponse.json(
61
- { error: typedError.message },
62
- { status: typedError.status ?? 500 },
63
- );
64
- }
65
- return NextResponse.json({ error: "Unknown error" }, { status: 500 });
66
- }
67
- }
68
-
69
- export const GET = (req: NextRequest) => handleRequest(req, "GET");
70
- export const POST = (req: NextRequest) => handleRequest(req, "POST");
71
- export const PUT = (req: NextRequest) => handleRequest(req, "PUT");
72
- export const PATCH = (req: NextRequest) => handleRequest(req, "PATCH");
73
- export const DELETE = (req: NextRequest) => handleRequest(req, "DELETE");
74
- export const OPTIONS = () =>
75
- new NextResponse(null, {
76
- status: 204,
77
- headers: getCorsHeaders(),
78
- });
79
-
80
- ```
81
-
82
- ## app/globals.css
83
-
84
- ```css
85
- @import "tailwindcss";
86
- @import "tw-animate-css";
87
-
88
- @source "../../../packages/ui/src";
89
-
90
- @custom-variant dark (&:is(.dark *));
91
-
92
- @theme inline {
93
- --radius-sm: calc(var(--radius) - 4px);
94
- --radius-md: calc(var(--radius) - 2px);
95
- --radius-lg: var(--radius);
96
- --radius-xl: calc(var(--radius) + 4px);
97
- --color-background: var(--background);
98
- --color-foreground: var(--foreground);
99
- --color-card: var(--card);
100
- --color-card-foreground: var(--card-foreground);
101
- --color-popover: var(--popover);
102
- --color-popover-foreground: var(--popover-foreground);
103
- --color-primary: var(--primary);
104
- --color-primary-foreground: var(--primary-foreground);
105
- --color-secondary: var(--secondary);
106
- --color-secondary-foreground: var(--secondary-foreground);
107
- --color-muted: var(--muted);
108
- --color-muted-foreground: var(--muted-foreground);
109
- --color-accent: var(--accent);
110
- --color-accent-foreground: var(--accent-foreground);
111
- --color-destructive: var(--destructive);
112
- --color-border: var(--border);
113
- --color-input: var(--input);
114
- --color-ring: var(--ring);
115
- --color-chart-1: var(--chart-1);
116
- --color-chart-2: var(--chart-2);
117
- --color-chart-3: var(--chart-3);
118
- --color-chart-4: var(--chart-4);
119
- --color-chart-5: var(--chart-5);
120
- --color-sidebar: var(--sidebar);
121
- --color-sidebar-foreground: var(--sidebar-foreground);
122
- --color-sidebar-primary: var(--sidebar-primary);
123
- --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
124
- --color-sidebar-accent: var(--sidebar-accent);
125
- --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
126
- --color-sidebar-border: var(--sidebar-border);
127
- --color-sidebar-ring: var(--sidebar-ring);
128
- }
129
-
130
- :root {
131
- --radius: 0.625rem;
132
- --background: oklch(1 0 0);
133
- --foreground: oklch(0.141 0.005 285.823);
134
- --card: oklch(1 0 0);
135
- --card-foreground: oklch(0.141 0.005 285.823);
136
- --popover: oklch(1 0 0);
137
- --popover-foreground: oklch(0.141 0.005 285.823);
138
- --primary: oklch(0.21 0.006 285.885);
139
- --primary-foreground: oklch(0.985 0 0);
140
- --secondary: oklch(0.967 0.001 286.375);
141
- --secondary-foreground: oklch(0.21 0.006 285.885);
142
- --muted: oklch(0.967 0.001 286.375);
143
- --muted-foreground: oklch(0.552 0.016 285.938);
144
- --accent: oklch(0.967 0.001 286.375);
145
- --accent-foreground: oklch(0.21 0.006 285.885);
146
- --destructive: oklch(0.577 0.245 27.325);
147
- --border: oklch(0.92 0.004 286.32);
148
- --input: oklch(0.92 0.004 286.32);
149
- --ring: oklch(0.705 0.015 286.067);
150
- --chart-1: oklch(0.646 0.222 41.116);
151
- --chart-2: oklch(0.6 0.118 184.704);
152
- --chart-3: oklch(0.398 0.07 227.392);
153
- --chart-4: oklch(0.828 0.189 84.429);
154
- --chart-5: oklch(0.769 0.188 70.08);
155
- --sidebar: oklch(0.985 0 0);
156
- --sidebar-foreground: oklch(0.141 0.005 285.823);
157
- --sidebar-primary: oklch(0.21 0.006 285.885);
158
- --sidebar-primary-foreground: oklch(0.985 0 0);
159
- --sidebar-accent: oklch(0.967 0.001 286.375);
160
- --sidebar-accent-foreground: oklch(0.21 0.006 285.885);
161
- --sidebar-border: oklch(0.92 0.004 286.32);
162
- --sidebar-ring: oklch(0.705 0.015 286.067);
163
- }
164
-
165
- .dark {
166
- --background: oklch(0.141 0.005 285.823);
167
- --foreground: oklch(0.985 0 0);
168
- --card: oklch(0.21 0.006 285.885);
169
- --card-foreground: oklch(0.985 0 0);
170
- --popover: oklch(0.21 0.006 285.885);
171
- --popover-foreground: oklch(0.985 0 0);
172
- --primary: oklch(0.92 0.004 286.32);
173
- --primary-foreground: oklch(0.21 0.006 285.885);
174
- --secondary: oklch(0.274 0.006 286.033);
175
- --secondary-foreground: oklch(0.985 0 0);
176
- --muted: oklch(0.274 0.006 286.033);
177
- --muted-foreground: oklch(0.705 0.015 286.067);
178
- --accent: oklch(0.274 0.006 286.033);
179
- --accent-foreground: oklch(0.985 0 0);
180
- --destructive: oklch(0.704 0.191 22.216);
181
- --border: oklch(1 0 0 / 10%);
182
- --input: oklch(1 0 0 / 15%);
183
- --ring: oklch(0.552 0.016 285.938);
184
- --chart-1: oklch(0.488 0.243 264.376);
185
- --chart-2: oklch(0.696 0.17 162.48);
186
- --chart-3: oklch(0.769 0.188 70.08);
187
- --chart-4: oklch(0.627 0.265 303.9);
188
- --chart-5: oklch(0.645 0.246 16.439);
189
- --sidebar: oklch(0.21 0.006 285.885);
190
- --sidebar-foreground: oklch(0.985 0 0);
191
- --sidebar-primary: oklch(0.488 0.243 264.376);
192
- --sidebar-primary-foreground: oklch(0.985 0 0);
193
- --sidebar-accent: oklch(0.274 0.006 286.033);
194
- --sidebar-accent-foreground: oklch(0.985 0 0);
195
- --sidebar-border: oklch(1 0 0 / 10%);
196
- --sidebar-ring: oklch(0.552 0.016 285.938);
197
- }
198
-
199
- @layer base {
200
- * {
201
- @apply border-border outline-ring/50;
202
- }
203
- body {
204
- @apply bg-background text-foreground;
205
- }
206
- }
207
-
208
- ```
209
-
210
- ## app/layout.tsx
211
-
212
- ```tsx
213
- import "./globals.css";
214
-
215
- import { cn } from "@/lib/utils";
216
- import { Montserrat } from "next/font/google";
217
- import { MyRuntimeProvider } from "./MyRuntimeProvider";
218
- import { Suspense } from "react";
219
-
220
- const montserrat = Montserrat({ subsets: ["latin"] });
221
-
222
- export default function RootLayout({
223
- children,
224
- }: Readonly<{
225
- children: React.ReactNode;
226
- }>) {
227
- return (
228
- <MyRuntimeProvider>
229
- <html lang="en">
230
- <body className={cn(montserrat.className, "h-dvh")}>
231
- <Suspense>{children}</Suspense>
232
- </body>
233
- </html>
234
- </MyRuntimeProvider>
235
- );
236
- }
237
-
238
- ```
239
-
240
- ## app/MyRuntimeProvider.tsx
241
-
242
- ```tsx
243
- "use client";
244
-
245
- import { AssistantRuntimeProvider } from "@assistant-ui/react";
246
- import { useStreamRuntime } from "@assistant-ui/react-langchain";
247
- import { Client } from "@langchain/langgraph-sdk";
248
-
249
- export function MyRuntimeProvider({
250
- children,
251
- }: Readonly<{
252
- children: React.ReactNode;
253
- }>) {
254
- const apiUrl =
255
- process.env.NEXT_PUBLIC_LANGGRAPH_API_URL ||
256
- (typeof window !== "undefined"
257
- ? new URL("/api", window.location.href).href
258
- : undefined);
259
-
260
- const runtime = useStreamRuntime({
261
- assistantId: process.env.NEXT_PUBLIC_LANGGRAPH_ASSISTANT_ID!,
262
- apiUrl,
263
- create: async () => {
264
- const { thread_id } = await new Client(
265
- apiUrl ? { apiUrl } : {},
266
- ).threads.create();
267
- return { externalId: thread_id };
268
- },
269
- });
270
-
271
- return (
272
- <AssistantRuntimeProvider runtime={runtime}>
273
- {children}
274
- </AssistantRuntimeProvider>
275
- );
276
- }
277
-
278
- ```
279
-
280
- ## app/page.tsx
281
-
282
- ```tsx
283
- "use client";
284
-
285
- import { Thread } from "@/components/assistant-ui/thread";
286
- import { ThreadList } from "@/components/assistant-ui/thread-list";
287
- import {
288
- useAui,
289
- AuiProvider,
290
- AuiConfig,
291
- Suggestions,
292
- Tools,
293
- } from "@assistant-ui/react";
294
- import toolkit from "./toolkit";
295
-
296
- function ThreadWithSuggestions() {
297
- const aui = useAui();
298
- const config = AuiConfig({
299
- tools: Tools({ toolkit }),
300
- suggestions: Suggestions([
301
- {
302
- title: "Check stock price",
303
- label: "get the latest AAPL snapshot",
304
- prompt: "What's the current price of AAPL?",
305
- },
306
- {
307
- title: "Buy shares",
308
- label: "execute a stock purchase",
309
- prompt: "Buy 10 shares of TSLA.",
310
- },
311
- ]),
312
- });
313
- return (
314
- <AuiProvider extends={aui} config={config}>
315
- <Thread />
316
- </AuiProvider>
317
- );
318
- }
319
-
320
- export default function Home() {
321
- return (
322
- <div className="flex h-dvh">
323
- <div className="max-w-md">
324
- <ThreadList />
325
- </div>
326
- <div className="flex-grow">
327
- <ThreadWithSuggestions />
328
- </div>
329
- </div>
330
- );
331
- }
332
-
333
- ```
334
-
335
- ## app/toolkit.tsx
336
-
337
- ```tsx
338
- "use generative";
339
-
340
- import { defineToolkit, externalTool } from "@assistant-ui/react";
341
- import { PriceSnapshotToolUI } from "@/components/tools/price-snapshot/PriceSnapshotTool";
342
- import { PurchaseStockToolUI } from "@/components/tools/purchase-stock/PurchaseStockTool";
343
-
344
- export default defineToolkit({
345
- price_snapshot: {
346
- execute: externalTool(),
347
- render: PriceSnapshotToolUI,
348
- },
349
- purchase_stock: {
350
- execute: externalTool(),
351
- render: PurchaseStockToolUI,
352
- },
353
- });
354
-
355
- ```
356
-
357
- ## components.json
358
-
359
- ```json
360
- {
361
- "$schema": "https://ui.shadcn.com/schema.json",
362
- "style": "new-york",
363
- "rsc": true,
364
- "tsx": true,
365
- "tailwind": {
366
- "config": "",
367
- "css": "app/globals.css",
368
- "baseColor": "zinc",
369
- "cssVariables": true,
370
- "prefix": ""
371
- },
372
- "aliases": {
373
- "components": "@/components",
374
- "utils": "@/lib/utils",
375
- "ui": "@/components/ui",
376
- "lib": "@/lib",
377
- "hooks": "@/hooks"
378
- },
379
- "iconLibrary": "lucide",
380
- "registries": {
381
- "@assistant-ui": "https://r.assistant-ui.com/{name}.json"
382
- }
383
- }
384
-
385
- ```
386
-
387
- ## components/tools/price-snapshot/price-snapshot.tsx
388
-
389
- ```tsx
390
- "use client";
391
-
392
- import { ArrowDownIcon, ArrowUpIcon } from "lucide-react";
393
-
394
- import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
395
-
396
- type PriceSnapshotToolArgs = {
397
- ticker: string;
398
- };
399
-
400
- type PriceSnapshotToolResult = {
401
- price: number;
402
- day_change: number;
403
- day_change_percent: number;
404
- time: string;
405
- };
406
-
407
- export function PriceSnapshot({
408
- ticker,
409
- price,
410
- day_change,
411
- day_change_percent,
412
- time,
413
- }: PriceSnapshotToolArgs & PriceSnapshotToolResult) {
414
- const isPositiveChange = day_change >= 0;
415
- const changeColor = isPositiveChange ? "text-green-600" : "text-red-600";
416
- const ArrowIcon = isPositiveChange ? ArrowUpIcon : ArrowDownIcon;
417
-
418
- return (
419
- <Card className="mx-auto w-full max-w-md">
420
- <CardHeader>
421
- <CardTitle className="text-2xl font-bold">{ticker}</CardTitle>
422
- </CardHeader>
423
- <CardContent>
424
- <div className="grid grid-cols-2 gap-4">
425
- <div className="col-span-2">
426
- <p className="text-3xl font-semibold">${price?.toFixed(2)}</p>
427
- </div>
428
- <div>
429
- <p className="text-muted-foreground text-sm">Day Change</p>
430
- <p
431
- className={`flex items-center text-lg font-medium ${changeColor}`}
432
- >
433
- <ArrowIcon className="mr-1 h-4 w-4" />$
434
- {Math.abs(day_change)?.toFixed(2)} (
435
- {Math.abs(day_change_percent)?.toFixed(2)}%)
436
- </p>
437
- </div>
438
- <div>
439
- <p className="text-muted-foreground text-sm">Last Updated</p>
440
- <p className="text-lg font-medium">
441
- {new Date(time).toLocaleTimeString()}
442
- </p>
443
- </div>
444
- </div>
445
- </CardContent>
446
- </Card>
447
- );
448
- }
449
-
450
- ```
451
-
452
- ## components/tools/price-snapshot/PriceSnapshotTool.tsx
453
-
454
- ```tsx
455
- "use client";
456
-
457
- import { PriceSnapshot } from "./price-snapshot";
458
- import type { ToolCallMessagePartComponent } from "@assistant-ui/react";
459
-
460
- type PriceSnapshotToolArgs = {
461
- ticker: string;
462
- };
463
- type PriceSnapshotToolResult = {
464
- snapshot: {
465
- price: number;
466
- day_change: number;
467
- day_change_percent: number;
468
- time: string;
469
- };
470
- };
471
- export const PriceSnapshotToolUI: ToolCallMessagePartComponent<
472
- PriceSnapshotToolArgs,
473
- string
474
- > = function PriceSnapshotUI({ args, argsText, result }) {
475
- const resultObj = result
476
- ? (JSON.parse(result) as PriceSnapshotToolResult)
477
- : undefined;
478
-
479
- return (
480
- <div className="mb-4 flex flex-col items-center gap-2">
481
- <pre className="whitespace-pre-wrap">price_snapshot({argsText})</pre>
482
- {resultObj && (
483
- <PriceSnapshot ticker={args.ticker} {...resultObj.snapshot} />
484
- )}
485
- </div>
486
- );
487
- };
488
-
489
- ```
490
-
491
- ## components/tools/purchase-stock/PurchaseStockTool.tsx
492
-
493
- ```tsx
494
- "use client";
495
-
496
- import { TransactionConfirmationPending } from "./transaction-confirmation-pending";
497
- import { TransactionConfirmationFinal } from "./transaction-confirmation-final";
498
- import type { ToolCallMessagePartComponent } from "@assistant-ui/react";
499
-
500
- type PurchaseStockArgs = {
501
- ticker: string;
502
- companyName: string;
503
- quantity: number;
504
- maxPurchasePrice: number;
505
- };
506
-
507
- export const PurchaseStockToolUI: ToolCallMessagePartComponent<
508
- PurchaseStockArgs,
509
- string
510
- > = function PurchaseStockUI({ args, argsText, result, status, addResult }) {
511
- const resultObj = result
512
- ? (JSON.parse(result) as { transactionId: string })
513
- : undefined;
514
-
515
- const handleConfirm = async () => {
516
- addResult(JSON.stringify({ confirmed: true }));
517
- };
518
-
519
- return (
520
- <div className="mb-4 flex flex-col items-center gap-2">
521
- <pre className="whitespace-pre-wrap">purchase_stock({argsText})</pre>
522
- {!resultObj && status.type !== "running" && (
523
- <TransactionConfirmationPending {...args} onConfirm={handleConfirm} />
524
- )}
525
- {resultObj && <TransactionConfirmationFinal {...args} />}
526
- </div>
527
- );
528
- };
529
-
530
- ```
531
-
532
- ## components/tools/purchase-stock/transaction-confirmation-final.tsx
533
-
534
- ```tsx
535
- "use client";
536
-
537
- import { CheckCircle } from "lucide-react";
538
-
539
- import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
540
-
541
- type TransactionConfirmation = {
542
- ticker: string;
543
- companyName: string;
544
- quantity: number;
545
- maxPurchasePrice: number;
546
- };
547
-
548
- export function TransactionConfirmationFinal(props: TransactionConfirmation) {
549
- const { ticker, companyName, quantity, maxPurchasePrice } = props;
550
-
551
- return (
552
- <Card className="mx-auto w-full max-w-md">
553
- <CardHeader className="text-center">
554
- <CheckCircle className="mx-auto mb-4 h-16 w-16 text-green-500" />
555
- <CardTitle className="text-2xl font-bold text-green-700">
556
- Transaction Confirmed
557
- </CardTitle>
558
- </CardHeader>
559
- <CardContent className="space-y-4">
560
- <div className="rounded-md border border-green-200 bg-green-50 p-4">
561
- <h3 className="mb-2 text-lg font-semibold text-green-800">
562
- Purchase Summary
563
- </h3>
564
- <div className="grid grid-cols-2 gap-2 text-sm">
565
- <p className="font-medium text-green-700">Ticker:</p>
566
- <p className="font-bold text-green-900">{ticker}</p>
567
- <p className="font-medium text-green-700">Company:</p>
568
- <p className="text-green-900">{companyName}</p>
569
- <p className="font-medium text-green-700">Quantity:</p>
570
- <p className="text-green-900">{quantity} shares</p>
571
- <p className="font-medium text-green-700">Price per Share:</p>
572
- <p className="text-green-900">${maxPurchasePrice?.toFixed(2)}</p>
573
- </div>
574
- </div>
575
- <div className="rounded-md border border-green-300 bg-green-100 p-4">
576
- <p className="text-lg font-semibold text-green-800">Total Cost:</p>
577
- <p className="text-2xl font-bold text-green-900">
578
- ${(quantity * maxPurchasePrice)?.toFixed(2)}
579
- </p>
580
- </div>
581
- <p className="text-center text-sm text-green-600">
582
- Your purchase of {quantity} shares of {companyName} ({ticker}) has
583
- been successfully processed.
584
- </p>
585
- </CardContent>
586
- </Card>
587
- );
588
- }
589
-
590
- ```
591
-
592
- ## components/tools/purchase-stock/transaction-confirmation-pending.tsx
593
-
594
- ```tsx
595
- "use client";
596
-
597
- import { CheckIcon } from "lucide-react";
598
-
599
- import { Button } from "@/components/ui/button";
600
- import {
601
- Card,
602
- CardContent,
603
- CardFooter,
604
- CardHeader,
605
- CardTitle,
606
- } from "@/components/ui/card";
607
-
608
- type TransactionConfirmation = {
609
- ticker: string;
610
- companyName: string;
611
- quantity: number;
612
- maxPurchasePrice: number;
613
- onConfirm: () => void;
614
- };
615
-
616
- export function TransactionConfirmationPending(props: TransactionConfirmation) {
617
- const { ticker, companyName, quantity, maxPurchasePrice, onConfirm } = props;
618
-
619
- return (
620
- <Card className="mx-auto w-full max-w-md">
621
- <CardHeader>
622
- <CardTitle className="text-2xl font-bold">
623
- Confirm Transaction
624
- </CardTitle>
625
- </CardHeader>
626
- <CardContent className="space-y-4">
627
- <div className="grid grid-cols-2 gap-2">
628
- <p className="text-muted-foreground text-sm font-medium">Ticker:</p>
629
- <p className="text-sm font-bold">{ticker}</p>
630
- <p className="text-muted-foreground text-sm font-medium">Company:</p>
631
- <p className="text-sm">{companyName}</p>
632
- <p className="text-muted-foreground text-sm font-medium">Quantity:</p>
633
- <p className="text-sm">{quantity} shares</p>
634
- <p className="text-muted-foreground text-sm font-medium">
635
- Max Purchase Price:
636
- </p>
637
- <p className="text-sm">${maxPurchasePrice?.toFixed(2)}</p>
638
- </div>
639
- <div className="bg-muted rounded-md p-3">
640
- <p className="text-sm font-medium">Total Maximum Cost:</p>
641
- <p className="text-lg font-bold">
642
- ${(quantity * maxPurchasePrice)?.toFixed(2)}
643
- </p>
644
- </div>
645
- </CardContent>
646
- <CardFooter className="flex justify-end">
647
- {/* <Button variant="outline" onClick={onReject}>
648
- <X className="mr-2 h-4 w-4" />
649
- Reject
650
- </Button> */}
651
- <Button onClick={onConfirm}>
652
- <CheckIcon className="mr-2 h-4 w-4" />
653
- Confirm
654
- </Button>
655
- </CardFooter>
656
- </Card>
657
- );
658
- }
659
-
660
- ```
661
-
662
- ## components/tools/ToolFallback.tsx
663
-
664
- ```tsx
665
- import type { ToolCallMessagePartComponent } from "@assistant-ui/react";
666
- import { CheckIcon, ChevronDownIcon, ChevronUpIcon } from "lucide-react";
667
- import { useState } from "react";
668
- import { Button } from "@/components/ui/button";
669
-
670
- export const ToolFallback: ToolCallMessagePartComponent = ({
671
- toolName,
672
- argsText,
673
- result,
674
- }) => {
675
- const [isCollapsed, setIsCollapsed] = useState(true);
676
- return (
677
- <div className="mb-4 flex w-full flex-col gap-3 rounded-lg border py-3">
678
- <div className="flex items-center gap-2 px-4">
679
- <CheckIcon className="size-4" />
680
- <p className="">
681
- Used tool: <b>{toolName}</b>
682
- </p>
683
- <div className="flex-grow" />
684
- <Button onClick={() => setIsCollapsed(!isCollapsed)}>
685
- {isCollapsed ? <ChevronUpIcon /> : <ChevronDownIcon />}
686
- </Button>
687
- </div>
688
- {!isCollapsed && (
689
- <div className="flex flex-col gap-2 border-t pt-2">
690
- <div className="px-4">
691
- <pre className="whitespace-pre-wrap">{argsText}</pre>
692
- </div>
693
- {result !== undefined && (
694
- <div className="border-t border-dashed px-4 pt-2">
695
- <p className="font-semibold">Result:</p>
696
- <pre className="whitespace-pre-wrap">
697
- {typeof result === "string"
698
- ? result
699
- : JSON.stringify(result, null, 2)}
700
- </pre>
701
- </div>
702
- )}
703
- </div>
704
- )}
705
- </div>
706
- );
707
- };
708
-
709
- ```
710
-
711
- ## next.config.ts
712
-
713
- ```typescript
714
- import { withAui } from "@assistant-ui/next";
715
- import type { NextConfig } from "next";
716
-
717
- const nextConfig: NextConfig = {
718
- async rewrites() {
719
- return [
720
- {
721
- source: "/assistant/:path*",
722
- destination: "http://localhost:8000/assistant/:path*",
723
- },
724
- ];
725
- },
726
- };
727
-
728
- export default withAui(nextConfig);
729
-
730
- ```
731
-
732
- ## package.json
733
-
734
- ```json
735
- {
736
- "name": "with-langgraph",
737
- "version": "0.0.0",
738
- "private": true,
739
- "type": "module",
740
- "scripts": {
741
- "dev": "next dev",
742
- "build": "next build",
743
- "start": "next start"
744
- },
745
- "dependencies": {
746
- "@assistant-ui/react": "workspace:*",
747
- "@assistant-ui/react-langchain": "workspace:*",
748
- "@assistant-ui/react-markdown": "workspace:*",
749
- "@assistant-ui/ui": "workspace:*",
750
- "@langchain/langgraph-sdk": "^1.9.31",
751
- "@langchain/react": "^1.0.32",
752
- "class-variance-authority": "^0.7.1",
753
- "clsx": "^2.1.1",
754
- "lucide-react": "^1.33.0",
755
- "next": "^16.3.2",
756
- "react": "^19.2.8",
757
- "react-dom": "^19.2.8",
758
- "tailwind-merge": "^3.6.0"
759
- },
760
- "devDependencies": {
761
- "@assistant-ui/next": "workspace:*",
762
- "@assistant-ui/x-buildutils": "workspace:*",
763
- "@tailwindcss/postcss": "^4.3.3",
764
- "@types/node": "^26.2.0",
765
- "@types/react": "^19.2.18",
766
- "@types/react-dom": "^19.2.5",
767
- "postcss": "^8.5.26",
768
- "tailwindcss": "^4.3.3",
769
- "tw-animate-css": "^1.4.0",
770
- "typescript": "^7.0.2"
771
- }
772
- }
773
-
774
- ```
775
-
776
- ## README.md
777
-
778
- ```markdown
779
- # LangGraph Integration
780
-
781
- [Hosted Demo](https://assistant-ui-langgraph.vercel.app/)
782
-
783
- This example demonstrates how to use LangChain LangGraph with assistant-ui. It is meant to be used with the backend found at LangGraph's Stockbroker example: https://github.com/bracesproul/langgraphjs-examples/tree/main/stockbroker
784
-
785
- ## Quick Start
786
-
787
- ### Using CLI (Recommended)
788
-
789
- ```bash
790
- npx assistant-ui@latest create my-app --example with-langgraph
791
- cd my-app
792
- ```
793
-
794
- ### Environment Variables
795
-
796
- Create `.env.local`:
797
-
798
- ```
799
- LANGGRAPH_API_URL=http://localhost:2024
800
- LANGCHAIN_API_KEY=
801
- NEXT_PUBLIC_LANGGRAPH_ASSISTANT_ID=stockbroker
802
- ```
803
-
804
- `LANGGRAPH_API_URL` is the LangGraph deployment URL the bundled `/api/[..._path]` proxy fetches from. `LANGCHAIN_API_KEY` is forwarded as `x-api-key` and can be blank for an unauthenticated dev server. `NEXT_PUBLIC_LANGGRAPH_ASSISTANT_ID` is the graph id (a key under `graphs` in your `langgraph.json`).
805
-
806
- ### Run
807
-
808
- ```bash
809
- npm install
810
- npm run dev
811
- ```
812
-
813
- ## Features
814
-
815
- - LangGraph agent integration via `@assistant-ui/react-langchain`
816
- - Thread list for conversation management
817
- - Custom tool UI for stock price snapshots
818
- - Custom tool UI for stock purchases
819
-
820
- ## Related Documentation
821
-
822
- - [assistant-ui Documentation](https://www.assistant-ui.com/docs)
823
- - [LangGraph Integration Guide](https://www.assistant-ui.com/docs/runtimes/langgraph)
824
-
825
- ```
826
-
827
- ## tsconfig.json
828
-
829
- ```json
830
- {
831
- "extends": "@assistant-ui/x-buildutils/ts/next",
832
- "compilerOptions": {
833
- "paths": {
834
- "@/*": ["./*"],
835
- "@/components/assistant-ui/*": [
836
- "../../packages/ui/src/components/assistant-ui/*"
837
- ],
838
- "@/hooks/*": ["../../packages/ui/src/hooks/*"],
839
- "@/components/ui/*": [
840
- "../../packages/ui/src/components/ui/base/*",
841
- "../../packages/ui/src/components/ui/radix/*"
842
- ],
843
- "@/components/ui/radix/*": [
844
- "../../packages/ui/src/components/ui/radix/*"
845
- ],
846
- "@/lib/utils": ["../../packages/ui/src/lib/utils"],
847
- "@assistant-ui/ui/*": ["../../packages/ui/src/*"]
848
- }
849
- },
850
- "include": ["**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
851
- "exclude": ["node_modules"]
852
- }
853
-
854
- ```
855
-