@usagetap/sdk 1.1.0 → 1.3.1

package/dist/{client-BA-QlnRq.d.cts → client-BD8O2J8Z.d.cts}

@@ -83,14 +83,22 @@ interface VendorHints {
 }
 interface PromptCompressionRequest {
     callId: string;
-    input: unknown;
-    provider?: "heuristic" | "toon" | "thetokencompany";
+    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";
+    provider: "heuristic" | "toon" | "thetokencompany" | "usagetap";
     originalCharacters: number;
     compressedCharacters: number;
     savedCharacters: number;
@@ -302,8 +310,14 @@ interface UsageTapLogEntry {
     error?: unknown;
 }
 interface UsageTapClientOptions {
-    apiKey: string;
-    baseUrl: string;
+    /**
+     * 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;
@@ -334,11 +348,24 @@ interface UsageTapClientOptions {
     /** Override endpoint for The Token Company compatible compression APIs. */
     tokenCompanyEndpoint?: string;
     /** Default model for The Token Company compression. */
+    model?: string;
     tokenCompanyModel?: string;
-    /** Default aggressiveness for The Token Company compression, from 0.0 to 1.0. */
+    /** 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;
@@ -347,11 +374,29 @@ interface RequestOptions {
 }
 interface PromptCompressionStandaloneOptions {
     signal?: AbortSignal;
-    provider?: "heuristic" | "toon" | "thetokencompany";
+    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;
@@ -492,15 +537,36 @@ interface UsageMetricEvent {
     correlationId?: string;
 }
 
-type PromptCompressionProvider = "heuristic" | "toon" | "thetokencompany";
+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;
+    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;
@@ -524,8 +590,17 @@ 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;
@@ -541,15 +616,30 @@ declare class UsageTapClient {
     private readonly autoIdempotency;
     private readonly tokenCompanyApiKey?;
     private readonly tokenCompanyEndpoint?;
+    private readonly model?;
     private readonly tokenCompanyModel?;
+    private readonly aggressiveness?;
     private readonly tokenCompanyAggressiveness?;
     private readonly tokenCompanyAppId?;
-    constructor(options: UsageTapClientOptions);
+    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>>;
@@ -557,6 +647,11 @@ declare class UsageTapClient {
     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;
@@ -570,4 +665,4 @@ declare class UsageTapClient {
     private toApiError;
 }
 
-export { type RetryOptions as $, type IncrementCustomMeterResponseBody as A, type BeginCallRequest as B, type CreateCustomerOptions as C, type CustomMeterSlot as D, type EndCallRequest as E, type EndCallOptions as F, type EndCallResponseBody as G, type BalanceSummary as H, type IncrementCustomMeterOptions as I, type SpendVelocityWindow as J, type SpendVelocityWindowKey as K, type EntitlementHints as L, type PlanSummary as M, type MeterSummary as N, type MeterSnapshot as O, type PromptCompressionProvider as P, type MeteredUsage as Q, type RecordPromptCompressionRequest as R, type SpendVelocitySnapshot as S, type RateLimitsSnapshot as T, UsageTapClient as U, type VendorHints as V, type WithUsageOptions as W, type RemainingRatios as X, type RollingCallsRateLimitState as Y, type RequestedEntitlements as Z, type AllowedEntitlements as _, type PromptCompressionTelemetry as a, type UsageTapClientOptions as a0, type UsageTapErrorResponse as a1, type UsageTapResultEnvelope as a2, type UsageTapResultStatus as a3, type UsageTapLogEntry as a4, type WithUsageContext as a5, type LimitType as a6, type SubscriptionSnapshot as a7, type ModelHints as a8, type IdempotencyMetadata as a9, type UsageMetricEvent as aa, type UsageTapSuccessResponse as b, type BeginCallResponseBody as c, compressPrompt as d, compressPromptHeuristic as e, compressPromptToon as f, estimatePromptTokens as g, protectPromptText as h, type PromptCompressionInput as i, type PromptCompressionResult as j, type BeginCallOptions as k, type PromptCompressionRequest as l, type PromptCompressionOptions as m, type PromptCompressionResponseBody as n, type PromptCompressionStandaloneOptions as o, protect as p, type CreateCustomerRequest as q, type CreateCustomerResponseBody as r, type CheckUsageOptions as s, type CheckUsageRequest as t, type CheckUsageResponseBody as u, type ChangePlanOptions as v, type ChangePlanRequest as w, type ChangePlanResponseBody as x, type ChangePlanStrategy as y, type IncrementCustomMeterRequest as z };
+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 };

package/dist/{client-BA-QlnRq.d.ts → client-BD8O2J8Z.d.ts}

@@ -83,14 +83,22 @@ interface VendorHints {
 }
 interface PromptCompressionRequest {
     callId: string;
-    input: unknown;
-    provider?: "heuristic" | "toon" | "thetokencompany";
+    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";
+    provider: "heuristic" | "toon" | "thetokencompany" | "usagetap";
     originalCharacters: number;
     compressedCharacters: number;
     savedCharacters: number;
@@ -302,8 +310,14 @@ interface UsageTapLogEntry {
     error?: unknown;
 }
 interface UsageTapClientOptions {
-    apiKey: string;
-    baseUrl: string;
+    /**
+     * 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;
@@ -334,11 +348,24 @@ interface UsageTapClientOptions {
     /** Override endpoint for The Token Company compatible compression APIs. */
     tokenCompanyEndpoint?: string;
     /** Default model for The Token Company compression. */
+    model?: string;
     tokenCompanyModel?: string;
-    /** Default aggressiveness for The Token Company compression, from 0.0 to 1.0. */
+    /** 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;
@@ -347,11 +374,29 @@ interface RequestOptions {
 }
 interface PromptCompressionStandaloneOptions {
     signal?: AbortSignal;
-    provider?: "heuristic" | "toon" | "thetokencompany";
+    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;
@@ -492,15 +537,36 @@ interface UsageMetricEvent {
     correlationId?: string;
 }
 
-type PromptCompressionProvider = "heuristic" | "toon" | "thetokencompany";
+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;
+    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;
@@ -524,8 +590,17 @@ 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;
@@ -541,15 +616,30 @@ declare class UsageTapClient {
     private readonly autoIdempotency;
     private readonly tokenCompanyApiKey?;
     private readonly tokenCompanyEndpoint?;
+    private readonly model?;
     private readonly tokenCompanyModel?;
+    private readonly aggressiveness?;
     private readonly tokenCompanyAggressiveness?;
     private readonly tokenCompanyAppId?;
-    constructor(options: UsageTapClientOptions);
+    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>>;
@@ -557,6 +647,11 @@ declare class UsageTapClient {
     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;
@@ -570,4 +665,4 @@ declare class UsageTapClient {
     private toApiError;
 }
 
-export { type RetryOptions as $, type IncrementCustomMeterResponseBody as A, type BeginCallRequest as B, type CreateCustomerOptions as C, type CustomMeterSlot as D, type EndCallRequest as E, type EndCallOptions as F, type EndCallResponseBody as G, type BalanceSummary as H, type IncrementCustomMeterOptions as I, type SpendVelocityWindow as J, type SpendVelocityWindowKey as K, type EntitlementHints as L, type PlanSummary as M, type MeterSummary as N, type MeterSnapshot as O, type PromptCompressionProvider as P, type MeteredUsage as Q, type RecordPromptCompressionRequest as R, type SpendVelocitySnapshot as S, type RateLimitsSnapshot as T, UsageTapClient as U, type VendorHints as V, type WithUsageOptions as W, type RemainingRatios as X, type RollingCallsRateLimitState as Y, type RequestedEntitlements as Z, type AllowedEntitlements as _, type PromptCompressionTelemetry as a, type UsageTapClientOptions as a0, type UsageTapErrorResponse as a1, type UsageTapResultEnvelope as a2, type UsageTapResultStatus as a3, type UsageTapLogEntry as a4, type WithUsageContext as a5, type LimitType as a6, type SubscriptionSnapshot as a7, type ModelHints as a8, type IdempotencyMetadata as a9, type UsageMetricEvent as aa, type UsageTapSuccessResponse as b, type BeginCallResponseBody as c, compressPrompt as d, compressPromptHeuristic as e, compressPromptToon as f, estimatePromptTokens as g, protectPromptText as h, type PromptCompressionInput as i, type PromptCompressionResult as j, type BeginCallOptions as k, type PromptCompressionRequest as l, type PromptCompressionOptions as m, type PromptCompressionResponseBody as n, type PromptCompressionStandaloneOptions as o, protect as p, type CreateCustomerRequest as q, type CreateCustomerResponseBody as r, type CheckUsageOptions as s, type CheckUsageRequest as t, type CheckUsageResponseBody as u, type ChangePlanOptions as v, type ChangePlanRequest as w, type ChangePlanResponseBody as x, type ChangePlanStrategy as y, type IncrementCustomMeterRequest as z };
+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 };

package/dist/express/index.cjs

@@ -495,6 +495,24 @@ async function compressChatParams(params, usageTap, compression, signal) {
   if (!messages) {
     return { params, segments: [] };
   }
+  if (isBelowMinContextTokens(
+    { messages, tools: source.tools },
+    compression.minContextTokens
+  )) {
+    return { params, segments: [] };
+  }
+  if (shouldUseUsageTapMessageEndpoint(compression)) {
+    const result = await usageTap.compressPromptMessages(source, {
+      provider: "usagetap",
+      failOpen: compression.failOpen,
+      aggressiveness: resolveMessageEndpointAggressiveness(compression),
+      signal
+    });
+    return {
+      params: result.compressedInput,
+      segments: [{ role: "user", result }]
+    };
+  }
   const messageResults = await Promise.all(
     messages.map(
       (message) => compressOpenAIMessage(message, usageTap, compression, signal)
@@ -514,6 +532,16 @@ async function compressResponsesParams(params, usageTap, compression, signal) {
   }
   const source = cloneRecord(params);
   const segments = [];
+  if (isBelowMinContextTokens(
+    {
+      instructions: source.instructions,
+      input: source.input,
+      tools: source.tools
+    },
+    compression.minContextTokens
+  )) {
+    return { params, segments };
+  }
   if (typeof source.instructions === "string") {
     const compressed = await compressTextForRole(
       source.instructions,
@@ -718,8 +746,11 @@ async function compressTextForRole(text, role, usageTap, compression, signal) {
     provider: roleOptions.provider,
     failOpen: roleOptions.failOpen,
     tokenCompanyModel: roleOptions.tokenCompanyModel,
+    aggressiveness: roleOptions.aggressiveness,
     tokenCompanyAggressiveness: roleOptions.tokenCompanyAggressiveness,
     tokenCompanyAppId: roleOptions.tokenCompanyAppId,
+    usageTapCompressionModel: roleOptions.usageTapCompressionModel,
+    usageTapCompressionAggressiveness: roleOptions.usageTapCompressionAggressiveness,
     signal
   });
   const compressedText = typeof result.compressedInput === "string" ? result.compressedInput : String(result.compressedInput);
@@ -740,6 +771,9 @@ function normalizePromptCompressionOptions(options) {
   }
   return options;
 }
+function isBelowMinContextTokens(context, minContextTokens) {
+  return typeof minContextTokens === "number" && estimatePromptTokens(context) < Math.max(0, minContextTokens);
+}
 function resolveEffectivePromptCompressionOptions(defaults, override) {
   if (override === false) {
     return void 0;
@@ -778,16 +812,67 @@ function resolveRoleCompressionOptions(compression, role) {
     minTokens: roleOptions?.minTokens ?? compression.minTokens,
     failOpen: compression.failOpen,
     tokenCompanyModel: compression.tokenCompanyModel,
+    aggressiveness: roleOptions?.aggressiveness ?? resolveAggressiveness(compression, role),
     tokenCompanyAggressiveness: roleOptions?.tokenCompanyAggressiveness ?? resolveTokenCompanyAggressiveness(compression, role),
-    tokenCompanyAppId: compression.tokenCompanyAppId
+    tokenCompanyAppId: compression.tokenCompanyAppId,
+    usageTapCompressionModel: compression.usageTapCompressionModel,
+    usageTapCompressionAggressiveness: roleOptions?.usageTapCompressionAggressiveness ?? resolveUsageTapCompressionAggressiveness(compression, role)
   };
 }
+function resolveAggressiveness(compression, role) {
+  if (typeof compression.aggressiveness === "number") {
+    return compression.aggressiveness;
+  }
+  return compression.aggressiveness?.[role];
+}
 function resolveTokenCompanyAggressiveness(compression, role) {
   if (typeof compression.tokenCompanyAggressiveness === "number") {
     return compression.tokenCompanyAggressiveness;
   }
   return compression.tokenCompanyAggressiveness?.[role];
 }
+function resolveUsageTapCompressionAggressiveness(compression, role) {
+  if (typeof compression.usageTapCompressionAggressiveness === "number") {
+    return compression.usageTapCompressionAggressiveness;
+  }
+  return compression.usageTapCompressionAggressiveness?.[role];
+}
+function shouldUseUsageTapMessageEndpoint(compression) {
+  if (compression.provider !== "usagetap") {
+    return false;
+  }
+  return Object.values(compression.roles ?? {}).every((setting) => {
+    if (typeof setting !== "object" || setting === null) {
+      return true;
+    }
+    return setting.provider === void 0 || setting.provider === "usagetap";
+  });
+}
+function resolveMessageEndpointAggressiveness(compression) {
+  const base = compression.aggressiveness ?? compression.usageTapCompressionAggressiveness ?? compression.tokenCompanyAggressiveness;
+  if (typeof base === "number" || base === void 0) {
+    return hasExplicitEnabledRoles(compression) ? buildRoleAggressiveness(compression, base) : base;
+  }
+  return buildRoleAggressiveness(compression, void 0, base);
+}
+function hasExplicitEnabledRoles(compression) {
+  return Object.values(compression.roles ?? {}).some((setting) => setting !== false);
+}
+function buildRoleAggressiveness(compression, fallback, base = {}) {
+  const roles = ["system", "user", "tool", "assistant"];
+  const result = {};
+  for (const role of roles) {
+    const roleOptions = resolveRoleCompressionOptions(compression, role);
+    if (!roleOptions) {
+      continue;
+    }
+    const roleAggressiveness = roleOptions.aggressiveness ?? roleOptions.usageTapCompressionAggressiveness ?? roleOptions.tokenCompanyAggressiveness ?? base[role] ?? fallback;
+    if (roleAggressiveness !== void 0) {
+      result[role] = roleAggressiveness;
+    }
+  }
+  return result;
+}
 function buildPromptCompressionTelemetry(segments) {
   if (!segments.length) {
     return void 0;