@oxy.so/contracts 4.5.0 → 4.6.0

package/dist/types/index.d.ts

@@ -74,9 +74,9 @@ export { embeddingVectorSchema, embeddingUsageSchema, embeddingSuccessSchema, em
 export type { EmbeddingVector, EmbeddingUsage, EmbeddingSuccess, EmbeddingFailure, EmbeddingResponse, } from './inference/embeddings';
 export { priceVersionStatusSchema, priceVersionSchema, priceSnapshotSchema, } from './inference/priceVersion';
 export type { PriceVersionStatus, PriceVersion, PriceSnapshot } from './inference/priceVersion';
-export { inferenceModalitySchema, reasoningEffortSchema, inferenceApiFormatSchema, realtimeSessionKindSchema, realtimeSessionTransportSchema, modelRealtimeCapabilitiesSchema, modelCapabilitiesSchema, modelLicenseSchema, modelProvenanceSchema, inferenceDataPolicySchema, availabilityScopeSchema, commercialPermissionSchema, modelDeprecationSchema, modelEvaluationResultSchema, modelSafetyMetadataSchema, modelPublisherSchema, catalogueModelSchema, modelRevisionSchema, inferenceProviderSchema, modelDeploymentSchema, routingProfileCandidateSchema, routingProfileSchema, cataloguePublisherSummarySchema, catalogueServingProviderSummarySchema, modelCatalogueEntrySchema, } from './inference/catalogue';
-export type { InferenceModality, ReasoningEffort, InferenceApiFormat, RealtimeSessionKind, RealtimeSessionTransport, ModelRealtimeCapabilities, ModelCapabilities, ModelLicense, ModelProvenance, InferenceDataPolicy, AvailabilityScope, CommercialPermission, ModelDeprecation, ModelEvaluationResult, ModelSafetyMetadata, ModelPublisher, CatalogueModel, ModelRevision, InferenceProvider, ModelDeployment, RoutingProfileCandidate, RoutingProfile, CataloguePublisherSummary, CatalogueServingProviderSummary, ModelCatalogueEntry, } from './inference/catalogue';
-export { routingTargetSchema, routingPolicyScopeSchema, routingFallbackPolicySchema, routingPolicySchema, routingPolicyReferenceSchema, authorizedRouteSchema, } from './inference/routingPolicy';
+export { inferenceModalitySchema, reasoningEffortSchema, powerLevelSchema, modelPowerClassSchema, inferenceApiFormatSchema, realtimeSessionKindSchema, realtimeSessionTransportSchema, modelRealtimeCapabilitiesSchema, modelCapabilitiesSchema, modelLicenseSchema, modelProvenanceSchema, inferenceDataPolicySchema, availabilityScopeSchema, commercialPermissionSchema, modelDeprecationSchema, modelEvaluationResultSchema, modelSafetyMetadataSchema, modelPublisherSchema, catalogueModelSchema, modelRevisionSchema, inferenceProviderSchema, modelDeploymentSchema, routingProfileCandidateSchema, routingProfileSchema, cataloguePublisherSummarySchema, catalogueServingProviderSummarySchema, modelCatalogueEntrySchema, } from './inference/catalogue';
+export type { InferenceModality, ReasoningEffort, PowerLevel, ModelPowerClass, InferenceApiFormat, RealtimeSessionKind, RealtimeSessionTransport, ModelRealtimeCapabilities, ModelCapabilities, ModelLicense, ModelProvenance, InferenceDataPolicy, AvailabilityScope, CommercialPermission, ModelDeprecation, ModelEvaluationResult, ModelSafetyMetadata, ModelPublisher, CatalogueModel, ModelRevision, InferenceProvider, ModelDeployment, RoutingProfileCandidate, RoutingProfile, CataloguePublisherSummary, CatalogueServingProviderSummary, ModelCatalogueEntry, } from './inference/catalogue';
+export { routingTargetSchema, routingPolicyScopeSchema, routingFallbackPolicySchema, routingPolicySchema, routingPolicyReferenceSchema, effectiveSameModelDeployment, authorizedRouteSchema, } from './inference/routingPolicy';
 export type { RoutingTarget, RoutingPolicyScope, RoutingFallbackPolicy, RoutingPolicy, RoutingPolicyReference, AuthorizedRoute, } from './inference/routingPolicy';
 export { aliaReleaseArtifactSchema, aliaReleaseSignatureSchema, aliaModelReleaseManifestSchema, } from './inference/aliaModelRelease';
 export type { AliaReleaseArtifact, AliaReleaseSignature, AliaModelReleaseManifest, } from './inference/aliaModelRelease';

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

@@ -38,6 +38,30 @@ export declare const inferenceModalitySchema: z.ZodEnum<["text", "image", "audio
  * effort the resolved model does not advertise rather than dropping it.
  */
 export declare const reasoningEffortSchema: z.ZodEnum<["low", "medium", "high"]>;
+/**
+ * A POWER LEVEL: the public name of a product-preset routing profile that asks
+ * Oxy to choose a model by capability tier instead of naming one (contract set
+ * 3.4.0). Ordered cheapest first; `auto` asks Oxy to pick the cheapest level
+ * that suffices for the request.
+ *
+ * - `instant` — very cheap, fast small models; no reasoning effort requested
+ * - `medium` — mid-size models, low reasoning effort
+ * - `high` — strong models, medium reasoning effort
+ * - `xhigh` — strong models, high reasoning effort
+ * - `pro` — frontier models, high reasoning effort
+ * - `ultra` — the heaviest frontier models, maximum reasoning effort
+ *
+ * A power level is a routing profile, never a model: its slug has no `/`, and
+ * the response always reports the concrete model that ran.
+ */
+export declare const powerLevelSchema: z.ZodEnum<["auto", "instant", "medium", "high", "xhigh", "pro", "ultra"]>;
+/**
+ * The reviewed capability tier of one MODEL, which power levels choose from.
+ * `xhigh` and `auto` are not classes: `xhigh` runs `high`-class models at a
+ * higher effort, and `auto` chooses a level. Reviewed catalogue data with a
+ * cited public benchmark source — never inferred from a model's name.
+ */
+export declare const modelPowerClassSchema: z.ZodEnum<["instant", "medium", "high", "pro", "ultra"]>;
 /**
  * The public dialects a request can arrive in — `client.apiFormat` on the
  * envelope, and the list a deployment declares it can execute.
@@ -1212,6 +1236,18 @@ export declare const routingProfileSchema: z.ZodObject<{
     }>, "many">;
     /** A product preset (Alia's "fast" toggle) rather than a customer's own profile. */
     isProductPreset: z.ZodBoolean;
+    /**
+     * Present when this profile IS a power level (contract set 3.4.0). Its
+     * `candidates` are then the currently servable models of the level's class,
+     * and may change between reads; cross-model failover among them is
+     * authorized by the profile and reported with a `route_switch` event.
+     */
+    powerLevel: z.ZodOptional<z.ZodEnum<["auto", "instant", "medium", "high", "xhigh", "pro", "ultra"]>>;
+    /**
+     * The reasoning effort a power level asks for when the request names none,
+     * applied only on a model that advertises it. Absent: none is requested.
+     */
+    reasoningEffort: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
 }, "strip", z.ZodTypeAny, {
     displayName: string;
     schemaVersion: 1;
@@ -1224,6 +1260,8 @@ export declare const routingProfileSchema: z.ZodObject<{
     }[];
     isProductPreset: boolean;
     description?: string | undefined;
+    powerLevel?: "medium" | "high" | "auto" | "instant" | "xhigh" | "pro" | "ultra" | undefined;
+    reasoningEffort?: "low" | "medium" | "high" | undefined;
 }, {
     displayName: string;
     schemaVersion: 1;
@@ -1236,6 +1274,8 @@ export declare const routingProfileSchema: z.ZodObject<{
     }[];
     isProductPreset: boolean;
     description?: string | undefined;
+    powerLevel?: "medium" | "high" | "auto" | "instant" | "xhigh" | "pro" | "ultra" | undefined;
+    reasoningEffort?: "low" | "medium" | "high" | undefined;
 }>;
 /** The publisher fields a customer sees beside a model. */
 export declare const cataloguePublisherSummarySchema: z.ZodObject<{
@@ -1729,6 +1769,12 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
         knownLimitations?: string[] | undefined;
     }>>;
     modelCardUrl: z.ZodOptional<z.ZodString>;
+    /**
+     * The reviewed power class this model serves in, when one has been reviewed
+     * (contract set 3.4.0). Absent means the model is callable by name only and
+     * no power level chooses it.
+     */
+    powerClass: z.ZodOptional<z.ZodEnum<["instant", "medium", "high", "pro", "ultra"]>>;
 }, "strip", z.ZodTypeAny, {
     displayName: string;
     capabilities: {
@@ -1830,6 +1876,7 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
             per: number;
         }[];
     } | undefined;
+    powerClass?: "medium" | "high" | "instant" | "pro" | "ultra" | undefined;
 }, {
     displayName: string;
     capabilities: {
@@ -1931,9 +1978,12 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
             per: number;
         }[];
     } | undefined;
+    powerClass?: "medium" | "high" | "instant" | "pro" | "ultra" | undefined;
 }>;
 export type InferenceModality = z.infer<typeof inferenceModalitySchema>;
 export type ReasoningEffort = z.infer<typeof reasoningEffortSchema>;
+export type PowerLevel = z.infer<typeof powerLevelSchema>;
+export type ModelPowerClass = z.infer<typeof modelPowerClassSchema>;
 export type InferenceApiFormat = z.infer<typeof inferenceApiFormatSchema>;
 export type RealtimeSessionKind = z.infer<typeof realtimeSessionKindSchema>;
 export type RealtimeSessionTransport = z.infer<typeof realtimeSessionTransportSchema>;

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/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.4.0";

package/package.json

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