@runblackcat/sdk 0.1.0-alpha.100 → 0.1.0-alpha.101

package/package.json

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

package/sdk/dist/index.d.ts

@@ -370,10 +370,14 @@ export type CreateCapacityReservationInput = ({
     /** 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;
-    /** `shared` (default): any eligible node, free headroom first. `dedicated`:
-     * only hosts dedicated reservations hold, launched for them. A held host
-     * serves only dedicated reservations (of any tenant: they pack), never
-     * ordinary work; a sandbox create naming it waits for one of its slots. */
+    /** `shared` (default): any eligible node, free headroom first.
+     * `dedicated`: one new exclusive metal host launched for this reservation
+     * alone, never shared with ordinary work or other reservations, and
+     * terminated when the reservation ends; a sandbox create naming it waits
+     * for one of its slots. A fleet with no metal shape whose one host holds the
+     * whole `count` refuses it with 409 `dedicated_metal_unavailable`
+     * (`dedicated_cpu_unsupported` when no metal shape restores the version's CPU). Warm
+     * reservations are always shared. */
     placement?: "shared" | "dedicated";
     /** With `placement: "dedicated"`, the provider shape to launch: an exact
      * shape or a family (`c7i`) the fleet can launch (direct EC2: the config's
@@ -412,6 +416,15 @@ export interface CapacityReservation {
     expires_at: SystemTimeValue;
     /** When the capacity must be ready (epoch milliseconds), or null. */
     needed_by: number | null;
+    /** Why the reservation's capacity plan last fell short (no metal shape
+     * holds it, no room under the fleet ceiling or quota, ...), or null. */
+    unmet_reason?: string | null;
+    /** The latest launch made for it, or null. */
+    launch?: {
+        state: string;
+        shape: string;
+        detail: string | null;
+    } | null;
 }
 export interface WaitOptions {
     /**
@@ -885,9 +898,21 @@ declare class ReservationsResource {
     /** Reserve capacity for a burst of sandboxes of one template/shape. */
     create(input: CreateCapacityReservationInput): Promise<CapacityReservation>;
     get(id: string): Promise<CapacityReservation>;
-    /** Release early. Unclaimed slots free immediately; bound nodes then fall
-     * back to the normal empty-worker scale-in grace period. */
+    /** Release early. Unclaimed slots free immediately. A shared
+     * reservation's bound nodes fall back to the normal empty-worker scale-in
+     * grace; a dedicated reservation's host is fenced and terminated after its
+     * remaining sandboxes have been destroyed. */
     release(id: string): Promise<CapacityReservation>;
+    /** Move an active, unoccupied, reusable dedicated reservation pinned to a
+     * version to a prepared template of the same `vcpus` and `memory_mib`,
+     * keeping its host and bindings. Retargeting to its current template is a
+     * no-op. 409 with a `code` and `hint` when it is shared
+     * (`retarget_requires_dedicated`), follows a template resource
+     * (`retarget_follows_resource`), its slots are occupied
+     * (`retarget_slots_occupied`), its host cannot restore the version
+     * (`retarget_cpu_incompatible`) or claims are waiting
+     * (`retarget_claims_waiting`). */
+    retarget(id: string, template: string): Promise<CapacityReservation>;
     renew(id: string, input: {
         ttl_secs: number;
         idempotency_key: string;

package/sdk/dist/index.js

@@ -445,6 +445,9 @@ class ReservationsResource {
   release(id) {
     return this.client.json("DELETE", `/v1/capacity-reservations/${pathSegment(id)}`, undefined, "either");
   }
+  retarget(id, template) {
+    return this.client.json("PUT", `/v1/capacity-reservations/${pathSegment(id)}/template`, { template }, "either");
+  }
   renew(id, input) {
     return this.client.json("POST", `/v1/capacity-reservations/${pathSegment(id)}/renew`, input, "either");
   }