@assistant-ui/mcp-docs-server 0.1.39 → 0.2.0

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 (136) hide show
  1. package/.docs/organized/code-examples/waterfall.md +7 -7
  2. package/.docs/organized/code-examples/with-a2a.md +7 -7
  3. package/.docs/organized/code-examples/with-ag-ui.md +8 -8
  4. package/.docs/organized/code-examples/with-ai-sdk-v7.md +9 -9
  5. package/.docs/organized/code-examples/with-artifacts.md +463 -138
  6. package/.docs/organized/code-examples/with-assistant-transport.md +7 -7
  7. package/.docs/organized/code-examples/with-browser-extension.md +6 -6
  8. package/.docs/organized/code-examples/with-chain-of-thought.md +11 -11
  9. package/.docs/organized/code-examples/with-cloud-standalone.md +9 -9
  10. package/.docs/organized/code-examples/with-cloud.md +9 -9
  11. package/.docs/organized/code-examples/with-custom-thread-list.md +9 -9
  12. package/.docs/organized/code-examples/with-elevenlabs-conversational.md +11 -11
  13. package/.docs/organized/code-examples/with-elevenlabs-scribe.md +11 -11
  14. package/.docs/organized/code-examples/with-eve.md +8 -8
  15. package/.docs/organized/code-examples/with-expo.md +26 -46
  16. package/.docs/organized/code-examples/with-external-store.md +7 -7
  17. package/.docs/organized/code-examples/with-ffmpeg.md +9 -9
  18. package/.docs/organized/code-examples/with-generative-ui.md +10 -10
  19. package/.docs/organized/code-examples/with-google-adk.md +8 -8
  20. package/.docs/organized/code-examples/with-heat-graph.md +6 -6
  21. package/.docs/organized/code-examples/with-image-generation.md +9 -9
  22. package/.docs/organized/code-examples/with-interactables.md +9 -9
  23. package/.docs/organized/code-examples/with-langchain.md +9 -9
  24. package/.docs/organized/code-examples/with-langgraph.md +9 -9
  25. package/.docs/organized/code-examples/with-livekit.md +11 -11
  26. package/.docs/organized/code-examples/with-mcp.md +28 -23
  27. package/.docs/organized/code-examples/with-opencode.md +8 -11
  28. package/.docs/organized/code-examples/with-pi.md +14 -14
  29. package/.docs/organized/code-examples/with-react-hook-form.md +10 -10
  30. package/.docs/organized/code-examples/with-react-ink-web.md +5 -5
  31. package/.docs/organized/code-examples/with-react-ink.md +2 -2
  32. package/.docs/organized/code-examples/with-react-router.md +11 -11
  33. package/.docs/organized/code-examples/with-resumable-stream.md +10 -10
  34. package/.docs/organized/code-examples/with-store.md +6 -6
  35. package/.docs/organized/code-examples/with-tanstack.md +9 -9
  36. package/.docs/organized/code-examples/with-tap-runtime.md +7 -7
  37. package/.docs/organized/code-examples/with-virtualized-thread.md +8 -8
  38. package/.docs/raw/docs/(docs)/cli.mdx +2 -0
  39. package/.docs/raw/docs/(docs)/devtools.mdx +7 -2
  40. package/.docs/raw/docs/(reference)/api-reference/generative-ui/a2ui.mdx +40 -0
  41. package/.docs/raw/docs/(reference)/api-reference/generative-ui/index.mdx +3 -0
  42. package/.docs/raw/docs/(reference)/api-reference/hooks/primitives.mdx +19 -420
  43. package/.docs/raw/docs/(reference)/api-reference/hooks/state.mdx +4 -1
  44. package/.docs/raw/docs/(reference)/api-reference/integrations/react-ai-sdk.mdx +21 -0
  45. package/.docs/raw/docs/(reference)/api-reference/model-context/context.mdx +1 -9
  46. package/.docs/raw/docs/(reference)/api-reference/primitives/assistant-if.mdx +1 -18
  47. package/.docs/raw/docs/cloud/langgraph.mdx +1 -1
  48. package/.docs/raw/docs/copilots/model-context.mdx +1 -1
  49. package/.docs/raw/docs/copilots/motivation.mdx +1 -1
  50. package/.docs/raw/docs/guides/attachments.mdx +3 -3
  51. package/.docs/raw/docs/guides/branching.mdx +2 -2
  52. package/.docs/raw/docs/guides/context-api.mdx +89 -111
  53. package/.docs/raw/docs/guides/editing.mdx +5 -5
  54. package/.docs/raw/docs/guides/electron.mdx +369 -0
  55. package/.docs/raw/docs/guides/index.mdx +10 -0
  56. package/.docs/raw/docs/guides/quoting.mdx +3 -3
  57. package/.docs/raw/docs/guides/resumable-stream-deployment.mdx +2 -2
  58. package/.docs/raw/docs/ink/hooks.mdx +3 -3
  59. package/.docs/raw/docs/ink/primitives.mdx +14 -7
  60. package/.docs/raw/docs/integrations/auth/better-auth.mdx +2 -2
  61. package/.docs/raw/docs/integrations/auth/clerk.mdx +2 -2
  62. package/.docs/raw/docs/integrations/auth/next-auth.mdx +3 -3
  63. package/.docs/raw/docs/integrations/observability/langsmith.mdx +1 -1
  64. package/.docs/raw/docs/integrations/persistence/custom-adapter.mdx +36 -9
  65. package/.docs/raw/docs/migrations/v0-15.mdx +156 -0
  66. package/.docs/raw/docs/primitives/composer.mdx +1 -1
  67. package/.docs/raw/docs/primitives/thread-list.mdx +2 -2
  68. package/.docs/raw/docs/react-native/hooks.mdx +3 -3
  69. package/.docs/raw/docs/react-native/index.mdx +2 -2
  70. package/.docs/raw/docs/react-native/primitives.mdx +39 -5
  71. package/.docs/raw/docs/runtimes/ai-sdk/overview.mdx +3 -3
  72. package/.docs/raw/docs/runtimes/ai-sdk/v4-legacy.mdx +4 -4
  73. package/.docs/raw/docs/runtimes/ai-sdk/v5-legacy.mdx +4 -4
  74. package/.docs/raw/docs/runtimes/ai-sdk/v6-legacy.mdx +4 -4
  75. package/.docs/raw/docs/runtimes/ai-sdk/v7.mdx +2 -2
  76. package/.docs/raw/docs/runtimes/concepts/threads.mdx +10 -10
  77. package/.docs/raw/docs/runtimes/custom/assistant-transport.mdx +2 -2
  78. package/.docs/raw/docs/runtimes/custom/external-store.mdx +1 -1
  79. package/.docs/raw/docs/runtimes/custom/local-runtime.mdx +3 -3
  80. package/.docs/raw/docs/runtimes/langchain.mdx +2 -2
  81. package/.docs/raw/docs/runtimes/langgraph/overview.mdx +1 -1
  82. package/.docs/raw/docs/runtimes/opencode/hooks.mdx +3 -1
  83. package/.docs/raw/docs/tools/a2ui.mdx +107 -0
  84. package/.docs/raw/docs/tools/interactables-legacy.mdx +4 -4
  85. package/.docs/raw/docs/tools/interactables.mdx +3 -3
  86. package/.docs/raw/docs/tools/mcp-apps.mdx +61 -2
  87. package/.docs/raw/docs/tools/user-managed-mcp.mdx +52 -7
  88. package/.docs/raw/docs/ui/follow-up-suggestions.mdx +2 -0
  89. package/.docs/raw/docs/ui/model-selector.mdx +1 -1
  90. package/.docs/raw/docs/ui/part-grouping.mdx +0 -4
  91. package/.docs/raw/docs/ui/reasoning.mdx +1 -1
  92. package/dist/index.d.ts +1 -1
  93. package/dist/index.js +2 -2
  94. package/dist/index.js.map +1 -1
  95. package/dist/prepare-docs/code-examples.js.map +1 -1
  96. package/dist/prepare-docs/prepare.d.ts +1 -1
  97. package/dist/stdio.d.ts +1 -1
  98. package/dist/tools/docs.d.ts +6 -10
  99. package/dist/tools/docs.d.ts.map +1 -1
  100. package/dist/tools/docs.js +2 -2
  101. package/dist/tools/docs.js.map +1 -1
  102. package/dist/tools/examples.d.ts +4 -8
  103. package/dist/tools/examples.d.ts.map +1 -1
  104. package/dist/tools/examples.js +2 -2
  105. package/dist/tools/examples.js.map +1 -1
  106. package/dist/tools/resources.d.ts +1 -1
  107. package/dist/tools/resources.d.ts.map +1 -1
  108. package/dist/tools/resources.js +1 -1
  109. package/dist/tools/resources.js.map +1 -1
  110. package/dist/tools/search.d.ts +4 -10
  111. package/dist/tools/search.d.ts.map +1 -1
  112. package/dist/tools/search.js +2 -2
  113. package/dist/tools/search.js.map +1 -1
  114. package/dist/tools/tests/mcp-test-client.d.ts +15 -0
  115. package/dist/tools/tests/mcp-test-client.d.ts.map +1 -0
  116. package/dist/tools/tests/mcp-test-client.js +68 -0
  117. package/dist/tools/tests/mcp-test-client.js.map +1 -0
  118. package/dist/tools/tests/test-setup.d.ts.map +1 -1
  119. package/dist/tools/xulux-templates.d.ts +9 -23
  120. package/dist/tools/xulux-templates.d.ts.map +1 -1
  121. package/dist/tools/xulux-templates.js +4 -4
  122. package/dist/tools/xulux-templates.js.map +1 -1
  123. package/dist/utils/logger.d.ts.map +1 -1
  124. package/dist/utils/security.js.map +1 -1
  125. package/package.json +4 -3
  126. package/src/index.ts +2 -2
  127. package/src/tools/docs.ts +2 -2
  128. package/src/tools/examples.ts +2 -2
  129. package/src/tools/resources.ts +1 -4
  130. package/src/tools/search.ts +2 -2
  131. package/src/tools/tests/completions.test.ts +40 -26
  132. package/src/tools/tests/integration.test.ts +3 -4
  133. package/src/tools/tests/mcp-protocol.test.ts +160 -175
  134. package/src/tools/tests/mcp-test-client.ts +111 -0
  135. package/src/tools/tests/resources.test.ts +97 -66
  136. package/src/tools/xulux-templates.ts +4 -4
