@kaana.ai/contracts 8.3.0 → 8.4.0

package/dist/internal/catalogue.d.ts

@@ -113,6 +113,13 @@ export declare const catalogueModelSchema: z.ZodObject<{
                 }>>;
             }, z.core.$strict>>;
         }, z.core.$strict>>;
+        unreported: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            tools: "tools";
+            parallelToolCalls: "parallelToolCalls";
+            structuredOutput: "structuredOutput";
+            jsonMode: "jsonMode";
+            promptCaching: "promptCaching";
+        }>>>;
     }, z.core.$strict>;
     license: z.ZodObject<{
         licenseId: z.ZodString;
@@ -436,6 +443,13 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
                 }>>;
             }, z.core.$strict>>;
         }, z.core.$strict>>;
+        unreported: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            tools: "tools";
+            parallelToolCalls: "parallelToolCalls";
+            structuredOutput: "structuredOutput";
+            jsonMode: "jsonMode";
+            promptCaching: "promptCaching";
+        }>>>;
     }, z.core.$strict>;
     license: z.ZodObject<{
         licenseId: z.ZodString;
@@ -501,6 +515,7 @@ export declare const modelCatalogueEntrySchema: 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";
             }>;
             amount: z.core.$ZodBranded<z.ZodString, "ExactDecimal", "out">;
             per: z.ZodNumber;
@@ -704,6 +719,13 @@ export declare const declaredModelSchema: z.ZodObject<{
                 }>>;
             }, z.core.$strict>>;
         }, z.core.$strict>>;
+        unreported: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            tools: "tools";
+            parallelToolCalls: "parallelToolCalls";
+            structuredOutput: "structuredOutput";
+            jsonMode: "jsonMode";
+            promptCaching: "promptCaching";
+        }>>>;
     }, z.core.$strict>;
     license: z.ZodObject<{
         licenseId: z.ZodString;
@@ -767,6 +789,7 @@ export declare const declaredModelSchema: 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";
             }>;
             amount: z.core.$ZodBranded<z.ZodString, "ExactDecimal", "out">;
             per: z.ZodNumber;
@@ -935,6 +958,13 @@ export declare const declaredCatalogueSchema: z.ZodObject<{
                     }>>;
                 }, z.core.$strict>>;
             }, z.core.$strict>>;
+            unreported: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                tools: "tools";
+                parallelToolCalls: "parallelToolCalls";
+                structuredOutput: "structuredOutput";
+                jsonMode: "jsonMode";
+                promptCaching: "promptCaching";
+            }>>>;
         }, z.core.$strict>;
         license: z.ZodObject<{
             licenseId: z.ZodString;
@@ -998,6 +1028,7 @@ export declare const declaredCatalogueSchema: 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";
                 }>;
                 amount: z.core.$ZodBranded<z.ZodString, "ExactDecimal", "out">;
                 per: z.ZodNumber;

package/dist/internal/decisions.d.ts

@@ -72,6 +72,7 @@ export declare const decisionResultSchema: 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>>;
@@ -245,6 +246,7 @@ export declare const decisionFailureSchema: 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/internal/grant.d.ts

@@ -561,6 +561,7 @@ export declare const receiptAccessSchema: 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";
                 }>;
                 amount: z.core.$ZodBranded<z.ZodString, "ExactDecimal", "out">;
                 per: z.ZodNumber;
@@ -610,6 +611,7 @@ export declare const receiptAccessSchema: 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>>;
@@ -672,6 +674,7 @@ export declare const receiptAccessSchema: 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/internal/realtime.d.ts

@@ -326,6 +326,7 @@ export declare const realtimeResponseDoneEventSchema: 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>>;
@@ -442,6 +443,7 @@ export declare const realtimeSessionClosedEventSchema: 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>>;
@@ -899,6 +901,7 @@ export declare const realtimeServerEventSchema: 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>>;
@@ -1005,6 +1008,7 @@ export declare const realtimeServerEventSchema: 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/internal/settlement.d.ts

@@ -92,6 +92,7 @@ export declare const settlementSchema: 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>>;
@@ -216,6 +217,7 @@ export declare const settlementPageSchema: 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/internal/streamEvents.d.ts

