import { UseGenerationOptions, UseGenerationReturn } from "./use-generation.js"; import { Accessor } from "solid-js"; import { AIDevtoolsDisplayOptions, ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, GenerationPersistenceOptions, InferGenerationOutputFromReturn, SummarizeGenerateInput } from "@tanstack/ai-client"; import { StreamChunk, SummarizationResult } from "@tanstack/ai"; //#region src/use-summarize.d.ts /** * Options for the useSummarize hook. * * @template TOutput - The transformed output type (defaults to SummarizationResult) */ interface UseSummarizeOptions extends Pick, 'persistence' | 'threadId' | 'hydrateGeneration' | 'joinRun' | 'byok' | 'byokProvider'> { /** Connect-based adapter for streaming transport (SSE, HTTP stream, custom) */ connection?: ConnectConnectionAdapter; /** Direct async function for summarization */ fetcher?: GenerationFetcher; /** Additional body parameters to send with connect-based adapter requests */ body?: Record; /** Display options for TanStack AI Devtools. */ devtools?: AIDevtoolsDisplayOptions; /** * Callback when summarization is complete. Can optionally return a transformed value. * * - Return a non-null value to transform and store it as the result * - Return `null` to keep the previous result unchanged * - Return nothing (`void`) to store the raw result as-is */ onResult?: (result: SummarizationResult) => TOutput | null | void; /** Callback when an error occurs */ onError?: (error: Error) => void; /** Callback when progress is reported (0-100) */ onProgress?: (progress: number, message?: string) => void; /** Callback for each stream chunk (connect-based adapter mode only) */ onChunk?: (chunk: StreamChunk) => void; } /** * Return type for the useSummarize hook. * * @template TOutput - The transformed output type (defaults to SummarizationResult) */ interface UseSummarizeReturn extends Omit, 'generate'> { /** Trigger summarization */ generate: (input: SummarizeGenerateInput) => Promise; /** The summarization result, or null */ result: Accessor; /** Whether summarization is in progress */ isLoading: Accessor; /** Current error, if any */ error: Accessor; /** Current state of the generation */ status: Accessor; } /** * Solid hook for summarizing text using AI models. * * @example * ```tsx * import { useSummarize } from '@tanstack/ai-solid' * import { fetchServerSentEvents } from '@tanstack/ai-client' * * function Summarizer() { * const { generate, result, isLoading } = useSummarize({ * connection: fetchServerSentEvents('/api/summarize'), * }) * * return ( *
* * {isLoading() &&

Summarizing...

} * {result() &&

{result()!.summary}

} *
* ) * } * ``` */ declare function useSummarize(options: Omit & { onResult?: (result: SummarizationResult) => TTransformed; } & GenerationPersistenceOptions): UseSummarizeReturn>; //#endregion export { UseSummarizeOptions, UseSummarizeReturn, useSummarize }; //# sourceMappingURL=use-summarize.d.ts.map