@leaflow/sdk 0.0.0-dev.429.gf6440ec → 0.0.0-dev.433.g7e48b8f

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

@@ -116,12 +116,147 @@ export interface ReasoningCapabilities {
     /** @nullable */
     summary: string[] | null;
 }
+/**
+ * The image parameters this endpoint accepts. The client chooses among them; a value outside the list is rejected before the upstream is called.
+ */
+export interface ImageCapabilities {
+    /**
+     * Size values the upstream accepts, such as 1024x1024 or auto. Null means unknown.
+     * @nullable
+     */
+    sizes: string[] | null;
+    /**
+     * Quality values the upstream accepts. Null means unknown.
+     * @nullable
+     */
+    qualities: string[] | null;
+    /**
+     * Response formats the upstream accepts. Null means unknown.
+     * @nullable
+     */
+    response_formats: string[] | null;
+    /**
+     * The largest number of images one request may ask for. Null means unknown.
+     * @minimum 0
+     * @maximum 128
+     * @nullable
+     */
+    max_n: number | null;
+    /**
+     * Whether the endpoint can stream partial images. Null means unknown.
+     * @nullable
+     */
+    supports_stream: boolean | null;
+}
+/**
+ * The audio parameters this endpoint accepts.
+ */
+export interface AudioCapabilities {
+    /**
+     * Voices the speech endpoint accepts. Empty for transcription endpoints. Null means unknown.
+     * @nullable
+     */
+    voices: string[] | null;
+    /**
+     * Audio container or codec values the endpoint accepts. Null means unknown.
+     * @nullable
+     */
+    formats: string[] | null;
+    /**
+     * Response formats the transcription endpoint accepts, such as json or srt. Null means unknown.
+     * @nullable
+     */
+    response_formats: string[] | null;
+    /**
+     * The largest upload the endpoint accepts, in bytes. Null means unknown.
+     * @minimum 0
+     * @nullable
+     */
+    max_input_bytes: number | null;
+    /**
+     * Whether the endpoint can stream its response. Null means unknown.
+     * @nullable
+     */
+    supports_stream: boolean | null;
+}
+/**
+ * The video parameters this endpoint accepts. Video is asynchronous on every endpoint that supports it. Create returns a task, and the task is polled separately.
+ */
+export interface VideoCapabilities {
+    /**
+     * Durations the upstream accepts, in seconds. Null means unknown.
+     * @nullable
+     * @items.minimum 1
+     */
+    seconds: number[] | null;
+    /**
+     * Output sizes the upstream accepts, such as 1280x720. Null means unknown.
+     * @nullable
+     */
+    sizes: string[] | null;
+    /**
+     * Resolution tiers the upstream accepts, such as 720p or 1080p. Null means unknown.
+     * @nullable
+     */
+    resolutions: string[] | null;
+    /**
+     * Whether a request may carry a reference image. Null means unknown.
+     * @nullable
+     */
+    supports_input_reference: boolean | null;
+    /**
+     * Whether a generated video can be remixed into another task. Null means unknown.
+     * @nullable
+     */
+    supports_remix: boolean | null;
+    /**
+     * Whether the upstream accepts reusable characters. Null means unknown.
+     * @nullable
+     */
+    supports_characters: boolean | null;
+}
+export type ModelParameterType = (typeof ModelParameterType)[keyof typeof ModelParameterType];
+export declare const ModelParameterType: {
+    readonly string: "string";
+    readonly integer: "integer";
+    readonly number: "number";
+    readonly boolean: "boolean";
+    readonly object: "object";
+    readonly array: "array";
+};
+/**
+ * A non-standard request field this endpoint accepts. OpenAI SDK callers pass it through `extra_body`, which places it at the top level of the body.
+ */
+export interface ModelParameter {
+    name: string;
+    description: string;
+    type: ModelParameterType;
+    required: boolean;
+    /** The value the upstream assumes when the field is absent; null when there is none. The service never writes it into the request. */
+    default?: unknown;
+    /**
+     * The accepted values of an enumerated string parameter. Null when the parameter is not enumerated.
+     * @nullable
+     */
+    values?: string[] | null;
+}
 export interface EndpointCapabilities {
     /** @nullable */
     function_calling: boolean | null;
     /** @nullable */
     structured_output: boolean | null;
     reasoning: ReasoningCapabilities | null;
+    /** Present on image generation and edit endpoints. Null or absent elsewhere. */
+    image?: ImageCapabilities | null;
+    /** Present on speech and transcription endpoints. Null or absent elsewhere. */
+    audio?: AudioCapabilities | null;
+    /** Present on the videos endpoint. Null or absent elsewhere. */
+    video?: VideoCapabilities | null;
+    /**
+     * Non-standard request fields this endpoint accepts, sent at the top level of the request body. Null or absent means none are declared.
+     * @nullable
+     */
+    parameters?: ModelParameter[] | null;
 }
 /**
  * Verified capabilities keyed by API endpoint, for example /v1/chat/completions or /v1/responses. Missing keys and null values mean unknown. Current route availability is separate.
@@ -142,6 +277,19 @@ export declare const ModelEndpoint: {
     readonly "/v1/audio/translations": "/v1/audio/translations";
     readonly "/v1/audio/speech": "/v1/audio/speech";
     readonly "/v1/realtime": "/v1/realtime";
+    readonly "/v1/completions": "/v1/completions";
+    readonly "/v1/rerank": "/v1/rerank";
+    readonly "/v1/moderations": "/v1/moderations";
+    readonly "/v1/images/variations": "/v1/images/variations";
+    readonly "/v1/files": "/v1/files";
+    readonly "/v1/uploads": "/v1/uploads";
+    readonly "/v1/batches": "/v1/batches";
+    readonly "/v1/fine_tuning/jobs": "/v1/fine_tuning/jobs";
+    readonly "/v1/assistants": "/v1/assistants";
+    readonly "/v1/threads": "/v1/threads";
+    readonly "/v1/vector_stores": "/v1/vector_stores";
+    readonly "/v1/containers": "/v1/containers";
+    readonly "/v1/videos": "/v1/videos";
 };
 export interface Model {
     id: string;
@@ -367,32 +515,45 @@ export declare const ModelResourceStatus: {
     readonly draining: "draining";
     readonly retired: "retired";
 };
-export type ModelMeterTokenKind = (typeof ModelMeterTokenKind)[keyof typeof ModelMeterTokenKind];
-export declare const ModelMeterTokenKind: {
+/**
+ * The billable quantity this entry prices. Token kinds are `input`, `output`, `cache_read`, `cache_write` and `reasoning`; media kinds are `images`, `audio_characters`, `audio_seconds` and `video_seconds`.
+ */
+export type ModelMeterKind = (typeof ModelMeterKind)[keyof typeof ModelMeterKind];
+export declare const ModelMeterKind: {
     readonly input: "input";
     readonly output: "output";
     readonly cache_read: "cache_read";
     readonly cache_write: "cache_write";
     readonly reasoning: "reasoning";
+    readonly images: "images";
+    readonly audio_characters: "audio_characters";
+    readonly audio_seconds: "audio_seconds";
+    readonly video_seconds: "video_seconds";
+    readonly rerank_units: "rerank_units";
 };
 /**
- * The dimension values the usage of this token kind carries, and the rate is matched at.
+ * One set of dimension values of this kind, useful as a query template. A media kind may have other values on the same keys, such as another size or resolution.
  */
 export type ModelMeterDimensions = {
     [key: string]: string;
 };
 export interface ModelMeter {
-    token_kind: ModelMeterTokenKind;
+    /** The billable quantity this entry prices. Token kinds are `input`, `output`, `cache_read`, `cache_write` and `reasoning`; media kinds are `images`, `audio_characters`, `audio_seconds` and `video_seconds`. */
+    kind: ModelMeterKind;
     meter_lookup_key: string;
-    /** The dimension values the usage of this token kind carries, and the rate is matched at. */
+    /** The unit the meter counts in, such as token, image, character or second. */
+    unit: string;
+    /** The dimension keys every rate of this kind is matched on, in the order the meter declares them. */
+    dimension_keys: string[];
+    /** One set of dimension values of this kind, useful as a query template. A media kind may have other values on the same keys, such as another size or resolution. */
     dimensions: ModelMeterDimensions;
 }
 /**
- * How requests to a model are billed: under the service's subscription, on the Billing plan `plan_id`, one rate for each token kind. Read the rates from Billing with `search-prices` for the plan, narrowing each price's `rates` with each meter's `dimensions`.
+ * How requests to a model are billed: under the service's subscription, on the Billing plan `plan_id`, one rate for each billable kind. Read the rates from Billing with `search-prices` for the plan, narrowing each price's `rates` with each meter's `dimensions`.
  *
- * Each token kind is priced on its own. `input` excludes cached input, which is `cache_read`, and `output` excludes reasoning the provider reports separately, which is `reasoning`; a request is billed for each kind it used.
+ * Text is billed on the five token kinds. `input` excludes cached input, which is `cache_read`; `output` excludes reasoning the provider reports separately, which is `reasoning`. Media is billed on its own unit and never converted to tokens: `images` counts generated images, `audio_characters` counts the input characters of speech synthesis, `audio_seconds` counts the duration of a transcription, and `video_seconds` counts the duration of a generated video. A request is billed for each kind it used.
  *
- * Rates are set per currency, and a currency may not offer a model at all. A model is offered in the currency of the project's billing account when at least one of its token kinds has a rate there; a token kind without a rate in that currency is not charged. Requests to a model with no rate in that currency are refused with 403 `BILLING_MODEL_NOT_OFFERED`.
+ * Rates are set per currency, and a currency may not offer a model at all. A model is offered in the currency of the project's billing account when at least one of its billable kinds has a rate there; a kind without a rate in that currency is not charged. Requests to a model with no rate in that currency are refused with 403 `BILLING_MODEL_NOT_OFFERED`.
  */
 export interface ModelBilling {
     /**
@@ -400,7 +561,7 @@ export interface ModelBilling {
      * @nullable
      */
     plan_id: string | null;
-    /** One entry for each of the five token kinds, in the order input, output, cache_read, cache_write, reasoning. */
+    /** One entry for each billable kind the model uses. A text model lists the five token kinds in the order input, output, cache_read, cache_write, reasoning; media kinds follow in the order images, audio_characters, audio_seconds, video_seconds. */
     meters: ModelMeter[];
 }
 export interface ModelResource {
@@ -432,6 +593,34 @@ export interface ModelResource {
     /** Explicitly supported API endpoints. Requests to any other endpoint are rejected before upstream admission. */
     supported_endpoints: ModelEndpoint[];
 }
+/**
+ * Media quantities and the rate dimensions they were billed at. Absent on a token-only request.
+ */
+export interface MediaUsage {
+    /** Number of generated images. */
+    images: number;
+    /** Input characters of speech synthesis. */
+    audio_characters: number;
+    /** Duration of transcribed audio. */
+    audio_seconds: number;
+    /** Duration of a generated video. */
+    video_seconds: number;
+    /**
+     * Image or video size the request asked for, if it carried one.
+     * @nullable
+     */
+    size: string | null;
+    /**
+     * Image quality the request asked for, if it carried one.
+     * @nullable
+     */
+    quality: string | null;
+    /**
+     * Video resolution tier the request asked for, if it carried one.
+     * @nullable
+     */
+    resolution: string | null;
+}
 export interface ModelListResponseBody {
     items: ModelResource[];
 }
@@ -467,6 +656,7 @@ export interface RequestResource {
     finished_at: string | null;
     /** @nullable */
     first_token_at: string | null;
+    /** A typed request id such as `req_01j...`. Legacy rows may still be returned as a bare UUID. */
     id: string;
     input_tokens: number;
     /** The model named in the request */
@@ -490,6 +680,8 @@ export interface RequestResource {
     /** upstream means the figures were reported by the provider; estimated means they were derived from the character classes of the payload */
     usage_source: RequestResourceUsageSource;
     reasoning: ReasoningDiagnostics | null;
+    /** Media quantities and their rate dimensions. Null for a token-only request. */
+    media?: MediaUsage | null;
 }
 export interface CursorPageRequestResource {
     /** The items in this page */
@@ -504,6 +696,8 @@ export interface APIKeyUsageResource {
     input_tokens: number;
     output_tokens: number;
     reasoning_tokens: number;
+    /** Media quantities and their rate dimensions. Null when this range has no media usage. */
+    media?: MediaUsage | null;
     requests: number;
 }
 export interface APIKeyUsageListResponseBody {
@@ -516,6 +710,8 @@ export interface ModelUsageResource {
     model_id: string;
     output_tokens: number;
     reasoning_tokens: number;
+    /** Media quantities and their rate dimensions. Null when this range has no media usage. */
+    media?: MediaUsage | null;
     requests: number;
 }
 export interface ModelUsageListResponseBody {
@@ -527,6 +723,8 @@ export interface TotalsResource {
     input_tokens: number;
     output_tokens: number;
     reasoning_tokens: number;
+    /** Media quantities and their rate dimensions. Null when this range has no media usage. */
+    media?: MediaUsage | null;
     requests: number;
 }
 export interface UsageBucketResource {
@@ -537,6 +735,8 @@ export interface UsageBucketResource {
     input_tokens: number;
     output_tokens: number;
     reasoning_tokens: number;
+    /** Media quantities and their rate dimensions. Null when this range has no media usage. */
+    media?: MediaUsage | null;
     requests: number;
     /** End of the bucket, exclusive */
     to: string;

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

@@ -10,6 +10,14 @@ export const Modality = {
     file: "file",
     embedding: "embedding",
 };
+export const ModelParameterType = {
+    string: "string",
+    integer: "integer",
+    number: "number",
+    boolean: "boolean",
+    object: "object",
+    array: "array",
+};
 export const ModelEndpoint = {
     "/v1/chat/completions": "/v1/chat/completions",
     "/v1/responses": "/v1/responses",
@@ -22,6 +30,19 @@ export const ModelEndpoint = {
     "/v1/audio/translations": "/v1/audio/translations",
     "/v1/audio/speech": "/v1/audio/speech",
     "/v1/realtime": "/v1/realtime",
+    "/v1/completions": "/v1/completions",
+    "/v1/rerank": "/v1/rerank",
+    "/v1/moderations": "/v1/moderations",
+    "/v1/images/variations": "/v1/images/variations",
+    "/v1/files": "/v1/files",
+    "/v1/uploads": "/v1/uploads",
+    "/v1/batches": "/v1/batches",
+    "/v1/fine_tuning/jobs": "/v1/fine_tuning/jobs",
+    "/v1/assistants": "/v1/assistants",
+    "/v1/threads": "/v1/threads",
+    "/v1/vector_stores": "/v1/vector_stores",
+    "/v1/containers": "/v1/containers",
+    "/v1/videos": "/v1/videos",
 };
 export const APIKeyResourceStatus = {
     active: "active",
@@ -38,12 +59,17 @@ export const ModelResourceStatus = {
     draining: "draining",
     retired: "retired",
 };
-export const ModelMeterTokenKind = {
+export const ModelMeterKind = {
     input: "input",
     output: "output",
     cache_read: "cache_read",
     cache_write: "cache_write",
     reasoning: "reasoning",
+    images: "images",
+    audio_characters: "audio_characters",
+    audio_seconds: "audio_seconds",
+    video_seconds: "video_seconds",
+    rerank_units: "rerank_units",
 };
 export const RequestResourceStatus = {
     in_flight: "in_flight",

package/dist/canopy/v1/generated/schemas.zod.d.ts

@@ -245,7 +245,7 @@ export declare const ListRequestsQueryParams: zod.ZodObject<{
  * @summary Get a single request record
  */
 export declare const GetRequestParams: zod.ZodObject<{
-    requestId: zod.ZodUUID;
+    requestId: zod.ZodString;
 }, zod.z.core.$strict>;
 /**
  * Purchases the model platform service for this project. The service itself has no charge; requests are metered under it by the tokens they use. It takes no billing choice. Returns the service as `pending` with its Checkout Session; it becomes `active` once the order is accepted, which with automatic checkout and nothing to pay happens without further action.

package/dist/canopy/v1/generated/schemas.zod.js

@@ -242,7 +242,9 @@ export const ListRequestsQueryParams = zod.strictObject({
  * @summary Get a single request record
  */
 export const GetRequestParams = zod.strictObject({
-    requestId: zod.uuid(),
+    requestId: zod
+        .string()
+        .describe("A typed request id such as `req_01j...`; a bare UUID is also accepted."),
 });
 /**
  * Purchases the model platform service for this project. The service itself has no charge; requests are metered under it by the tokens they use. It takes no billing choice. Returns the service as `pending` with its Checkout Session; it becomes `active` once the order is accepted, which with automatic checkout and nothing to pay happens without further action.

package/dist/canopy/v1/generated/validators/aPIKeyUsageListResponseBody.zod.d.ts

@@ -47,6 +47,15 @@ export declare const APIKeyUsageListResponseBody: zod.ZodObject<{
         input_tokens: zod.ZodInt;
         output_tokens: zod.ZodInt;
         reasoning_tokens: zod.ZodInt;
+        media: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
+            images: zod.ZodInt;
+            audio_characters: zod.ZodInt;
+            audio_seconds: zod.ZodInt;
+            video_seconds: zod.ZodInt;
+            size: zod.ZodNullable<zod.ZodString>;
+            quality: zod.ZodNullable<zod.ZodString>;
+            resolution: zod.ZodNullable<zod.ZodString>;
+        }, zod.z.core.$strict>, zod.ZodNull]>>;
         requests: zod.ZodInt;
     }, zod.z.core.$strict>>;
 }, zod.z.core.$strict>;

package/dist/canopy/v1/generated/validators/aPIKeyUsageResource.zod.d.ts

@@ -46,6 +46,15 @@ export declare const APIKeyUsageResource: zod.ZodObject<{
     input_tokens: zod.ZodInt;
     output_tokens: zod.ZodInt;
     reasoning_tokens: zod.ZodInt;
+    media: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
+        images: zod.ZodInt;
+        audio_characters: zod.ZodInt;
+        audio_seconds: zod.ZodInt;
+        video_seconds: zod.ZodInt;
+        size: zod.ZodNullable<zod.ZodString>;
+        quality: zod.ZodNullable<zod.ZodString>;
+        resolution: zod.ZodNullable<zod.ZodString>;
+    }, zod.z.core.$strict>, zod.ZodNull]>>;
     requests: zod.ZodInt;
 }, zod.z.core.$strict>;
 export type APIKeyUsageResource = zod.input<typeof APIKeyUsageResource>;

package/dist/canopy/v1/generated/validators/aPIKeyUsageResource.zod.js

@@ -39,6 +39,7 @@
  * OpenAPI spec version: 1.0.0
  */
 import * as zod from "zod";
+import { MediaUsage } from "./mediaUsage.zod.js";
 export const APIKeyUsageResource = zod.strictObject({
     api_key_id: zod.uuid(),
     cache_read_tokens: zod.int(),
@@ -46,5 +47,9 @@ export const APIKeyUsageResource = zod.strictObject({
     input_tokens: zod.int(),
     output_tokens: zod.int(),
     reasoning_tokens: zod.int(),
+    media: zod
+        .union([MediaUsage, zod.null()])
+        .optional()
+        .describe("Media quantities and their rate dimensions. Null when this range has no media usage."),
     requests: zod.int(),
 });

package/dist/canopy/v1/generated/validators/audioCapabilities.zod.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Canopy API
+ * Canopy model inference, API keys, model catalogue, service enablement and recorded usage.
+ *
+ * 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 names how each model is billed in Billing;
+ * `/v1/models` returns the OpenAI model format with Canopy capabilities and parameter limits.
+ *
+ * ## Authentication
+ *
+ * Every request carries a scoped token; see the `bearerAuth` security scheme.
+ *
+ * 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 serves the same endpoints.
+ *
+ * ## Conventions
+ *
+ * - **The plaintext of an API key is returned once.** The `secret` appears in the response that issues it and is returned by no other endpoint. A key that has been lost has to be revoked and reissued.
+ * - **Disabling and revoking are distinct.** A disabled key may be enabled again at any time, while a revocation is irreversible and is intended for a key that has been exposed. Neither removes the record, and the usage the key accrued remains readable.
+ * - **A usage query must carry a time range**, spanning no more than 31 days, or 400 days for the usage timeline. `from` and `to` carry a timezone offset, which the server does not infer.
+ * - **The request and response bodies do not appear in the ledger.** They are not recorded. Quote the `upstream_request_id` from the response when reporting a problem.
+ * - **Usage may be estimated.** The upstream provider does not report usage on every request. Where it does not, `usage_source` is `estimated` and the figures are derived from the character classes of the payload, to within roughly fifteen per cent.
+ * - **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 Billing holds for each model's `billing`.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export declare const audioCapabilitiesMaxInputBytesMin = 0;
+export declare const AudioCapabilities: zod.ZodObject<{
+    voices: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+    formats: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+    response_formats: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+    max_input_bytes: zod.ZodNullable<zod.ZodInt>;
+    supports_stream: zod.ZodNullable<zod.ZodBoolean>;
+}, zod.z.core.$strict>;
+export type AudioCapabilities = zod.input<typeof AudioCapabilities>;
+export type AudioCapabilitiesOutput = zod.output<typeof AudioCapabilities>;

package/dist/canopy/v1/generated/validators/audioCapabilities.zod.js

@@ -0,0 +1,67 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Canopy API
+ * Canopy model inference, API keys, model catalogue, service enablement and recorded usage.
+ *
+ * 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 names how each model is billed in Billing;
+ * `/v1/models` returns the OpenAI model format with Canopy capabilities and parameter limits.
+ *
+ * ## Authentication
+ *
+ * Every request carries a scoped token; see the `bearerAuth` security scheme.
+ *
+ * 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 serves the same endpoints.
+ *
+ * ## Conventions
+ *
+ * - **The plaintext of an API key is returned once.** The `secret` appears in the response that issues it and is returned by no other endpoint. A key that has been lost has to be revoked and reissued.
+ * - **Disabling and revoking are distinct.** A disabled key may be enabled again at any time, while a revocation is irreversible and is intended for a key that has been exposed. Neither removes the record, and the usage the key accrued remains readable.
+ * - **A usage query must carry a time range**, spanning no more than 31 days, or 400 days for the usage timeline. `from` and `to` carry a timezone offset, which the server does not infer.
+ * - **The request and response bodies do not appear in the ledger.** They are not recorded. Quote the `upstream_request_id` from the response when reporting a problem.
+ * - **Usage may be estimated.** The upstream provider does not report usage on every request. Where it does not, `usage_source` is `estimated` and the figures are derived from the character classes of the payload, to within roughly fifteen per cent.
+ * - **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 Billing holds for each model's `billing`.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export const audioCapabilitiesMaxInputBytesMin = 0;
+export const AudioCapabilities = zod
+    .strictObject({
+    voices: zod
+        .array(zod.string())
+        .nullable()
+        .describe("Voices the speech endpoint accepts. Empty for transcription endpoints. Null means unknown."),
+    formats: zod
+        .array(zod.string())
+        .nullable()
+        .describe("Audio container or codec values the endpoint accepts. Null means unknown."),
+    response_formats: zod
+        .array(zod.string())
+        .nullable()
+        .describe("Response formats the transcription endpoint accepts, such as json or srt. Null means unknown."),
+    max_input_bytes: zod
+        .int()
+        .min(audioCapabilitiesMaxInputBytesMin)
+        .nullable()
+        .describe("The largest upload the endpoint accepts, in bytes. Null means unknown."),
+    supports_stream: zod
+        .boolean()
+        .nullable()
+        .describe("Whether the endpoint can stream its response. Null means unknown."),
+})
+    .describe("The audio parameters this endpoint accepts.");

package/dist/canopy/v1/generated/validators/cursorPageRequestResource.zod.d.ts

@@ -47,7 +47,7 @@ export declare const CursorPageRequestResource: zod.ZodObject<{
         error_code: zod.ZodString;
         finished_at: zod.ZodNullable<zod.z.ZodISODateTime>;
         first_token_at: zod.ZodNullable<zod.z.ZodISODateTime>;
-        id: zod.ZodUUID;
+        id: zod.ZodString;
         input_tokens: zod.ZodInt;
         model_id: zod.ZodString;
         output_tokens: zod.ZodInt;
@@ -73,6 +73,15 @@ export declare const CursorPageRequestResource: zod.ZodObject<{
         reasoning: zod.ZodUnion<readonly [zod.ZodObject<{
             requested: zod.ZodRecord<zod.ZodString, zod.ZodUnknown>;
         }, zod.z.core.$strict>, zod.ZodNull]>;
+        media: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
+            images: zod.ZodInt;
+            audio_characters: zod.ZodInt;
+            audio_seconds: zod.ZodInt;
+            video_seconds: zod.ZodInt;
+            size: zod.ZodNullable<zod.ZodString>;
+            quality: zod.ZodNullable<zod.ZodString>;
+            resolution: zod.ZodNullable<zod.ZodString>;
+        }, zod.z.core.$strict>, zod.ZodNull]>>;
     }, zod.z.core.$strict>>;
     next_cursor: zod.ZodString;
 }, zod.z.core.$strict>;

package/dist/canopy/v1/generated/validators/endpointCapabilities.zod.d.ts

@@ -53,6 +53,43 @@ export declare const EndpointCapabilities: zod.ZodObject<{
         }, zod.z.core.$strict>>;
         summary: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
     }, zod.z.core.$strict>, zod.ZodNull]>;
+    image: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
+        sizes: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+        qualities: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+        response_formats: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+        max_n: zod.ZodNullable<zod.ZodInt>;
+        supports_stream: zod.ZodNullable<zod.ZodBoolean>;
+    }, zod.z.core.$strict>, zod.ZodNull]>>;
+    audio: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
+        voices: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+        formats: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+        response_formats: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+        max_input_bytes: zod.ZodNullable<zod.ZodInt>;
+        supports_stream: zod.ZodNullable<zod.ZodBoolean>;
+    }, zod.z.core.$strict>, zod.ZodNull]>>;
+    video: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
+        seconds: zod.ZodNullable<zod.ZodArray<zod.ZodInt>>;
+        sizes: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+        resolutions: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+        supports_input_reference: zod.ZodNullable<zod.ZodBoolean>;
+        supports_remix: zod.ZodNullable<zod.ZodBoolean>;
+        supports_characters: zod.ZodNullable<zod.ZodBoolean>;
+    }, zod.z.core.$strict>, zod.ZodNull]>>;
+    parameters: zod.ZodOptional<zod.ZodNullable<zod.ZodArray<zod.ZodObject<{
+        name: zod.ZodString;
+        description: zod.ZodString;
+        type: zod.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            object: "object";
+            array: "array";
+            integer: "integer";
+        }>;
+        required: zod.ZodBoolean;
+        default: zod.ZodOptional<zod.ZodUnknown>;
+        values: zod.ZodOptional<zod.ZodNullable<zod.ZodArray<zod.ZodString>>>;
+    }, zod.z.core.$strict>>>>;
 }, zod.z.core.$strict>;
 export type EndpointCapabilities = zod.input<typeof EndpointCapabilities>;
 export type EndpointCapabilitiesOutput = zod.output<typeof EndpointCapabilities>;