@deeprelay/sdk 0.4.1 → 0.4.3

package/dist/models/RefereeStatus.d.ts

@@ -17,21 +17,41 @@
  */
 export interface RefereeStatus {
     /**
-     * Lifecycle state. `pending` until the spend gate is met; `qualified` inside the hold; `settled` once paid.
+     * Lifecycle state. `pending` until the gate is met; `qualified` inside the hold; `settled` once paid; `reversed` when the qualifying deposit was refunded after payout and both rewards were taken back.
      * @type {RefereeStatusStatusEnum}
      * @memberof RefereeStatus
      */
     status: RefereeStatusStatusEnum;
     /**
-     * Cumulative inference spend so far.
+     * What qualifies this referral. `deposit` (net real deposits) for current referrals; `spend` (inference usage) for referrals made under the earlier program, which keep their original terms.
+     * @type {RefereeStatusGateEnum}
+     * @memberof RefereeStatus
+     */
+    gate?: RefereeStatusGateEnum;
+    /**
+     * Progress toward the gate so far — net deposits for `deposit`, inference spend for `spend`.
+     * @type {number}
+     * @memberof RefereeStatus
+     */
+    progressCents?: number;
+    /**
+     * The amount that qualifies the referral.
      * @type {number}
      * @memberof RefereeStatus
      */
+    goalCents?: number;
+    /**
+     * Deprecated alias of `progress_cents`.
+     * @type {number}
+     * @memberof RefereeStatus
+     * @deprecated
+     */
     spentCents: number;
     /**
-     * The spend that qualifies the referral.
+     * Deprecated alias of `goal_cents`.
      * @type {number}
      * @memberof RefereeStatus
+     * @deprecated
      */
     qualifySpendCents: number;
     /**
@@ -41,7 +61,7 @@ export interface RefereeStatus {
      */
     rewardCents: number;
     /**
-     * When the spend gate was met. Absent while pending.
+     * When the gate was met. Absent while pending.
      * @type {Date}
      * @memberof RefereeStatus
      */
@@ -67,8 +87,17 @@ export declare const RefereeStatusStatusEnum: {
     readonly Qualified: "qualified";
     readonly Settled: "settled";
     readonly Rejected: "rejected";
+    readonly Reversed: "reversed";
 };
 export type RefereeStatusStatusEnum = typeof RefereeStatusStatusEnum[keyof typeof RefereeStatusStatusEnum];
+/**
+ * @export
+ */
+export declare const RefereeStatusGateEnum: {
+    readonly Deposit: "deposit";
+    readonly Spend: "spend";
+};
+export type RefereeStatusGateEnum = typeof RefereeStatusGateEnum[keyof typeof RefereeStatusGateEnum];
 /**
  * Check if a given object implements the RefereeStatus interface.
  */

package/dist/models/RefereeStatus.js

@@ -13,7 +13,7 @@
  * Do not edit the class manually.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RefereeStatusStatusEnum = void 0;
+exports.RefereeStatusGateEnum = exports.RefereeStatusStatusEnum = void 0;
 exports.instanceOfRefereeStatus = instanceOfRefereeStatus;
 exports.RefereeStatusFromJSON = RefereeStatusFromJSON;
 exports.RefereeStatusFromJSONTyped = RefereeStatusFromJSONTyped;
@@ -26,7 +26,15 @@ exports.RefereeStatusStatusEnum = {
     Pending: 'pending',
     Qualified: 'qualified',
     Settled: 'settled',
-    Rejected: 'rejected'
+    Rejected: 'rejected',
+    Reversed: 'reversed'
+};
+/**
+ * @export
+ */
+exports.RefereeStatusGateEnum = {
+    Deposit: 'deposit',
+    Spend: 'spend'
 };
 /**
  * Check if a given object implements the RefereeStatus interface.
@@ -51,6 +59,9 @@ function RefereeStatusFromJSONTyped(json, ignoreDiscriminator) {
     }
     return {
         'status': json['status'],
+        'gate': json['gate'] == null ? undefined : json['gate'],
+        'progressCents': json['progress_cents'] == null ? undefined : json['progress_cents'],
+        'goalCents': json['goal_cents'] == null ? undefined : json['goal_cents'],
         'spentCents': json['spent_cents'],
         'qualifySpendCents': json['qualify_spend_cents'],
         'rewardCents': json['reward_cents'],
@@ -68,6 +79,9 @@ function RefereeStatusToJSONTyped(value, ignoreDiscriminator = false) {
     }
     return {
         'status': value['status'],
+        'gate': value['gate'],
+        'progress_cents': value['progressCents'],
+        'goal_cents': value['goalCents'],
         'spent_cents': value['spentCents'],
         'qualify_spend_cents': value['qualifySpendCents'],
         'reward_cents': value['rewardCents'],

package/dist/models/Referral.d.ts

@@ -30,13 +30,13 @@ export interface Referral {
      */
     inviteUrl: string;
     /**
-     * Friends who signed up through the link but have not yet reached the spend gate.
+     * Friends who signed up through the link but have not yet reached the qualifying deposit.
      * @type {number}
      * @memberof Referral
      */
     pending: number;
     /**
-     * Friends past the spend gate whose reward is inside the chargeback hold.
+     * Friends past the qualifying deposit whose reward is inside the chargeback hold.
      * @type {number}
      * @memberof Referral
      */
@@ -72,10 +72,17 @@ export interface Referral {
      */
     refereeRewardCents: number;
     /**
-     * The friend's cumulative inference spend that qualifies a referral.
+     * The friend's cumulative net real deposits (card, auto-pay and crypto, less refunds) that qualify a referral.
      * @type {number}
      * @memberof Referral
      */
+    qualifyDepositCents?: number;
+    /**
+     * Deprecated — referrals now qualify on deposits. Mirrors `qualify_deposit_cents`.
+     * @type {number}
+     * @memberof Referral
+     * @deprecated
+     */
     qualifySpendCents: number;
     /**
      * Days between qualification and payout (chargeback hold).

package/dist/models/Referral.js

@@ -66,6 +66,7 @@ function ReferralFromJSONTyped(json, ignoreDiscriminator) {
         'commissionEarnedCents': json['commission_earned_cents'],
         'rewardCents': json['reward_cents'],
         'refereeRewardCents': json['referee_reward_cents'],
+        'qualifyDepositCents': json['qualify_deposit_cents'] == null ? undefined : json['qualify_deposit_cents'],
         'qualifySpendCents': json['qualify_spend_cents'],
         'holdDays': json['hold_days'],
         'commissionPct': json['commission_pct'],
@@ -89,6 +90,7 @@ function ReferralToJSONTyped(value, ignoreDiscriminator = false) {
         'commission_earned_cents': value['commissionEarnedCents'],
         'reward_cents': value['rewardCents'],
         'referee_reward_cents': value['refereeRewardCents'],
+        'qualify_deposit_cents': value['qualifyDepositCents'],
         'qualify_spend_cents': value['qualifySpendCents'],
         'hold_days': value['holdDays'],
         'commission_pct': value['commissionPct'],

package/dist/models/RequestAttempt.d.ts

@@ -0,0 +1,71 @@
+/**
+ * deeprelay Public Developer API
+ * Programmatic API for deeprelay. Authenticate with API keys minted from the dashboard. See https://deeprelay.ai/docs for details.  Keys minted from the dashboard or `deeprelay login` belong to the Production server, https://api.deeprelay.ai/v1. The Demo server is an internal staging environment with its own key store.  Versioning: `/v1` is the API version. `info.version` is the revision of this `/v1` document, not a separate API.  OpenAI compatibility: chat completions follow the OpenAI request and response shapes, but not every OpenAI parameter is carried. Some are rejected with 400 `unsupported_parameter` and any parameter not declared in this spec is accepted and ignored. The full table is at https://deeprelay.ai/docs/api/inference#openai-compatibility.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: support@deeprelay.ai
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * One model in a request's backup-model trail.
+ * @export
+ * @interface RequestAttempt
+ */
+export interface RequestAttempt {
+    /**
+     *
+     * @type {string}
+     * @memberof RequestAttempt
+     */
+    model: string;
+    /**
+     * `ok`: this model served. `failed`: it was dialled and every provider failed before the first token. `skipped`: it was passed over without being dialled.
+     * @type {RequestAttemptOutcomeEnum}
+     * @memberof RequestAttempt
+     */
+    outcome: RequestAttemptOutcomeEnum;
+    /**
+     * Why the attempt failed (a public error code such as `upstream_timeout`) or was skipped: `model_not_allowed_for_key`, `subscription_quota_exhausted`, `api_key_budget_exceeded`, `member_spend_limit_reached`, `insufficient_balance`, `daily_limit_reached`, `spending_limit_reached`, `wallet_only` (not on the plan roster, for a plan-covered request), `unavailable`, `capability_mismatch`, `context_window_too_small`, `breaker_open` or `deadline_exhausted` (too little time was left to start another model).
+     * @type {string}
+     * @memberof RequestAttempt
+     */
+    reason?: string;
+    /**
+     * How long this model's attempt took, in milliseconds.
+     * @type {number}
+     * @memberof RequestAttempt
+     */
+    durationMs: number;
+    /**
+     * Time to first token, for the model that served a streamed call.
+     * @type {number}
+     * @memberof RequestAttempt
+     */
+    ttftMs?: number;
+    /**
+     * How many upstream attempts were made for this model. 0 for a skipped model.
+     * @type {number}
+     * @memberof RequestAttempt
+     */
+    tries: number;
+}
+/**
+ * @export
+ */
+export declare const RequestAttemptOutcomeEnum: {
+    readonly Ok: "ok";
+    readonly Failed: "failed";
+    readonly Skipped: "skipped";
+};
+export type RequestAttemptOutcomeEnum = typeof RequestAttemptOutcomeEnum[keyof typeof RequestAttemptOutcomeEnum];
+/**
+ * Check if a given object implements the RequestAttempt interface.
+ */
+export declare function instanceOfRequestAttempt(value: object): value is RequestAttempt;
+export declare function RequestAttemptFromJSON(json: any): RequestAttempt;
+export declare function RequestAttemptFromJSONTyped(json: any, ignoreDiscriminator: boolean): RequestAttempt;
+export declare function RequestAttemptToJSON(json: any): RequestAttempt;
+export declare function RequestAttemptToJSONTyped(value?: RequestAttempt | null, ignoreDiscriminator?: boolean): any;

package/dist/models/RequestAttempt.js

@@ -0,0 +1,75 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * deeprelay Public Developer API
+ * Programmatic API for deeprelay. Authenticate with API keys minted from the dashboard. See https://deeprelay.ai/docs for details.  Keys minted from the dashboard or `deeprelay login` belong to the Production server, https://api.deeprelay.ai/v1. The Demo server is an internal staging environment with its own key store.  Versioning: `/v1` is the API version. `info.version` is the revision of this `/v1` document, not a separate API.  OpenAI compatibility: chat completions follow the OpenAI request and response shapes, but not every OpenAI parameter is carried. Some are rejected with 400 `unsupported_parameter` and any parameter not declared in this spec is accepted and ignored. The full table is at https://deeprelay.ai/docs/api/inference#openai-compatibility.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: support@deeprelay.ai
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestAttemptOutcomeEnum = void 0;
+exports.instanceOfRequestAttempt = instanceOfRequestAttempt;
+exports.RequestAttemptFromJSON = RequestAttemptFromJSON;
+exports.RequestAttemptFromJSONTyped = RequestAttemptFromJSONTyped;
+exports.RequestAttemptToJSON = RequestAttemptToJSON;
+exports.RequestAttemptToJSONTyped = RequestAttemptToJSONTyped;
+/**
+ * @export
+ */
+exports.RequestAttemptOutcomeEnum = {
+    Ok: 'ok',
+    Failed: 'failed',
+    Skipped: 'skipped'
+};
+/**
+ * Check if a given object implements the RequestAttempt interface.
+ */
+function instanceOfRequestAttempt(value) {
+    if (!('model' in value) || value['model'] === undefined)
+        return false;
+    if (!('outcome' in value) || value['outcome'] === undefined)
+        return false;
+    if ((!('durationMs' in value) && !('duration_ms' in value)) || (value['durationMs'] === undefined && value['duration_ms'] === undefined))
+        return false;
+    if (!('tries' in value) || value['tries'] === undefined)
+        return false;
+    return true;
+}
+function RequestAttemptFromJSON(json) {
+    return RequestAttemptFromJSONTyped(json, false);
+}
+function RequestAttemptFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'model': json['model'],
+        'outcome': json['outcome'],
+        'reason': json['reason'] == null ? undefined : json['reason'],
+        'durationMs': json['duration_ms'],
+        'ttftMs': json['ttft_ms'] == null ? undefined : json['ttft_ms'],
+        'tries': json['tries'],
+    };
+}
+function RequestAttemptToJSON(json) {
+    return RequestAttemptToJSONTyped(json, false);
+}
+function RequestAttemptToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'model': value['model'],
+        'outcome': value['outcome'],
+        'reason': value['reason'],
+        'duration_ms': value['durationMs'],
+        'ttft_ms': value['ttftMs'],
+        'tries': value['tries'],
+    };
+}

