import { type AgentEngine, type EngineContentPart, type EngineStreamOptions } from "../agent/engine/index.js";
import type { ReasoningEffort } from "../shared/reasoning-effort.js";
export interface CompleteTextMessage {
    role: "user" | "assistant";
    content: string | EngineContentPart[];
}
export interface CompleteTextUsage {
    inputTokens?: number;
    outputTokens?: number;
    cacheReadTokens?: number;
    cacheWriteTokens?: number;
    totalTokens?: number;
    reasoningTokens?: number;
}
export interface CompleteTextOptions {
    systemPrompt?: string;
    input?: string;
    messages?: CompleteTextMessage[];
    engine?: string | AgentEngine | {
        name: string;
        config: Record<string, unknown>;
    };
    model?: string;
    appId?: string;
    apiKey?: string;
    maxOutputTokens?: number;
    temperature?: number;
    reasoningEffort?: ReasoningEffort;
    providerOptions?: EngineStreamOptions["providerOptions"];
    signal?: AbortSignal;
    timeoutMs?: number;
}
export interface CompleteTextResult {
    text: string;
    content: EngineContentPart[];
    engine: string;
    model: string;
    stopReason?: "end_turn" | "max_tokens" | "stop_sequence" | "tool_use";
    usage?: CompleteTextUsage;
}
export declare function completeText(options: CompleteTextOptions): Promise<CompleteTextResult>;