@leaflow/sdk 0.141.0 → 0.143.0

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

@@ -0,0 +1,50 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * 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.
+ *
+ * Management operations use `/api/v1`. The management model catalogue includes pricing;
+ * `/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 supports OpenAI, Anthropic and Gemini request formats.
+ *
+ * ## 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. `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 stated in each model's `pricing`.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export declare const EndpointCapabilities: zod.ZodObject<{
+    function_calling: zod.ZodNullable<zod.ZodBoolean>;
+    structured_output: zod.ZodNullable<zod.ZodBoolean>;
+    reasoning: zod.ZodUnion<readonly [zod.ZodObject<{
+        supported: zod.ZodBoolean;
+        effort_levels: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+        default_effort: zod.ZodNullable<zod.ZodString>;
+        modes: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+        budget_tokens: zod.ZodNullable<zod.ZodObject<{
+            min: zod.ZodInt;
+            max: zod.ZodInt;
+        }, zod.z.core.$strict>>;
+        summary: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+    }, zod.z.core.$strict>, zod.ZodNull]>;
+}, zod.z.core.$strict>;
+export type EndpointCapabilities = zod.input<typeof EndpointCapabilities>;
+export type EndpointCapabilitiesOutput = zod.output<typeof EndpointCapabilities>;

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

@@ -0,0 +1,39 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * 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.
+ *
+ * Management operations use `/api/v1`. The management model catalogue includes pricing;
+ * `/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 supports OpenAI, Anthropic and Gemini request formats.
+ *
+ * ## 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. `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 stated in each model's `pricing`.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+import { ReasoningCapabilities } from "./reasoningCapabilities.zod.js";
+export const EndpointCapabilities = zod.strictObject({
+    function_calling: zod.boolean().nullable(),
+    structured_output: zod.boolean().nullable(),
+    reasoning: zod.union([ReasoningCapabilities, zod.null()]),
+});

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

@@ -41,5 +41,5 @@ export const Entitlement = zod.strictObject({
     expires_at: zod.iso
         .datetime({ offset: true })
         .nullish()
-        .describe("When the subscription providing it ends. Absent for a metered subscription, which\nhas no end date."),
+        .describe("When the providing subscription ends. Absent for a metered subscription."),
 });

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

@@ -35,10 +35,10 @@ import { Money } from "./money.zod.js";
 export const Funds = zod
     .strictObject({
     available_balance_amount: Money.describe("Spendable balance after pending returns."),
-    usable_credit_amount: Money.describe("Currently effective credits eligible for the quoted purchases or postpaid usage. Each grant is counted once."),
-    restricted_credit_amount: Money.describe("Currently effective credits that cannot fund any quoted purchase or postpaid target. Unused eligible credits are not restricted."),
-    required_balance_amount: Money.describe("Minimum spendable balance needed after eligible credits, covering immediate charges and every new postpaid admission requirement."),
+    usable_credit_amount: Money.describe("Currently effective credits eligible for the quoted purchases or metered usage. Each grant is counted once."),
+    restricted_credit_amount: Money.describe("Currently effective credits that cannot fund any quoted purchase or metered target. Unused eligible credits are not restricted."),
+    required_balance_amount: Money.describe("Minimum spendable balance needed after eligible credits, covering immediate charges and every new metered purchase's admission requirement."),
     balance_shortfall_amount: Money.describe("Additional balance needed now. Zero means account funds satisfy this quote. No funds are reserved."),
     required_top_up_amount: Money.describe("Minimum recharge that covers the shortfall, respecting the currency minimum recharge and currency precision. Zero when no additional balance is needed."),
 })
-    .describe("Account funding for this purchase, calculated by Billing. Amounts use the enclosing response currency.\nCredit eligibility and all purchase requirements are already evaluated. Nothing is charged or reserved.\nA prepaid purchase may instead use an online payment method.\n");
+    .describe("Account funding for this purchase, calculated by Billing. Amounts use the enclosing response currency.\nCredit eligibility and all purchase requirements are already evaluated. Nothing is charged or reserved.\nA licensed purchase may instead be paid with an online payment method.\n");

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

@@ -55,7 +55,6 @@ export declare const Invoice: zod.ZodObject<{
         open: "open";
         draft: "draft";
         paid: "paid";
-        uncollectible: "uncollectible";
     }>;
     subtotal: zod.ZodOptional<zod.ZodString>;
     discount_amount: zod.ZodOptional<zod.ZodString>;

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

