export declare const OPENAI_V1_IMAGES_EDITS_ENDPOINT: "/v1/images/edits";
export declare const DEFAULT_OPENAI_V1_IMAGES_EDITS_BASE_URL: "https://api.openai.com";
export type OpenAIV1ImagesEditsBoundary = "input" | "contract" | "governance" | "auth" | "scope" | "provider" | "response";
export type OpenAIV1ImagesEditsErrorCode = "MISSING_BODY" | "MISSING_IMAGE" | "MISSING_RUNTIME_ID" | "CONTRACT_REJECTED" | "GOVERNANCE_REJECTED" | "SCOPE_DENIED" | "AUTH_REJECTED" | "CALLER_REQUIRED" | "PROVIDER_AUTH_FAILED" | "PROVIDER_RATE_LIMITED" | "PROVIDER_TIMEOUT" | "PROVIDER_UNAVAILABLE" | "RESPONSE_FORMAT_DRIFT" | "CALLER_FAILED";
export type OpenAIV1ImagesEditsGate = {
    accepted: boolean;
    reason?: string;
};
export type OpenAIV1ImagesEditsRuntimeContext = {
    runtimeId?: string;
    invocationId?: string;
    traceId?: string;
    callerId?: string;
};
export type OpenAIV1ImagesEditsAuthEnvelope = {
    kind: "bearer" | "api-key" | "none";
    present: boolean;
    redactedToken?: string;
};
export type OpenAIV1ImagesEditInput = {
    id?: string;
    name?: string;
    mimeType?: string;
    byteLength?: number;
    sourceRef?: string;
    providerHandle?: unknown;
};
export type OpenAIV1ImagesEditsRequestEnvelope = {
    provider: "openai";
    apiVersion: "v1";
    endpoint: typeof OPENAI_V1_IMAGES_EDITS_ENDPOINT;
    operation: "edit-image";
    method: "POST";
    url: string;
    headers: Readonly<Record<string, string>>;
    body: unknown;
    images: readonly OpenAIV1ImagesEditInput[];
    mask?: OpenAIV1ImagesEditInput;
    runtime: Required<OpenAIV1ImagesEditsRuntimeContext>;
    requestedScopes: readonly string[];
    grantedScopes: readonly string[];
    dryRun: boolean;
    providerCallPlanned: boolean;
    unsafeSideEffects: false;
    providerFieldsOpaque: true;
};
export type OpenAIV1ImagesEditsProviderCaller = (envelope: OpenAIV1ImagesEditsRequestEnvelope) => unknown | Promise<unknown>;
export type OpenAIV1ImagesEditsInvocationRequest = {
    body?: unknown;
    images?: readonly OpenAIV1ImagesEditInput[];
    mask?: OpenAIV1ImagesEditInput;
    baseUrl?: string;
    headers?: Readonly<Record<string, string | undefined>>;
    auth?: OpenAIV1ImagesEditsAuthEnvelope;
    runtime?: OpenAIV1ImagesEditsRuntimeContext;
    requiredScopes?: readonly string[];
    allowedScopes?: readonly string[];
    contract?: OpenAIV1ImagesEditsGate;
    governance?: OpenAIV1ImagesEditsGate;
    dryRun?: boolean;
    mockResponse?: unknown;
    expectImageListResponse?: boolean;
    caller?: OpenAIV1ImagesEditsProviderCaller;
};
export type OpenAIV1ImagesEditsResponseEnvelope = {
    provider: "openai";
    endpoint: typeof OPENAI_V1_IMAGES_EDITS_ENDPOINT;
    mode: "dry-run" | "mock" | "caller";
    raw: unknown;
    providerFieldsOpaque: true;
};
export type OpenAIV1ImagesEditsCapabilitySignal = {
    provider: "openai";
    endpoint: typeof OPENAI_V1_IMAGES_EDITS_ENDPOINT;
    operation: "edit-image";
    rawShape: "image-list" | "mock" | "dry-run";
};
export type OpenAIV1ImagesEditsError = {
    code: OpenAIV1ImagesEditsErrorCode;
    message: string;
    boundary: OpenAIV1ImagesEditsBoundary;
    retryable: boolean;
};
export type OpenAIV1ImagesEditsResult = {
    ok: true;
    request: OpenAIV1ImagesEditsRequestEnvelope;
    response: OpenAIV1ImagesEditsResponseEnvelope;
    capability: OpenAIV1ImagesEditsCapabilitySignal;
    events: readonly string[];
} | {
    ok: false;
    error: OpenAIV1ImagesEditsError;
    request?: OpenAIV1ImagesEditsRequestEnvelope;
    events: readonly string[];
};
export declare function classifyOpenAIV1ImagesEditsProviderError(error: unknown): OpenAIV1ImagesEditsErrorCode;
export declare function invokeOpenAIV1ImagesEdits(input?: OpenAIV1ImagesEditsInvocationRequest): Promise<OpenAIV1ImagesEditsResult>;
