@usagetap/sdk 1.0.0 → 1.1.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { U as UsageTapClient, B as BeginCallRequest } from './client-BHNMYvlO.cjs';
-export { T as AllowedEntitlements, D as BalanceSummary, i as BeginCallOptions, b as BeginCallResponseBody, s as ChangePlanOptions, t as ChangePlanRequest, u as ChangePlanResponseBody, v as ChangePlanStrategy, p as CheckUsageOptions, q as CheckUsageRequest, r as CheckUsageResponseBody, C as CreateCustomerOptions, n as CreateCustomerRequest, o as CreateCustomerResponseBody, y as CustomMeterSlot, z as EndCallOptions, E as EndCallRequest, A as EndCallResponseBody, H as EntitlementHints, a5 as IdempotencyMetadata, I as IncrementCustomMeterOptions, w as IncrementCustomMeterRequest, x as IncrementCustomMeterResponseBody, a2 as LimitType, K as MeterSnapshot, M as MeterSummary, L as MeteredUsage, a4 as ModelHints, J as PlanSummary, P as PromptCompressionInput, k as PromptCompressionOptions, g as PromptCompressionProvider, j as PromptCompressionRequest, l as PromptCompressionResponseBody, h as PromptCompressionResult, m as PromptCompressionTelemetry, R as RateLimitsSnapshot, N as RemainingRatios, Q as RequestedEntitlements, X as RetryOptions, O as RollingCallsRateLimitState, S as SpendVelocitySnapshot, F as SpendVelocityWindow, G as SpendVelocityWindowKey, a3 as SubscriptionSnapshot, a6 as UsageMetricEvent, Y as UsageTapClientOptions, Z as UsageTapErrorResponse, a0 as UsageTapLogEntry, _ as UsageTapResultEnvelope, $ as UsageTapResultStatus, a as UsageTapSuccessResponse, V as VendorHints, a1 as WithUsageContext, W as WithUsageOptions, c as compressPrompt, d as compressPromptHeuristic, e as compressPromptToon, f as estimatePromptTokens } from './client-BHNMYvlO.cjs';
+import { U as UsageTapClient, B as BeginCallRequest } from './client-BA-QlnRq.cjs';
+export { _ as AllowedEntitlements, H as BalanceSummary, k as BeginCallOptions, c as BeginCallResponseBody, v as ChangePlanOptions, w as ChangePlanRequest, x as ChangePlanResponseBody, y as ChangePlanStrategy, s as CheckUsageOptions, t as CheckUsageRequest, u as CheckUsageResponseBody, C as CreateCustomerOptions, q as CreateCustomerRequest, r as CreateCustomerResponseBody, D as CustomMeterSlot, F as EndCallOptions, E as EndCallRequest, G as EndCallResponseBody, L as EntitlementHints, a9 as IdempotencyMetadata, I as IncrementCustomMeterOptions, z as IncrementCustomMeterRequest, A as IncrementCustomMeterResponseBody, a6 as LimitType, O as MeterSnapshot, N as MeterSummary, Q as MeteredUsage, a8 as ModelHints, M as PlanSummary, i as PromptCompressionInput, m as PromptCompressionOptions, P as PromptCompressionProvider, l as PromptCompressionRequest, n as PromptCompressionResponseBody, j as PromptCompressionResult, o as PromptCompressionStandaloneOptions, a as PromptCompressionTelemetry, T as RateLimitsSnapshot, R as RecordPromptCompressionRequest, X as RemainingRatios, Z as RequestedEntitlements, $ as RetryOptions, Y as RollingCallsRateLimitState, S as SpendVelocitySnapshot, J as SpendVelocityWindow, K as SpendVelocityWindowKey, a7 as SubscriptionSnapshot, aa as UsageMetricEvent, a0 as UsageTapClientOptions, a1 as UsageTapErrorResponse, a4 as UsageTapLogEntry, a2 as UsageTapResultEnvelope, a3 as UsageTapResultStatus, b as UsageTapSuccessResponse, V as VendorHints, a5 as WithUsageContext, W as WithUsageOptions, d as compressPrompt, e as compressPromptHeuristic, f as compressPromptToon, g as estimatePromptTokens, p as protect, h as protectPromptText } from './client-BA-QlnRq.cjs';
 
 type UsageTapErrorCode = "USAGETAP_BROWSER_RUNTIME" | "USAGETAP_AUTH_ERROR" | "USAGETAP_BAD_REQUEST" | "USAGETAP_INVALID_RESPONSE" | "USAGETAP_NETWORK_ERROR" | "USAGETAP_RATE_LIMITED" | "USAGETAP_SERVER_ERROR" | "USAGETAP_RETRY_EXHAUSTED" | "USAGETAP_END_CALL_ERROR";
 interface UsageTapErrorInit {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { U as UsageTapClient, B as BeginCallRequest } from './client-BHNMYvlO.js';
-export { T as AllowedEntitlements, D as BalanceSummary, i as BeginCallOptions, b as BeginCallResponseBody, s as ChangePlanOptions, t as ChangePlanRequest, u as ChangePlanResponseBody, v as ChangePlanStrategy, p as CheckUsageOptions, q as CheckUsageRequest, r as CheckUsageResponseBody, C as CreateCustomerOptions, n as CreateCustomerRequest, o as CreateCustomerResponseBody, y as CustomMeterSlot, z as EndCallOptions, E as EndCallRequest, A as EndCallResponseBody, H as EntitlementHints, a5 as IdempotencyMetadata, I as IncrementCustomMeterOptions, w as IncrementCustomMeterRequest, x as IncrementCustomMeterResponseBody, a2 as LimitType, K as MeterSnapshot, M as MeterSummary, L as MeteredUsage, a4 as ModelHints, J as PlanSummary, P as PromptCompressionInput, k as PromptCompressionOptions, g as PromptCompressionProvider, j as PromptCompressionRequest, l as PromptCompressionResponseBody, h as PromptCompressionResult, m as PromptCompressionTelemetry, R as RateLimitsSnapshot, N as RemainingRatios, Q as RequestedEntitlements, X as RetryOptions, O as RollingCallsRateLimitState, S as SpendVelocitySnapshot, F as SpendVelocityWindow, G as SpendVelocityWindowKey, a3 as SubscriptionSnapshot, a6 as UsageMetricEvent, Y as UsageTapClientOptions, Z as UsageTapErrorResponse, a0 as UsageTapLogEntry, _ as UsageTapResultEnvelope, $ as UsageTapResultStatus, a as UsageTapSuccessResponse, V as VendorHints, a1 as WithUsageContext, W as WithUsageOptions, c as compressPrompt, d as compressPromptHeuristic, e as compressPromptToon, f as estimatePromptTokens } from './client-BHNMYvlO.js';
+import { U as UsageTapClient, B as BeginCallRequest } from './client-BA-QlnRq.js';
+export { _ as AllowedEntitlements, H as BalanceSummary, k as BeginCallOptions, c as BeginCallResponseBody, v as ChangePlanOptions, w as ChangePlanRequest, x as ChangePlanResponseBody, y as ChangePlanStrategy, s as CheckUsageOptions, t as CheckUsageRequest, u as CheckUsageResponseBody, C as CreateCustomerOptions, q as CreateCustomerRequest, r as CreateCustomerResponseBody, D as CustomMeterSlot, F as EndCallOptions, E as EndCallRequest, G as EndCallResponseBody, L as EntitlementHints, a9 as IdempotencyMetadata, I as IncrementCustomMeterOptions, z as IncrementCustomMeterRequest, A as IncrementCustomMeterResponseBody, a6 as LimitType, O as MeterSnapshot, N as MeterSummary, Q as MeteredUsage, a8 as ModelHints, M as PlanSummary, i as PromptCompressionInput, m as PromptCompressionOptions, P as PromptCompressionProvider, l as PromptCompressionRequest, n as PromptCompressionResponseBody, j as PromptCompressionResult, o as PromptCompressionStandaloneOptions, a as PromptCompressionTelemetry, T as RateLimitsSnapshot, R as RecordPromptCompressionRequest, X as RemainingRatios, Z as RequestedEntitlements, $ as RetryOptions, Y as RollingCallsRateLimitState, S as SpendVelocitySnapshot, J as SpendVelocityWindow, K as SpendVelocityWindowKey, a7 as SubscriptionSnapshot, aa as UsageMetricEvent, a0 as UsageTapClientOptions, a1 as UsageTapErrorResponse, a4 as UsageTapLogEntry, a2 as UsageTapResultEnvelope, a3 as UsageTapResultStatus, b as UsageTapSuccessResponse, V as VendorHints, a5 as WithUsageContext, W as WithUsageOptions, d as compressPrompt, e as compressPromptHeuristic, f as compressPromptToon, g as estimatePromptTokens, p as protect, h as protectPromptText } from './client-BA-QlnRq.js';
 
 type UsageTapErrorCode = "USAGETAP_BROWSER_RUNTIME" | "USAGETAP_AUTH_ERROR" | "USAGETAP_BAD_REQUEST" | "USAGETAP_INVALID_RESPONSE" | "USAGETAP_NETWORK_ERROR" | "USAGETAP_RATE_LIMITED" | "USAGETAP_SERVER_ERROR" | "USAGETAP_RETRY_EXHAUSTED" | "USAGETAP_END_CALL_ERROR";
 interface UsageTapErrorInit {

package/dist/index.mjs

@@ -115,6 +115,13 @@ async function runWithRetry(operation, options, shouldRetry, onSchedule, signal)
 
 // src/prompt-compression.ts
 var DEFAULT_TTC_ENDPOINT = "https://api.thetokencompany.com/v1/compress";
+var DEFAULT_TTC_MODEL = "bear-2";
+var DEFAULT_TTC_AGGRESSIVENESS = 0.2;
+var PROTECTED_TEXT_PATTERN = /<ttc_safe>[\s\S]*?<\/ttc_safe>|<usagetap_safe>[\s\S]*?<\/usagetap_safe>/g;
+function protectPromptText(text) {
+  return `<ttc_safe>${text}</ttc_safe>`;
+}
+var protect = protectPromptText;
 async function compressPrompt(options) {
   try {
     if (options.provider === "thetokencompany" || options.tokenCompanyApiKey) {
@@ -177,6 +184,12 @@ async function compressWithTheTokenCompany(options) {
   }
   const original = stableStringifyInput(options.input);
   const heuristic = compressPromptHeuristic(options.input);
+  const input = typeof heuristic.compressedInput === "string" ? heuristic.compressedInput : stableStringifyInput(heuristic.compressedInput);
+  const model = options.tokenCompanyModel ?? DEFAULT_TTC_MODEL;
+  const aggressiveness = options.tokenCompanyAggressiveness ?? DEFAULT_TTC_AGGRESSIVENESS;
+  if (typeof aggressiveness !== "number" || !Number.isFinite(aggressiveness) || aggressiveness < 0 || aggressiveness > 1) {
+    throw new Error("tokenCompanyAggressiveness must be between 0.0 and 1.0");
+  }
   const response = await fetchCandidate(
     options.tokenCompanyEndpoint ?? DEFAULT_TTC_ENDPOINT,
     {
@@ -185,7 +198,12 @@ async function compressWithTheTokenCompany(options) {
         authorization: `Bearer ${options.tokenCompanyApiKey}`,
         "content-type": "application/json"
       },
-      body: JSON.stringify({ input: heuristic.compressedInput }),
+      body: JSON.stringify({
+        model,
+        input,
+        compression_settings: { aggressiveness },
+        ...options.tokenCompanyAppId ? { app_id: options.tokenCompanyAppId } : {}
+      }),
       signal: options.signal
     }
   );
@@ -293,6 +311,20 @@ function compressValue(value, techniques, options) {
   return value;
 }
 function compressText(value, techniques, options) {
+  const protectedSpans = [];
+  const text = value.replace(PROTECTED_TEXT_PATTERN, (match) => {
+    const placeholder = `__USAGETAP_PROTECTED_${protectedSpans.length}__`;
+    protectedSpans.push(match);
+    techniques.add("protected-text");
+    return placeholder;
+  });
+  const compressed = compressTextWithoutProtection(text, techniques, options);
+  return protectedSpans.reduce(
+    (output, span, index) => output.replace(`__USAGETAP_PROTECTED_${index}__`, span),
+    compressed
+  );
+}
+function compressTextWithoutProtection(value, techniques, options) {
   const fencePattern = /```([\w-]+)?\n([\s\S]*?)```/g;
   const parts = [];
   let cursor = 0;
@@ -586,7 +618,7 @@ var IDEMPOTENCY_HEADER = "idempotency-key";
 var SDK_HEADER = "x-usage-sdk";
 var USER_AGENT = "UsageTapClient";
 var CANONICAL_MEDIA_TYPE = "application/vnd.usagetap.v1+json";
-var SDK_VERSION = "1.0.0" ;
+var SDK_VERSION = "1.1.0" ;
 var HAS_WINDOW = typeof globalThis !== "undefined" && typeof globalThis.window !== "undefined";
 var UsageTapClient = class {
   apiKey;
@@ -603,6 +635,9 @@ var UsageTapClient = class {
   autoIdempotency;
   tokenCompanyApiKey;
   tokenCompanyEndpoint;
+  tokenCompanyModel;
+  tokenCompanyAggressiveness;
+  tokenCompanyAppId;
   constructor(options) {
     if (!options) {
       throw new UsageTapError(
@@ -650,6 +685,9 @@ var UsageTapClient = class {
     this.autoIdempotency = options.autoIdempotency ?? true;
     this.tokenCompanyApiKey = options.tokenCompanyApiKey;
     this.tokenCompanyEndpoint = options.tokenCompanyEndpoint;
+    this.tokenCompanyModel = options.tokenCompanyModel;
+    this.tokenCompanyAggressiveness = options.tokenCompanyAggressiveness;
+    this.tokenCompanyAppId = options.tokenCompanyAppId;
   }
   async beginCall(request, options = {}) {
     const idempotencyKey = request.idempotencyKey ?? request.idempotency ?? (this.autoIdempotency ? this.idempotencyGenerator() : void 0);
@@ -679,17 +717,15 @@ var UsageTapClient = class {
         "promptCompress requires callId"
       );
     }
-    const result = await compressPrompt({
-      input: request.input,
+    const result = await this.compressPromptInput(request.input, {
       provider: request.provider,
-      tokenCompanyApiKey: this.tokenCompanyApiKey,
-      tokenCompanyEndpoint: this.tokenCompanyEndpoint,
-      fetchImpl: this.fetchImpl,
+      tokenCompanyModel: request.tokenCompanyModel,
+      tokenCompanyAggressiveness: request.tokenCompanyAggressiveness,
+      tokenCompanyAppId: request.tokenCompanyAppId,
       signal: options.signal
     });
     try {
-      await this.request(
-        COMPRESS_PROMPT_PATH,
+      await this.recordPromptCompression(
         {
           callId: request.callId,
           promptCompression: this.toPromptCompressionTelemetry(result)
@@ -708,6 +744,36 @@ var UsageTapClient = class {
       };
     }
   }
+  async compressPromptInput(input, options = {}) {
+    return compressPrompt({
+      input,
+      provider: options.provider,
+      tokenCompanyApiKey: this.tokenCompanyApiKey,
+      tokenCompanyEndpoint: this.tokenCompanyEndpoint,
+      tokenCompanyModel: options.tokenCompanyModel ?? this.tokenCompanyModel,
+      tokenCompanyAggressiveness: options.tokenCompanyAggressiveness ?? this.tokenCompanyAggressiveness,
+      tokenCompanyAppId: options.tokenCompanyAppId ?? this.tokenCompanyAppId,
+      fetchImpl: this.fetchImpl,
+      signal: options.signal,
+      failOpen: options.failOpen
+    });
+  }
+  async recordPromptCompression(request, options = {}) {
+    if (!request?.callId) {
+      throw new UsageTapError(
+        "USAGETAP_BAD_REQUEST",
+        "recordPromptCompression requires callId"
+      );
+    }
+    return this.request(
+      COMPRESS_PROMPT_PATH,
+      {
+        callId: request.callId,
+        promptCompression: request.promptCompression
+      },
+      options
+    );
+  }
   async endCall(request, options = {}) {
     if (!request?.callId) {
       throw new UsageTapError(
@@ -1533,6 +1599,6 @@ async function finalizeCall(callState, usageTap, error, usage) {
   }
 }
 
-export { UsageTapClient, UsageTapError, compressPrompt, compressPromptHeuristic, compressPromptToon, createIdempotencyKey, estimatePromptTokens, isUsageTapError, wrapFetch };
+export { UsageTapClient, UsageTapError, compressPrompt, compressPromptHeuristic, compressPromptToon, createIdempotencyKey, estimatePromptTokens, isUsageTapError, protect, protectPromptText, wrapFetch };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map