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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runblackcat/sdk",
-  "version": "0.1.0-alpha.104",
+  "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

@@ -288,6 +288,8 @@ export type CreateSandboxInput = {
     /** Stable across retries of one acquisition; never reuse for another request. */
     request_id: string;
     ssh_public_key?: string;
+    /** Per-copy values applied before the restore gate opens. */
+    copy_env?: Record<string, string>;
     lease: SandboxLeaseInput;
     /** A capacity reservation this create should draw a bound slot from. */
     reservation?: string;
@@ -320,6 +322,8 @@ export type CreateSandboxBatchInput = CreateSandboxInput & {
 };
 export type SandboxBatchMemberState = "pending" | "placed" | "failed" | "destroyed";
 export interface SandboxBatchMember {
+    /** The gateway accepted and forwarded non-empty copy_env for this placed member; older gateways omit it. */
+    copy_env_forwarded?: true;
     /** Poll this member alone with `sandboxes.acquisition(request_id)`. */
     request_id: string;
     id: string;
@@ -345,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;
@@ -355,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
@@ -386,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
@@ -397,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. */
@@ -429,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
@@ -460,6 +491,8 @@ export type CreateSandboxResponse = {
      * predates this field.
      */
     restore_timing?: RestoreTiming;
+    /** The gateway accepted and forwarded non-empty copy_env at launch. Older gateways omit this. */
+    copy_env_forwarded?: true;
     /** Present when the create asked for `capability` and created this sandbox. */
     capability?: SandboxCapability;
 } & ({
@@ -906,6 +939,17 @@ declare class ReservationsResource {
      * grace; a dedicated reservation's host is fenced and terminated after its
      * remaining sandboxes have been destroyed. */
     release(id: string): Promise<CapacityReservation>;
+    /** Shrink an active reusable dedicated reservation pinned to a template version.
+     * Claimed copies stay on their hosts. Surplus empty hosts terminate; kept
+     * hosts receive smaller share caps and unclaimed bound slots are trimmed.
+     * Old-contract reservations without fresh exclusive hosts are refused with
+     * `resize_requires_fresh_hosts`; create a new dedicated reservation instead.
+     * Equal count (including replay) is a no-op.
+     * Count must be positive. 409: `resize_grow_unsupported`, `resize_below_claimed`,
+     * `resize_layout_occupied`, `resize_requires_active_reusable`,
+     * `retarget_requires_dedicated`, `retarget_follows_resource`, or
+     * `resize_changed` (concurrent change; submit again). */
+    resize(id: string, count: number): 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 hosts and bindings. Retargeting to its current template is a

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");
   }
+  resize(id, count) {
+    return this.client.json("PUT", `/v1/capacity-reservations/${pathSegment(id)}/count`, { count }, "either");
+  }
   retarget(id, template) {
     return this.client.json("PUT", `/v1/capacity-reservations/${pathSegment(id)}/template`, { template }, "either");
   }