@oxyhq/contracts 0.29.0 → 0.31.0

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

@@ -56,8 +56,16 @@ export declare const oxyCredentialIdSchema: z.ZodString;
  * traceable as one that was served (ADR 0007, and step 1 of ADR 0010's edge
  * order). It is required on the inbound envelope, which is what makes the data
  * plane a consumer of this id rather than its source: the data plane echoes it
- * on every stream event, on the usage report and on anything it can be asked
- * about later.
+ * on every stream event, on the usage report, in its response header and on
+ * anything it can be asked about later. It never mints one for a request it
+ * received.
+ *
+ * The one case that is NOT an exception to that: an envelope the data plane
+ * cannot read or authenticate carries no id to echo, so its rejection is
+ * labelled with an id of the data plane's own — visibly local, and never
+ * correlated with an Oxy request, because there is no Oxy request it belongs to.
+ * Saying so is what stops "consumer, not source" from being read as forbidding
+ * the only id such a rejection could have.
  *
  * Correlates the Oxy edge, the data plane, the financial ledger and the
  * customer-visible receipt, so it appears on every stream event and every
@@ -95,6 +103,16 @@ export declare const inferenceTimestampSchema: z.ZodString;
 export declare const inferenceDateSchema: z.ZodString;
 /** An absolute https URL, for model cards, licenses and provider documentation. */
 export declare const inferenceHttpsUrlSchema: z.ZodString;
+/**
+ * A content digest, `sha256:<64 lowercase hex>`.
+ *
+ * ONE spelling, because a digest is compared for equality and nothing else: an
+ * uppercase or unprefixed variant of the same hash is a different string, so two
+ * records describing the same bytes would not match. Lowercase hex with the
+ * algorithm prefix is what the `inference_model_revisions` CHECK stores and what
+ * every artifact registry emits.
+ */
+export declare const sha256DigestSchema: z.ZodString;
 /** A publisher slug, e.g. `openai`, `anthropic`, `meta`, `alia`. */
 export declare const publisherSlugSchema: z.ZodString;
 /** A model slug within its publisher's namespace, e.g. `gpt-5`, `llama-3.1-70b`. */