@epicbagel/saas-kit 1.6.0 → 1.10.0

package/dist/primitives/chat.cjs

@@ -2,12 +2,15 @@
 "use client";
 
 
+var _chunkUW67GSZ4cjs = require('../chunk-UW67GSZ4.cjs');
+
+
 
 
 var _chunk2BTDBZYNcjs = require('../chunk-2BTDBZYN.cjs');
 
 
-var _chunkLKPM6DQPcjs = require('../chunk-LKPM6DQP.cjs');
+var _chunkHTCW6AEHcjs = require('../chunk-HTCW6AEH.cjs');
 
 
 
@@ -15,21 +18,21 @@ var _chunkM4V7OJNFcjs = require('../chunk-M4V7OJNF.cjs');
 
 
 
+var _chunkB765DSRGcjs = require('../chunk-B765DSRG.cjs');
 
 
 
 
-var _chunk5VMKDVB6cjs = require('../chunk-5VMKDVB6.cjs');
 
 
 
+var _chunk5VMKDVB6cjs = require('../chunk-5VMKDVB6.cjs');
 
 
-var _chunkNWDPH2Z7cjs = require('../chunk-NWDPH2Z7.cjs');
 
 
 
-var _chunkB765DSRGcjs = require('../chunk-B765DSRG.cjs');
+var _chunkNWDPH2Z7cjs = require('../chunk-NWDPH2Z7.cjs');
 
 
 
@@ -39,7 +42,7 @@ require('../chunk-2HV2KKOE.cjs');
 
 
 
-var _chunkZ3JJSNR5cjs = require('../chunk-Z3JJSNR5.cjs');
+var _chunkZLEM2SAUcjs = require('../chunk-ZLEM2SAU.cjs');
 
 
 var _chunkKENBU3NVcjs = require('../chunk-KENBU3NV.cjs');
@@ -50,6 +53,7 @@ require('../chunk-ELPV44S6.cjs');
 
 
 var _chunkZAITUDYDcjs = require('../chunk-ZAITUDYD.cjs');
+require('../chunk-U2NES7VR.cjs');
 
 
 
@@ -67,17 +71,22 @@ require('../chunk-W5HPHEE7.cjs');
 
 
 var _chunkFYRQFEU4cjs = require('../chunk-FYRQFEU4.cjs');
-require('../chunk-U2NES7VR.cjs');
 
 
 var _chunk2KFZQJH5cjs = require('../chunk-2KFZQJH5.cjs');
 require('../chunk-PQUSJEXL.cjs');
+require('../chunk-XB2D4NQK.cjs');
 
 
 var _chunkJDEXZGIYcjs = require('../chunk-JDEXZGIY.cjs');
 
 
+var _chunkKWLSBTB2cjs = require('../chunk-KWLSBTB2.cjs');
+require('../chunk-2BSFYU22.cjs');
+
+
 var _chunk4LXN6GLZcjs = require('../chunk-4LXN6GLZ.cjs');
+require('../chunk-O6F3LVZY.cjs');
 
 
 var _chunkR35FT53Gcjs = require('../chunk-R35FT53G.cjs');
@@ -85,9 +94,6 @@ var _chunkR35FT53Gcjs = require('../chunk-R35FT53G.cjs');
 
 var _chunkH2UFRLLNcjs = require('../chunk-H2UFRLLN.cjs');
 
-
-var _chunkKWLSBTB2cjs = require('../chunk-KWLSBTB2.cjs');
-
 // src/primitives/chat.tsx
 
 
@@ -372,6 +378,7 @@ function ChatInput({
   size = "md",
   uploadingLabel,
   voice = true,
+  voiceSession,
   voiceTitle,
   voiceLang,
   submitLabel,
@@ -397,6 +404,7 @@ function ChatInput({
   const isDisabled = pending || disabled;
   const attachmentsReady = attachments.length > 0 && attachments.every((item) => item.state !== "uploading");
   const canSubmit = !isDisabled && (Boolean(value.trim()) || attachmentsReady);
+  const liveVoiceActive = voiceSession && voiceSession.state !== "disconnected" && voiceSession.state !== "error";
   const submit = () => {
     const trimmed = value.trim();
     if (!trimmed && !attachmentsReady || isDisabled) return;
@@ -457,6 +465,7 @@ function ChatInput({
                 className
               ),
               children: [
+                liveVoiceActive && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk7LDJAXRXcjs.InputGroupAddon, { align: "block-start", className: "w-full border-b border-border", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkUW67GSZ4cjs.VoiceSessionControls, { ...voiceSession }) }),
                 attachments.length > 0 && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
                   ChatAttachmentList,
                   {
@@ -523,12 +532,21 @@ function ChatInput({
                           addFilesLabel
                         ] }) })
                       ] }),