package/dist/models/RequestLogEntry.d.ts

@@ -9,6 +9,7 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
+import type { RequestAttempt } from './RequestAttempt';
 /**
  * One inference call as the request log records it. Never carries prompt or completion content. Optional numeric fields are omitted when they do not apply (for example token counts on a rejected call).
  * @export
@@ -177,6 +178,30 @@ export interface RequestLogEntry {
      * @memberof RequestLogEntry
      */
     suppressedCount?: number;
+    /**
+     * The model the request asked for. Always present; equal to `model` unless a backup model was tried.
+     * @type {string}
+     * @memberof RequestLogEntry
+     */
+    requestedModel?: string;
+    /**
+     * The model that produced the response. Omitted when no model served (a failed or rejected call). When a backup served, `model` is this model and the row is billed at its price.
+     * @type {string}
+     * @memberof RequestLogEntry
+     */
+    servedModel?: string;
+    /**
+     * Set when backup models were tried: the requested model's public error code (for example `upstream_timeout`). Rows with it set are the ones `fallback=true` returns.
+     * @type {string}
+     * @memberof RequestLogEntry
+     */
+    fallbackReason?: string;
+    /**
+     * Present when backup models were tried: every model the request went through, in order, including skipped backups. Upstream providers are never named.
+     * @type {Array<RequestAttempt>}
+     * @memberof RequestLogEntry
+     */
+    attempts?: Array<RequestAttempt>;
 }
 /**
  * @export

package/dist/models/RequestLogEntry.js

@@ -19,6 +19,7 @@ exports.RequestLogEntryFromJSON = RequestLogEntryFromJSON;
 exports.RequestLogEntryFromJSONTyped = RequestLogEntryFromJSONTyped;
 exports.RequestLogEntryToJSON = RequestLogEntryToJSON;
 exports.RequestLogEntryToJSONTyped = RequestLogEntryToJSONTyped;
+const RequestAttempt_1 = require("./RequestAttempt");
 /**
  * @export
  */
