@oxy.so/contracts 4.4.0 → 4.6.0

package/dist/types/inference/routingPolicy.d.ts

@@ -96,17 +96,32 @@ export declare const routingPolicyScopeSchema: z.ZodDiscriminatedUnion<"kind", [
  */
 export declare const routingFallbackPolicySchema: z.ZodObject<{
     disabled: z.ZodBoolean;
-    sameModelDeployment: z.ZodBoolean;
+    /**
+     * Same-model deployment failover. OPTIONAL since contract set 3.4.0, and
+     * absent means ON unless `disabled` is set: serving the same weights from
+     * another deployment of the same revision is an availability decision, not
+     * a substitution. A policy opts out with an explicit `false` (or
+     * `disabled: true`). See `effectiveSameModelDeployment`.
+     */
+    sameModelDeployment: z.ZodOptional<z.ZodBoolean>;
     authorizedCrossModel: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
 }, "strict", z.ZodTypeAny, {
     disabled: boolean;
-    sameModelDeployment: boolean;
     authorizedCrossModel: string[];
+    sameModelDeployment?: boolean | undefined;
 }, {
     disabled: boolean;
-    sameModelDeployment: boolean;
+    sameModelDeployment?: boolean | undefined;
     authorizedCrossModel?: string[] | undefined;
 }>;
+/**
+ * Whether a fallback block authorizes same-model deployment failover: an
+ * explicit `sameModelDeployment` wins; absent means on unless `disabled`.
+ */
+export declare function effectiveSameModelDeployment(fallback: {
+    readonly disabled: boolean;
+    readonly sameModelDeployment?: boolean;
+}): boolean;
 /**
  * A versioned routing policy.
  *
@@ -172,19 +187,19 @@ export declare const routingPolicySchema: z.ZodEffects<z.ZodObject<{
     prohibitTrainingOnCustomerData: z.ZodBoolean;
     /** Ceilings on what a route may cost the customer, quoted like catalogue prices. */
     maxPricePerUnit: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        unit: z.ZodEnum<["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"]>;
+        unit: z.ZodEnum<["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"]>;
         amount: z.ZodBranded<z.ZodString, "ExactDecimal">;
         per: z.ZodNumber;
         currency: z.ZodString;
     }, "strict", z.ZodTypeAny, {
         currency: string;
         amount: string & z.BRAND<"ExactDecimal">;
-        unit: "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";
+        unit: "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";
         per: number;
     }, {
         currency: string;
         amount: string;
-        unit: "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";
+        unit: "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";
         per: number;
     }>, "many">>;
     maxPricePerRequest: z.ZodOptional<z.ZodObject<{
@@ -206,17 +221,32 @@ export declare const routingPolicySchema: z.ZodEffects<z.ZodObject<{
     requireCommercialUseRights: z.ZodBoolean;
     fallback: z.ZodObject<{
         disabled: z.ZodBoolean;
-        sameModelDeployment: z.ZodBoolean;
+        /**
+         * Same-model deployment failover. OPTIONAL since contract set 3.4.0, and
+         * absent means ON unless `disabled` is set: serving the same weights from
+         * another deployment of the same revision is an availability decision, not
+         * a substitution. A policy opts out with an explicit `false` (or
+         * `disabled: true`). See `effectiveSameModelDeployment`.
+         */
+        sameModelDeployment: z.ZodOptional<z.ZodBoolean>;
         authorizedCrossModel: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     }, "strict", z.ZodTypeAny, {
         disabled: boolean;
-        sameModelDeployment: boolean;
         authorizedCrossModel: string[];
+        sameModelDeployment?: boolean | undefined;
     }, {
         disabled: boolean;
-        sameModelDeployment: boolean;
+        sameModelDeployment?: boolean | undefined;
         authorizedCrossModel?: string[] | undefined;
     }>;
+    /**
+     * The routing profiles (power levels) this scope may target, by exact id
+     * (contract set 3.4.0). Empty means no restriction. A request naming a
+     * profile outside a non-empty list is refused with `policy_violation`, and
+     * `auto` only climbs to levels on the list. Concrete model targets are
+     * governed by the other controls, not by this list.
+     */
+    allowedRoutingProfileIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     /** Whether the customer's own provider credentials may or must be used. */
     byokPreference: z.ZodEnum<["disabled", "prefer", "require"]>;
     /** Enterprise reserved capacity rather than shared endpoints. */
@@ -246,7 +276,7 @@ export declare const routingPolicySchema: z.ZodEffects<z.ZodObject<{
     maxPricePerUnit: {
         currency: string;
         amount: string & z.BRAND<"ExactDecimal">;
-        unit: "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";
+        unit: "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";
         per: number;
     }[];
     oxyHostedOnly: boolean;
@@ -254,9 +284,10 @@ export declare const routingPolicySchema: z.ZodEffects<z.ZodObject<{
     requireCommercialUseRights: boolean;
     fallback: {
         disabled: boolean;
-        sameModelDeployment: boolean;
         authorizedCrossModel: string[];
+        sameModelDeployment?: boolean | undefined;
     };
+    allowedRoutingProfileIds: string[];
     byokPreference: "disabled" | "prefer" | "require";
     defaultTarget?: {
         kind: "model";
@@ -290,7 +321,7 @@ export declare const routingPolicySchema: z.ZodEffects<z.ZodObject<{
     requireCommercialUseRights: boolean;
     fallback: {
         disabled: boolean;
-        sameModelDeployment: boolean;
+        sameModelDeployment?: boolean | undefined;
         authorizedCrossModel?: string[] | undefined;
     };
     byokPreference: "disabled" | "prefer" | "require";
@@ -308,7 +339,7 @@ export declare const routingPolicySchema: z.ZodEffects<z.ZodObject<{
     maxPricePerUnit?: {
         currency: string;
         amount: string;
-        unit: "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";
+        unit: "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";
         per: number;
     }[] | undefined;
     maxPricePerRequest?: {
@@ -316,6 +347,7 @@ export declare const routingPolicySchema: z.ZodEffects<z.ZodObject<{
         amount: string;
     } | undefined;
     allowedLicenseIds?: string[] | undefined;
+    allowedRoutingProfileIds?: string[] | undefined;
 }>, {
     updatedAt: string;
     schemaVersion: 2;
@@ -340,7 +372,7 @@ export declare const routingPolicySchema: z.ZodEffects<z.ZodObject<{
     maxPricePerUnit: {
         currency: string;
         amount: string & z.BRAND<"ExactDecimal">;
-        unit: "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";
+        unit: "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";
         per: number;
     }[];
     oxyHostedOnly: boolean;
@@ -348,9 +380,10 @@ export declare const routingPolicySchema: z.ZodEffects<z.ZodObject<{
     requireCommercialUseRights: boolean;
     fallback: {
         disabled: boolean;
-        sameModelDeployment: boolean;
         authorizedCrossModel: string[];
+        sameModelDeployment?: boolean | undefined;
     };
+    allowedRoutingProfileIds: string[];
     byokPreference: "disabled" | "prefer" | "require";
     defaultTarget?: {
         kind: "model";
@@ -384,7 +417,7 @@ export declare const routingPolicySchema: z.ZodEffects<z.ZodObject<{
     requireCommercialUseRights: boolean;
     fallback: {
         disabled: boolean;
-        sameModelDeployment: boolean;
+        sameModelDeployment?: boolean | undefined;
         authorizedCrossModel?: string[] | undefined;
     };
     byokPreference: "disabled" | "prefer" | "require";
@@ -402,7 +435,7 @@ export declare const routingPolicySchema: z.ZodEffects<z.ZodObject<{
     maxPricePerUnit?: {
         currency: string;
         amount: string;
-        unit: "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";
+        unit: "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";
         per: number;
     }[] | undefined;
     maxPricePerRequest?: {
@@ -410,6 +443,7 @@ export declare const routingPolicySchema: z.ZodEffects<z.ZodObject<{
         amount: string;
     } | undefined;
     allowedLicenseIds?: string[] | undefined;
+    allowedRoutingProfileIds?: string[] | undefined;
 }>;
 /**
  * The reference a request records: which policy, at which of the customer's own

package/dist/types/inference/streamEvents.d.ts

@@ -210,13 +210,13 @@ export declare const inferenceStreamUsageEventSchema: z.ZodObject<{
     /** Exact deployment whose metering produced these partial units. */
     deploymentId: z.ZodString;
     units: z.ZodArray<z.ZodObject<{
-        unit: z.ZodEnum<["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"]>;
+        unit: z.ZodEnum<["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"]>;
         quantity: z.ZodNumber;
     }, "strict", z.ZodTypeAny, {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }, {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }>, "many">;
     usageSource: z.ZodEnum<["provider_reported", "oxy_measured", "estimated"]>;
@@ -227,7 +227,7 @@ export declare const inferenceStreamUsageEventSchema: z.ZodObject<{
     deploymentId: string;
     sequence: number;
     units: {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
@@ -238,7 +238,7 @@ export declare const inferenceStreamUsageEventSchema: z.ZodObject<{
     deploymentId: string;
     sequence: number;
     units: {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
@@ -715,13 +715,13 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
     /** Exact deployment whose metering produced these partial units. */
     deploymentId: z.ZodString;
     units: z.ZodArray<z.ZodObject<{
-        unit: z.ZodEnum<["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"]>;
+        unit: z.ZodEnum<["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"]>;
         quantity: z.ZodNumber;
     }, "strict", z.ZodTypeAny, {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }, {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }>, "many">;
     usageSource: z.ZodEnum<["provider_reported", "oxy_measured", "estimated"]>;
@@ -732,7 +732,7 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
     deploymentId: string;
     sequence: number;
     units: {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
@@ -743,7 +743,7 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
     deploymentId: string;
     sequence: number;
     units: {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";

package/dist/types/inference/usage.d.ts

@@ -105,13 +105,13 @@ export declare const usageReservationRequestSchema: z.ZodObject<{
     }>;
     /** Units already determined by the request itself, e.g. input tokens. */
     knownUnits: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        unit: z.ZodEnum<["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"]>;
+        unit: z.ZodEnum<["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"]>;
         quantity: z.ZodNumber;
     }, "strict", z.ZodTypeAny, {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }, {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }>, "many">>;
     /** The ceiling on generated output, when the request set one. */
@@ -140,7 +140,7 @@ export declare const usageReservationRequestSchema: z.ZodObject<{
     };
     idempotencyKey: string;
     knownUnits: {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }[];
     ceilingPriceVersionId: string;
@@ -170,7 +170,7 @@ export declare const usageReservationRequestSchema: z.ZodObject<{
     expiresInSeconds: number;
     maxOutputTokens?: number | undefined;
     knownUnits?: {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }[] | undefined;
 }>;
@@ -468,13 +468,13 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
     }>;
     outcome: z.ZodEnum<["completed", "partial", "cancelled", "failed"]>;
     units: z.ZodArray<z.ZodObject<{
-        unit: z.ZodEnum<["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"]>;
+        unit: z.ZodEnum<["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"]>;
         quantity: z.ZodNumber;
     }, "strict", z.ZodTypeAny, {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }, {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }>, "many">;
     usageSource: z.ZodEnum<["provider_reported", "oxy_measured", "estimated"]>;
@@ -511,7 +511,7 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
     completedAt: string;
     startedAt: string;
     units: {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
@@ -542,7 +542,7 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
     completedAt: string;
     startedAt: string;
     units: {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
@@ -573,7 +573,7 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
     completedAt: string;
     startedAt: string;
     units: {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
@@ -604,7 +604,7 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
     completedAt: string;
     startedAt: string;
     units: {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
@@ -693,13 +693,13 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
     }>;
     outcome: z.ZodEnum<["completed", "partial", "cancelled", "failed"]>;
     units: z.ZodArray<z.ZodObject<{
-        unit: z.ZodEnum<["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"]>;
+        unit: z.ZodEnum<["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"]>;
         quantity: z.ZodNumber;
     }, "strict", z.ZodTypeAny, {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }, {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }>, "many">;
     usageSource: z.ZodEnum<["provider_reported", "oxy_measured", "estimated"]>;
@@ -707,19 +707,19 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
         priceVersionId: z.ZodString;
         currency: z.ZodString;
         unitPrices: z.ZodArray<z.ZodObject<{
-            unit: z.ZodEnum<["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"]>;
+            unit: z.ZodEnum<["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"]>;
             amount: z.ZodBranded<z.ZodString, "ExactDecimal">;
             per: z.ZodNumber;
             currency: z.ZodString;
         }, "strict", z.ZodTypeAny, {
             currency: string;
             amount: string & z.BRAND<"ExactDecimal">;
-            unit: "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";
+            unit: "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";
             per: number;
         }, {
             currency: string;
             amount: string;
-            unit: "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";
+            unit: "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";
             per: number;
         }>, "many">;
     }, "strict", z.ZodTypeAny, {
@@ -728,7 +728,7 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
         unitPrices: {
             currency: string;
             amount: string & z.BRAND<"ExactDecimal">;
-            unit: "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";
+            unit: "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";
             per: number;
         }[];
     }, {
@@ -737,7 +737,7 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
         unitPrices: {
             currency: string;
             amount: string;
-            unit: "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";
+            unit: "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";
             per: number;
         }[];
     }>;
@@ -773,7 +773,7 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
     };
     idempotencyKey: string;
     units: {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
@@ -783,7 +783,7 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
         unitPrices: {
             currency: string;
             amount: string & z.BRAND<"ExactDecimal">;
-            unit: "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";
+            unit: "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";
             per: number;
         }[];
     };
@@ -814,7 +814,7 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
     };
     idempotencyKey: string;
     units: {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
@@ -824,7 +824,7 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
         unitPrices: {
             currency: string;
             amount: string;
-            unit: "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";
+            unit: "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";
             per: number;
         }[];
     };
@@ -855,7 +855,7 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
     };
     idempotencyKey: string;
     units: {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
@@ -865,7 +865,7 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
         unitPrices: {
             currency: string;
             amount: string & z.BRAND<"ExactDecimal">;
-            unit: "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";
+            unit: "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";
             per: number;
         }[];
     };
@@ -896,7 +896,7 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
     };
     idempotencyKey: string;
     units: {
-        unit: "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";
+        unit: "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";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
@@ -906,7 +906,7 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
         unitPrices: {
             currency: string;
             amount: string;
-            unit: "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";
+            unit: "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";
             per: number;
         }[];
     };

package/dist/types/inference/version.d.ts

@@ -99,4 +99,4 @@
  * 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 = "3.2.0";
+export declare const INFERENCE_CONTRACT_VERSION = "3.4.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxy.so/contracts",
-  "version": "4.4.0",
+  "version": "4.6.0",
   "description": "OxyHQ API contracts — single source of truth for request/response Zod schemas and inferred types, shared by the backend and the client SDKs",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",