@oxy.so/contracts 4.5.0 → 4.7.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.
  *
@@ -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. */
@@ -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";
@@ -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;
@@ -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";
@@ -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

@@ -46,8 +46,8 @@ export declare const inferenceStreamStartEventSchema: z.ZodObject<{
     requestId: string;
     resolvedModelReference: string;
     servingProvider: string;
-    sequence: number;
     startedAt: string;
+    sequence: number;
     generationId?: string | undefined;
 }, {
     type: "start";
@@ -55,8 +55,8 @@ export declare const inferenceStreamStartEventSchema: z.ZodObject<{
     requestId: string;
     resolvedModelReference: string;
     servingProvider: string;
-    sequence: number;
     startedAt: string;
+    sequence: number;
     generationId?: string | undefined;
 }>;
 /**
@@ -225,23 +225,23 @@ export declare const inferenceStreamUsageEventSchema: z.ZodObject<{
     schemaVersion: 2;
     requestId: string;
     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" | "session_milliseconds";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
+    sequence: number;
 }, {
     type: "usage";
     schemaVersion: 2;
     requestId: string;
     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" | "session_milliseconds";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
+    sequence: number;
 }>;
 /**
  * What kind of re-route happened.
@@ -609,8 +609,8 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
     requestId: string;
     resolvedModelReference: string;
     servingProvider: string;
-    sequence: number;
     startedAt: string;
+    sequence: number;
     generationId?: string | undefined;
 }, {
     type: "start";
@@ -618,8 +618,8 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
     requestId: string;
     resolvedModelReference: string;
     servingProvider: string;
-    sequence: number;
     startedAt: string;
+    sequence: number;
     generationId?: string | undefined;
 }>, z.ZodObject<{
     /** See `version.ts`: each stream event is a whole message on the wire. */
@@ -730,23 +730,23 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
     schemaVersion: 2;
     requestId: string;
     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" | "session_milliseconds";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
+    sequence: number;
 }, {
     type: "usage";
     schemaVersion: 2;
     requestId: string;
     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" | "session_milliseconds";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
+    sequence: number;
 }>, z.ZodObject<{
     /** See `version.ts`: each stream event is a whole message on the wire. */
     schemaVersion: z.ZodLiteral<1>;

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

@@ -509,13 +509,13 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
     };
     deploymentId: string;
     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" | "session_milliseconds";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
     routeSwitches: number;
+    startedAt: string;
     generationId?: string | undefined;
     timeToFirstTokenMs?: number | undefined;
 }, {
@@ -540,13 +540,13 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
     };
     deploymentId: string;
     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" | "session_milliseconds";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
     routeSwitches: number;
+    startedAt: string;
     generationId?: string | undefined;
     timeToFirstTokenMs?: number | undefined;
 }>, {
@@ -571,13 +571,13 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
     };
     deploymentId: string;
     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" | "session_milliseconds";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
     routeSwitches: number;
+    startedAt: string;
     generationId?: string | undefined;
     timeToFirstTokenMs?: number | undefined;
 }, {
@@ -602,13 +602,13 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
     };
     deploymentId: string;
     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" | "session_milliseconds";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
     routeSwitches: number;
+    startedAt: string;
     generationId?: string | undefined;
     timeToFirstTokenMs?: number | undefined;
 }>;

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.3.0";
+export declare const INFERENCE_CONTRACT_VERSION = "3.5.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxy.so/contracts",
-  "version": "4.5.0",
+  "version": "4.7.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",