@@ -64,19 +64,19 @@
64
64
  "dependencies": {
65
65
  "@assistant-ui/react": "workspace:*",
66
66
  "@assistant-ui/react-markdown": "workspace:*",
67
- "@tailwindcss/vite": "^4.3.2",
67
+ "@tailwindcss/vite": "^4.3.3",
68
68
  "@tanstack/react-router": "^1.170.18",
69
- "@tanstack/react-start": "^1.168.28",
69
+ "@tanstack/react-start": "^1.168.32",
70
70
  "class-variance-authority": "^0.7.1",
71
71
  "clsx": "^2.1.1",
72
- "lucide-react": "^1.24.0",
72
+ "lucide-react": "^1.26.0",
73
73
  "nitro": "^3.0.260311-beta",
74
- "openai": "^6.47.0",
75
- "react": "^19.2.7",
76
- "react-dom": "^19.2.7",
74
+ "openai": "^6.49.0",
75
+ "react": "^19.2.8",
76
+ "react-dom": "^19.2.8",
77
77
  "remark-gfm": "^4.0.1",
78
78
  "tailwind-merge": "^3.6.0",
79
- "tailwindcss": "^4.3.2",
79
+ "tailwindcss": "^4.3.3",
80
80
  "vite-tsconfig-paths": "^6.1.1"
81
81
  },