@@ -38,7 +38,7 @@ export const Invoice = zod.strictObject({
     void_requested_at: zod.iso
         .datetime({ offset: true })
         .optional()
-        .describe("Collection has been stopped; any accepted return obligations are completed before final voiding."),
+        .describe("Collection has stopped; accepted return obligations are completed."),
     due_at: zod.iso.datetime({ offset: true }).optional(),
     amount_refunded: zod.string().optional(),
     tax_items: zod.array(TaxItem),
@@ -50,24 +50,24 @@ export const Invoice = zod.strictObject({
     subtotal: Money.optional().describe("Sum of the line amounts before discounts. Where prices include tax, the tax contained in\neach line's discounted amount is taken out here, so that total = subtotal -\ndiscount_amount + tax_amount always holds."),
     discount_amount: Money.optional().describe("Sum of the line discounts, taken off before tax."),
     tax_amount: Money.optional(),
-    credit_applied: Money.optional().describe("Successful credit-grant payments included in amount_paid. Does not reduce the receivable or tax base."),
-    total: Money.describe("Subtotal less discount plus tax. Balance and credit grants are payment sources, not reductions of the receivable."),
+    credit_applied: Money.optional().describe("Successful credit-grant payments, included in amount_paid; they do not reduce the receivable or tax base."),
+    total: Money.describe("Subtotal less discount plus tax. Balance and credit grants pay it; they do not reduce it."),
     amount_paid: Money.optional(),
-    pre_payment_credit_notes_amount: Money.describe("Issued, non-void credit notes that reduced unpaid receivables. Does not rewrite the original invoice total."),
-    post_payment_credit_notes_amount: Money.describe("Issued credit notes against payments already received. This is a return obligation, not evidence of completed refunds."),
-    amount_due: Money.describe("What is still collectible after unpaid credit notes and successful payments; never below zero. A draft has none; its total is the base price, and a payment preview shows what paying it would collect. A paid or void invoice has none either."),
+    pre_payment_credit_notes_amount: Money.describe("Issued credit notes that reduced unpaid receivables; the original invoice total is unchanged."),
+    post_payment_credit_notes_amount: Money.describe("Issued credit notes against payments already received; their refunds may not have completed."),
+    amount_due: Money.describe("What is still collectible after unpaid credit notes and successful payments; never below zero. Zero for a draft, whose total is the base price, and for a paid or void invoice."),
     period_start: zod.iso.datetime({ offset: true }).nullish(),
     period_end: zod.iso.datetime({ offset: true }).nullish().describe("Exclusive."),
     customer_name: zod
         .string()
         .optional()
-        .describe("Who this was billed to, as recorded when the invoice was issued. Later changes to\nthe account do not alter it."),
+        .describe("The billing details recorded when the invoice was issued."),
     customer_email: zod.string().optional(),
     customer_tax_id: zod.string().optional(),
     customer_tax_exempt: zod
         .enum(["none", "exempt", "reverse"])
         .optional()
-        .describe("How tax applied to the customer when the invoice was issued. `reverse` means no tax was\ncharged because the customer accounts for it under the reverse-charge mechanism."),
+        .describe("How tax applied to the customer when the invoice was issued; `reverse` means no tax was charged under the reverse-charge mechanism."),
     customer_address_line1: zod.string().optional(),
     customer_address_line2: zod.string().optional(),
     customer_address_city: zod.string().optional(),

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

@@ -61,6 +61,7 @@ export declare const InvoiceItem: zod.ZodObject<{
     currency: zod.ZodString;
     period_start: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
     period_end: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
+    dimensions: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodString>>;
     prorations: zod.ZodOptional<zod.ZodArray<zod.ZodObject<{
         credited_invoice_item_id: zod.ZodUUID;
         description: zod.ZodString;

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

@@ -53,11 +53,9 @@ export const InvoiceItem = zod.strictObject({
     project: zod
         .union([NamedIdentity, zod.null()])
         .optional()
-        .describe("The project the charge was for and its current name, for display. Absent when the line is\nnot for a project, and when the project no longer exists or its details cannot be read at\nthe moment; `project_id` still identifies it then."),
+        .describe("The project the charge was for and its current name. Absent when the line has no project or the project cannot be read; `project_id` still identifies it."),
     resource_id: zod.string().optional(),
-    description: zod
-        .string()
-        .describe("The wording as recorded when the invoice was issued. It is not re-translated\nafterwards, so that an invoice continues to read as it did when it was sent."),
+    description: zod.string().describe("The line's wording as recorded when the invoice was issued."),
     unit: zod.string().optional(),
     quantity: zod.string().optional(),
     deducted_quantity: zod
@@ -69,6 +67,10 @@ export const InvoiceItem = zod.strictObject({
     currency: zod.string(),
     period_start: zod.iso.datetime({ offset: true }).nullish(),
     period_end: zod.iso.datetime({ offset: true }).nullish(),
+    dimensions: zod
+        .record(zod.string(), zod.string())
+        .optional()
+        .describe("For a usage line, the values of its meter's presentation dimensions, such as the model and token kind. Empty for other lines."),
     prorations: zod
         .array(InvoiceItemProration)
         .optional()

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

@@ -62,6 +62,7 @@ export declare const InvoiceItemList: zod.ZodObject<{
         currency: zod.ZodString;
         period_start: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
         period_end: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
+        dimensions: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodString>>;
         prorations: zod.ZodOptional<zod.ZodArray<zod.ZodObject<{
             credited_invoice_item_id: zod.ZodUUID;
             description: zod.ZodString;

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

@@ -37,9 +37,7 @@ export const InvoiceItemProration = zod
     credited_invoice_item_id: zod
         .uuid()
         .describe("The earlier invoice line that paid for the period."),
-    description: zod
-        .string()
-        .describe("The wording of the earlier invoice line as recorded when this invoice was created."),
+    description: zod.string().describe("The earlier invoice line's wording as recorded."),
     period_start: zod.iso.datetime({ offset: true }),
     period_end: zod.iso.datetime({ offset: true }).describe("Exclusive."),
     remaining_amount: Money.describe("Before tax and discounts, the new configuration for the period."),

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

@@ -56,7 +56,6 @@ export declare const InvoiceList: zod.ZodObject<{
             open: "open";
             draft: "draft";
             paid: "paid";
-            uncollectible: "uncollectible";
         }>;
         subtotal: zod.ZodOptional<zod.ZodString>;
         discount_amount: zod.ZodOptional<zod.ZodString>;

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

@@ -36,7 +36,6 @@ export declare const InvoiceStatus: zod.ZodEnum<{
     open: "open";
     draft: "draft";
     paid: "paid";
-    uncollectible: "uncollectible";
 }>;
 export type InvoiceStatus = zod.input<typeof InvoiceStatus>;
 export type InvoiceStatusOutput = zod.output<typeof InvoiceStatus>;

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

@@ -32,5 +32,5 @@
  */
 import * as zod from "zod";
 export const InvoiceStatus = zod
-    .enum(["draft", "open", "paid", "void", "uncollectible"])
-    .describe("A draft is not yet issued. The draft invoice of an order shows base prices until it is paid, when\nthe discount is applied and it is issued; other drafts are private to administrators.\nAn issued invoice is open until settled; a zero-total issued invoice is immediately paid.\nUnbilled usage remains separate from invoices until it is invoiced.\nA refund does not change the status: a paid invoice stays paid, with the refunded part in\namount_refunded. void means collection has stopped and any funds received have been returned.");
+    .enum(["draft", "open", "paid", "void"])
+    .describe("`draft`: not yet issued; an order's draft invoice shows base prices until it is paid, when the discount is applied and it is issued. Other drafts are visible only to operators. `open`: issued and not yet settled; a zero-total invoice is paid at once. `paid` stays paid after a refund, with the refunded part in amount_refunded. `void`: collection has stopped and any funds received have been returned. Usage not yet invoiced is not on any invoice.");

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

@@ -41,7 +41,6 @@ export declare const InvoiceSummary: zod.ZodObject<{
         open: "open";
         draft: "draft";
         paid: "paid";
-        uncollectible: "uncollectible";
     }>;
     subtotal: zod.ZodString;
     discount_amount: zod.ZodString;

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

@@ -47,8 +47,8 @@ export const InvoiceSummary = zod
     tax_amount: zod.string(),
     total: zod.string(),
     amount_paid: zod.string(),
-    pre_payment_credit_notes_amount: Money.describe("Issued, non-void credit notes that reduced unpaid receivables. Does not rewrite the original invoice total."),
-    post_payment_credit_notes_amount: Money.describe("Issued credit notes against payments already received. This is a return obligation, not evidence of completed refunds."),
+    pre_payment_credit_notes_amount: Money.describe("Issued credit notes that reduced unpaid receivables; the original invoice total is unchanged."),
+    post_payment_credit_notes_amount: Money.describe("Issued credit notes against payments already received; their refunds may not have completed."),
     amount_due: zod
         .string()
         .regex(invoiceSummaryAmountDueRegExp)
@@ -56,4 +56,4 @@ export const InvoiceSummary = zod
     amount_refunded: zod.string(),
     due_at: zod.iso.datetime({ offset: true }).optional(),
 })
-    .describe("Purchase-related invoice amounts, without account contact details or payment methods. Every order\nhas an invoice from placement. A draft shows base prices until it is paid, when the discount is\napplied and it is issued; a zero-total invoice is issued and paid at placement whatever the\ncheckout mode. Neither establishes acceptance or delivery.");
+    .describe("An order's invoice amounts, without contact details or payment methods. A draft shows base prices until it is paid, when the discount is applied and it is issued; a zero-total invoice is issued and paid at placement.");

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

@@ -0,0 +1,43 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * 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.
+ *
+ * Management operations use `/api/v1`. The management model catalogue includes pricing;
+ * `/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 supports OpenAI, Anthropic and Gemini request formats.
+ *
+ * ## 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. `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 stated in each model's `pricing`.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export declare const Modality: zod.ZodEnum<{
+    file: "file";
+    text: "text";
+    image: "image";
+    audio: "audio";
+    video: "video";
+    embedding: "embedding";
+}>;
+export type Modality = zod.input<typeof Modality>;
+export type ModalityOutput = zod.output<typeof Modality>;

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

@@ -0,0 +1,34 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * 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.
+ *
+ * Management operations use `/api/v1`. The management model catalogue includes pricing;
+ * `/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 supports OpenAI, Anthropic and Gemini request formats.
+ *
+ * ## 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. `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 stated in each model's `pricing`.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export const Modality = zod.enum(["text", "image", "audio", "video", "file", "embedding"]);

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

@@ -39,10 +39,50 @@ export declare const Model: zod.ZodObject<{
     display_name: zod.ZodString;
     context_length: zod.ZodInt;
     max_output_tokens: zod.ZodInt;
-    supports_vision: zod.ZodBoolean;
-    supports_tools: zod.ZodBoolean;
-    supports_reasoning: zod.ZodBoolean;
-    reasoning_tiers: zod.ZodArray<zod.ZodString>;
+    developer: zod.ZodString;
+    description: zod.ZodString;
+    input_modalities: zod.ZodNullable<zod.ZodArray<zod.ZodEnum<{
+        file: "file";
+        text: "text";
+        image: "image";
+        audio: "audio";
+        video: "video";
+        embedding: "embedding";
+    }>>>;
+    output_modalities: zod.ZodNullable<zod.ZodArray<zod.ZodEnum<{
+        file: "file";
+        text: "text";
+        image: "image";
+        audio: "audio";
+        video: "video";
+        embedding: "embedding";
+    }>>>;
+    capabilities: zod.ZodRecord<zod.ZodString, zod.ZodObject<{
+        function_calling: zod.ZodNullable<zod.ZodBoolean>;
+        structured_output: zod.ZodNullable<zod.ZodBoolean>;
+        reasoning: zod.ZodUnion<readonly [zod.ZodObject<{
+            supported: zod.ZodBoolean;
+            effort_levels: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+            default_effort: zod.ZodNullable<zod.ZodString>;
+            modes: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+            budget_tokens: zod.ZodNullable<zod.ZodObject<{
+                min: zod.ZodInt;
+                max: zod.ZodInt;
+            }, zod.z.core.$strict>>;
+            summary: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+        }, zod.z.core.$strict>, zod.ZodNull]>;
+    }, zod.z.core.$strict>>;
+    supported_endpoints: zod.ZodArray<zod.ZodEnum<{
+        "/v1/chat/completions": "/v1/chat/completions";
+        "/v1/responses": "/v1/responses";
+        "/v1/embeddings": "/v1/embeddings";
+        "/v1/images/generations": "/v1/images/generations";
+        "/v1/images/edits": "/v1/images/edits";
+        "/v1/audio/transcriptions": "/v1/audio/transcriptions";
+        "/v1/audio/translations": "/v1/audio/translations";
+        "/v1/audio/speech": "/v1/audio/speech";
+        "/v1/realtime": "/v1/realtime";
+    }>>;
 }, zod.z.core.$strict>;
 export type Model = zod.input<typeof Model>;
 export type ModelOutput = zod.output<typeof Model>;

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

@@ -31,6 +31,9 @@
  * OpenAPI spec version: 1.0.0
  */
 import * as zod from "zod";
+import { Modality } from "./modality.zod.js";
+import { ModelCapabilities } from "./modelCapabilities.zod.js";
+import { ModelEndpoint } from "./modelEndpoint.zod.js";
 export const Model = zod.strictObject({
     id: zod.string(),
     object: zod.literal("model"),
@@ -39,8 +42,20 @@ export const Model = zod.strictObject({
     display_name: zod.string(),
     context_length: zod.int(),
     max_output_tokens: zod.int(),
-    supports_vision: zod.boolean(),
-    supports_tools: zod.boolean(),
-    supports_reasoning: zod.boolean(),
-    reasoning_tiers: zod.array(zod.string()),
+    developer: zod
+        .string()
+        .describe("The model developer; not the upstream provider or model family."),
+    description: zod.string(),
+    input_modalities: zod
+        .array(Modality)
+        .nullable()
+        .describe("Accepted input modalities. Null means unknown."),
+    output_modalities: zod
+        .array(Modality)
+        .nullable()
+        .describe("Produced output modalities. Image input does not imply image generation."),
+    capabilities: ModelCapabilities,
+    supported_endpoints: zod
+        .array(ModelEndpoint)
+        .describe("Explicitly supported API endpoints. Requests to any other endpoint are rejected before upstream admission."),
 });

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

@@ -0,0 +1,50 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * 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.
+ *
+ * Management operations use `/api/v1`. The management model catalogue includes pricing;
+ * `/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 supports OpenAI, Anthropic and Gemini request formats.
+ *
+ * ## 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. `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 stated in each model's `pricing`.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export declare const ModelCapabilities: zod.ZodRecord<zod.ZodString, zod.ZodObject<{
+    function_calling: zod.ZodNullable<zod.ZodBoolean>;
+    structured_output: zod.ZodNullable<zod.ZodBoolean>;
+    reasoning: zod.ZodUnion<readonly [zod.ZodObject<{
+        supported: zod.ZodBoolean;
+        effort_levels: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+        default_effort: zod.ZodNullable<zod.ZodString>;
+        modes: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+        budget_tokens: zod.ZodNullable<zod.ZodObject<{
+            min: zod.ZodInt;
+            max: zod.ZodInt;
+        }, zod.z.core.$strict>>;
+        summary: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+    }, zod.z.core.$strict>, zod.ZodNull]>;
+}, zod.z.core.$strict>>;
+export type ModelCapabilities = zod.input<typeof ModelCapabilities>;
+export type ModelCapabilitiesOutput = zod.output<typeof ModelCapabilities>;

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

@@ -0,0 +1,37 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * 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.
+ *
+ * Management operations use `/api/v1`. The management model catalogue includes pricing;
+ * `/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 supports OpenAI, Anthropic and Gemini request formats.
+ *
+ * ## 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. `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 stated in each model's `pricing`.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+import { EndpointCapabilities } from "./endpointCapabilities.zod.js";
+export const ModelCapabilities = zod
+    .record(zod.string(), EndpointCapabilities)
+    .describe("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.");

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

@@ -0,0 +1,46 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * 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.
+ *
+ * Management operations use `/api/v1`. The management model catalogue includes pricing;
+ * `/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 supports OpenAI, Anthropic and Gemini request formats.
+ *
+ * ## 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. `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 stated in each model's `pricing`.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export declare const ModelEndpoint: zod.ZodEnum<{
+    "/v1/chat/completions": "/v1/chat/completions";
+    "/v1/responses": "/v1/responses";
+    "/v1/embeddings": "/v1/embeddings";
+    "/v1/images/generations": "/v1/images/generations";
+    "/v1/images/edits": "/v1/images/edits";
+    "/v1/audio/transcriptions": "/v1/audio/transcriptions";
+    "/v1/audio/translations": "/v1/audio/translations";
+    "/v1/audio/speech": "/v1/audio/speech";
+    "/v1/realtime": "/v1/realtime";
+}>;
+export type ModelEndpoint = zod.input<typeof ModelEndpoint>;
+export type ModelEndpointOutput = zod.output<typeof ModelEndpoint>;