import { HEADER_FEATURE_NAME, HEADER_INTERFACE_NAME, HEADER_QUOTA_ID, HEADER_TRACEPARENT, HEADER_USER_ACTION_ID } from '../constants';
export declare function generateUserActionId(): string;
export declare function generateTraceparent(): string;
export interface UserActionHeaders extends Record<string, string> {
    [HEADER_USER_ACTION_ID]: string;
    [HEADER_TRACEPARENT]: string;
    [HEADER_INTERFACE_NAME]: string;
    [HEADER_FEATURE_NAME]: string;
    [HEADER_QUOTA_ID]: string;
}
export declare const startUserAction: (interfaceName?: string, featureName?: string) => Promise<UserActionHeaders>;
export declare function getUserActionHeaders(): UserActionHeaders;
export declare function withTrackingHeaders(options?: RequestInit): RequestInit;
export declare const endUserAction: () => void;
/**
 * Wraps an async function with user-action tracking (capture at start, report at end).
 * Use for standalone engine calls (e.g., from MCP Server) when tracing and consumption tracking are required.
 * @param interfaceName - e.g. 'MCP'
 * @param featureName - e.g. 'BUILD-CHART'
 * @param fn - The async function to execute
 * @returns The result of fn
 */
export declare function runWithUserAction<T>(interfaceName: string, featureName: string, fn: () => Promise<T>): Promise<T>;
//# sourceMappingURL=user-action-tracking.d.ts.map