@runblackcat/sdk 0.1.0-alpha.105 → 0.1.0-alpha.107

package/package.json

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

package/sdk/dist/index.d.ts

@@ -349,7 +349,7 @@ export interface SandboxLeaseInput {
     /** Hard lifetime from acquisition, at least ttl_secs and at most 30 days. */
     renewable_for_secs: number;
 }
-export type CreateCapacityReservationInput = ({
+type CapacityReservationTarget = ({
     /** One immutable template version, pinned for the reservation's life. */
     template: string;
     template_resource?: never;
@@ -359,13 +359,19 @@ export type CreateCapacityReservationInput = ({
      * warmed with each new version as it is activated. */
     template_resource: string;
     template?: never;
-}) & {
-    /** How many sandboxes of this template/shape to reserve. */
-    count: number;
+});
+type CapacityReservationCommonInput = {
     vcpus: number;
     memory_mib: number;
     /** How long to hold the reservation, between 1 second and 4 hours. */
     ttl_secs: number;
+    /** Stable retry key, at most 107 ASCII letters, digits, `_` or `-`. */
+    idempotency_key?: string;
+};
+export type CreateCapacityReservationInput = CapacityReservationTarget & CapacityReservationCommonInput & ({
+    /** How many sandboxes of this template/shape to reserve. */
+    count: number;
+    host?: never;
     /** 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
@@ -390,10 +396,19 @@ export type CreateCapacityReservationInput = ({
      * shape or a family (`c7i`) the fleet can launch (direct EC2: the config's
      * instance_types). Absent: the planner chooses. */
     shape?: string;
-    /** Stable retry key, at most 107 ASCII letters, digits, `_` or `-`. */
-    idempotency_key?: string;
-};
-export interface CapacityReservation {
+} | {
+    /** Reserve exactly one dedicated host, with no VM slot budget. */
+    host: {
+        shape: string;
+    };
+    count?: never;
+    template_resource?: never;
+    mode: "reusable";
+    placement: "dedicated";
+    needed_by?: never;
+    shape?: never;
+});
+interface CapacityReservationBase {
     id: string;
     state: "active" | "released" | "expired";
     /** The version nodes are warmed with; null while a reservation following a
@@ -401,7 +416,6 @@ export interface CapacityReservation {
     template: string | null;
     /** The template resource this reservation follows, or null when pinned. */
     template_resource: string | null;
-    count: number;
     mode: "consumable" | "reusable" | "warm";
     placement: "shared" | "dedicated";
     /** The shape a dedicated reservation launches, or null. */
@@ -433,6 +447,19 @@ export interface CapacityReservation {
         detail: string | null;
     } | null;
 }
+export type CapacityReservation = CapacityReservationBase & ({
+    capacity: {
+        kind: "copies";
+        count: number;
+    };
+    count: number;
+} | {
+    capacity: {
+        kind: "host";
+        shape: string;
+    };
+    count?: never;
+});
 export interface WaitOptions {
     /**
      * Have the gateway hold a still-pending claim for up to this many seconds