@runblackcat/sdk 0.1.0-alpha.102 → 0.1.0-alpha.104

package/README.md

@@ -59,7 +59,8 @@ Tenants are **API-managed rows**, not configuration, so an operator can provisio
 and use one without restarting the service.
 
 No ZooKeeper, etcd, or Consul at any scale. Placement is sticky and sandboxes never move
-while running, so the problem partitions without consensus.
+while running (a paused sandbox may be moved and resumed on another node, dropping its
+open connections), so the problem partitions without consensus.
 
 ## How it fits together
 

package/package.json

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

package/sdk/dist/index.d.ts

@@ -371,11 +371,14 @@ export type CreateCapacityReservationInput = ({
      * 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`: 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`: as few new exclusive hosts as hold `count` (full hosts of
+     * the largest metal shape, the remainder on the smallest metal or nested
+     * shape that holds it), launched for this reservation alone, never shared
+     * with ordinary work or other reservations, a failed host replaced alone,
+     * and terminated when the reservation ends; a sandbox create naming it
+     * waits for one of its slots, filling one host before the next. A fleet
+     * with no metal shape a host of which holds one copy 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";
@@ -905,7 +908,7 @@ declare class ReservationsResource {
     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
+     * keeping its hosts 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