@kaana.ai/contracts 8.0.0 → 8.1.0

package/dist/stringBounds.js

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+/**
+ * Kaana's frozen wire contract measures strings in UTF-16 code units, as Go's
+ * utf16Length does. Zod >=4.5 measures its built-in string bounds in code points.
+ * These per-schema checks retain the standard bound metadata used by the Go
+ * descriptor and JSON Schema generators, with the contract's explicit measure.
+ * No Zod constructor, prototype, shared check or array validation is changed.
+ */
+export function minUtf16Length(minimum) {
+    const check = z.minLength(minimum);
+    check._zod.check = (payload) => {
+        if (payload.value.length >= minimum)
+            return;
+        payload.issues.push({
+            origin: 'string',
+            code: 'too_small',
+            minimum,
+            inclusive: true,
+            input: payload.value,
+            inst: check,
+            continue: true,
+        });
+    };
+    return check;
+}
+export function maxUtf16Length(maximum) {
+    const check = z.maxLength(maximum);
+    check._zod.check = (payload) => {
+        if (payload.value.length <= maximum)
+            return;
+        payload.issues.push({
+            origin: 'string',
+            code: 'too_big',
+            maximum,
+            inclusive: true,
+            input: payload.value,
+            inst: check,
+            continue: true,
+        });
+    };
+    return check;
+}
+export function utf16Length(length) {
+    const check = z.length(length);
+    check._zod.check = (payload) => {
+        if (payload.value.length === length)
+            return;
+        payload.issues.push({
+            origin: 'string',
+            ...(payload.value.length > length
+                ? { code: 'too_big', maximum: length }
+                : { code: 'too_small', minimum: length }),
+            inclusive: true,
+            exact: true,
+            input: payload.value,
+            inst: check,
+            continue: true,
+        });
+    };
+    return check;
+}

package/dist/timestampCheck.d.ts

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+/** Preserve the existing UTC wire spelling, including minute precision. */
+export declare function utcTimestampCheck(): z.core.$ZodCheck<string>;

package/dist/timestampCheck.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+/** Preserve the existing UTC wire spelling, including minute precision. */
+export function utcTimestampCheck() {
+    // Zod >=4.6 requires seconds on a qualified datetime. Compose its calendar
+    // and time validators explicitly to retain the contract's previous grammar,
+    // without accepting offsets, local datetimes or invalid calendar dates.
+    const date = z.regexes.date.source.slice(1, -1);
+    const time = z.regexes.time({}).source.slice(1, -1);
+    return new z.core.$ZodISODateTime({
+        type: 'string',
+        format: 'datetime',
+        check: 'string_format',
+        offset: false,
+        local: false,
+        precision: null,
+        pattern: new RegExp(`^${date}T(?:${time}(?:Z))$`),
+    });
+}

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Kaana API",
-    "version": "8.0.0",
+    "version": "8.1.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": [
@@ -1388,13 +1388,9 @@
                 "minLength": 1
               },
               "param": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
+                "type": [
+                  "string",
+                  "null"
                 ]
               },
               "code": {
@@ -1542,13 +1538,9 @@
                       "const": "assistant"
                     },
                     "content": {
-                      "anyOf": [
-                        {
-                          "type": "string"
-                        },
-                        {
-                          "type": "null"
-                        }
+                      "type": [
+                        "string",
+                        "null"
                       ]
                     },
                     "audio": {
@@ -4478,6 +4470,9 @@
           "prompt": {
             "type": "string",
             "maxLength": 4096
+          },
+          "interimResults": {
+            "type": "boolean"
           }
         },
         "additionalProperties": false
@@ -5028,6 +5023,9 @@
           {
             "$ref": "#/components/schemas/RealtimeTranscriptDoneEvent"
           },
+          {
+            "$ref": "#/components/schemas/RealtimeTranscriptInterimEvent"
+          },
           {
             "$ref": "#/components/schemas/RealtimeTextDeltaEvent"
           },
@@ -5953,6 +5951,55 @@
           "transcript"
         ]
       },
+      "RealtimeTranscriptInterimEvent": {
+        "type": "object",
+        "properties": {
+          "schemaVersion": {
+            "type": "number",
+            "const": 1
+          },
+          "requestId": {
+            "$ref": "#/components/schemas/RequestId"
+          },
+          "sequence": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          },
+          "commandId": {
+            "$ref": "#/components/schemas/RealtimeCommandId"
+          },
+          "type": {
+            "type": "string",
+            "const": "transcript.interim"
+          },
+          "source": {
+            "type": "string",
+            "const": "input_audio"
+          },
+          "itemId": {
+            "$ref": "#/components/schemas/RealtimeItemId"
+          },
+          "contentIndex": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          },
+          "text": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "schemaVersion",
+          "requestId",
+          "sequence",
+          "type",
+          "source",
+          "itemId",
+          "contentIndex",
+          "text"
+        ]
+      },
       "RealtimeTranscriptSource": {
         "type": "string",
         "enum": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaana.ai/contracts",
-  "version": "8.0.0",
+  "version": "8.1.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,
@@ -38,10 +38,9 @@
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.build.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "bun test src",
-    "prepublishOnly": "bun run typecheck && bun run test && bun run build && make -C ../.. contract-generate"
+    "test": "bun test src"
   },
   "dependencies": {
-    "zod": ">=4.4.3 <4.5.0"
+    "zod": ">=4.6.7 <5.0.0"
   }
 }