@@ -82,6 +82,7 @@ export declare const inferenceStreamUsageEventSchema: 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>>;
@@ -300,6 +301,7 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<[z.ZodO
             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/internal/usage.d.ts

@@ -116,6 +116,7 @@ export declare const normalizedUsageReportSchema: 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/audio.d.ts

@@ -85,6 +85,7 @@ export declare const speechAudioDoneEventSchema: 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>>;
@@ -168,6 +169,7 @@ export declare const speechStreamEventSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             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>>;
@@ -313,6 +315,7 @@ export declare const transcriptionSchema: 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/catalogue.d.ts

@@ -157,6 +157,11 @@ export declare const modelRealtimeCapabilitiesSchema: z.ZodObject<{
         }>>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
+/**
+ * The boolean capabilities that may be listed as unreported (contract set
+ * 8.4.0): the five whose `false` has so far meant both "no" and "not recorded".
+ */
+export declare const UNREPORTED_CAPABILITY_KEYS: readonly ["tools", "parallelToolCalls", "structuredOutput", "jsonMode", "promptCaching"];
 /**
  * What a model can do, in the terms a caller has to decide against before
  * sending a request: can it call tools, does it accept images, will it honour a
@@ -226,6 +231,13 @@ export declare const modelCapabilitiesSchema: z.ZodObject<{
             }>>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
+    unreported: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        tools: "tools";
+        parallelToolCalls: "parallelToolCalls";
+        structuredOutput: "structuredOutput";
+        jsonMode: "jsonMode";
+        promptCaching: "promptCaching";
+    }>>>;
 }, z.core.$strict>;
 /**
  * License terms, including the two questions that decide whether Oxy may serve
@@ -483,6 +495,13 @@ export declare const modelSchema: z.ZodObject<{
                 }>>;
             }, z.core.$strict>>;
         }, z.core.$strict>>;
+        unreported: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            tools: "tools";
+            parallelToolCalls: "parallelToolCalls";
+            structuredOutput: "structuredOutput";
+            jsonMode: "jsonMode";
+            promptCaching: "promptCaching";
+        }>>>;
     }, z.core.$strict>;
     audio: z.ZodOptional<z.ZodObject<{
         voices: z.ZodArray<z.ZodObject<{
@@ -573,6 +592,7 @@ export declare const modelSchema: 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";
             }>;
             amount: z.core.$ZodBranded<z.ZodString, "ExactDecimal", "out">;
             per: z.ZodNumber;
@@ -702,6 +722,13 @@ export declare const modelListSchema: z.ZodObject<{
                     }>>;
                 }, z.core.$strict>>;
             }, z.core.$strict>>;
+            unreported: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                tools: "tools";
+                parallelToolCalls: "parallelToolCalls";
+                structuredOutput: "structuredOutput";
+                jsonMode: "jsonMode";
+                promptCaching: "promptCaching";
+            }>>>;
         }, z.core.$strict>;
         audio: z.ZodOptional<z.ZodObject<{
             voices: z.ZodArray<z.ZodObject<{
@@ -792,6 +819,7 @@ export declare const modelListSchema: 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";
                 }>;
                 amount: z.core.$ZodBranded<z.ZodString, "ExactDecimal", "out">;
                 per: z.ZodNumber;

package/dist/public/catalogue.js

@@ -127,6 +127,17 @@ export const modelRealtimeCapabilitiesSchema = z
         .optional(),
 })
     .strict();
+/**
+ * The boolean capabilities that may be listed as unreported (contract set
+ * 8.4.0): the five whose `false` has so far meant both "no" and "not recorded".
+ */
+export const UNREPORTED_CAPABILITY_KEYS = [
+    'tools',
+    'parallelToolCalls',
+    'structuredOutput',
+    'jsonMode',
+    'promptCaching',
+];
 /**
  * What a model can do, in the terms a caller has to decide against before
  * sending a request: can it call tools, does it accept images, will it honour a
@@ -168,9 +179,38 @@ export const modelCapabilitiesSchema = z
     apiFormats: z.array(inferenceApiFormatSchema).min(1).optional(),
     /** Realtime sessions this model holds; absent means none. Contract set 3.2.0. */
     realtime: modelRealtimeCapabilitiesSchema.optional(),
+    /**
+     * The boolean capabilities whose value is NOT evidence: nobody recorded an
+     * answer, so `false` there means "not stated as true", not "known absent".
+     * Added in contract set 8.4.0 so the five required booleans keep their
+     * shape for every deployed reader while a producer can still say which of
+     * them it never established. A listed key is always `false`. ABSENT means
+     * undeclared (a catalogue from an older producer): every boolean is read
+     * as it was before this field existed.
+     */
+    unreported: z.array(z.enum(UNREPORTED_CAPABILITY_KEYS)).optional(),
 })
     .strict()
     .superRefine((capabilities, ctx) => {
+    const unreported = capabilities.unreported;
+    if (unreported !== undefined) {
+        if (new Set(unreported).size !== unreported.length) {
+            ctx.addIssue({
+                code: 'custom',
+                path: ['unreported'],
+                message: 'each unreported capability is listed at most once',
+            });
+        }
+        for (const [index, key] of unreported.entries()) {
+            if (capabilities[key]) {
+                ctx.addIssue({
+                    code: 'custom',
+                    path: ['unreported', index],
+                    message: `${key} is true, so it is reported: an unreported capability is false`,
+                });
+            }
+        }
+    }
     const formats = capabilities.apiFormats;
     if (formats !== undefined && new Set(formats).size !== formats.length) {
         ctx.addIssue({

package/dist/public/decisions.d.ts

@@ -145,6 +145,7 @@ export declare const decisionSuccessSchema: 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/generations.d.ts

@@ -57,6 +57,7 @@ export declare const chargedGenerationRecordSchema: 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";
             }>;
             amount: z.core.$ZodBranded<z.ZodString, "ExactDecimal", "out">;
             per: z.ZodNumber;
@@ -106,6 +107,7 @@ export declare const chargedGenerationRecordSchema: 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>>;
@@ -174,6 +176,7 @@ export declare const meteredGenerationRecordSchema: 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>>;
@@ -206,6 +209,7 @@ export declare const generationRecordSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
                 audio_output_tokens: "audio_output_tokens";
                 session_milliseconds: "session_milliseconds";
                 input_transcription_milliseconds: "input_transcription_milliseconds";
+                cache_write_input_tokens: "cache_write_input_tokens";
             }>;
             amount: z.core.$ZodBranded<z.ZodString, "ExactDecimal", "out">;
             per: z.ZodNumber;
@@ -255,6 +259,7 @@ export declare const generationRecordSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
             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>>;
@@ -317,6 +322,7 @@ export declare const generationRecordSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
             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/money.d.ts

@@ -142,12 +142,22 @@ export declare const moneySchema: z.ZodObject<{
  * (`routes/inferenceEdge.ts` renders `prompt_tokens` as
  * `input_tokens + cached_input_tokens`).
  *
+ * **`cache_write_input_tokens` is the first-request premium** (added in contract
+ * set 8.4.0): input tokens written to a prompt cache on THIS request, which a
+ * provider bills above the base input rate (Anthropic's 5-minute write is 1.25x
+ * input). It is a sibling under the partition rule, never inside `input_tokens`
+ * or `cached_input_tokens`: a cache read and a cache write of the same token
+ * cannot both happen, so the three never count one token twice. It covers the
+ * provider's DEFAULT time-to-live only; a longer TTL is a different price and
+ * is not expressible by this unit, so a route that cannot price it refuses it.
+ * Declared before anything emits it: Oxy must accept the unit first.
+ *
  * Time is carried in integer MILLISECONDS rather than seconds so that no unit
  * quantity is ever fractional: a 12.5-second transcription is `12500`, exactly,
  * and the "units are integers" rule holds for every modality instead of holding
  * for tokens and being quietly broken by audio.
  */
-export declare const USAGE_UNITS: readonly ["input_tokens", "cached_input_tokens", "output_tokens", "reasoning_tokens", "requests", "images", "audio_input_milliseconds", "audio_output_milliseconds", "video_milliseconds", "characters", "embeddings", "audio_input_tokens", "cached_audio_input_tokens", "audio_output_tokens", "session_milliseconds", "input_transcription_milliseconds"];
+export declare const USAGE_UNITS: readonly ["input_tokens", "cached_input_tokens", "output_tokens", "reasoning_tokens", "requests", "images", "audio_input_milliseconds", "audio_output_milliseconds", "video_milliseconds", "characters", "embeddings", "audio_input_tokens", "cached_audio_input_tokens", "audio_output_tokens", "session_milliseconds", "input_transcription_milliseconds", "cache_write_input_tokens"];
 export declare const usageUnitSchema: z.ZodEnum<{
     input_tokens: "input_tokens";
     cached_input_tokens: "cached_input_tokens";
@@ -165,6 +175,7 @@ export declare const usageUnitSchema: z.ZodEnum<{
     audio_output_tokens: "audio_output_tokens";
     session_milliseconds: "session_milliseconds";
     input_transcription_milliseconds: "input_transcription_milliseconds";
+    cache_write_input_tokens: "cache_write_input_tokens";
 }>;
 /**
  * A metered quantity of ONE unit. Never money — a quantity carries no price and
@@ -188,6 +199,7 @@ export declare const usageQuantitySchema: 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>;
@@ -231,6 +243,7 @@ export declare const unitPriceSchema: 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";
     }>;
     amount: z.core.$ZodBranded<z.ZodString, "ExactDecimal", "out">;
     per: z.ZodNumber;
@@ -265,6 +278,7 @@ export declare const priceSnapshotSchema: 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";
         }>;
         amount: z.core.$ZodBranded<z.ZodString, "ExactDecimal", "out">;
         per: z.ZodNumber;
@@ -294,6 +308,7 @@ export declare const usageSchema: z.ZodArray<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/money.js

@@ -150,6 +150,16 @@ export const moneySchema = z
  * (`routes/inferenceEdge.ts` renders `prompt_tokens` as
  * `input_tokens + cached_input_tokens`).
  *
+ * **`cache_write_input_tokens` is the first-request premium** (added in contract
+ * set 8.4.0): input tokens written to a prompt cache on THIS request, which a
+ * provider bills above the base input rate (Anthropic's 5-minute write is 1.25x
+ * input). It is a sibling under the partition rule, never inside `input_tokens`
+ * or `cached_input_tokens`: a cache read and a cache write of the same token
+ * cannot both happen, so the three never count one token twice. It covers the
+ * provider's DEFAULT time-to-live only; a longer TTL is a different price and
+ * is not expressible by this unit, so a route that cannot price it refuses it.
+ * Declared before anything emits it: Oxy must accept the unit first.
+ *
  * Time is carried in integer MILLISECONDS rather than seconds so that no unit
  * quantity is ever fractional: a 12.5-second transcription is `12500`, exactly,
  * and the "units are integers" rule holds for every modality instead of holding
@@ -172,6 +182,7 @@ export const USAGE_UNITS = [
     'audio_output_tokens',
     'session_milliseconds',
     'input_transcription_milliseconds',
+    'cache_write_input_tokens',
 ];
 export const usageUnitSchema = z.enum(USAGE_UNITS);
 /**

package/dist/public/realtime.d.ts

@@ -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>>;
@@ -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

@@ -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.3.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:
@@ -201,6 +201,13 @@ export declare const INFERENCE_CONTRACT_VERSION = "8.3.0";
  * `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.3.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:
@@ -201,6 +201,13 @@ export const INFERENCE_CONTRACT_VERSION = '8.3.0';
  * `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';

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Kaana API",
-    "version": "8.3.0",
+    "version": "8.4.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": [
@@ -4615,6 +4615,19 @@
           },
           "realtime": {
             "$ref": "#/components/schemas/ModelRealtimeCapabilities"
+          },
+          "unreported": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "tools",
+                "parallelToolCalls",
+                "structuredOutput",
+                "jsonMode",
+                "promptCaching"
+              ]
+            }
           }
         },
         "required": [
@@ -8066,7 +8079,8 @@
           "cached_audio_input_tokens",
           "audio_output_tokens",
           "session_milliseconds",
-          "input_transcription_milliseconds"
+          "input_transcription_milliseconds",
+          "cache_write_input_tokens"
         ]
       },
       "Voice": {

package/package.json

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