@oxy.so/contracts 4.11.0-oxy-one.0 → 4.12.0

package/dist/types/accountGraph.d.ts

@@ -118,7 +118,7 @@ export declare function isOperatorSwitchTargetKind(kind: AccountKind | null | un
  * Narrow an unknown value to an {@link AccountKind}.
  *
  * The user-DTO serializers read from structurally-permissive `unknown` sources
- * (a Drizzle row, a Mongo document, an already-formatted object), so each one
+ * (a Drizzle row, a raw document, an already-formatted object), so each one
  * would otherwise hand-roll this check and they would drift on what counts.
  */
 export declare function isAccountKind(value: unknown): value is AccountKind;

package/dist/types/accountSubject.d.ts

@@ -166,7 +166,7 @@ export declare const financialEffectAttributionSchema: z.ZodEffects<z.ZodObject<
     }>;
 }, "strict", z.ZodTypeAny, {
     schemaVersion: 1;
-    direction: "debit" | "credit";
+    direction: "credit" | "debit";
     subjectAccountId: string & z.BRAND<"OxyAccountId">;
     actor: {
         schemaVersion: 1;
@@ -176,7 +176,7 @@ export declare const financialEffectAttributionSchema: z.ZodEffects<z.ZodObject<
     };
 }, {
     schemaVersion: 1;
-    direction: "debit" | "credit";
+    direction: "credit" | "debit";
     subjectAccountId: string;
     actor: {
         schemaVersion: 1;
@@ -186,7 +186,7 @@ export declare const financialEffectAttributionSchema: z.ZodEffects<z.ZodObject<
     };
 }>, {
     schemaVersion: 1;
-    direction: "debit" | "credit";
+    direction: "credit" | "debit";
     subjectAccountId: string & z.BRAND<"OxyAccountId">;
     actor: {
         schemaVersion: 1;
@@ -196,7 +196,7 @@ export declare const financialEffectAttributionSchema: z.ZodEffects<z.ZodObject<
     };
 }, {
     schemaVersion: 1;
-    direction: "debit" | "credit";
+    direction: "credit" | "debit";
     subjectAccountId: string;
     actor: {
         schemaVersion: 1;

package/dist/types/commonsSignIn.d.ts

@@ -30,8 +30,8 @@
 import { z } from 'zod';
 /**
  * The closed set, as a value — consumed directly where a runtime list is
- * required (e.g. the Mongoose `enum` of `AuthSession.deniedReason`, which is
- * the storage-level guarantee that an unauthenticated caller can never write
+ * required (e.g. the `enum` of the `auth_sessions.denied_reason` column, which
+ * is the storage-level guarantee that an unauthenticated caller can never write
  * free-form text into the field).
  */
 export declare const COMMONS_DENY_REASONS: readonly ["declined", "not_me"];

package/dist/types/email/messages.d.ts

@@ -35,6 +35,29 @@ export type EmailFilterActionType = (typeof EMAIL_FILTER_ACTION_TYPES)[number];
 /** Lifecycle of a durable outbound delivery. */
 export declare const EMAIL_OUTBOX_STATUSES: readonly ["pending", "processing", "sent", "failed", "cancelled"];
 export type EmailOutboxStatus = (typeof EMAIL_OUTBOX_STATUSES)[number];
+/**
+ * Where a message the user sent stands, as its Sent copy reports it.
+ *
+ * A send is filed in Sent the moment the API accepts it and handed to the relay
+ * afterwards, so being in Sent no longer means having left. `sent` means the
+ * relay took it; `retrying` means an attempt failed and another is scheduled;
+ * `failed` means nothing more will happen on its own.
+ */
+export declare const EMAIL_DELIVERY_STATES: readonly ["sending", "retrying", "sent", "failed"];
+export type EmailDeliveryState = (typeof EMAIL_DELIVERY_STATES)[number];
+/**
+ * Why a delivery is retrying or failed, in words a client can translate.
+ *
+ * - `relay_unavailable`: the relay did not answer or answered 4xx (transient).
+ * - `relay_unconfigured`: this server has no relay; an operator must fix it.
+ * - `relay_auth`: the relay rejected Oxy's credential; an operator must fix it.
+ * - `rejected`: the relay refused this message with a 5xx.
+ * - `retries_exhausted`: it stayed `relay_unavailable` for the whole budget.
+ * - `bounced`: the relay took it, then a recipient's server refused it.
+ * - `cancelled`: the sender stopped it.
+ */
+export declare const EMAIL_DELIVERY_ERROR_CODES: readonly ["relay_unavailable", "relay_unconfigured", "relay_auth", "rejected", "retries_exhausted", "bounced", "cancelled"];
+export type EmailDeliveryErrorCode = (typeof EMAIL_DELIVERY_ERROR_CODES)[number];
 /** One addressee. A header without a display name carries `name: ''`. */
 export declare const emailMessageAddressSchema: z.ZodObject<{
     name: z.ZodString;
@@ -130,6 +153,39 @@ export declare const emailMessageHighlightSchema: z.ZodObject<{
     label: string;
 }>;
 export type EmailMessageHighlightWire = z.infer<typeof emailMessageHighlightSchema>;
+/**
+ * The delivery of a message the user sent. `error` is the relay's own words;
+ * `errorCode` is the same failure in the vocabulary above, and is `null` when
+ * there is nothing to explain — or when a newer server names a reason this
+ * client does not know yet, which then still reads as a delivery.
+ * `nextAttemptAt` is set only while `retrying`.
+ */
+export declare const emailMessageDeliverySchema: z.ZodObject<{
+    state: z.ZodEnum<["sending", "retrying", "sent", "failed"]>;
+    attempts: z.ZodNumber;
+    maxAttempts: z.ZodNumber;
+    nextAttemptAt: z.ZodNullable<z.ZodString>;
+    error: z.ZodNullable<z.ZodString>;
+    errorCode: z.ZodCatch<z.ZodNullable<z.ZodEnum<["relay_unavailable", "relay_unconfigured", "relay_auth", "rejected", "retries_exhausted", "bounced", "cancelled"]>>>;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    updatedAt: string;
+    state: "failed" | "sent" | "sending" | "retrying";
+    error: string | null;
+    attempts: number;
+    maxAttempts: number;
+    nextAttemptAt: string | null;
+    errorCode: "rejected" | "cancelled" | "relay_unavailable" | "relay_unconfigured" | "relay_auth" | "retries_exhausted" | "bounced" | null;
+}, {
+    updatedAt: string;
+    state: "failed" | "sent" | "sending" | "retrying";
+    error: string | null;
+    attempts: number;
+    maxAttempts: number;
+    nextAttemptAt: string | null;
+    errorCode?: unknown;
+}>;
+export type EmailMessageDeliveryWire = z.infer<typeof emailMessageDeliverySchema>;
 /**
  * A stored message as every `/email` read returns it.
  *
@@ -294,6 +350,36 @@ export declare const emailMessageSchema: z.ZodObject<{
     /** Present only on list reads that walked the thread. */
     threadCount: z.ZodOptional<z.ZodNumber>;
     threadParticipants: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Present only on a message the user sent through Oxy since delivery was
+     * tracked; absent on received mail. A delivery this client cannot read is
+     * dropped rather than allowed to drop the message with it.
+     */
+    delivery: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        state: z.ZodEnum<["sending", "retrying", "sent", "failed"]>;
+        attempts: z.ZodNumber;
+        maxAttempts: z.ZodNumber;
+        nextAttemptAt: z.ZodNullable<z.ZodString>;
+        error: z.ZodNullable<z.ZodString>;
+        errorCode: z.ZodCatch<z.ZodNullable<z.ZodEnum<["relay_unavailable", "relay_unconfigured", "relay_auth", "rejected", "retries_exhausted", "bounced", "cancelled"]>>>;
+        updatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        updatedAt: string;
+        state: "failed" | "sent" | "sending" | "retrying";
+        error: string | null;
+        attempts: number;
+        maxAttempts: number;
+        nextAttemptAt: string | null;
+        errorCode: "rejected" | "cancelled" | "relay_unavailable" | "relay_unconfigured" | "relay_auth" | "retries_exhausted" | "bounced" | null;
+    }, {
+        updatedAt: string;
+        state: "failed" | "sent" | "sending" | "retrying";
+        error: string | null;
+        attempts: number;
+        maxAttempts: number;
+        nextAttemptAt: string | null;
+        errorCode?: unknown;
+    }>>>;
 }, "strip", z.ZodTypeAny, {
     date: string;
     id: string;
@@ -373,6 +459,15 @@ export declare const emailMessageSchema: z.ZodObject<{
     senderAvatarPath?: string | null | undefined;
     threadCount?: number | undefined;
     threadParticipants?: string[] | undefined;
+    delivery?: {
+        updatedAt: string;
+        state: "failed" | "sent" | "sending" | "retrying";
+        error: string | null;
+        attempts: number;
+        maxAttempts: number;
+        nextAttemptAt: string | null;
+        errorCode: "rejected" | "cancelled" | "relay_unavailable" | "relay_unconfigured" | "relay_auth" | "retries_exhausted" | "bounced" | null;
+    } | undefined;
 }, {
     date: string;
     id: string;
@@ -452,6 +547,7 @@ export declare const emailMessageSchema: z.ZodObject<{
     senderAvatarPath?: string | null | undefined;
     threadCount?: number | undefined;
     threadParticipants?: string[] | undefined;
+    delivery?: unknown;
 }>;
 export type EmailMessageWire = z.infer<typeof emailMessageSchema>;
 export declare const emailMailboxSchema: z.ZodObject<{
@@ -898,6 +994,36 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
         /** Present only on list reads that walked the thread. */
         threadCount: z.ZodOptional<z.ZodNumber>;
         threadParticipants: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * Present only on a message the user sent through Oxy since delivery was
+         * tracked; absent on received mail. A delivery this client cannot read is
+         * dropped rather than allowed to drop the message with it.
+         */
+        delivery: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            state: z.ZodEnum<["sending", "retrying", "sent", "failed"]>;
+            attempts: z.ZodNumber;
+            maxAttempts: z.ZodNumber;
+            nextAttemptAt: z.ZodNullable<z.ZodString>;
+            error: z.ZodNullable<z.ZodString>;
+            errorCode: z.ZodCatch<z.ZodNullable<z.ZodEnum<["relay_unavailable", "relay_unconfigured", "relay_auth", "rejected", "retries_exhausted", "bounced", "cancelled"]>>>;
+            updatedAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            updatedAt: string;
+            state: "failed" | "sent" | "sending" | "retrying";
+            error: string | null;
+            attempts: number;
+            maxAttempts: number;
+            nextAttemptAt: string | null;
+            errorCode: "rejected" | "cancelled" | "relay_unavailable" | "relay_unconfigured" | "relay_auth" | "retries_exhausted" | "bounced" | null;
+        }, {
+            updatedAt: string;
+            state: "failed" | "sent" | "sending" | "retrying";
+            error: string | null;
+            attempts: number;
+            maxAttempts: number;
+            nextAttemptAt: string | null;
+            errorCode?: unknown;
+        }>>>;
     }, "strip", z.ZodTypeAny, {
         date: string;
         id: string;
@@ -977,6 +1103,15 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
         senderAvatarPath?: string | null | undefined;
         threadCount?: number | undefined;
         threadParticipants?: string[] | undefined;
+        delivery?: {
+            updatedAt: string;
+            state: "failed" | "sent" | "sending" | "retrying";
+            error: string | null;
+            attempts: number;
+            maxAttempts: number;
+            nextAttemptAt: string | null;
+            errorCode: "rejected" | "cancelled" | "relay_unavailable" | "relay_unconfigured" | "relay_auth" | "retries_exhausted" | "bounced" | null;
+        } | undefined;
     }, {
         date: string;
         id: string;
@@ -1056,6 +1191,7 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
         senderAvatarPath?: string | null | undefined;
         threadCount?: number | undefined;
         threadParticipants?: string[] | undefined;
+        delivery?: unknown;
     }>, "many">;
     bundles: z.ZodArray<z.ZodObject<{
         bundle: z.ZodObject<{
@@ -1255,6 +1391,36 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
             /** Present only on list reads that walked the thread. */
             threadCount: z.ZodOptional<z.ZodNumber>;
             threadParticipants: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            /**
+             * Present only on a message the user sent through Oxy since delivery was
+             * tracked; absent on received mail. A delivery this client cannot read is
+             * dropped rather than allowed to drop the message with it.
+             */
+            delivery: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                state: z.ZodEnum<["sending", "retrying", "sent", "failed"]>;
+                attempts: z.ZodNumber;
+                maxAttempts: z.ZodNumber;
+                nextAttemptAt: z.ZodNullable<z.ZodString>;
+                error: z.ZodNullable<z.ZodString>;
+                errorCode: z.ZodCatch<z.ZodNullable<z.ZodEnum<["relay_unavailable", "relay_unconfigured", "relay_auth", "rejected", "retries_exhausted", "bounced", "cancelled"]>>>;
+                updatedAt: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                updatedAt: string;
+                state: "failed" | "sent" | "sending" | "retrying";
+                error: string | null;
+                attempts: number;
+                maxAttempts: number;
+                nextAttemptAt: string | null;
+                errorCode: "rejected" | "cancelled" | "relay_unavailable" | "relay_unconfigured" | "relay_auth" | "retries_exhausted" | "bounced" | null;
+            }, {
+                updatedAt: string;
+                state: "failed" | "sent" | "sending" | "retrying";
+                error: string | null;
+                attempts: number;
+                maxAttempts: number;
+                nextAttemptAt: string | null;
+                errorCode?: unknown;
+            }>>>;
         }, "strip", z.ZodTypeAny, {
             date: string;
             id: string;
@@ -1334,6 +1500,15 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
             senderAvatarPath?: string | null | undefined;
             threadCount?: number | undefined;
             threadParticipants?: string[] | undefined;
+            delivery?: {
+                updatedAt: string;
+                state: "failed" | "sent" | "sending" | "retrying";
+                error: string | null;
+                attempts: number;
+                maxAttempts: number;
+                nextAttemptAt: string | null;
+                errorCode: "rejected" | "cancelled" | "relay_unavailable" | "relay_unconfigured" | "relay_auth" | "retries_exhausted" | "bounced" | null;
+            } | undefined;
         }, {
             date: string;
             id: string;
@@ -1413,6 +1588,7 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
             senderAvatarPath?: string | null | undefined;
             threadCount?: number | undefined;
             threadParticipants?: string[] | undefined;
+            delivery?: unknown;
         }>, "many">;
         unreadCount: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
@@ -1495,6 +1671,15 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
             senderAvatarPath?: string | null | undefined;
             threadCount?: number | undefined;
             threadParticipants?: string[] | undefined;
+            delivery?: {
+                updatedAt: string;
+                state: "failed" | "sent" | "sending" | "retrying";
+                error: string | null;
+                attempts: number;
+                maxAttempts: number;
+                nextAttemptAt: string | null;
+                errorCode: "rejected" | "cancelled" | "relay_unavailable" | "relay_unconfigured" | "relay_auth" | "retries_exhausted" | "bounced" | null;
+            } | undefined;
         }[];
         bundle: {
             name: string;
@@ -1591,6 +1776,7 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
             senderAvatarPath?: string | null | undefined;
             threadCount?: number | undefined;
             threadParticipants?: string[] | undefined;
+            delivery?: unknown;
         }[];
         bundle: {
             name: string;
@@ -1690,6 +1876,15 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
         senderAvatarPath?: string | null | undefined;
         threadCount?: number | undefined;
         threadParticipants?: string[] | undefined;
+        delivery?: {
+            updatedAt: string;
+            state: "failed" | "sent" | "sending" | "retrying";
+            error: string | null;
+            attempts: number;
+            maxAttempts: number;
+            nextAttemptAt: string | null;
+            errorCode: "rejected" | "cancelled" | "relay_unavailable" | "relay_unconfigured" | "relay_auth" | "retries_exhausted" | "bounced" | null;
+        } | undefined;
     }[];
     bundles: {
         messages: {
@@ -1771,6 +1966,15 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
             senderAvatarPath?: string | null | undefined;
             threadCount?: number | undefined;
             threadParticipants?: string[] | undefined;
+            delivery?: {
+                updatedAt: string;
+                state: "failed" | "sent" | "sending" | "retrying";
+                error: string | null;
+                attempts: number;
+                maxAttempts: number;
+                nextAttemptAt: string | null;
+                errorCode: "rejected" | "cancelled" | "relay_unavailable" | "relay_unconfigured" | "relay_auth" | "retries_exhausted" | "bounced" | null;
+            } | undefined;
         }[];
         bundle: {
             name: string;
@@ -1869,6 +2073,7 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
         senderAvatarPath?: string | null | undefined;
         threadCount?: number | undefined;
         threadParticipants?: string[] | undefined;
+        delivery?: unknown;
     }[];
     bundles: {
         messages: {
@@ -1950,6 +2155,7 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
             senderAvatarPath?: string | null | undefined;
             threadCount?: number | undefined;
             threadParticipants?: string[] | undefined;
+            delivery?: unknown;
         }[];
         bundle: {
             name: string;
@@ -2035,8 +2241,8 @@ export declare const emailOutboxSchema: z.ZodObject<{
     messageId: string;
     attempts: number;
     maxAttempts: number;
-    terminal: boolean;
     nextAttemptAt: string;
+    terminal: boolean;
     lastError: string | null;
     sentAt: string | null;
 }, {
@@ -2047,8 +2253,8 @@ export declare const emailOutboxSchema: z.ZodObject<{
     messageId: string;
     attempts: number;
     maxAttempts: number;
-    terminal: boolean;
     nextAttemptAt: string;
+    terminal: boolean;
     lastError: string | null;
     sentAt: string | null;
 }>;

package/dist/types/identity.d.ts

@@ -417,7 +417,7 @@ export declare const exportFinancialSectionSchema: z.ZodType<ExportFinancialSect
  * `proof` when the user signed the bundle with their own key.
  */
 export interface ExportBundle {
-    '$schema': string;
+    $schema: string;
     exportedAt: string;
     did: string;
     didDocument: DidDocument;

package/dist/types/index.d.ts

@@ -64,8 +64,8 @@ export type { EmailVerificationPurpose, EmailVerificationStartRequest, EmailVeri
 export { transparencyCheckpointSignatureSchema, transparencyAnchorSchema, transparencyCheckpointSchema, transparencyInclusionProofSchema, transparencyCheckpointListSchema, } from './transparency';
 export type { TransparencyCheckpointSignature, TransparencyAnchor, TransparencyCheckpoint, TransparencyInclusionProof, TransparencyCheckpointList, } from './transparency';
 export { INFERENCE_CONTRACT_VERSION, } from './inference/version';
-export { oxyAccountIdSchema, delegatedUserIdSchema, oxyApplicationIdSchema, oxyCredentialIdSchema, requestIdSchema, generationIdSchema, idempotencyKeySchema, inferenceEnvironmentSchema, inferenceTimestampSchema, inferenceDateSchema, inferenceHttpsUrlSchema, sha256DigestSchema, publisherSlugSchema, modelSlugSchema, modelIdSchema, modelRevisionLabelSchema, modelReferenceSchema, routingProfileIdSchema, routingProfileSlugSchema, inferenceProviderSlugSchema, deploymentIdSchema, inferenceRegionSchema, RESERVED_ALIA_PUBLISHER, } from './inference/identifiers';
-export type { OxyAccountId, DelegatedUserId, InferenceEnvironment, ModelReference, ModelId, } from './inference/identifiers';
+export { oxyAccountIdSchema, delegatedUserIdSchema, oxyApplicationIdSchema, oxyCredentialIdSchema, requestIdSchema, generationIdSchema, idempotencyKeySchema, inferenceEnvironmentSchema, inferenceTimestampSchema, inferenceDateSchema, inferenceHttpsUrlSchema, sha256DigestSchema, publisherSlugSchema, modelSlugSchema, modelIdSchema, modelRevisionLabelSchema, modelReferenceSchema, routingProfileIdSchema, routingProfileSlugSchema, inferenceProviderSlugSchema, deploymentIdSchema, inferenceRegionSchema, inferenceFundingTierSchema, RESERVED_ALIA_PUBLISHER, } from './inference/identifiers';
+export type { OxyAccountId, DelegatedUserId, InferenceEnvironment, InferenceFundingTier, ModelReference, ModelId, } from './inference/identifiers';
 export { currencyCodeSchema, INFERENCE_MONEY_SCALE, exactDecimalSchema, moneySchema, USAGE_UNITS, usageUnitSchema, USAGE_SOURCES, usageSourceSchema, usageQuantitySchema, unitPriceSchema, } from './inference/money';
 export type { CurrencyCode, ExactDecimal, Money, UsageUnit, UsageSource, UsageQuantity, UnitPrice, } from './inference/money';
 export { INFERENCE_SCOPES, inferenceScopeSchema, billingPrincipalSchema, authenticatedPrincipalSchema, inferenceAttributionSchema, } from './inference/attribution';
@@ -106,8 +106,8 @@ export { catalogInvocationPathParameters, catalogInvocationsOverlap, catalogInvo
 export type { CatalogInvocationMatch, CatalogInvocationTemplate, ResolvedCatalogInvocation, } from './capabilityInvocation';
 export { emailContextAddressSchema, emailContextMailboxSchema, emailContextMessageSchema, emailAgentContextSchema, } from './emailAgentContext';
 export type { EmailContextAddress, EmailContextMailbox, EmailContextMessage, EmailAgentContext, } from './emailAgentContext';
-export { inboxComposeRequestSchema, inboxDailyBriefRequestSchema, inboxNaturalSearchRequestSchema, inboxMessageInferenceParamsSchema, inboxInferenceTextResponseSchema, inboxNaturalSearchResponseSchema, inboxSmartRepliesResponseSchema, inboxThreadSummaryResponseSchema, inboxInferenceStreamEventSchema, } from './inference/inbox';
-export type { InboxComposeRequest, InboxDailyBriefRequest, InboxInferenceTextResponse, InboxNaturalSearchResponse, InboxSmartRepliesResponse, InboxThreadSummaryResponse, InboxInferenceStreamEvent, } from './inference/inbox';
+export { inboxComposeRequestSchema, inboxDailyBriefRequestSchema, inboxDailyBriefResponseSchema, INBOX_DAILY_BRIEF_SECTIONS, inboxNaturalSearchRequestSchema, inboxMessageInferenceParamsSchema, inboxInferenceTextResponseSchema, inboxNaturalSearchResponseSchema, inboxSmartRepliesResponseSchema, inboxThreadSummaryResponseSchema, inboxInferenceStreamEventSchema, } from './inference/inbox';
+export type { InboxComposeRequest, InboxDailyBriefRequest, InboxDailyBriefResponse, InboxDailyBriefSection, InboxInferenceTextResponse, InboxNaturalSearchResponse, InboxSmartRepliesResponse, InboxThreadSummaryResponse, InboxInferenceStreamEvent, } from './inference/inbox';
 export * from './externalIdentity';
 export * from './linkedAccounts';
 export * from './federationInstanceFetch';
@@ -116,19 +116,19 @@ export * from './email/messages';
 export * from './stickers';
 export { decisionEffortSchema, decisionQuestionSchema, decisionInputSchema, decisionRequestSchema, decisionAnswerSchema, decisionResultSchema, decisionSuccessSchema, decisionFailureSchema, decisionInputBudget, decisionFitsGateway, decisionAnswersMatch, } from './inference/decisions';
 export type { DecisionQuestion, DecisionInput, DecisionRequest, DecisionAnswer, DecisionFailure, DecisionResult, DecisionSuccess, } from './inference/decisions';
-export { SCOPED_EXECUTION_CONTRACT_VERSION, SCOPED_REQUEST_ENVELOPE_VERSION, scopedExecutionAudienceSchema, scopedExecutionSchema, canonicalScopedExecutionJson } from './inference/scopedExecution';
+export { SCOPED_EXECUTION_CONTRACT_VERSION, SCOPED_REQUEST_ENVELOPE_VERSION, scopedExecutionAudienceSchema, scopedExecutionSchema, canonicalScopedExecutionJson, } from './inference/scopedExecution';
 export type { ScopedExecutionAudience, ScopedExecution } from './inference/scopedExecution';
 export { scopedInferenceRequestSchema } from './inference/request';
 export type { ScopedInferenceRequest } from './inference/request';
 export { PRIVATE_AUTO_EXECUTION_CONTRACT_VERSION, PRIVATE_AUTO_REQUEST_ENVELOPE_VERSION, PRIVATE_AUTO_LIMITS, PRIVATE_AUTO_INSTRUCTIONS, PRIVATE_AUTO_QUESTION, privateAutoPrincipalSchema, privateAutoSourceApprovalSchema, privateAutoExecutionSchema, privateAutoInputSchema, privateAutoOperationId, } from './inference/privateAutoExecution';
-export type { PrivateAutoPrincipal, PrivateAutoSourceApproval, PrivateAutoExecution } from './inference/privateAutoExecution';
+export type { PrivateAutoPrincipal, PrivateAutoSourceApproval, PrivateAutoExecution, } from './inference/privateAutoExecution';
 export { privateAutoInferenceRequestSchema } from './inference/request';
 export type { PrivateAutoInferenceRequest } from './inference/request';
 export { productDefinitionSchema, subjectProductAccessQuerySchema, productBenefitSchema, productOfferSchema, productSubscriptionSourceSchema, productAccessGrantSchema, subjectProductGrantSnapshotSchema, productOfferSegmentSchema, subjectProductAccessSchema, } from './products/access';
 export type { ProductDefinition, SubjectProductAccessQuery, SubjectProductGrantSnapshot, ProductBenefit, ProductOffer, ProductSubscriptionSource, ProductAccessGrant, ProductOfferSegment, SubjectProductAccess, } from './products/access';
-export { meteredGenerationSchema, type MeteredGeneration } from "./inference/economics";
-export { canonicalCapabilityJson, inputSatisfiesCapabilityLimits, isLoopbackOrigin } from './capabilityBindings';
+export { meteredGenerationSchema, type MeteredGeneration } from './inference/economics';
+export { canonicalCapabilityJson, inputSatisfiesCapabilityLimits, isLoopbackOrigin, } from './capabilityBindings';
 export * from './agentKeys';
-export { productSubscriptionSummarySchema, productSubscriptionsResponseSchema, subscriptionCreditGrantSchema, subscriptionCreditGrantsResponseSchema, cancelProductSubscriptionSchema, productSubscriptionCancellationResultSchema, type ProductSubscriptionSummary, type SubscriptionCreditGrant, type ProductSubscriptionCancellationResult } from './products/billing';
-export { personalPlanDisplayPriceSchema, personalPlanCatalogueSchema, type PersonalPlanCatalogue } from './products/plans';
+export { productSubscriptionSummarySchema, productSubscriptionsResponseSchema, subscriptionCreditGrantSchema, subscriptionCreditGrantsResponseSchema, cancelProductSubscriptionSchema, productSubscriptionCancellationResultSchema, type ProductSubscriptionSummary, type SubscriptionCreditGrant, type ProductSubscriptionCancellationResult, } from './products/billing';
+export { personalPlanDisplayPriceSchema, personalPlanCatalogueSchema, type PersonalPlanCatalogue, } from './products/plans';
 export * from './products/checkout';

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

@@ -322,7 +322,7 @@ export declare const billingInvoiceSchema: z.ZodObject<{
     paidAt: z.ZodOptional<z.ZodString>;
     receiptCount: z.ZodNumber;
 }, "strict", z.ZodTypeAny, {
-    status: "void" | "draft" | "open" | "paid";
+    status: "void" | "paid" | "draft" | "open";
     schemaVersion: 1;
     accountId: string & z.BRAND<"OxyAccountId">;
     id: string;
@@ -337,7 +337,7 @@ export declare const billingInvoiceSchema: z.ZodObject<{
     externalInvoiceRef?: string | undefined;
     paidAt?: string | undefined;
 }, {
-    status: "void" | "draft" | "open" | "paid";
+    status: "void" | "paid" | "draft" | "open";
     schemaVersion: 1;
     accountId: string;
     id: string;

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

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import { z } from 'zod';
 export declare const decisionEffortSchema: z.ZodEnum<["instant", "low", "medium", "high", "xhigh"]>;
 export declare const decisionQuestionSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: z.ZodLiteral<"choice">;
@@ -531,6 +531,7 @@ export declare const decisionResultSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         servingProvider: z.ZodString;
         deploymentId: z.ZodString;
         routeSwitches: z.ZodNumber;
+        fundingTier: z.ZodOptional<z.ZodEnum<["free", "credit", "paid"]>>;
         startedAt: z.ZodString;
         completedAt: z.ZodString;
         timeToFirstTokenMs: z.ZodOptional<z.ZodNumber>;
@@ -564,6 +565,7 @@ export declare const decisionResultSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         routeSwitches: number;
         startedAt: string;
         generationId?: string | undefined;
+        fundingTier?: "free" | "credit" | "paid" | undefined;
         timeToFirstTokenMs?: number | undefined;
     }, {
         schemaVersion: 2;
@@ -595,6 +597,7 @@ export declare const decisionResultSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         routeSwitches: number;
         startedAt: string;
         generationId?: string | undefined;
+        fundingTier?: "free" | "credit" | "paid" | undefined;
         timeToFirstTokenMs?: number | undefined;
     }>, {
         schemaVersion: 2;
@@ -626,6 +629,7 @@ export declare const decisionResultSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         routeSwitches: number;
         startedAt: string;
         generationId?: string | undefined;
+        fundingTier?: "free" | "credit" | "paid" | undefined;
         timeToFirstTokenMs?: number | undefined;
     }, {
         schemaVersion: 2;
@@ -657,6 +661,7 @@ export declare const decisionResultSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         routeSwitches: number;
         startedAt: string;
         generationId?: string | undefined;
+        fundingTier?: "free" | "credit" | "paid" | undefined;
         timeToFirstTokenMs?: number | undefined;
     }>;
     schemaVersion: z.ZodLiteral<1>;
@@ -803,6 +808,7 @@ export declare const decisionResultSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         routeSwitches: number;
         startedAt: string;
         generationId?: string | undefined;
+        fundingTier?: "free" | "credit" | "paid" | undefined;
         timeToFirstTokenMs?: number | undefined;
     };
 }, {
@@ -857,6 +863,7 @@ export declare const decisionResultSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         routeSwitches: number;
         startedAt: string;
         generationId?: string | undefined;
+        fundingTier?: "free" | "credit" | "paid" | undefined;
         timeToFirstTokenMs?: number | undefined;
     };
 }>, {
@@ -911,6 +918,7 @@ export declare const decisionResultSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         routeSwitches: number;
         startedAt: string;
         generationId?: string | undefined;
+        fundingTier?: "free" | "credit" | "paid" | undefined;
         timeToFirstTokenMs?: number | undefined;
     };
 }, {
@@ -965,6 +973,7 @@ export declare const decisionResultSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         routeSwitches: number;
         startedAt: string;
         generationId?: string | undefined;
+        fundingTier?: "free" | "credit" | "paid" | undefined;
         timeToFirstTokenMs?: number | undefined;
     };
 }>, {
@@ -1019,6 +1028,7 @@ export declare const decisionResultSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         routeSwitches: number;
         startedAt: string;
         generationId?: string | undefined;
+        fundingTier?: "free" | "credit" | "paid" | undefined;
         timeToFirstTokenMs?: number | undefined;
     };
 }, {
@@ -1073,6 +1083,7 @@ export declare const decisionResultSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         routeSwitches: number;
         startedAt: string;
         generationId?: string | undefined;
+        fundingTier?: "free" | "credit" | "paid" | undefined;
         timeToFirstTokenMs?: number | undefined;
     };
 }>;
@@ -1250,6 +1261,7 @@ export declare const decisionFailureSchema: z.ZodEffects<z.ZodObject<{
         servingProvider: z.ZodString;
         deploymentId: z.ZodString;
         routeSwitches: z.ZodNumber;
+        fundingTier: z.ZodOptional<z.ZodEnum<["free", "credit", "paid"]>>;
         startedAt: z.ZodString;
         completedAt: z.ZodString;
         timeToFirstTokenMs: z.ZodOptional<z.ZodNumber>;
@@ -1283,6 +1295,7 @@ export declare const decisionFailureSchema: z.ZodEffects<z.ZodObject<{
         routeSwitches: number;
         startedAt: string;
         generationId?: string | undefined;
+        fundingTier?: "free" | "credit" | "paid" | undefined;
         timeToFirstTokenMs?: number | undefined;
     }, {
         schemaVersion: 2;
@@ -1314,6 +1327,7 @@ export declare const decisionFailureSchema: z.ZodEffects<z.ZodObject<{
         routeSwitches: number;
         startedAt: string;
         generationId?: string | undefined;
+        fundingTier?: "free" | "credit" | "paid" | undefined;
         timeToFirstTokenMs?: number | undefined;
     }>, {
         schemaVersion: 2;
@@ -1345,6 +1359,7 @@ export declare const decisionFailureSchema: z.ZodEffects<z.ZodObject<{
         routeSwitches: number;
         startedAt: string;
         generationId?: string | undefined;
+        fundingTier?: "free" | "credit" | "paid" | undefined;
         timeToFirstTokenMs?: number | undefined;
     }, {
         schemaVersion: 2;
@@ -1376,6 +1391,7 @@ export declare const decisionFailureSchema: z.ZodEffects<z.ZodObject<{
         routeSwitches: number;
         startedAt: string;
         generationId?: string | undefined;
+        fundingTier?: "free" | "credit" | "paid" | undefined;
         timeToFirstTokenMs?: number | undefined;
     }>>;
 }, "strict", z.ZodTypeAny, {
@@ -1427,6 +1443,7 @@ export declare const decisionFailureSchema: z.ZodEffects<z.ZodObject<{
         routeSwitches: number;
         startedAt: string;
         generationId?: string | undefined;
+        fundingTier?: "free" | "credit" | "paid" | undefined;
         timeToFirstTokenMs?: number | undefined;
     } | undefined;
 }, {
@@ -1478,6 +1495,7 @@ export declare const decisionFailureSchema: z.ZodEffects<z.ZodObject<{
         routeSwitches: number;
         startedAt: string;
         generationId?: string | undefined;
+        fundingTier?: "free" | "credit" | "paid" | undefined;
         timeToFirstTokenMs?: number | undefined;
     } | undefined;
 }>, {
@@ -1529,6 +1547,7 @@ export declare const decisionFailureSchema: z.ZodEffects<z.ZodObject<{
         routeSwitches: number;
         startedAt: string;
         generationId?: string | undefined;
+        fundingTier?: "free" | "credit" | "paid" | undefined;
         timeToFirstTokenMs?: number | undefined;
     } | undefined;
 }, {
@@ -1580,6 +1599,7 @@ export declare const decisionFailureSchema: z.ZodEffects<z.ZodObject<{
         routeSwitches: number;
         startedAt: string;
         generationId?: string | undefined;
+        fundingTier?: "free" | "credit" | "paid" | undefined;
         timeToFirstTokenMs?: number | undefined;
     } | undefined;
 }>;

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

@@ -182,3 +182,17 @@ export type DelegatedUserId = z.infer<typeof delegatedUserIdSchema>;
 export type InferenceEnvironment = z.infer<typeof inferenceEnvironmentSchema>;
 export type ModelReference = z.infer<typeof modelReferenceSchema>;
 export type ModelId = z.infer<typeof modelIdSchema>;
+/**
+ * The economic tier of the provider capacity that funds a request, in the
+ * order Kaana spends it: `free` (costs nothing), `credit` (a promotional or
+ * trial grant, or a prepaid balance), `paid` (ordinary metered spend).
+ *
+ * Kaana owns provider keys, their economics and which key serves (Oxy ADR
+ * 0038, Kaana ADR 0001); Oxy owns what a customer may spend. The tier is the
+ * one economic fact the two exchange: Oxy BOUNDS a route by it
+ * (`maxFundingTier`), and Kaana REPORTS the tier that served
+ * (`normalizedUsageReportSchema.fundingTier`). No key id, label or price
+ * travels with it.
+ */
+export declare const inferenceFundingTierSchema: z.ZodEnum<["free", "credit", "paid"]>;
+export type InferenceFundingTier = z.infer<typeof inferenceFundingTierSchema>;