import type { ApiUsage } from "../types.mts";
import type { RateLimitInfo } from "./http-utils.mts";
export interface ApiTelemetryEvent {
    kind: "GraphQL" | "REST";
    method: string;
    authSource: string;
    rateLimit?: RateLimitInfo;
}
/** Isolates a top-level CLI/MCP command while allowing nested iterate ticks to aggregate. */
export declare function withApiTelemetryScope<T>(fn: () => Promise<T>): Promise<T>;
export declare function recordApiTelemetry(event: ApiTelemetryEvent): void;
export declare function mergeGraphqlRateLimit(headerRateLimit: RateLimitInfo | null, data: unknown): RateLimitInfo | null;
export declare function summarizeApiTelemetry(): ApiUsage | undefined;