@assistant-ui/mcp-docs-server 0.1.26 → 0.1.27

package/.docs/raw/docs/runtimes/a2a/index.mdx

@@ -97,6 +97,7 @@ const runtime = useA2ARuntime({ client });
 | Option | Type | Description |
 | --- | --- | --- |
 | `baseUrl` | `string` | Base URL of the A2A server |
+| `basePath` | `string` | Optional path prefix for API endpoints (e.g. `"/v1"`). Does not affect agent card discovery |
 | `headers` | `Record<string, string>` or `() => Record<string, string>` | Static or dynamic headers (e.g. for auth tokens) |
 | `tenant` | `string` | Tenant ID for multi-tenant servers (prepended to URL paths) |
 | `extensions` | `string[]` | Extension URIs to negotiate via `A2A-Extensions` header |
@@ -124,7 +125,10 @@ const runtime = useA2ARuntime({ client });
 | --- | --- | --- |
 | `client` | `A2AClient` | Pre-built A2A client instance (provide this OR `baseUrl`) |
 | `baseUrl` | `string` | A2A server URL (creates a client automatically) |
+| `basePath` | `string` | Path prefix for API endpoints (e.g. `"/v1"`). Only used with `baseUrl` |
+| `tenant` | `string` | Tenant ID for multi-tenant servers. Only used with `baseUrl` |
 | `headers` | see above | Headers for the auto-created client |
+| `extensions` | `string[]` | Extension URIs to negotiate. Only used with `baseUrl` |
 | `contextId` | `string` | Initial context ID for the conversation |
 | `configuration` | `A2ASendMessageConfiguration` | Default send message configuration |
 | `onError` | `(error: Error) => void` | Error callback |

package/.docs/raw/docs/runtimes/ai-sdk/v6.mdx

