@deeprelay/sdk 0.1.0 → 0.1.2

package/dist/esm/apis/BillingApi.js

@@ -25,8 +25,13 @@ import { BalanceFromJSON, } from '../models/Balance';
 import { CreateCryptoDepositRequestToJSON, } from '../models/CreateCryptoDepositRequest';
 import { CryptoDepositFromJSON, } from '../models/CryptoDeposit';
 import { ListDeposits200ResponseFromJSON, } from '../models/ListDeposits200Response';
+import { ReferralFromJSON, } from '../models/Referral';
 import { SpendingLimitFromJSON, } from '../models/SpendingLimit';
 import { SubscriptionFromJSON, } from '../models/Subscription';
+import { SubscriptionCheckoutRequestToJSON, } from '../models/SubscriptionCheckoutRequest';
+import { SubscriptionCheckoutSessionFromJSON, } from '../models/SubscriptionCheckoutSession';
+import { SubscriptionPortalRequestToJSON, } from '../models/SubscriptionPortalRequest';
+import { SubscriptionPortalSessionFromJSON, } from '../models/SubscriptionPortalSession';
 import { UpdateSpendingLimitRequestToJSON, } from '../models/UpdateSpendingLimitRequest';
 /**
  *
@@ -81,6 +86,98 @@ export class BillingApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for createSubscriptionCheckout without sending the request
+     */
+    createSubscriptionCheckoutRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            let urlPath = `/billing/subscription/checkout`;
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: SubscriptionCheckoutRequestToJSON(requestParameters['subscriptionCheckoutRequest']),
+            };
+        });
+    }
+    /**
+     * Opens a hosted checkout session for the flat tier and returns its URL. Requires the `billing:write` scope AND organization-admin privileges — subscribing spends organization money.  This endpoint does NOT subscribe anyone. Checkout is a hosted page that needs a browser and a card, so the caller\'s job is to put the returned URL in front of a human. The subscription becomes active when payment completes, which is not synchronous with this call: poll `/billing/subscription` to confirm.  `success_url` and `cancel_url` are optional and fall back to the deployment\'s configured redirects, which is what lets a command-line client start a purchase without having any URLs of its own. An empty request body is valid and means \"use every default\".  `plan_key`, when sent, pins the plan the client DISPLAYED: an unknown key is a 400 rather than a silent purchase of a different tier. Today there is one tier, so the only accepted value is its key — but sending it is the forward-compatible choice.  One flat tier means at most one subscription per organization: a second checkout while an entitling subscription exists is a 409.
+     * Start a subscription checkout session
+     */
+    createSubscriptionCheckoutRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.createSubscriptionCheckoutRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => SubscriptionCheckoutSessionFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Opens a hosted checkout session for the flat tier and returns its URL. Requires the `billing:write` scope AND organization-admin privileges — subscribing spends organization money.  This endpoint does NOT subscribe anyone. Checkout is a hosted page that needs a browser and a card, so the caller\'s job is to put the returned URL in front of a human. The subscription becomes active when payment completes, which is not synchronous with this call: poll `/billing/subscription` to confirm.  `success_url` and `cancel_url` are optional and fall back to the deployment\'s configured redirects, which is what lets a command-line client start a purchase without having any URLs of its own. An empty request body is valid and means \"use every default\".  `plan_key`, when sent, pins the plan the client DISPLAYED: an unknown key is a 400 rather than a silent purchase of a different tier. Today there is one tier, so the only accepted value is its key — but sending it is the forward-compatible choice.  One flat tier means at most one subscription per organization: a second checkout while an entitling subscription exists is a 409.
+     * Start a subscription checkout session
+     */
+    createSubscriptionCheckout() {
+        return __awaiter(this, arguments, void 0, function* (requestParameters = {}, initOverrides) {
+            const response = yield this.createSubscriptionCheckoutRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Creates request options for createSubscriptionPortal without sending the request
+     */
+    createSubscriptionPortalRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            let urlPath = `/billing/subscription/portal`;
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: SubscriptionPortalRequestToJSON(requestParameters['subscriptionPortalRequest']),
+            };
+        });
+    }
+    /**
+     * Returns a URL for the hosted billing portal: where a customer cancels the subscription, resumes one they cancelled, changes payment method, or downloads invoices. Requires the `billing:write` scope AND organization-admin privileges.  Cancellation lives here rather than on its own endpoint because it is one surface with the rest of the billing lifecycle. The common reason a subscription is about to lapse is a declined card, and the fix for that is a new card, not a cancellation — sending a customer somewhere that can only cancel would lose renewals.  Cancelling in the portal ends the subscription at the close of the current period; coverage continues until then and `/billing/subscription` reports `cancel_at_period_end: true`.  An organization that has never paid for anything gets 404: there is no billing account to manage, and this endpoint deliberately does not create one as a side effect of looking.
+     * Open the billing portal to cancel or manage the subscription
+     */
+    createSubscriptionPortalRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.createSubscriptionPortalRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => SubscriptionPortalSessionFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Returns a URL for the hosted billing portal: where a customer cancels the subscription, resumes one they cancelled, changes payment method, or downloads invoices. Requires the `billing:write` scope AND organization-admin privileges.  Cancellation lives here rather than on its own endpoint because it is one surface with the rest of the billing lifecycle. The common reason a subscription is about to lapse is a declined card, and the fix for that is a new card, not a cancellation — sending a customer somewhere that can only cancel would lose renewals.  Cancelling in the portal ends the subscription at the close of the current period; coverage continues until then and `/billing/subscription` reports `cancel_at_period_end: true`.  An organization that has never paid for anything gets 404: there is no billing account to manage, and this endpoint deliberately does not create one as a side effect of looking.
+     * Open the billing portal to cancel or manage the subscription
+     */
+    createSubscriptionPortal() {
+        return __awaiter(this, arguments, void 0, function* (requestParameters = {}, initOverrides) {
+            const response = yield this.createSubscriptionPortalRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for getBalance without sending the request
      */
@@ -173,6 +270,50 @@ export class BillingApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for getReferral without sending the request
+     */
+    getReferralRequestOpts() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const queryParameters = {};
+            const headerParameters = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            let urlPath = `/referrals`;
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * 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 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.
+     * Get the org referral code, invite link, terms and stats
+     */
+    getReferralRaw(initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.getReferralRequestOpts();
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => ReferralFromJSON(jsonValue));
+        });
+    }
+    /**
+     * 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 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.
+     * Get the org referral code, invite link, terms and stats
+     */
+    getReferral(initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getReferralRaw(initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for getSpendingLimit without sending the request
      */

package/dist/esm/apis/InferenceApi.d.ts

@@ -16,6 +16,7 @@ import { type EmbeddingsRequest } from '../models/EmbeddingsRequest';
 import { type EmbeddingsResponse } from '../models/EmbeddingsResponse';
 import { type ImagesGenerationsRequest } from '../models/ImagesGenerationsRequest';
 import { type ImagesResponse } from '../models/ImagesResponse';
+import { type InferencePreflight } from '../models/InferencePreflight';
 import { type Model } from '../models/Model';
 import { type ModelList } from '../models/ModelList';
 import { type VideoCreateRequest } from '../models/VideoCreateRequest';
@@ -47,6 +48,9 @@ export interface GetVideoRequest {
 export interface GetVideoContentRequest {
     id: string;
 }
+export interface InferencePreflightRequest {
+    model: string;
+}
 export interface ListModelsRequest {
     modality?: ListModelsModalityEnum;
 }
@@ -162,6 +166,20 @@ export declare class InferenceApi extends runtime.BaseAPI {
      * Download a completed video artifact
      */
     getVideoContent(requestParameters: GetVideoContentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Blob>;
+    /**
+     * Creates request options for inferencePreflight without sending the request
+     */
+    inferencePreflightRequestOpts(requestParameters: InferencePreflightRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Answers \"what happens if I call this model right now?\" before the call is made: whether the plan covers the model, whether the organization is subscribed, and whether there is credit to pay if it is not covered. Requires the `serverless:read` scope.  Nothing is sent, counted, charged, or reserved. The verdict is computed from the state of the SAME gates that judge the real request — plan coverage, subscription entitlement, remaining plan quota, credit balance and self-set spending caps — so the advice cannot drift from enforcement. It is deliberately NOT a dry run: no per-request cost estimate is quoted, because that figure changes with every prompt and quoting it would invite clients to cache it.  The gates consulted depend on the model\'s MODALITY, because the endpoints do not all meet the same ones. Chat, embeddings and image requests meet the full gate (balance, then the organization\'s opt-in daily cap, then its monthly cap). Video creation meets only the balance check, so an organization past its own spending cap but holding credit is reported as fundable for video — which is what the video endpoint will in fact do. Predicting the strictest gate rather than the applicable one would make this endpoint refuse requests the API accepts.  The same is true of the plan: video creation does not run the subscription gate, so `plan_covered` is false for a video model even if an operator has placed it on the plan\'s covered list. That is a deliberate divergence from the same-named field on `/v1/models`, which reports the platform\'s configuration. Here it means \"the plan covers this REQUEST\" — describing what will happen is the entire job of a preflight.  One caveat on \"read-only\": resolving the balance creates the organization\'s balance row if it has never had one (idempotent, org-scoped, and the same row the first real request would create). Nothing else is written.  The case this exists for is `warn` / `not_plan_covered`. A subscriber calling a model outside the plan IS served and IS charged pay-as-you-go, and nothing in the response to that request says so — the first signal used to be the invoice.  `funded` is a boolean and never a figure. This route is on the inference read scope, so it must not disclose the organization\'s balance; use `/billing/balance` for the number.  Failure posture is the opposite of the request gate\'s: any gate that cannot be read degrades the verdict toward `ok`, never toward `block`. A false `block` would stop a customer whose request would have succeeded, while a false `ok` costs them one honest error from the real call.
+     * Check whether a model request would be served, and at whose expense
+     */
+    inferencePreflightRaw(requestParameters: InferencePreflightRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<InferencePreflight>>;
+    /**
+     * Answers \"what happens if I call this model right now?\" before the call is made: whether the plan covers the model, whether the organization is subscribed, and whether there is credit to pay if it is not covered. Requires the `serverless:read` scope.  Nothing is sent, counted, charged, or reserved. The verdict is computed from the state of the SAME gates that judge the real request — plan coverage, subscription entitlement, remaining plan quota, credit balance and self-set spending caps — so the advice cannot drift from enforcement. It is deliberately NOT a dry run: no per-request cost estimate is quoted, because that figure changes with every prompt and quoting it would invite clients to cache it.  The gates consulted depend on the model\'s MODALITY, because the endpoints do not all meet the same ones. Chat, embeddings and image requests meet the full gate (balance, then the organization\'s opt-in daily cap, then its monthly cap). Video creation meets only the balance check, so an organization past its own spending cap but holding credit is reported as fundable for video — which is what the video endpoint will in fact do. Predicting the strictest gate rather than the applicable one would make this endpoint refuse requests the API accepts.  The same is true of the plan: video creation does not run the subscription gate, so `plan_covered` is false for a video model even if an operator has placed it on the plan\'s covered list. That is a deliberate divergence from the same-named field on `/v1/models`, which reports the platform\'s configuration. Here it means \"the plan covers this REQUEST\" — describing what will happen is the entire job of a preflight.  One caveat on \"read-only\": resolving the balance creates the organization\'s balance row if it has never had one (idempotent, org-scoped, and the same row the first real request would create). Nothing else is written.  The case this exists for is `warn` / `not_plan_covered`. A subscriber calling a model outside the plan IS served and IS charged pay-as-you-go, and nothing in the response to that request says so — the first signal used to be the invoice.  `funded` is a boolean and never a figure. This route is on the inference read scope, so it must not disclose the organization\'s balance; use `/billing/balance` for the number.  Failure posture is the opposite of the request gate\'s: any gate that cannot be read degrades the verdict toward `ok`, never toward `block`. A false `block` would stop a customer whose request would have succeeded, while a false `ok` costs them one honest error from the real call.
+     * Check whether a model request would be served, and at whose expense
+     */
+    inferencePreflight(requestParameters: InferencePreflightRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<InferencePreflight>;
     /**
      * Creates request options for listModels without sending the request
      */

package/dist/esm/apis/InferenceApi.js

@@ -27,6 +27,7 @@ import { EmbeddingsRequestToJSON, } from '../models/EmbeddingsRequest';
 import { EmbeddingsResponseFromJSON, } from '../models/EmbeddingsResponse';
 import { ImagesGenerationsRequestToJSON, } from '../models/ImagesGenerationsRequest';
 import { ImagesResponseFromJSON, } from '../models/ImagesResponse';
+import { InferencePreflightFromJSON, } from '../models/InferencePreflight';
 import { ModelFromJSON, } from '../models/Model';
 import { ModelListFromJSON, } from '../models/ModelList';
 import { VideoCreateRequestToJSON, } from '../models/VideoCreateRequest';
@@ -422,6 +423,56 @@ export class InferenceApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for inferencePreflight without sending the request
+     */
+    inferencePreflightRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['model'] == null) {
+                throw new runtime.RequiredError('model', 'Required parameter "model" was null or undefined when calling inferencePreflight().');
+            }
+            const queryParameters = {};
+            if (requestParameters['model'] != null) {
+                queryParameters['model'] = requestParameters['model'];
+            }
+            const headerParameters = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            let urlPath = `/inference/preflight`;
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Answers \"what happens if I call this model right now?\" before the call is made: whether the plan covers the model, whether the organization is subscribed, and whether there is credit to pay if it is not covered. Requires the `serverless:read` scope.  Nothing is sent, counted, charged, or reserved. The verdict is computed from the state of the SAME gates that judge the real request — plan coverage, subscription entitlement, remaining plan quota, credit balance and self-set spending caps — so the advice cannot drift from enforcement. It is deliberately NOT a dry run: no per-request cost estimate is quoted, because that figure changes with every prompt and quoting it would invite clients to cache it.  The gates consulted depend on the model\'s MODALITY, because the endpoints do not all meet the same ones. Chat, embeddings and image requests meet the full gate (balance, then the organization\'s opt-in daily cap, then its monthly cap). Video creation meets only the balance check, so an organization past its own spending cap but holding credit is reported as fundable for video — which is what the video endpoint will in fact do. Predicting the strictest gate rather than the applicable one would make this endpoint refuse requests the API accepts.  The same is true of the plan: video creation does not run the subscription gate, so `plan_covered` is false for a video model even if an operator has placed it on the plan\'s covered list. That is a deliberate divergence from the same-named field on `/v1/models`, which reports the platform\'s configuration. Here it means \"the plan covers this REQUEST\" — describing what will happen is the entire job of a preflight.  One caveat on \"read-only\": resolving the balance creates the organization\'s balance row if it has never had one (idempotent, org-scoped, and the same row the first real request would create). Nothing else is written.  The case this exists for is `warn` / `not_plan_covered`. A subscriber calling a model outside the plan IS served and IS charged pay-as-you-go, and nothing in the response to that request says so — the first signal used to be the invoice.  `funded` is a boolean and never a figure. This route is on the inference read scope, so it must not disclose the organization\'s balance; use `/billing/balance` for the number.  Failure posture is the opposite of the request gate\'s: any gate that cannot be read degrades the verdict toward `ok`, never toward `block`. A false `block` would stop a customer whose request would have succeeded, while a false `ok` costs them one honest error from the real call.
+     * Check whether a model request would be served, and at whose expense
+     */
+    inferencePreflightRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.inferencePreflightRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => InferencePreflightFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Answers \"what happens if I call this model right now?\" before the call is made: whether the plan covers the model, whether the organization is subscribed, and whether there is credit to pay if it is not covered. Requires the `serverless:read` scope.  Nothing is sent, counted, charged, or reserved. The verdict is computed from the state of the SAME gates that judge the real request — plan coverage, subscription entitlement, remaining plan quota, credit balance and self-set spending caps — so the advice cannot drift from enforcement. It is deliberately NOT a dry run: no per-request cost estimate is quoted, because that figure changes with every prompt and quoting it would invite clients to cache it.  The gates consulted depend on the model\'s MODALITY, because the endpoints do not all meet the same ones. Chat, embeddings and image requests meet the full gate (balance, then the organization\'s opt-in daily cap, then its monthly cap). Video creation meets only the balance check, so an organization past its own spending cap but holding credit is reported as fundable for video — which is what the video endpoint will in fact do. Predicting the strictest gate rather than the applicable one would make this endpoint refuse requests the API accepts.  The same is true of the plan: video creation does not run the subscription gate, so `plan_covered` is false for a video model even if an operator has placed it on the plan\'s covered list. That is a deliberate divergence from the same-named field on `/v1/models`, which reports the platform\'s configuration. Here it means \"the plan covers this REQUEST\" — describing what will happen is the entire job of a preflight.  One caveat on \"read-only\": resolving the balance creates the organization\'s balance row if it has never had one (idempotent, org-scoped, and the same row the first real request would create). Nothing else is written.  The case this exists for is `warn` / `not_plan_covered`. A subscriber calling a model outside the plan IS served and IS charged pay-as-you-go, and nothing in the response to that request says so — the first signal used to be the invoice.  `funded` is a boolean and never a figure. This route is on the inference read scope, so it must not disclose the organization\'s balance; use `/billing/balance` for the number.  Failure posture is the opposite of the request gate\'s: any gate that cannot be read degrades the verdict toward `ok`, never toward `block`. A false `block` would stop a customer whose request would have succeeded, while a false `ok` costs them one honest error from the real call.
+     * Check whether a model request would be served, and at whose expense
+     */
+    inferencePreflight(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.inferencePreflightRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for listModels without sending the request
      */

package/dist/esm/models/InferencePreflight.d.ts

@@ -0,0 +1,92 @@
+/**
+ * deeprelay Public Developer API
+ * Programmatic API for deeprelay. Authenticate with API keys minted from the dashboard. See https://deeprelay.ai/docs for details.
+ *
+ * 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.
+ */
+/**
+ * The verdict for one (organization, model) pair: what would happen if the model were invoked right now.
+ *
+ * @export
+ * @interface InferencePreflight
+ */
+export interface InferencePreflight {
+    /**
+     * The canonical catalog id the request resolved to.
+     * @type {string}
+     * @memberof InferencePreflight
+     */
+    model: string;
+    /**
+     * `ok` — the request will be served (covered by the plan, or payable). `warn` — it will be served AND charged in a way the caller may not expect. `block` — it will be refused (402 or 429).
+     * @type {InferencePreflightVerdictEnum}
+     * @memberof InferencePreflight
+     */
+    verdict: InferencePreflightVerdictEnum;
+    /**
+     * Stable code explaining the verdict, for clients that need their own wording. Absent on a plain `ok` that needs no explanation.
+     * @type {InferencePreflightReasonEnum}
+     * @memberof InferencePreflight
+     */
+    reason?: InferencePreflightReasonEnum;
+    /**
+     * A ready-to-print sentence, phrased for this exact plan/credit combination. Prefer it over composing one from verdict and reason: it improves without a client release.
+     * @type {string}
+     * @memberof InferencePreflight
+     */
+    message: string;
+    /**
+     * Whether the subscription tier covers this model. A property of the PLATFORM, not of the caller — it stays true for an organization that has no subscription, which is what makes the "this is included in the plan" upsell honest.
+     * @type {boolean}
+     * @memberof InferencePreflight
+     */
+    planCovered: boolean;
+    /**
+     * Whether the organization is entitled to the plan right now.
+     * @type {boolean}
+     * @memberof InferencePreflight
+     */
+    subscribed: boolean;
+    /**
+     * Whether a pay-as-you-go request could be paid for right now: a positive credit balance AND no self-set spending cap already at its limit. A boolean and never a figure — this route is on the inference read scope and must not disclose the balance.
+     * @type {boolean}
+     * @memberof InferencePreflight
+     */
+    funded: boolean;
+}
+/**
+ * @export
+ */
+export declare const InferencePreflightVerdictEnum: {
+    readonly Ok: "ok";
+    readonly Warn: "warn";
+    readonly Block: "block";
+};
+export type InferencePreflightVerdictEnum = typeof InferencePreflightVerdictEnum[keyof typeof InferencePreflightVerdictEnum];
+/**
+ * @export
+ */
+export declare const InferencePreflightReasonEnum: {
+    readonly PlanCovered: "plan_covered";
+    readonly Payg: "payg";
+    readonly NotPlanCovered: "not_plan_covered";
+    readonly SubscriptionQuotaExhausted: "subscription_quota_exhausted";
+    readonly InsufficientBalance: "insufficient_balance";
+    readonly DailyLimitReached: "daily_limit_reached";
+    readonly MonthlyLimitReached: "monthly_limit_reached";
+    readonly PreflightUnavailable: "preflight_unavailable";
+};
+export type InferencePreflightReasonEnum = typeof InferencePreflightReasonEnum[keyof typeof InferencePreflightReasonEnum];
+/**
+ * Check if a given object implements the InferencePreflight interface.
+ */
+export declare function instanceOfInferencePreflight(value: object): value is InferencePreflight;
+export declare function InferencePreflightFromJSON(json: any): InferencePreflight;
+export declare function InferencePreflightFromJSONTyped(json: any, ignoreDiscriminator: boolean): InferencePreflight;
+export declare function InferencePreflightToJSON(json: any): InferencePreflight;
+export declare function InferencePreflightToJSONTyped(value?: InferencePreflight | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/InferencePreflight.js

@@ -0,0 +1,86 @@
+/* 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.
+ *
+ * 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.
+ */
+/**
+ * @export
+ */
+export const InferencePreflightVerdictEnum = {
+    Ok: 'ok',
+    Warn: 'warn',
+    Block: 'block'
+};
+/**
+ * @export
+ */
+export const InferencePreflightReasonEnum = {
+    PlanCovered: 'plan_covered',
+    Payg: 'payg',
+    NotPlanCovered: 'not_plan_covered',
+    SubscriptionQuotaExhausted: 'subscription_quota_exhausted',
+    InsufficientBalance: 'insufficient_balance',
+    DailyLimitReached: 'daily_limit_reached',
+    MonthlyLimitReached: 'monthly_limit_reached',
+    PreflightUnavailable: 'preflight_unavailable'
+};
+/**
+ * Check if a given object implements the InferencePreflight interface.
+ */
+export function instanceOfInferencePreflight(value) {
+    if (!('model' in value) || value['model'] === undefined)
+        return false;
+    if (!('verdict' in value) || value['verdict'] === undefined)
+        return false;
+    if (!('message' in value) || value['message'] === undefined)
+        return false;
+    if ((!('planCovered' in value) && !('plan_covered' in value)) || (value['planCovered'] === undefined && value['plan_covered'] === undefined))
+        return false;
+    if (!('subscribed' in value) || value['subscribed'] === undefined)
+        return false;
+    if (!('funded' in value) || value['funded'] === undefined)
+        return false;
+    return true;
+}
+export function InferencePreflightFromJSON(json) {
+    return InferencePreflightFromJSONTyped(json, false);
+}
+export function InferencePreflightFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'model': json['model'],
+        'verdict': json['verdict'],
+        'reason': json['reason'] == null ? undefined : json['reason'],
+        'message': json['message'],
+        'planCovered': json['plan_covered'],
+        'subscribed': json['subscribed'],
+        'funded': json['funded'],
+    };
+}
+export function InferencePreflightToJSON(json) {
+    return InferencePreflightToJSONTyped(json, false);
+}
+export function InferencePreflightToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'model': value['model'],
+        'verdict': value['verdict'],
+        'reason': value['reason'],
+        'message': value['message'],
+        'plan_covered': value['planCovered'],
+        'subscribed': value['subscribed'],
+        'funded': value['funded'],
+    };
+}

package/dist/esm/models/RefereeStatus.d.ts

@@ -0,0 +1,79 @@
+/**
+ * deeprelay Public Developer API
+ * Programmatic API for deeprelay. Authenticate with API keys minted from the dashboard. See https://deeprelay.ai/docs for details.
+ *
+ * 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.
+ */
+/**
+ * Present only when the organization signed up through someone else's invite link: where that referral sits and how far the organization is from unlocking its own reward.
+ *
+ * @export
+ * @interface RefereeStatus
+ */
+export interface RefereeStatus {
+    /**
+     * Lifecycle state. `pending` until the spend gate is met; `qualified` inside the hold; `settled` once paid.
+     * @type {RefereeStatusStatusEnum}
+     * @memberof RefereeStatus
+     */
+    status: RefereeStatusStatusEnum;
+    /**
+     * Cumulative inference spend so far.
+     * @type {number}
+     * @memberof RefereeStatus
+     */
+    spentCents: number;
+    /**
+     * The spend that qualifies the referral.
+     * @type {number}
+     * @memberof RefereeStatus
+     */
+    qualifySpendCents: number;
+    /**
+     * What this organization receives on settlement.
+     * @type {number}
+     * @memberof RefereeStatus
+     */
+    rewardCents: number;
+    /**
+     * When the spend gate was met. Absent while pending.
+     * @type {Date}
+     * @memberof RefereeStatus
+     */
+    qualifiedAt?: Date;
+    /**
+     * When the hold ends and both halves pay out. Absent while pending.
+     * @type {Date}
+     * @memberof RefereeStatus
+     */
+    holdUntil?: Date;
+    /**
+     * When the reward was paid. Absent until settled.
+     * @type {Date}
+     * @memberof RefereeStatus
+     */
+    settledAt?: Date;
+}
+/**
+ * @export
+ */
+export declare const RefereeStatusStatusEnum: {
+    readonly Pending: "pending";
+    readonly Qualified: "qualified";
+    readonly Settled: "settled";
+    readonly Rejected: "rejected";
+};
+export type RefereeStatusStatusEnum = typeof RefereeStatusStatusEnum[keyof typeof RefereeStatusStatusEnum];
+/**
+ * Check if a given object implements the RefereeStatus interface.
+ */
+export declare function instanceOfRefereeStatus(value: object): value is RefereeStatus;
+export declare function RefereeStatusFromJSON(json: any): RefereeStatus;
+export declare function RefereeStatusFromJSONTyped(json: any, ignoreDiscriminator: boolean): RefereeStatus;
+export declare function RefereeStatusToJSON(json: any): RefereeStatus;
+export declare function RefereeStatusToJSONTyped(value?: RefereeStatus | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/RefereeStatus.js

@@ -0,0 +1,70 @@
+/* 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.
+ *
+ * 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.
+ */
+/**
+ * @export
+ */
+export const RefereeStatusStatusEnum = {
+    Pending: 'pending',
+    Qualified: 'qualified',
+    Settled: 'settled',
+    Rejected: 'rejected'
+};
+/**
+ * Check if a given object implements the RefereeStatus interface.
+ */
+export function instanceOfRefereeStatus(value) {
+    if (!('status' in value) || value['status'] === undefined)
+        return false;
+    if ((!('spentCents' in value) && !('spent_cents' in value)) || (value['spentCents'] === undefined && value['spent_cents'] === undefined))
+        return false;
+    if ((!('qualifySpendCents' in value) && !('qualify_spend_cents' in value)) || (value['qualifySpendCents'] === undefined && value['qualify_spend_cents'] === undefined))
+        return false;
+    if ((!('rewardCents' in value) && !('reward_cents' in value)) || (value['rewardCents'] === undefined && value['reward_cents'] === undefined))
+        return false;
+    return true;
+}
+export function RefereeStatusFromJSON(json) {
+    return RefereeStatusFromJSONTyped(json, false);
+}
+export function RefereeStatusFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'status': json['status'],
+        'spentCents': json['spent_cents'],
+        'qualifySpendCents': json['qualify_spend_cents'],
+        'rewardCents': json['reward_cents'],
+        'qualifiedAt': json['qualified_at'] == null ? undefined : (new Date(json['qualified_at'])),
+        'holdUntil': json['hold_until'] == null ? undefined : (new Date(json['hold_until'])),
+        'settledAt': json['settled_at'] == null ? undefined : (new Date(json['settled_at'])),
+    };
+}
+export function RefereeStatusToJSON(json) {
+    return RefereeStatusToJSONTyped(json, false);
+}
+export function RefereeStatusToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'status': value['status'],
+        'spent_cents': value['spentCents'],
+        'qualify_spend_cents': value['qualifySpendCents'],
+        'reward_cents': value['rewardCents'],
+        'qualified_at': value['qualifiedAt'] == null ? value['qualifiedAt'] : value['qualifiedAt'].toISOString(),
+        'hold_until': value['holdUntil'] == null ? value['holdUntil'] : value['holdUntil'].toISOString(),
+        'settled_at': value['settledAt'] == null ? value['settledAt'] : value['settledAt'].toISOString(),
+    };
+}