import type { ServerContext } from '../context.js';
import type { OllamaPhase } from '../embeddings/ollama.js';
export interface PreparingResponse {
    status: 'preparing' | 'failed';
    message: string;
    phase?: OllamaPhase;
}
/**
 * v1.7.22 (O3/N2): shared preparing-state shape for tools that need the
 * embedder. Returns `null` when the embedder is fully ready — callers then
 * proceed normally. Returns a `failed` envelope if startup raised; otherwise
 * a `preparing` envelope, with Ollama pull progress surfaced verbatim when
 * the embedder is mid-pull.
 *
 * Callers (search.ts, reindex.ts) should gate on `!ctx.embedderReady()` and
 * forward this response straight back to the MCP client when non-null. The
 * extra `phase` field lets clients display a progress bar without parsing
 * the human-readable `message`.
 */
export declare function describeEmbedderPreparing(ctx: ServerContext): PreparingResponse | null;