@@ -111,9 +111,9 @@ Use `messageMetadata` in your Next.js route to attach `usage` from `finish` and
 import { streamText, convertToModelMessages } from "ai";
 import { frontendTools } from "@assistant-ui/react-ai-sdk";
 export async function POST(req: Request) {
-  const { messages, tools, modelName } = await req.json();
+  const { messages, tools, config } = await req.json();
   const result = streamText({
-    model: getModel(modelName),
+    model: getModel(config?.modelName),
     messages: await convertToModelMessages(messages),
     tools: frontendTools(tools),
   });

package/.docs/raw/docs/runtimes/assistant-transport.mdx

@@ -72,11 +72,15 @@ The backend endpoint receives POST requests with the following payload:
   tools?: Record<string, ToolJSONSchema>, // Tool definitions keyed by tool name
   threadId: string | null, // The current thread/conversation identifier (null for new threads)
   parentId?: string | null, // The parent message ID (included when editing or branching)
-  // ...callSettings (maxTokens, temperature, topP, presencePenalty, frequencyPenalty, seed)
-  // ...config (apiKey, baseUrl, modelName)
+  callSettings?: { maxTokens, temperature, topP, presencePenalty, frequencyPenalty, seed },
+  config?: { apiKey, baseUrl, modelName },
 }
 ```
 
+<Callout type="warn">
+  **Migrating from top-level fields:** `callSettings` and `config` fields were previously spread at the top level of the request body (e.g. `body.modelName` instead of `body.config.modelName`). Both formats are currently sent for backward compatibility, but the top-level fields are deprecated and will be removed in a future version. Update your backend to read from the nested objects.
+</Callout>
+
 The backend endpoint returns a stream of state snapshots using the `assistant-stream` library ([npm](https://www.npmjs.com/package/assistant-stream) / [PyPI](https://pypi.org/project/assistant-stream/)).
 
 ### Handling Commands

package/.docs/raw/docs/ui/context-display.mdx

@@ -33,9 +33,9 @@ Use `messageMetadata` in your Next.js route to attach `usage` from `finish` and
 import { streamText, convertToModelMessages } from "ai";
 
 export async function POST(req: Request) {
-  const { messages, modelName } = await req.json();
+  const { messages, config } = await req.json();
   const result = streamText({
-    model: getModel(modelName),
+    model: getModel(config?.modelName),
     messages: await convertToModelMessages(messages),
   });
   return result.toUIMessageStreamResponse({

package/.docs/raw/docs/ui/model-selector.mdx

@@ -50,7 +50,7 @@ const ComposerAction: FC = () => {
 
 ### Read the model in your API route
 
-The selected model name is sent as `config.modelName` in the request body:
+The selected model's `id` is sent as `config.modelName` in the request body:
 
 ```tsx title="app/api/chat/route.ts" {2,5}
 export async function POST(req: Request) {

package/.docs/raw/docs/ui/voice.mdx

@@ -0,0 +1,172 @@
+---
+title: Voice
+description: Realtime voice session controls with connect, mute, and status indicator.
+---
+
+import { VoiceSample, VoiceVariantsSample, VoiceStatesSample } from "@/components/docs/samples/voice";
+
+A control bar for realtime bidirectional voice sessions with an animated orb indicator. Works with any `RealtimeVoiceAdapter` (LiveKit, ElevenLabs, etc.).
+
+<VoiceSample />
+
+## Getting Started
+
+<Steps>
+  <Step>
+
+### Add the component
+
+<InstallCommand shadcn={["voice"]} />
+
+This adds `/components/assistant-ui/voice.tsx` to your project, which you can adjust as needed.
+
+  </Step>
+  <Step>
+
+### Configure a voice adapter
+
+Pass a `RealtimeVoiceAdapter` to your runtime. See the [Realtime Voice guide](/docs/guides/voice) for details.
+
+```tsx
+const runtime = useChatRuntime({
+  adapters: {
+    voice: myVoiceAdapter,
+  },
+});
+```
+
+  </Step>
+  <Step>
+
+### Use in your application
+
+```tsx title="app/page.tsx"
+import { Thread } from "@/components/assistant-ui/thread";
+import { VoiceControl } from "@/components/assistant-ui/voice";
+import { AuiIf } from "@assistant-ui/react";
+
+export default function Chat() {
+  return (
+    <div className="flex h-full flex-col">
+      <AuiIf condition={(s) => s.thread.capabilities.voice}>
+        <VoiceControl />
+      </AuiIf>
+      <div className="min-h-0 flex-1">
+        <Thread />
+      </div>
+    </div>
+  );
+}
+```
+
+  </Step>
+</Steps>
+
+## Anatomy
+
+The `VoiceControl` component is built with the following hooks and conditionals:
+
+```tsx
+import { AuiIf, useVoiceState, useVoiceControls } from "@assistant-ui/react";
+
+<div className="aui-voice-control">
+  <VoiceIndicator />
+
+  <AuiIf condition={(s) => s.thread.voice == null}>
+    <VoiceConnectButton />
+  </AuiIf>
+
+  <AuiIf condition={(s) => s.thread.voice?.status.type === "running"}>
+    <VoiceMuteButton />
+    <VoiceDisconnectButton />
+  </AuiIf>
+</div>
+```
+
+## Examples
+
+### Conditionally show voice controls
+
+Only render when a voice adapter is configured:
+
+```tsx
+<AuiIf condition={(s) => s.thread.capabilities.voice}>
+  <VoiceControl />
+</AuiIf>
+```
+
+### Voice toggle in composer
+
+Add a compact voice toggle button inside the composer action area:
+
+```tsx
+function ComposerVoiceToggle() {
+  const voiceState = useVoiceState();
+  const { connect, disconnect } = useVoiceControls();
+  const isActive =
+    voiceState?.status.type === "running" ||
+    voiceState?.status.type === "starting";
+
+  return (
+    <AuiIf condition={(s) => s.thread.capabilities.voice}>
+      <button
+        type="button"
+        onClick={() => (isActive ? disconnect() : connect())}
+        aria-label={isActive ? "End voice" : "Start voice"}
+      >
+        {isActive ? <PhoneOffIcon /> : <PhoneIcon />}
+      </button>
+    </AuiIf>
+  );
+}
+```
+
+### Custom indicator colors
+
+Override the indicator styles by targeting the `aui-voice-indicator` class:
+
+```css
+.aui-voice-indicator {
+  /* Override active color */
+  &.bg-green-500 {
+    background: theme("colors.blue.500");
+  }
+}
+```
+
+## States
+
+The `VoiceOrb` responds to five voice session states with distinct animations:
+
+<VoiceStatesSample />
+
+## Variants
+
+Four built-in color palettes. Size is controlled via `className`.
+
+<VoiceVariantsSample />
+
+## Sub-components
+
+| Component | Description |
+|-----------|-------------|
+| `VoiceOrb` | Animated orb visual with gradient, glow, and ripple effects. Accepts `state` and `variant` props. |
+| `VoiceControl` | Control bar with status dot, connect/disconnect, and mute/unmute buttons. |
+| `VoiceConnectButton` | Calls `connect()`. Shown when no session is active. |
+| `VoiceMuteButton` | Toggles `mute()`/`unmute()`. Shown when session is running. |
+| `VoiceDisconnectButton` | Calls `disconnect()`. Shown when session is active. |
+
+All sub-components are exported and can be used independently for custom layouts.
+
+## State Selectors
+
+Use these with `AuiIf` or `useAuiState` to build custom voice UI:
+
+| Selector | Type | Description |
+|----------|------|-------------|
+| `s.thread.capabilities.voice` | `boolean` | Whether a voice adapter is configured |
+| `s.thread.voice` | `VoiceSessionState \| undefined` | `undefined` when no session |
+| `s.thread.voice?.status.type` | `"starting" \| "running" \| "ended"` | Session phase |
+| `s.thread.voice?.isMuted` | `boolean` | Microphone muted state |
+| `s.thread.voice?.mode` | `"listening" \| "speaking"` | Who is currently active (user or agent) |
+| `useVoiceVolume()` | `number` | Real-time audio level (0–1), separate from main state to avoid 20Hz re-renders |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assistant-ui/mcp-docs-server",
-  "version": "0.1.26",
+  "version": "0.1.27",
   "description": "MCP server for assistant-ui documentation and examples",
   "keywords": [
     "mcp",
@@ -15,7 +15,6 @@
   "type": "module",
   "exports": {
     ".": {
-      "aui-source": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     }
@@ -33,14 +32,14 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.28.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "gray-matter": "^4.0.3",
     "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",
     "tsx": "^4.21.0",
-    "vitest": "^4.1.1",
+    "vitest": "^4.1.2",
     "@assistant-ui/x-buildutils": "0.0.3"
   },
   "publishConfig": {