@runblackcat/sdk 0.1.0-alpha.115 → 0.1.0-alpha.116

package/package.json

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

package/sdk/dist/index.d.ts

@@ -22,6 +22,7 @@ export declare const CAPABILITY_OPS: {
 };
 export type CapabilityOps = number;
 export declare const BLACKCAT_ERROR_CODES: {
+    readonly CHECKPOINT_KERNEL_MISMATCH: "checkpoint_kernel_mismatch";
     readonly SANDBOX_TRANSITIONING: "sandbox_transitioning";
     readonly FLEET_UPGRADE_QUIESCING: "fleet_upgrade_quiescing";
 };
@@ -491,6 +492,11 @@ export type CreateSandboxResponse = {
      * predates this field.
      */
     restore_timing?: RestoreTiming;
+    /** First recorded failure, also available while pending teardown. Rebuild captures on checkpoint_kernel_mismatch. */
+    failure?: {
+        code: string;
+        detail: string | null;
+    };
     /** 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. */
@@ -844,7 +850,7 @@ export interface RenewTokenResponse {
 }
 export declare class BlackcatApiError extends Error {
     readonly status: number;
-    /** Stable gateway error code when one is provided. */
+    /** Stable gateway code, including failure.code on failed acquisition receipts. */
     readonly code?: string;
     readonly retryAfter?: number;
     readonly requestId?: string;

package/sdk/dist/index.js

@@ -15,6 +15,7 @@ var CAPABILITY_OPS = {
   RENEW: 4096
 };
 var BLACKCAT_ERROR_CODES = {
+  CHECKPOINT_KERNEL_MISMATCH: "checkpoint_kernel_mismatch",
   SANDBOX_TRANSITIONING: "sandbox_transitioning",
   FLEET_UPGRADE_QUIESCING: "fleet_upgrade_quiescing"
 };
@@ -37,7 +38,9 @@ class BlackcatApiError extends Error {
     this.status = status;
     this.details = details;
     if (typeof details === "object" && details !== null && !Array.isArray(details)) {
-      const code = details.code;
+      const fields = details;
+      const failure = fields.failure;
+      const code = fields.code ?? (typeof failure === "object" && failure !== null ? failure.code : undefined);
       if (typeof code === "string")
         this.code = code;
     }