@runblackcat/sdk 0.1.0-alpha.85 → 0.1.0-alpha.86

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runblackcat/sdk",
-  "version": "0.1.0-alpha.85",
+  "version": "0.1.0-alpha.86",
   "description": "TypeScript SDK for the Blackcat sandbox gateway",
   "license": "Apache-2.0",
   "repository": "https://github.com/TreebeardHQ/blackcat",

package/sdk/dist/index.d.ts

@@ -355,8 +355,11 @@ export type CreateCapacityReservationInput = ({
     memory_mib: number;
     /** How long to hold the reservation, between 1 second and 4 hours. */
     ttl_secs: number;
-    /** Defaults to `consumable`; `reusable` returns each slot after confirmed destruction. */
-    mode?: "consumable" | "reusable";
+    /** Defaults to `consumable`; `reusable` returns each slot after confirmed destruction.
+     * `warm` keeps `count` free slots on workers that cache a pinned template
+     * version; it takes `template` (not `template_resource`), is never held
+     * against other claims, and a sandbox create naming it is a 400. */
+    mode?: "consumable" | "reusable" | "warm";
     /** When the capacity must be ready: seconds from now, or an RFC 3339 time
      * within `ttl_secs`. Absent: as soon as it can be, at the lowest cost. */
     needed_by?: number | string;
@@ -381,7 +384,7 @@ export interface CapacityReservation {
     /** The template resource this reservation follows, or null when pinned. */
     template_resource: string | null;
     count: number;
-    mode: "consumable" | "reusable";
+    mode: "consumable" | "reusable" | "warm";
     placement: "shared" | "dedicated";
     /** The shape a dedicated reservation launches, or null. */
     shape: string | null;
@@ -393,8 +396,12 @@ export interface CapacityReservation {
     occupied: number;
     /** Slots bound to a specific node and not yet claimed. */
     bound: number;
-    /** Bound slots whose node already has the template warm. */
+    /** Bound slots whose node already has the template warm. For warm mode this
+     * counts member nodes at 1 each. */
     warm: number;
+    /** Warm mode: free slots of the shape on member workers whose template is
+     * ready, as of the last reconcile; zero for other modes. */
+    warm_free: number;
     expires_at: SystemTimeValue;
     /** When the capacity must be ready (epoch milliseconds), or null. */
     needed_by: number | null;
@@ -551,6 +558,8 @@ export interface FleetNode {
     memory: FleetNodeMemory;
     /** Whether the host runs with SMT active. */
     smt_active: boolean;
+    /** Bytes the worker reserves for cached templates; 0 until it reports one. */
+    cache_budget_bytes: number;
     /** The node's CPU; absent from nodes older than CPU-aware placement. */
     cpu?: CpuIdentity | null;
     /** 1000 charges file-backed clones in full; 2000 charges them at half. */