@kaana.ai/contracts 4.4.0 → 5.0.0

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Kaana API",
-    "version": "4.4.0",
+    "version": "5.0.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": [
@@ -3191,6 +3191,19 @@
         ],
         "additionalProperties": false
       },
+      "InferenceTranscriptionParameters": {
+        "type": "object",
+        "properties": {
+          "language": {
+            "$ref": "#/components/schemas/LanguageTag"
+          },
+          "prompt": {
+            "type": "string",
+            "maxLength": 4096
+          }
+        },
+        "additionalProperties": false
+      },
       "LanguageTag": {
         "type": "string",
         "maxLength": 35,
@@ -3358,6 +3371,12 @@
               "$ref": "#/components/schemas/LanguageTag"
             }
           },
+          "detectsLanguage": {
+            "type": "boolean"
+          },
+          "transcriptionPrompt": {
+            "type": "boolean"
+          },
           "audioFormats": {
             "type": "object",
             "properties": {
@@ -3684,6 +3703,9 @@
               "output"
             ],
             "additionalProperties": false
+          },
+          "parameters": {
+            "$ref": "#/components/schemas/RealtimeParameters"
           }
         },
         "required": [
@@ -3872,6 +3894,22 @@
         ],
         "additionalProperties": false
       },
+      "NumberRange": {
+        "type": "object",
+        "properties": {
+          "min": {
+            "type": "number"
+          },
+          "max": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "min",
+          "max"
+        ],
+        "additionalProperties": false
+      },
       "OxyApplicationId": {
         "type": "string",
         "minLength": 1,
@@ -4760,11 +4798,6 @@
             "type": "integer",
             "exclusiveMinimum": 0,
             "maximum": 10000
-          },
-          "maxTextItems": {
-            "type": "integer",
-            "minimum": 0,
-            "maximum": 10000
           }
         },
         "additionalProperties": false
@@ -4875,6 +4908,52 @@
           "audio"
         ]
       },
+      "RealtimeParameters": {
+        "type": "object",
+        "properties": {
+          "turnDetection": {
+            "minItems": 1,
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/RealtimeTurnDetectionParameters"
+            }
+          },
+          "outputModalities": {
+            "minItems": 1,
+            "type": "array",
+            "items": {
+              "minItems": 1,
+              "maxItems": 2,
+              "type": "array",
+              "items": {
+                "$ref": "#/components/schemas/RealtimeOutputModality"
+              }
+            }
+          },
+          "toolChoice": {
+            "minItems": 1,
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/RealtimeToolChoiceKind"
+            }
+          },
+          "maxOutputTokens": {
+            "type": "integer",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991
+          },
+          "inputTranscriptionPrompt": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "turnDetection",
+          "outputModalities",
+          "toolChoice",
+          "inputTranscriptionPrompt"
+        ],
+        "additionalProperties": false
+      },
       "RealtimePublicErrorEvent": {
         "type": "object",
         "properties": {
@@ -5352,17 +5431,12 @@
             "maxItems": 128,
             "type": "array",
             "items": {
-              "$ref": "#/components/schemas/ToolDefinition"
+              "$ref": "#/components/schemas/RealtimeToolDefinition"
             }
           },
           "toolChoice": {
             "$ref": "#/components/schemas/ToolChoice"
           },
-          "temperature": {
-            "type": "number",
-            "minimum": 0,
-            "maximum": 2
-          },
           "maxOutputTokens": {
             "type": "integer",
             "exclusiveMinimum": 0,
@@ -5400,17 +5474,12 @@
             "maxItems": 128,
             "type": "array",
             "items": {
-              "$ref": "#/components/schemas/ToolDefinition"
+              "$ref": "#/components/schemas/RealtimeToolDefinition"
             }
           },
           "toolChoice": {
             "$ref": "#/components/schemas/ToolChoice"
           },
-          "temperature": {
-            "type": "number",
-            "minimum": 0,
-            "maximum": 2
-          },
           "maxOutputTokens": {
             "type": "integer",
             "exclusiveMinimum": 0,
@@ -5820,6 +5889,46 @@
           "complete"
         ]
       },
+      "RealtimeToolChoiceKind": {
+        "type": "string",
+        "enum": [
+          "auto",
+          "none",
+          "required",
+          "function"
+        ]
+      },
+      "RealtimeToolDefinition": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "type": "string",
+            "const": "function"
+          },
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "description": {
+            "type": "string",
+            "maxLength": 2000
+          },
+          "parameters": {
+            "type": "object",
+            "propertyNames": {
+              "type": "string"
+            },
+            "additionalProperties": {}
+          }
+        },
+        "required": [
+          "type",
+          "name",
+          "parameters"
+        ],
+        "additionalProperties": false
+      },
       "RealtimeTranscriptDeltaEvent": {
         "type": "object",
         "properties": {
@@ -5943,6 +6052,33 @@
         ],
         "additionalProperties": false
       },
+      "RealtimeTurnDetectionParameters": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "$ref": "#/components/schemas/RealtimeTurnDetectionType"
+          },
+          "fixedResponses": {
+            "type": "boolean"
+          },
+          "threshold": {
+            "$ref": "#/components/schemas/NumberRange"
+          },
+          "meteredUnits": {
+            "minItems": 1,
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/UsageUnit"
+            }
+          }
+        },
+        "required": [
+          "type",
+          "fixedResponses",
+          "meteredUnits"
+        ],
+        "additionalProperties": false
+      },
       "RealtimeTurnDetection": {
         "oneOf": [
           {
@@ -6027,6 +6163,14 @@
           }
         ]
       },
+      "RealtimeTurnDetectionType": {
+        "type": "string",
+        "enum": [
+          "none",
+          "server_vad",
+          "semantic_vad"
+        ]
+      },
       "ReasoningEffort": {
         "type": "string",
         "enum": [
@@ -6682,14 +6826,6 @@
             "type": "string",
             "maxLength": 4096
           },
-          "timestamps": {
-            "type": "string",
-            "enum": [
-              "none",
-              "segment",
-              "word"
-            ]
-          },
           "audio": {
             "type": "object",
             "properties": {
@@ -6728,14 +6864,6 @@
           "prompt": {
             "type": "string",
             "maxLength": 4096
-          },
-          "timestamps": {
-            "type": "string",
-            "enum": [
-              "none",
-              "segment",
-              "word"
-            ]
           }
         },
         "required": [
@@ -6767,60 +6895,6 @@
             "minimum": 0,
             "maximum": 9007199254740991
           },
-          "segments": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "properties": {
-                "startMs": {
-                  "type": "integer",
-                  "minimum": 0,
-                  "maximum": 9007199254740991
-                },
-                "endMs": {
-                  "type": "integer",
-                  "minimum": 0,
-                  "maximum": 9007199254740991
-                },
-                "text": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "startMs",
-                "endMs",
-                "text"
-              ],
-              "additionalProperties": false
-            }
-          },
-          "words": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "properties": {
-                "startMs": {
-                  "type": "integer",
-                  "minimum": 0,
-                  "maximum": 9007199254740991
-                },
-                "endMs": {
-                  "type": "integer",
-                  "minimum": 0,
-                  "maximum": 9007199254740991
-                },
-                "word": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "startMs",
-                "endMs",
-                "word"
-              ],
-              "additionalProperties": false
-            }
-          },
           "usage": {
             "$ref": "#/components/schemas/Usage"
           }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaana.ai/contracts",
-  "version": "4.4.0",
+  "version": "5.0.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,