@runblackcat/sdk 0.1.0-alpha.51 → 0.1.0-alpha.56

package/README.md

@@ -297,6 +297,7 @@ and pins its ID for safe retries. Intel Mac binaries are not published.
 - **[docs/PRODUCT.md](docs/PRODUCT.md)** — the product contract and readiness levels.
 - **[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)** — processes, crates, trust domains, a sandbox's life.
 - **[docs/SECURITY.md](docs/SECURITY.md)** — isolation boundaries and known gaps.
+- **[docs/fleet-upgrades.md](docs/fleet-upgrades.md)** — stage, preview, run, and resume compatible fleet upgrades.
 - **[docs/GROOMED.md](docs/GROOMED.md)** — the ranked backlog.
 - **[AGENTS.md](AGENTS.md)** — how to work in this repository.
 - **[docs/forkable-templates.md](docs/forkable-templates.md)**,

package/package.json

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

package/sdk/dist/index.d.ts

@@ -208,7 +208,13 @@ export interface SandboxLeaseInput {
     /** Hard lifetime from acquisition, at least ttl_secs and at most 30 days. */
     renewable_for_secs: number;
 }
-/** Response returned by POST /v1/sandboxes (the gateway has no template field). */
+/**
+ * Response returned by POST /v1/sandboxes (the gateway has no template field).
+ * The gateway sends a `failed` receipt with HTTP 409, so `create` and
+ * `acquisition` surface it as a `BlackcatApiError` whose `details` this
+ * parser accepts: placement was abandoned and its sandbox torn down, which is
+ * retryable under a new request id rather than a protocol fault.
+ */
 export type CreateSandboxResponse = {
     request_id: string;
     id: string;
@@ -221,6 +227,10 @@ export type CreateSandboxResponse = {
 } | {
     state: "pending";
     node: string | null;
+} | {
+    state: "failed";
+    node: null;
+    error: string;
 });
 export interface Sandbox {
     id: string;
@@ -438,6 +448,7 @@ declare class TemplateResourcesResource {
     constructor(client: GatewayClient);
     get(name: string): Promise<TemplateResource>;
     configure(name: string, input: ConfigureTemplateResourceInput): Promise<TemplateResource>;
+    delete(name: string): Promise<void>;
 }
 declare class TemplateBuildsResource {
     private readonly client;

package/sdk/dist/index.js

@@ -78,7 +78,7 @@ function parseCreateSandboxResponse(value, requestId) {
     throw new BlackcatProtocolError("sandbox create receipt is malformed or belongs to another request");
   }
   const row = value;
-  if (row.request_id !== requestId || typeof row.id !== "string" || row.id.length === 0 || !["boot", "warm_pool", "restore"].includes(String(row.tier)) || !["placed", "pending"].includes(String(row.state)) || row.state === "placed" && typeof row.node !== "string" || row.state === "pending" && row.node !== null && typeof row.node !== "string" || !isSystemTime(row.expires_at) || !isSystemTime(row.renewable_until)) {
+  if (row.request_id !== requestId || typeof row.id !== "string" || row.id.length === 0 || !["boot", "warm_pool", "restore"].includes(String(row.tier)) || !["placed", "pending", "failed"].includes(String(row.state)) || row.state === "placed" && typeof row.node !== "string" || row.state === "pending" && row.node !== null && typeof row.node !== "string" || row.state === "failed" && (row.node !== null || typeof row.error !== "string") || !isSystemTime(row.expires_at) || !isSystemTime(row.renewable_until)) {
     throw new BlackcatProtocolError("sandbox create receipt is malformed or belongs to another request");
   }
   return value;
@@ -343,6 +343,9 @@ class TemplateResourcesResource {
   configure(name, input) {
     return this.client.json("PUT", `/v1/template-resources/${pathSegment(name)}`, input, "token");
   }
+  delete(name) {
+    return this.client.json("DELETE", `/v1/template-resources/${pathSegment(name)}`, undefined, "token");
+  }
 }
 
 class TemplateBuildsResource {