@zuplo/cli 6.73.28 → 6.73.29

package/node_modules/@zuplo/runtime/out/types/index.d.ts

@@ -475,7 +475,6 @@ export declare class AIGatewayMeteringInboundPolicy extends InboundPolicy<AIGate
     increments: AIGatewayMeterIncrements,
     context: ZuploContext
   ): Promise<void>;
-  private static incrementMetersInternal;
   private checkWarnings;
   private checkQuotaWarning;
   private createHierarchicalQuotaExceededResponse;
@@ -492,6 +491,131 @@ export declare interface AIGatewayMeteringInboundPolicyOptions {
   throwOnFailure?: boolean;
 }
 
+/**
+ * Meters AI Gateway v2 usage and enforces options-driven usage limits.
+ *
+ * The authentication policy must run before this policy so the app
+ * configuration id is available for meter storage and analytics.
+ *
+ * @title AI Gateway Metering (v2)
+ * @beta
+ * @product ai-gateway
+ * @requiresAI
+ * @param request - The ZuploRequest
+ * @param context - The ZuploContext
+ * @param options - The policy options set in policies.json
+ * @param policyName - The name of the policy as set in policies.json
+ * @returns The request, or a 429 response when a limit is exceeded
+ */
+export declare class AIGatewayMeteringV2InboundPolicy extends InboundPolicy<AIGatewayMeteringV2InboundPolicyOptions> {
+  #private;
+  static readonly policyType = "ai-gateway-metering-v2";
+  constructor(
+    options: AIGatewayMeteringV2InboundPolicyOptions,
+    policyName: string
+  );
+  /** Set the meter increments accumulated for this request. */
+  static setIncrements(
+    context: ZuploContext,
+    increments: AIGatewayMeterIncrements
+  ): void;
+  /** Read the meter increments accumulated for this request. */
+  static getIncrements(context: ZuploContext): AIGatewayMeterIncrements;
+  /** Set the quota-fallback marker for this request. */
+  static setQuotaFallback(
+    context: ZuploContext,
+    quotaFallback: QuotaFallbackModels
+  ): void;
+  /** Read the quota-fallback marker for this request. */
+  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,
+    increments: AIGatewayMeterIncrements,
+    context: ZuploContext
+  ): Promise<void>;
+  handler(
+    request: ZuploRequest,
+    context: ZuploContext
+  ): Promise<ZuploRequest | Response>;
+  private resolveConfiguration;
+  private fetchCurrentMeters;
+  private checkWarnings;
+  private hasWarning;
+  private findViolation;
+  private requestCapability;
+  private createQuotaExceededResponse;
+}
+
+/**
+ * Options for metering AI Gateway v2 usage and enforcing request-time limits.
+ * @public
+ */
+export declare interface AIGatewayMeteringV2InboundPolicyOptions {
+  /**
+   * Throw when the metering service is unavailable instead of failing open.
+   */
+  throwOnFailure?: boolean;
+  /**
+   * Usage limits grouped by meter.
+   */
+  limits?: {
+    costs?: QuotaLimit;
+    tokens?: QuotaLimit;
+    requests?: QuotaLimit;
+  };
+}
+
+/**
+ * Request-scoped usage-limit overrides accepted by
+ * `AIGatewayMeteringV2InboundPolicy.setLimits`.
+ */
+export declare interface AIGatewayMeteringV2LimitOverrides {
+  costs?: AIGatewayMeteringV2MeterLimitOverrides;
+  tokens?: AIGatewayMeteringV2MeterLimitOverrides;
+  requests?: AIGatewayMeteringV2MeterLimitOverrides;
+}
+
+/** Daily and monthly overrides for one usage meter. */
+declare interface AIGatewayMeteringV2MeterLimitOverrides {
+  daily?: AIGatewayMeteringV2PeriodLimitOverride;
+  monthly?: AIGatewayMeteringV2PeriodLimitOverride;
+}
+
+/** Settings that a policy can override 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. */
+declare interface AIGatewayMeteringV2WarningLimitOverride {
+  enabled?: boolean;
+  threshold?: number;
+}
+
 /**
  * Matches AI Gateway requests against curated allow lists or open block lists,
  * then stores the winning model reference for the route handler.
@@ -12178,6 +12302,17 @@ export declare interface QuotaInboundPolicyOptions {
   };
 }
 
+declare interface QuotaLimit {
+  daily?: QuotaSettings;
+  monthly?: QuotaSettings;
+}
+
+declare interface QuotaSettings {
+  enabled: boolean;
+  limit?: number;
+  warning?: WarningSettings;
+}
+
 /**
  * The identifying element of the request that enforces distinct rate limits. For example, you can limit by `user`, `ip`, `function` or `all` - function allows you to specify a simple function to create a string identifier to create a rate-limit group.
  * @public
@@ -15720,6 +15855,14 @@ declare interface WaitUntilFunc {
   (promise: Promise<any>): void;
 }
 
+declare interface WarningSettings {
+  enabled: boolean;
+  /**
+   * Percentage of the limit at which to emit a warning event.
+   */
+  threshold?: number;
+}
+
 /**
  * Authenticate bots using web-bot-auth HTTP Message Signatures.
  *

package/node_modules/@zuplo/runtime/package.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zuplo/cli",
-  "version": "6.73.28",
+  "version": "6.73.29",
   "repository": "https://github.com/zuplo/zuplo",
   "author": "Zuplo, Inc.",
   "type": "module",
@@ -27,10 +27,10 @@
     "@opentelemetry/api": "1.9.0",
     "@opentelemetry/api-logs": "0.220.0",
     "@swc/core": "1.10.18",
-    "@zuplo/core": "6.73.28",
+    "@zuplo/core": "6.73.29",
     "@zuplo/editor": "1.0.29844086763",
-    "@zuplo/openapi-tools": "6.73.28",
-    "@zuplo/runtime": "6.73.28",
+    "@zuplo/openapi-tools": "6.73.29",
+    "@zuplo/runtime": "6.73.29",
     "chalk": "5.4.1",
     "chokidar": "3.5.3",
     "cookie": "1.0.2",
@@ -61,8 +61,8 @@
     "workerd": "1.20241230.0",
     "yargs": "17.7.2",
     "zod": "3.25.76",
-    "@zuplo/graphql": "6.73.28",
-    "@zuplo/otel": "6.73.28"
+    "@zuplo/graphql": "6.73.29",
+    "@zuplo/otel": "6.73.29"
   },
   "bundleDependencies": [
     "@inquirer/prompts",