sandbox0 0.7.6 → 0.7.8

package/dist/errors.js

@@ -1,10 +1,12 @@
 import { runtime } from "./apispec_compat.js";
+export const CLAIM_START_THROTTLED_CODE = "claim_start_throttled";
 export class APIError extends Error {
     statusCode;
     code;
     details;
     requestId;
     body;
+    retryAfter;
     constructor(params) {
         super(params.message);
         this.name = "APIError";
@@ -13,6 +15,19 @@ export class APIError extends Error {
         this.details = params.details;
         this.requestId = params.requestId;
         this.body = params.body;
+        this.retryAfter = params.retryAfter;
+    }
+}
+export class SandboxWaitTimeoutError extends Error {
+    sandboxId;
+    timeoutMs;
+    lastSandbox;
+    constructor(params) {
+        super(`timed out waiting for sandbox ${params.sandboxId} after ${params.timeoutMs}ms`);
+        this.name = "SandboxWaitTimeoutError";
+        this.sandboxId = params.sandboxId;
+        this.timeoutMs = params.timeoutMs;
+        this.lastSandbox = params.lastSandbox;
     }
 }
 function getRequestId(response) {
@@ -20,9 +35,27 @@ function getRequestId(response) {
         response.headers.get("x-requestid") ??
         undefined);
 }
+function getRetryAfter(response) {
+    const value = response.headers.get("retry-after");
+    if (!value) {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    if (!/^\d+$/.test(trimmed)) {
+        return undefined;
+    }
+    const seconds = Number.parseInt(trimmed, 10);
+    return Number.isFinite(seconds) && seconds >= 0 ? seconds : undefined;
+}
+export function isClaimStartThrottled(error) {
+    return error instanceof APIError
+        && error.statusCode === 429
+        && error.code === CLAIM_START_THROTTLED_CODE;
+}
 export async function apiErrorFromResponse(response) {
     const statusCode = response.status;
     const requestId = getRequestId(response);
+    const retryAfter = getRetryAfter(response);
     let bodyText = "";
     let code = "unexpected_response";
     let message = response.statusText || "request failed";
@@ -50,6 +83,7 @@ export async function apiErrorFromResponse(response) {
         details,
         requestId,
         body: bodyText || undefined,
+        retryAfter,
     });
 }
 export async function wrapApiCall(fn) {

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { Client, type ClientOptions, DEFAULT_BASE_URL } from "./client.js";
 export { Sandbox } from "./sandbox.js";
-export { APIError } from "./errors.js";
+export { APIError, SandboxWaitTimeoutError } from "./errors.js";
 export { verifyWebhookSignature } from "./webhook_signature.js";
 export * from "./template_helpers.js";
 export * from "./models.js";
@@ -12,4 +12,28 @@ import "./sandbox_files.js";
 import "./sandbox_network.js";
 import "./sandbox_services.js";
 import "./sandbox_observability.js";
+export declare const SandboxRuntimeMetricName: {
+    readonly SandboxCpuUtilization: "sandbox.cpu.utilization";
+    readonly SandboxCpuUsage: "sandbox.cpu.usage";
+    readonly SandboxCpuTime: "sandbox.cpu.time";
+    readonly SandboxCpuLimit: "sandbox.cpu.limit";
+    readonly SandboxMemoryUsage: "sandbox.memory.usage";
+    readonly SandboxMemoryWorkingSet: "sandbox.memory.working_set";
+    readonly SandboxMemoryAvailable: "sandbox.memory.available";
+    readonly SandboxMemoryLimit: "sandbox.memory.limit";
+    readonly SandboxMemoryUtilization: "sandbox.memory.utilization";
+    readonly SandboxNetworkIo: "sandbox.network.io";
+    readonly SandboxNetworkErrors: "sandbox.network.errors";
+    readonly SandboxProcessCount: "sandbox.process.count";
+    readonly SandboxRootfsWritableUsage: "sandbox.rootfs.writable.usage";
+    readonly SandboxRootfsWritableInodes: "sandbox.rootfs.writable.inodes";
+};
+export declare const SandboxRuntimeMetricStatistic: {
+    readonly Auto: "auto";
+    readonly Average: "average";
+    readonly Minimum: "minimum";
+    readonly Maximum: "maximum";
+    readonly Last: "last";
+    readonly Rate: "rate";
+};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAC5C,OAAO,oBAAoB,CAAC;AAC5B,OAAO,iBAAiB,CAAC;AACzB,OAAO,mBAAmB,CAAC;AAC3B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAE5C,OAAO,oBAAoB,CAAC;AAC5B,OAAO,iBAAiB,CAAC;AACzB,OAAO,mBAAmB,CAAC;AAC3B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,yBAAyB,CAAC;AAEjC,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;CAA2C,CAAC;AACjF,eAAO,MAAM,6BAA6B;;;;;;;CAAgD,CAAC"}

package/dist/index.js

@@ -1,14 +1,17 @@
 export { Client, DEFAULT_BASE_URL } from "./client.js";
 export { Sandbox } from "./sandbox.js";
-export { APIError } from "./errors.js";
+export { APIError, SandboxWaitTimeoutError } from "./errors.js";
 export { verifyWebhookSignature } from "./webhook_signature.js";
 export * from "./template_helpers.js";
 export * from "./models.js";
 export * from "./sessions.js";
 export { apis, models, runtime } from "./apispec_compat.js";
 export * as apispec from "./apispec_compat.js";
+import { models as generatedModels } from "./apispec_compat.js";
 import "./sandbox_contexts.js";
 import "./sandbox_files.js";
 import "./sandbox_network.js";
 import "./sandbox_services.js";
 import "./sandbox_observability.js";
+export const SandboxRuntimeMetricName = generatedModels.SandboxRuntimeMetricName;
+export const SandboxRuntimeMetricStatistic = generatedModels.SandboxRuntimeMetricStatistic;

package/dist/models.d.ts

@@ -1,4 +1,4 @@
-import type { ObservabilityEventSource, SandboxAppServiceView, SandboxObservabilityEventType, SandboxObservabilityEventsResponse, SandboxObservabilityLogStream, SandboxObservabilityLogsResponse, SandboxObservabilityMetricsResponse, SandboxObservabilityOutcome, SandboxObservabilityWatchLine, SandboxSummary } from "./apispec/src/models/index.js";
+import type { ObservabilityEventSource, SandboxAppServiceView, SandboxObservabilityEventType, SandboxObservabilityEventsResponse, SandboxObservabilityLogStream, SandboxObservabilityLogsResponse, SandboxObservabilityOutcome, SandboxObservabilityWatchLine, SandboxRuntimeMetricName, SandboxRuntimeMetricStatistic, SandboxRuntimeMetricsCatalogResponse, SandboxRuntimeMetricsResponse, Sandbox, SandboxSummary } from "./apispec/src/models/index.js";
 export interface RunResult {
     sandboxId: string;
     contextId: string;
@@ -71,15 +71,19 @@ export interface SandboxObservabilityLogWatchOptions extends SandboxObservabilit
     contextId?: string;
     stream?: SandboxObservabilityLogStream;
 }
-export interface SandboxObservabilityMetricOptions extends SandboxObservabilityQueryOptions {
-    contextId?: string;
-    name?: string[];
-    names?: string;
-}
-export interface SandboxObservabilityMetricWatchOptions extends SandboxObservabilityWatchOptions {
-    contextId?: string;
-    name?: string[];
-    names?: string;
+export interface SandboxMetricsOptions {
+    /** Defaults to one hour before endTime. */
+    startTime?: Date;
+    /** Defaults to the current time. */
+    endTime?: Date;
+    /** Canonical sandbox-wide metrics to return. */
+    metrics?: readonly SandboxRuntimeMetricName[];
+    /** Requested bucket width. The server may increase it to honor maxPoints. */
+    stepSeconds?: number;
+    /** Defaults to average for gauges and rate for counters. */
+    statistic?: SandboxRuntimeMetricStatistic;
+    /** Maximum points per series. Defaults to 240 and cannot exceed 1000. */
+    maxPoints?: number;
 }
 export interface SandboxObservabilityWatchStream extends AsyncIterable<SandboxObservabilityWatchLine> {
     body: ReadableStream<Uint8Array>;
@@ -87,7 +91,8 @@ export interface SandboxObservabilityWatchStream extends AsyncIterable<SandboxOb
 }
 export type SandboxObservabilityEvents = SandboxObservabilityEventsResponse;
 export type SandboxObservabilityLogs = SandboxObservabilityLogsResponse;
-export type SandboxObservabilityMetrics = SandboxObservabilityMetricsResponse;
+export type SandboxMetrics = SandboxRuntimeMetricsResponse;
+export type SandboxMetricsCatalog = SandboxRuntimeMetricsCatalogResponse;
 export type SandboxStatusFilter = SandboxSummary["status"];
 export interface SandboxListOptions {
     status?: SandboxStatusFilter;
@@ -101,4 +106,13 @@ export interface SandboxListResult {
     count: number;
     hasMore: boolean;
 }
+export interface SandboxLifecycleWaitOptions {
+    /** Maximum polling duration. Defaults to 60 seconds. */
+    timeoutMs?: number;
+    /** Delay between observations. Defaults to 500 milliseconds. */
+    pollIntervalMs?: number;
+    /** Stops waiting locally. It does not roll back a lifecycle request already accepted by the server. */
+    signal?: AbortSignal;
+}
+export type SandboxLifecyclePredicate = (sandbox: Sandbox) => boolean | Promise<boolean>;
 //# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"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"}

package/dist/resources/sandboxes.d.ts

@@ -1,5 +1,5 @@
 import type { ClaimMountRequest, CreateSandboxRootFSSnapshotRequest, ForkSandboxRequest, ForkSandboxResponse, PauseSandboxResponse, RestoreSandboxRootFSRequest, RestoreSandboxRootFSResponse, SandboxRefreshRequest, RefreshResponse, ResumeSandboxResponse, Sandbox, SandboxConfig, SandboxRootFSSnapshot, SandboxStatus, SandboxUpdateRequest, SuccessMessageResponse, SuccessDeletedResponse } from "../apispec/src/models/index.js";
-import type { SandboxListOptions, SandboxListResult } from "../models.js";
+import type { SandboxLifecyclePredicate, SandboxLifecycleWaitOptions, SandboxListOptions, SandboxListResult } from "../models.js";
 import type { Client } from "../client.js";
 import { Sandbox as SandboxHandle } from "../sandbox.js";
 import { SandboxSession } from "../sessions.js";
@@ -16,12 +16,24 @@ export declare class Sandboxes {
     list(options?: SandboxListOptions): Promise<SandboxListResult>;
     open(template: string, options?: SandboxConfig | ClaimSandboxOptions): Promise<SandboxSession>;
     get(sandboxId: string): Promise<Sandbox>;
+    private getWithSignal;
+    /**
+     * Polls committed sandbox details until the predicate matches.
+     *
+     * Abort stops the local wait but cannot undo a lifecycle request that the
+     * server has already accepted.
+     */
+    waitForLifecycle(sandboxId: string, predicate: SandboxLifecyclePredicate, options?: SandboxLifecycleWaitOptions): Promise<Sandbox>;
     update(sandboxId: string, request: SandboxUpdateRequest): Promise<Sandbox>;
     updateMemory(sandboxId: string, memory: string): Promise<Sandbox>;
     delete(sandboxId: string): Promise<SuccessMessageResponse>;
     status(sandboxId: string): Promise<SandboxStatus>;
     pause(sandboxId: string): Promise<PauseSandboxResponse>;
+    /** Requests a pause and waits for its durable checkpoint to commit. */
+    pauseAndWait(sandboxId: string, options?: SandboxLifecycleWaitOptions): Promise<Sandbox>;
     resume(sandboxId: string): Promise<ResumeSandboxResponse>;
+    /** Requests a resume and waits for the committed running generation. */
+    resumeAndWait(sandboxId: string, options?: SandboxLifecycleWaitOptions): Promise<Sandbox>;
     refresh(sandboxId: string, request?: SandboxRefreshRequest): Promise<RefreshResponse>;
     createRootFSSnapshot(sandboxId: string, request?: CreateSandboxRootFSSnapshotRequest): Promise<SandboxRootFSSnapshot>;
     listRootFSSnapshots(sandboxId: string): Promise<SandboxRootFSSnapshot[]>;

package/dist/resources/sandboxes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sandboxes.d.ts","sourceRoot":"","sources":["../../src/resources/sandboxes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAEjB,kCAAkC,EAClC,kBAAkB,EAClB,mBAAmB,EAEnB,oBAAoB,EACpB,2BAA2B,EAC3B,4BAA4B,EAC5B,qBAAqB,EACrB,eAAe,EACf,qBAAqB,EACrB,OAAO,EACP,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAyCD,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAErC,KAAK,CACT,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,aAAa,GAAG,mBAAmB,GAC5C,OAAO,CAAC,aAAa,CAAC;IAmBnB,IAAI,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAkB9D,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,aAAa,GAAG,mBAAmB,GAC5C,OAAO,CAAC,cAAc,CAAC;IAOpB,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOxC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAU1E,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQjE,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAO1D,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAOjD,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAOvD,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAOzD,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,eAAe,CAAC;IAUrB,oBAAoB,CACxB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,kCAAkC,GAC3C,OAAO,CAAC,qBAAqB,CAAC;IAU3B,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAQxE,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IASrE,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IASzE,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,4BAA4B,CAAC;IAUlC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAUzF,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa;CAG1C"}
+{"version":3,"file":"sandboxes.d.ts","sourceRoot":"","sources":["../../src/resources/sandboxes.ts"],"names":[],"mappings":"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"}

package/dist/resources/sandboxes.js

@@ -1,7 +1,9 @@
 import { ensureData, ensureModel } from "../response.js";
-import { wrapApiCall } from "../errors.js";
+import { SandboxWaitTimeoutError, wrapApiCall } from "../errors.js";
 import { Sandbox as SandboxHandle } from "../sandbox.js";
 import { SandboxSession } from "../sessions.js";
+const DEFAULT_LIFECYCLE_TIMEOUT_MS = 60_000;
+const DEFAULT_LIFECYCLE_POLL_INTERVAL_MS = 500;
 function isClaimSandboxOptions(value) {
     return !!value && typeof value === "object" && ("config" in value ||
         "mounts" in value ||
@@ -74,9 +76,39 @@ export class Sandboxes {
         });
     }
     async get(sandboxId) {
-        const response = await wrapApiCall(() => this.client.apispec.sandboxes.apiV1SandboxesIdGet({ id: sandboxId }));
+        return this.getWithSignal(sandboxId);
+    }
+    async getWithSignal(sandboxId, signal) {
+        const response = await wrapApiCall(() => this.client.apispec.sandboxes.apiV1SandboxesIdGet({ id: sandboxId }, signal ? { signal } : undefined));
         return ensureData(response, "get sandbox returned empty response");
     }
+    /**
+     * Polls committed sandbox details until the predicate matches.
+     *
+     * Abort stops the local wait but cannot undo a lifecycle request that the
+     * server has already accepted.
+     */
+    async waitForLifecycle(sandboxId, predicate, options = {}) {
+        const timeoutMs = options.timeoutMs ?? DEFAULT_LIFECYCLE_TIMEOUT_MS;
+        const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_LIFECYCLE_POLL_INTERVAL_MS;
+        validateWaitDuration("timeoutMs", timeoutMs, true);
+        validateWaitDuration("pollIntervalMs", pollIntervalMs, false);
+        const startedAt = Date.now();
+        let lastSandbox;
+        while (true) {
+            throwIfAborted(options.signal);
+            lastSandbox = await this.getWithSignal(sandboxId, options.signal);
+            throwIfAborted(options.signal);
+            if (await predicate(lastSandbox)) {
+                return lastSandbox;
+            }
+            const remainingMs = timeoutMs - (Date.now() - startedAt);
+            if (remainingMs <= 0) {
+                throw new SandboxWaitTimeoutError({ sandboxId, timeoutMs, lastSandbox });
+            }
+            await sleepWithSignal(Math.min(pollIntervalMs, remainingMs), options.signal);
+        }
+    }
     async update(sandboxId, request) {
         const response = await wrapApiCall(() => this.client.apispec.sandboxes.apiV1SandboxesIdPut({
             id: sandboxId,
@@ -103,10 +135,29 @@ export class Sandboxes {
         const response = await wrapApiCall(() => this.client.apispec.sandboxes.apiV1SandboxesIdPausePost({ id: sandboxId }));
         return ensureData(response, "pause sandbox returned empty response");
     }
+    /** Requests a pause and waits for its durable checkpoint to commit. */
+    async pauseAndWait(sandboxId, options) {
+        throwIfAborted(options?.signal);
+        await this.pause(sandboxId);
+        return this.waitForLifecycle(sandboxId, (sandbox) => sandbox.status === "paused" && sandbox.paused, options);
+    }
     async resume(sandboxId) {
         const response = await wrapApiCall(() => this.client.apispec.sandboxes.apiV1SandboxesIdResumePost({ id: sandboxId }));
         return ensureData(response, "resume sandbox returned empty response");
     }
+    /** Requests a resume and waits for the committed running generation. */
+    async resumeAndWait(sandboxId, options) {
+        throwIfAborted(options?.signal);
+        const before = await this.getWithSignal(sandboxId, options?.signal);
+        throwIfAborted(options?.signal);
+        await this.resume(sandboxId);
+        const minimumRuntimeGeneration = before.paused || before.status === "paused"
+            ? before.runtimeGeneration + 1
+            : before.runtimeGeneration;
+        return this.waitForLifecycle(sandboxId, (sandbox) => (sandbox.status === "running"
+            && !sandbox.paused
+            && sandbox.runtimeGeneration >= minimumRuntimeGeneration), options);
+    }
     async refresh(sandboxId, request) {
         const params = request
             ? { id: sandboxId, sandboxRefreshRequest: request }
@@ -156,3 +207,56 @@ export class Sandboxes {
         return new SandboxHandle({ id: sandboxId, client: this.client });
     }
 }
+function validateWaitDuration(name, value, allowZero) {
+    if (!Number.isFinite(value) || (allowZero ? value < 0 : value <= 0)) {
+        const requirement = allowZero ? "a finite number >= 0" : "a finite number > 0";
+        throw new RangeError(`${name} must be ${requirement}`);
+    }
+}
+function throwIfAborted(signal) {
+    if (!signal?.aborted) {
+        return;
+    }
+    throw abortReason(signal);
+}
+function abortReason(signal) {
+    if (signal.reason !== undefined) {
+        return signal.reason;
+    }
+    const error = new Error("sandbox lifecycle wait was aborted");
+    error.name = "AbortError";
+    return error;
+}
+function sleepWithSignal(durationMs, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(abortReason(signal));
+            return;
+        }
+        let settled = false;
+        let timer;
+        const onAbort = () => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            if (timer !== undefined) {
+                clearTimeout(timer);
+            }
+            signal?.removeEventListener("abort", onAbort);
+            reject(signal ? abortReason(signal) : new Error("sandbox lifecycle wait was aborted"));
+        };
+        timer = setTimeout(() => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, durationMs);
+        signal?.addEventListener("abort", onAbort, { once: true });
+        if (signal?.aborted) {
+            onAbort();
+        }
+    });
+}

package/dist/sandbox_observability.d.ts

@@ -1,14 +1,12 @@
-import type { SandboxObservabilityEventOptions, SandboxObservabilityEventWatchOptions, SandboxObservabilityEvents, SandboxObservabilityLogOptions, SandboxObservabilityLogWatchOptions, SandboxObservabilityLogs, SandboxObservabilityMetricOptions, SandboxObservabilityMetricWatchOptions, SandboxObservabilityMetrics, SandboxObservabilityWatchStream } from "./models.js";
+import type { SandboxObservabilityEventOptions, SandboxObservabilityEventWatchOptions, SandboxObservabilityEvents, SandboxObservabilityLogOptions, SandboxObservabilityLogWatchOptions, SandboxObservabilityLogs, SandboxObservabilityWatchStream, SandboxMetrics, SandboxMetricsCatalog, SandboxMetricsOptions } from "./models.js";
 declare module "./sandbox" {
     interface Sandbox {
         listObservabilityEvents(options?: SandboxObservabilityEventOptions): Promise<SandboxObservabilityEvents>;
         watchObservabilityEvents(options?: SandboxObservabilityEventWatchOptions): Promise<SandboxObservabilityWatchStream>;
-        listAuditEvents(options?: SandboxObservabilityEventOptions): Promise<SandboxObservabilityEvents>;
-        watchAuditEvents(options?: SandboxObservabilityEventWatchOptions): Promise<SandboxObservabilityWatchStream>;
         listLogs(options?: SandboxObservabilityLogOptions): Promise<SandboxObservabilityLogs>;
         watchLogs(options?: SandboxObservabilityLogWatchOptions): Promise<SandboxObservabilityWatchStream>;
-        listMetrics(options?: SandboxObservabilityMetricOptions): Promise<SandboxObservabilityMetrics>;
-        watchMetrics(options?: SandboxObservabilityMetricWatchOptions): Promise<SandboxObservabilityWatchStream>;
+        getMetrics(options?: SandboxMetricsOptions): Promise<SandboxMetrics>;
+        getMetricsCatalog(): Promise<SandboxMetricsCatalog>;
     }
 }
 //# sourceMappingURL=sandbox_observability.d.ts.map

package/dist/sandbox_observability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sandbox_observability.d.ts","sourceRoot":"","sources":["../src/sandbox_observability.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gCAAgC,EAChC,qCAAqC,EACrC,0BAA0B,EAC1B,8BAA8B,EAC9B,mCAAmC,EACnC,wBAAwB,EACxB,iCAAiC,EACjC,sCAAsC,EACtC,2BAA2B,EAC3B,+BAA+B,EAChC,MAAM,UAAU,CAAC;AAOlB,OAAO,QAAQ,WAAW,CAAC;IACzB,UAAU,OAAO;QACf,uBAAuB,CACrB,OAAO,CAAC,EAAE,gCAAgC,GACzC,OAAO,CAAC,0BAA0B,CAAC,CAAC;QACvC,wBAAwB,CACtB,OAAO,CAAC,EAAE,qCAAqC,GAC9C,OAAO,CAAC,+BAA+B,CAAC,CAAC;QAC5C,eAAe,CACb,OAAO,CAAC,EAAE,gCAAgC,GACzC,OAAO,CAAC,0BAA0B,CAAC,CAAC;QACvC,gBAAgB,CACd,OAAO,CAAC,EAAE,qCAAqC,GAC9C,OAAO,CAAC,+BAA+B,CAAC,CAAC;QAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,8BAA8B,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;QACtF,SAAS,CACP,OAAO,CAAC,EAAE,mCAAmC,GAC5C,OAAO,CAAC,+BAA+B,CAAC,CAAC;QAC5C,WAAW,CACT,OAAO,CAAC,EAAE,iCAAiC,GAC1C,OAAO,CAAC,2BAA2B,CAAC,CAAC;QACxC,YAAY,CACV,OAAO,CAAC,EAAE,sCAAsC,GAC/C,OAAO,CAAC,+BAA+B,CAAC,CAAC;KAC7C;CACF"}
+{"version":3,"file":"sandbox_observability.d.ts","sourceRoot":"","sources":["../src/sandbox_observability.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gCAAgC,EAChC,qCAAqC,EACrC,0BAA0B,EAC1B,8BAA8B,EAC9B,mCAAmC,EACnC,wBAAwB,EACxB,+BAA+B,EAC/B,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,UAAU,CAAC;AAOlB,OAAO,QAAQ,WAAW,CAAC;IACzB,UAAU,OAAO;QACf,uBAAuB,CACrB,OAAO,CAAC,EAAE,gCAAgC,GACzC,OAAO,CAAC,0BAA0B,CAAC,CAAC;QACvC,wBAAwB,CACtB,OAAO,CAAC,EAAE,qCAAqC,GAC9C,OAAO,CAAC,+BAA+B,CAAC,CAAC;QAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,8BAA8B,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;QACtF,SAAS,CACP,OAAO,CAAC,EAAE,mCAAmC,GAC5C,OAAO,CAAC,+BAA+B,CAAC,CAAC;QAC5C,UAAU,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;QACrE,iBAAiB,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAAC;KACrD;CACF"}

package/dist/sandbox_observability.js

@@ -8,21 +8,15 @@ Sandbox.prototype.listObservabilityEvents = async function (options) {
 Sandbox.prototype.watchObservabilityEvents = async function (options) {
     return getClient(this).watchSandboxObservabilityEvents(this.id, options);
 };
-Sandbox.prototype.listAuditEvents = async function (options) {
-    return getClient(this).listSandboxAuditEvents(this.id, options);
-};
-Sandbox.prototype.watchAuditEvents = async function (options) {
-    return getClient(this).watchSandboxAuditEvents(this.id, options);
-};
 Sandbox.prototype.listLogs = async function (options) {
     return getClient(this).listSandboxObservabilityLogs(this.id, options);
 };
 Sandbox.prototype.watchLogs = async function (options) {
     return getClient(this).watchSandboxObservabilityLogs(this.id, options);
 };
-Sandbox.prototype.listMetrics = async function (options) {
-    return getClient(this).listSandboxObservabilityMetrics(this.id, options);
+Sandbox.prototype.getMetrics = async function (options) {
+    return getClient(this).getSandboxMetrics(this.id, options);
 };
-Sandbox.prototype.watchMetrics = async function (options) {
-    return getClient(this).watchSandboxObservabilityMetrics(this.id, options);
+Sandbox.prototype.getMetricsCatalog = async function () {
+    return getClient(this).getSandboxMetricsCatalog(this.id);
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sandbox0",
-  "version": "0.7.6",
+  "version": "0.7.8",
   "description": "Sandbox0 JavaScript/TypeScript SDK",
   "license": "Apache-2.0",
   "author": "Sandbox0 Team",

package/dist/apispec/src/apis/AuditApi.d.ts

@@ -1,40 +0,0 @@
-/**
- * Sandbox0 API
- * Public HTTP APIs exposed by Sandbox0 regional gateways and the global gateway.
- *
- * The version of the OpenAPI document: 0.1.0
- *
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-import * as runtime from '../runtime.js';
-import type { ObservabilityEventSource, SandboxObservabilityEventType, SandboxObservabilityOutcome, SuccessSandboxObservabilityEventsResponse } from '../models/index.js';
-export interface ApiV1SandboxesIdAuditEventsGetRequest {
-    id: string;
-    startTime?: Date;
-    endTime?: Date;
-    limit?: number;
-    cursor?: string;
-    watch?: boolean;
-    source?: ObservabilityEventSource;
-    eventType?: SandboxObservabilityEventType;
-    outcome?: SandboxObservabilityOutcome;
-}
-/**
- *
- */
-export declare class AuditApi extends runtime.BaseAPI {
-    /**
-     * Queries the audit-focused projection for a sandbox. Network audit events are included in scope; file audit is intentionally not included.
-     * Query historical sandbox audit events
-     */
-    apiV1SandboxesIdAuditEventsGetRaw(requestParameters: ApiV1SandboxesIdAuditEventsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessSandboxObservabilityEventsResponse>>;
-    /**
-     * Queries the audit-focused projection for a sandbox. Network audit events are included in scope; file audit is intentionally not included.
-     * Query historical sandbox audit events
-     */
-    apiV1SandboxesIdAuditEventsGet(requestParameters: ApiV1SandboxesIdAuditEventsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessSandboxObservabilityEventsResponse>;
-}
-//# sourceMappingURL=AuditApi.d.ts.map

package/dist/apispec/src/apis/AuditApi.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AuditApi.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/apis/AuditApi.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAEV,wBAAwB,EACxB,6BAA6B,EAC7B,2BAA2B,EAE3B,yCAAyC,EAC1C,MAAM,iBAAiB,CAAC;AAgBzB,MAAM,WAAW,qCAAqC;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,SAAS,CAAC,EAAE,6BAA6B,CAAC;IAC1C,OAAO,CAAC,EAAE,2BAA2B,CAAC;CACzC;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,OAAO,CAAC,OAAO;IAEzC;;;OAGG;IACG,iCAAiC,CAAC,iBAAiB,EAAE,qCAAqC,EAAE,aAAa,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,yCAAyC,CAAC,CAAC;IAkEtO;;;OAGG;IACG,8BAA8B,CAAC,iBAAiB,EAAE,qCAAqC,EAAE,aAAa,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,GAAG,OAAO,CAAC,yCAAyC,CAAC;CAKjN"}

package/dist/apispec/src/apis/AuditApi.js

@@ -1,79 +0,0 @@
-/* tslint:disable */
-/* eslint-disable */
-/**
- * Sandbox0 API
- * Public HTTP APIs exposed by Sandbox0 regional gateways and the global gateway.
- *
- * The version of the OpenAPI document: 0.1.0
- *
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-import * as runtime from '../runtime.js';
-import { SuccessSandboxObservabilityEventsResponseFromJSON, } from '../models/index.js';
-/**
- *
- */
-export class AuditApi extends runtime.BaseAPI {
-    /**
-     * Queries the audit-focused projection for a sandbox. Network audit events are included in scope; file audit is intentionally not included.
-     * Query historical sandbox audit events
-     */
-    async apiV1SandboxesIdAuditEventsGetRaw(requestParameters, initOverrides) {
-        if (requestParameters['id'] == null) {
-            throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling apiV1SandboxesIdAuditEventsGet().');
-        }
-        const queryParameters = {};
-        if (requestParameters['startTime'] != null) {
-            queryParameters['start_time'] = requestParameters['startTime'].toISOString();
-        }
-        if (requestParameters['endTime'] != null) {
-            queryParameters['end_time'] = requestParameters['endTime'].toISOString();
-        }
-        if (requestParameters['limit'] != null) {
-            queryParameters['limit'] = requestParameters['limit'];
-        }
-        if (requestParameters['cursor'] != null) {
-            queryParameters['cursor'] = requestParameters['cursor'];
-        }
-        if (requestParameters['watch'] != null) {
-            queryParameters['watch'] = requestParameters['watch'];
-        }
-        if (requestParameters['source'] != null) {
-            queryParameters['source'] = requestParameters['source'];
-        }
-        if (requestParameters['eventType'] != null) {
-            queryParameters['event_type'] = requestParameters['eventType'];
-        }
-        if (requestParameters['outcome'] != null) {
-            queryParameters['outcome'] = requestParameters['outcome'];
-        }
-        const headerParameters = {};
-        if (this.configuration && this.configuration.accessToken) {
-            const token = this.configuration.accessToken;
-            const tokenString = await token("bearerAuth", []);
-            if (tokenString) {
-                headerParameters["Authorization"] = `Bearer ${tokenString}`;
-            }
-        }
-        let urlPath = `/api/v1/sandboxes/{id}/audit/events`;
-        urlPath = urlPath.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id'])));
-        const response = await this.request({
-            path: urlPath,
-            method: 'GET',
-            headers: headerParameters,
-            query: queryParameters,
-        }, initOverrides);
-        return new runtime.JSONApiResponse(response, (jsonValue) => SuccessSandboxObservabilityEventsResponseFromJSON(jsonValue));
-    }
-    /**
-     * Queries the audit-focused projection for a sandbox. Network audit events are included in scope; file audit is intentionally not included.
-     * Query historical sandbox audit events
-     */
-    async apiV1SandboxesIdAuditEventsGet(requestParameters, initOverrides) {
-        const response = await this.apiV1SandboxesIdAuditEventsGetRaw(requestParameters, initOverrides);
-        return await response.value();
-    }
-}

package/dist/apispec/src/models/ContextStatsResponse.d.ts

@@ -1,64 +0,0 @@
-/**
- * Sandbox0 API
- * Public HTTP APIs exposed by Sandbox0 regional gateways and the global gateway.
- *
- * The version of the OpenAPI document: 0.1.0
- *
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-import type { ResourceUsage } from './ResourceUsage.js';
-/**
- *
- * @export
- * @interface ContextStatsResponse
- */
-export interface ContextStatsResponse {
-    /**
-     *
-     * @type {string}
-     * @memberof ContextStatsResponse
-     */
-    contextId?: string;
-    /**
-     *
-     * @type {string}
-     * @memberof ContextStatsResponse
-     */
-    type?: string;
-    /**
-     * Alias for the REPL or CLI tool (e.g., python, node, bash, redis-cli)
-     * @type {string}
-     * @memberof ContextStatsResponse
-     */
-    alias?: string;
-    /**
-     *
-     * @type {boolean}
-     * @memberof ContextStatsResponse
-     */
-    running?: boolean;
-    /**
-     *
-     * @type {boolean}
-     * @memberof ContextStatsResponse
-     */
-    paused?: boolean;
-    /**
-     *
-     * @type {ResourceUsage}
-     * @memberof ContextStatsResponse
-     */
-    usage?: ResourceUsage;
-}
-/**
- * Check if a given object implements the ContextStatsResponse interface.
- */
-export declare function instanceOfContextStatsResponse(value: object): value is ContextStatsResponse;
-export declare function ContextStatsResponseFromJSON(json: any): ContextStatsResponse;
-export declare function ContextStatsResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): ContextStatsResponse;
-export declare function ContextStatsResponseToJSON(json: any): ContextStatsResponse;
-export declare function ContextStatsResponseToJSONTyped(value?: ContextStatsResponse | null, ignoreDiscriminator?: boolean): any;
-//# sourceMappingURL=ContextStatsResponse.d.ts.map