@leaflow/sdk 0.0.0-dev.358.gbb34078 → 0.0.0-dev.361.gefdc428

package/dist/canopy/v1/generated/functions.d.ts

@@ -4,9 +4,17 @@
  * Leaflow Canopy API
  * Canopy model inference, API keys, model catalogue, service enablement and recorded usage.
  *
- * OpenAI-compatible project inference is served on this host at `/v1/chat/completions`,
- * `/v1/embeddings`, `/v1/models` and `/v1/models/{model}`. Use `https://canopy.leaflow.cloud/v1`
- * as the OpenAI SDK base URL. Chat completions support `stream=true` SSE.
+ * Project inference is served on this host in each provider's own protocol:
+ *
+ * - OpenAI: `/v1/chat/completions`, `/v1/responses` and `/v1/embeddings`; use
+ *   `https://canopy.leaflow.cloud/v1` as the OpenAI SDK base URL.
+ * - Anthropic: `/v1/messages`; use `https://canopy.leaflow.cloud` as the Anthropic SDK base URL.
+ * - Gemini: `/v1beta/models/{model}:generateContent` and `:streamGenerateContent`.
+ *
+ * Canopy does not convert between protocols. A request is accepted only for a model whose
+ * `supported_endpoints` lists the endpoint it was sent to, and it is forwarded unchanged except for
+ * the model name and the credentials. Reasoning settings such as `reasoning_effort` are passed
+ * through as written; a model's `capabilities` lists the values its upstream accepts.
  *
  * Management operations use `/api/v1`. The management model catalogue includes pricing;
  * `/v1/models` returns the OpenAI model format with Canopy capabilities and parameter limits.
@@ -18,7 +26,7 @@
  * Management and project inference accept the same verified IAM scoped token. The token is the
  * sole billing project authority; `OpenAI-Project` and historical identity headers cannot
  * override it. These endpoints do not accept a Canopy API key. The separate API-key gateway
- * accepts Canopy API keys and supports OpenAI, Anthropic and Gemini request formats.
+ * accepts Canopy API keys and serves the same endpoints.
  *
  * ## Conventions
  *
@@ -30,7 +38,7 @@
  * - **The service is enabled before use.** A project enables the model platform once, through `create-service`; the forwarding endpoints refuse its requests until the service is `active`. Requests are then billed under the service's subscription by the tokens they use, at the rates stated in each model's `pricing`.
  * OpenAPI spec version: 1.0.0
  */
-import type { APIKeyResource, APIKeyUsageListResponseBody, ChatCompletion, ChatCompletionRequest, ConflictResponse, CreateAPIKeyRequestBody, CreateServiceRequestBody, CreateServiceResponseBody, CursorPageRequestResource, EmbeddingRequest, EmbeddingResponse, Error, GetUsageSummaryParams, GetUsageTimelineParams, InferenceError, IssuedAPIKeyResource, LengthAwarePageAPIKeyResource, ListApiKeysParams, ListRequestsParams, ListUsageByApiKeyParams, ListUsageByModelParams, Model, ModelList, ModelListResponseBody, ModelResource, ModelUsageListResponseBody, Quote, RequestResource, ResponseCreate, ResponseDeleted, ResponseResource, ServiceResource, TotalsResource, UpdateAPIKeyRequestBody, UsageTimelineResponseBody } from "./models.js";
+import type { APIKeyResource, APIKeyUsageListResponseBody, ChatCompletion, ChatCompletionRequest, ConflictResponse, CreateAPIKeyRequestBody, CreateServiceRequestBody, CreateServiceResponseBody, CursorPageRequestResource, EmbeddingRequest, EmbeddingResponse, Error, GetUsageSummaryParams, GetUsageTimelineParams, InferenceError, IssuedAPIKeyResource, LengthAwarePageAPIKeyResource, ListApiKeysParams, ListRequestsParams, ListUsageByApiKeyParams, ListUsageByModelParams, Model, ModelList, ModelListResponseBody, ModelResource, ModelUsageListResponseBody, NativeRequest, NativeResponse, Quote, RequestResource, ResponseCreate, ResponseDeleted, ResponseResource, ServiceResource, StreamGenerateContentParams, TotalsResource, UpdateAPIKeyRequestBody, UsageTimelineResponseBody } from "./models.js";
 export type HTTPStatusCode1xx = 100 | 101 | 102 | 103;
 export type HTTPStatusCode2xx = 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207;
 export type HTTPStatusCode3xx = 300 | 301 | 302 | 303 | 304 | 305 | 307 | 308;
