zuplo 7.6.7 → 7.6.8

package/docs/ai-gateway/usage-limits.mdx

@@ -118,13 +118,13 @@ at $80, block at $100. The warn amount has to be the lower of the two.
 The **Overview** tab charts daily and monthly usage only. Hourly and weekly rows
 are enforced, but no meter on that tab tracks them.
 
-:::note
+:::note{title="Budget rule periods follow the UTC calendar"}
 
-Periods are anchored to your gateway, not the calendar. Every period rolls over
-relative to the time (UTC) the gateway was created, so a daily period resets at
-that hour rather than at midnight, and a monthly one on that day of the month.
-Teams and apps created later use the same anchor. Changing a limit mid-period
-doesn't reset the period's usage.
+Hourly periods reset at the top of each hour, daily at 00:00 UTC, weekly on
+Monday at 00:00 UTC, and monthly on the first of the month. A rule added
+mid-period gets the full allowance for the rest of that period—the limit isn't
+prorated—and resets at the next boundary. Changing a limit mid-period doesn't
+reset the period's usage. Custom anchors aren't configurable.
 
 :::
 
@@ -184,6 +184,56 @@ App rules are stored in `options.budgetRules` on the app's own Budgets and Costs
 policy entry. For the app rule schema, see the
 [Budgets and Costs policy reference](../policies/ai-gateway-metering-v2-inbound.mdx).
 
+This rule set budgets each user, each organization, and the app as a whole:
+
+```json
+{
+  "budgetRules": [
+    {
+      "budgetBy": "expression",
+      "expression": "request.headers.get(\"x-user\")",
+      "meters": [
+        {
+          "meter": "tokens",
+          "period": "hourly",
+          "value": 20000,
+          "action": "block"
+        }
+      ]
+    },
+    {
+      "budgetBy": "expression",
+      "expression": "request.headers.get(\"x-organization\")",
+      "meters": [
+        { "meter": "cost", "period": "daily", "value": 50, "action": "block" }
+      ]
+    },
+    {
+      "budgetBy": "app",
+      "meters": [
+        {
+          "meter": "cost",
+          "period": "monthly",
+          "value": 2000,
+          "action": "warn"
+        },
+        {
+          "meter": "cost",
+          "period": "monthly",
+          "value": 2500,
+          "action": "block"
+        }
+      ]
+    }
+  ]
+}
+```
+
+Every distinct `x-user` value gets its own 20,000 tokens per hour, resetting at
+the top of the hour. Every distinct `x-organization` value gets its own $50 per
+day, resetting at 00:00 UTC. The `app` rule caps the whole app at $2,500 per
+month, warning at $2,000, resetting on the first of the month.
+
 ## Setting team and gateway limits
 
 Team and gateway limits cover the node's own usage and all descendant usage.

package/docs/policies/ai-gateway-smart-router-inbound/doc.md

@@ -24,6 +24,8 @@ invalid options fail open: the original request is forwarded.
 - `classifierAppApiKey` — bearer token for that app. Use
   `$env(CLASSIFIER_APP_API_KEY)`.
 - `classifierModel` — `providerName/model` sent on the classifier request.
+- `modelsByComplexity` — `providerName/model` for each of `low`, `medium`, and
+  `high`. Used for routing when `smartRoutingEnabled` is true.
 
 Omit `intents` and `classifierPrompt` to use the built-in taxonomy (code,
 summarization, translation, qa, conversation, classification, creative_writing,

package/docs/policies/ai-gateway-smart-router-inbound/schema.json

@@ -38,7 +38,8 @@
           "required": [
             "classifierAppID",
             "classifierAppApiKey",
-            "classifierModel"
+            "classifierModel",
+            "modelsByComplexity"
           ],
           "examples": [
             {
@@ -82,8 +83,9 @@
             "modelsByComplexity": {
               "type": "object",
               "title": "Models By Complexity",
-              "description": "Optional `providerName/model` routing by classified complexity. Used only when `smartRoutingEnabled` is true.",
+              "description": "`providerName/model` routing by classified complexity. All of `low`, `medium`, and `high` are required. Used only when `smartRoutingEnabled` is true.",
               "additionalProperties": false,
+              "required": ["low", "medium", "high"],
               "properties": {
                 "low": {
                   "type": "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zuplo",
-  "version": "7.6.7",
+  "version": "7.6.8",
   "type": "module",
   "description": "The official Zuplo CLI for local development and platform management",
   "homepage": "https://zuplo.com/docs/cli/overview",
@@ -32,9 +32,9 @@
     "zuplo": "zuplo.js"
   },
   "dependencies": {
-    "@zuplo/cli": "7.6.7",
-    "@zuplo/core": "7.6.7",
-    "@zuplo/runtime": "7.6.7",
-    "@zuplo/test": "7.6.7"
+    "@zuplo/cli": "7.6.8",
+    "@zuplo/core": "7.6.8",
+    "@zuplo/runtime": "7.6.8",
+    "@zuplo/test": "7.6.8"
   }
 }