@@ -96,6 +97,10 @@ function RequestLogEntryFromJSONTyped(json, ignoreDiscriminator) {
         'imageCount': json['image_count'] == null ? undefined : json['image_count'],
         'videoSeconds': json['video_seconds'] == null ? undefined : json['video_seconds'],
         'suppressedCount': json['suppressed_count'] == null ? undefined : json['suppressed_count'],
+        'requestedModel': json['requested_model'] == null ? undefined : json['requested_model'],
+        'servedModel': json['served_model'] == null ? undefined : json['served_model'],
+        'fallbackReason': json['fallback_reason'] == null ? undefined : json['fallback_reason'],
+        'attempts': json['attempts'] == null ? undefined : (json['attempts'].map(RequestAttempt_1.RequestAttemptFromJSON)),
     };
 }
 function RequestLogEntryToJSON(json) {
@@ -133,5 +138,9 @@ function RequestLogEntryToJSONTyped(value, ignoreDiscriminator = false) {
         'image_count': value['imageCount'],
         'video_seconds': value['videoSeconds'],
         'suppressed_count': value['suppressedCount'],
+        'requested_model': value['requestedModel'],
+        'served_model': value['servedModel'],
+        'fallback_reason': value['fallbackReason'],
+        'attempts': value['attempts'] == null ? undefined : (value['attempts'].map(RequestAttempt_1.RequestAttemptToJSON)),
     };
 }

