@usagetap/sdk 1.3.2 → 1.4.0

package/dist/adapters/anthropic.d.cts

@@ -1,4 +1,4 @@
-import { B as BeginCallRequest, P as PromptCompressionProvider, a as PromptCompressionTelemetry, U as UsageTapClient, W as WithUsageOptions } from '../client-BD8O2J8Z.cjs';
+import { B as BeginCallRequest, P as PromptCompressionProvider, a as PromptCompressionMode, b as PromptCompressionTelemetry, S as SamplingOptions, U as UsageTapClient, W as WithUsageOptions } from '../client-CExQ8e1T.cjs';
 
 type WrapAnthropicContext = BeginCallRequest;
 type AnthropicPromptCompressionRole = "system" | "user" | "tool" | "assistant";
@@ -25,6 +25,14 @@ interface AnthropicPromptCompressionOptions {
     /** Minimum estimated tokens for each individual text segment. */
     minTokens?: number;
     failOpen?: boolean;
+    /** Select deterministic-only, automatic model gating, or a forced model pass. */
+    mode?: PromptCompressionMode;
+    /** Maximum compression latency the service should target. */
+    latencyBudgetMs?: number;
+    /** Remove empty user messages before compression. */
+    compactEmptyUserMessages?: boolean;
+    /** Deduplicate repeated text parts within user messages. */
+    compactDuplicateUserTextParts?: boolean;
     tokenCompanyModel?: string;
     aggressiveness?: number | Partial<Record<AnthropicPromptCompressionRole, number>>;
     /** @deprecated Use aggressiveness instead. */
@@ -41,7 +49,13 @@ interface AnthropicPromptCompressionFailure {
     message: string;
     timestamp: number;
 }
-interface AnthropicPromptCompressionTurnStats extends PromptCompressionTelemetry {
+interface PromptCompressionTelemetryWithDiagnostics extends PromptCompressionTelemetry {
+    originalCharacters: number;
+    compressedCharacters: number;
+    savedCharacters: number;
+    savingsRatio: number;
+}
+interface AnthropicPromptCompressionTurnStats extends PromptCompressionTelemetryWithDiagnostics {
     callId: string;
     operation: "messages.create";
     messagesCompressed: number;
@@ -68,13 +82,37 @@ interface WrapAnthropicOptions {
     defaultContext?: Partial<WrapAnthropicContext>;
     applyVendorHints?: boolean;
     promptCompression?: boolean | AnthropicPromptCompressionOptions;
+    /** Retain eligible metered calls with an exact link to their UsageTap call. */
+    sampling?: MeteredAnthropicSamplingOptions | true;
 }
 interface AnthropicCompressionOptions extends AnthropicPromptCompressionOptions {
     /** UsageTap API key. Defaults to USAGETAP_API_KEY. */
     apiKey?: string;
     /** Reuse an existing client when custom transport or endpoints are configured. */
     usageTapClient?: UsageTapClient;
+    /** Also retain eligible calls after the provider responds. */
+    sampling?: SamplingOptions | true;
+}
+type AnthropicSamplingOptions = Partial<SamplingOptions> & {
+    apiKey?: string;
+    usageTapClient?: UsageTapClient;
+};
+type MeteredAnthropicSamplingOptions = Partial<SamplingOptions>;
+interface AnthropicSamplingContext {
+    customerId?: string;
+    feature?: string;
+    environment?: string;
+    tags?: string[];
 }
+type SamplingAnthropicCreate<TCreate> = TCreate extends (params: infer TParams, options?: infer TOptions) => infer TReturn ? (params: TParams, options?: TOptions & {
+    usageTap?: AnthropicSamplingContext;
+}) => TReturn : never;
+type SamplingWrappedAnthropic<TClient extends AnthropicClientLike = AnthropicClientLike> = Omit<TClient, "messages"> & {
+    messages: Omit<TClient["messages"], "create"> & {
+        create: SamplingAnthropicCreate<TClient["messages"]["create"]>;
+    };
+    unwrap: () => TClient;
+};
 type WithMeteringAnthropicOptions = BeginCallRequest & {
     /** UsageTap API key. Defaults to USAGETAP_API_KEY. */
     apiKey?: string;
@@ -82,6 +120,8 @@ type WithMeteringAnthropicOptions = BeginCallRequest & {
     usageTapClient?: UsageTapClient;
     applyVendorHints?: boolean;
     promptCompression?: boolean | AnthropicPromptCompressionOptions;
+    /** Retain eligible calls using the same ID as the metered UsageTap call. */
+    sampling?: MeteredAnthropicSamplingOptions | true;
 };
 interface WrapAnthropicCallOptions {
     usageTap?: Partial<WrapAnthropicContext>;
@@ -109,10 +149,12 @@ type CompressionWrappedAnthropic<TClient extends AnthropicClientLike = Anthropic
     unwrap: () => TClient;
 };
 type AnthropicMessagesCreateParams = Record<string, unknown>;
+/** Retain locally-selected Anthropic calls without changing call sites. */
+declare function withSampling<TClient extends AnthropicClientLike>(client: TClient, options?: AnthropicSamplingOptions): SamplingWrappedAnthropic<TClient>;
 /** Add hosted prompt compression while preserving the Anthropic client API. */
 declare function withCompression<TClient extends AnthropicClientLike>(client: TClient, options?: AnthropicCompressionOptions): CompressionWrappedAnthropic<TClient>;
 /** Add UsageTap metering while preserving the Anthropic client API. */
 declare function withMetering<TClient extends AnthropicClientLike>(client: TClient, customer: string | WithMeteringAnthropicOptions): WrappedAnthropic<TClient>;
 declare function wrapAnthropic<TClient extends AnthropicClientLike>(client: TClient, usageTap: UsageTapClient, options?: WrapAnthropicOptions): WrappedAnthropic<TClient>;
 
-export { type AnthropicClientLike, type AnthropicCompressionOptions, type AnthropicPromptCompressionFailure, type AnthropicPromptCompressionOptions, type AnthropicPromptCompressionRole, type AnthropicPromptCompressionRoleOptions, type AnthropicPromptCompressionRoleSetting, AnthropicPromptCompressionStats, type AnthropicPromptCompressionTurnStats, type CompressionWrappedAnthropic, type WithMeteringAnthropicOptions, type WrapAnthropicCallOptions, type WrapAnthropicContext, type WrapAnthropicOptions, type WrappedAnthropic, withCompression, withMetering, wrapAnthropic };
+export { type AnthropicClientLike, type AnthropicCompressionOptions, type AnthropicPromptCompressionFailure, type AnthropicPromptCompressionOptions, type AnthropicPromptCompressionRole, type AnthropicPromptCompressionRoleOptions, type AnthropicPromptCompressionRoleSetting, AnthropicPromptCompressionStats, type AnthropicPromptCompressionTurnStats, type AnthropicSamplingContext, type AnthropicSamplingOptions, type CompressionWrappedAnthropic, type MeteredAnthropicSamplingOptions, type SamplingWrappedAnthropic, type WithMeteringAnthropicOptions, type WrapAnthropicCallOptions, type WrapAnthropicContext, type WrapAnthropicOptions, type WrappedAnthropic, withCompression, withMetering, withSampling, wrapAnthropic };

package/dist/adapters/anthropic.d.ts

@@ -1,4 +1,4 @@
-import { B as BeginCallRequest, P as PromptCompressionProvider, a as PromptCompressionTelemetry, U as UsageTapClient, W as WithUsageOptions } from '../client-BD8O2J8Z.js';
+import { B as BeginCallRequest, P as PromptCompressionProvider, a as PromptCompressionMode, b as PromptCompressionTelemetry, S as SamplingOptions, U as UsageTapClient, W as WithUsageOptions } from '../client-CExQ8e1T.js';
 
 type WrapAnthropicContext = BeginCallRequest;
 type AnthropicPromptCompressionRole = "system" | "user" | "tool" | "assistant";
@@ -25,6 +25,14 @@ interface AnthropicPromptCompressionOptions {
     /** Minimum estimated tokens for each individual text segment. */
     minTokens?: number;
     failOpen?: boolean;
+    /** Select deterministic-only, automatic model gating, or a forced model pass. */
+    mode?: PromptCompressionMode;
+    /** Maximum compression latency the service should target. */
+    latencyBudgetMs?: number;
+    /** Remove empty user messages before compression. */
+    compactEmptyUserMessages?: boolean;
+    /** Deduplicate repeated text parts within user messages. */
+    compactDuplicateUserTextParts?: boolean;
     tokenCompanyModel?: string;
     aggressiveness?: number | Partial<Record<AnthropicPromptCompressionRole, number>>;
     /** @deprecated Use aggressiveness instead. */
@@ -41,7 +49,13 @@ interface AnthropicPromptCompressionFailure {
     message: string;
     timestamp: number;
 }
-interface AnthropicPromptCompressionTurnStats extends PromptCompressionTelemetry {
+interface PromptCompressionTelemetryWithDiagnostics extends PromptCompressionTelemetry {
+    originalCharacters: number;
+    compressedCharacters: number;
+    savedCharacters: number;
+    savingsRatio: number;
+}
+interface AnthropicPromptCompressionTurnStats extends PromptCompressionTelemetryWithDiagnostics {
     callId: string;
     operation: "messages.create";
     messagesCompressed: number;
@@ -68,13 +82,37 @@ interface WrapAnthropicOptions {
     defaultContext?: Partial<WrapAnthropicContext>;
     applyVendorHints?: boolean;
     promptCompression?: boolean | AnthropicPromptCompressionOptions;
+    /** Retain eligible metered calls with an exact link to their UsageTap call. */
+    sampling?: MeteredAnthropicSamplingOptions | true;
 }
 interface AnthropicCompressionOptions extends AnthropicPromptCompressionOptions {
     /** UsageTap API key. Defaults to USAGETAP_API_KEY. */
     apiKey?: string;
     /** Reuse an existing client when custom transport or endpoints are configured. */
     usageTapClient?: UsageTapClient;
+    /** Also retain eligible calls after the provider responds. */
+    sampling?: SamplingOptions | true;
+}
+type AnthropicSamplingOptions = Partial<SamplingOptions> & {
+    apiKey?: string;
+    usageTapClient?: UsageTapClient;
+};
+type MeteredAnthropicSamplingOptions = Partial<SamplingOptions>;
+interface AnthropicSamplingContext {
+    customerId?: string;
+    feature?: string;
+    environment?: string;
+    tags?: string[];
 }
+type SamplingAnthropicCreate<TCreate> = TCreate extends (params: infer TParams, options?: infer TOptions) => infer TReturn ? (params: TParams, options?: TOptions & {
+    usageTap?: AnthropicSamplingContext;
+}) => TReturn : never;
+type SamplingWrappedAnthropic<TClient extends AnthropicClientLike = AnthropicClientLike> = Omit<TClient, "messages"> & {
+    messages: Omit<TClient["messages"], "create"> & {
+        create: SamplingAnthropicCreate<TClient["messages"]["create"]>;
+    };
+    unwrap: () => TClient;
+};
 type WithMeteringAnthropicOptions = BeginCallRequest & {
     /** UsageTap API key. Defaults to USAGETAP_API_KEY. */
     apiKey?: string;
@@ -82,6 +120,8 @@ type WithMeteringAnthropicOptions = BeginCallRequest & {
     usageTapClient?: UsageTapClient;
     applyVendorHints?: boolean;
     promptCompression?: boolean | AnthropicPromptCompressionOptions;
+    /** Retain eligible calls using the same ID as the metered UsageTap call. */
+    sampling?: MeteredAnthropicSamplingOptions | true;
 };
 interface WrapAnthropicCallOptions {
     usageTap?: Partial<WrapAnthropicContext>;
@@ -109,10 +149,12 @@ type CompressionWrappedAnthropic<TClient extends AnthropicClientLike = Anthropic
     unwrap: () => TClient;
 };
 type AnthropicMessagesCreateParams = Record<string, unknown>;
+/** Retain locally-selected Anthropic calls without changing call sites. */
+declare function withSampling<TClient extends AnthropicClientLike>(client: TClient, options?: AnthropicSamplingOptions): SamplingWrappedAnthropic<TClient>;
 /** Add hosted prompt compression while preserving the Anthropic client API. */
 declare function withCompression<TClient extends AnthropicClientLike>(client: TClient, options?: AnthropicCompressionOptions): CompressionWrappedAnthropic<TClient>;
 /** Add UsageTap metering while preserving the Anthropic client API. */
 declare function withMetering<TClient extends AnthropicClientLike>(client: TClient, customer: string | WithMeteringAnthropicOptions): WrappedAnthropic<TClient>;
 declare function wrapAnthropic<TClient extends AnthropicClientLike>(client: TClient, usageTap: UsageTapClient, options?: WrapAnthropicOptions): WrappedAnthropic<TClient>;
 
-export { type AnthropicClientLike, type AnthropicCompressionOptions, type AnthropicPromptCompressionFailure, type AnthropicPromptCompressionOptions, type AnthropicPromptCompressionRole, type AnthropicPromptCompressionRoleOptions, type AnthropicPromptCompressionRoleSetting, AnthropicPromptCompressionStats, type AnthropicPromptCompressionTurnStats, type CompressionWrappedAnthropic, type WithMeteringAnthropicOptions, type WrapAnthropicCallOptions, type WrapAnthropicContext, type WrapAnthropicOptions, type WrappedAnthropic, withCompression, withMetering, wrapAnthropic };
+export { type AnthropicClientLike, type AnthropicCompressionOptions, type AnthropicPromptCompressionFailure, type AnthropicPromptCompressionOptions, type AnthropicPromptCompressionRole, type AnthropicPromptCompressionRoleOptions, type AnthropicPromptCompressionRoleSetting, AnthropicPromptCompressionStats, type AnthropicPromptCompressionTurnStats, type AnthropicSamplingContext, type AnthropicSamplingOptions, type CompressionWrappedAnthropic, type MeteredAnthropicSamplingOptions, type SamplingWrappedAnthropic, type WithMeteringAnthropicOptions, type WrapAnthropicCallOptions, type WrapAnthropicContext, type WrapAnthropicOptions, type WrappedAnthropic, withCompression, withMetering, withSampling, wrapAnthropic };