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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runblackcat/sdk",
-  "version": "0.1.0-alpha.114",
+  "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;
@@ -965,9 +971,27 @@ declare class ReservationsResource {
         idempotency_key: string;
     }): Promise<CapacityReservation>;
 }
+/** Managed-DNS queries only; all timestamps are UTC epoch milliseconds. */
+export interface SandboxEgressDnsEntry {
+    host: string;
+    queries: number;
+    decision: "allowed" | "filtered";
+    first_seen_at: number;
+    last_seen_at: number;
+}
+export interface SandboxEgressDns {
+    items: SandboxEgressDnsEntry[];
+    observation_started_at: number | null;
+    /** Queries for additional names after the node-local admission cap. */
+    overflow_queries: number;
+    /** Queries with invalid or unrecordable names. */
+    invalid_queries: number;
+}
 declare class SandboxesResource {
     private readonly client;
     constructor(client: GatewayClient);
+    /** Read node-local DNS history for a running sandbox; never resumes it. */
+    egressDns(id: string): Promise<SandboxEgressDns>;
     /** List all of this tenant's non-destroyed sandboxes, including hibernated ones. */
     list(): Promise<Sandbox[]>;
     /**

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;
     }
@@ -461,6 +464,9 @@ class SandboxesResource {
   constructor(client) {
     this.client = client;
   }
+  egressDns(id) {
+    return this.client.json("GET", `/v1/sandboxes/${pathSegment(id)}/egress/dns`, undefined, "either");
+  }
   list() {
     return this.client.json("GET", "/v1/sandboxes", undefined, "either");
   }