@kaana.ai/contracts 8.0.0 → 8.1.0

package/dist/public/messages.js

@@ -5,6 +5,7 @@
  * Moved from `@oxy.so/contracts` 4.12.0 (`src/inference/request.ts`) by Kaana ADR 0002.
  */
 import { z } from 'zod';
+import { maxUtf16Length, minUtf16Length } from '../stringBounds.js';
 import { languageTagSchema } from './audioFormats.js';
 import { reasoningEffortSchema } from './catalogue.js';
 /**
@@ -15,12 +16,17 @@ import { reasoningEffortSchema } from './catalogue.js';
  * neither appears in a receipt, a log line or a telemetry event.
  */
 export const inferenceContentSourceSchema = z.discriminatedUnion('kind', [
-    z.object({ kind: z.literal('url'), url: z.string().min(1).max(4096) }).strict(),
+    z
+        .object({
+        kind: z.literal('url'),
+        url: z.string().check(minUtf16Length(1)).check(maxUtf16Length(4096)),
+    })
+        .strict(),
     z
         .object({
         kind: z.literal('inline'),
-        mediaType: z.string().min(1).max(255),
-        data: z.string().min(1),
+        mediaType: z.string().check(minUtf16Length(1)).check(maxUtf16Length(255)),
+        data: z.string().check(minUtf16Length(1)),
     })
         .strict(),
 ]);
@@ -71,7 +77,7 @@ export const inferenceContentPartSchema = z.discriminatedUnion('type', [
         .object({
         type: z.literal('file'),
         source: inferenceContentSourceSchema,
-        filename: z.string().max(255).optional(),
+        filename: z.string().check(maxUtf16Length(255)).optional(),
     })
         .strict(),
     /**
@@ -89,8 +95,8 @@ export const inferenceContentPartSchema = z.discriminatedUnion('type', [
  */
 export const inferenceToolCallSchema = z
     .object({
-    id: z.string().min(1).max(128),
-    name: z.string().min(1).max(128),
+    id: z.string().check(minUtf16Length(1)).check(maxUtf16Length(128)),
+    name: z.string().check(minUtf16Length(1)).check(maxUtf16Length(128)),
     arguments: z.string(),
 })
     .strict();
@@ -114,9 +120,9 @@ export const inferenceMessageSchema = z
     role: inferenceMessageRoleSchema,
     content: z.array(inferenceContentPartSchema),
     /** Participant name, where the dialect supports naming participants. */
-    name: z.string().max(128).optional(),
+    name: z.string().check(maxUtf16Length(128)).optional(),
     /** The tool call this message answers. Required on, and only on, `tool`. */
-    toolCallId: z.string().min(1).max(128).optional(),
+    toolCallId: z.string().check(minUtf16Length(1)).check(maxUtf16Length(128)).optional(),
     /** Tool calls the assistant made. Only on `assistant`. */
     toolCalls: z.array(inferenceToolCallSchema).optional(),
 })
@@ -168,7 +174,10 @@ export const samplingParametersSchema = z
     presencePenalty: z.number().min(-2).max(2).optional(),
     /** A seed makes a request reproducible on providers that honour one. */
     seed: z.number().int().safe().optional(),
-    stopSequences: z.array(z.string().min(1).max(256)).max(8).optional(),
+    stopSequences: z
+        .array(z.string().check(minUtf16Length(1)).check(maxUtf16Length(256)))
+        .max(8)
+        .optional(),
 })
     .strict();
 /**
@@ -179,8 +188,8 @@ export const samplingParametersSchema = z
 export const toolDefinitionSchema = z
     .object({
     type: z.literal('function'),
-    name: z.string().min(1).max(128),
-    description: z.string().max(2000).optional(),
+    name: z.string().check(minUtf16Length(1)).check(maxUtf16Length(128)),
+    description: z.string().check(maxUtf16Length(2000)).optional(),
     parameters: z.record(z.string(), z.unknown()),
     /** Ask the provider to enforce the schema, where it supports enforcement. */
     strict: z.boolean().optional(),
