@oxy.so/contracts 4.7.0 → 4.9.0

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

@@ -253,8 +253,8 @@ export declare const routingPolicySchema: z.ZodEffects<z.ZodObject<{
     dedicatedCapacity: z.ZodEnum<["disabled", "prefer", "require"]>;
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    updatedAt: string;
     schemaVersion: 2;
+    updatedAt: string;
     scope: {
         kind: "account";
         accountId: string & z.BRAND<"OxyAccountId">;
@@ -263,10 +263,10 @@ export declare const routingPolicySchema: z.ZodEffects<z.ZodObject<{
         accountId: string & z.BRAND<"OxyAccountId">;
         applicationId: string;
     };
-    dedicatedCapacity: "disabled" | "prefer" | "require";
-    optimiseFor: "price" | "latency" | "throughput" | "balanced";
     routingPolicyId: string;
     policyVersion: number;
+    dedicatedCapacity: "disabled" | "prefer" | "require";
+    optimiseFor: "price" | "latency" | "throughput" | "balanced";
     providerAllowlist: string[];
     providerDenylist: string[];
     allowedRegions: string[];
@@ -301,8 +301,8 @@ export declare const routingPolicySchema: z.ZodEffects<z.ZodObject<{
         amount: string & z.BRAND<"ExactDecimal">;
     } | undefined;
 }, {
-    updatedAt: string;
     schemaVersion: 2;
+    updatedAt: string;
     scope: {
         kind: "account";
         accountId: string;
@@ -311,10 +311,10 @@ export declare const routingPolicySchema: z.ZodEffects<z.ZodObject<{
         accountId: string;
         applicationId: string;
     };
-    dedicatedCapacity: "disabled" | "prefer" | "require";
-    optimiseFor: "price" | "latency" | "throughput" | "balanced";
     routingPolicyId: string;
     policyVersion: number;
+    dedicatedCapacity: "disabled" | "prefer" | "require";
+    optimiseFor: "price" | "latency" | "throughput" | "balanced";
     requireZeroDataRetention: boolean;
     prohibitTrainingOnCustomerData: boolean;
     oxyHostedOnly: boolean;
@@ -349,8 +349,8 @@ export declare const routingPolicySchema: z.ZodEffects<z.ZodObject<{
     allowedLicenseIds?: string[] | undefined;
     allowedRoutingProfileIds?: string[] | undefined;
 }>, {
-    updatedAt: string;
     schemaVersion: 2;
+    updatedAt: string;
     scope: {
         kind: "account";
         accountId: string & z.BRAND<"OxyAccountId">;
@@ -359,10 +359,10 @@ export declare const routingPolicySchema: z.ZodEffects<z.ZodObject<{
         accountId: string & z.BRAND<"OxyAccountId">;
         applicationId: string;
     };
-    dedicatedCapacity: "disabled" | "prefer" | "require";
-    optimiseFor: "price" | "latency" | "throughput" | "balanced";
     routingPolicyId: string;
     policyVersion: number;
+    dedicatedCapacity: "disabled" | "prefer" | "require";
+    optimiseFor: "price" | "latency" | "throughput" | "balanced";
     providerAllowlist: string[];
     providerDenylist: string[];
     allowedRegions: string[];
@@ -397,8 +397,8 @@ export declare const routingPolicySchema: z.ZodEffects<z.ZodObject<{
         amount: string & z.BRAND<"ExactDecimal">;
     } | undefined;
 }, {
-    updatedAt: string;
     schemaVersion: 2;
+    updatedAt: string;
     scope: {
         kind: "account";
         accountId: string;
@@ -407,10 +407,10 @@ export declare const routingPolicySchema: z.ZodEffects<z.ZodObject<{
         accountId: string;
         applicationId: string;
     };
-    dedicatedCapacity: "disabled" | "prefer" | "require";
-    optimiseFor: "price" | "latency" | "throughput" | "balanced";
     routingPolicyId: string;
     policyVersion: number;
+    dedicatedCapacity: "disabled" | "prefer" | "require";
+    optimiseFor: "price" | "latency" | "throughput" | "balanced";
     requireZeroDataRetention: boolean;
     prohibitTrainingOnCustomerData: boolean;
     oxyHostedOnly: boolean;
@@ -509,8 +509,8 @@ export declare const authorizedRouteSchema: z.ZodEffects<z.ZodDiscriminatedUnion
 }, "strict", z.ZodTypeAny, {
     provider: string;
     modelReference: string;
-    regions: string[];
     deploymentId: string;
+    regions: string[];
     substitution: "same_model";
     customerProviderCredential?: {
         environment: "development" | "staging" | "production";
@@ -522,8 +522,8 @@ export declare const authorizedRouteSchema: z.ZodEffects<z.ZodDiscriminatedUnion
 }, {
     provider: string;
     modelReference: string;
-    regions: string[];
     deploymentId: string;
+    regions: string[];
     substitution: "same_model";
     customerProviderCredential?: {
         environment: "development" | "staging" | "production";
@@ -562,8 +562,8 @@ export declare const authorizedRouteSchema: z.ZodEffects<z.ZodDiscriminatedUnion
 }, "strict", z.ZodTypeAny, {
     provider: string;
     modelReference: string;
-    regions: string[];
     deploymentId: string;
+    regions: string[];
     substitution: "cross_model";
     authorizedByPolicy: true;
     customerProviderCredential?: {
@@ -576,8 +576,8 @@ export declare const authorizedRouteSchema: z.ZodEffects<z.ZodDiscriminatedUnion
 }, {
     provider: string;
     modelReference: string;
-    regions: string[];
     deploymentId: string;
+    regions: string[];
     substitution: "cross_model";
     authorizedByPolicy: true;
     customerProviderCredential?: {
@@ -590,8 +590,8 @@ export declare const authorizedRouteSchema: z.ZodEffects<z.ZodDiscriminatedUnion
 }>]>, {
     provider: string;
     modelReference: string;
-    regions: string[];
     deploymentId: string;
+    regions: string[];
     substitution: "same_model";
     customerProviderCredential?: {
         environment: "development" | "staging" | "production";
@@ -603,8 +603,8 @@ export declare const authorizedRouteSchema: z.ZodEffects<z.ZodDiscriminatedUnion
 } | {
     provider: string;
     modelReference: string;
-    regions: string[];
     deploymentId: string;
+    regions: string[];
     substitution: "cross_model";
     authorizedByPolicy: true;
     customerProviderCredential?: {
@@ -617,8 +617,8 @@ export declare const authorizedRouteSchema: z.ZodEffects<z.ZodDiscriminatedUnion
 }, {
     provider: string;
     modelReference: string;
-    regions: string[];
     deploymentId: string;
+    regions: string[];
     substitution: "same_model";
     customerProviderCredential?: {
         environment: "development" | "staging" | "production";
@@ -630,8 +630,8 @@ export declare const authorizedRouteSchema: z.ZodEffects<z.ZodDiscriminatedUnion
 } | {
     provider: string;
     modelReference: string;
-    regions: string[];
     deploymentId: string;
+    regions: string[];
     substitution: "cross_model";
     authorizedByPolicy: true;
     customerProviderCredential?: {

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

@@ -0,0 +1,202 @@
+import { z } from "zod";
+/** Explicit extension negotiation; never replaces the legacy 3.5 handshake. */
+export declare const SCOPED_EXECUTION_CONTRACT_VERSION: "3.6.0";
+/** Scoped only; normal envelope v2 and metadata 3.5 remain unchanged. */
+export declare const SCOPED_REQUEST_ENVELOPE_VERSION: 3;
+/** Restriction only: none of these identities grants catalogue eligibility. */
+export declare const scopedExecutionAudienceSchema: z.ZodObject<{
+    permitId: z.ZodString;
+    idempotencyKey: z.ZodString;
+    fixtureSha256: z.ZodString;
+    expiresAt: z.ZodString;
+    principal: z.ZodObject<{
+        accountId: z.ZodString;
+        applicationId: z.ZodString;
+        credentialId: z.ZodString;
+        environment: z.ZodEnum<["development", "staging", "production"]>;
+    }, "strict", z.ZodTypeAny, {
+        environment: "development" | "staging" | "production";
+        accountId: string;
+        applicationId: string;
+        credentialId: string;
+    }, {
+        environment: "development" | "staging" | "production";
+        accountId: string;
+        applicationId: string;
+        credentialId: string;
+    }>;
+    policy: z.ZodObject<{
+        routingPolicyId: z.ZodString;
+        policyVersion: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        routingPolicyId: string;
+        policyVersion: number;
+    }, {
+        routingPolicyId: string;
+        policyVersion: number;
+    }>;
+    deploymentId: z.ZodString;
+    provider: z.ZodString;
+    keyId: z.ZodString;
+    modelReference: z.ZodEffects<z.ZodString, string, string>;
+    upstreamModelId: z.ZodString;
+    priceVersionId: z.ZodString;
+    providerRateCardVersionId: z.ZodString;
+    providerSourceVersion: z.ZodString;
+    maxCostUsd: z.ZodEffects<z.ZodBranded<z.ZodString, "ExactDecimal">, string & z.BRAND<"ExactDecimal">, string>;
+}, "strict", z.ZodTypeAny, {
+    expiresAt: string;
+    keyId: string;
+    idempotencyKey: string;
+    principal: {
+        environment: "development" | "staging" | "production";
+        accountId: string;
+        applicationId: string;
+        credentialId: string;
+    };
+    provider: string;
+    priceVersionId: string;
+    modelReference: string;
+    permitId: string;
+    fixtureSha256: string;
+    policy: {
+        routingPolicyId: string;
+        policyVersion: number;
+    };
+    deploymentId: string;
+    upstreamModelId: string;
+    providerRateCardVersionId: string;
+    providerSourceVersion: string;
+    maxCostUsd: string & z.BRAND<"ExactDecimal">;
+}, {
+    expiresAt: string;
+    keyId: string;
+    idempotencyKey: string;
+    principal: {
+        environment: "development" | "staging" | "production";
+        accountId: string;
+        applicationId: string;
+        credentialId: string;
+    };
+    provider: string;
+    priceVersionId: string;
+    modelReference: string;
+    permitId: string;
+    fixtureSha256: string;
+    policy: {
+        routingPolicyId: string;
+        policyVersion: number;
+    };
+    deploymentId: string;
+    upstreamModelId: string;
+    providerRateCardVersionId: string;
+    providerSourceVersion: string;
+    maxCostUsd: string;
+}>;
+export declare const scopedExecutionSchema: z.ZodObject<{
+    permitId: z.ZodString;
+    idempotencyKey: z.ZodString;
+    fixtureSha256: z.ZodString;
+    expiresAt: z.ZodString;
+    principal: z.ZodObject<{
+        accountId: z.ZodString;
+        applicationId: z.ZodString;
+        credentialId: z.ZodString;
+        environment: z.ZodEnum<["development", "staging", "production"]>;
+    }, "strict", z.ZodTypeAny, {
+        environment: "development" | "staging" | "production";
+        accountId: string;
+        applicationId: string;
+        credentialId: string;
+    }, {
+        environment: "development" | "staging" | "production";
+        accountId: string;
+        applicationId: string;
+        credentialId: string;
+    }>;
+    policy: z.ZodObject<{
+        routingPolicyId: z.ZodString;
+        policyVersion: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        routingPolicyId: string;
+        policyVersion: number;
+    }, {
+        routingPolicyId: string;
+        policyVersion: number;
+    }>;
+    deploymentId: z.ZodString;
+    provider: z.ZodString;
+    keyId: z.ZodString;
+    modelReference: z.ZodEffects<z.ZodString, string, string>;
+    upstreamModelId: z.ZodString;
+    priceVersionId: z.ZodString;
+    providerRateCardVersionId: z.ZodString;
+    providerSourceVersion: z.ZodString;
+    maxCostUsd: z.ZodEffects<z.ZodBranded<z.ZodString, "ExactDecimal">, string & z.BRAND<"ExactDecimal">, string>;
+} & {
+    requestId: z.ZodString;
+    snapshotId: z.ZodString;
+    catalogueEvidenceHash: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    expiresAt: string;
+    requestId: string;
+    keyId: string;
+    idempotencyKey: string;
+    principal: {
+        environment: "development" | "staging" | "production";
+        accountId: string;
+        applicationId: string;
+        credentialId: string;
+    };
+    provider: string;
+    priceVersionId: string;
+    modelReference: string;
+    permitId: string;
+    fixtureSha256: string;
+    policy: {
+        routingPolicyId: string;
+        policyVersion: number;
+    };
+    deploymentId: string;
+    upstreamModelId: string;
+    providerRateCardVersionId: string;
+    providerSourceVersion: string;
+    maxCostUsd: string & z.BRAND<"ExactDecimal">;
+    snapshotId: string;
+    catalogueEvidenceHash: string;
+}, {
+    expiresAt: string;
+    requestId: string;
+    keyId: string;
+    idempotencyKey: string;
+    principal: {
+        environment: "development" | "staging" | "production";
+        accountId: string;
+        applicationId: string;
+        credentialId: string;
+    };
+    provider: string;
+    priceVersionId: string;
+    modelReference: string;
+    permitId: string;
+    fixtureSha256: string;
+    policy: {
+        routingPolicyId: string;
+        policyVersion: number;
+    };
+    deploymentId: string;
+    upstreamModelId: string;
+    providerRateCardVersionId: string;
+    providerSourceVersion: string;
+    maxCostUsd: string;
+    snapshotId: string;
+    catalogueEvidenceHash: string;
+}>;
+export type ScopedExecutionAudience = z.infer<typeof scopedExecutionAudienceSchema>;
+export type ScopedExecution = z.infer<typeof scopedExecutionSchema>;
+/**
+ * Canonical JSON wire bytes: recursive UTF-16 key order, JSON string/number
+ * encoding, arrays in order, no whitespace. Hash the whole signed input, not a
+ * reparsed/defaulted decision. Reject non-JSON values rather than dropping them.
+ */
+export declare function canonicalScopedExecutionJson(value: unknown): string;

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

@@ -361,9 +361,9 @@ export declare const inferenceStreamRouteSwitchEventSchema: z.ZodObject<{
     occurredAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     type: "route_switch";
+    schemaVersion: 1;
     reason: "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "capacity" | "policy_preference";
     occurredAt: string;
-    schemaVersion: 1;
     requestId: string;
     detail: {
         scope: "deployment";
@@ -381,9 +381,9 @@ export declare const inferenceStreamRouteSwitchEventSchema: z.ZodObject<{
     sequence: number;
 }, {
     type: "route_switch";
+    schemaVersion: 1;
     reason: "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "capacity" | "policy_preference";
     occurredAt: string;
-    schemaVersion: 1;
     requestId: string;
     detail: {
         scope: "deployment";
@@ -802,9 +802,9 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
     occurredAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     type: "route_switch";
+    schemaVersion: 1;
     reason: "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "capacity" | "policy_preference";
     occurredAt: string;
-    schemaVersion: 1;
     requestId: string;
     detail: {
         scope: "deployment";
@@ -822,9 +822,9 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
     sequence: number;
 }, {
     type: "route_switch";
+    schemaVersion: 1;
     reason: "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "capacity" | "policy_preference";
     occurredAt: string;
-    schemaVersion: 1;
     requestId: string;
     detail: {
         scope: "deployment";

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

@@ -259,8 +259,8 @@ export declare const usageReservationSchema: z.ZodEffects<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     status: "expired" | "held" | "settled" | "released";
     expiresAt: string;
-    createdAt: string;
     schemaVersion: 1;
+    createdAt: string;
     currency: string;
     reservationId: string;
     reservedAmount: string & z.BRAND<"ExactDecimal">;
@@ -284,8 +284,8 @@ export declare const usageReservationSchema: z.ZodEffects<z.ZodObject<{
 }, {
     status: "expired" | "held" | "settled" | "released";
     expiresAt: string;
-    createdAt: string;
     schemaVersion: 1;
+    createdAt: string;
     currency: string;
     reservationId: string;
     reservedAmount: string;
@@ -309,8 +309,8 @@ export declare const usageReservationSchema: z.ZodEffects<z.ZodObject<{
 }>, {
     status: "expired" | "held" | "settled" | "released";
     expiresAt: string;
-    createdAt: string;
     schemaVersion: 1;
+    createdAt: string;
     currency: string;
     reservationId: string;
     reservedAmount: string & z.BRAND<"ExactDecimal">;
@@ -334,8 +334,8 @@ export declare const usageReservationSchema: z.ZodEffects<z.ZodObject<{
 }, {
     status: "expired" | "held" | "settled" | "released";
     expiresAt: string;
-    createdAt: string;
     schemaVersion: 1;
+    createdAt: string;
     currency: string;
     reservationId: string;
     reservedAmount: string;
@@ -1037,9 +1037,8 @@ export declare const usageRefundSchema: z.ZodEffects<z.ZodObject<{
     currency: z.ZodString;
     createdAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    createdAt: string;
-    reason: "unused_reservation" | "client_cancelled" | "upstream_failure" | "partial_stream" | "usage_unavailable" | "billing_correction" | "duplicate_charge";
     schemaVersion: 1;
+    createdAt: string;
     subject: {
         kind: "reservation";
         reservationId: string;
@@ -1047,6 +1046,7 @@ export declare const usageRefundSchema: z.ZodEffects<z.ZodObject<{
         kind: "receipt";
         receiptId: string;
     };
+    reason: "unused_reservation" | "client_cancelled" | "upstream_failure" | "partial_stream" | "usage_unavailable" | "billing_correction" | "duplicate_charge";
     currency: string;
     attribution: {
         requestId: string;
@@ -1066,9 +1066,8 @@ export declare const usageRefundSchema: z.ZodEffects<z.ZodObject<{
     amount: string & z.BRAND<"ExactDecimal">;
     refundId: string;
 }, {
-    createdAt: string;
-    reason: "unused_reservation" | "client_cancelled" | "upstream_failure" | "partial_stream" | "usage_unavailable" | "billing_correction" | "duplicate_charge";
     schemaVersion: 1;
+    createdAt: string;
     subject: {
         kind: "reservation";
         reservationId: string;
@@ -1076,6 +1075,7 @@ export declare const usageRefundSchema: z.ZodEffects<z.ZodObject<{
         kind: "receipt";
         receiptId: string;
     };
+    reason: "unused_reservation" | "client_cancelled" | "upstream_failure" | "partial_stream" | "usage_unavailable" | "billing_correction" | "duplicate_charge";
     currency: string;
     attribution: {
         requestId: string;
@@ -1095,9 +1095,8 @@ export declare const usageRefundSchema: z.ZodEffects<z.ZodObject<{
     amount: string;
     refundId: string;
 }>, {
-    createdAt: string;
-    reason: "unused_reservation" | "client_cancelled" | "upstream_failure" | "partial_stream" | "usage_unavailable" | "billing_correction" | "duplicate_charge";
     schemaVersion: 1;
+    createdAt: string;
     subject: {
         kind: "reservation";
         reservationId: string;
@@ -1105,6 +1104,7 @@ export declare const usageRefundSchema: z.ZodEffects<z.ZodObject<{
         kind: "receipt";
         receiptId: string;
     };
+    reason: "unused_reservation" | "client_cancelled" | "upstream_failure" | "partial_stream" | "usage_unavailable" | "billing_correction" | "duplicate_charge";
     currency: string;
     attribution: {
         requestId: string;
@@ -1124,9 +1124,8 @@ export declare const usageRefundSchema: z.ZodEffects<z.ZodObject<{
     amount: string & z.BRAND<"ExactDecimal">;
     refundId: string;
 }, {
-    createdAt: string;
-    reason: "unused_reservation" | "client_cancelled" | "upstream_failure" | "partial_stream" | "usage_unavailable" | "billing_correction" | "duplicate_charge";
     schemaVersion: 1;
+    createdAt: string;
     subject: {
         kind: "reservation";
         reservationId: string;
@@ -1134,6 +1133,7 @@ export declare const usageRefundSchema: z.ZodEffects<z.ZodObject<{
         kind: "receipt";
         receiptId: string;
     };
+    reason: "unused_reservation" | "client_cancelled" | "upstream_failure" | "partial_stream" | "usage_unavailable" | "billing_correction" | "duplicate_charge";
     currency: string;
     attribution: {
         requestId: string;

package/dist/types/keyRotation.d.ts

@@ -73,16 +73,16 @@ export declare const rotateKeyCompleteRequestSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     signature: string;
     challenge: string;
+    timestamp: number;
     newPublicKey: string;
     newKeyProof: string;
-    timestamp: number;
     signOutEverywhere?: boolean | undefined;
 }, {
     signature: string;
     challenge: string;
+    timestamp: number;
     newPublicKey: string;
     newKeyProof: string;
-    timestamp: number;
     signOutEverywhere?: boolean | undefined;
 }>;
 export type RotateKeyCompleteRequest = z.infer<typeof rotateKeyCompleteRequestSchema>;

package/dist/types/notifications.d.ts

@@ -51,8 +51,8 @@ export declare const createOxyNotificationRequestSchema: z.ZodEffects<z.ZodObjec
     data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     type: "system" | "like" | "reply" | "follow" | "mention" | "quote" | "repost" | "welcome";
-    recipientId: string;
     actorId: string;
+    recipientId: string;
     entityId: string;
     entityType: "profile" | "reply" | "post" | "app";
     message?: string | undefined;
@@ -61,8 +61,8 @@ export declare const createOxyNotificationRequestSchema: z.ZodEffects<z.ZodObjec
     title?: string | undefined;
 }, {
     type: "system" | "like" | "reply" | "follow" | "mention" | "quote" | "repost" | "welcome";
-    recipientId: string;
     actorId: string;
+    recipientId: string;
     entityId: string;
     entityType: "profile" | "reply" | "post" | "app";
     message?: string | undefined;
@@ -71,8 +71,8 @@ export declare const createOxyNotificationRequestSchema: z.ZodEffects<z.ZodObjec
     title?: string | undefined;
 }>, {
     type: "system" | "like" | "reply" | "follow" | "mention" | "quote" | "repost" | "welcome";
-    recipientId: string;
     actorId: string;
+    recipientId: string;
     entityId: string;
     entityType: "profile" | "reply" | "post" | "app";
     message?: string | undefined;
@@ -81,8 +81,8 @@ export declare const createOxyNotificationRequestSchema: z.ZodEffects<z.ZodObjec
     title?: string | undefined;
 }, {
     type: "system" | "like" | "reply" | "follow" | "mention" | "quote" | "repost" | "welcome";
-    recipientId: string;
     actorId: string;
+    recipientId: string;
     entityId: string;
     entityType: "profile" | "reply" | "post" | "app";
     message?: string | undefined;