@oxyhq/contracts 0.29.0 → 0.31.0

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

@@ -122,6 +122,7 @@ export declare const usageReservationRequestSchema: z.ZodObject<{
     currency: z.ZodString;
     expiresInSeconds: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
+    currency: string;
     attribution: {
         requestId: string;
         principal: {
@@ -137,7 +138,6 @@ export declare const usageReservationRequestSchema: z.ZodObject<{
         generationId?: string | undefined;
     };
     idempotencyKey: string;
-    currency: string;
     schemaVersion: 1;
     knownUnits: {
         unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings";
@@ -148,6 +148,7 @@ export declare const usageReservationRequestSchema: z.ZodObject<{
     expiresInSeconds: number;
     maxOutputTokens?: number | undefined;
 }, {
+    currency: string;
     attribution: {
         requestId: string;
         principal: {
@@ -163,7 +164,6 @@ export declare const usageReservationRequestSchema: z.ZodObject<{
         generationId?: string | undefined;
     };
     idempotencyKey: string;
-    currency: string;
     schemaVersion: 1;
     ceilingPriceVersionId: string;
     maxAmount: string;
@@ -259,6 +259,10 @@ export declare const usageReservationSchema: z.ZodEffects<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     status: "expired" | "held" | "settled" | "released";
     expiresAt: string;
+    currency: string;
+    createdAt: string;
+    reservationId: string;
+    reservedAmount: string & z.BRAND<"ExactDecimal">;
     attribution: {
         requestId: string;
         principal: {
@@ -274,16 +278,16 @@ export declare const usageReservationSchema: z.ZodEffects<z.ZodObject<{
         generationId?: string | undefined;
     };
     idempotencyKey: string;
-    createdAt: string;
-    currency: string;
     schemaVersion: 1;
     ceilingPriceVersionId: string;
-    reservationId: string;
-    reservedAmount: string & z.BRAND<"ExactDecimal">;
     settledReceiptId?: string | undefined;
 }, {
     status: "expired" | "held" | "settled" | "released";
     expiresAt: string;
+    currency: string;
+    createdAt: string;
+    reservationId: string;
+    reservedAmount: string;
     attribution: {
         requestId: string;
         principal: {
@@ -299,16 +303,16 @@ export declare const usageReservationSchema: z.ZodEffects<z.ZodObject<{
         generationId?: string | undefined;
     };
     idempotencyKey: string;
-    createdAt: string;
-    currency: string;
     schemaVersion: 1;
     ceilingPriceVersionId: string;
-    reservationId: string;
-    reservedAmount: string;
     settledReceiptId?: string | undefined;
 }>, {
     status: "expired" | "held" | "settled" | "released";
     expiresAt: string;
+    currency: string;
+    createdAt: string;
+    reservationId: string;
+    reservedAmount: string & z.BRAND<"ExactDecimal">;
     attribution: {
         requestId: string;
         principal: {
@@ -324,16 +328,16 @@ export declare const usageReservationSchema: z.ZodEffects<z.ZodObject<{
         generationId?: string | undefined;
     };
     idempotencyKey: string;
-    createdAt: string;
-    currency: string;
     schemaVersion: 1;
     ceilingPriceVersionId: string;
-    reservationId: string;
-    reservedAmount: string & z.BRAND<"ExactDecimal">;
     settledReceiptId?: string | undefined;
 }, {
     status: "expired" | "held" | "settled" | "released";
     expiresAt: string;
+    currency: string;
+    createdAt: string;
+    reservationId: string;
+    reservedAmount: string;
     attribution: {
         requestId: string;
         principal: {
@@ -349,18 +353,20 @@ export declare const usageReservationSchema: z.ZodEffects<z.ZodObject<{
         generationId?: string | undefined;
     };
     idempotencyKey: string;
-    createdAt: string;
-    currency: string;
     schemaVersion: 1;
     ceilingPriceVersionId: string;
-    reservationId: string;
-    reservedAmount: string;
     settledReceiptId?: string | undefined;
 }>;
 /** How a request ended, from the data plane's point of view. */
 export declare const inferenceRequestOutcomeSchema: z.ZodEnum<["completed", "partial", "cancelled", "failed"]>;
 /**
- * The data plane's technical account of one request.
+ * The data plane's technical account of one request, and the ONLY shape a
+ * settlement is written from.
+ *
+ * `inferenceStreamUsageEventSchema` is not a narrower version of this one that
+ * could be widened into it — see that event's own comment. Its units are exact
+ * and settleable; the record around them is not inferable, so an edge settling
+ * from a stream event supplies the outcome itself and never promotes the event.
  *
  * No money and no price: the data plane measures units and names the route it
  * used, and the control plane decides what that costs. Keeping the two apart is
@@ -376,6 +382,24 @@ export declare const inferenceRequestOutcomeSchema: z.ZodEnum<["completed", "par
  * nested `prompt_tokens`/`completion_tokens` verbatim charges the cached and
  * reasoning tokens twice, so subtracting the children out is part of what
  * "normalized" means in this shape's name.
+ *
+ * **A `completed` report carries at least one unit, and the other outcomes need
+ * not.** `completed` is the one outcome that asserts the customer received the
+ * whole answer, so "delivered in full, consumed nothing measurable" is a
+ * contradiction — and it is one that BILLS NOTHING: settlement prices every
+ * reported unit and sums, so an empty list is a free request produced by a
+ * provider that simply omitted its usage block. The refinement makes that shape
+ * unparseable, and the policy behind it is refuse-and-release: the report is
+ * rejected and the hold is released, never estimated and charged.
+ *
+ * The three other outcomes legitimately carry none, which is why the rule is
+ * conditional rather than a `.min(1)` on the field. In the reference data plane
+ * `failed` is DERIVED from having no units — `outcomeFor` in
+ * `internal/relay/executor.go` returns `partial` when units exist and `failed`
+ * when they do not — and `cancelled` is reported for a client that stopped
+ * before anything was measured. An unconditional minimum would refuse those
+ * reports, and a refused report is a request that ran, cost money upstream and
+ * can never be settled or refunded.
  */
 export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
     /** See `version.ts`: emitted by the data plane as a whole message. */
@@ -464,6 +488,9 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
     timeToFirstTokenMs: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     requestId: string;
+    outcome: "cancelled" | "completed" | "partial" | "failed";
+    resolvedModelReference: string;
+    servingProvider: string;
     attribution: {
         requestId: string;
         principal: {
@@ -479,8 +506,6 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
         generationId?: string | undefined;
     };
     schemaVersion: 1;
-    resolvedModelReference: string;
-    servingProvider: 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";
@@ -488,13 +513,15 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
     completedAt: string;
-    outcome: "cancelled" | "completed" | "partial" | "failed";
     routeSwitches: number;
     generationId?: string | undefined;
     deploymentId?: string | undefined;
     timeToFirstTokenMs?: number | undefined;
 }, {
     requestId: string;
+    outcome: "cancelled" | "completed" | "partial" | "failed";
+    resolvedModelReference: string;
+    servingProvider: string;
     attribution: {
         requestId: string;
         principal: {
@@ -510,8 +537,6 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
         generationId?: string | undefined;
     };
     schemaVersion: 1;
-    resolvedModelReference: string;
-    servingProvider: 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";
@@ -519,13 +544,15 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
     completedAt: string;
-    outcome: "cancelled" | "completed" | "partial" | "failed";
     routeSwitches: number;
     generationId?: string | undefined;
     deploymentId?: string | undefined;
     timeToFirstTokenMs?: number | undefined;
 }>, {
     requestId: string;
+    outcome: "cancelled" | "completed" | "partial" | "failed";
+    resolvedModelReference: string;
+    servingProvider: string;
     attribution: {
         requestId: string;
         principal: {
@@ -541,8 +568,6 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
         generationId?: string | undefined;
     };
     schemaVersion: 1;
-    resolvedModelReference: string;
-    servingProvider: 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";
@@ -550,13 +575,15 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
     completedAt: string;
-    outcome: "cancelled" | "completed" | "partial" | "failed";
     routeSwitches: number;
     generationId?: string | undefined;
     deploymentId?: string | undefined;
     timeToFirstTokenMs?: number | undefined;
 }, {
     requestId: string;
+    outcome: "cancelled" | "completed" | "partial" | "failed";
+    resolvedModelReference: string;
+    servingProvider: string;
     attribution: {
         requestId: string;
         principal: {
@@ -572,8 +599,6 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
         generationId?: string | undefined;
     };
     schemaVersion: 1;
-    resolvedModelReference: string;
-    servingProvider: 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";
@@ -581,7 +606,6 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
     completedAt: string;
-    outcome: "cancelled" | "completed" | "partial" | "failed";
     routeSwitches: number;
     generationId?: string | undefined;
     deploymentId?: string | undefined;
@@ -687,13 +711,13 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
             per: z.ZodNumber;
             currency: z.ZodString;
         }, "strict", z.ZodTypeAny, {
-            amount: string & z.BRAND<"ExactDecimal">;
             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";
             per: number;
         }, {
-            amount: string;
             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";
             per: number;
         }>, "many">;
@@ -701,8 +725,8 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
         currency: string;
         priceVersionId: string;
         unitPrices: {
-            amount: string & z.BRAND<"ExactDecimal">;
             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";
             per: number;
         }[];
@@ -710,8 +734,8 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
         currency: string;
         priceVersionId: string;
         unitPrices: {
-            amount: string;
             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";
             per: number;
         }[];
@@ -723,6 +747,14 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
     servingProvider: z.ZodString;
     settledAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
+    receiptId: string;
+    settledAt: string;
+    billedAmount: string & z.BRAND<"ExactDecimal">;
+    currency: string;
+    outcome: "cancelled" | "completed" | "partial" | "failed";
+    resolvedModelReference: string;
+    servingProvider: string;
+    platformFeeOnly: boolean;
     attribution: {
         requestId: string;
         principal: {
@@ -738,32 +770,32 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
         generationId?: string | undefined;
     };
     idempotencyKey: string;
-    currency: string;
     schemaVersion: 1;
-    resolvedModelReference: string;
-    servingProvider: string;
     units: {
         unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
-    receiptId: string;
-    outcome: "cancelled" | "completed" | "partial" | "failed";
     priceSnapshot: {
         currency: string;
         priceVersionId: string;
         unitPrices: {
-            amount: string & z.BRAND<"ExactDecimal">;
             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";
             per: number;
         }[];
     };
-    billedAmount: string & z.BRAND<"ExactDecimal">;
-    platformFeeOnly: boolean;
-    settledAt: string;
     reservationId?: string | undefined;
 }, {
+    receiptId: string;
+    settledAt: string;
+    billedAmount: string;
+    currency: string;
+    outcome: "cancelled" | "completed" | "partial" | "failed";
+    resolvedModelReference: string;
+    servingProvider: string;
+    platformFeeOnly: boolean;
     attribution: {
         requestId: string;
         principal: {
@@ -779,32 +811,32 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
         generationId?: string | undefined;
     };
     idempotencyKey: string;
-    currency: string;
     schemaVersion: 1;
-    resolvedModelReference: string;
-    servingProvider: string;
     units: {
         unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
-    receiptId: string;
-    outcome: "cancelled" | "completed" | "partial" | "failed";
     priceSnapshot: {
         currency: string;
         priceVersionId: string;
         unitPrices: {
-            amount: string;
             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";
             per: number;
         }[];
     };
-    billedAmount: string;
-    platformFeeOnly: boolean;
-    settledAt: string;
     reservationId?: string | undefined;
 }>, {
+    receiptId: string;
+    settledAt: string;
+    billedAmount: string & z.BRAND<"ExactDecimal">;
+    currency: string;
+    outcome: "cancelled" | "completed" | "partial" | "failed";
+    resolvedModelReference: string;
+    servingProvider: string;
+    platformFeeOnly: boolean;
     attribution: {
         requestId: string;
         principal: {
@@ -820,32 +852,32 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
         generationId?: string | undefined;
     };
     idempotencyKey: string;
-    currency: string;
     schemaVersion: 1;
-    resolvedModelReference: string;
-    servingProvider: string;
     units: {
         unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
-    receiptId: string;
-    outcome: "cancelled" | "completed" | "partial" | "failed";
     priceSnapshot: {
         currency: string;
         priceVersionId: string;
         unitPrices: {
-            amount: string & z.BRAND<"ExactDecimal">;
             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";
             per: number;
         }[];
     };
-    billedAmount: string & z.BRAND<"ExactDecimal">;
-    platformFeeOnly: boolean;
-    settledAt: string;
     reservationId?: string | undefined;
 }, {
+    receiptId: string;
+    settledAt: string;
+    billedAmount: string;
+    currency: string;
+    outcome: "cancelled" | "completed" | "partial" | "failed";
+    resolvedModelReference: string;
+    servingProvider: string;
+    platformFeeOnly: boolean;
     attribution: {
         requestId: string;
         principal: {
@@ -861,30 +893,22 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
         generationId?: string | undefined;
     };
     idempotencyKey: string;
-    currency: string;
     schemaVersion: 1;
-    resolvedModelReference: string;
-    servingProvider: string;
     units: {
         unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings";
         quantity: number;
     }[];
     usageSource: "provider_reported" | "oxy_measured" | "estimated";
-    receiptId: string;
-    outcome: "cancelled" | "completed" | "partial" | "failed";
     priceSnapshot: {
         currency: string;
         priceVersionId: string;
         unitPrices: {
-            amount: string;
             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";
             per: number;
         }[];
     };
-    billedAmount: string;
-    platformFeeOnly: boolean;
-    settledAt: string;
     reservationId?: string | undefined;
 }>;
 /**
@@ -1020,6 +1044,8 @@ export declare const usageRefundSchema: z.ZodEffects<z.ZodObject<{
         kind: "receipt";
         receiptId: string;
     };
+    currency: string;
+    createdAt: string;
     attribution: {
         requestId: string;
         principal: {
@@ -1035,9 +1061,7 @@ export declare const usageRefundSchema: z.ZodEffects<z.ZodObject<{
         generationId?: string | undefined;
     };
     idempotencyKey: string;
-    createdAt: string;
     amount: string & z.BRAND<"ExactDecimal">;
-    currency: string;
     schemaVersion: 1;
     refundId: string;
 }, {
@@ -1049,6 +1073,8 @@ export declare const usageRefundSchema: z.ZodEffects<z.ZodObject<{
         kind: "receipt";
         receiptId: string;
     };
+    currency: string;
+    createdAt: string;
     attribution: {
         requestId: string;
         principal: {
@@ -1064,9 +1090,7 @@ export declare const usageRefundSchema: z.ZodEffects<z.ZodObject<{
         generationId?: string | undefined;
     };
     idempotencyKey: string;
-    createdAt: string;
     amount: string;
-    currency: string;
     schemaVersion: 1;
     refundId: string;
 }>, {
@@ -1078,6 +1102,8 @@ export declare const usageRefundSchema: z.ZodEffects<z.ZodObject<{
         kind: "receipt";
         receiptId: string;
     };
+    currency: string;
+    createdAt: string;
     attribution: {
         requestId: string;
         principal: {
@@ -1093,9 +1119,7 @@ export declare const usageRefundSchema: z.ZodEffects<z.ZodObject<{
         generationId?: string | undefined;
     };
     idempotencyKey: string;
-    createdAt: string;
     amount: string & z.BRAND<"ExactDecimal">;
-    currency: string;
     schemaVersion: 1;
     refundId: string;
 }, {
@@ -1107,6 +1131,8 @@ export declare const usageRefundSchema: z.ZodEffects<z.ZodObject<{
         kind: "receipt";
         receiptId: string;
     };
+    currency: string;
+    createdAt: string;
     attribution: {
         requestId: string;
         principal: {
@@ -1122,9 +1148,7 @@ export declare const usageRefundSchema: z.ZodEffects<z.ZodObject<{
         generationId?: string | undefined;
     };
     idempotencyKey: string;
-    createdAt: string;
     amount: string;
-    currency: string;
     schemaVersion: 1;
     refundId: string;
 }>;

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

@@ -62,7 +62,20 @@
  * escapes, and the billing and entitlement records, where one is a second
  * number beside an exact amount.
  *
- * Decided in: docs/adr/0006-oxy-relay-boundary.md, docs/adr/0010-public-api-compatibility.md.
+ * A SIGNED document is strict at its top level for a third reason, and there it
+ * is forced rather than chosen. `aliaModelReleaseManifestSchema` carries
+ * signatures over its own canonical bytes, so a field stripped at this parse is a
+ * field missing from the bytes a verifier re-canonicalizes: a tolerant parse
+ * would report an invalid SIGNATURE where the truth is that this build does not
+ * understand the DOCUMENT. Its producer can run ahead of this package — Alia's
+ * release tooling is deployed independently — so the usual argument applies here
+ * and is outweighed, because the refusal costs an operator one retry after Oxy
+ * takes the newer contract, while the tolerant parse costs a misdiagnosis of a
+ * cryptographic failure.
+ *
+ * Decided in: docs/adr/0006-oxy-relay-boundary.md,
+ * docs/adr/0010-public-api-compatibility.md,
+ * docs/adr/0017-authorized-routes-in-the-envelope.md.
  */
 /**
  * Version of the contract SET as a whole — the value the control plane and the
@@ -86,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 = "1.1.0";
+export declare const INFERENCE_CONTRACT_VERSION = "1.3.0";

package/dist/types/keyRecovery.d.ts

@@ -60,17 +60,17 @@ export declare const encryptedBackupEnvelopeSchema: z.ZodObject<{
     createdAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     version: number;
+    createdAt: string;
     nonce: string;
     ciphertext: string;
-    createdAt: string;
     algorithm: "xchacha20poly1305";
     kdfInfo: string;
     publicKeyHint: string;
 }, {
     version: number;
+    createdAt: string;
     nonce: string;
     ciphertext: string;
-    createdAt: string;
     algorithm: "xchacha20poly1305";
     kdfInfo: string;
     publicKeyHint: string;
@@ -99,18 +99,18 @@ export declare const backupUploadRequestSchema: z.ZodObject<{
     lookupId: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     version: number;
+    createdAt: string;
     nonce: string;
     ciphertext: string;
-    createdAt: string;
     algorithm: "xchacha20poly1305";
     kdfInfo: string;
     publicKeyHint: string;
     lookupId: string;
 }, {
     version: number;
+    createdAt: string;
     nonce: string;
     ciphertext: string;
-    createdAt: string;
     algorithm: "xchacha20poly1305";
     kdfInfo: string;
     publicKeyHint: string;

package/dist/types/updates.d.ts

@@ -115,18 +115,22 @@ export declare const assetUploadTicketSchema: z.ZodObject<{
      * carries the long immutable cache header (assets are content-addressed).
      */
     cacheControl: z.ZodString;
+    /** Base64 SHA-256 value required in the presigned PUT's checksum header. */
+    checksumSHA256: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     sha256: string;
     contentType: string;
     uploadUrl: string;
     storageKey: string;
     cacheControl: string;
+    checksumSHA256: string;
 }, {
     sha256: string;
     contentType: string;
     uploadUrl: string;
     storageKey: string;
     cacheControl: string;
+    checksumSHA256: string;
 }>;
 export type AssetUploadTicket = z.infer<typeof assetUploadTicketSchema>;
 /**
@@ -149,18 +153,22 @@ export declare const assetInitResponseSchema: z.ZodObject<{
          * carries the long immutable cache header (assets are content-addressed).
          */
         cacheControl: z.ZodString;
+        /** Base64 SHA-256 value required in the presigned PUT's checksum header. */
+        checksumSHA256: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         sha256: string;
         contentType: string;
         uploadUrl: string;
         storageKey: string;
         cacheControl: string;
+        checksumSHA256: string;
     }, {
         sha256: string;
         contentType: string;
         uploadUrl: string;
         storageKey: string;
         cacheControl: string;
+        checksumSHA256: string;
     }>, "many">;
     existing: z.ZodArray<z.ZodString, "many">;
 }, "strip", z.ZodTypeAny, {
@@ -170,6 +178,7 @@ export declare const assetInitResponseSchema: z.ZodObject<{
         uploadUrl: string;
         storageKey: string;
         cacheControl: string;
+        checksumSHA256: string;
     }[];
     existing: string[];
 }, {
@@ -179,6 +188,7 @@ export declare const assetInitResponseSchema: z.ZodObject<{
         uploadUrl: string;
         storageKey: string;
         cacheControl: string;
+        checksumSHA256: string;
     }[];
     existing: string[];
 }>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxyhq/contracts",
-  "version": "0.29.0",
+  "version": "0.31.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",