import { type H3Event } from "h3";
import { type ProviderKeyCheckCode } from "./agent-engine-provider-models-route.js";
type AgentEngineApiKeyScope = "user" | "org";
export interface AgentEngineApiKeyWriteTarget {
    scope: AgentEngineApiKeyScope;
    scopeId: string;
}
/**
 * Check a provider key before it is stored, by listing the models it
 * reaches. `baseUrl` is OpenAI's gateway: a string checks that endpoint,
 * `null` the default, `undefined` the saved one (read through the ambient
 * request context).
 */
export declare function validateAgentEngineProviderKey(key: string, value: string, options?: {
    baseUrl?: string | null;
}): Promise<{
    ok: true;
    models: string[];
} | {
    ok: false;
    statusCode: number;
    error: string;
    code: ProviderKeyCheckCode;
}>;
export declare function normalizeAgentEngineApiKeyPayload(body: unknown): {
    ok: true;
    key: string;
    value?: string;
    baseUrl?: string;
    clearBaseUrl: boolean;
    scope: AgentEngineApiKeyScope;
    surface?: "settings" | "onboarding" | "setup_card";
} | {
    ok: false;
    statusCode: number;
    error: string;
};
export declare function normalizeAgentEngineApiKeyDeletePayload(body: unknown): {
    ok: true;
    key: string;
    endpointKey?: string;
    scope: AgentEngineApiKeyScope;
} | {
    ok: false;
    statusCode: number;
    error: string;
};
export declare function resolveAgentEngineApiKeyWriteTarget(event: H3Event, scope: AgentEngineApiKeyScope): Promise<{
    ok: true;
    target: AgentEngineApiKeyWriteTarget;
} | {
    ok: false;
    statusCode: number;
    error: string;
}>;
export declare function createAgentEngineApiKeyHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
    error: string;
    errorCode?: undefined;
    code?: undefined;
} | {
    error: string;
    errorCode: string;
    code?: undefined;
} | {
    errorCode?: undefined;
    error: string;
    code: ProviderKeyCheckCode;
} | {
    error?: undefined;
    errorCode?: undefined;
    code?: undefined;
    ok: boolean;
    key: string;
    baseUrlKey?: string | undefined;
    scope: AgentEngineApiKeyScope;
    defaultModel?: import("./agent-engine-default-model-route.js").SavedKeyDefaultModelOutcome | undefined;
}>>;
export {};