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 {
    /** Optional system prompt for the single model call. */
    systemPrompt?: string;
    /** Convenience final user message. Appended after `messages` when both are set. */
    input?: string;
    /** Optional prior messages for narrow multi-turn transforms. */
    messages?: CompleteTextMessage[];
    /** Explicit engine name or instance. Omit to use the normal request/default engine. */
    engine?: string | AgentEngine | {
        name: string;
        config: Record<string, unknown>;
    };
    /** Explicit model. Omit to honor app/user default, then engine default. */
    model?: string;
    /** App/template id used for org-scoped model defaults. */
    appId?: string;
    /** Optional direct API key. Prefer request secrets/env resolution when possible. */
    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;
}
/**
 * Run a single server-side model completion through the framework engine layer.
 *
 * Prefer `sendToAgentChat()` or actions for product workflows where the user
 * should see, steer, or audit the agent. Use this helper only for narrow text
 * transforms that intentionally do not need tools, chat history, or run state.
 */
export declare function completeText(options: CompleteTextOptions): Promise<CompleteTextResult>;
//# sourceMappingURL=complete-text.d.ts.map