82
82
  "devDependencies": {
@@ -84,9 +84,9 @@
84
84
  "@types/node": "^26.1.1",
85
85
  "@types/react": "^19.2.17",
86
86
  "@types/react-dom": "^19.2.3",
87
- "@vitejs/plugin-react": "^6.0.3",
87
+ "@vitejs/plugin-react": "^6.0.4",
88
88
  "typescript": "^7.0.2",
89
- "vite": "^8.1.4"
89
+ "vite": "^8.1.5"
90
90
  }
91
91
  }
92
92
 
@@ -600,21 +600,21 @@ export default withAui(nextConfig);
600
600
  "@assistant-ui/ui": "workspace:*",
601
601
  "class-variance-authority": "^0.7.1",
602
602
  "clsx": "^2.1.1",
603
- "lucide-react": "^1.24.0",
604
- "next": "^16.2.10",
605
- "react": "^19.2.7",
606
- "react-dom": "^19.2.7",
603
+ "lucide-react": "^1.26.0",
604
+ "next": "^16.2.11",
605
+ "react": "^19.2.8",
606
+ "react-dom": "^19.2.8",
607
607
  "tailwind-merge": "^3.6.0"
608
608
  },
609
609
  "devDependencies": {
610
610
  "@assistant-ui/next": "workspace:*",
611
611
  "@assistant-ui/x-buildutils": "workspace:*",
612
- "@tailwindcss/postcss": "^4.3.2",
612
+ "@tailwindcss/postcss": "^4.3.3",
613
613
  "@types/node": "^26.1.1",
614
614
  "@types/react": "^19.2.17",
615
615
  "@types/react-dom": "^19.2.3",
616
- "postcss": "^8.5.19",
617
- "tailwindcss": "^4.3.2",
616
+ "postcss": "^8.5.23",
617
+ "tailwindcss": "^4.3.3",
618
618
  "tw-animate-css": "^1.4.0",
619
619
  "typescript": "npm:@typescript/typescript6@^6.0.2",
620
620
  "typescript-7": "npm:typescript@^7.0.2"
@@ -597,24 +597,24 @@ export default withAui(nextConfig);
597
597
  "@assistant-ui/react": "workspace:*",
598
598
  "@assistant-ui/react-markdown": "workspace:*",
599
599
  "@assistant-ui/ui": "workspace:*",
600
- "@tanstack/react-virtual": "^3.14.6",
600
+ "@tanstack/react-virtual": "^3.14.8",
601
601
  "class-variance-authority": "^0.7.1",
602
602
  "clsx": "^2.1.1",
603
- "lucide-react": "^1.24.0",
604
- "next": "^16.2.10",
605
- "react": "^19.2.7",
606
- "react-dom": "^19.2.7",
603
+ "lucide-react": "^1.26.0",
604
+ "next": "^16.2.11",
605
+ "react": "^19.2.8",
606
+ "react-dom": "^19.2.8",
607
607
  "tailwind-merge": "^3.6.0"
608
608
  },
