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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runblackcat/sdk",
-  "version": "0.1.0-alpha.103",
+  "version": "0.1.0-alpha.105",
   "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;
@@ -371,11 +375,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";
@@ -457,6 +464,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;
 } & ({
@@ -903,9 +912,20 @@ 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 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

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");
   }