/**
 * TamboThreadInputProvider - Shared Thread Input Context
 *
 * Provides shared input state across all components, enabling features like
 * suggestions to update the input field directly.
 *
 * This mirrors the TamboThreadInputProvider pattern from the legacy beta SDK.
 */
import React, { type PropsWithChildren } from "react";
import { type StagedImage } from "../../hooks/use-message-images.js";
import { type UseTamboMutationResult } from "../../hooks/react-query-hooks.js";
import type { ToolChoice } from "@tambo-ai/client";
export declare const INPUT_ERROR_MESSAGES: {
    readonly EMPTY: "Message cannot be empty";
    readonly VALIDATION: "Invalid message format";
};
/**
 * Options for submitting a message
 */
export interface SubmitOptions {
    /**
     * Enable debug logging for the stream
     */
    debug?: boolean;
    /**
     * How the model should use tools. Defaults to "auto".
     * - "auto": Model decides whether to use tools
     * - "required": Model must use at least one tool
     * - "none": Model cannot use tools
     * - { name: "toolName" }: Model must use the specified tool
     */
    toolChoice?: ToolChoice;
}
/**
 * Context props for thread input state
 */
export interface TamboThreadInputContextProps extends Omit<UseTamboMutationResult<{
    threadId: string | undefined;
}, Error, SubmitOptions | undefined>, "mutate" | "mutateAsync"> {
    /** Current value of the input field */
    value: string;
    /**
     * Function to update the input value
     * @param value - New value for the input field
     */
    setValue: React.Dispatch<React.SetStateAction<string>>;
    /**
     * Function to submit the current input value
     * @param options - Submission options
     * @returns Promise with the threadId
     */
    submit: (options?: SubmitOptions) => Promise<{
        threadId: string | undefined;
    }>;
    /** Currently staged images */
    images: StagedImage[];
    /** Add a single image */
    addImage: (file: File) => Promise<void>;
    /** Add multiple images */
    addImages: (files: File[]) => Promise<void>;
    /** Remove an image by id */
    removeImage: (id: string) => void;
    /** Clear all staged images */
    clearImages: () => void;
    /** Current thread ID being used for input (from stream state) */
    threadId: string | undefined;
    /** Whether the input should be disabled (pending submission or not authenticated) */
    isDisabled: boolean;
}
/**
 * Context for thread input state.
 * @internal
 */
export declare const TamboThreadInputContext: React.Context<TamboThreadInputContextProps | undefined>;
/**
 * Provider that manages shared thread input state across all components.
 *
 * This ensures that useTamboThreadInput, useTamboSuggestions, and other components
 * all share the same input state.
 * @param props - Provider props
 * @param props.children - Child components
 * @returns Thread input context provider
 */
export declare function TamboThreadInputProvider({ children }: PropsWithChildren): React.JSX.Element;
/**
 * Hook to access the shared thread input state.
 *
 * All components using this hook share the same input state, enabling
 * features like suggestions to update the input field directly.
 * @returns The shared thread input context
 * @throws {Error} If used outside TamboThreadInputProvider
 * @example
 * ```tsx
 * function ChatInput() {
 *   const { value, setValue, submit, isPending } = useTamboThreadInput();
 *
 *   return (
 *     <form onSubmit={(e) => { e.preventDefault(); submit(); }}>
 *       <input
 *         value={value}
 *         onChange={(e) => setValue(e.target.value)}
 *         disabled={isPending}
 *       />
 *       <button type="submit" disabled={isPending}>Send</button>
 *     </form>
 *   );
 * }
 * ```
 */
export declare function useTamboThreadInput(): TamboThreadInputContextProps;
//# sourceMappingURL=tambo-v1-thread-input-provider.d.ts.map