package/dist/models/WebhookEndpoint.d.ts

@@ -66,6 +66,7 @@ export declare const WebhookEndpointEventTypesEnum: {
     readonly SubscriptionQuotaThreshold: "subscription_quota.threshold";
     readonly ApiKeyBudgetThreshold: "api_key_budget.threshold";
     readonly MemberSpendThreshold: "member_spend.threshold";
+    readonly PlanRosterModelRemoved: "plan_roster.model_removed";
 };
 export type WebhookEndpointEventTypesEnum = typeof WebhookEndpointEventTypesEnum[keyof typeof WebhookEndpointEventTypesEnum];
 /**

package/dist/models/WebhookEndpoint.js

@@ -32,7 +32,8 @@ exports.WebhookEndpointEventTypesEnum = {
     BalanceLow: 'balance.low',
     SubscriptionQuotaThreshold: 'subscription_quota.threshold',
     ApiKeyBudgetThreshold: 'api_key_budget.threshold',
-    MemberSpendThreshold: 'member_spend.threshold'
+    MemberSpendThreshold: 'member_spend.threshold',
+    PlanRosterModelRemoved: 'plan_roster.model_removed'
 };
 /**
  * Check if a given object implements the WebhookEndpoint interface.

package/dist/models/index.d.ts

@@ -4,6 +4,7 @@ export * from './AlertSettingsUpdate';
 export * from './ApiKey';
 export * from './ApiKeyCreate';
 export * from './ApiKeyCreated';
+export * from './ApiKeyFallbackEntry';
 export * from './ApiKeyList';
 export * from './ApiKeyScopes';
 export * from './ApiKeyUpdate';
@@ -43,6 +44,7 @@ export * from './PeakWindow';
 export * from './Problem';
 export * from './RefereeStatus';
 export * from './Referral';
+export * from './RequestAttempt';
 export * from './RequestLogEntry';
 export * from './RequestLogPage';
 export * from './ResponseFormatJSONObject';

package/dist/models/index.js

@@ -22,6 +22,7 @@ __exportStar(require("./AlertSettingsUpdate"), exports);
 __exportStar(require("./ApiKey"), exports);
 __exportStar(require("./ApiKeyCreate"), exports);
 __exportStar(require("./ApiKeyCreated"), exports);
+__exportStar(require("./ApiKeyFallbackEntry"), exports);
 __exportStar(require("./ApiKeyList"), exports);
 __exportStar(require("./ApiKeyScopes"), exports);
 __exportStar(require("./ApiKeyUpdate"), exports);
@@ -61,6 +62,7 @@ __exportStar(require("./PeakWindow"), exports);
 __exportStar(require("./Problem"), exports);
 __exportStar(require("./RefereeStatus"), exports);
 __exportStar(require("./Referral"), exports);
+__exportStar(require("./RequestAttempt"), exports);
 __exportStar(require("./RequestLogEntry"), exports);
 __exportStar(require("./RequestLogPage"), exports);
 __exportStar(require("./ResponseFormatJSONObject"), exports);

package/dist/runtime.js

@@ -69,7 +69,7 @@ class Configuration {
         return undefined;
     }
     get headers() {
-        return Object.assign({ 'User-Agent': 'deeprelay-sdk-ts/0.4.1' }, this.configuration.headers);
+        return Object.assign({ 'User-Agent': 'deeprelay-sdk-ts/0.4.3' }, this.configuration.headers);
     }
     get credentials() {
         return this.configuration.credentials;

package/docs/ApiKey.md

@@ -17,6 +17,9 @@ Name | Type
 `budgetResetsAt` | Date
 `allowedModels` | Array<string>
 `staleModels` | Array<string>
+`fallbackModels` | Array<string>
+`fallbackEntries` | [Array<ApiKeyFallbackEntry>](ApiKeyFallbackEntry.md)
+`primaryModel` | string
 `rateLimitRps` | number
 `rateLimitBurst` | number
 `expiresAt` | Date
@@ -41,6 +44,9 @@ const example = {
   "budgetResetsAt": null,
   "allowedModels": null,
   "staleModels": null,
+  "fallbackModels": null,
+  "fallbackEntries": null,
+  "primaryModel": null,
   "rateLimitRps": null,
   "rateLimitBurst": null,
   "expiresAt": null,

package/docs/ApiKeyCreate.md

@@ -10,6 +10,7 @@ Name | Type
 `scopes` | { [key: string]: any; }
 `budgetCents` | number
 `allowedModels` | Array<string>
+`fallbackModels` | Array<string>
 `rateLimitRps` | number
 `rateLimitBurst` | number
 `expiresAt` | Date
@@ -25,6 +26,7 @@ const example = {
   "scopes": null,
   "budgetCents": null,
   "allowedModels": null,
+  "fallbackModels": null,
   "rateLimitRps": null,
   "rateLimitBurst": null,
   "expiresAt": null,

package/docs/ApiKeyCreated.md

@@ -17,6 +17,9 @@ Name | Type
 `budgetResetsAt` | Date
 `allowedModels` | Array<string>
 `staleModels` | Array<string>
+`fallbackModels` | Array<string>
+`fallbackEntries` | [Array<ApiKeyFallbackEntry>](ApiKeyFallbackEntry.md)
+`primaryModel` | string
 `rateLimitRps` | number
 `rateLimitBurst` | number
 `expiresAt` | Date
@@ -42,6 +45,9 @@ const example = {
   "budgetResetsAt": null,
   "allowedModels": null,
   "staleModels": null,
+  "fallbackModels": null,
+  "fallbackEntries": null,
+  "primaryModel": null,
   "rateLimitRps": null,
   "rateLimitBurst": null,
   "expiresAt": null,

package/docs/ApiKeyFallbackEntry.md

@@ -0,0 +1,43 @@
+
+# ApiKeyFallbackEntry
+
+One backup model on a key, as it stands now.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`model` | string
+`state` | string
+`inputPer1mTokensMicrocents` | number
+`outputPer1mTokensMicrocents` | number
+`abovePrimary` | boolean
+
+## Example
+
+```typescript
+import type { ApiKeyFallbackEntry } from '@deeprelay/sdk'
+
+// TODO: Update the object below with actual values
+const example = {
+  "model": null,
+  "state": null,
+  "inputPer1mTokensMicrocents": null,
+  "outputPer1mTokensMicrocents": null,
+  "abovePrimary": null,
+} satisfies ApiKeyFallbackEntry
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as ApiKeyFallbackEntry
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/ApiKeyUpdate.md

@@ -1,7 +1,7 @@
 
 # ApiKeyUpdate
 
-Send only the fields to change. `null` clears `budget_cents`, `allowed_models` or `expires_at`. `scopes` cannot be changed.
+Send only the fields to change. `null` clears `budget_cents`, `allowed_models`, `fallback_models` or `expires_at`. `scopes` cannot be changed.
 
 ## Properties
 
@@ -10,6 +10,7 @@ Name | Type
 `name` | string
 `budgetCents` | number
 `allowedModels` | Array<string>
+`fallbackModels` | Array<string>
 `rateLimitRps` | number
 `rateLimitBurst` | number
 `expiresAt` | Date
@@ -24,6 +25,7 @@ const example = {
   "name": null,
   "budgetCents": null,
   "allowedModels": null,
+  "fallbackModels": null,
   "rateLimitRps": null,
   "rateLimitBurst": null,
   "expiresAt": null,

package/docs/ApiKeysApi.md

@@ -311,7 +311,7 @@ example().catch(console.error);
 
 Update an API key\'s name or limits
 
-Changes a key\'s name, budget, model allowlist, rate limit or expiry. An absent field is left unchanged; an explicit `null` clears `budget_cents`, `allowed_models` or `expires_at`. `scopes` cannot be changed after minting, and unknown fields are refused (422), so a typo never looks like a successful change. Requires the `keys:manage` capability (403 `keys_manage_required` otherwise); a member can only change keys they created. 
+Changes a key\'s name, budget, model allowlist, backup models, rate limit or expiry. An absent field is left unchanged; an explicit `null` clears `budget_cents`, `allowed_models`, `fallback_models` or `expires_at`. `scopes` cannot be changed after minting, and unknown fields are refused (422), so a typo never looks like a successful change. Requires the `keys:manage` capability (403 `keys_manage_required` otherwise); a member can only change keys they created. 
 
 ### Example
 

package/docs/BillingApi.md

@@ -460,7 +460,7 @@ example().catch(console.error);
 
 Get the org referral code, invite link, terms and stats
 
-Returns the organization\'s shareable referral code and invite link (minting the code on first read), the program terms, the referrer\'s stats, and — when this organization itself signed up through someone else\'s link — its own progress toward the referee reward. Requires the `billing:read` scope. The organization is taken from the authenticated API key, never from a parameter.  The program: share the invite link; when a friend signs up through it and spends `qualify_spend_cents` on inference, the referrer receives `reward_cents` and the friend receives `referee_reward_cents`, both as non-withdrawable credit, after a `hold_days` chargeback hold. The referrer also earns `commission_pct` percent of every real deposit the friend makes, credited as spend-only promotional credit when the deposit clears (`commission_earned_cents`). Program rewards never apply to the subscription. The terms ride on the wire so a client never hard-codes the amounts.  `referred` is ABSENT (not null) for an organization nobody referred — key on its presence. This is the same contract the dashboard\'s referral card reads. 
+Returns the organization\'s shareable referral code and invite link (minting the code on first read), the program terms, the referrer\'s stats, and — when this organization itself signed up through someone else\'s link — its own progress toward the referee reward. Requires the `billing:read` scope. The organization is taken from the authenticated API key, never from a parameter.  The program: share the invite link; once a friend who signed up through it has made `qualify_deposit_cents` of net real deposits (card, auto-pay or crypto, less refunds), the referrer receives `reward_cents` and the friend receives `referee_reward_cents`, both as non-withdrawable credit, after a `hold_days` chargeback hold. Both rewards are reversed if the qualifying deposit is later refunded. The deposit commission is retired and `commission_pct` is 0; when it is non-zero the referrer also earns that percent of every real deposit the friend makes. `commission_earned_cents` still reports commission earned before retirement. Program rewards never apply to the subscription. The terms ride on the wire so a client never hard-codes the amounts.  `referred` is ABSENT (not null) for an organization nobody referred — key on its presence. This is the same contract the dashboard\'s referral card reads. 
 
 ### Example
 

package/docs/ChatCompletionRequest.md

@@ -7,6 +7,7 @@
 Name | Type
 ------------ | -------------
 `model` | string
+`models` | Array<string>
 `messages` | [Array<ChatMessage>](ChatMessage.md)
 `temperature` | number
 `maxTokens` | number
@@ -32,6 +33,7 @@ import type { ChatCompletionRequest } from '@deeprelay/sdk'
 // TODO: Update the object below with actual values
 const example = {
   "model": null,
+  "models": null,
   "messages": null,
   "temperature": null,
   "maxTokens": null,