@kaana.ai/contracts 8.14.0 → 8.16.0

package/dist/internal/catalogue.d.ts

@@ -98,7 +98,14 @@ export declare const catalogueModelSchema: z.ZodObject<{
                 conversation: "conversation";
                 transcription: "transcription";
                 translation: "translation";
+                live: "live";
             }>>;
+            defaultKinds: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                conversation: "conversation";
+                transcription: "transcription";
+                translation: "translation";
+                live: "live";
+            }>>>;
             inputAudioTranscription: z.ZodOptional<z.ZodBoolean>;
             audioFormats: z.ZodOptional<z.ZodObject<{
                 input: z.ZodArray<z.ZodEnum<{
@@ -428,7 +435,14 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
                 conversation: "conversation";
                 transcription: "transcription";
                 translation: "translation";
+                live: "live";
             }>>;
+            defaultKinds: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                conversation: "conversation";
+                transcription: "transcription";
+                translation: "translation";
+                live: "live";
+            }>>>;
             inputAudioTranscription: z.ZodOptional<z.ZodBoolean>;
             audioFormats: z.ZodOptional<z.ZodObject<{
                 input: z.ZodArray<z.ZodEnum<{
@@ -704,7 +718,14 @@ export declare const declaredModelSchema: z.ZodObject<{
                 conversation: "conversation";
                 transcription: "transcription";
                 translation: "translation";
+                live: "live";
             }>>;
+            defaultKinds: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                conversation: "conversation";
+                transcription: "transcription";
+                translation: "translation";
+                live: "live";
+            }>>>;
             inputAudioTranscription: z.ZodOptional<z.ZodBoolean>;
             audioFormats: z.ZodOptional<z.ZodObject<{
                 input: z.ZodArray<z.ZodEnum<{
@@ -943,7 +964,14 @@ export declare const declaredCatalogueSchema: z.ZodObject<{
                     conversation: "conversation";
                     transcription: "transcription";
                     translation: "translation";
+                    live: "live";
                 }>>;
+                defaultKinds: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                    conversation: "conversation";
+                    transcription: "transcription";
+                    translation: "translation";
+                    live: "live";
+                }>>>;
                 inputAudioTranscription: z.ZodOptional<z.ZodBoolean>;
                 audioFormats: z.ZodOptional<z.ZodObject<{
                     input: z.ZodArray<z.ZodEnum<{

package/dist/internal/catalogue.js

@@ -417,4 +417,27 @@ export const declaredCatalogueSchema = z
     schemaVersion: z.literal(1),
     models: z.array(declaredModelSchema),
 })
-    .strict();
+    .strict()
+    .superRefine((catalogue, ctx) => {
+    // A kind has one default (contract set 8.16.0, Kaana ADR 0012): a client
+    // opens the default line of a kind, so two active defaults would leave the
+    // choice to whichever the client read first.
+    const defaults = new Map();
+    for (const [index, model] of catalogue.models.entries()) {
+        if (model.deprecation.status !== 'active')
+            continue;
+        for (const kind of model.capabilities.realtime?.defaultKinds ?? []) {
+            const first = defaults.get(kind);
+            if (first !== undefined) {
+                ctx.addIssue({
+                    code: 'custom',
+                    path: ['models', index, 'capabilities', 'realtime', 'defaultKinds'],
+                    message: `models[${first}] is already the default ${kind} line: at most one active line is the default of a kind`,
+                });
+            }
+            else {
+                defaults.set(kind, index);
+            }
+        }
+    }
+});

package/dist/internal/grant.d.ts

@@ -82,6 +82,7 @@ export declare const grantRequestFactsSchema: z.ZodObject<{
         conversation: "conversation";
         transcription: "transcription";
         translation: "translation";
+        live: "live";
     }>>;
 }, z.core.$strict>;
 /**
@@ -135,6 +136,7 @@ export declare const inferenceAuthorizationRequestSchema: z.ZodObject<{
             conversation: "conversation";
             transcription: "transcription";
             translation: "translation";
+            live: "live";
         }>>;
     }, z.core.$strict>;
     idempotencyKey: z.ZodOptional<z.ZodString>;
@@ -216,6 +218,7 @@ export declare const authorizationRequestSchema: z.ZodDiscriminatedUnion<[z.ZodO
             conversation: "conversation";
             transcription: "transcription";
             translation: "translation";
+            live: "live";
         }>>;
     }, z.core.$strict>;
     idempotencyKey: z.ZodOptional<z.ZodString>;

package/dist/internal/realtime.d.ts

@@ -64,6 +64,7 @@ export declare const realtimeSessionRequestSchema: z.ZodObject<{
         conversation: "conversation";
         transcription: "transcription";
         translation: "translation";
+        live: "live";
     }>;
     transport: z.ZodEnum<{
         websocket: "websocket";
@@ -128,6 +129,12 @@ export declare const realtimeSessionRequestSchema: z.ZodObject<{
             name: z.ZodString;
         }, z.core.$strict>]>>;
         maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+        delegation: z.ZodOptional<z.ZodObject<{
+            acknowledgement: z.ZodEnum<{
+                auto: "auto";
+                none: "none";
+            }>;
+        }, z.core.$strict>>;
     }, z.core.$strict>;
     limits: z.ZodObject<{
         maxDurationMs: z.ZodNumber;
@@ -208,6 +215,7 @@ export declare const realtimeSessionCreatedEventSchema: z.ZodObject<{
         conversation: "conversation";
         transcription: "transcription";
         translation: "translation";
+        live: "live";
     }>;
     config: z.ZodObject<{
         instructions: z.ZodOptional<z.ZodString>;
@@ -269,6 +277,12 @@ export declare const realtimeSessionCreatedEventSchema: z.ZodObject<{
             name: z.ZodString;
         }, z.core.$strict>]>>;
         maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+        delegation: z.ZodOptional<z.ZodObject<{
+            acknowledgement: z.ZodEnum<{
+                auto: "auto";
+                none: "none";
+            }>;
+        }, z.core.$strict>>;
     }, z.core.$strict>;
     limits: z.ZodObject<{
         maxDurationMs: z.ZodNumber;
@@ -468,6 +482,7 @@ export declare const realtimeServerEventSchema: z.ZodDiscriminatedUnion<[z.ZodOb
         conversation: "conversation";
         transcription: "transcription";
         translation: "translation";
+        live: "live";
     }>;
     config: z.ZodObject<{
         instructions: z.ZodOptional<z.ZodString>;
@@ -529,6 +544,12 @@ export declare const realtimeServerEventSchema: z.ZodDiscriminatedUnion<[z.ZodOb
             name: z.ZodString;
         }, z.core.$strict>]>>;
         maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+        delegation: z.ZodOptional<z.ZodObject<{
+            acknowledgement: z.ZodEnum<{
+                auto: "auto";
+                none: "none";
+            }>;
+        }, z.core.$strict>>;
     }, z.core.$strict>;
     limits: z.ZodObject<{
         maxDurationMs: z.ZodNumber;
@@ -606,6 +627,12 @@ export declare const realtimeServerEventSchema: z.ZodDiscriminatedUnion<[z.ZodOb
             name: z.ZodString;
         }, z.core.$strict>]>>;
         maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+        delegation: z.ZodOptional<z.ZodObject<{
+            acknowledgement: z.ZodEnum<{
+                auto: "auto";
+                none: "none";
+            }>;
+        }, z.core.$strict>>;
     }, z.core.$strict>;
     schemaVersion: z.ZodLiteral<1>;
     requestId: z.ZodString;
@@ -865,6 +892,21 @@ export declare const realtimeServerEventSchema: z.ZodDiscriminatedUnion<[z.ZodOb
     requestId: z.ZodString;
     sequence: z.ZodNumber;
     commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"delegation.requested">;
+    delegationId: z.ZodString;
+    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<"delegation.superseded">;
+    delegationId: 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<"response.done">;
     responseId: z.ZodString;

package/dist/internal/realtime.js

@@ -11,7 +11,7 @@ import { inferenceTimestampSchema, modelReferenceSchema, requestIdSchema, } from
 import { usageQuantitySchema, usageSourceSchema } from '../public/money.js';
 import { routingPolicyReferenceSchema } from '../public/policy.js';
 import { inferenceFinishReasonSchema } from '../public/streamEvents.js';
-import { MAX_REALTIME_RESUME_WINDOW_MS, realtimeCommandAcceptedEventSchema, realtimeCommandIdSchema, realtimeConfigIssues, realtimeInputAudioClearedEventSchema, realtimeInputAudioCommittedEventSchema, realtimeItemAddedEventSchema, realtimeItemDeletedEventSchema, realtimeItemDoneEventSchema, realtimeItemTruncatedEventSchema, realtimeOutputAudioDeltaEventSchema, realtimeOutputAudioDoneEventSchema, realtimeResponseCreatedEventSchema, realtimeResponseIdSchema, realtimeResponseStatusSchema, realtimeSessionCloseReasonSchema, realtimeSessionConfigSchema, realtimeSessionLimitsSchema, realtimeSessionResumedEventSchema, realtimeSessionUpdatedEventSchema, realtimeSpeechStartedEventSchema, realtimeSpeechStoppedEventSchema, realtimeTextDeltaEventSchema, realtimeToolCallEventSchema, realtimeTranscriptDeltaEventSchema, realtimeTranscriptDoneEventSchema, realtimeTranscriptInterimEventSchema, } from '../public/realtime.js';
+import { MAX_REALTIME_RESUME_WINDOW_MS, realtimeCommandAcceptedEventSchema, realtimeCommandIdSchema, realtimeConfigIssues, realtimeDelegationRequestedEventSchema, realtimeDelegationSupersededEventSchema, realtimeInputAudioClearedEventSchema, realtimeInputAudioCommittedEventSchema, realtimeItemAddedEventSchema, realtimeItemDeletedEventSchema, realtimeItemDoneEventSchema, realtimeItemTruncatedEventSchema, realtimeOutputAudioDeltaEventSchema, realtimeOutputAudioDoneEventSchema, realtimeResponseCreatedEventSchema, realtimeResponseIdSchema, realtimeResponseStatusSchema, realtimeSessionCloseReasonSchema, realtimeSessionConfigSchema, realtimeSessionLimitsSchema, realtimeSessionResumedEventSchema, realtimeSessionUpdatedEventSchema, realtimeSpeechStartedEventSchema, realtimeSpeechStoppedEventSchema, realtimeTextDeltaEventSchema, realtimeToolCallEventSchema, realtimeTranscriptDeltaEventSchema, realtimeTranscriptDoneEventSchema, realtimeTranscriptInterimEventSchema, } from '../public/realtime.js';
 import { inferenceAttributionSchema } from './attribution.js';
 import { inferenceErrorSchema } from './errors.js';
 import { deploymentIdSchema, inferenceProviderSlugSchema } from './identifiers.js';
@@ -168,6 +168,8 @@ export const realtimeServerEventSchema = z
     realtimeTranscriptInterimEventSchema,
     realtimeTextDeltaEventSchema,
     realtimeToolCallEventSchema,
+    realtimeDelegationRequestedEventSchema,
+    realtimeDelegationSupersededEventSchema,
     realtimeResponseDoneEventSchema,
     realtimeErrorEventSchema,
     realtimeSessionClosedEventSchema,

package/dist/internal/request.d.ts

@@ -351,6 +351,11 @@ export declare const inferenceRequestSchema: z.ZodObject<{
             b64_json: "b64_json";
         }>>;
     }, z.core.$strict>>;
+    rerank: z.ZodOptional<z.ZodObject<{
+        documents: z.ZodArray<z.ZodString>;
+        topN: z.ZodOptional<z.ZodNumber>;
+        returnDocuments: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
     transcription: z.ZodOptional<z.ZodObject<{
         language: z.ZodOptional<z.ZodString>;
         prompt: z.ZodOptional<z.ZodString>;

package/dist/internal/request.js

@@ -8,7 +8,7 @@ import { maxUtf16Length, minUtf16Length } from '../stringBounds.js';
 import { inferenceApiFormatSchema, inferenceModalitySchema } from '../public/catalogue.js';
 import { decisionInputSchema } from '../public/decisions.js';
 import { idempotencyKeySchema, inferenceTimestampSchema } from '../public/identifiers.js';
-import { inferenceAudioOutputParametersSchema, inferenceMessageSchema, inferenceReasoningSchema, inferenceImageParametersSchema, inferenceSpeechParametersSchema, inferenceTranscriptionParametersSchema, responseFormatSchema, samplingParametersSchema, toolChoiceSchema, toolDefinitionSchema, } from '../public/messages.js';
+import { inferenceAudioOutputParametersSchema, inferenceMessageSchema, inferenceReasoningSchema, inferenceImageParametersSchema, inferenceRerankParametersSchema, inferenceSpeechParametersSchema, inferenceTranscriptionParametersSchema, responseFormatSchema, samplingParametersSchema, toolChoiceSchema, toolDefinitionSchema, } from '../public/messages.js';
 import { routingPolicyReferenceSchema } from '../public/policy.js';
 import { inferenceAttributionSchema } from './attribution.js';
 import { authorizedRouteSchema, routingTargetSchema } from './routing.js';
@@ -95,6 +95,8 @@ const inferenceRequestObjectSchema = z.object({
     speech: inferenceSpeechParametersSchema.optional(),
     /** Text-to-image controls. Contract set 8.12.0. */
     image: inferenceImageParametersSchema.optional(),
+    /** The documents and controls of a rerank request. Contract set 8.15.0. */
+    rerank: inferenceRerankParametersSchema.optional(),
     /** File transcription parameters. Contract set 4.5.0. */
     transcription: inferenceTranscriptionParametersSchema.optional(),
     /** Spoken output from a conversational model. Contract set 3.2.0. */
@@ -171,6 +173,7 @@ export const inferenceRequestSchema = inferenceRequestObjectSchema.superRefine((
             request.reasoning !== undefined ||
             request.speech !== undefined ||
             request.image !== undefined ||
+            request.rerank !== undefined ||
             request.transcription !== undefined ||
             request.audioOutput !== undefined) {
             ctx.addIssue({
@@ -209,6 +212,19 @@ export const inferenceRequestSchema = inferenceRequestObjectSchema.superRefine((
             message: 'image parameters require the images_generations API format with image modality and text input',
         });
     }
+    if ((request.rerank !== undefined || request.client.apiFormat === 'rerank') &&
+        (request.rerank === undefined ||
+            request.client.apiFormat !== 'rerank' ||
+            request.modality !== 'text' ||
+            request.input.format !== 'text' ||
+            request.input.text.length === 0 ||
+            request.stream)) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['rerank'],
+            message: 'a rerank request needs the rerank API format, text modality, a non-empty text query, no streaming and rerank parameters',
+        });
+    }
     if (request.transcription !== undefined &&
         (request.client.apiFormat !== 'audio_transcriptions' ||
             request.modality !== 'audio' ||

package/dist/public/catalogue.d.ts

@@ -93,19 +93,23 @@ export declare const inferenceApiFormatSchema: z.ZodEnum<{
     batches: "batches";
 }>;
 /**
- * What a realtime session is FOR. The three are different upstream products
- * with different event families and different metering, not options of one:
+ * What a realtime session is FOR. They are different upstream products with
+ * different event families and different metering, not options of one:
  *
  *  - `conversation` — a speech-to-speech (or text) model holding a dialogue,
  *    with responses, tool calls and interruption.
  *  - `transcription` — live speech-to-text; the model never responds, it only
  *    transcribes committed input audio.
  *  - `translation` — live speech-to-speech translation into one target language.
+ *  - `live` — a spoken conversation whose turns the CALLER's backend answers
+ *    (contract set 8.16.0, Kaana ADR 0012): the voice hands each turn over as
+ *    `delegation.requested` and speaks the `delegation.reply` it is given.
  */
 export declare const realtimeSessionKindSchema: z.ZodEnum<{
     conversation: "conversation";
     transcription: "transcription";
     translation: "translation";
+    live: "live";
 }>;
 /**
  * How a realtime session is carried. One member today: a WebSocket, whose every
@@ -133,6 +137,13 @@ export declare const realtimeSessionTransportSchema: z.ZodEnum<{
  * - `audioFormats` — the realtime encodings a session may name as
  *   `config.inputAudioFormat` and `config.outputAudioFormat`. These are not the
  *   media types of `audio.audioFormats`, which describe files.
+ *
+ * `defaultKinds` arrived in contract set 8.16.0 (Kaana ADR 0012): the session
+ * kinds for which this line is Kaana's default, each one of its `sessionKinds`.
+ * A client opens the default line of a kind after reading `GET /v1/models`, so
+ * which provider serves a kind is a catalogue decision and never a client
+ * constant. At most one active line is the default of a kind. Absent means the
+ * line is the default of none.
  */
 export declare const modelRealtimeCapabilitiesSchema: z.ZodObject<{
     transports: z.ZodArray<z.ZodEnum<{
@@ -142,7 +153,14 @@ export declare const modelRealtimeCapabilitiesSchema: z.ZodObject<{
         conversation: "conversation";
         transcription: "transcription";
         translation: "translation";
+        live: "live";
     }>>;
+    defaultKinds: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        conversation: "conversation";
+        transcription: "transcription";
+        translation: "translation";
+        live: "live";
+    }>>>;
     inputAudioTranscription: z.ZodOptional<z.ZodBoolean>;
     audioFormats: z.ZodOptional<z.ZodObject<{
         input: z.ZodArray<z.ZodEnum<{
@@ -216,7 +234,14 @@ export declare const modelCapabilitiesSchema: z.ZodObject<{
             conversation: "conversation";
             transcription: "transcription";
             translation: "translation";
+            live: "live";
         }>>;
+        defaultKinds: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            conversation: "conversation";
+            transcription: "transcription";
+            translation: "translation";
+            live: "live";
+        }>>>;
         inputAudioTranscription: z.ZodOptional<z.ZodBoolean>;
         audioFormats: z.ZodOptional<z.ZodObject<{
             input: z.ZodArray<z.ZodEnum<{
@@ -480,7 +505,14 @@ export declare const modelSchema: z.ZodObject<{
                 conversation: "conversation";
                 transcription: "transcription";
                 translation: "translation";
+                live: "live";
             }>>;
+            defaultKinds: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                conversation: "conversation";
+                transcription: "transcription";
+                translation: "translation";
+                live: "live";
+            }>>>;
             inputAudioTranscription: z.ZodOptional<z.ZodBoolean>;
             audioFormats: z.ZodOptional<z.ZodObject<{
                 input: z.ZodArray<z.ZodEnum<{
@@ -707,7 +739,14 @@ export declare const modelListSchema: z.ZodObject<{
                     conversation: "conversation";
                     transcription: "transcription";
                     translation: "translation";
+                    live: "live";
                 }>>;
+                defaultKinds: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                    conversation: "conversation";
+                    transcription: "transcription";
+                    translation: "translation";
+                    live: "live";
+                }>>>;
                 inputAudioTranscription: z.ZodOptional<z.ZodBoolean>;
                 audioFormats: z.ZodOptional<z.ZodObject<{
                     input: z.ZodArray<z.ZodEnum<{

package/dist/public/catalogue.js

@@ -78,16 +78,24 @@ export const inferenceApiFormatSchema = z.enum([
     'batches',
 ]);
 /**
- * What a realtime session is FOR. The three are different upstream products
- * with different event families and different metering, not options of one:
+ * What a realtime session is FOR. They are different upstream products with
+ * different event families and different metering, not options of one:
  *
  *  - `conversation` — a speech-to-speech (or text) model holding a dialogue,
  *    with responses, tool calls and interruption.
  *  - `transcription` — live speech-to-text; the model never responds, it only
  *    transcribes committed input audio.
  *  - `translation` — live speech-to-speech translation into one target language.
+ *  - `live` — a spoken conversation whose turns the CALLER's backend answers
+ *    (contract set 8.16.0, Kaana ADR 0012): the voice hands each turn over as
+ *    `delegation.requested` and speaks the `delegation.reply` it is given.
  */
-export const realtimeSessionKindSchema = z.enum(['conversation', 'transcription', 'translation']);
+export const realtimeSessionKindSchema = z.enum([
+    'conversation',
+    'transcription',
+    'translation',
+    'live',
+]);
 /**
  * How a realtime session is carried. One member today: a WebSocket, whose every
  * frame is one JSON message (see `realtime.ts`). WebRTC and SIP are separate
@@ -112,11 +120,19 @@ export const realtimeSessionTransportSchema = z.enum(['websocket']);
  * - `audioFormats` — the realtime encodings a session may name as
  *   `config.inputAudioFormat` and `config.outputAudioFormat`. These are not the
  *   media types of `audio.audioFormats`, which describe files.
+ *
+ * `defaultKinds` arrived in contract set 8.16.0 (Kaana ADR 0012): the session
+ * kinds for which this line is Kaana's default, each one of its `sessionKinds`.
+ * A client opens the default line of a kind after reading `GET /v1/models`, so
+ * which provider serves a kind is a catalogue decision and never a client
+ * constant. At most one active line is the default of a kind. Absent means the
+ * line is the default of none.
  */
 export const modelRealtimeCapabilitiesSchema = z
     .object({
     transports: z.array(realtimeSessionTransportSchema).min(1),
     sessionKinds: z.array(realtimeSessionKindSchema).min(1),
+    defaultKinds: z.array(realtimeSessionKindSchema).min(1).optional(),
     inputAudioTranscription: z.boolean().optional(),
     audioFormats: z
         .object({
@@ -229,6 +245,25 @@ export const modelCapabilitiesSchema = z
             message: 'each session kind is declared at most once',
         });
     }
+    const defaults = realtime.defaultKinds;
+    if (defaults !== undefined) {
+        if (new Set(defaults).size !== defaults.length) {
+            ctx.addIssue({
+                code: 'custom',
+                path: ['realtime', 'defaultKinds'],
+                message: 'each default kind is declared at most once',
+            });
+        }
+        for (const [index, kind] of defaults.entries()) {
+            if (!realtime.sessionKinds.includes(kind)) {
+                ctx.addIssue({
+                    code: 'custom',
+                    path: ['realtime', 'defaultKinds', index],
+                    message: `a line is the default only of a kind it holds, and it holds no ${kind} session`,
+                });
+            }
+        }
+    }
     if (new Set(realtime.transports).size !== realtime.transports.length) {
         ctx.addIssue({
             code: 'custom',

package/dist/public/messages.d.ts

@@ -361,6 +361,16 @@ export declare const inferenceImageParametersSchema: z.ZodObject<{
         b64_json: "b64_json";
     }>>;
 }, z.core.$strict>;
+/**
+ * The documents and controls of a rerank request (contract set 8.15.0), carried
+ * in the signed envelope beside the query (the envelope's text input). Strings
+ * only, as on the public request. Customer data: never logged or persisted.
+ */
+export declare const inferenceRerankParametersSchema: z.ZodObject<{
+    documents: z.ZodArray<z.ZodString>;
+    topN: z.ZodOptional<z.ZodNumber>;
+    returnDocuments: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
 /**
  * Parameters for a file transcription, preserved in the signed request
  * (contract set 4.5.0). `language` is the caller's statement of what is spoken,
@@ -404,6 +414,7 @@ export declare const inferenceAudioOutputParametersSchema: z.ZodObject<{
  * Moved from the Oxy edge (`packages/api/src/schemas/inferenceEdge.schemas.ts`).
  */
 export declare const requestLabelsSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+export type InferenceRerankParameters = z.infer<typeof inferenceRerankParametersSchema>;
 export type InferenceImageParameters = z.infer<typeof inferenceImageParametersSchema>;
 export type InferenceSpeechParameters = z.infer<typeof inferenceSpeechParametersSchema>;
 export type InferenceTranscriptionParameters = z.infer<typeof inferenceTranscriptionParametersSchema>;

package/dist/public/messages.js

@@ -429,6 +429,21 @@ export const inferenceImageParametersSchema = z
     responseFormat: z.enum(['url', 'b64_json']).optional(),
 })
     .strict();
+/**
+ * The documents and controls of a rerank request (contract set 8.15.0), carried
+ * in the signed envelope beside the query (the envelope's text input). Strings
+ * only, as on the public request. Customer data: never logged or persisted.
+ */
+export const inferenceRerankParametersSchema = z
+    .object({
+    documents: z
+        .array(z.string().check(minUtf16Length(1)))
+        .min(1)
+        .max(1000),
+    topN: z.number().int().min(1).optional(),
+    returnDocuments: z.boolean().optional(),
+})
+    .strict();
 /**
  * Parameters for a file transcription, preserved in the signed request
  * (contract set 4.5.0). `language` is the caller's statement of what is spoken,