609
609
  "devDependencies": {
610
610
  "@assistant-ui/next": "workspace:*",
611
611
  "@assistant-ui/x-buildutils": "workspace:*",
612
- "@tailwindcss/postcss": "^4.3.2",
612
+ "@tailwindcss/postcss": "^4.3.3",
613
613
  "@types/node": "^26.1.1",
614
614
  "@types/react": "^19.2.17",
615
615
  "@types/react-dom": "^19.2.3",
616
- "postcss": "^8.5.19",
617
- "tailwindcss": "^4.3.2",
616
+ "postcss": "^8.5.23",
617
+ "tailwindcss": "^4.3.3",
618
618
  "tw-animate-css": "^1.4.0",
619
619
  "typescript": "npm:@typescript/typescript6@^6.0.2",
620
620
  "typescript-7": "npm:typescript@^7.0.2"
@@ -356,6 +356,7 @@ npx assistant-ui@latest info
356
356
  ```
357
357
 
358
358
  This command collects and prints:
359
+ - The running `assistant-ui` CLI version
359
360
  - OS, Node.js version, package manager, and framework
360
361
  - All installed `@assistant-ui/*` and `assistant-*` package versions
361
362
  - Key ecosystem dependency versions (React, Next.js, AI SDK, etc.)
@@ -365,6 +366,7 @@ This command collects and prints:
365
366
 
366
367
  ```
367
368
  Environment:
369
+ assistant-ui CLI: 0.0.106
368
370
  OS: macOS 15.3 (arm64)
369
371
  Node.js: v22.14.0
370
372
  Package Manager: pnpm 10.32.1
@@ -4,10 +4,13 @@ description: Inspect runtime state, context, and events in the browser.
4
4
  platforms: ["react"]
5
5
  ---
6
6
 
7
+ import { DevToolsSample, DevToolsModalSample } from "@/components/docs/samples/devtools";
7
8
 
8
9
  The assistant-ui DevTools allows you to debug the assistant-ui state and context, and events without resorting to `console.log`. It's an easy way to see how data flows to the assistant-ui's runtime layer.
9
10
 
10
- ![Screenshot of the DevTools UI showing logs and state panels](../../../../../.github/assets/devtoolsui.png)
11
+ Try it below — the chat on top is a live assistant-ui app, and the panel underneath is the real DevTools inspecting it. Send a message, trigger a tool call, and switch between the Thread, Context, and Activity tabs.
12
+
13
+ <DevToolsSample />
11
14
 
12
15
  ## Setup
13
16
 
@@ -45,7 +48,9 @@ export function AssistantApp() {
45
48
 
46
49
  That's it! In development builds you should now see the DevTools launcher in the lower-right corner of your site. The panel renders inline in an isolated shadow root, and the whole component is stripped from production builds.
47
50
 
48
- ![DevTools floating launcher anchored in the lower-right corner of a page](../../../../../.github/assets/devtoolsmodal.png)
51
+ Try it here — click the launcher in the lower-right corner of the frame, then use "Run a demo turn" to watch events stream into the open panel. In your app the window opens over a dimmed, click-to-close backdrop; the demo omits it so the app stays usable while the panel is open:
52
+
53
+ <DevToolsModalSample />
49
54
 
50
55
  </Step>
51
56
  </Steps>
@@ -0,0 +1,40 @@
1
+ ---
2
+ title: A2UI
3
+ description: Convert A2UI surface operations into generative UI specs.
4
+ ---
5
+
6
+ import { A2uiOperation, A2uiOperationResult, A2uiState, A2uiSurfaceState, applyA2uiOperations, convertSurfaceToUISpec } from "@/generated/typeDocs";
7
+
8
+ {/* AUTO-GENERATED PAGE by scripts/generate-api-reference.mts */}
9
+ {/* Do not edit manually. */}
10
+
11
+ {/* api-reference:start */}
12
+ {/* AUTO-GENERATED by scripts/generate-api-reference.mts */}
13
+ {/* Do not edit this block manually. */}
14
+
15
+ ## API Reference
16
+
17
+ ### A2uiOperation
18
+
19
+ <ParametersTable {...A2uiOperation} />
20
+
21
+ ### A2uiOperationResult
22
+
23
+ <ParametersTable {...A2uiOperationResult} />
24
+
25
+ ### A2uiState
26
+
27
+ <ParametersTable {...A2uiState} />
28
+
29
+ ### A2uiSurfaceState
30
+
31
+ <ParametersTable {...A2uiSurfaceState} />
32
+
33
+ ### applyA2uiOperations
34
+
35
+ <ParametersTable {...applyA2uiOperations} />
36
+
37
+ ### convertSurfaceToUISpec
38
+
39
+ <ParametersTable {...convertSurfaceToUISpec} />
40
+ {/* api-reference:end */}
@@ -30,6 +30,9 @@ description: Spec-driven generative UI for assistant-ui. The data format an assi
30
30
  <Card title={"Microsoft Teams"} href={"/docs/api-reference/generative-ui/teams"}>
31
31
  {"Convert generative UI trees to Teams Adaptive Cards and decode Action.Submit payloads back into $action payloads."}
32
32
  </Card>
33
+ <Card title={"A2UI"} href={"/docs/api-reference/generative-ui/a2ui"}>
34
+ {"Convert A2UI surface operations into generative UI specs."}
35
+ </Card>
33
36
  <Card title={"Generative UI Tokens"} href={"/docs/api-reference/generative-ui/tokens"}>
34
37
  {"Shared token arrays used by the default generative UI vocabulary for sizing, color, alignment, and component variants."}
35
38
  </Card>