@zuplo/runtime 7.5.6 → 7.6.0

package/out/types/index.d.ts

@@ -641,25 +641,6 @@ export declare class AIGatewayMeteringV2InboundPolicy extends InboundPolicy<AIGa
   static getQuotaFallback(
     context: ZuploContext
   ): QuotaFallbackModels | undefined;
-  /**
-   * Compose request-scoped limit overrides with any limits already set.
-   *
-   * Limits intentionally merge at each meter, period, and setting leaf because
-   * independent policies may tighten one path without restating sibling limits.
-   * Defined values from the newest call win; undefined values never erase an
-   * earlier value.
-   *
-   * @param context - The current request context
-   * @param limits - Limits or partial leaf overrides to compose
-   */
-  static setLimits(
-    context: ZuploContext,
-    limits: AIGatewayMeteringV2LimitOverrides
-  ): void;
-  /** Read request-scoped limit overrides. */
-  static getLimits(
-    context: ZuploContext
-  ): AIGatewayMeteringV2LimitOverrides | undefined;
   /** Increment meters directly, for example after a streaming response. */
   static incrementMeters(
     configurationId: string,
@@ -689,6 +670,30 @@ export declare interface AIGatewayMeteringV2InboundPolicyOptions {
    */
   throwOnFailure?: boolean;
   /**
+   * Budget rules for this application. Each rule budgets the whole app ("app") or each distinct value of an expression ("expression"), with warn and block thresholds per meter and period.
+   *
+   * @maxItems 5
+   */
+  budgetRules?:
+    | []
+    | [MeteringBudgetRule]
+    | [MeteringBudgetRule, MeteringBudgetRule]
+    | [MeteringBudgetRule, MeteringBudgetRule, MeteringBudgetRule]
+    | [
+        MeteringBudgetRule,
+        MeteringBudgetRule,
+        MeteringBudgetRule,
+        MeteringBudgetRule,
+      ]
+    | [
+        MeteringBudgetRule,
+        MeteringBudgetRule,
+        MeteringBudgetRule,
+        MeteringBudgetRule,
+        MeteringBudgetRule,
+      ];
+  /**
+   * @deprecated
    * Usage limits grouped by meter.
    */
   limits?: {
@@ -699,8 +704,7 @@ export declare interface AIGatewayMeteringV2InboundPolicyOptions {
 }
 
 /**
- * Request-scoped usage-limit overrides accepted by
- * `AIGatewayMeteringV2InboundPolicy.setLimits`.
+ * Usage-limit settings accepted by the `options.limits` policy option.
  */
 export declare interface AIGatewayMeteringV2LimitOverrides {
   costs?: AIGatewayMeteringV2MeterLimitOverrides;
@@ -708,20 +712,20 @@ export declare interface AIGatewayMeteringV2LimitOverrides {
   requests?: AIGatewayMeteringV2MeterLimitOverrides;
 }
 
-/** Daily and monthly overrides for one usage meter. */
+/** Daily and monthly settings for one usage meter. */
 declare interface AIGatewayMeteringV2MeterLimitOverrides {
   daily?: AIGatewayMeteringV2PeriodLimitOverride;
   monthly?: AIGatewayMeteringV2PeriodLimitOverride;
 }
 
-/** Settings that a policy can override for one usage-limit period. */
+/** Settings for one usage-limit period. */
 declare interface AIGatewayMeteringV2PeriodLimitOverride {
   enabled?: boolean;
   limit?: number;
   warning?: AIGatewayMeteringV2WarningLimitOverride;
 }
 
-/** Warning settings that a policy can override for one usage-limit period. */
+/** Warning settings for one usage-limit period. */
 declare interface AIGatewayMeteringV2WarningLimitOverride {
   enabled?: boolean;
   threshold?: number;
@@ -10451,6 +10455,26 @@ declare interface Meter {
  */
 declare type Meter_2 = Partial<OpenMeterEvent> & Meter;
 
+declare interface MeteringBudgetRule {
+  budgetBy: "app" | "expression";
+  /**
+   * Required when budgetBy is "expression"; forbidden for "app". Each distinct value gets its own budget.
+   */
+  expression?: string;
+  /**
+   * @minItems 1
+   * @maxItems 24
+   */
+  meters: [MeteringBudgetRuleMeter, ...MeteringBudgetRuleMeter[]];
+}
+
+declare interface MeteringBudgetRuleMeter {
+  meter: "cost" | "requests" | "tokens";
+  period: "hourly" | "daily" | "weekly" | "monthly";
+  value: number;
+  action: "warn" | "block";
+}
+
 declare interface MeterUsageMap {
   [meter: string]: number;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zuplo/runtime",
   "type": "module",
-  "version": "7.5.6",
+  "version": "7.6.0",
   "repository": "https://github.com/zuplo/zuplo",
   "author": "Zuplo, Inc.",
   "exports": {