@usagetap/sdk 1.3.1 → 1.4.0

package/dist/client-BD8O2J8Z.d.ts

@@ -1,668 +0,0 @@
-type ReasoningLevel = "NONE" | "LOW" | "MEDIUM" | "HIGH";
-type LimitType = "NONE" | "BLOCK" | "DOWNGRADE";
-interface RequestedEntitlements {
-    standard?: boolean;
-    premium?: boolean;
-    audio?: boolean;
-    image?: boolean;
-    search?: boolean;
-    reasoningLevel?: ReasoningLevel;
-}
-type AllowedEntitlements = Required<RequestedEntitlements>;
-type ModelTier = "premium" | "standard" | "none";
-interface EntitlementDowngradeHint {
-    reason: string;
-    fallbackTier?: ModelTier;
-}
-interface EntitlementHints {
-    suggestedModelTier: ModelTier;
-    reasoningLevel: ReasoningLevel;
-    policy: LimitType;
-    downgrade?: EntitlementDowngradeHint;
-}
-interface MeterSummary {
-    /** Always numeric. Check the `unlimited` flag to detect unbounded meters. */
-    remaining: number;
-    limit: number | null;
-    /** Always numeric (0 when no usage recorded). */
-    used: number;
-    /** When true this meter is unbounded; `remaining` is informational only. */
-    unlimited: boolean;
-    /** remaining / limit (0-1). null when unlimited or limit is null/0. */
-    ratio: number | null;
-    label?: string;
-}
-type MeterSnapshot = Record<string, MeterSummary>;
-type RemainingRatios = Record<string, number | null | undefined>;
-interface RollingCallsRateLimitState {
-    windowType: "rolling_calls";
-    limit: number;
-    used: number;
-    remaining: number;
-    windowSeconds: number;
-    state: "fresh" | "estimated" | "stale" | "unknown";
-    source?: "current_rolling_check" | "call_records";
-    nextAvailableAt?: string;
-    scope?: {
-        callType?: "standard" | "API";
-        tier?: "standard" | "premium";
-    };
-}
-interface RateLimitsSnapshot {
-    rollingCalls?: RollingCallsRateLimitState | Record<string, RollingCallsRateLimitState>;
-}
-interface SubscriptionSnapshot {
-    id: string | null;
-    usagePlanVersionId: string | null;
-    planName: string | null;
-    planVersion: string | null;
-    limitType: LimitType;
-    reasoningLevel: ReasoningLevel;
-    lastReplenishedAt: string | null;
-    nextReplenishAt: string | null;
-    subscriptionVersion: number | null;
-    customerFriendlyName?: string | null;
-    customerEmail?: string | null;
-    pending?: {
-        usagePlanVersionId: string | null;
-        strategy: string | null;
-        effectiveAt: string | null;
-    };
-    stripeCustomerId?: string | null;
-}
-type ModelHints = Record<string, string[]>;
-interface IdempotencyMetadata {
-    key: string;
-    source: "explicit" | "derived";
-}
-interface VendorHints {
-    preferredModel?: string;
-    reasoning?: ReasoningLevel;
-    maxInputTokens?: number;
-    maxResponseTokens?: number;
-}
-interface PromptCompressionRequest {
-    callId: string;
-    input?: unknown;
-    text?: string;
-    provider?: "heuristic" | "toon" | "thetokencompany" | "usagetap";
-    model?: string;
-    tokenCompanyModel?: string;
-    /** Provider-neutral compression aggressiveness from 0.0 to 1.0. */
-    aggressiveness?: number;
-    /** @deprecated Use aggressiveness instead. */
-    tokenCompanyAggressiveness?: number;
-    tokenCompanyAppId?: string;
-    usageTapCompressionModel?: string;
-    /** @deprecated Use aggressiveness instead. */
-    usageTapCompressionAggressiveness?: number;
-}
-interface PromptCompressionTelemetry {
-    provider: "heuristic" | "toon" | "thetokencompany" | "usagetap";
-    originalCharacters: number;
-    compressedCharacters: number;
-    savedCharacters: number;
-    originalTokens?: number;
-    compressedTokens?: number;
-    savedTokens?: number;
-    tokenSavingsRatio?: number;
-    savingsRatio: number;
-    techniques: string[];
-}
-interface BeginCallRequest {
-    customerId: string;
-    requested?: RequestedEntitlements;
-    feature?: string;
-    tags?: string[];
-    /**
-     * Optional PAYG hold hint (USD) to authorize upfront during call_begin.
-     * When provided, overrides the plan's default hold for this call only.
-     */
-    holdUsd?: number;
-    /**
-     * Idempotency key for safe retries. When omitted, UsageTap derives a key deterministically.
-     * @deprecated Use idempotencyKey instead
-     */
-    idempotency?: string;
-    /**
-     * Idempotency key for safe retries. When omitted, UsageTap derives a key deterministically.
-     */
-    idempotencyKey?: string;
-    customerName?: string;
-    customerEmail?: string;
-    stripeCustomerId?: string;
-    /**
-     * Whether this call uses batch pricing (typically 50% of standard rates).
-     */
-    batch?: boolean;
-    /**
-     * Explicit pricing mode for this call.
-     */
-    pricingMode?: "batch" | "standard";
-}
-interface BalanceSummary {
-    standardCallsRemaining?: number;
-    premiumCallsRemaining?: number;
-    tokensRemaining?: number;
-    searchesRemaining?: number;
-    audioSecondsRemaining?: number;
-    customMeter1Remaining?: number;
-    customMeter2Remaining?: number;
-}
-type SpendVelocityWindowKey = "hour" | "day";
-interface SpendVelocityWindow {
-    bucket: string;
-    windowMinutes: number;
-    startedAt: string;
-    endedAt: string;
-    completedCostUsd: number;
-    completedCalls: number;
-}
-interface SpendVelocitySnapshot {
-    currency: "USD";
-    source: "usage_aggregate";
-    generatedAt: string;
-    customerId: string;
-    currentCallCostUsd: number;
-    windows: Record<SpendVelocityWindowKey, SpendVelocityWindow>;
-}
-interface PlanSummary {
-    id: string | null;
-    name: string | null;
-    version: string | null;
-}
-interface BeginCallResponseBody {
-    callId: string;
-    startTime: string;
-    feature?: string;
-    tags?: string[];
-    newCustomer: boolean;
-    canceled: boolean;
-    policy: LimitType;
-    allowed: AllowedEntitlements;
-    entitlementHints: EntitlementHints;
-    rateLimits?: RateLimitsSnapshot;
-    meters: MeterSnapshot;
-    remainingRatios: RemainingRatios;
-    subscription: SubscriptionSnapshot;
-    models?: ModelHints;
-    idempotency?: IdempotencyMetadata;
-    vendorHints?: VendorHints;
-    plan?: PlanSummary;
-    balances?: BalanceSummary;
-    stripeCustomerId?: string | null;
-    batch?: boolean;
-    pricingMode?: "batch" | "standard";
-}
-interface EndCallRequest {
-    callId: string;
-    /** Optional customer ID for metric tracking. Not sent to API, used for onUsageMetric callback. */
-    customerId?: string;
-    /** Optional feature for metric tracking. Not sent to API, used for onUsageMetric callback. */
-    feature?: string;
-    /** Optional tags for metric tracking. Not sent to API, used for onUsageMetric callback. */
-    tags?: string[];
-    modelUsed?: string;
-    /**
-     * Total prompt/input tokens for the call (including any cached prompt tokens).
-     */
-    inputTokens?: number;
-    responseTokens?: number;
-    /**
-     * Prompt/input tokens served from cache.
-     * Preferred over legacy aliases.
-     */
-    cachedInputTokens?: number;
-    reasoningTokens?: number;
-    searches?: number;
-    audio?: number;
-    audioSeconds?: number;
-    error?: {
-        code: string;
-        message: string;
-    };
-    stripeCustomerId?: string;
-    /**
-     * Whether this call uses batch pricing (typically 50% of standard rates).
-     */
-    batch?: boolean;
-    /**
-     * Explicit pricing mode for this call.
-     */
-    pricingMode?: "batch" | "standard";
-}
-interface MeteredUsage {
-    calls?: number;
-    tokens?: number;
-    reasoningTokens?: number;
-    searches?: number;
-    audio?: number;
-    audioSeconds?: number;
-}
-interface EndCallResponseBody {
-    callId: string;
-    costUSD: number;
-    usage?: {
-        inputTokens: number;
-        cachedInputTokens: number;
-        billableInputTokens: number;
-        responseTokens: number;
-        reasoningTokens: number;
-    };
-    metered?: MeteredUsage;
-    spendVelocity?: SpendVelocitySnapshot;
-    balances?: BalanceSummary;
-    stripeCustomerId?: string | null;
-    batch?: boolean;
-    pricingMode?: "batch" | "standard";
-}
-type UsageTapResultStatus = "ACCEPTED" | "ERROR";
-interface UsageTapResultEnvelope {
-    status: UsageTapResultStatus;
-    code?: string;
-    message?: string;
-    timestamp?: string;
-}
-interface UsageTapErrorPayload {
-    code: string;
-    message: string;
-    details?: Record<string, unknown>;
-}
-interface UsageTapSuccessResponse<TData> {
-    result: UsageTapResultEnvelope;
-    data: TData;
-    correlationId: string;
-}
-interface UsageTapErrorResponse {
-    result: UsageTapResultEnvelope;
-    error: UsageTapErrorPayload;
-    correlationId: string;
-}
-interface RetryOptions {
-    /**
-     * Maximum number of attempts including the initial try.
-     * @default 3
-     */
-    maxAttempts?: number;
-    /**
-     * Base backoff delay in milliseconds.
-     * @default 250
-     */
-    baseDelayMs?: number;
-    /**
-     * Maximum backoff delay in milliseconds.
-     * @default 5000
-     */
-    maxDelayMs?: number;
-    /**
-     * Jitter ratio between 0 and 1 applied to the computed delay.
-     * @default 0.2
-     */
-    jitterRatio?: number;
-}
-interface UsageTapLogEntry {
-    event: "request:start" | "request:success" | "request:error" | "retry:scheduled" | "retry:exhausted";
-    path: string;
-    attempt: number;
-    elapsedMs?: number;
-    idempotencyKey?: string;
-    correlationId?: string;
-    error?: unknown;
-}
-interface UsageTapClientOptions {
-    /**
-     * UsageTap API key. Defaults to the server-side USAGETAP_API_KEY environment variable.
-     */
-    apiKey?: string;
-    /**
-     * UsageTap API base URL. Defaults to USAGETAP_BASE_URL, then https://api.usagetap.com.
-     */
-    baseUrl?: string;
-    defaultFeature?: string;
-    defaultTags?: string[];
-    fetchImpl?: typeof fetch;
-    headers?: Record<string, string>;
-    retries?: RetryOptions;
-    idempotencyGenerator?: () => string;
-    /**
-     * When true (default), the client auto-generates an idempotency key when one is not provided.
-     * Set to false to rely on the backend's deterministic fallback.
-     */
-    autoIdempotency?: boolean;
-    onLog?: (entry: UsageTapLogEntry) => void;
-    /**
-     * Callback invoked when usage metrics are recorded (call_end, custom_meter).
-     * Use this to export metrics to OpenTelemetry or other observability systems.
-     */
-    onUsageMetric?: (event: UsageMetricEvent) => void;
-    /**
-     * Override the default Authorization header with x-api-key when true.
-     */
-    useApiKeyHeader?: boolean;
-    /**
-     * Allow constructing the client in browser-like environments for testing.
-     */
-    allowBrowser?: boolean;
-    /** API key for The Token Company Bear compression API. */
-    tokenCompanyApiKey?: string;
-    /** Override endpoint for The Token Company compatible compression APIs. */
-    tokenCompanyEndpoint?: string;
-    /** Default model for The Token Company compression. */
-    model?: string;
-    tokenCompanyModel?: string;
-    /** Default compression aggressiveness, from 0.0 to 1.0. */
-    aggressiveness?: number;
-    /** @deprecated Use aggressiveness instead. */
-    tokenCompanyAggressiveness?: number;
-    /** Optional application identifier sent to The Token Company. */
-    tokenCompanyAppId?: string;
-    /** API key for UsageTap prompt compression. Defaults to apiKey when omitted. */
-    usageTapCompressionApiKey?: string;
-    /** Override endpoint for UsageTap-compatible prompt compression APIs. */
-    usageTapCompressionEndpoint?: string;
-    /** Override endpoint for UsageTap-compatible message/request compression APIs. */
-    usageTapCompressionMessagesEndpoint?: string;
-    /** Default model for UsageTap prompt compression. */
-    usageTapCompressionModel?: string;
-    /** @deprecated Use aggressiveness instead. */
-    usageTapCompressionAggressiveness?: number;
-}
-interface RequestOptions {
-    signal?: AbortSignal;
-    headers?: Record<string, string>;
-    retries?: RetryOptions;
-}
-interface PromptCompressionStandaloneOptions {
-    signal?: AbortSignal;
-    provider?: "heuristic" | "toon" | "thetokencompany" | "usagetap";
-    failOpen?: boolean;
-    model?: string;
-    tokenCompanyModel?: string;
-    /** Provider-neutral compression aggressiveness from 0.0 to 1.0. */
-    aggressiveness?: number;
-    /** @deprecated Use aggressiveness instead. */
-    tokenCompanyAggressiveness?: number;
-    tokenCompanyAppId?: string;
-    usageTapCompressionModel?: string;
-    /** @deprecated Use aggressiveness instead. */
-    usageTapCompressionAggressiveness?: number;
-}
-type PromptCompressionMessageRole$1 = "system" | "user" | "tool" | "assistant";
-type PromptCompressionRoleAggressiveness$1 = Partial<Record<PromptCompressionMessageRole$1, number>>;
-type PromptCompressionMessagesAggressiveness$1 = number | PromptCompressionRoleAggressiveness$1;
-interface PromptCompressionMessagesOptions extends RequestOptions {
-    provider?: "usagetap";
-    failOpen?: boolean;
-    /** Provider-neutral scalar or per-role compression aggressiveness. */
-    aggressiveness?: PromptCompressionMessagesAggressiveness$1;
-    /** @deprecated Use aggressiveness instead. */
-    usageTapCompressionAggressiveness?: PromptCompressionMessagesAggressiveness$1;
-}
-interface RecordPromptCompressionRequest {
-    callId: string;
-    promptCompression: PromptCompressionTelemetry;
-}
-interface BeginCallOptions extends RequestOptions {
-    correlationId?: string;
-}
-interface EndCallOptions extends RequestOptions {
-    correlationId?: string;
-}
-interface PromptCompressionOptions extends RequestOptions {
-    correlationId?: string;
-}
-interface PromptCompressionResponseBody extends PromptCompressionTelemetry {
-    callId: string;
-    updated: boolean;
-}
-interface WithUsageContext {
-    begin: UsageTapSuccessResponse<BeginCallResponseBody>;
-    setUsage: (usage: Partial<Omit<EndCallRequest, "callId" | "error">>) => void;
-    setError: (error: EndCallRequest["error"]) => void;
-}
-interface WithUsageOptions {
-    signal?: AbortSignal;
-    headers?: Record<string, string>;
-    retries?: RetryOptions;
-    correlationId?: string;
-    /**
-     * Default error payload applied when the handler throws and setError was never invoked.
-     */
-    defaultErrorCode?: string;
-}
-interface CheckUsageRequest {
-    customerId: string;
-}
-interface CheckUsageOptions extends RequestOptions {
-    correlationId?: string;
-}
-interface CheckUsageResponseBody {
-    customerId: string;
-    canceled: boolean;
-    policy: LimitType;
-    allowed: AllowedEntitlements;
-    entitlementHints: EntitlementHints;
-    rateLimits?: RateLimitsSnapshot;
-    meters: MeterSnapshot;
-    remainingRatios: RemainingRatios;
-    subscription: SubscriptionSnapshot;
-    models?: ModelHints;
-    plan?: PlanSummary;
-    balances?: BalanceSummary;
-    stripeCustomerId?: string | null;
-}
-interface CreateCustomerRequest {
-    customerId: string;
-    customerFriendlyName?: string;
-    customerName?: string;
-    customerEmail?: string;
-    stripeCustomerId?: string;
-}
-interface CreateCustomerOptions extends RequestOptions {
-    correlationId?: string;
-    idempotencyKey?: string;
-}
-interface CreateCustomerResponseBody extends CheckUsageResponseBody {
-    newCustomer: boolean;
-}
-type ChangePlanStrategy = "IMMEDIATE_RESET" | "IMMEDIATE_PRORATED" | "AT_NEXT_REPLENISH";
-interface ChangePlanRequest {
-    customerId: string;
-    planId: string;
-    strategy?: ChangePlanStrategy;
-}
-interface ChangePlanOptions extends RequestOptions {
-    correlationId?: string;
-    idempotencyKey?: string;
-}
-interface ChangePlanResponseBody {
-    success: boolean;
-    subscription: SubscriptionSnapshot;
-}
-type CustomMeterSlot = "CUSTOM1" | "CUSTOM2";
-interface IncrementCustomMeterRequest {
-    customerId: string;
-    meterSlot: CustomMeterSlot;
-    amount: number;
-    feature?: string;
-    tags?: string[];
-    metadata?: Record<string, unknown>;
-}
-interface IncrementCustomMeterOptions extends RequestOptions {
-    correlationId?: string;
-    idempotencyKey?: string;
-}
-interface IncrementCustomMeterResponseBody {
-    success: boolean;
-    eventId: string;
-    meterSlot: CustomMeterSlot;
-    amount: number;
-    meter: MeterSummary;
-    blocked: boolean;
-}
-/**
- * Event emitted when usage metrics are recorded.
- * Use with `onUsageMetric` callback to export to OpenTelemetry or other observability systems.
- */
-interface UsageMetricEvent {
-    /** Type of metric event */
-    type: "call_end" | "custom_meter";
-    /** Timestamp in ISO 8601 format */
-    timestamp: string;
-    /** Customer identifier */
-    customerId: string;
-    /** Unique call identifier (for call_end events) */
-    callId?: string;
-    /** Feature tag */
-    feature?: string;
-    /** Additional tags */
-    tags?: string[];
-    /** Model used for the call */
-    modelUsed?: string;
-    /** Usage metrics */
-    metrics: {
-        inputTokens?: number;
-        cachedInputTokens?: number;
-        responseTokens?: number;
-        reasoningTokens?: number;
-        searches?: number;
-        audioSeconds?: number;
-        costUsd?: number;
-        /** Custom meter slot (for custom_meter events) */
-        customMeterSlot?: CustomMeterSlot;
-        /** Custom meter amount (for custom_meter events) */
-        customMeterAmount?: number;
-    };
-    /** Correlation ID for tracing */
-    correlationId?: string;
-}
-
-type PromptCompressionProvider = "heuristic" | "toon" | "thetokencompany" | "usagetap";
-type PromptCompressionMessageRole = "system" | "user" | "tool" | "assistant";
-type PromptCompressionRoleAggressiveness = Partial<Record<PromptCompressionMessageRole, number>>;
-type PromptCompressionMessagesAggressiveness = number | PromptCompressionRoleAggressiveness;
-interface PromptCompressionInput {
-    input?: unknown;
-    text?: string;
-    provider?: PromptCompressionProvider;
-    tokenCompanyApiKey?: string;
-    tokenCompanyEndpoint?: string;
-    model?: string;
-    tokenCompanyModel?: string;
-    aggressiveness?: number;
-    tokenCompanyAggressiveness?: number;
-    tokenCompanyAppId?: string;
-    usageTapCompressionApiKey?: string;
-    usageTapCompressionEndpoint?: string;
-    usageTapCompressionModel?: string;
-    usageTapCompressionAggressiveness?: number;
-    fetchImpl?: typeof fetch;
-    signal?: AbortSignal;
-    failOpen?: boolean;
-}
-interface PromptCompressionMessagesInput<TInput = unknown> {
-    input: TInput;
-    provider?: Extract<PromptCompressionProvider, "usagetap">;
-    usageTapCompressionApiKey?: string;
-    usageTapCompressionMessagesEndpoint?: string;
-    aggressiveness?: PromptCompressionMessagesAggressiveness;
-    usageTapCompressionAggressiveness?: PromptCompressionMessagesAggressiveness;
-    fetchImpl?: typeof fetch;
-    signal?: AbortSignal;
-    failOpen?: boolean;
-}
-interface PromptCompressionResult<TInput = unknown> {
-    input: TInput;
-    compressedInput: unknown;
-    provider: PromptCompressionProvider;
-    originalCharacters: number;
-    compressedCharacters: number;
-    savedCharacters: number;
-    originalTokens: number;
-    compressedTokens: number;
-    savedTokens: number;
-    tokenSavingsRatio: number;
-    savingsRatio: number;
-    techniques: string[];
-}
-declare function protectPromptText(text: string): string;
-declare const protect: typeof protectPromptText;
-declare function compressPrompt<TInput = unknown>(options: PromptCompressionInput): Promise<PromptCompressionResult<TInput>>;
-declare function compressPromptHeuristic<TInput = unknown>(input: TInput): PromptCompressionResult<TInput>;
-declare function compressPromptToon<TInput = unknown>(input: TInput): PromptCompressionResult<TInput>;
-declare function compressPromptMessages<TInput = unknown>(options: PromptCompressionMessagesInput<TInput>): Promise<PromptCompressionResult<TInput>>;
-declare function estimatePromptTokens(input: unknown): number;
-
-type UsageTapCompressOptions = Omit<PromptCompressionStandaloneOptions, "provider">;
-type UsageTapCompressResult = Omit<PromptCompressionResult<string>, "compressedInput"> & {
-    /** The compressed text, ready to pass to an LLM. */
-    output: string;
-    /** Alias retained for consistency with the lower-level compression APIs. */
-    compressedInput: string;
-};
-type MeterRequest = string | BeginCallRequest;
-declare class UsageTapClient {
-    private readonly apiKey;
-    private readonly baseUrl;
-    private readonly fetchImpl;
-    private readonly defaultFeature?;
-    private readonly defaultTags?;
-    private readonly defaultHeaders;
-    private readonly retryDefaults;
-    private readonly idempotencyGenerator;
-    private readonly logFn?;
-    private readonly metricFn?;
-    private readonly authHeader;
-    private readonly autoIdempotency;
-    private readonly tokenCompanyApiKey?;
-    private readonly tokenCompanyEndpoint?;
-    private readonly model?;
-    private readonly tokenCompanyModel?;
-    private readonly aggressiveness?;
-    private readonly tokenCompanyAggressiveness?;
-    private readonly tokenCompanyAppId?;
-    private readonly usageTapCompressionApiKey?;
-    private readonly usageTapCompressionEndpoint?;
-    private readonly usageTapCompressionMessagesEndpoint?;
-    private readonly usageTapCompressionModel?;
-    private readonly usageTapCompressionAggressiveness?;
-    constructor(options?: UsageTapClientOptions);
-    beginCall(request: BeginCallRequest, options?: BeginCallOptions): Promise<UsageTapSuccessResponse<BeginCallResponseBody>>;
-    promptCompress(request: PromptCompressionRequest, options?: PromptCompressionOptions): Promise<PromptCompressionResult & {
-        callId: string;
-    }>;
-    compressPromptInput<TInput = unknown>(input: TInput, options?: PromptCompressionStandaloneOptions): Promise<PromptCompressionResult<TInput>>;
-    /**
-     * Compress text with UsageTap's hosted compression service.
-     *
-     * This is the short, standalone path. It does not create a metered call and
-     * fails open to the original text unless failOpen is explicitly disabled.
-     */
-    compress(text: string, options?: UsageTapCompressOptions): Promise<UsageTapCompressResult>;
-    compressPromptMessages<TInput = unknown>(input: TInput, options?: PromptCompressionMessagesOptions): Promise<PromptCompressionResult<TInput>>;
-    recordPromptCompression(request: RecordPromptCompressionRequest, options?: PromptCompressionOptions): Promise<UsageTapSuccessResponse<PromptCompressionResponseBody>>;
-    endCall(request: EndCallRequest, options?: EndCallOptions): Promise<UsageTapSuccessResponse<EndCallResponseBody>>;
-    checkUsage(request: CheckUsageRequest, options?: CheckUsageOptions): Promise<UsageTapSuccessResponse<CheckUsageResponseBody>>;
-    createCustomer(request: CreateCustomerRequest, options?: CreateCustomerOptions): Promise<UsageTapSuccessResponse<CreateCustomerResponseBody>>;
-    changePlan(request: ChangePlanRequest, options?: ChangePlanOptions): Promise<UsageTapSuccessResponse<ChangePlanResponseBody>>;
-    incrementCustomMeter(request: IncrementCustomMeterRequest, options?: IncrementCustomMeterOptions): Promise<UsageTapSuccessResponse<IncrementCustomMeterResponseBody>>;
-    withUsage<T>(beginRequest: BeginCallRequest, handler: (context: WithUsageContext) => Promise<T>, options?: WithUsageOptions): Promise<T>;
-    /**
-     * Meter one operation. Pass only a customer ID for the common path, or the
-     * existing begin-call request object when feature, tags, or entitlements are needed.
-     */
-    meter<T>(request: MeterRequest, handler: (context: WithUsageContext) => Promise<T>, options?: WithUsageOptions): Promise<T>;
-    private toPromptCompressionTelemetry;
-    private request;
-    private requestGet;
-    private performFetch;
-    private composeHeaders;
-    private log;
-    private emitUsageMetric;
-    private mergeTags;
-    private shouldRetry;
-    private toHttpError;
-    private toApiError;
-}
-
-export { type PlanSummary as $, type CheckUsageOptions as A, type BeginCallRequest as B, type CreateCustomerOptions as C, type CheckUsageRequest as D, type EndCallRequest as E, type CheckUsageResponseBody as F, type ChangePlanOptions as G, type ChangePlanRequest as H, type ChangePlanResponseBody as I, type ChangePlanStrategy as J, type IncrementCustomMeterOptions as K, type IncrementCustomMeterRequest as L, type MeterRequest as M, type IncrementCustomMeterResponseBody as N, type CustomMeterSlot as O, type PromptCompressionProvider as P, type EndCallOptions as Q, type RecordPromptCompressionRequest as R, type EndCallResponseBody as S, type BalanceSummary as T, UsageTapClient as U, type VendorHints as V, type WithUsageOptions as W, type SpendVelocitySnapshot as X, type SpendVelocityWindow as Y, type SpendVelocityWindowKey as Z, type EntitlementHints as _, type PromptCompressionTelemetry as a, type MeterSummary as a0, type MeterSnapshot as a1, type MeteredUsage as a2, type RateLimitsSnapshot as a3, type RemainingRatios as a4, type RollingCallsRateLimitState as a5, type RequestedEntitlements as a6, type AllowedEntitlements as a7, type RetryOptions as a8, type UsageTapClientOptions as a9, type UsageTapErrorResponse as aa, type UsageTapResultEnvelope as ab, type UsageTapResultStatus as ac, type UsageTapLogEntry as ad, type WithUsageContext as ae, type LimitType as af, type SubscriptionSnapshot as ag, type ModelHints as ah, type IdempotencyMetadata as ai, type UsageMetricEvent as aj, type UsageTapSuccessResponse as b, type BeginCallResponseBody as c, type UsageTapCompressOptions as d, type UsageTapCompressResult as e, compressPrompt as f, compressPromptMessages as g, compressPromptHeuristic as h, compressPromptToon as i, estimatePromptTokens as j, protectPromptText as k, type PromptCompressionInput as l, type PromptCompressionMessagesAggressiveness as m, type PromptCompressionMessagesInput as n, type PromptCompressionMessageRole as o, protect as p, type PromptCompressionResult as q, type PromptCompressionRoleAggressiveness as r, type BeginCallOptions as s, type PromptCompressionRequest as t, type PromptCompressionOptions as u, type PromptCompressionMessagesOptions as v, type PromptCompressionResponseBody as w, type PromptCompressionStandaloneOptions as x, type CreateCustomerRequest as y, type CreateCustomerResponseBody as z };