import { ReactNode } from 'react';
import { Vowel } from '../core';
import { VoiceSessionState } from '../managers';
import { FloatingCursorConfig } from '../types';
/**
 * Vowel Context type
 */
export interface VowelContextType {
    /** Vowel client instance (null if not initialized) */
    client: Vowel | null;
    /** Current session state */
    state: VoiceSessionState;
    /** Start a voice session */
    startSession: () => Promise<void>;
    /** Stop the current session */
    stopSession: () => void;
    /** Toggle session on/off */
    toggleSession: () => Promise<void>;
    /** Clear transcript history */
    clearTranscripts: () => void;
    /**
     * Notify the AI about an app event
     * Triggers an AI voice response without requiring user speech input
     *
     * @param eventDetails - Description of the event
     * @param context - Optional context data
     */
    notifyEvent: (eventDetails: string, context?: Record<string, any>) => Promise<void>;
    /**
     * Send text to the AI for processing
     * Lower-level method for custom text interactions
     *
     * @param text - Text to send to the AI
     */
    sendText: (text: string) => Promise<void>;
    /**
     * Update the dynamic context that gets appended to system prompt.
     * Context is stringified, wrapped in `<context>` tags and sent via session.update.
     *
     * When context changes, a session.update event is automatically sent
     * to update the system prompt so the AI knows about the current context.
     *
     * @param context - Context object to append to system prompt. Use null to clear.
     *
     * @example
     * ```tsx
     * const { updateContext } = useVowel();
     *
     * useEffect(() => {
     *   updateContext({ page: 'product', productId: 'iphone-15-pro' });
     *   return () => updateContext(null); // Clear on unmount
     * }, [product]);
     * ```
     */
    updateContext: (context: Record<string, unknown> | null) => void;
    /**
     * Get current context value
     *
     * @returns Current context object (null if no context set)
     *
     * @example
     * ```tsx
     * const { getContext } = useVowel();
     * const currentContext = getContext();
     * ```
     */
    getContext: () => Record<string, unknown> | null;
}
/**
 * Props for VowelProvider
 */
export interface VowelProviderProps {
    /** Vowel client instance (can be null if not yet initialized) */
    client: Vowel | null;
    /** Children to render */
    children: ReactNode;
    /**
     * Optional: Floating cursor configuration for React mode
     * When enabled, cursor will be rendered as a native React component
     *
     * @default { enabled: true } (enabled by default)
     *
     * Set to false to disable:
     * @example
     * ```tsx
     * <VowelProvider client={client} floatingCursor={false}>
     *   <VowelAgent />
     * </VowelProvider>
     * ```
     *
     * Or customize appearance:
     * @example
     * ```tsx
     * <VowelProvider
     *   client={client}
     *   floatingCursor={{
     *     enabled: true,
     *     appearance: { cursorColor: '#2563eb' }
     *   }}
     * >
     *   <VowelAgent />
     * </VowelProvider>
     * ```
    */
    floatingCursor?: FloatingCursorConfig | false;
    /**
     * How to handle transient null clients.
     *
     * - `sticky` (default): keep the last known good client across transient nulls.
     * - `strict`: immediately clear the active client when prop becomes null.
     */
    clientMode?: "sticky" | "strict";
    /**
     * In sticky mode, how long to wait before releasing an idle client after prop=null.
     *
     * This timeout is ignored while a session is live (connected/connecting/resuming/disconnecting).
     *
     * @default 5000
     */
    nullClientGraceMs?: number;
}
/**
 * Provider component for Vowel voice agent
 * Wrap your app with this to enable voice interactions
 *
 * This is the ONLY provider users need to manage.
 * Floating cursor is enabled by default and automatically wrapped.
 *
 * @example Basic usage (floating cursor enabled by default)
 * ```tsx
 * import { VowelProvider, VowelAgent } from '@vowel.to/client/react';
 * import { vowel } from './vowel.client';
 *
 * function App() {
 *   return (
 *     <VowelProvider client={vowel}>
 *       <VowelAgent />
 *     </VowelProvider>
 *   );
 * }
 * ```
 *
 * @example Disable floating cursor
 * ```tsx
 * <VowelProvider client={vowel} floatingCursor={false}>
 *   <VowelAgent />
 * </VowelProvider>
 * ```
 *
 * @example Customize floating cursor
 * ```tsx
 * <VowelProvider
 *   client={vowel}
 *   floatingCursor={{
 *     enabled: true,
 *     appearance: { cursorColor: '#2563eb' }
 *   }}
 * >
 *   <VowelAgent />
 * </VowelProvider>
 * ```
 */
export declare function VowelProvider({ client, children, floatingCursor, clientMode, nullClientGraceMs, }: VowelProviderProps): import("react/jsx-runtime").JSX.Element;
/**
 * Hook to access Vowel context
 *
 * @example
 * ```tsx
 * function MyComponent() {
 *   const { state, toggleSession, client } = useVowel();
 *
 *   // Don't render if client is not available yet
 *   if (!client) {
 *     return null;
 *   }
 *
 *   return (
 *     <button onClick={toggleSession}>
 *       {state.isConnected ? 'Stop' : 'Start'} Voice
 *     </button>
 *   );
 * }
 * ```
 */
export declare function useVowel(): VowelContextType;
//# sourceMappingURL=VowelProviderSimple.d.ts.map