@kaana.ai/contracts 8.9.0 → 8.10.0

package/dist/internal/catalogue.d.ts

@@ -314,10 +314,10 @@ export declare const routingProfileSchema: z.ZodObject<{
     displayName: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     optimiseFor: z.ZodEnum<{
+        price: "price";
         latency: "latency";
         throughput: "throughput";
         quality: "quality";
-        price: "price";
         balanced: "balanced";
     }>;
     candidates: z.ZodArray<z.ZodObject<{

package/dist/public/chatCompletions.d.ts

@@ -250,9 +250,14 @@ export declare const chatCompletionsRequestSchema: z.ZodObject<{
             fp32: "fp32";
         }>>>;
         sort: z.ZodOptional<z.ZodEnum<{
+            price: "price";
             latency: "latency";
             throughput: "throughput";
         }>>;
+        max_price: z.ZodOptional<z.ZodObject<{
+            prompt: z.ZodOptional<z.ZodNumber>;
+            completion: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
         preferred_max_latency: z.ZodOptional<z.ZodNumber>;
         preferred_min_throughput: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;

package/dist/public/providerPreferences.d.ts

@@ -9,11 +9,17 @@
  * rather than widened.
  *
  * The names are OpenRouter's, so a client written for OpenRouter's `provider`
- * object works, and only the controls Kaana can honour are accepted:
- * `sort: "price"`, `max_price`, `zdr`, `data_collection`, `preferred_*` with a
- * percentile object, and `enforce_distillable_text` are refused by `.strict()`
- * rather than silently ignored. `max_price` and the data policy stay Oxy's:
- * Kaana never prices, and Oxy applies data policy when it computes the grant.
+ * object works, and only the controls Kaana can honour are accepted: `zdr`,
+ * `data_collection`, `preferred_*` with a percentile object and
+ * `enforce_distillable_text` are refused by `.strict()` rather than silently
+ * ignored, because the data policy is Oxy's and is applied when it computes the
+ * grant.
+ *
+ * `max_price` and `sort: "price"` read the DECLARED LIST PRICE of a model line,
+ * the price Oxy rates the grant at, in USD per million tokens. They are about
+ * which model line serves the request, because every route of one line costs
+ * the customer the same: they never expose an amount, and a line whose price
+ * the catalogue does not state is neither within a ceiling nor cheap.
  *
  * Provider names here are Kaana provider slugs as a caller sees them in the
  * catalogue. A response never names one.
@@ -55,9 +61,14 @@ export declare const providerPreferencesSchema: z.ZodObject<{
         fp32: "fp32";
     }>>>;
     sort: z.ZodOptional<z.ZodEnum<{
+        price: "price";
         latency: "latency";
         throughput: "throughput";
     }>>;
+    max_price: z.ZodOptional<z.ZodObject<{
+        prompt: z.ZodOptional<z.ZodNumber>;
+        completion: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
     preferred_max_latency: z.ZodOptional<z.ZodNumber>;
     preferred_min_throughput: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;

package/dist/public/providerPreferences.js

@@ -9,11 +9,17 @@
  * rather than widened.
  *
  * The names are OpenRouter's, so a client written for OpenRouter's `provider`
- * object works, and only the controls Kaana can honour are accepted:
- * `sort: "price"`, `max_price`, `zdr`, `data_collection`, `preferred_*` with a
- * percentile object, and `enforce_distillable_text` are refused by `.strict()`
- * rather than silently ignored. `max_price` and the data policy stay Oxy's:
- * Kaana never prices, and Oxy applies data policy when it computes the grant.
+ * object works, and only the controls Kaana can honour are accepted: `zdr`,
+ * `data_collection`, `preferred_*` with a percentile object and
+ * `enforce_distillable_text` are refused by `.strict()` rather than silently
+ * ignored, because the data policy is Oxy's and is applied when it computes the
+ * grant.
+ *
+ * `max_price` and `sort: "price"` read the DECLARED LIST PRICE of a model line,
+ * the price Oxy rates the grant at, in USD per million tokens. They are about
+ * which model line serves the request, because every route of one line costs
+ * the customer the same: they never expose an amount, and a line whose price
+ * the catalogue does not state is neither within a ceiling nor cheap.
  *
  * Provider names here are Kaana provider slugs as a caller sees them in the
  * catalogue. A response never names one.
@@ -58,8 +64,26 @@ export const providerPreferencesSchema = z
     require_parameters: z.boolean().optional(),
     /** Keep only routes published at one of these quantizations; `unknown` admits unstated ones. */
     quantizations: z.array(providerQuantizationSchema).min(1).max(12).optional(),
-    /** Prefer the route with the lowest recent latency or the highest recent throughput. */
-    sort: z.enum(['latency', 'throughput']).optional(),
+    /**
+     * Prefer the model line with the lowest declared list price, or the route
+     * with the lowest recent latency or the highest recent throughput.
+     */
+    sort: z.enum(['price', 'latency', 'throughput']).optional(),
+    /**
+     * A ceiling on the declared list price of the model line, in USD per million
+     * tokens. A line over it, or one whose price is not stated, is not used; the
+     * request is refused rather than served above it.
+     */
+    max_price: z
+        .object({
+        prompt: z.number().positive().max(1_000_000).optional(),
+        completion: z.number().positive().max(1_000_000).optional(),
+    })
+        .strict()
+        .refine((ceiling) => ceiling.prompt !== undefined || ceiling.completion !== undefined, {
+        message: 'max_price names prompt, completion or both',
+    })
+        .optional(),
     /** Seconds. A route slower than this recently is tried later, never excluded (p50). */
     preferred_max_latency: z.number().positive().max(600).optional(),
     /** Output tokens per second. A route slower than this recently is tried later, never excluded (p50). */

package/dist/public/responses.d.ts

@@ -204,9 +204,14 @@ export declare const responsesRequestSchema: z.ZodObject<{
             fp32: "fp32";
         }>>>;
         sort: z.ZodOptional<z.ZodEnum<{
+            price: "price";
             latency: "latency";
             throughput: "throughput";
         }>>;
+        max_price: z.ZodOptional<z.ZodObject<{
+            prompt: z.ZodOptional<z.ZodNumber>;
+            completion: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
         preferred_max_latency: z.ZodOptional<z.ZodNumber>;
         preferred_min_throughput: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;

package/dist/public/version.d.ts

@@ -100,7 +100,7 @@
  * change to, say, the catalogue reject every in-flight inference request; the
  * per-shape `schemaVersion` is what a message is validated against.
  */
-export declare const INFERENCE_CONTRACT_VERSION = "8.9.0";
+export declare const INFERENCE_CONTRACT_VERSION = "8.10.0";
 /**
  * Contract set 4.0.0 (Kaana ADR 0002) is the first published as
  * `@kaana.ai/contracts`. MAJOR because the set changed hands and split in two:
@@ -230,6 +230,12 @@ export declare const INFERENCE_CONTRACT_VERSION = "8.9.0";
  * request member only: the signed grant and envelope are unchanged, and a
  * response carries no new body member, so every older reader parses what 8.9.0
  * serves.
+ *
+ * Contract set 8.10.0 is additive: `max_price` and `sort: "price"` in the
+ * `provider` routing preference (`providerPreferencesSchema`, Kaana ADR 0008).
+ * Both read the declared list price of a model line, in USD per million tokens.
+ * Public request members only: the signed grant and envelope are unchanged and
+ * no response carries an amount.
  */
 /** The public API's one origin and version. */
 export declare const KAANA_API_BASE_URL = "https://kaana.ai/v1";

package/dist/public/version.js

@@ -100,7 +100,7 @@
  * change to, say, the catalogue reject every in-flight inference request; the
  * per-shape `schemaVersion` is what a message is validated against.
  */
-export const INFERENCE_CONTRACT_VERSION = '8.9.0';
+export const INFERENCE_CONTRACT_VERSION = '8.10.0';
 /**
  * Contract set 4.0.0 (Kaana ADR 0002) is the first published as
  * `@kaana.ai/contracts`. MAJOR because the set changed hands and split in two:
@@ -230,6 +230,12 @@ export const INFERENCE_CONTRACT_VERSION = '8.9.0';
  * request member only: the signed grant and envelope are unchanged, and a
  * response carries no new body member, so every older reader parses what 8.9.0
  * serves.
+ *
+ * Contract set 8.10.0 is additive: `max_price` and `sort: "price"` in the
+ * `provider` routing preference (`providerPreferencesSchema`, Kaana ADR 0008).
+ * Both read the declared list price of a model line, in USD per million tokens.
+ * Public request members only: the signed grant and envelope are unchanged and
+ * no response carries an amount.
  */
 /** The public API's one origin and version. */
 export const KAANA_API_BASE_URL = 'https://kaana.ai/v1';

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Kaana API",
-    "version": "8.9.0",
+    "version": "8.10.0",
     "description": "Kaana inference API. Generated from @kaana.ai/contracts; the Zod source is the authority. Accounts, applications, oxy_sk_ keys, limits and billing are managed in Oxy Console: https://console.oxy.so"
   },
   "servers": [
@@ -5506,10 +5506,27 @@
           "sort": {
             "type": "string",
             "enum": [
+              "price",
               "latency",
               "throughput"
             ]
           },
+          "max_price": {
+            "type": "object",
+            "properties": {
+              "prompt": {
+                "type": "number",
+                "exclusiveMinimum": 0,
+                "maximum": 1000000
+              },
+              "completion": {
+                "type": "number",
+                "exclusiveMinimum": 0,
+                "maximum": 1000000
+              }
+            },
+            "additionalProperties": false
+          },
           "preferred_max_latency": {
             "type": "number",
             "exclusiveMinimum": 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaana.ai/contracts",
-  "version": "8.9.0",
+  "version": "8.10.0",
   "description": "Kaana inference contract: the Zod schemas of the public API at https://kaana.ai/v1 and, under /internal, of the Oxy-Kaana grant, settlement and signed lane.",
   "type": "module",
   "sideEffects": false,