@admin-layout/tailwind-ui 12.2.4-alpha.6 → 12.2.4-alpha.61

package/lib/components/AIToolbar/components/speech/index.js

@@ -0,0 +1,300 @@
+import {jsxs,jsx,Fragment}from'react/jsx-runtime';import {useState,useEffect,useCallback}from'react';import'../../../../shardui/accordion.js';import'../../../../shardui/alert.js';import'../../../../shardui/alert-dialog.js';import'@radix-ui/react-aspect-ratio';import'../../../../shardui/avatar.js';import'../../../../shardui/badge.js';import'../../../../shardui/breadcrumb.js';import {Button}from'../../../../shardui/button.js';import'../../../../shardui/calendar.js';import'../../../../shardui/card.js';import'../../../../shardui/carousel.js';import'../../../../shardui/chart.js';import'../../../../shardui/checkbox.js';import'@radix-ui/react-collapsible';import'../../../../shardui/command.js';import'../../../../shardui/context-menu.js';import'../../../../shardui/dialog.js';import'../../../../shardui/drawer.js';import'../../../../shardui/dropdown-menu.js';import'../../../../shardui/form.js';import'../../../../shardui/hover-card.js';import'../../../../shardui/input.js';import'../../../../shardui/input-otp.js';import'../../../../shardui/label.js';import'../../../../shardui/menubar.js';import'../../../../shardui/navigation-menu.js';import'../../../../shardui/pagination.js';import {Popover,PopoverTrigger,PopoverContent}from'../../../../shardui/popover.js';import'../../../../shardui/progress.js';import'../../../../shardui/radio-group.js';import {LoaderIcon,CameraIcon,PlusIcon,XIcon,AlertCircleIcon,AudioLinesIcon,HeadphonesIcon}from'lucide-react';import'react-resizable-panels';import'../../../../utils/isBrowser/index.js';import {cn}from'../../../../utils/util.js';import'fast-deep-equal/react.js';import {ScrollArea}from'../../../../shardui/scroll-area.js';import'../../../../shardui/select.js';import'../../../../shardui/separator.js';import'../../../../shardui/sheet.js';import'../../../../shardui/sidebar.js';import'../../../../shardui/slider.js';import'../../../ThemeProvider/ThemeProvider.js';import'sonner';import'../../../../shardui/switch.js';import'../../../../shardui/table.js';import'../../../../shardui/tabs.js';import'../../../../shardui/textarea.js';import'../../../../shardui/toast.js';import'../../../../shardui/toggle.js';import'../../../../shardui/toggle-group.js';import'../../../../shardui/tooltip.js';import {ModeSwitcher}from'./ModeSwitcher.js';import {RecordingPanel}from'./RecordingPanel.js';import {ResultsSection}from'./ResultsSection.js';import {SettingsPanel}from'./SettingsPanel.js';import {PermissionFlow}from'./PermissionFlow.js';import {QuickActions}from'./QuickActions.js';import {Warning}from'./Warning.js';const SystemAudio = props => {
+  const {
+    hasActiveLicense = true,
+    supportsImages = true,
+    checkSystemAudioAccess,
+    requestSystemAudioAccess,
+    captureSystemScreenshot,
+    capturing,
+    isProcessing,
+    isAIProcessing,
+    lastTranscription,
+    lastAIResponse,
+    error,
+    setupRequired,
+    startCapture,
+    stopCapture,
+    isPopoverOpen,
+    setIsPopoverOpen,
+    useSystemPrompt,
+    setUseSystemPrompt,
+    contextContent,
+    setContextContent,
+    startNewConversation,
+    conversation,
+    resizeWindow,
+    quickActions,
+    addQuickAction,
+    removeQuickAction,
+    isManagingQuickActions,
+    setIsManagingQuickActions,
+    showQuickActions,
+    setShowQuickActions,
+    handleQuickActionClick,
+    vadConfig,
+    updateVadConfiguration,
+    isRecordingInContinuousMode,
+    recordingProgress,
+    manualStopAndSend,
+    startContinuousRecording,
+    ignoreContinuousRecording,
+    scrollAreaRef,
+    settingsDropdownContent,
+    voicePopoverFooter,
+    toolbarShowElementTitles
+  } = props;
+  const showNativeTitles = toolbarShowElementTitles !== false;
+  // View mode toggle
+  const [conversationMode, setConversationMode] = useState(false);
+  // Screenshot state
+  const [screenshotImage, setScreenshotImage] = useState(null);
+  const [isCapturingScreenshot, setIsCapturingScreenshot] = useState(false);
+  const isVadMode = vadConfig.enabled;
+  const hasResponse = lastAIResponse || isAIProcessing;
+  // Keyboard shortcut for Cmd+K to toggle view mode
+  useEffect(() => {
+    const handleKeyDown = e => {
+      if (!isPopoverOpen) return;
+      // Cmd+K or Ctrl+K to toggle view mode
+      if ((e.metaKey || e.ctrlKey) && e.key === 'k') {
+        e.preventDefault();
+        setConversationMode(prev => !prev);
+      }
+    };
+    window.addEventListener('keydown', handleKeyDown);
+    return () => window.removeEventListener('keydown', handleKeyDown);
+  }, [isPopoverOpen]);
+  // Reset screenshot when processing starts (message is being sent)
+  useEffect(() => {
+    if (isProcessing && screenshotImage) {
+      setScreenshotImage(null);
+    }
+  }, [isProcessing, screenshotImage]);
+  const handleToggleCapture = async () => {
+    if (capturing) {
+      await stopCapture();
+    } else {
+      await startCapture();
+    }
+  };
+  const handleModeChange = vadEnabled => {
+    updateVadConfiguration({
+      ...vadConfig,
+      enabled: vadEnabled
+    });
+  };
+  // Capture screenshot functionality
+  const handleCaptureScreenshot = useCallback(async () => {
+    if (!captureSystemScreenshot || isCapturingScreenshot) return;
+    setIsCapturingScreenshot(true);
+    try {
+      const base64 = await captureSystemScreenshot();
+      if (base64) {
+        setScreenshotImage(base64);
+      }
+    } catch (err) {
+      console.error('Failed to capture screenshot:', err);
+    } finally {
+      setIsCapturingScreenshot(false);
+    }
+  }, [captureSystemScreenshot, isCapturingScreenshot]);
+  const handleRemoveScreenshot = useCallback(() => {
+    setScreenshotImage(null);
+  }, []);
+  const getButtonIcon = () => {
+    if (setupRequired) return jsx(AlertCircleIcon, {
+      className: "text-orange-500"
+    });
+    if (error && !setupRequired) return jsx(AlertCircleIcon, {
+      className: "text-red-500"
+    });
+    if (isProcessing) return jsx(LoaderIcon, {
+      className: "animate-spin"
+    });
+    if (capturing) return jsx(AudioLinesIcon, {
+      className: "text-green-500 animate-pulse"
+    });
+    return jsx(HeadphonesIcon, {});
+  };
+  const getButtonTitle = () => {
+    if (setupRequired) return 'Setup required - Click for instructions';
+    if (error && !setupRequired) return `Error: ${error}`;
+    if (isProcessing) return 'Transcribing audio...';
+    if (capturing) return 'Stop system audio capture';
+    return 'Start system audio capture';
+  };
+  return jsxs(Popover, {
+    open: isPopoverOpen,
+    onOpenChange: open => {
+      if (capturing && !open) {
+        return;
+      }
+      setIsPopoverOpen(open);
+    },
+    children: [jsx(PopoverTrigger, {
+      asChild: true,
+      children: jsx(Button, {
+        size: "icon",
+        title: showNativeTitles ? getButtonTitle() : undefined,
+        onClick: handleToggleCapture,
+        className: cn(capturing && 'bg-green-50 hover:bg-green-100', error && 'bg-red-100 hover:bg-red-200'),
+        children: getButtonIcon()
+      })
+    }), (capturing || setupRequired || error) && jsx(PopoverContent, {
+      align: "end",
+      side: "bottom",
+      className: "z-[200] select-none w-screen max-h-[min(92vh,calc(100vh-1rem))] p-0 border shadow-lg overflow-hidden border-input/50",
+      sideOffset: 8,
+      children: jsxs("div", {
+        className: "flex flex-col h-[calc(100vh-4rem)] overflow-hidden",
+        children: [jsx("div", {
+          className: "flex-shrink-0 p-3 border-b border-border/50",
+          children: jsxs("div", {
+            className: "flex items-center justify-between gap-2",
+            children: [!setupRequired && jsx(ModeSwitcher, {
+              isVadMode: isVadMode,
+              onModeChange: handleModeChange,
+              disabled: isRecordingInContinuousMode || isProcessing || isAIProcessing
+            }), setupRequired && jsx("h2", {
+              className: "font-semibold text-sm",
+              children: "Setup Required"
+            }), jsxs("div", {
+              className: "flex items-center gap-1.5 flex-shrink-0",
+              children: [hasActiveLicense && !setupRequired && supportsImages && captureSystemScreenshot && jsxs(Button, {
+                size: "sm",
+                variant: screenshotImage ? 'default' : 'outline',
+                onClick: handleCaptureScreenshot,
+                disabled: isCapturingScreenshot,
+                className: cn('h-6 text-[10px] gap-1 px-2', screenshotImage && 'bg-primary text-primary-foreground'),
+                title: showNativeTitles ? 'Capture screenshot to include with transcription' : undefined,
+                children: [isCapturingScreenshot ? jsx(LoaderIcon, {
+                  className: "w-3 h-3 animate-spin"
+                }) : jsx(CameraIcon, {
+                  className: "w-3 h-3"
+                }), "Screenshot"]
+              }), !setupRequired && jsxs(Button, {
+                size: "sm",
+                variant: "ghost",
+                onClick: startNewConversation,
+                className: "h-6 text-[10px] gap-1 px-2",
+                title: showNativeTitles ? 'Start a new conversation' : undefined,
+                children: [jsx(PlusIcon, {
+                  className: "w-3 h-3"
+                }), "New"]
+              }), !capturing && jsx(Button, {
+                size: "icon",
+                variant: "ghost",
+                className: "h-6 w-6",
+                title: showNativeTitles ? 'Close' : undefined,
+                onClick: () => {
+                  setIsPopoverOpen(false);
+                  resizeWindow(false);
+                },
+                children: jsx(XIcon, {
+                  className: "h-3.5 w-3.5"
+                })
+              })]
+            })]
+          })
+        }), jsx(ScrollArea, {
+          className: "flex-1 min-h-0",
+          ref: scrollAreaRef,
+          children: jsxs("div", {
+            className: "p-2 space-y-2",
+            children: [screenshotImage && jsxs("div", {
+              className: "flex items-center gap-2 p-2 rounded-lg bg-primary/5 border border-primary/20",
+              children: [jsx("img", {
+                src: `data:image/png;base64,${screenshotImage}`,
+                alt: "Screenshot",
+                className: "h-12 w-20 object-cover rounded"
+              }), jsxs("div", {
+                className: "flex-1 min-w-0",
+                children: [jsx("p", {
+                  className: "text-[10px] font-medium",
+                  children: "Screenshot attached"
+                }), jsx("p", {
+                  className: "text-[9px] text-muted-foreground",
+                  children: "Will be sent with next transcription"
+                })]
+              }), jsx(Button, {
+                size: "icon",
+                variant: "ghost",
+                className: "h-5 w-5",
+                onClick: handleRemoveScreenshot,
+                children: jsx(XIcon, {
+                  className: "h-3 w-3"
+                })
+              })]
+            }), error && !setupRequired && jsxs("div", {
+              className: "flex items-start gap-2 p-2.5 rounded-lg bg-red-50 border border-red-200",
+              children: [jsx(AlertCircleIcon, {
+                className: "w-3.5 h-3.5 text-red-500 flex-shrink-0 mt-0.5"
+              }), jsxs("div", {
+                children: [jsx("p", {
+                  className: "text-[10px] font-medium text-red-800",
+                  children: "Error"
+                }), jsx("p", {
+                  className: "text-[10px] text-red-700",
+                  children: error
+                })]
+              })]
+            }), setupRequired ? jsx(PermissionFlow, {
+              checkAccess: checkSystemAudioAccess,
+              requestAccess: requestSystemAudioAccess,
+              onPermissionGranted: () => {
+                void startCapture();
+              },
+              onPermissionDenied: () => {
+                // Keep showing setup instructions
+              }
+            }) : jsxs(Fragment, {
+              children: [jsx(RecordingPanel, {
+                isVadMode: isVadMode,
+                isRecording: isRecordingInContinuousMode,
+                isProcessing: isProcessing,
+                isAIProcessing: isAIProcessing,
+                recordingProgress: recordingProgress,
+                maxDuration: vadConfig.max_recording_duration_secs,
+                onStartRecording: startContinuousRecording,
+                onStopAndSend: manualStopAndSend,
+                onIgnore: ignoreContinuousRecording
+              }), jsx(ResultsSection, {
+                lastTranscription: lastTranscription,
+                lastAIResponse: lastAIResponse,
+                isAIProcessing: isAIProcessing,
+                conversation: conversation,
+                conversationMode: conversationMode,
+                setConversationMode: setConversationMode
+              }), jsx(SettingsPanel, {
+                vadConfig: vadConfig,
+                onUpdateVadConfig: updateVadConfiguration,
+                useSystemPrompt: useSystemPrompt,
+                setUseSystemPrompt: setUseSystemPrompt,
+                contextContent: contextContent,
+                setContextContent: setContextContent,
+                settingsDropdownContent: settingsDropdownContent
+              }), jsx(Warning, {
+                isVadMode: isVadMode
+              })]
+            })]
+          })
+        }), voicePopoverFooter ? jsx("div", {
+          className: "flex-shrink-0 border-t border-border/55 bg-muted/25 px-3 py-2.5 backdrop-blur supports-[backdrop-filter]:bg-muted/20",
+          children: voicePopoverFooter
+        }) : null, !setupRequired && hasResponse && jsx("div", {
+          className: "flex-shrink-0 border-t border-border/50 p-2",
+          children: jsx(QuickActions, {
+            actions: quickActions,
+            onActionClick: handleQuickActionClick,
+            onAddAction: addQuickAction,
+            onRemoveAction: removeQuickAction,
+            isManaging: isManagingQuickActions,
+            setIsManaging: setIsManagingQuickActions,
+            show: showQuickActions,
+            setShow: setShowQuickActions
+          })
+        })]
+      })
+    })]
+  });
+};export{SystemAudio};//# sourceMappingURL=index.js.map