@@ -189,7 +198,12 @@ export const toolDefinitionSchema = z
 /** Whether, and which, tool the model must call. */
 export const toolChoiceSchema = z.union([
     z.enum(['auto', 'none', 'required']),
-    z.object({ type: z.literal('function'), name: z.string().min(1).max(128) }).strict(),
+    z
+        .object({
+        type: z.literal('function'),
+        name: z.string().check(minUtf16Length(1)).check(maxUtf16Length(128)),
+    })
+        .strict(),
 ]);
 /** Structured-output request: free text, any JSON object, or a named schema. */
 export const responseFormatSchema = z.discriminatedUnion('type', [
@@ -198,7 +212,7 @@ export const responseFormatSchema = z.discriminatedUnion('type', [
     z
         .object({
         type: z.literal('json_schema'),
-        name: z.string().min(1).max(128),
+        name: z.string().check(minUtf16Length(1)).check(maxUtf16Length(128)),
         schema: z.record(z.string(), z.unknown()),
         strict: z.boolean(),
     })
@@ -215,7 +229,7 @@ export const inferenceReasoningSchema = z.object({ effort: reasoningEffortSchema
 /** Parameters for text-to-speech, preserved in the signed request. */
 export const inferenceSpeechParametersSchema = z
     .object({
-    voice: z.string().min(1).max(64),
+    voice: z.string().check(minUtf16Length(1)).check(maxUtf16Length(64)),
     responseFormat: z.enum(['mp3', 'opus', 'aac', 'flac', 'wav', 'pcm']),
     speed: z.number().min(0.25).max(4).optional(),
 })
@@ -231,7 +245,7 @@ export const inferenceTranscriptionParametersSchema = z
     .object({
     language: languageTagSchema.optional(),
     /** Vocabulary or context, never an instruction (contract set 5.0.0). */
-    prompt: z.string().max(4096).optional(),
+    prompt: z.string().check(maxUtf16Length(4096)).optional(),
 })
     .strict();
 /**
@@ -249,7 +263,7 @@ export const inferenceTranscriptionParametersSchema = z
  */
 export const inferenceAudioOutputParametersSchema = z
     .object({
-    voice: z.string().min(1).max(64),
+    voice: z.string().check(minUtf16Length(1)).check(maxUtf16Length(64)),
     format: z.enum(['wav', 'mp3', 'flac', 'opus', 'pcm']),
 })
     .strict();
@@ -262,5 +276,5 @@ export const inferenceAudioOutputParametersSchema = z
  * Moved from the Oxy edge (`packages/api/src/schemas/inferenceEdge.schemas.ts`).
  */
 export const requestLabelsSchema = z
-    .record(z.string(), z.string().max(256))
+    .record(z.string(), z.string().check(maxUtf16Length(256)))
     .refine((labels) => Object.keys(labels).length <= 16, 'at most 16 labels may be attached to one request');

package/dist/public/money.js

@@ -6,6 +6,7 @@
  * itself stays in `@oxy.so/contracts`, because Oxy owns the price lists.
  */
 import { z } from 'zod';
+import { maxUtf16Length, minUtf16Length } from '../stringBounds.js';
 /** ISO 4217 alpha-3 currency code, e.g. `USD`. */
 export const currencyCodeSchema = z
     .string()
@@ -219,7 +220,7 @@ export const unitPriceSchema = z
  */
 export const priceSnapshotSchema = z
     .object({
-    priceVersionId: z.string().min(1).max(128),
+    priceVersionId: z.string().check(minUtf16Length(1)).check(maxUtf16Length(128)),
     currency: currencyCodeSchema,
     unitPrices: z.array(unitPriceSchema).min(1),
 })

package/dist/public/policy.js

@@ -7,6 +7,7 @@
  * Moved from `@oxy.so/contracts` 4.12.0 (`src/inference/routingPolicy.ts`) by Kaana ADR 0002.
  */
 import { z } from 'zod';
+import { maxUtf16Length, minUtf16Length } from '../stringBounds.js';
 /**
  * The reference a request records: which policy, at which of the customer's own
  * revisions. Embedded in the request envelope and in the settled receipt, so a
@@ -14,7 +15,7 @@ import { z } from 'zod';
  */
 export const routingPolicyReferenceSchema = z
     .object({
-    routingPolicyId: z.string().min(1).max(128),
+    routingPolicyId: z.string().check(minUtf16Length(1)).check(maxUtf16Length(128)),
     policyVersion: z.number().int().positive().safe(),
 })
     .strict();

package/dist/public/realtime.d.ts

@@ -89,6 +89,7 @@ export declare const realtimeTurnDetectionSchema: z.ZodDiscriminatedUnion<[z.Zod
 export declare const realtimeInputTranscriptionSchema: z.ZodObject<{
     language: z.ZodOptional<z.ZodString>;
     prompt: z.ZodOptional<z.ZodString>;
+    interimResults: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 /** The target of a `translation` session. */
 export declare const realtimeTranslationSchema: z.ZodObject<{
@@ -153,6 +154,7 @@ export declare const realtimeSessionConfigSchema: z.ZodObject<{
     inputAudioTranscription: z.ZodOptional<z.ZodObject<{
         language: z.ZodOptional<z.ZodString>;
         prompt: z.ZodOptional<z.ZodString>;
+        interimResults: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
     translation: z.ZodOptional<z.ZodObject<{
         targetLanguage: z.ZodString;
@@ -210,6 +212,7 @@ export declare const realtimeSessionConfigUpdateSchema: z.ZodObject<{
     inputAudioTranscription: z.ZodOptional<z.ZodObject<{
         language: z.ZodOptional<z.ZodString>;
         prompt: z.ZodOptional<z.ZodString>;
+        interimResults: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
     tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
         type: z.ZodLiteral<"function">;
@@ -369,6 +372,7 @@ export declare const realtimeSessionUpdateCommandSchema: z.ZodObject<{
         inputAudioTranscription: z.ZodOptional<z.ZodObject<{
             language: z.ZodOptional<z.ZodString>;
             prompt: z.ZodOptional<z.ZodString>;
+            interimResults: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
         tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
             type: z.ZodLiteral<"function">;
@@ -559,6 +563,7 @@ export declare const realtimeClientCommandSchema: z.ZodDiscriminatedUnion<[z.Zod
         inputAudioTranscription: z.ZodOptional<z.ZodObject<{
             language: z.ZodOptional<z.ZodString>;
             prompt: z.ZodOptional<z.ZodString>;
+            interimResults: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
         tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
             type: z.ZodLiteral<"function">;
@@ -740,6 +745,7 @@ export declare const realtimeSessionUpdatedEventSchema: z.ZodObject<{
         inputAudioTranscription: z.ZodOptional<z.ZodObject<{
             language: z.ZodOptional<z.ZodString>;
             prompt: z.ZodOptional<z.ZodString>;
+            interimResults: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
         translation: z.ZodOptional<z.ZodObject<{
             targetLanguage: z.ZodString;
@@ -1017,6 +1023,24 @@ export declare const realtimeTranscriptDoneEventSchema: z.ZodObject<{
     sequence: z.ZodNumber;
     commandId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * The provisional text of an input item not yet final (contract set 8.1.0,
+ * Kaana ADR 0006): sent only to a `transcription` session that asked for
+ * `interimResults`. Each one REPLACES the item's previous interim text; it is
+ * display state, never settled and never part of the item's transcript, and
+ * the item's next `transcript.delta` or its `transcript.done` supersedes it.
+ */
+export declare const realtimeTranscriptInterimEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"transcript.interim">;
+    source: z.ZodLiteral<"input_audio">;
+    itemId: z.ZodString;
+    contentIndex: z.ZodNumber;
+    text: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 /** Written output of a response (`outputModalities` including `text`). */
 export declare const realtimeTextDeltaEventSchema: z.ZodObject<{
     type: z.ZodLiteral<"text.delta">;
@@ -1158,6 +1182,7 @@ export declare const realtimeSessionOpenSchema: z.ZodObject<{
         inputAudioTranscription: z.ZodOptional<z.ZodObject<{
             language: z.ZodOptional<z.ZodString>;
             prompt: z.ZodOptional<z.ZodString>;
+            interimResults: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
         translation: z.ZodOptional<z.ZodObject<{
             targetLanguage: z.ZodString;
@@ -1268,6 +1293,7 @@ export declare const realtimePublicSessionCreatedEventSchema: z.ZodObject<{
         inputAudioTranscription: z.ZodOptional<z.ZodObject<{
             language: z.ZodOptional<z.ZodString>;
             prompt: z.ZodOptional<z.ZodString>;
+            interimResults: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
         translation: z.ZodOptional<z.ZodObject<{
             targetLanguage: z.ZodString;
@@ -1505,6 +1531,7 @@ export declare const realtimePublicServerEventSchema: z.ZodDiscriminatedUnion<[z
         inputAudioTranscription: z.ZodOptional<z.ZodObject<{
             language: z.ZodOptional<z.ZodString>;
             prompt: z.ZodOptional<z.ZodString>;
+            interimResults: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
         translation: z.ZodOptional<z.ZodObject<{
             targetLanguage: z.ZodString;
@@ -1581,6 +1608,7 @@ export declare const realtimePublicServerEventSchema: z.ZodDiscriminatedUnion<[z
         inputAudioTranscription: z.ZodOptional<z.ZodObject<{
             language: z.ZodOptional<z.ZodString>;
             prompt: z.ZodOptional<z.ZodString>;
+            interimResults: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
         translation: z.ZodOptional<z.ZodObject<{
             targetLanguage: z.ZodString;
@@ -1827,6 +1855,16 @@ export declare const realtimePublicServerEventSchema: z.ZodDiscriminatedUnion<[z
     requestId: z.ZodString;
     sequence: z.ZodNumber;
     commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"transcript.interim">;
+    source: z.ZodLiteral<"input_audio">;
+    itemId: z.ZodString;
+    contentIndex: z.ZodNumber;
+    text: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"text.delta">;
     responseId: z.ZodString;

package/dist/public/realtime.js

@@ -4,6 +4,7 @@
  * Moved from `@oxy.so/contracts` 4.12.0 (`src/inference/realtime.ts`) by Kaana ADR 0002.
  */
 import { z } from 'zod';
+import { maxUtf16Length, minUtf16Length } from '../stringBounds.js';
 import { realtimeAudioFormatSchema, realtimeOutputModalitySchema } from './audioFormats.js';
 import { realtimeSessionKindSchema, realtimeSessionTransportSchema, } from './catalogue.js';
 import { inferenceTimestampSchema, modelReferenceSchema, PADDED_BASE64_PATTERN, requestIdSchema, } from './identifiers.js';
@@ -36,15 +37,21 @@ export const MAX_REALTIME_RESUME_WINDOW_MS = 60_000;
  */
 export const MAX_REALTIME_ITEM_TEXT_CHARS = 1_048_576;
 /** A client-chosen command identity, unique within one session. */
-export const realtimeCommandIdSchema = z.string().min(1).max(128);
+export const realtimeCommandIdSchema = z
+    .string()
+    .check(minUtf16Length(1))
+    .check(maxUtf16Length(128));
 /** A conversation item's identity within one session. */
-export const realtimeItemIdSchema = z.string().min(1).max(128);
+export const realtimeItemIdSchema = z.string().check(minUtf16Length(1)).check(maxUtf16Length(128));
 /** A response's identity within one session. */
-export const realtimeResponseIdSchema = z.string().min(1).max(128);
+export const realtimeResponseIdSchema = z
+    .string()
+    .check(minUtf16Length(1))
+    .check(maxUtf16Length(128));
 const audioFrameSchema = z
     .string()
-    .min(4)
-    .max(MAX_REALTIME_AUDIO_FRAME_BASE64_LENGTH)
+    .check(minUtf16Length(4))
+    .check(maxUtf16Length(MAX_REALTIME_AUDIO_FRAME_BASE64_LENGTH))
     .regex(PADDED_BASE64_PATTERN);
 const sequenceSchema = z.number().int().nonnegative().safe();
 const milliseconds = z.number().int().nonnegative().safe();
@@ -106,16 +113,22 @@ export const realtimeInputTranscriptionSchema = z
      * the provider its spelling of that language, or none for the model to
      * detect; it is never refused.
      */
-    language: z.string().min(2).max(35).optional(),
+    language: z.string().check(minUtf16Length(2)).check(maxUtf16Length(35)).optional(),
     /** A hint — vocabulary or context — used where the model takes one. */
-    prompt: z.string().max(4_096).optional(),
+    prompt: z.string().check(maxUtf16Length(4_096)).optional(),
+    /**
+     * Send `transcript.interim`: the model's provisional text of the current
+     * item, about every half second, before any of it is final (contract set
+     * 8.1.0, Kaana ADR 0006). Only a `transcription` session sends it.
+     */
+    interimResults: z.boolean().optional(),
 })
     .strict();
 /** The target of a `translation` session. */
 export const realtimeTranslationSchema = z
     .object({
     /** A BCP 47 tag. */
-    targetLanguage: z.string().min(2).max(35),
+    targetLanguage: z.string().check(minUtf16Length(2)).check(maxUtf16Length(35)),
 })
     .strict();
 /**
@@ -134,9 +147,9 @@ export const realtimeToolDefinitionSchema = toolDefinitionSchema.omit({ strict:
  */
 export const realtimeSessionConfigSchema = z
     .object({
-    instructions: z.string().max(32_768).optional(),
+    instructions: z.string().check(maxUtf16Length(32_768)).optional(),
     outputModalities: z.array(realtimeOutputModalitySchema).min(1).max(2).optional(),
-    voice: z.string().min(1).max(64).optional(),
+    voice: z.string().check(minUtf16Length(1)).check(maxUtf16Length(64)).optional(),
     inputAudioFormat: realtimeAudioFormatSchema,
     outputAudioFormat: realtimeAudioFormatSchema.optional(),
     turnDetection: realtimeTurnDetectionSchema,
@@ -158,7 +171,7 @@ export const realtimeSessionConfigSchema = z
  */
 export const realtimeSessionConfigUpdateSchema = z
     .object({
-    instructions: z.string().max(32_768).optional(),
+    instructions: z.string().check(maxUtf16Length(32_768)).optional(),
     outputModalities: z.array(realtimeOutputModalitySchema).min(1).max(2).optional(),
     turnDetection: realtimeTurnDetectionSchema.optional(),
     inputAudioTranscription: realtimeInputTranscriptionSchema.optional(),
@@ -199,7 +212,10 @@ export const realtimeSessionLimitsSchema = z
  */
 export const realtimeContentPartSchema = z.discriminatedUnion('type', [
     z
-        .object({ type: z.literal('input_text'), text: z.string().max(MAX_REALTIME_ITEM_TEXT_CHARS) })
+        .object({
+        type: z.literal('input_text'),
+        text: z.string().check(maxUtf16Length(MAX_REALTIME_ITEM_TEXT_CHARS)),
+    })
         .strict(),
     z
         .object({
@@ -239,8 +255,8 @@ export const realtimeConversationItemSchema = z
         .object({
         type: z.literal('function_call'),
         itemId: realtimeItemIdSchema.optional(),
-        callId: z.string().min(1).max(128),
-        name: z.string().min(1).max(128),
+        callId: z.string().check(minUtf16Length(1)).check(maxUtf16Length(128)),
+        name: z.string().check(minUtf16Length(1)).check(maxUtf16Length(128)),
         arguments: z.string(),
     })
         .strict(),
@@ -248,8 +264,8 @@ export const realtimeConversationItemSchema = z
         .object({
         type: z.literal('function_call_output'),
         itemId: realtimeItemIdSchema.optional(),
-        callId: z.string().min(1).max(128),
-        output: z.string().max(MAX_REALTIME_ITEM_TEXT_CHARS),
+        callId: z.string().check(minUtf16Length(1)).check(maxUtf16Length(128)),
+        output: z.string().check(maxUtf16Length(MAX_REALTIME_ITEM_TEXT_CHARS)),
     })
         .strict(),
 ])
@@ -279,7 +295,7 @@ export const realtimeConversationItemSchema = z
 /** Per-response overrides for `response.create`. Absent fields keep the session's. */
 export const realtimeResponseParametersSchema = z
     .object({
-    instructions: z.string().max(32_768).optional(),
+    instructions: z.string().check(maxUtf16Length(32_768)).optional(),
     outputModalities: z.array(realtimeOutputModalitySchema).min(1).max(2).optional(),
     maxOutputTokens: z.number().int().positive().safe().optional(),
     toolChoice: toolChoiceSchema.optional(),
@@ -496,6 +512,21 @@ export const realtimeTranscriptDoneEventSchema = z.object({
     responseId: realtimeResponseIdSchema.optional(),
     transcript: z.string(),
 });
+/**
+ * The provisional text of an input item not yet final (contract set 8.1.0,
+ * Kaana ADR 0006): sent only to a `transcription` session that asked for
+ * `interimResults`. Each one REPLACES the item's previous interim text; it is
+ * display state, never settled and never part of the item's transcript, and
+ * the item's next `transcript.delta` or its `transcript.done` supersedes it.
+ */
+export const realtimeTranscriptInterimEventSchema = z.object({
+    ...eventBase,
+    type: z.literal('transcript.interim'),
+    source: z.literal('input_audio'),
+    itemId: realtimeItemIdSchema,
+    contentIndex: z.number().int().nonnegative().safe(),
+    text: z.string(),
+});
 /** Written output of a response (`outputModalities` including `text`). */
 export const realtimeTextDeltaEventSchema = z.object({
     ...eventBase,
@@ -511,8 +542,8 @@ export const realtimeToolCallEventSchema = z.object({
     type: z.literal('tool_call'),
     responseId: realtimeResponseIdSchema,
     itemId: realtimeItemIdSchema,
-    toolCallId: z.string().min(1).max(128),
-    name: z.string().min(1).max(128).optional(),
+    toolCallId: z.string().check(minUtf16Length(1)).check(maxUtf16Length(128)),
+    name: z.string().check(minUtf16Length(1)).check(maxUtf16Length(128)).optional(),
     argumentsDelta: z.string().optional(),
     complete: z.boolean(),
 });
@@ -589,6 +620,9 @@ export function realtimeConfigIssues(kind, config) {
             }
             break;
     }
+    if (kind !== 'transcription' && config.inputAudioTranscription?.interimResults === true) {
+        found(['inputAudioTranscription', 'interimResults'], 'only a transcription session sends interim text');
+    }
     if (config.toolChoice !== undefined && !hasTools) {
         found(['toolChoice'], 'a tool choice requires at least one tool definition');
     }
@@ -644,7 +678,7 @@ export const realtimeSessionOpenSchema = z
     config: realtimeSessionConfigSchema,
     limits: realtimeOpenLimitsSchema.optional(),
     /** The caller's own correlation id. */
-    clientSessionId: z.string().min(1).max(128).optional(),
+    clientSessionId: z.string().check(minUtf16Length(1)).check(maxUtf16Length(128)).optional(),
     labels: requestLabelsSchema.optional(),
 })
     .strict()
@@ -795,6 +829,7 @@ export const realtimePublicServerEventSchema = z
     realtimeOutputAudioDoneEventSchema,
     realtimeTranscriptDeltaEventSchema,
     realtimeTranscriptDoneEventSchema,
+    realtimeTranscriptInterimEventSchema,
     realtimeTextDeltaEventSchema,
     realtimeToolCallEventSchema,
     realtimePublicResponseDoneEventSchema,

package/dist/public/responses.js

@@ -8,6 +8,7 @@
  * catalogue identities), and the response names no serving provider.
  */
 import { z } from 'zod';
+import { maxUtf16Length, minUtf16Length } from '../stringBounds.js';
 import { powerLevelSchema } from './catalogue.js';
 import { generationIdSchema, modelReferenceSchema, requestIdSchema } from './identifiers.js';
 import { inferenceMessageSchema, inferenceReasoningSchema, requestLabelsSchema, responseFormatSchema, toolChoiceSchema, toolDefinitionSchema, } from './messages.js';
@@ -22,7 +23,10 @@ import { inferenceFinishReasonSchema } from './streamEvents.js';
  */
 export const modelTargetSchema = z.union([modelReferenceSchema, powerLevelSchema]);
 /** The message-or-text input `/v1/responses` accepts. */
-const responsesInputSchema = z.union([z.string().min(1), z.array(inferenceMessageSchema).min(1)]);
+const responsesInputSchema = z.union([
+    z.string().check(minUtf16Length(1)),
+    z.array(inferenceMessageSchema).min(1),
+]);
 /**
  * The request. `model` may be absent: the application's routing policy in Oxy
  * Console may name a default target, and the request is refused only when it
@@ -44,7 +48,10 @@ export const responsesRequestSchema = z
     frequencyPenalty: z.number().min(-2).max(2).optional(),
     presencePenalty: z.number().min(-2).max(2).optional(),
     seed: z.number().int().safe().optional(),
-    stopSequences: z.array(z.string().min(1).max(256)).max(8).optional(),
+    stopSequences: z
+        .array(z.string().check(minUtf16Length(1)).check(maxUtf16Length(256)))
+        .max(8)
+        .optional(),
     tools: z.array(toolDefinitionSchema).max(128).optional(),
     toolChoice: toolChoiceSchema.optional(),
     responseFormat: responseFormatSchema.optional(),
@@ -52,7 +59,7 @@ export const responsesRequestSchema = z
     reasoning: inferenceReasoningSchema.optional(),
     labels: requestLabelsSchema.optional(),
     /** The caller's own correlation id, echoed on the response. */
-    clientRequestId: z.string().min(1).max(128).optional(),
+    clientRequestId: z.string().check(minUtf16Length(1)).check(maxUtf16Length(128)).optional(),
 })
     .strict()
     .superRefine((request, ctx) => {

package/dist/public/streamEvents.js

@@ -5,6 +5,7 @@
  * Moved from `@oxy.so/contracts` 4.12.0 (`src/inference/streamEvents.ts`) by Kaana ADR 0002.
  */
 import { z } from 'zod';
+import { maxUtf16Length, minUtf16Length } from '../stringBounds.js';
 import { generationIdSchema, inferenceTimestampSchema, modelReferenceSchema, PADDED_BASE64_PATTERN, requestIdSchema, } from './identifiers.js';
 import { publicErrorSchema } from './errors.js';
 import { usageQuantitySchema, usageSourceSchema } from './money.js';
@@ -51,7 +52,11 @@ export const inferenceStreamAudioEventSchema = z.object({
     sequence: z.number().int().nonnegative().safe(),
     outputIndex: z.number().int().nonnegative().safe(),
     mediaType: inferenceAudioMediaTypeSchema,
-    data: z.string().min(4).max(65536).regex(PADDED_BASE64_PATTERN),
+    data: z
+        .string()
+        .check(minUtf16Length(4))
+        .check(maxUtf16Length(65536))
+        .regex(PADDED_BASE64_PATTERN),
 });
 /**
  * A tool call being streamed.
@@ -65,9 +70,9 @@ export const inferenceStreamToolCallEventSchema = z.object({
     type: z.literal('tool_call'),
     requestId: requestIdSchema,
     sequence: z.number().int().nonnegative().safe(),
-    toolCallId: z.string().min(1).max(128),
+    toolCallId: z.string().check(minUtf16Length(1)).check(maxUtf16Length(128)),
     /** Present on the first event of a call. */
-    name: z.string().min(1).max(128).optional(),
+    name: z.string().check(minUtf16Length(1)).check(maxUtf16Length(128)).optional(),
     argumentsDelta: z.string().optional(),
     complete: z.boolean(),
 });
@@ -103,7 +108,7 @@ export const inferenceStreamDoneEventSchema = z.object({
     sequence: z.number().int().nonnegative().safe(),
     generationId: generationIdSchema.optional(),
     finishReason: inferenceFinishReasonSchema,
-    receiptId: z.string().min(1).max(128).optional(),
+    receiptId: z.string().check(minUtf16Length(1)).check(maxUtf16Length(128)).optional(),
     completedAt: inferenceTimestampSchema,
 });
 /* -------------------------------------------------------------------------- */

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.0.0";
+export declare const INFERENCE_CONTRACT_VERSION = "8.1.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:
@@ -181,6 +181,12 @@ export declare const INFERENCE_CONTRACT_VERSION = "8.0.0";
  * envelopes v3 and v4 (`scopedExecutionSchema`, `privateAutoExecutionSchema`
  * and every shape under them) and a deployment's `scopedExecution`. A grant
  * or a request that parsed under 6.0.0 without them still parses the same.
+ *
+ * Contract set 8.1.0 (Kaana ADR 0006) is additive: a `transcription`
+ * session's `inputAudioTranscription.interimResults`, and the
+ * `transcript.interim` event it asks for, the provisional text of an input
+ * item that the item's deltas and its `transcript.done` supersede. Any other
+ * kind asking for interim text is refused. Nothing in 8.0.0 changes.
  */
 /** 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.0.0';
+export const INFERENCE_CONTRACT_VERSION = '8.1.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:
@@ -181,6 +181,12 @@ export const INFERENCE_CONTRACT_VERSION = '8.0.0';
  * envelopes v3 and v4 (`scopedExecutionSchema`, `privateAutoExecutionSchema`
  * and every shape under them) and a deployment's `scopedExecution`. A grant
  * or a request that parsed under 6.0.0 without them still parses the same.
+ *
+ * Contract set 8.1.0 (Kaana ADR 0006) is additive: a `transcription`
+ * session's `inputAudioTranscription.interimResults`, and the
+ * `transcript.interim` event it asks for, the provisional text of an input
+ * item that the item's deltas and its `transcript.done` supersede. Any other
+ * kind asking for interim text is refused. Nothing in 8.0.0 changes.
  */
 /** The public API's one origin and version. */
 export const KAANA_API_BASE_URL = 'https://kaana.ai/v1';

package/dist/stringBounds.d.ts

@@ -0,0 +1,11 @@
+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 declare function minUtf16Length(minimum: number): z.core.$ZodCheck<string>;
+export declare function maxUtf16Length(maximum: number): z.core.$ZodCheck<string>;
+export declare function utf16Length(length: number): z.core.$ZodCheck<string>;