export declare const OPENAI_V1_ORGANIZATION_USAGE_ENDPOINT: "/v1/organization/usage";
export declare const DEFAULT_OPENAI_V1_ORGANIZATION_USAGE_BASE_URL: "https://api.openai.com";
export type OpenAIV1OrganizationUsageMethod = "GET";
export type OpenAIV1OrganizationUsageBoundary = "input" | "contract" | "governance" | "auth" | "scope" | "provider" | "response";
export type OpenAIV1OrganizationUsageErrorCode = "MISSING_OPERATION" | "MISSING_RUNTIME_ID" | "INVALID_QUERY" | "CONTRACT_REJECTED" | "GOVERNANCE_REJECTED" | "SCOPE_DENIED" | "AUTH_REJECTED" | "REAL_PROVIDER_CALL_NOT_ALLOWED" | "PROVIDER_AUTH_FAILED" | "PROVIDER_RATE_LIMITED" | "PROVIDER_TIMEOUT" | "PROVIDER_UNAVAILABLE" | "RESPONSE_FORMAT_DRIFT" | "PROVIDER_REJECTED";
export type OpenAIV1OrganizationUsageGate = {
    accepted: boolean;
    reason?: string;
};
export type OpenAIV1OrganizationUsageRuntimeContext = {
    runtimeId?: string;
    invocationId?: string;
    traceId?: string;
    callerId?: string;
};
export type OpenAIV1OrganizationUsageAuthEnvelope = {
    kind: "bearer" | "api-key" | "none";
    present: boolean;
    redactedToken?: string;
    organizationId?: string;
};
export type OpenAIV1OrganizationUsageRequestEnvelope = {
    provider: "openai";
    apiVersion: "v1";
    endpoint: typeof OPENAI_V1_ORGANIZATION_USAGE_ENDPOINT;
    operation: string;
    method: OpenAIV1OrganizationUsageMethod;
    url: string;
    query: Readonly<Record<string, string>>;
    headers: Readonly<Record<string, string>>;
    runtime: Required<OpenAIV1OrganizationUsageRuntimeContext>;
    requestedScopes: readonly string[];
    grantedScopes: readonly string[];
    dryRun: true;
    providerCallPlanned: false;
    unsafeSideEffects: false;
    providerFieldsOpaque: true;
};
export type OpenAIV1OrganizationUsageInvocationRequest = {
    operation?: string;
    query?: Readonly<Record<string, string | number | boolean | undefined>>;
    headers?: Readonly<Record<string, string | undefined>>;
    baseUrl?: string;
    auth?: OpenAIV1OrganizationUsageAuthEnvelope;
    runtime?: OpenAIV1OrganizationUsageRuntimeContext;
    requiredScopes?: readonly string[];
    allowedScopes?: readonly string[];
    contract?: OpenAIV1OrganizationUsageGate;
    governance?: OpenAIV1OrganizationUsageGate;
    dryRun?: boolean;
    mockResponse?: unknown;
    expectResponseObject?: boolean;
    providerError?: unknown;
};
export type OpenAIV1OrganizationUsageResponseEnvelope = {
    provider: "openai";
    endpoint: typeof OPENAI_V1_ORGANIZATION_USAGE_ENDPOINT;
    mode: "dry-run" | "mock";
    raw: unknown;
    providerFieldsOpaque: true;
};
export type OpenAIV1OrganizationUsageCapabilitySignal = {
    provider: "openai";
    layer: "actualInvocationLayer";
    endpoint: typeof OPENAI_V1_ORGANIZATION_USAGE_ENDPOINT;
    operation: string;
    rawShape: "organization-usage-list" | "organization-usage-object" | "mock" | "dry-run";
    providerRawShapePromoted: false;
};
export type OpenAIV1OrganizationUsageError = {
    code: OpenAIV1OrganizationUsageErrorCode;
    message: string;
    boundary: OpenAIV1OrganizationUsageBoundary;
    retryable: boolean;
    safeForRuntimeInspection: true;
    providerRawDetailExposed: false;
};
export type OpenAIV1OrganizationUsageResult = {
    ok: true;
    request: OpenAIV1OrganizationUsageRequestEnvelope;
    response: OpenAIV1OrganizationUsageResponseEnvelope;
    capability: OpenAIV1OrganizationUsageCapabilitySignal;
    events: readonly string[];
} | {
    ok: false;
    error: OpenAIV1OrganizationUsageError;
    request?: OpenAIV1OrganizationUsageRequestEnvelope;
    events: readonly string[];
};
export declare const openAIV1OrganizationUsageDescriptor: {
    readonly provider: "openai";
    readonly layer: "actualInvocationLayer";
    readonly endpoint: "/v1/organization/usage";
    readonly method: "GET";
    readonly requestShape: "query";
    readonly providerRawShapePromoted: false;
    readonly unsafeSideEffects: false;
};
export declare function classifyOpenAIV1OrganizationUsageProviderError(error: unknown): OpenAIV1OrganizationUsageErrorCode;
export declare function createOpenAIV1OrganizationUsageInvocation(input?: OpenAIV1OrganizationUsageInvocationRequest): OpenAIV1OrganizationUsageResult;
