@leaflow/sdk 0.184.0 → 0.186.0

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

@@ -647,9 +647,16 @@ export interface RequestResource {
      * @nullable
      */
     api_key_id: string | null;
-    /** The portion served from the upstream prefix cache, which costs an order of magnitude less than ordinary input */
-    cache_read_tokens: number;
-    cache_write_tokens: number;
+    /**
+     * The portion served from the upstream prefix cache, which costs an order of magnitude less than ordinary input. Null on a request billed on a non-token meter.
+     * @nullable
+     */
+    cache_read_tokens: number | null;
+    /**
+     * Tokens written to the provider's prompt cache. Null on a request billed on a non-token meter.
+     * @nullable
+     */
+    cache_write_tokens: number | null;
     /** The error code on failure. Empty on success */
     error_code: string;
     /** @nullable */
@@ -658,13 +665,25 @@ export interface RequestResource {
     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;
+    /**
+     * Input tokens the provider billed for. Null on a request billed on a non-token meter, such as image generation, video generation or speech.
+     * @nullable
+     */
+    input_tokens: number | null;
     /** The model named in the request */
     model_id: string;
     /** The request operation, such as video_create or video_retrieve. Absent for historical requests where it was not recorded. */
     operation?: string;
-    output_tokens: number;
-    reasoning_tokens: number;
+    /**
+     * Output tokens the provider billed for. Null on a request billed on a non-token meter, such as image generation, video generation or speech.
+     * @nullable
+     */
+    output_tokens: number | null;
+    /**
+     * Reasoning tokens the provider reports separately. Null on a request billed on a non-token meter.
+     * @nullable
+     */
+    reasoning_tokens: number | null;
     retries: number;
     /**
      * Who made the request. `api_key` means one of the project's API keys and `project_token` a project access token on the OpenAI-compatible endpoints; any other value names the Leaflow service that made it on the project's behalf, such as `assistant`, and more services may appear. Null for requests recorded before sources were tracked
@@ -693,11 +712,31 @@ export interface CursorPageRequestResource {
 }
 export interface APIKeyUsageResource {
     api_key_id: string;
-    cache_read_tokens: number;
-    cache_write_tokens: number;
-    input_tokens: number;
-    output_tokens: number;
-    reasoning_tokens: number;
+    /**
+     * Null when this range has no token usage.
+     * @nullable
+     */
+    cache_read_tokens: number | null;
+    /**
+     * Null when this range has no token usage.
+     * @nullable
+     */
+    cache_write_tokens: number | null;
+    /**
+     * Null when this range has no token usage.
+     * @nullable
+     */
+    input_tokens: number | null;
+    /**
+     * Null when this range has no token usage.
+     * @nullable
+     */
+    output_tokens: number | null;
+    /**
+     * Null when this range has no token usage.
+     * @nullable
+     */
+    reasoning_tokens: number | null;
     /** Media quantities and their rate dimensions. Null when this range has no media usage. */
     media?: MediaUsage | null;
     requests: number;
@@ -706,12 +745,32 @@ export interface APIKeyUsageListResponseBody {
     items: APIKeyUsageResource[];
 }
 export interface ModelUsageResource {
-    cache_read_tokens: number;
-    cache_write_tokens: number;
-    input_tokens: number;
+    /**
+     * Null when this range has no token usage.
+     * @nullable
+     */
+    cache_read_tokens: number | null;
+    /**
+     * Null when this range has no token usage.
+     * @nullable
+     */
+    cache_write_tokens: number | null;
+    /**
+     * Null when this range has no token usage.
+     * @nullable
+     */
+    input_tokens: number | null;
     model_id: string;
-    output_tokens: number;
-    reasoning_tokens: number;
+    /**
+     * Null when this range has no token usage.
+     * @nullable
+     */
+    output_tokens: number | null;
+    /**
+     * Null when this range has no token usage.
+     * @nullable
+     */
+    reasoning_tokens: number | null;
     /** Media quantities and their rate dimensions. Null when this range has no media usage. */
     media?: MediaUsage | null;
     requests: number;
@@ -720,23 +779,63 @@ export interface ModelUsageListResponseBody {
     items: ModelUsageResource[];
 }
 export interface TotalsResource {
-    cache_read_tokens: number;
-    cache_write_tokens: number;
-    input_tokens: number;
-    output_tokens: number;
-    reasoning_tokens: number;
+    /**
+     * Null when this range has no token usage.
+     * @nullable
+     */
+    cache_read_tokens: number | null;
+    /**
+     * Null when this range has no token usage.
+     * @nullable
+     */
+    cache_write_tokens: number | null;
+    /**
+     * Null when this range has no token usage.
+     * @nullable
+     */
+    input_tokens: number | null;
+    /**
+     * Null when this range has no token usage.
+     * @nullable
+     */
+    output_tokens: number | null;
+    /**
+     * Null when this range has no token usage.
+     * @nullable
+     */
+    reasoning_tokens: number | null;
     /** Media quantities and their rate dimensions. Null when this range has no media usage. */
     media?: MediaUsage | null;
     requests: number;
 }
 export interface UsageBucketResource {
-    cache_read_tokens: number;
-    cache_write_tokens: number;
+    /**
+     * Null when this range has no token usage.
+     * @nullable
+     */
+    cache_read_tokens: number | null;
+    /**
+     * Null when this range has no token usage.
+     * @nullable
+     */
+    cache_write_tokens: number | null;
     /** Start of the bucket, inclusive */
     from: string;
-    input_tokens: number;
-    output_tokens: number;
-    reasoning_tokens: number;
+    /**
+     * Null when this range has no token usage.
+     * @nullable
+     */
+    input_tokens: number | null;
+    /**
+     * Null when this range has no token usage.
+     * @nullable
+     */
+    output_tokens: number | null;
+    /**
+     * Null when this range has no token usage.
+     * @nullable
+     */
+    reasoning_tokens: number | null;
     /** Media quantities and their rate dimensions. Null when this range has no media usage. */
     media?: MediaUsage | null;
     requests: number;

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

@@ -42,11 +42,11 @@ import * as zod from "zod";
 export declare const APIKeyUsageListResponseBody: zod.ZodObject<{
     items: zod.ZodArray<zod.ZodObject<{
         api_key_id: zod.ZodUUID;
-        cache_read_tokens: zod.ZodInt;
-        cache_write_tokens: zod.ZodInt;
-        input_tokens: zod.ZodInt;
-        output_tokens: zod.ZodInt;
-        reasoning_tokens: zod.ZodInt;
+        cache_read_tokens: zod.ZodNullable<zod.ZodInt>;
+        cache_write_tokens: zod.ZodNullable<zod.ZodInt>;
+        input_tokens: zod.ZodNullable<zod.ZodInt>;
+        output_tokens: zod.ZodNullable<zod.ZodInt>;
+        reasoning_tokens: zod.ZodNullable<zod.ZodInt>;
         media: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
             images: zod.ZodInt;
             audio_characters: zod.ZodInt;

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

@@ -41,11 +41,11 @@
 import * as zod from "zod";
 export declare const APIKeyUsageResource: zod.ZodObject<{
     api_key_id: zod.ZodUUID;
-    cache_read_tokens: zod.ZodInt;
-    cache_write_tokens: zod.ZodInt;
-    input_tokens: zod.ZodInt;
-    output_tokens: zod.ZodInt;
-    reasoning_tokens: zod.ZodInt;
+    cache_read_tokens: zod.ZodNullable<zod.ZodInt>;
+    cache_write_tokens: zod.ZodNullable<zod.ZodInt>;
+    input_tokens: zod.ZodNullable<zod.ZodInt>;
+    output_tokens: zod.ZodNullable<zod.ZodInt>;
+    reasoning_tokens: zod.ZodNullable<zod.ZodInt>;
     media: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
         images: zod.ZodInt;
         audio_characters: zod.ZodInt;

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

@@ -42,11 +42,11 @@ 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(),
-    cache_write_tokens: zod.int(),
-    input_tokens: zod.int(),
-    output_tokens: zod.int(),
-    reasoning_tokens: zod.int(),
+    cache_read_tokens: zod.int().nullable().describe("Null when this range has no token usage."),
+    cache_write_tokens: zod.int().nullable().describe("Null when this range has no token usage."),
+    input_tokens: zod.int().nullable().describe("Null when this range has no token usage."),
+    output_tokens: zod.int().nullable().describe("Null when this range has no token usage."),
+    reasoning_tokens: zod.int().nullable().describe("Null when this range has no token usage."),
     media: zod
         .union([MediaUsage, zod.null()])
         .optional()

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

@@ -42,17 +42,17 @@ import * as zod from "zod";
 export declare const CursorPageRequestResource: zod.ZodObject<{
     items: zod.ZodArray<zod.ZodObject<{
         api_key_id: zod.ZodNullable<zod.ZodUUID>;
-        cache_read_tokens: zod.ZodInt;
-        cache_write_tokens: zod.ZodInt;
+        cache_read_tokens: zod.ZodNullable<zod.ZodInt>;
+        cache_write_tokens: zod.ZodNullable<zod.ZodInt>;
         error_code: zod.ZodString;
         finished_at: zod.ZodNullable<zod.z.ZodISODateTime>;
         first_token_at: zod.ZodNullable<zod.z.ZodISODateTime>;
         id: zod.ZodString;
-        input_tokens: zod.ZodInt;
+        input_tokens: zod.ZodNullable<zod.ZodInt>;
         model_id: zod.ZodString;
         operation: zod.ZodOptional<zod.ZodString>;
-        output_tokens: zod.ZodInt;
-        reasoning_tokens: zod.ZodInt;
+        output_tokens: zod.ZodNullable<zod.ZodInt>;
+        reasoning_tokens: zod.ZodNullable<zod.ZodInt>;
         retries: zod.ZodInt;
         source: zod.ZodNullable<zod.ZodString>;
         started_at: zod.z.ZodISODateTime;

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

@@ -41,12 +41,12 @@
 import * as zod from "zod";
 export declare const ModelUsageListResponseBody: zod.ZodObject<{
     items: zod.ZodArray<zod.ZodObject<{
-        cache_read_tokens: zod.ZodInt;
-        cache_write_tokens: zod.ZodInt;
-        input_tokens: zod.ZodInt;
+        cache_read_tokens: zod.ZodNullable<zod.ZodInt>;
+        cache_write_tokens: zod.ZodNullable<zod.ZodInt>;
+        input_tokens: zod.ZodNullable<zod.ZodInt>;
         model_id: zod.ZodString;
-        output_tokens: zod.ZodInt;
-        reasoning_tokens: zod.ZodInt;
+        output_tokens: zod.ZodNullable<zod.ZodInt>;
+        reasoning_tokens: zod.ZodNullable<zod.ZodInt>;
         media: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
             images: zod.ZodInt;
             audio_characters: zod.ZodInt;

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

@@ -40,12 +40,12 @@
  */
 import * as zod from "zod";
 export declare const ModelUsageResource: zod.ZodObject<{
-    cache_read_tokens: zod.ZodInt;
-    cache_write_tokens: zod.ZodInt;
-    input_tokens: zod.ZodInt;
+    cache_read_tokens: zod.ZodNullable<zod.ZodInt>;
+    cache_write_tokens: zod.ZodNullable<zod.ZodInt>;
+    input_tokens: zod.ZodNullable<zod.ZodInt>;
     model_id: zod.ZodString;
-    output_tokens: zod.ZodInt;
-    reasoning_tokens: zod.ZodInt;
+    output_tokens: zod.ZodNullable<zod.ZodInt>;
+    reasoning_tokens: zod.ZodNullable<zod.ZodInt>;
     media: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
         images: zod.ZodInt;
         audio_characters: zod.ZodInt;

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

@@ -41,12 +41,12 @@
 import * as zod from "zod";
 import { MediaUsage } from "./mediaUsage.zod.js";
 export const ModelUsageResource = zod.strictObject({
-    cache_read_tokens: zod.int(),
-    cache_write_tokens: zod.int(),
-    input_tokens: zod.int(),
+    cache_read_tokens: zod.int().nullable().describe("Null when this range has no token usage."),
+    cache_write_tokens: zod.int().nullable().describe("Null when this range has no token usage."),
+    input_tokens: zod.int().nullable().describe("Null when this range has no token usage."),
     model_id: zod.string(),
-    output_tokens: zod.int(),
-    reasoning_tokens: zod.int(),
+    output_tokens: zod.int().nullable().describe("Null when this range has no token usage."),
+    reasoning_tokens: zod.int().nullable().describe("Null when this range has no token usage."),
     media: zod
         .union([MediaUsage, zod.null()])
         .optional()

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

@@ -42,17 +42,17 @@ import * as zod from "zod";
 export declare const requestResourceSourceMax = 64;
 export declare const RequestResource: zod.ZodObject<{
     api_key_id: zod.ZodNullable<zod.ZodUUID>;
-    cache_read_tokens: zod.ZodInt;
-    cache_write_tokens: zod.ZodInt;
+    cache_read_tokens: zod.ZodNullable<zod.ZodInt>;
+    cache_write_tokens: zod.ZodNullable<zod.ZodInt>;
     error_code: zod.ZodString;
     finished_at: zod.ZodNullable<zod.z.ZodISODateTime>;
     first_token_at: zod.ZodNullable<zod.z.ZodISODateTime>;
     id: zod.ZodString;
-    input_tokens: zod.ZodInt;
+    input_tokens: zod.ZodNullable<zod.ZodInt>;
     model_id: zod.ZodString;
     operation: zod.ZodOptional<zod.ZodString>;
-    output_tokens: zod.ZodInt;
-    reasoning_tokens: zod.ZodInt;
+    output_tokens: zod.ZodNullable<zod.ZodInt>;
+    reasoning_tokens: zod.ZodNullable<zod.ZodInt>;
     retries: zod.ZodInt;
     source: zod.ZodNullable<zod.ZodString>;
     started_at: zod.z.ZodISODateTime;

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

@@ -49,22 +49,35 @@ export const RequestResource = zod.strictObject({
         .describe("Null for a request that did not come through one of the project's API keys."),
     cache_read_tokens: zod
         .int()
-        .describe("The portion served from the upstream prefix cache, which costs an order of magnitude less than ordinary input"),
-    cache_write_tokens: zod.int(),
+        .nullable()
+        .describe("The portion served from the upstream prefix cache, which costs an order of magnitude less than ordinary input. Null on a request billed on a non-token meter."),
+    cache_write_tokens: zod
+        .int()
+        .nullable()
+        .describe("Tokens written to the provider's prompt cache. Null on a request billed on a non-token meter."),
     error_code: zod.string().describe("The error code on failure. Empty on success"),
     finished_at: zod.iso.datetime({ offset: true }).nullable(),
     first_token_at: zod.iso.datetime({ offset: true }).nullable(),
     id: zod
         .string()
         .describe("A typed request id such as `req_01j...`. Legacy rows may still be returned as a bare UUID."),
-    input_tokens: zod.int(),
+    input_tokens: zod
+        .int()
+        .nullable()
+        .describe("Input tokens the provider billed for. Null on a request billed on a non-token meter, such as image generation, video generation or speech."),
     model_id: zod.string().describe("The model named in the request"),
     operation: zod
         .string()
         .optional()
         .describe("The request operation, such as video_create or video_retrieve. Absent for historical requests where it was not recorded."),
-    output_tokens: zod.int(),
-    reasoning_tokens: zod.int(),
+    output_tokens: zod
+        .int()
+        .nullable()
+        .describe("Output tokens the provider billed for. Null on a request billed on a non-token meter, such as image generation, video generation or speech."),
+    reasoning_tokens: zod
+        .int()
+        .nullable()
+        .describe("Reasoning tokens the provider reports separately. Null on a request billed on a non-token meter."),
     retries: zod.int(),
     source: zod
         .string()

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

@@ -40,11 +40,11 @@
  */
 import * as zod from "zod";
 export declare const TotalsResource: zod.ZodObject<{
-    cache_read_tokens: zod.ZodInt;
-    cache_write_tokens: zod.ZodInt;
-    input_tokens: zod.ZodInt;
-    output_tokens: zod.ZodInt;
-    reasoning_tokens: zod.ZodInt;
+    cache_read_tokens: zod.ZodNullable<zod.ZodInt>;
+    cache_write_tokens: zod.ZodNullable<zod.ZodInt>;
+    input_tokens: zod.ZodNullable<zod.ZodInt>;
+    output_tokens: zod.ZodNullable<zod.ZodInt>;
+    reasoning_tokens: zod.ZodNullable<zod.ZodInt>;
     media: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
         images: zod.ZodInt;
         audio_characters: zod.ZodInt;

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

@@ -41,11 +41,11 @@
 import * as zod from "zod";
 import { MediaUsage } from "./mediaUsage.zod.js";
 export const TotalsResource = zod.strictObject({
-    cache_read_tokens: zod.int(),
-    cache_write_tokens: zod.int(),
-    input_tokens: zod.int(),
-    output_tokens: zod.int(),
-    reasoning_tokens: zod.int(),
+    cache_read_tokens: zod.int().nullable().describe("Null when this range has no token usage."),
+    cache_write_tokens: zod.int().nullable().describe("Null when this range has no token usage."),
+    input_tokens: zod.int().nullable().describe("Null when this range has no token usage."),
+    output_tokens: zod.int().nullable().describe("Null when this range has no token usage."),
+    reasoning_tokens: zod.int().nullable().describe("Null when this range has no token usage."),
     media: zod
         .union([MediaUsage, zod.null()])
         .optional()

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

@@ -40,12 +40,12 @@
  */
 import * as zod from "zod";
 export declare const UsageBucketResource: zod.ZodObject<{
-    cache_read_tokens: zod.ZodInt;
-    cache_write_tokens: zod.ZodInt;
+    cache_read_tokens: zod.ZodNullable<zod.ZodInt>;
+    cache_write_tokens: zod.ZodNullable<zod.ZodInt>;
     from: zod.z.ZodISODateTime;
-    input_tokens: zod.ZodInt;
-    output_tokens: zod.ZodInt;
-    reasoning_tokens: zod.ZodInt;
+    input_tokens: zod.ZodNullable<zod.ZodInt>;
+    output_tokens: zod.ZodNullable<zod.ZodInt>;
+    reasoning_tokens: zod.ZodNullable<zod.ZodInt>;
     media: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
         images: zod.ZodInt;
         audio_characters: zod.ZodInt;

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

@@ -41,12 +41,12 @@
 import * as zod from "zod";
 import { MediaUsage } from "./mediaUsage.zod.js";
 export const UsageBucketResource = zod.strictObject({
-    cache_read_tokens: zod.int(),
-    cache_write_tokens: zod.int(),
+    cache_read_tokens: zod.int().nullable().describe("Null when this range has no token usage."),
+    cache_write_tokens: zod.int().nullable().describe("Null when this range has no token usage."),
     from: zod.iso.datetime({ offset: true }).describe("Start of the bucket, inclusive"),
-    input_tokens: zod.int(),
-    output_tokens: zod.int(),
-    reasoning_tokens: zod.int(),
+    input_tokens: zod.int().nullable().describe("Null when this range has no token usage."),
+    output_tokens: zod.int().nullable().describe("Null when this range has no token usage."),
+    reasoning_tokens: zod.int().nullable().describe("Null when this range has no token usage."),
     media: zod
         .union([MediaUsage, zod.null()])
         .optional()

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

@@ -41,12 +41,12 @@
 import * as zod from "zod";
 export declare const UsageTimelineResponseBody: zod.ZodObject<{
     items: zod.ZodArray<zod.ZodObject<{
-        cache_read_tokens: zod.ZodInt;
-        cache_write_tokens: zod.ZodInt;
+        cache_read_tokens: zod.ZodNullable<zod.ZodInt>;
+        cache_write_tokens: zod.ZodNullable<zod.ZodInt>;
         from: zod.z.ZodISODateTime;
-        input_tokens: zod.ZodInt;
-        output_tokens: zod.ZodInt;
-        reasoning_tokens: zod.ZodInt;
+        input_tokens: zod.ZodNullable<zod.ZodInt>;
+        output_tokens: zod.ZodNullable<zod.ZodInt>;
+        reasoning_tokens: zod.ZodNullable<zod.ZodInt>;
         media: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
             images: zod.ZodInt;
             audio_characters: zod.ZodInt;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leaflow/sdk",
-  "version": "0.184.0",
+  "version": "0.186.0",
   "description": "Leaflow 平台 API 的 TypeScript SDK",
   "license": "MIT",
   "repository": {