@kaana.ai/contracts 8.2.0 → 8.4.0

package/dist/public/realtime.d.ts

@@ -284,8 +284,8 @@ export declare const realtimeConversationItemSchema: z.ZodDiscriminatedUnion<[z.
     type: z.ZodLiteral<"message">;
     itemId: z.ZodOptional<z.ZodString>;
     role: z.ZodEnum<{
-        user: "user";
         system: "system";
+        user: "user";
         assistant: "assistant";
     }>;
     content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -401,8 +401,8 @@ export declare const realtimeItemCreateCommandSchema: z.ZodObject<{
         type: z.ZodLiteral<"message">;
         itemId: z.ZodOptional<z.ZodString>;
         role: z.ZodEnum<{
-            user: "user";
             system: "system";
+            user: "user";
             assistant: "assistant";
         }>;
         content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -591,8 +591,8 @@ export declare const realtimeClientCommandSchema: z.ZodDiscriminatedUnion<[z.Zod
         type: z.ZodLiteral<"message">;
         itemId: z.ZodOptional<z.ZodString>;
         role: z.ZodEnum<{
-            user: "user";
             system: "system";
+            user: "user";
             assistant: "assistant";
         }>;
         content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -796,8 +796,8 @@ export declare const realtimeItemAddedEventSchema: z.ZodObject<{
         type: z.ZodLiteral<"message">;
         itemId: z.ZodOptional<z.ZodString>;
         role: z.ZodEnum<{
-            user: "user";
             system: "system";
+            user: "user";
             assistant: "assistant";
         }>;
         content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -848,8 +848,8 @@ export declare const realtimeItemDoneEventSchema: z.ZodObject<{
         type: z.ZodLiteral<"message">;
         itemId: z.ZodOptional<z.ZodString>;
         role: z.ZodEnum<{
-            user: "user";
             system: "system";
+            user: "user";
             assistant: "assistant";
         }>;
         content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1365,6 +1365,7 @@ export declare const realtimePublicResponseDoneEventSchema: z.ZodObject<{
             audio_output_tokens: "audio_output_tokens";
             session_milliseconds: "session_milliseconds";
             input_transcription_milliseconds: "input_transcription_milliseconds";
+            cache_write_input_tokens: "cache_write_input_tokens";
         }>;
         quantity: z.ZodNumber;
     }, z.core.$strict>>;
@@ -1468,6 +1469,7 @@ export declare const realtimePublicSessionClosedEventSchema: z.ZodObject<{
             audio_output_tokens: "audio_output_tokens";
             session_milliseconds: "session_milliseconds";
             input_transcription_milliseconds: "input_transcription_milliseconds";
+            cache_write_input_tokens: "cache_write_input_tokens";
         }>;
         quantity: z.ZodNumber;
     }, z.core.$strict>>;
@@ -1655,8 +1657,8 @@ export declare const realtimePublicServerEventSchema: z.ZodDiscriminatedUnion<[z
         type: z.ZodLiteral<"message">;
         itemId: z.ZodOptional<z.ZodString>;
         role: z.ZodEnum<{
-            user: "user";
             system: "system";
+            user: "user";
             assistant: "assistant";
         }>;
         content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1706,8 +1708,8 @@ export declare const realtimePublicServerEventSchema: z.ZodDiscriminatedUnion<[z
         type: z.ZodLiteral<"message">;
         itemId: z.ZodOptional<z.ZodString>;
         role: z.ZodEnum<{
-            user: "user";
             system: "system";
+            user: "user";
             assistant: "assistant";
         }>;
         content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1922,6 +1924,7 @@ export declare const realtimePublicServerEventSchema: z.ZodDiscriminatedUnion<[z
             audio_output_tokens: "audio_output_tokens";
             session_milliseconds: "session_milliseconds";
             input_transcription_milliseconds: "input_transcription_milliseconds";
+            cache_write_input_tokens: "cache_write_input_tokens";
         }>;
         quantity: z.ZodNumber;
     }, z.core.$strict>>;
@@ -2018,6 +2021,7 @@ export declare const realtimePublicServerEventSchema: z.ZodDiscriminatedUnion<[z
             audio_output_tokens: "audio_output_tokens";
             session_milliseconds: "session_milliseconds";
             input_transcription_milliseconds: "input_transcription_milliseconds";
+            cache_write_input_tokens: "cache_write_input_tokens";
         }>;
         quantity: z.ZodNumber;
     }, z.core.$strict>>;

package/dist/public/responses.d.ts

@@ -44,9 +44,9 @@ export declare const responsesRequestSchema: z.ZodObject<{
     }>]>>;
     input: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodObject<{
         role: z.ZodEnum<{
-            user: "user";
             system: "system";
             developer: "developer";
+            user: "user";
             assistant: "assistant";
             tool: "tool";
         }>;
@@ -164,9 +164,9 @@ export declare const responseSchema: z.ZodObject<{
     }>;
     output: z.ZodArray<z.ZodObject<{
         role: z.ZodEnum<{
-            user: "user";
             system: "system";
             developer: "developer";
+            user: "user";
             assistant: "assistant";
             tool: "tool";
         }>;
@@ -239,6 +239,7 @@ export declare const responseSchema: z.ZodObject<{
             audio_output_tokens: "audio_output_tokens";
             session_milliseconds: "session_milliseconds";
             input_transcription_milliseconds: "input_transcription_milliseconds";
+            cache_write_input_tokens: "cache_write_input_tokens";
         }>;
         quantity: z.ZodNumber;
     }, z.core.$strict>>;

package/dist/public/streamEvents.d.ts

@@ -153,6 +153,7 @@ export declare const responseStreamUsageEventSchema: z.ZodObject<{
             audio_output_tokens: "audio_output_tokens";
             session_milliseconds: "session_milliseconds";
             input_transcription_milliseconds: "input_transcription_milliseconds";
+            cache_write_input_tokens: "cache_write_input_tokens";
         }>;
         quantity: z.ZodNumber;
     }, z.core.$strict>>;
@@ -284,6 +285,7 @@ export declare const responseStreamEventSchema: z.ZodDiscriminatedUnion<[z.ZodOb
             audio_output_tokens: "audio_output_tokens";
             session_milliseconds: "session_milliseconds";
             input_transcription_milliseconds: "input_transcription_milliseconds";
+            cache_write_input_tokens: "cache_write_input_tokens";
         }>;
         quantity: 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.2.0";
+export declare const INFERENCE_CONTRACT_VERSION = "8.4.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:
@@ -195,6 +195,19 @@ export declare const INFERENCE_CONTRACT_VERSION = "8.2.0";
  * grant fact `inputImages`. Every 8.1.0 message parses the same; a consumer on
  * 8.1.0 or earlier refuses a declared catalogue or an authorization carrying
  * what is new, so Oxy reads them before Kaana publishes them.
+ *
+ * Contract set 8.3.0 is additive: the Anthropic-Messages-compatible
+ * `POST /v1/messages` (`anthropicMessagesRequestSchema`,
+ * `anthropicMessageSchema`, `anthropicStreamEventSchema`,
+ * `anthropicErrorSchema`). Nothing in 8.2.0 changes, and the signed grant and
+ * envelope are untouched: the endpoint is served as the `responses` operation.
+ *
+ * Contract set 8.4.0 is additive: the usage unit `cache_write_input_tokens`
+ * (input tokens written to a prompt cache, a sibling under the partition rule,
+ * default TTL only) and the optional `capabilities.unreported` (the boolean
+ * capabilities whose `false` is not evidence). Nothing in 8.3.0 changes and
+ * nothing emits either yet: a consumer on 8.3.0 refuses a usage report carrying
+ * the unit and a catalogue carrying the field, so Oxy reads them first.
  */
 /** 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.2.0';
+export const INFERENCE_CONTRACT_VERSION = '8.4.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:
@@ -195,6 +195,19 @@ export const INFERENCE_CONTRACT_VERSION = '8.2.0';
  * grant fact `inputImages`. Every 8.1.0 message parses the same; a consumer on
  * 8.1.0 or earlier refuses a declared catalogue or an authorization carrying
  * what is new, so Oxy reads them before Kaana publishes them.
+ *
+ * Contract set 8.3.0 is additive: the Anthropic-Messages-compatible
+ * `POST /v1/messages` (`anthropicMessagesRequestSchema`,
+ * `anthropicMessageSchema`, `anthropicStreamEventSchema`,
+ * `anthropicErrorSchema`). Nothing in 8.2.0 changes, and the signed grant and
+ * envelope are untouched: the endpoint is served as the `responses` operation.
+ *
+ * Contract set 8.4.0 is additive: the usage unit `cache_write_input_tokens`
+ * (input tokens written to a prompt cache, a sibling under the partition rule,
+ * default TTL only) and the optional `capabilities.unreported` (the boolean
+ * capabilities whose `false` is not evidence). Nothing in 8.3.0 changes and
+ * nothing emits either yet: a consumer on 8.3.0 refuses a usage report carrying
+ * the unit and a catalogue carrying the field, so Oxy reads them first.
  */
 /** The public API's one origin and version. */
 export const KAANA_API_BASE_URL = 'https://kaana.ai/v1';