@@ -123,7 +131,7 @@ export type createChatCompletionResponseError = createChatCompletionResponseDefa
 export type createChatCompletionResponse = createChatCompletionResponseSuccess | createChatCompletionResponseError;
 export declare const getCreateChatCompletionUrl: () => string;
 /**
- * Authenticated project inference. Billing ownership comes only from the verified project token; no Canopy API key or project header is required.
+ * Authenticated project inference in the OpenAI Chat Completions protocol, forwarded unchanged to an upstream that speaks it. Billing ownership comes only from the verified project token.
  * @summary Create a chat completion
  */
 export declare const createChatCompletion: (chatCompletionRequest: ChatCompletionRequest, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<createChatCompletionResponse>;
@@ -148,6 +156,73 @@ export declare const getCreateEmbeddingsUrl: () => string;
  * @summary Create embeddings
  */
 export declare const createEmbeddings: (embeddingRequest: EmbeddingRequest, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<createEmbeddingsResponse>;
+export type createMessageResponse200ApplicationJson = {
+    data: NativeResponse;
+    status: 200;
+};
+export type createMessageResponse200TextEventStream = {
+    data: Blob;
+    status: 200;
+};
+export type createMessageResponseDefault = {
+    data: InferenceError;
+    status: Exclude<HTTPStatusCodes, 200>;
+};
+export type createMessageResponseSuccess = (createMessageResponse200ApplicationJson | createMessageResponse200TextEventStream) & {
+    headers: Headers;
+};
+export type createMessageResponseError = createMessageResponseDefault & {
+    headers: Headers;
+};
+export type createMessageResponse = createMessageResponseSuccess | createMessageResponseError;
+export declare const getCreateMessageUrl: () => string;
+/**
+ * Authenticated project inference in the Anthropic Messages protocol, forwarded unchanged to an upstream that speaks it. Accepts the `x-api-key` header as well as Authorization. Streams Anthropic SSE events when `stream` is true.
+ * @summary Create a message
+ */
+export declare const createMessage: (nativeRequest: NativeRequest, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<createMessageResponse>;
+export type generateContentResponse200 = {
+    data: NativeResponse;
+    status: 200;
+};
+export type generateContentResponseDefault = {
+    data: InferenceError;
+    status: Exclude<HTTPStatusCodes, 200>;
+};
+export type generateContentResponseSuccess = generateContentResponse200 & {
+    headers: Headers;
+};
+export type generateContentResponseError = generateContentResponseDefault & {
+    headers: Headers;
+};
+export type generateContentResponse = generateContentResponseSuccess | generateContentResponseError;
+export declare const getGenerateContentUrl: (model: string) => string;
+/**
+ * Authenticated project inference in the Gemini protocol, forwarded unchanged to an upstream that speaks it. Accepts the `x-goog-api-key` header as well as Authorization.
+ * @summary Generate content
+ */
+export declare const generateContent: (model: string, nativeRequest: NativeRequest, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<generateContentResponse>;
+export type streamGenerateContentResponse200 = {
+    data: Blob;
+    status: 200;
+};
+export type streamGenerateContentResponseDefault = {
+    data: InferenceError;
+    status: Exclude<HTTPStatusCodes, 200>;
+};
+export type streamGenerateContentResponseSuccess = streamGenerateContentResponse200 & {
+    headers: Headers;
+};
+export type streamGenerateContentResponseError = streamGenerateContentResponseDefault & {
+    headers: Headers;
+};
+export type streamGenerateContentResponse = streamGenerateContentResponseSuccess | streamGenerateContentResponseError;
+export declare const getStreamGenerateContentUrl: (model: string, params?: StreamGenerateContentParams) => string;
+/**
+ * The streaming form of generate-content. Use `alt=sse` for server-sent events.
+ * @summary Stream generated content
+ */
+export declare const streamGenerateContent: (model: string, nativeRequest: NativeRequest, params?: StreamGenerateContentParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<streamGenerateContentResponse>;
 export type listInferenceModelsResponse200 = {
     data: ModelList;
     status: 200;

package/dist/canopy/v1/generated/functions.js

@@ -69,7 +69,7 @@ export const getCreateChatCompletionUrl = () => {
     return `https://canopy.leaflow.cloud/v1/chat/completions`;
 };
 /**
- * Authenticated project inference. Billing ownership comes only from the verified project token; no Canopy API key or project header is required.
+ * Authenticated project inference in the OpenAI Chat Completions protocol, forwarded unchanged to an upstream that speaks it. Billing ownership comes only from the verified project token.
  * @summary Create a chat completion
  */
 export const createChatCompletion = async (chatCompletionRequest, options, fetchFn) => {
@@ -94,11 +94,7 @@ export const createChatCompletion = async (chatCompletionRequest, options, fetch
         headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
         body: JSON.stringify(chatCompletionRequest),
     });
-    const body = [204, 205, 304].includes(res.status)
-        ? null
-        : res.headers.get("content-type")?.includes("application/json")
-            ? JSON.parse(await res.text())
-            : await res.blob();
+    const body = [204, 205, 304].includes(res.status) ? null : res.headers.get("content-type")?.includes("application/json") ? JSON.parse(await res.text()) : await res.blob();
     const data = body;
     return { data, status: res.status, headers: res.headers };
 };
@@ -135,6 +131,114 @@ export const createEmbeddings = async (embeddingRequest, options, fetchFn) => {
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
+export const getCreateMessageUrl = () => {
+    return `https://canopy.leaflow.cloud/v1/messages`;
+};
+/**
+ * Authenticated project inference in the Anthropic Messages protocol, forwarded unchanged to an upstream that speaks it. Accepts the `x-api-key` header as well as Authorization. Streams Anthropic SSE events when `stream` is true.
+ * @summary Create a message
+ */
+export const createMessage = async (nativeRequest, options, fetchFn) => {
+    const getHeaders = (h) => {
+        if (!h)
+            return {};
+        if (h instanceof Headers)
+            return Object.fromEntries(h.entries());
+        if (Symbol.iterator in h) {
+            return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+        }
+        const headers = {};
+        for (const [name, value] of Object.entries(h)) {
+            if (value !== undefined)
+                headers[name] = value;
+        }
+        return headers;
+    };
+    const res = await (fetchFn ?? fetch)(getCreateMessageUrl(), {
+        ...options,
+        method: "POST",
+        headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
+        body: JSON.stringify(nativeRequest),
+    });
+    const body = [204, 205, 304].includes(res.status) ? null : await res.blob();
+    const data = body;
+    return { data, status: res.status, headers: res.headers };
+};
+export const getGenerateContentUrl = (model) => {
+    return `https://canopy.leaflow.cloud/v1beta/models/${encodeURIComponent(String(model))}:generateContent`;
+};
+/**
+ * Authenticated project inference in the Gemini protocol, forwarded unchanged to an upstream that speaks it. Accepts the `x-goog-api-key` header as well as Authorization.
+ * @summary Generate content
+ */
+export const generateContent = async (model, nativeRequest, options, fetchFn) => {
+    const getHeaders = (h) => {
+        if (!h)
+            return {};
+        if (h instanceof Headers)
+            return Object.fromEntries(h.entries());
+        if (Symbol.iterator in h) {
+            return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+        }
+        const headers = {};
+        for (const [name, value] of Object.entries(h)) {
+            if (value !== undefined)
+                headers[name] = value;
+        }
+        return headers;
+    };
+    const res = await (fetchFn ?? fetch)(getGenerateContentUrl(model), {
+        ...options,
+        method: "POST",
+        headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
+        body: JSON.stringify(nativeRequest),
+    });
+    const body = [204, 205, 304].includes(res.status) ? null : await res.text();
+    const data = body ? JSON.parse(body) : {};
+    return { data, status: res.status, headers: res.headers };
+};
+export const getStreamGenerateContentUrl = (model, params) => {
+    const normalizedParams = new URLSearchParams();
+    Object.entries(params || {}).forEach(([key, value]) => {
+        if (value !== undefined) {
+            normalizedParams.append(key, value === null ? "null" : String(value));
+        }
+    });
+    const stringifiedParams = normalizedParams.toString();
+    return stringifiedParams.length > 0
+        ? `https://canopy.leaflow.cloud/v1beta/models/${encodeURIComponent(String(model))}:streamGenerateContent?${stringifiedParams}`
+        : `https://canopy.leaflow.cloud/v1beta/models/${encodeURIComponent(String(model))}:streamGenerateContent`;
+};
+/**
+ * The streaming form of generate-content. Use `alt=sse` for server-sent events.
+ * @summary Stream generated content
+ */
+export const streamGenerateContent = async (model, nativeRequest, params, options, fetchFn) => {
+    const getHeaders = (h) => {
+        if (!h)
+            return {};
+        if (h instanceof Headers)
+            return Object.fromEntries(h.entries());
+        if (Symbol.iterator in h) {
+            return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+        }
+        const headers = {};
+        for (const [name, value] of Object.entries(h)) {
+            if (value !== undefined)
+                headers[name] = value;
+        }
+        return headers;
+    };
+    const res = await (fetchFn ?? fetch)(getStreamGenerateContentUrl(model, params), {
+        ...options,
+        method: "POST",
+        headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
+        body: JSON.stringify(nativeRequest),
+    });
+    const body = [204, 205, 304].includes(res.status) ? null : await res.blob();
+    const data = body;
+    return { data, status: res.status, headers: res.headers };
+};
 export const getListInferenceModelsUrl = () => {
     return `https://canopy.leaflow.cloud/v1/models`;
 };

package/dist/canopy/v1/generated/models.d.ts

@@ -4,9 +4,17 @@
  * Leaflow Canopy API
  * Canopy model inference, API keys, model catalogue, service enablement and recorded usage.
  *
- * OpenAI-compatible project inference is served on this host at `/v1/chat/completions`,
- * `/v1/embeddings`, `/v1/models` and `/v1/models/{model}`. Use `https://canopy.leaflow.cloud/v1`
- * as the OpenAI SDK base URL. Chat completions support `stream=true` SSE.
+ * Project inference is served on this host in each provider's own protocol:
+ *
+ * - OpenAI: `/v1/chat/completions`, `/v1/responses` and `/v1/embeddings`; use
+ *   `https://canopy.leaflow.cloud/v1` as the OpenAI SDK base URL.
+ * - Anthropic: `/v1/messages`; use `https://canopy.leaflow.cloud` as the Anthropic SDK base URL.
+ * - Gemini: `/v1beta/models/{model}:generateContent` and `:streamGenerateContent`.
+ *
+ * Canopy does not convert between protocols. A request is accepted only for a model whose
+ * `supported_endpoints` lists the endpoint it was sent to, and it is forwarded unchanged except for
+ * the model name and the credentials. Reasoning settings such as `reasoning_effort` are passed
+ * through as written; a model's `capabilities` lists the values its upstream accepts.
  *
  * Management operations use `/api/v1`. The management model catalogue includes pricing;
  * `/v1/models` returns the OpenAI model format with Canopy capabilities and parameter limits.
@@ -18,7 +26,7 @@
  * Management and project inference accept the same verified IAM scoped token. The token is the
  * sole billing project authority; `OpenAI-Project` and historical identity headers cannot
  * override it. These endpoints do not accept a Canopy API key. The separate API-key gateway
- * accepts Canopy API keys and supports OpenAI, Anthropic and Gemini request formats.
+ * accepts Canopy API keys and serves the same endpoints.
  *
  * ## Conventions
  *
@@ -33,19 +41,8 @@
 export type ReasoningDiagnosticsRequested = {
     [key: string]: unknown;
 };
-export type ReasoningDiagnosticsEffective = {
-    [key: string]: unknown;
-};
-export type ReasoningDiagnosticsTranslation = (typeof ReasoningDiagnosticsTranslation)[keyof typeof ReasoningDiagnosticsTranslation];
-export declare const ReasoningDiagnosticsTranslation: {
-    readonly translate: "translate";
-    readonly passthrough: "passthrough";
-    readonly strip: "strip";
-};
 export interface ReasoningDiagnostics {
     requested: ReasoningDiagnosticsRequested;
-    effective?: ReasoningDiagnosticsEffective;
-    translation?: ReasoningDiagnosticsTranslation;
 }
 export type ChatCompletionRequestMessagesItem = {
     [key: string]: unknown;
@@ -106,7 +103,7 @@ export type ReasoningCapabilitiesBudgetTokens = {
 export interface ReasoningCapabilities {
     supported: boolean;
     /**
-     * Null means unknown; an empty array means effort is not configurable.
+     * The effort values the upstream accepts, sent through unchanged. Agents send low, medium or high. Null means unknown; an empty array means effort is not configurable.
      * @nullable
      */
     effort_levels: string[] | null;
@@ -137,6 +134,8 @@ export declare const ModelEndpoint: {
     readonly "/v1/chat/completions": "/v1/chat/completions";
     readonly "/v1/responses": "/v1/responses";
     readonly "/v1/embeddings": "/v1/embeddings";
+    readonly "/v1/messages": "/v1/messages";
+    readonly "/v1beta/models/{model}:generateContent": "/v1beta/models/{model}:generateContent";
     readonly "/v1/images/generations": "/v1/images/generations";
     readonly "/v1/images/edits": "/v1/images/edits";
     readonly "/v1/audio/transcriptions": "/v1/audio/transcriptions";
@@ -782,6 +781,18 @@ export interface ResponseDeleted {
     object: string;
     deleted: boolean;
 }
+/**
+ * A request body in the endpoint's own protocol. Canopy reads only the model name and forwards the rest unchanged.
+ */
+export interface NativeRequest {
+    [key: string]: unknown;
+}
+/**
+ * A response body in the endpoint's own protocol, as the upstream returned it.
+ */
+export interface NativeResponse {
+    [key: string]: unknown;
+}
 /**
  * Pagination metadata for stable numbered pages. total_count is returned only when the operation can determine it without an unbounded scan.
  */
@@ -958,20 +969,34 @@ export interface WithdrawalItemList {
     pagination: OffsetPagination;
 }
 /**
- * Whether a delivered purchase may end immediately or only at the end of its paid term; refunds follow the refund policy. When absent, no termination terms were agreed.
+ * Whether a cancellation of a delivered purchase may take effect immediately or only at the end of its paid term; refunds follow the refund policy. When absent, no cancellation terms were agreed.
  */
-export type TerminationPolicy = (typeof TerminationPolicy)[keyof typeof TerminationPolicy];
-export declare const TerminationPolicy: {
+export type CancellationPolicy = (typeof CancellationPolicy)[keyof typeof CancellationPolicy];
+export declare const CancellationPolicy: {
     readonly immediate: "immediate";
     readonly period_end: "period_end";
 };
 /**
- * `none` refunds nothing. `prorated` refunds the amount paid for the current period minus the value of the time used, never below zero or above what remains unrefunded. Time used runs from the period start to the effective cancellation and is valued at prices frozen on the order item: each full calendar month at `refund_monthly_amount`, the rest at `refund_hourly_amount` or, without it, at the monthly price by the second. When the plan has no licensed period shorter than the one bought, time used is valued pro rata at the price paid. Discounts and setup fees are not refunded. Refunds return to the original payment sources, with tax refunded in proportion.
+ * `none` refunds nothing.
+ *
+ * `prorated` refunds the amount paid for the current period minus the value of the time used, never below zero
+ * or above what remains unrefunded. Time used runs from the period start to the effective cancellation, by the
+ * second. Each whole month from the period start is valued at the order item's `monthly_list_amount`, and the
+ * remainder at that amount in proportion to the length of the month it falls in; without `monthly_list_amount`,
+ * time used is valued at the amount paid in proportion to the length of the period. A renewal starts a new
+ * period, and an immediate change starts one at the change. Discounts and setup fees are not refunded. Refunds
+ * return to the original payment sources, with tax refunded in proportion.
+ *
+ * `short_rate` refunds as `prorated`, except that when the cancellation takes effect less than
+ * `short_rate_threshold_seconds` after the period start, the value of the time used is multiplied by
+ * `short_rate_multiplier`, up to `monthly_list_amount` for each month begun or, without `monthly_list_amount`,
+ * up to the amount paid.
  */
 export type RefundPolicy = (typeof RefundPolicy)[keyof typeof RefundPolicy];
 export declare const RefundPolicy: {
     readonly none: "none";
     readonly prorated: "prorated";
+    readonly short_rate: "short_rate";
 };
 export interface OrderCancel {
     /**
@@ -991,8 +1016,8 @@ export declare const QuoteRenewalInterval: {
  * Price renewing a licensed subscription. Give `price_id`, or `interval` with
  * `interval_count`, to renew for another term at the price currently sold for it. Naming
  * the current term, or giving neither, renews at the agreed amount. A term sold at several
- * prices that differ in termination policy is refused with 409
- * `BILLING_RENEWAL_OPTION_AMBIGUOUS` unless `termination_policy` or `price_id` is given.
+ * prices that differ in cancellation policy is refused with 409
+ * `BILLING_RENEWAL_OPTION_AMBIGUOUS` unless `cancellation_policy` or `price_id` is given.
  */
 export interface QuoteRenewal {
     subscription_id: string;
@@ -1000,8 +1025,8 @@ export interface QuoteRenewal {
     interval?: QuoteRenewalInterval;
     /** @minimum 1 */
     interval_count?: number;
-    /** With `interval` and `interval_count`, chooses among prices of that term that differ in termination policy. */
-    termination_policy?: TerminationPolicy;
+    /** With `interval` and `interval_count`, chooses among prices of that term that differ in cancellation policy. */
+    cancellation_policy?: CancellationPolicy;
     /**
      * How many consecutive periods to renew for.
      * @minimum 1
@@ -1133,6 +1158,7 @@ export interface CancellationRefundPreviewItem {
     /** Whether automatic renewal is on now. Creating the cancellation turns it off; withdrawing it turns it back on for a metered subscription but not for a licensed one. */
     auto_renew: boolean;
     unused_amount: Money;
+    short_rate_surcharge_amount: Money;
     refundable_amount: Money;
     refund_amount: Money;
     credit_amount: Money;
@@ -1143,8 +1169,9 @@ export interface CancellationRefundPreviewItem {
  * What the cancellation would return, per subscription and in total, as of now. Give `proration_date` and
  * `refundable_amount` when creating the cancellation.
  *
- * - `unused_amount`: before tax, the amount paid for the current periods minus the value of the time used,
- *   valued as refund policy `prorated` describes, whatever the refund terms say.
+ * - `unused_amount`: before tax, the amount paid for the current periods in proportion to the time remaining.
+ * - `short_rate_surcharge_amount`: before tax, the part of `forfeited_amount` due to the short rate of the
+ *   refund policy.
  * - `refundable_amount`: what is returned the way it was paid, tax included; `refund_amount` plus
  *   `credit_amount`.
  * - `refund_amount`: the part returned to the balance or the payment method.
@@ -1155,13 +1182,14 @@ export interface CancellationRefundPreviewItem {
  * Metered and one-time subscriptions show zero; their usage until release is charged as usual.
  */
 export interface CancellationRefundPreview {
-    mode: TerminationPolicy;
+    mode: CancellationPolicy;
     /** For `period_end`, when release begins, the end of the paid terms. */
     scheduled_at?: string;
     /** For `immediate`, the second the refund is computed as of. Give it when creating the cancellation. */
     proration_date?: string;
     currency: string;
     unused_amount: Money;
+    short_rate_surcharge_amount: Money;
     refundable_amount: Money;
     refund_amount: Money;
     credit_amount: Money;
@@ -1170,7 +1198,7 @@ export interface CancellationRefundPreview {
     items: CancellationRefundPreviewItem[];
 }
 /**
- * An estimated refund to the original payment sources. Before acceptance, cancellation returns the collected amount. For delivered service, only value paid by this order is included; renewals are evaluated with their own orders under the agreed termination terms. Nothing is refunded by the quote; the amount is fixed when cancellation or termination is confirmed.
+ * An estimated refund to the original payment sources. Before acceptance, cancellation returns the collected amount. For delivered service, only value paid by this order is included; renewals are evaluated with their own orders under the agreed cancellation terms. Nothing is refunded by the quote; the amount is fixed when cancellation or termination is confirmed.
  */
 export interface OrderRefundQuote {
     order_id: string;
@@ -1210,7 +1238,7 @@ export interface QuoteCancellation {
      * @maxItems 50
      */
     subscription_ids: string[];
-    mode: TerminationPolicy;
+    mode: CancellationPolicy;
 }
 export interface CancellationCreate {
     /**
@@ -1219,7 +1247,7 @@ export interface CancellationCreate {
      * @maxItems 50
      */
     subscription_ids: string[];
-    mode: TerminationPolicy;
+    mode: CancellationPolicy;
     /** For `immediate`, the quote's `proration_date`: a whole second, not in the future and at most ten minutes old; the refund is computed as of it. Now when omitted. */
     proration_date?: string;
     /** The quote's `refundable_amount`; the cancellation is refused when the refund differs. */
@@ -1299,7 +1327,7 @@ export interface CancellationItem {
 export interface Cancellation {
     id: string;
     status: CancellationStatus;
-    mode: TerminationPolicy;
+    mode: CancellationPolicy;
     scheduled_at?: string;
     /** For `immediate`, the second the refund is computed as of. */
     proration_date?: string;
@@ -2216,9 +2244,11 @@ export declare const RefundStatus: {
  * - `change_expired`: a scheduled change could not take effect in time.
  * - `subscription_canceled`: the unused value of a canceled subscription, under its refund terms.
  * - `future_period_canceled`: a renewal that had not started was withdrawn.
- * - `downgrade_difference`: after a downgrade, the remaining paid value, valued as refund policy `prorated`
- *   describes, minus the new configuration's cost for the remaining time at the change item's
- *   `refund_monthly_amount` and `refund_hourly_amount`.
+ * - `downgrade_difference`: after a downgrade, the remaining paid value, valued under each paid period's refund
+ *   policy and as `prorated` where that policy is `none`, minus the new configuration's value for the remaining
+ *   time: each whole month at the change item's `monthly_list_amount` and the remainder in proportion to the
+ *   length of the month it falls in, or without `monthly_list_amount`, the new period price in proportion to the
+ *   remaining time.
  * - `usage_true_up`: usage priced over the whole month cost less than was charged.
  * - `payment_not_applied`: a payment arrived after its invoice could no longer be paid.
  * - `operator`: made by the platform operator.
@@ -2439,8 +2469,14 @@ export interface Subscription {
     interval_count?: number;
     /** The whole licensed subscription's renewal amount, after continuing discounts and before tax. A pending subscription shows base terms until paying the order fixes any new discount. Absent for metered and one-time subscriptions. */
     recurring_amount?: string;
-    termination_policy?: TerminationPolicy;
+    cancellation_policy?: CancellationPolicy;
     refund_policy?: RefundPolicy;
+    /** Refund policy `short_rate` only, as on the price bought. */
+    short_rate_multiplier?: string;
+    /** Refund policy `short_rate` only, as on the price bought. */
+    short_rate_threshold_seconds?: number;
+    /** Licensed recurring only, the `monthly_list_amount` that a renewal at the agreed amount keeps; see the order item. */
+    monthly_list_amount?: string;
     order_item_id?: string;
     coupon_id?: string;
     coupon?: ObjectIdentity;
@@ -2513,8 +2549,12 @@ export declare const RenewalPriceInterval: {
     readonly year: "year";
 };
 export interface RenewalPrice {
-    termination_policy?: TerminationPolicy;
+    cancellation_policy?: CancellationPolicy;
     refund_policy?: RefundPolicy;
+    /** Refund policy `short_rate` only. */
+    short_rate_multiplier?: string;
+    /** Refund policy `short_rate` only. */
+    short_rate_threshold_seconds?: number;
     price_id: string;
     /** How many periods one renewal covers. */
     interval_count: number;
@@ -2553,8 +2593,8 @@ export interface RenewRequest {
      * Leaving both out renews at the price this item already bills at, which a later price
      * change does not affect. Naming a term that differs from the current one is a fresh
      * choice, so it is bought at today's price. Naming the current term changes nothing. A
-     * term sold at several prices that differ in termination policy is refused with 409
-     * `BILLING_RENEWAL_OPTION_AMBIGUOUS` unless `termination_policy` is given.
+     * term sold at several prices that differ in cancellation policy is refused with 409
+     * `BILLING_RENEWAL_OPTION_AMBIGUOUS` unless `cancellation_policy` is given.
      *
      * List the terms on offer with the renewal prices operation.
      * @minimum 1
@@ -2562,8 +2602,8 @@ export interface RenewRequest {
     interval_count?: number;
     /** The unit interval_count counts in. */
     interval?: RenewRequestInterval;
-    /** With `interval` and `interval_count`, chooses among prices of that term that differ in termination policy. */
-    termination_policy?: TerminationPolicy;
+    /** With `interval` and `interval_count`, chooses among prices of that term that differ in cancellation policy. */
+    cancellation_policy?: CancellationPolicy;
     payment_method_id?: string;
     /** Whether to pay from the balance, with or without `payment_method_id`. */
     use_balance?: boolean;
@@ -2599,7 +2639,7 @@ export interface RenewalOrderRequest {
     /** As in renewing. */
     interval?: RenewalOrderRequestInterval;
     /** As in renewing. */
-    termination_policy?: TerminationPolicy;
+    cancellation_policy?: CancellationPolicy;
 }
 export interface AutoRenewSet {
     auto_renew: boolean;
@@ -2680,18 +2720,23 @@ export interface OrderItem {
     interval: OrderItemInterval;
     /** @minimum 1 */
     interval_count?: number;
-    termination_policy?: TerminationPolicy;
+    cancellation_policy?: CancellationPolicy;
     refund_policy?: RefundPolicy;
     /**
-     * Recurring licensed items only: the plan's one-month licensed price for this item's quantity, before tax and frozen at purchase, used to value time under a prorated refund or a downgrade. Null when the plan has no licensed period shorter than the one bought.
+     * Recurring licensed items only: a month at list price for this item's quantity, before tax and discounts, which values time under a refund or a downgrade. It is the monthly amount of the shortest period the plan sells, not longer than the one bought, at the item's dimensions, fixed at purchase; a renewal at the agreed amount keeps the previous value. Null when time used is valued at the amount paid, as for a daily period.
      * @nullable
      */
-    refund_monthly_amount?: string | null;
+    monthly_list_amount?: string | null;
     /**
-     * Recurring licensed items only, the plan's metered hourly price for this item's quantity before tax, frozen at purchase, used for time used short of a full month. Null when the licensed price has no meter.
+     * Refund policy `short_rate` only, as on the price when bought.
      * @nullable
      */
-    refund_hourly_amount?: string | null;
+    short_rate_multiplier?: string | null;
+    /**
+     * Refund policy `short_rate` only, as on the price when bought.
+     * @nullable
+     */
+    short_rate_threshold_seconds?: number | null;
     recurring_amount?: string;
     setup_amount?: string;
     type: PriceType;
@@ -3021,8 +3066,12 @@ export interface Price {
     unit_quantity: string;
     /** False once archived. An archived price cannot be bought until it is active again. */
     active: boolean;
-    termination_policy?: TerminationPolicy;
+    cancellation_policy?: CancellationPolicy;
     refund_policy?: RefundPolicy;
+    /** Refund policy `short_rate` only, the factor applied to the value of the time used when a cancellation takes effect less than `short_rate_threshold_seconds` after the period start. */
+    short_rate_multiplier?: string;
+    /** Refund policy `short_rate` only, how long after the period start `short_rate_multiplier` applies. */
+    short_rate_threshold_seconds?: number;
     product_id?: ProductID;
     id: string;
     plan_id: string;
@@ -3147,7 +3196,7 @@ export interface QuoteItemInput {
     /** @minimum 1 */
     interval_count?: number;
     /** Selects among licensed prices with otherwise identical billing terms. Ambiguous terms are refused instead of choosing a price arbitrarily. */
-    termination_policy?: TerminationPolicy;
+    cancellation_policy?: CancellationPolicy;
     /** @pattern ^(?:(?:[1-9][0-9]{0,27}|0(?:[1-9][0-9]{0,26}|0(?:[1-9][0-9]{0,25}|0(?:[1-9][0-9]{0,24}|0(?:[1-9][0-9]{0,23}|0(?:[1-9][0-9]{0,22}|0(?:[1-9][0-9]{0,21}|0(?:[1-9][0-9]{0,20}|0(?:[1-9][0-9]{0,19}|0(?:[1-9][0-9]{0,18}|0(?:[1-9][0-9]{0,17}|0(?:[1-9][0-9]{0,16}|0(?:[1-9][0-9]{0,15}|0(?:[1-9][0-9]{0,14}|0(?:[1-9][0-9]{0,13}|0(?:[1-9][0-9]{0,12}|0(?:[1-9][0-9]{0,11}|0(?:[1-9][0-9]{0,10}|0(?:[1-9][0-9]{0,9}|0(?:[1-9][0-9]{0,8}|0(?:[1-9][0-9]{0,7}|0(?:[1-9][0-9]{0,6}|0(?:[1-9][0-9]{0,5}|0(?:[1-9][0-9]{0,4}|0(?:[1-9][0-9]{0,3}|0(?:[1-9][0-9]{0,2}|0(?:[1-9][0-9]{0,1}|0[1-9])))))))))))))))))))))))))))([.][0-9]{1,10})?|0{1,28}[.](?:[1-9][0-9]{0,9}|0(?:[1-9][0-9]{0,8}|0(?:[1-9][0-9]{0,7}|0(?:[1-9][0-9]{0,6}|0(?:[1-9][0-9]{0,5}|0(?:[1-9][0-9]{0,4}|0(?:[1-9][0-9]{0,3}|0(?:[1-9][0-9]{0,2}|0(?:[1-9][0-9]{0,1}|0[1-9]))))))))))$ */
     quantity: string;
     meter_id?: string;
@@ -3372,7 +3421,7 @@ export interface ContactList {
     pagination: OffsetPagination;
 }
 export interface CancelSubscriptionRequest {
-    mode: TerminationPolicy;
+    mode: CancellationPolicy;
     /** For immediate cancellation, the quoted whole-second refund basis. Now when omitted. */
     proration_date?: string;
     /** The cancellation quote's refundable amount, including an explicit zero. */
@@ -3489,6 +3538,13 @@ export interface StatementSummary {
  * The request conflicts with the current state of the service. The codes are described where they apply.
  */
 export type ConflictResponse = Error;
+export type StreamGenerateContentParams = {
+    alt?: StreamGenerateContentAlt;
+};
+export type StreamGenerateContentAlt = (typeof StreamGenerateContentAlt)[keyof typeof StreamGenerateContentAlt];
+export declare const StreamGenerateContentAlt: {
+    readonly sse: "sse";
+};
 export type ListApiKeysParams = {
     /**
      * Items returned in this page. Defaults to 50; at most 200.