export declare const DEEPMIND_V1BETA_FILES_ENDPOINT: "/v1beta/files";
export type DeepMindV1BetaFilesMethod = "GET" | "POST" | "PATCH" | "DELETE";
export type DeepMindV1BetaFilesGate = {
    accepted: boolean;
    reason?: string;
};
export type DeepMindV1BetaFilesRuntimeContext = {
    runtimeId?: string;
    correlationId?: string;
    callerId?: string;
};
export type DeepMindV1BetaFilesAuthEnvelope = {
    kind: "api-key" | "oauth" | "none";
    present: boolean;
    redactedToken?: string;
};
export type DeepMindV1BetaFilesRequestEnvelope = {
    provider: "deepmind";
    apiVersion: "v1beta";
    endpoint: typeof DEEPMIND_V1BETA_FILES_ENDPOINT;
    operation: string;
    method: DeepMindV1BetaFilesMethod;
    urlPath: string;
    query: Readonly<Record<string, string>>;
    headers: Readonly<Record<string, string>>;
    body?: unknown;
    runtime: Required<DeepMindV1BetaFilesRuntimeContext>;
    requestedScopes: readonly string[];
    grantedScopes: readonly string[];
    dryRun: boolean;
    unsafeSideEffects: false;
    providerFieldsOpaque: true;
};
export type DeepMindV1BetaFilesProviderCaller = (envelope: DeepMindV1BetaFilesRequestEnvelope) => unknown | Promise<unknown>;
export type DeepMindV1BetaFilesInvocationRequest = {
    operation?: string;
    method?: DeepMindV1BetaFilesMethod;
    pathSuffix?: string;
    query?: Readonly<Record<string, string | number | boolean | undefined>>;
    headers?: Readonly<Record<string, string | undefined>>;
    body?: unknown;
    auth?: DeepMindV1BetaFilesAuthEnvelope;
    runtime?: DeepMindV1BetaFilesRuntimeContext;
    requiredScopes?: readonly string[];
    allowedScopes?: readonly string[];
    contract?: DeepMindV1BetaFilesGate;
    governance?: DeepMindV1BetaFilesGate;
    dryRun?: boolean;
    mockResponse?: unknown;
    expectResponseObject?: boolean;
    caller?: DeepMindV1BetaFilesProviderCaller;
};
export type DeepMindV1BetaFilesErrorCode = "MISSING_OPERATION" | "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 DeepMindV1BetaFilesError = {
    code: DeepMindV1BetaFilesErrorCode;
    message: string;
    boundary: "input" | "contract" | "governance" | "auth" | "scope" | "provider";
    retryable: boolean;
};
export type DeepMindV1BetaFilesProviderResponseEnvelope = {
    provider: "deepmind";
    endpoint: typeof DEEPMIND_V1BETA_FILES_ENDPOINT;
    mode: "dry-run" | "mock" | "caller";
    raw: unknown;
    providerFieldsOpaque: true;
};
export type DeepMindV1BetaFilesCapabilitySignal = {
    provider: "deepmind";
    endpoint: typeof DEEPMIND_V1BETA_FILES_ENDPOINT;
    operation: string;
    rawShape: "opaque-provider-payload";
};
export type DeepMindV1BetaFilesInvocationResult = {
    ok: true;
    request: DeepMindV1BetaFilesRequestEnvelope;
    response: DeepMindV1BetaFilesProviderResponseEnvelope;
    capability: DeepMindV1BetaFilesCapabilitySignal;
    events: readonly string[];
} | {
    ok: false;
    error: DeepMindV1BetaFilesError;
    request?: DeepMindV1BetaFilesRequestEnvelope;
    events: readonly string[];
};
export declare function classifyDeepMindV1BetaFilesProviderError(error: unknown): DeepMindV1BetaFilesErrorCode;
export declare function invokeDeepMindV1BetaFiles(input?: DeepMindV1BetaFilesInvocationRequest): Promise<DeepMindV1BetaFilesInvocationResult>;