+                      helperText ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+                        "span",
+                        {
+                          "data-slot": "chat-input-helper",
+                          className: _chunkKWLSBTB2cjs.cn.call(void 0, "min-w-0 flex-1 truncate px-1 text-center text-xs font-normal text-muted-foreground sm:px-2 sm:text-sm", compact && "hidden"),
+                          children: helperText
+                        }
+                      ) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: compact ? "hidden" : "flex-1" }),
                       voice && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-                        _chunkLKPM6DQPcjs.VoiceDictationButton,
+                        _chunkHTCW6AEHcjs.VoiceDictationButton,
                         {
                           size: "icon",
                           title: voiceTitle,
                           lang: voiceLang,
+                          disabled: Boolean(isDisabled || liveVoiceActive),
                           onCommit: (text) => onSend(text),
                           className: _chunkKWLSBTB2cjs.cn.call(void 0, 
                             spacious && "border-transparent bg-transparent shadow-none hover:bg-muted",
@@ -537,14 +555,7 @@ function ChatInput({
                           )
                         }
                       ),
-                      helperText ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-                        "span",
-                        {
-                          "data-slot": "chat-input-helper",
-                          className: _chunkKWLSBTB2cjs.cn.call(void 0, "min-w-0 flex-1 truncate px-1 text-center text-xs font-normal text-muted-foreground sm:px-2 sm:text-sm", compact && "hidden"),
-                          children: helperText
-                        }
-                      ) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: compact ? "hidden" : "flex-1" }),
+                      voiceSession && !liveVoiceActive && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkUW67GSZ4cjs.VoiceSessionControls, { ...voiceSession, disabled: voiceSession.disabled || isDisabled }),
                       submitLabel ? /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
                         _chunkJDEXZGIYcjs.Button,
                         {
@@ -593,6 +604,8 @@ function ChatInput({
 }
 function VoiceHero({
   onSubmit,
+  voice,
+  voiceSession,
   voiceTitle,
   voiceLang,
   onSwitchToText,
@@ -600,8 +613,20 @@ function VoiceHero({
   switchLabel
 }) {
   return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "flex flex-col items-center gap-5 py-6", children: [
-    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-      _chunkLKPM6DQPcjs.VoiceDictationButton,
+    voiceSession ? /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _jsxruntime.Fragment, { children: [
+      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkUW67GSZ4cjs.VoiceSessionControls, { ...voiceSession, size: "hero" }),
+      voice && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+        _chunkHTCW6AEHcjs.VoiceDictationButton,
+        {
+          size: "icon",
+          title: voiceTitle,
+          lang: voiceLang,
+          onCommit: onSubmit,
+          disabled: Boolean(voiceSession.disabled || voiceSession.state !== "disconnected" && voiceSession.state !== "error")
+        }
+      )
+    ] }) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+      _chunkHTCW6AEHcjs.VoiceDictationButton,
       {
         size: "lg",
         title: voiceTitle,
@@ -629,27 +654,40 @@ var EXAMPLE_PROMPT_LAYOUTS = {
   row: "row",
   cards: "grid"
 };
-function ExamplePrompts({
-  prompts,
+function ChatSuggestions({
+  slot,
+  items,
   onSelect,
-  label = "Try",
+  label,
+  showLabel = true,
   variant = "chips",
+  disabled = false,
   className
 }) {
   const labelId = _react.useId.call(void 0, );
-  if (prompts.length === 0) return null;
+  if (items.length === 0) return null;
   const cards = variant === "cards";
-  return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { "data-slot": "chat-examples", "data-variant": variant, className: _chunkKWLSBTB2cjs.cn.call(void 0, cards ? "mt-4" : "mt-3", className), children: [
-    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "p", { id: labelId, "data-slot": "chat-examples-label", className: "mb-2 text-left text-xs text-muted-foreground", children: label }),
-    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkM4V7OJNFcjs.Suggestions, { role: "group", "aria-labelledby": labelId, layout: EXAMPLE_PROMPT_LAYOUTS[variant], children: prompts.map((prompt) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-      _chunkM4V7OJNFcjs.Suggestion,
+  return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { "data-slot": slot, "data-variant": variant, className, children: [
+    showLabel && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "p", { id: labelId, "data-slot": `${slot}-label`, className: "mb-2 text-left text-xs text-muted-foreground", children: label }),
+    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+      _chunkM4V7OJNFcjs.Suggestions,
       {
-        suggestion: prompt,
-        onClick: onSelect,
-        className: cards ? "h-auto min-h-12 px-3 py-2.5 text-xs" : void 0
-      },
-      prompt
-    )) })
+        role: "group",
+        "aria-labelledby": showLabel ? labelId : void 0,
+        "aria-label": showLabel ? void 0 : label,
+        layout: EXAMPLE_PROMPT_LAYOUTS[variant],
+        children: items.map((item) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+          _chunkM4V7OJNFcjs.Suggestion,
+          {
+            suggestion: item,
+            onClick: onSelect,
+            disabled,
+            className: cards ? "h-auto min-h-12 px-3 py-2.5 text-xs" : void 0
+          },
+          item
+        ))
+      }
+    )
   ] });
 }
 function ExamplePromptsLoading({ label, className }) {
@@ -693,6 +731,8 @@ var Chat = _react.forwardRef.call(void 0, function Chat2({
   examplePromptsVariant = "chips",
   examplePromptsLoading = false,
   examplePromptsLoadingLabel = "Loading suggestions\u2026",
+  replySuggestions = [],
+  replySuggestionsLabel = "Suggested replies",
   compactEmptyState = false,
   defaultMode,
   placeholder = "Type your message\u2026",
@@ -715,6 +755,7 @@ var Chat = _react.forwardRef.call(void 0, function Chat2({
   fileDropLabel,
   fileDropDescription,
   voice = true,
+  voiceSession,
   voiceTitle,
   activeVoiceTitle,
   voiceLang,
@@ -738,7 +779,15 @@ var Chat = _react.forwardRef.call(void 0, function Chat2({
   const inputRef = _react.useRef.call(void 0, null);
   const conversationStarted = messages.length > 0;
   const [userMode, setUserMode] = _react.useState.call(void 0, null);
-  const mode = _nullishCoalesce(_nullishCoalesce(userMode, () => ( defaultMode)), () => ( (isMobile ? "voice" : "text")));
+  const mode = !voice && !voiceSession ? "text" : _nullishCoalesce(_nullishCoalesce(userMode, () => ( defaultMode)), () => ( (isMobile ? "voice" : "text")));
+  const reportSendError = _react.useCallback.call(void 0, 
+    (cause) => {
+      if (onSendError) onSendError(cause);
+      else if (typeof globalThis.reportError === "function") globalThis.reportError(cause);
+      else console.error(cause);
+    },
+    [onSendError]
+  );
   const send = _react.useCallback.call(void 0, 
     async (text, sentAttachments = attachments) => {
       const trimmed = text.trim();
@@ -751,18 +800,29 @@ var Chat = _react.forwardRef.call(void 0, function Chat2({
           setInput((current) => current ? current : trimmed);
           if (mode === "voice") setUserMode("text");
         }
-        if (onSendError) onSendError(cause);
-        else if (typeof globalThis.reportError === "function") globalThis.reportError(cause);
-        else console.error(cause);
+        reportSendError(cause);
       }
       window.setTimeout(() => _optionalChain([inputRef, 'access', _9 => _9.current, 'optionalAccess', _10 => _10.focus, 'call', _11 => _11()]), 0);
     },
-    [attachments, mode, onSend, onSendError, pending]
+    [attachments, mode, onSend, pending, reportSendError]
+  );
+  const sendSuggestion = _react.useCallback.call(void 0, 
+    async (text) => {
+      const trimmed = text.trim();
+      if (!trimmed || pending) return;
+      try {
+        await onSend(trimmed, []);
+      } catch (cause) {
+        reportSendError(cause);
+      }
+      window.setTimeout(() => _optionalChain([inputRef, 'access', _12 => _12.current, 'optionalAccess', _13 => _13.focus, 'call', _14 => _14()]), 0);
+    },
+    [onSend, pending, reportSendError]
   );
   _react.useImperativeHandle.call(void 0, 
     ref,
     () => ({
-      focusInput: () => _optionalChain([inputRef, 'access', _12 => _12.current, 'optionalAccess', _13 => _13.focus, 'call', _14 => _14()]),
+      focusInput: () => _optionalChain([inputRef, 'access', _15 => _15.current, 'optionalAccess', _16 => _16.focus, 'call', _17 => _17()]),
       clearInput: () => setInput("")
     }),
     []
@@ -770,16 +830,17 @@ var Chat = _react.forwardRef.call(void 0, function Chat2({
   const dropFiles = _react.useCallback.call(void 0, 
     (files) => {
       if (!conversationStarted && mode === "voice") setUserMode("text");
-      return _optionalChain([onFilesSelected, 'optionalCall', _15 => _15(files)]);
+      return _optionalChain([onFilesSelected, 'optionalCall', _18 => _18(files)]);
     },
     [conversationStarted, mode, onFilesSelected]
   );
   const application = layout === "application";
   const workspace = layout === "workspace";
   const showEmptyFileDropzone = emptyFileDropzone && Boolean(onFilesSelected) && attachments.length === 0;
-  const showEmptyPending = !conversationStarted && pending && Boolean(emptyPendingContent);
+  const liveVoiceActive = voiceSession && voiceSession.state !== "disconnected" && voiceSession.state !== "error";
+  const showEmptyPending = !conversationStarted && pending && Boolean(emptyPendingContent) && !liveVoiceActive;
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-    _chunkZ3JJSNR5cjs.FileDropArea,
+    _chunkZLEM2SAUcjs.FileDropArea,
     {
       "data-slot": "chat",
       "data-layout": layout,
@@ -847,7 +908,7 @@ var Chat = _react.forwardRef.call(void 0, function Chat2({
                 ),
                 children: [
                   showEmptyFileDropzone && onFilesSelected && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-                    _chunkZ3JJSNR5cjs.FileDropzone,
+                    _chunkZLEM2SAUcjs.FileDropzone,
                     {
                       multiple: true,
                       onFiles: onFilesSelected,
@@ -862,6 +923,8 @@ var Chat = _react.forwardRef.call(void 0, function Chat2({
                     VoiceHero,
                     {
                       onSubmit: (text) => void send(text),
+                      voice,
+                      voiceSession: voiceSession ? { ...voiceSession, disabled: voiceSession.disabled || pending } : void 0,
                       voiceTitle,
                       voiceLang,
                       label: voiceHeroLabel,
@@ -878,6 +941,7 @@ var Chat = _react.forwardRef.call(void 0, function Chat2({
                       placeholder,
                       size: showEmptyFileDropzone || application && isMobile ? "md" : "lg",
                       voice,
+                      voiceSession,
                       voiceTitle,
                       voiceLang,
                       submitLabel,
@@ -898,12 +962,14 @@ var Chat = _react.forwardRef.call(void 0, function Chat2({
                   error && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, ChatError, { children: error }),
                   !pending && examplePromptsLoading && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, ExamplePromptsLoading, { label: examplePromptsLoadingLabel }),
                   !pending && !examplePromptsLoading && examplePrompts.length > 0 && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-                    ExamplePrompts,
+                    ChatSuggestions,
                     {
-                      prompts: examplePrompts,
-                      onSelect: (p) => void send(p),
+                      slot: "chat-examples",
+                      items: examplePrompts,
+                      onSelect: (prompt) => void sendSuggestion(prompt),
                       label: examplePromptsLabel,
-                      variant: examplePromptsVariant
+                      variant: examplePromptsVariant,
+                      className: examplePromptsVariant === "cards" ? "mt-4" : "mt-3"
                     }
                   ),
                   emptyFooter && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { "data-slot": "chat-empty-footer", className: "mt-5", children: emptyFooter })
@@ -946,6 +1012,18 @@ var Chat = _react.forwardRef.call(void 0, function Chat2({
               workspace && mobileCompactComposer && "max-md:pb-[max(0.75rem,env(safe-area-inset-bottom))] max-md:pt-3"
             ),
             children: [
+              /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+                ChatSuggestions,
+                {
+                  slot: "chat-replies",
+                  items: replySuggestions,
+                  onSelect: (reply) => void sendSuggestion(reply),
+                  label: replySuggestionsLabel,
+                  showLabel: false,
+                  disabled: pending,
+                  className: _chunkKWLSBTB2cjs.cn.call(void 0, "mb-3", workspace && "mx-auto max-w-3xl")
+                }
+              ),
               /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
                 ChatInput,
                 {
@@ -956,6 +1034,7 @@ var Chat = _react.forwardRef.call(void 0, function Chat2({
                   placeholder: activePlaceholder,
                   size: composerAppearance === "spacious" ? "lg" : "sm",
                   voice,
+                  voiceSession,
                   voiceTitle: _nullishCoalesce(activeVoiceTitle, () => ( voiceTitle)),
                   voiceLang,
                   inputRef,

package/dist/primitives/chat.d.cts

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React$1 from 'react';
 import { ReactNode } from 'react';
+import { VoiceSessionControlsProps } from './voice-session-controls.cjs';
 import { MarkdownComponents } from './markdown.cjs';
 import 'react-markdown';
 import './rich-text.cjs';
@@ -153,6 +154,8 @@ interface ChatInputProps {
     uploadingLabel?: string;
     /** Show the inline voice dictation button. Defaults to true. */
     voice?: boolean;
+    /** A separate live voice control alongside dictation. The host owns its transport and lifecycle. */
+    voiceSession?: VoiceSessionControlsProps;
     /** Title shown inside the voice overlay. */
     voiceTitle?: string;
     /** Language tag for voice dictation. */
@@ -210,7 +213,7 @@ interface ChatInputProps {
  * `<Chat>` instead of composing `<ChatInput>` directly if you want
  * device-aware default modes.
  */
-declare function ChatInput({ value, onChange, onSend, pending, disabled, placeholder, size, uploadingLabel, voice, voiceTitle, voiceLang, submitLabel, autoFocus, className, inputRef, attachments, onFilesSelected, onRemoveAttachment, accept, multiple, addFilesLabel, appearance, compactOnBlur, helperText, privacyNote, }: ChatInputProps): react_jsx_runtime.JSX.Element;
+declare function ChatInput({ value, onChange, onSend, pending, disabled, placeholder, size, uploadingLabel, voice, voiceSession, voiceTitle, voiceLang, submitLabel, autoFocus, className, inputRef, attachments, onFilesSelected, onRemoveAttachment, accept, multiple, addFilesLabel, appearance, compactOnBlur, helperText, privacyNote, }: ChatInputProps): react_jsx_runtime.JSX.Element;
 interface ChatProps {
     /** Conversation messages. */
     messages: ChatMessage[];
@@ -249,7 +252,10 @@ interface ChatProps {
     emptyTitle?: ReactNode;
     /** Subheadline shown under the headline. */
     emptySubtitle?: ReactNode;
-    /** Optional list of suggested starter prompts. Click → sends. */
+    /**
+     * Optional list of suggested starter prompts, under the empty-state
+     * composer. Picking one sends it as `replySuggestions` do.
+     */
     examplePrompts?: ReadonlyArray<string>;
     /** Label above the example prompts. Defaults to "Try". */
     examplePromptsLabel?: string;
@@ -303,6 +309,19 @@ interface ChatProps {
     addFilesLabel?: string;
     /** Shown on a file, staged or on a message, while it is still uploading. Defaults to "Uploading…". */
     uploadingLabel?: string;
+    /**
+     * Replies the conversation offers next, such as the choices the latest
+     * assistant turn asked for. Once the conversation has started they show
+     * at the composer, directly above the input and at its width, as the same
+     * suggestion chips as `examplePrompts`, wrapping onto as many lines as
+     * they need. Picking one sends only its words: the draft and any staged
+     * files stay in the composer, and a failed send is reported
+     * (`onSendError`) without touching them. Disabled while `pending`. Pass
+     * none (the default) to show none; drop them once they no longer apply.
+     */
+    replySuggestions?: ReadonlyArray<string>;
+    /** The reply suggestions' accessible name. Defaults to "Suggested replies". */
+    replySuggestionsLabel?: string;
     /** Visual treatment for both empty and active text composers. */
     composerAppearance?: ChatInputProps["appearance"];
     /**
@@ -338,6 +357,8 @@ interface ChatProps {
     fileDropDescription?: ReactNode;
     /** Enable voice dictation. Defaults to true. */
     voice?: boolean;
+    /** Controlled live voice UI, used instead of browser dictation when provided. */
+    voiceSession?: VoiceSessionControlsProps;
     /** Title shown inside the voice overlay. */
     voiceTitle?: string;
     /** Title shown inside the voice overlay in the active state. */
@@ -406,7 +427,8 @@ interface ChatHandle {
  *   - Optional example prompts render as suggestions below the input.
  *
  * **Active state** (messages exist) — always the compact text input;
- * the mic stays as an accessory icon.
+ * the mic stays as an accessory icon. Optional reply suggestions render as
+ * the same suggestions, directly above the input.
  *
  * **Files** — with `onFilesSelected`, the composer's menu picks files and a
  * file dragged anywhere on the conversation can be dropped (`fileDrop`);

package/dist/primitives/chat.d.ts

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React$1 from 'react';
 import { ReactNode } from 'react';
+import { VoiceSessionControlsProps } from './voice-session-controls.js';
 import { MarkdownComponents } from './markdown.js';
 import 'react-markdown';
 import './rich-text.js';
@@ -153,6 +154,8 @@ interface ChatInputProps {
     uploadingLabel?: string;
     /** Show the inline voice dictation button. Defaults to true. */
     voice?: boolean;
+    /** A separate live voice control alongside dictation. The host owns its transport and lifecycle. */
+    voiceSession?: VoiceSessionControlsProps;
     /** Title shown inside the voice overlay. */
     voiceTitle?: string;
     /** Language tag for voice dictation. */
@@ -210,7 +213,7 @@ interface ChatInputProps {
  * `<Chat>` instead of composing `<ChatInput>` directly if you want
  * device-aware default modes.
  */
-declare function ChatInput({ value, onChange, onSend, pending, disabled, placeholder, size, uploadingLabel, voice, voiceTitle, voiceLang, submitLabel, autoFocus, className, inputRef, attachments, onFilesSelected, onRemoveAttachment, accept, multiple, addFilesLabel, appearance, compactOnBlur, helperText, privacyNote, }: ChatInputProps): react_jsx_runtime.JSX.Element;
+declare function ChatInput({ value, onChange, onSend, pending, disabled, placeholder, size, uploadingLabel, voice, voiceSession, voiceTitle, voiceLang, submitLabel, autoFocus, className, inputRef, attachments, onFilesSelected, onRemoveAttachment, accept, multiple, addFilesLabel, appearance, compactOnBlur, helperText, privacyNote, }: ChatInputProps): react_jsx_runtime.JSX.Element;
 interface ChatProps {
     /** Conversation messages. */
     messages: ChatMessage[];
@@ -249,7 +252,10 @@ interface ChatProps {
     emptyTitle?: ReactNode;
     /** Subheadline shown under the headline. */
     emptySubtitle?: ReactNode;
-    /** Optional list of suggested starter prompts. Click → sends. */
+    /**
+     * Optional list of suggested starter prompts, under the empty-state
+     * composer. Picking one sends it as `replySuggestions` do.
+     */
     examplePrompts?: ReadonlyArray<string>;
     /** Label above the example prompts. Defaults to "Try". */
     examplePromptsLabel?: string;
@@ -303,6 +309,19 @@ interface ChatProps {
     addFilesLabel?: string;
     /** Shown on a file, staged or on a message, while it is still uploading. Defaults to "Uploading…". */
     uploadingLabel?: string;
+    /**
+     * Replies the conversation offers next, such as the choices the latest
+     * assistant turn asked for. Once the conversation has started they show
+     * at the composer, directly above the input and at its width, as the same
+     * suggestion chips as `examplePrompts`, wrapping onto as many lines as
+     * they need. Picking one sends only its words: the draft and any staged
+     * files stay in the composer, and a failed send is reported
+     * (`onSendError`) without touching them. Disabled while `pending`. Pass
+     * none (the default) to show none; drop them once they no longer apply.
+     */
+    replySuggestions?: ReadonlyArray<string>;
+    /** The reply suggestions' accessible name. Defaults to "Suggested replies". */
+    replySuggestionsLabel?: string;
     /** Visual treatment for both empty and active text composers. */
     composerAppearance?: ChatInputProps["appearance"];
     /**
@@ -338,6 +357,8 @@ interface ChatProps {
     fileDropDescription?: ReactNode;
     /** Enable voice dictation. Defaults to true. */
     voice?: boolean;
+    /** Controlled live voice UI, used instead of browser dictation when provided. */
+    voiceSession?: VoiceSessionControlsProps;
     /** Title shown inside the voice overlay. */
     voiceTitle?: string;
     /** Title shown inside the voice overlay in the active state. */
@@ -406,7 +427,8 @@ interface ChatHandle {
  *   - Optional example prompts render as suggestions below the input.
  *
  * **Active state** (messages exist) — always the compact text input;
- * the mic stays as an accessory icon.
+ * the mic stays as an accessory icon. Optional reply suggestions render as
+ * the same suggestions, directly above the input.
  *
  * **Files** — with `onFilesSelected`, the composer's menu picks files and a
  * file dragged anywhere on the conversation can be dropped (`fileDrop`);