package/lib/components/AIToolbar/components/speech/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/lib/components/AIToolbar/components/speech/promptTemplates.d.ts

@@ -0,0 +1,12 @@
+export interface PromptTemplate {
+    id: string;
+    name: string;
+    prompt: string;
+}
+export declare const PROMPT_TEMPLATES: PromptTemplate[];
+export declare const getPromptTemplateById: (id: string) => PromptTemplate | undefined;
+export declare const getPromptTemplateNames: () => {
+    id: string;
+    name: string;
+}[];
+//# sourceMappingURL=promptTemplates.d.ts.map

package/lib/components/AIToolbar/components/speech/promptTemplates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptTemplates.d.ts","sourceRoot":"","sources":["../../../../../src/components/AIToolbar/components/speech/promptTemplates.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAuH5C,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,IAAI,MAAM,KAAG,cAAc,GAAG,SAEnE,CAAC;AAEF,eAAO,MAAM,sBAAsB,QAAO;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAKrE,CAAC"}

package/lib/components/AIToolbar/components/speech/promptTemplates.js

@@ -0,0 +1,114 @@
+const PROMPT_TEMPLATES = [{
+  id: 'real_time_translator',
+  name: 'Real-time Translator',
+  prompt: `You are a real-time translation assistant. Listen to system audio and provide instant, accurate translations. Be concise and quick.
+
+[ADD YOUR TRANSLATION SETTINGS HERE]
+- From language: 
+- To language: 
+- Context/Domain: (business, casual, technical, etc.)
+
+Provide immediate translations of what you hear. Keep responses short and clear for quick reading.`
+}, {
+  id: 'meeting_assistant',
+  name: 'Meeting Assistant',
+  prompt: `You are a transparent meeting assistant. Listen to conversations and provide real-time insights, summaries, and action items.
+
+[ADD YOUR MEETING CONTEXT HERE]
+- Meeting type: 
+- Your role: 
+- Key topics to focus on: 
+- What you need help with: 
+
+Provide quick insights, key points, and actionable information as the meeting progresses.`
+}, {
+  id: 'interview_assistant',
+  name: 'Interview Assistant',
+  prompt: `You are a real-time interview assistant. Help answer questions by providing quick, relevant talking points based on the candidate's background.
+
+[ADD YOUR RESUME HERE]
+- Your experience: 
+- Key skills: 
+- Notable achievements: 
+- Education: 
+- Projects: 
+
+[ADD JOB DESCRIPTION HERE]
+- Position: 
+- Required skills: 
+- Company: 
+- Key responsibilities: 
+
+Listen to interview questions and provide concise, relevant talking points to help answer effectively.`
+}, {
+  id: 'technical_interview',
+  name: 'Technical Interview Helper',
+  prompt: `You are a technical interview assistant. Provide quick hints, approaches, and explanations for technical questions.
+
+[ADD YOUR TECHNICAL BACKGROUND HERE]
+- Programming languages: 
+- Technologies/frameworks: 
+- Experience level: 
+- Areas of expertise: 
+
+[ADD JOB REQUIREMENTS HERE]
+- Technical stack: 
+- Position level: 
+- Key technical skills needed: 
+
+Listen to technical questions and provide brief, helpful guidance and approaches.`
+}, {
+  id: 'presentation_coach',
+  name: 'Presentation Coach',
+  prompt: `You are a real-time presentation assistant. Help improve delivery, suggest talking points, and provide confidence boosters.
+
+[ADD YOUR PRESENTATION CONTEXT HERE]
+- Topic/subject: 
+- Audience: 
+- Key messages: 
+- Your expertise level: 
+- Presentation goals: 
+
+Provide quick tips, talking points, and encouragement as you present.`
+}, {
+  id: 'learning_assistant',
+  name: 'Learning Assistant',
+  prompt: `You are a real-time learning companion. Help understand concepts, provide explanations, and suggest questions during lectures or tutorials.
+
+[ADD YOUR LEARNING CONTEXT HERE]
+- Subject/topic: 
+- Your current level: 
+- Learning goals: 
+- Areas of difficulty: 
+- Course context: 
+
+Provide quick explanations, clarifications, and helpful insights as you learn.`
+}, {
+  id: 'customer_call_helper',
+  name: 'Customer Call Helper',
+  prompt: `You are a customer service assistant. Help handle customer calls by providing quick responses, solutions, and talking points.
+
+[ADD YOUR PRODUCT/SERVICE INFO HERE]
+- Company/product: 
+- Common issues: 
+- Your role: 
+- Available solutions: 
+- Escalation procedures: 
+
+Listen to customer concerns and provide quick, helpful response suggestions.`
+}, {
+  id: 'general_assistant',
+  name: 'General Assistant',
+  prompt: `You are a transparent AI assistant. Provide real-time help, insights, and information based on what you hear through system audio.
+
+[ADD YOUR PREFERENCES HERE]
+- Primary use case: 
+- Areas of interest: 
+- Response style: (brief, detailed, technical, etc.)
+- Language preference: 
+
+Listen and provide relevant, helpful information and insights in real-time.`
+}];
+const getPromptTemplateById = id => {
+  return PROMPT_TEMPLATES.find(template => template.id === id);
+};export{PROMPT_TEMPLATES,getPromptTemplateById};//# sourceMappingURL=promptTemplates.js.map

