@leaflow/sdk 0.185.0 → 0.187.0

package/README.md

@@ -22,6 +22,21 @@ npm run build
 so JSON and SSE retain their respective response formats. No compatibility forwarding layer is used. For local generation, CONTRACTS_DIR
 may point to an existing clean checkout of the exact CONTRACTS_REF commit. CI checks out that commit.
 
+## Protocol messages
+
+The contract's protobuf messages, currently the Fleet protocol spoken by VirtualDesktop viewers, are
+generated with protoc-gen-es under `src/proto`, keeping their proto paths. Import a file by that
+path and encode or decode with `@bufbuild/protobuf`; no gRPC or Connect transport is involved:
+
+```ts
+import { create, toBinary } from "@bufbuild/protobuf";
+import { ClientMessageSchema } from "@leaflow/sdk/proto/leaflow/fleet/control/v1/control_pb";
+
+const bytes = toBinary(ClientMessageSchema, create(ClientMessageSchema, {}));
+```
+
+`npm run generate` runs Orval and then `buf generate` on the same contract checkout.
+
 ## Canopy migration
 
 Project inference and management are exported from `canopy` and `@leaflow/sdk/canopy/v1`.

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

@@ -712,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;
@@ -725,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;
@@ -739,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/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/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;