package/lib/components/AIToolbar/components/speech/promptTemplates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptTemplates.js","sources":["../../../../../src/components/AIToolbar/components/speech/promptTemplates.ts"],"sourcesContent":[null],"names":[],"mappings":"sBAAiB,GAAc,CAAA;IAC3B,EAAE,sBAAS;MACX,EAAI,sBAAS;QACb,EAAM,CAAA;;AAGV;AAyHA;AAIA;;;AAAsE,kGAKpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/lib/components/AIToolbar/components/types.d.ts

@@ -0,0 +1,194 @@
+import type { ChangeEvent, ClipboardEvent, Dispatch, KeyboardEvent, ReactNode, RefObject, SetStateAction } from 'react';
+export type ToolbarSelectedProvider = {
+    provider: string;
+    variables: Record<string, string>;
+};
+export type ToolbarAudioDevices = {
+    input: {
+        id: string;
+        name: string;
+    };
+    output: {
+        id: string;
+        name: string;
+    };
+};
+/**
+ * STT/AI provider row — kept structurally aligned with Pluely `TYPE_PROVIDER`
+ * so host hooks can satisfy {@link UseCompletionReturn} without casts.
+ */
+export type ToolbarAiProvider = {
+    id?: string;
+    streaming?: boolean;
+    responseContentPath?: string;
+    isCustom?: boolean;
+    curl: string;
+};
+/** File row shown in the attach popover (host may extend fields). */
+export type ToolbarAttachedFile = {
+    id: string;
+    name: string;
+    type?: string;
+    base64?: string;
+    size?: number;
+};
+export interface ChatMessage {
+    id: string;
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    timestamp: number;
+}
+export type ToolbarScreenshotConfiguration = {
+    mode: 'manual' | 'auto' | 'timer';
+    autoPrompt: string;
+    enabled: boolean;
+    /** Timer interval in seconds when mode === 'timer'. Min 10, default 600 (10 min). */
+    intervalSec?: number;
+    /** Apply ±20% jitter to the timer interval to vary capture timing. */
+    jitter?: boolean;
+};
+export interface ChatConversation {
+    id: string;
+    title: string;
+    messages: ChatMessage[];
+    createdAt: number;
+    updatedAt: number;
+}
+/** Optional flags passed to {@link UseCompletionReturn.submit} (e.g. regenerate). */
+export type CompletionSubmitOptions = {
+    /** Trim history from this assistant message onward and resubmit the preceding user turn. */
+    regenerateAssistantMessageId?: string;
+};
+export interface VadConfig {
+    enabled: boolean;
+    hop_size: number;
+    sensitivity_rms: number;
+    peak_threshold: number;
+    silence_chunks: number;
+    min_speech_chunks: number;
+    pre_speech_chunks: number;
+    noise_gate_threshold: number;
+    max_recording_duration_secs: number;
+}
+/**
+ * Shape returned by the host’s completion hook — everything the toolbar input stack needs.
+ */
+export interface UseCompletionReturn {
+    input: string;
+    setInput: (value: string) => void;
+    response: string;
+    setResponse: (value: string) => void;
+    isLoading: boolean;
+    error: string | null;
+    attachedFiles: ToolbarAttachedFile[];
+    addFile: (file: File) => Promise<void>;
+    removeFile: (fileId: string) => void;
+    clearFiles: () => void;
+    submit: (speechText?: string, opts?: CompletionSubmitOptions) => Promise<void>;
+    /** When implemented, per-message actions can regenerate that assistant reply. */
+    regenerateAssistantMessage?: (assistantMessageId: string) => Promise<void>;
+    cancel: () => void;
+    reset: () => void;
+    setState: Dispatch<SetStateAction<unknown>>;
+    enableVAD: boolean;
+    setEnableVAD: Dispatch<SetStateAction<boolean>>;
+    micOpen: boolean;
+    setMicOpen: Dispatch<SetStateAction<boolean>>;
+    currentConversationId: string | null;
+    conversationHistory: ChatMessage[];
+    loadConversation: (conversation: ChatConversation) => void;
+    startNewConversation: () => void;
+    messageHistoryOpen: boolean;
+    setMessageHistoryOpen: Dispatch<SetStateAction<boolean>>;
+    keepEngaged: boolean;
+    setKeepEngaged: Dispatch<SetStateAction<boolean>>;
+    screenshotConfiguration: ToolbarScreenshotConfiguration;
+    setScreenshotConfiguration: Dispatch<SetStateAction<ToolbarScreenshotConfiguration>>;
+    handleScreenshotSubmit: (base64: string, prompt?: string) => Promise<void>;
+    handleFileSelect: (e: ChangeEvent<HTMLInputElement>) => void;
+    handleKeyPress: (e: KeyboardEvent) => void;
+    handlePaste: (e: ClipboardEvent) => Promise<void>;
+    isPopoverOpen: boolean;
+    scrollAreaRef: RefObject<HTMLDivElement | null>;
+    resizeWindow: (expanded: boolean) => Promise<void>;
+    isFilesPopoverOpen: boolean;
+    setIsFilesPopoverOpen: Dispatch<SetStateAction<boolean>>;
+    onRemoveAllFiles: () => void;
+    inputRef: RefObject<HTMLInputElement | null>;
+    captureScreenshot: () => Promise<void>;
+    isScreenshotLoading: boolean;
+    selectedSttProvider: ToolbarSelectedProvider;
+    allSttProviders: ToolbarAiProvider[];
+    managedAiApiEnabled: boolean;
+    selectedAudioDevices: ToolbarAudioDevices;
+    /** Host wires STT (e.g. fetchSTT + provider selection). */
+    transcribeAudio: (audio: Blob) => Promise<string>;
+}
+export type AIToolbarHostPlatform = 'macos' | 'windows' | 'linux';
+/**
+ * System-audio popover: host implements permission + screenshot bridges; state comes from the host hook.
+ */
+export interface SystemAudioProps {
+    hasActiveLicense?: boolean;
+    supportsImages?: boolean;
+    checkSystemAudioAccess: () => Promise<boolean>;
+    requestSystemAudioAccess: () => Promise<void>;
+    /** Raw base64 PNG (no data: prefix). If omitted, screenshot control is hidden. */
+    captureSystemScreenshot?: () => Promise<string>;
+    capturing: boolean;
+    isProcessing: boolean;
+    isAIProcessing: boolean;
+    lastTranscription: string;
+    lastAIResponse: string;
+    error: string;
+    setupRequired: boolean;
+    startCapture: () => Promise<void>;
+    stopCapture: () => Promise<void>;
+    isPopoverOpen: boolean;
+    setIsPopoverOpen: Dispatch<SetStateAction<boolean>>;
+    useSystemPrompt: boolean;
+    setUseSystemPrompt: (value: boolean) => void;
+    contextContent: string;
+    setContextContent: (content: string) => void;
+    startNewConversation: () => void;
+    conversation: ChatConversation;
+    resizeWindow: (expanded: boolean) => void | Promise<void>;
+    quickActions: string[];
+    addQuickAction: (action: string) => void;
+    removeQuickAction: (action: string) => void;
+    isManagingQuickActions: boolean;
+    setIsManagingQuickActions: Dispatch<SetStateAction<boolean>>;
+    showQuickActions: boolean;
+    setShowQuickActions: Dispatch<SetStateAction<boolean>>;
+    handleQuickActionClick: (action: string) => Promise<void>;
+    vadConfig: VadConfig;
+    updateVadConfiguration: (config: VadConfig) => void;
+    isRecordingInContinuousMode: boolean;
+    recordingProgress: number;
+    manualStopAndSend: () => Promise<void>;
+    startContinuousRecording: () => Promise<void>;
+    ignoreContinuousRecording: () => Promise<void>;
+    scrollAreaRef: RefObject<HTMLDivElement | null>;
+    /** Optional host-provided content rendered under Settings dropdown. */
+    settingsDropdownContent?: ReactNode;
+    /** Optional footer (e.g. version, report bug) pinned under the scroll area, below Help & shortcuts. */
+    voicePopoverFooter?: ReactNode;
+    /** When false, omit native `title=` tooltips on primary voice popover controls (desktop bar setting). */
+    toolbarShowElementTitles?: boolean;
+}
+export type AIToolbarAppProps = {
+    isHidden?: boolean;
+    systemAudio: SystemAudioProps;
+    completion: UseCompletionReturn;
+    hasActiveLicense?: boolean;
+    supportsImages?: boolean;
+    cursorType?: string;
+    platform?: AIToolbarHostPlatform;
+    onOpenDashboard?: () => void | Promise<void>;
+    trailing?: ReactNode;
+    className?: string;
+    toolbarClassName?: string;
+    /** When false, omit native `title=` tooltips on toolbar controls (desktop bar setting). Default: show. */
+    showElementTitles?: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/components/AIToolbar/components/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/AIToolbar/components/types.ts"],"names":[],"mappings":"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"}

package/lib/components/AIToolbar/hooks/marketplaceCharactersRegistry.d.ts

@@ -0,0 +1,13 @@
+/** Entries fed from yantra marketplace uiLayout (`useMarketplaceCharacters`) before install. */
+export type MarketplaceCharacterEntry = {
+    name: string;
+    fileName?: string;
+    extensionId?: string;
+    extensionSlug?: string;
+    avatarSrc: string | null;
+};
+/** Dispatched when {@link setMarketplaceCharacters} updates the overlay list. */
+export declare const MARKETPLACE_CHARACTERS_CHANGED_EVENT = "yantra:marketplace-characters-changed";
+export declare function setMarketplaceCharacters(entries: MarketplaceCharacterEntry[]): void;
+export declare function getMarketplaceCharactersSnapshot(): MarketplaceCharacterEntry[];
+//# sourceMappingURL=marketplaceCharactersRegistry.d.ts.map

package/lib/components/AIToolbar/hooks/marketplaceCharactersRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplaceCharactersRegistry.d.ts","sourceRoot":"","sources":["../../../../src/components/AIToolbar/hooks/marketplaceCharactersRegistry.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,MAAM,MAAM,yBAAyB,GAAG;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,iFAAiF;AACjF,eAAO,MAAM,oCAAoC,0CAA0C,CAAC;AAI5F,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,EAAE,GAAG,IAAI,CAKnF;AAED,wBAAgB,gCAAgC,IAAI,yBAAyB,EAAE,CAE9E"}