sandbox0 0.7.6 → 0.7.8

package/README.md

@@ -85,6 +85,53 @@ for (const mount of sandbox.bootstrapMounts) {
 }
 ```
 
+## Wait For Lifecycle Changes
+
+Pause is accepted before its rootfs checkpoint is fully committed. Use the
+waiting helpers when the next operation depends on committed lifecycle state:
+
+```typescript
+const paused = await client.sandboxes.pauseAndWait(sandbox.id, {
+  timeoutMs: 120_000,
+  signal: abortController.signal,
+});
+
+const resumed = await client.sandboxes.resumeAndWait(paused.id);
+console.log(resumed.status, resumed.runtimeGeneration);
+```
+
+`waitForLifecycle()` is available for other committed-state conditions. Aborting
+a wait stops polling locally; it does not undo a pause or resume already accepted
+by Sandbox0.
+
+## Runtime Metrics
+
+`getMetrics()` returns bounded, chart-ready sandbox metrics. Each series is split
+into segments at runtime restarts and collector resets, so chart segments should
+not be connected across those boundaries.
+
+```typescript
+import { SandboxRuntimeMetricName } from "sandbox0";
+
+const metrics = await sandbox.getMetrics({
+  startTime: new Date(Date.now() - 60 * 60 * 1000),
+  metrics: [
+    SandboxRuntimeMetricName.SandboxCpuUtilization,
+    SandboxRuntimeMetricName.SandboxMemoryUtilization,
+  ],
+  maxPoints: 240,
+});
+
+for (const series of metrics.series) {
+  for (const segment of series.segments) {
+    console.log(series.metric, segment.points);
+  }
+}
+```
+
+Use `sandbox.getMetricsCatalog()` to discover metric kinds, units, and
+dimensions supported by the API.
+
 ## Links
 
 - [Documentation](https://sandbox0.ai/docs)

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

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime.js';
-import type { ObservabilityEventSource, SandboxObservabilityEventType, SandboxObservabilityLogStream, SandboxObservabilityOutcome, SuccessSandboxObservabilityEventsResponse, SuccessSandboxObservabilityLogsResponse, SuccessSandboxObservabilityMetricsResponse } from '../models/index.js';
+import type { ObservabilityEventSource, SandboxObservabilityEventType, SandboxObservabilityLogStream, SandboxObservabilityOutcome, SandboxRuntimeMetricStatistic, SuccessSandboxObservabilityEventsResponse, SuccessSandboxObservabilityLogsResponse, SuccessSandboxRuntimeMetricsCatalogResponse, SuccessSandboxRuntimeMetricsResponse } from '../models/index.js';
 export interface ApiV1SandboxesIdObservabilityEventsGetRequest {
     id: string;
     startTime?: Date;
@@ -32,28 +32,29 @@ export interface ApiV1SandboxesIdObservabilityLogsGetRequest {
     contextId?: string;
     stream?: SandboxObservabilityLogStream;
 }
-export interface ApiV1SandboxesIdObservabilityMetricsGetRequest {
+export interface GetSandboxRuntimeMetricsRequest {
     id: string;
     startTime?: Date;
     endTime?: Date;
-    limit?: number;
-    cursor?: string;
-    watch?: boolean;
-    contextId?: string;
-    name?: Array<string>;
-    names?: string;
+    metrics?: string;
+    stepSeconds?: number;
+    statistic?: SandboxRuntimeMetricStatistic;
+    maxPoints?: number;
+}
+export interface GetSandboxRuntimeMetricsCatalogRequest {
+    id: string;
 }
 /**
  *
  */
 export declare class ObservabilityApi extends runtime.BaseAPI {
     /**
-     * Queries the asynchronous per-sandbox observability projection for lifecycle, network audit, and runtime stats events. This endpoint does not expose backend SQL and does not replace the metering usage truth stored in PostgreSQL.
+     * Queries the asynchronous per-sandbox observability projection for lifecycle, network audit, and runtime stats events. This endpoint does not expose backend SQL and reads tables that are separate from the metering usage ledger.
      * Query historical sandbox observability events
      */
     apiV1SandboxesIdObservabilityEventsGetRaw(requestParameters: ApiV1SandboxesIdObservabilityEventsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessSandboxObservabilityEventsResponse>>;
     /**
-     * Queries the asynchronous per-sandbox observability projection for lifecycle, network audit, and runtime stats events. This endpoint does not expose backend SQL and does not replace the metering usage truth stored in PostgreSQL.
+     * Queries the asynchronous per-sandbox observability projection for lifecycle, network audit, and runtime stats events. This endpoint does not expose backend SQL and reads tables that are separate from the metering usage ledger.
      * Query historical sandbox observability events
      */
     apiV1SandboxesIdObservabilityEventsGet(requestParameters: ApiV1SandboxesIdObservabilityEventsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessSandboxObservabilityEventsResponse>;
@@ -68,14 +69,24 @@ export declare class ObservabilityApi extends runtime.BaseAPI {
      */
     apiV1SandboxesIdObservabilityLogsGet(requestParameters: ApiV1SandboxesIdObservabilityLogsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessSandboxObservabilityLogsResponse>;
     /**
-     * Queries the asynchronous per-sandbox metric sample projection. This endpoint is separate from platform service metrics and PostgreSQL metering usage truth.
-     * Query historical sandbox metric samples
+     * Returns bounded, downsampled sandbox-wide runtime series. When timestamps are omitted, the query covers the hour ending now. The maximum range is 30 days. Counter rates never cross a runtime reset boundary. Missing data is reported as gaps and is never synthesized as zero. This endpoint is separate from platform service metrics and metering usage truth.
+     * Query chart-ready sandbox runtime metrics
+     */
+    getSandboxRuntimeMetricsRaw(requestParameters: GetSandboxRuntimeMetricsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessSandboxRuntimeMetricsResponse>>;
+    /**
+     * Returns bounded, downsampled sandbox-wide runtime series. When timestamps are omitted, the query covers the hour ending now. The maximum range is 30 days. Counter rates never cross a runtime reset boundary. Missing data is reported as gaps and is never synthesized as zero. This endpoint is separate from platform service metrics and metering usage truth.
+     * Query chart-ready sandbox runtime metrics
+     */
+    getSandboxRuntimeMetrics(requestParameters: GetSandboxRuntimeMetricsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessSandboxRuntimeMetricsResponse>;
+    /**
+     * Returns the bounded canonical metric names, kinds, units, and dimensions supported by the runtime metrics API.
+     * Get the sandbox runtime metric catalog
      */
-    apiV1SandboxesIdObservabilityMetricsGetRaw(requestParameters: ApiV1SandboxesIdObservabilityMetricsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessSandboxObservabilityMetricsResponse>>;
+    getSandboxRuntimeMetricsCatalogRaw(requestParameters: GetSandboxRuntimeMetricsCatalogRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessSandboxRuntimeMetricsCatalogResponse>>;
     /**
-     * Queries the asynchronous per-sandbox metric sample projection. This endpoint is separate from platform service metrics and PostgreSQL metering usage truth.
-     * Query historical sandbox metric samples
+     * Returns the bounded canonical metric names, kinds, units, and dimensions supported by the runtime metrics API.
+     * Get the sandbox runtime metric catalog
      */
-    apiV1SandboxesIdObservabilityMetricsGet(requestParameters: ApiV1SandboxesIdObservabilityMetricsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessSandboxObservabilityMetricsResponse>;
+    getSandboxRuntimeMetricsCatalog(requestParameters: GetSandboxRuntimeMetricsCatalogRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessSandboxRuntimeMetricsCatalogResponse>;
 }
 //# sourceMappingURL=ObservabilityApi.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ObservabilityApi.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/apis/ObservabilityApi.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAEV,wBAAwB,EACxB,6BAA6B,EAC7B,6BAA6B,EAC7B,2BAA2B,EAE3B,yCAAyC,EACzC,uCAAuC,EACvC,0CAA0C,EAC3C,MAAM,iBAAiB,CAAC;AAsBzB,MAAM,WAAW,6CAA6C;IAC1D,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,MAAM,WAAW,2CAA2C;IACxD,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,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,6BAA6B,CAAC;CAC1C;AAED,MAAM,WAAW,8CAA8C;IAC3D,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,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,OAAO,CAAC,OAAO;IAEjD;;;OAGG;IACG,yCAAyC,CAAC,iBAAiB,EAAE,6CAA6C,EAAE,aAAa,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,yCAAyC,CAAC,CAAC;IAkEtP;;;OAGG;IACG,sCAAsC,CAAC,iBAAiB,EAAE,6CAA6C,EAAE,aAAa,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,GAAG,OAAO,CAAC,yCAAyC,CAAC;IAK9N;;;OAGG;IACG,uCAAuC,CAAC,iBAAiB,EAAE,2CAA2C,EAAE,aAAa,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,uCAAuC,CAAC,CAAC;IA8DhP;;;OAGG;IACG,oCAAoC,CAAC,iBAAiB,EAAE,2CAA2C,EAAE,aAAa,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,GAAG,OAAO,CAAC,uCAAuC,CAAC;IAKxN;;;OAGG;IACG,0CAA0C,CAAC,iBAAiB,EAAE,8CAA8C,EAAE,aAAa,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,0CAA0C,CAAC,CAAC;IAkEzP;;;OAGG;IACG,uCAAuC,CAAC,iBAAiB,EAAE,8CAA8C,EAAE,aAAa,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,GAAG,OAAO,CAAC,0CAA0C,CAAC;CAKpO"}
+{"version":3,"file":"ObservabilityApi.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/apis/ObservabilityApi.ts"],"names":[],"mappings":"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"}

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

@@ -12,13 +12,13 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime.js';
-import { SuccessSandboxObservabilityEventsResponseFromJSON, SuccessSandboxObservabilityLogsResponseFromJSON, SuccessSandboxObservabilityMetricsResponseFromJSON, } from '../models/index.js';
+import { SuccessSandboxObservabilityEventsResponseFromJSON, SuccessSandboxObservabilityLogsResponseFromJSON, SuccessSandboxRuntimeMetricsCatalogResponseFromJSON, SuccessSandboxRuntimeMetricsResponseFromJSON, } from '../models/index.js';
 /**
  *
  */
 export class ObservabilityApi extends runtime.BaseAPI {
     /**
-     * Queries the asynchronous per-sandbox observability projection for lifecycle, network audit, and runtime stats events. This endpoint does not expose backend SQL and does not replace the metering usage truth stored in PostgreSQL.
+     * Queries the asynchronous per-sandbox observability projection for lifecycle, network audit, and runtime stats events. This endpoint does not expose backend SQL and reads tables that are separate from the metering usage ledger.
      * Query historical sandbox observability events
      */
     async apiV1SandboxesIdObservabilityEventsGetRaw(requestParameters, initOverrides) {
@@ -69,7 +69,7 @@ export class ObservabilityApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => SuccessSandboxObservabilityEventsResponseFromJSON(jsonValue));
     }
     /**
-     * Queries the asynchronous per-sandbox observability projection for lifecycle, network audit, and runtime stats events. This endpoint does not expose backend SQL and does not replace the metering usage truth stored in PostgreSQL.
+     * Queries the asynchronous per-sandbox observability projection for lifecycle, network audit, and runtime stats events. This endpoint does not expose backend SQL and reads tables that are separate from the metering usage ledger.
      * Query historical sandbox observability events
      */
     async apiV1SandboxesIdObservabilityEventsGet(requestParameters, initOverrides) {
@@ -133,12 +133,12 @@ export class ObservabilityApi extends runtime.BaseAPI {
         return await response.value();
     }
     /**
-     * Queries the asynchronous per-sandbox metric sample projection. This endpoint is separate from platform service metrics and PostgreSQL metering usage truth.
-     * Query historical sandbox metric samples
+     * Returns bounded, downsampled sandbox-wide runtime series. When timestamps are omitted, the query covers the hour ending now. The maximum range is 30 days. Counter rates never cross a runtime reset boundary. Missing data is reported as gaps and is never synthesized as zero. This endpoint is separate from platform service metrics and metering usage truth.
+     * Query chart-ready sandbox runtime metrics
      */
-    async apiV1SandboxesIdObservabilityMetricsGetRaw(requestParameters, initOverrides) {
+    async getSandboxRuntimeMetricsRaw(requestParameters, initOverrides) {
         if (requestParameters['id'] == null) {
-            throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling apiV1SandboxesIdObservabilityMetricsGet().');
+            throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling getSandboxRuntimeMetrics().');
         }
         const queryParameters = {};
         if (requestParameters['startTime'] != null) {
@@ -147,24 +147,53 @@ export class ObservabilityApi extends runtime.BaseAPI {
         if (requestParameters['endTime'] != null) {
             queryParameters['end_time'] = requestParameters['endTime'].toISOString();
         }
-        if (requestParameters['limit'] != null) {
-            queryParameters['limit'] = requestParameters['limit'];
+        if (requestParameters['metrics'] != null) {
+            queryParameters['metrics'] = requestParameters['metrics'];
         }
-        if (requestParameters['cursor'] != null) {
-            queryParameters['cursor'] = requestParameters['cursor'];
+        if (requestParameters['stepSeconds'] != null) {
+            queryParameters['step_seconds'] = requestParameters['stepSeconds'];
         }
-        if (requestParameters['watch'] != null) {
-            queryParameters['watch'] = requestParameters['watch'];
+        if (requestParameters['statistic'] != null) {
+            queryParameters['statistic'] = requestParameters['statistic'];
         }
-        if (requestParameters['contextId'] != null) {
-            queryParameters['context_id'] = requestParameters['contextId'];
+        if (requestParameters['maxPoints'] != null) {
+            queryParameters['max_points'] = requestParameters['maxPoints'];
         }
-        if (requestParameters['name'] != null) {
-            queryParameters['name'] = requestParameters['name'];
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
         }
-        if (requestParameters['names'] != null) {
-            queryParameters['names'] = requestParameters['names'];
+        let urlPath = `/api/v1/sandboxes/{id}/metrics`;
+        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) => SuccessSandboxRuntimeMetricsResponseFromJSON(jsonValue));
+    }
+    /**
+     * Returns bounded, downsampled sandbox-wide runtime series. When timestamps are omitted, the query covers the hour ending now. The maximum range is 30 days. Counter rates never cross a runtime reset boundary. Missing data is reported as gaps and is never synthesized as zero. This endpoint is separate from platform service metrics and metering usage truth.
+     * Query chart-ready sandbox runtime metrics
+     */
+    async getSandboxRuntimeMetrics(requestParameters, initOverrides) {
+        const response = await this.getSandboxRuntimeMetricsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Returns the bounded canonical metric names, kinds, units, and dimensions supported by the runtime metrics API.
+     * Get the sandbox runtime metric catalog
+     */
+    async getSandboxRuntimeMetricsCatalogRaw(requestParameters, initOverrides) {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling getSandboxRuntimeMetricsCatalog().');
         }
+        const queryParameters = {};
         const headerParameters = {};
         if (this.configuration && this.configuration.accessToken) {
             const token = this.configuration.accessToken;
@@ -173,7 +202,7 @@ export class ObservabilityApi extends runtime.BaseAPI {
                 headerParameters["Authorization"] = `Bearer ${tokenString}`;
             }
         }
-        let urlPath = `/api/v1/sandboxes/{id}/observability/metrics`;
+        let urlPath = `/api/v1/sandboxes/{id}/metrics/catalog`;
         urlPath = urlPath.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id'])));
         const response = await this.request({
             path: urlPath,
@@ -181,14 +210,14 @@ export class ObservabilityApi extends runtime.BaseAPI {
             headers: headerParameters,
             query: queryParameters,
         }, initOverrides);
-        return new runtime.JSONApiResponse(response, (jsonValue) => SuccessSandboxObservabilityMetricsResponseFromJSON(jsonValue));
+        return new runtime.JSONApiResponse(response, (jsonValue) => SuccessSandboxRuntimeMetricsCatalogResponseFromJSON(jsonValue));
     }
     /**
-     * Queries the asynchronous per-sandbox metric sample projection. This endpoint is separate from platform service metrics and PostgreSQL metering usage truth.
-     * Query historical sandbox metric samples
+     * Returns the bounded canonical metric names, kinds, units, and dimensions supported by the runtime metrics API.
+     * Get the sandbox runtime metric catalog
      */
-    async apiV1SandboxesIdObservabilityMetricsGet(requestParameters, initOverrides) {
-        const response = await this.apiV1SandboxesIdObservabilityMetricsGetRaw(requestParameters, initOverrides);
+    async getSandboxRuntimeMetricsCatalog(requestParameters, initOverrides) {
+        const response = await this.getSandboxRuntimeMetricsCatalogRaw(requestParameters, initOverrides);
         return await response.value();
     }
 }

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

@@ -53,11 +53,13 @@ export declare class SandboxRootfsApi extends runtime.BaseAPI {
      */
     apiV1SandboxRootfsSnapshotsSnapshotIdGet(requestParameters: ApiV1SandboxRootfsSnapshotsSnapshotIdGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessSandboxRootFSSnapshotResponse>;
     /**
-     * Fork sandbox from paused rootfs
+     * Forks the source sandbox writable rootfs into a new paused sandbox. A paused source is forked from its current rootfs head. A running source is briefly barriered and checkpointed first; the source sandbox remains running after the fork operation completes.
+     * Fork sandbox rootfs
      */
     apiV1SandboxesIdForkPostRaw(requestParameters: ApiV1SandboxesIdForkPostRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessForkSandboxResponse>>;
     /**
-     * Fork sandbox from paused rootfs
+     * Forks the source sandbox writable rootfs into a new paused sandbox. A paused source is forked from its current rootfs head. A running source is briefly barriered and checkpointed first; the source sandbox remains running after the fork operation completes.
+     * Fork sandbox rootfs
      */
     apiV1SandboxesIdForkPost(requestParameters: ApiV1SandboxesIdForkPostRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessForkSandboxResponse>;
     /**
@@ -77,10 +79,12 @@ export declare class SandboxRootfsApi extends runtime.BaseAPI {
      */
     apiV1SandboxesIdSnapshotsGet(requestParameters: ApiV1SandboxesIdSnapshotsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessSandboxRootFSSnapshotListResponse>;
     /**
+     * Creates an immutable snapshot record from the source sandbox writable rootfs. A paused source is snapshotted from its current rootfs head. A running source is briefly barriered and checkpointed first; the source sandbox remains running after the snapshot operation completes.
      * Create sandbox rootfs snapshot
      */
     apiV1SandboxesIdSnapshotsPostRaw(requestParameters: ApiV1SandboxesIdSnapshotsPostRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessSandboxRootFSSnapshotResponse>>;
     /**
+     * Creates an immutable snapshot record from the source sandbox writable rootfs. A paused source is snapshotted from its current rootfs head. A running source is briefly barriered and checkpointed first; the source sandbox remains running after the snapshot operation completes.
      * Create sandbox rootfs snapshot
      */
     apiV1SandboxesIdSnapshotsPost(requestParameters: ApiV1SandboxesIdSnapshotsPostRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessSandboxRootFSSnapshotResponse>;

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

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

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

@@ -84,7 +84,8 @@ export class SandboxRootfsApi extends runtime.BaseAPI {
         return await response.value();
     }
     /**
-     * Fork sandbox from paused rootfs
+     * Forks the source sandbox writable rootfs into a new paused sandbox. A paused source is forked from its current rootfs head. A running source is briefly barriered and checkpointed first; the source sandbox remains running after the fork operation completes.
+     * Fork sandbox rootfs
      */
     async apiV1SandboxesIdForkPostRaw(requestParameters, initOverrides) {
         if (requestParameters['id'] == null) {
@@ -112,7 +113,8 @@ export class SandboxRootfsApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => SuccessForkSandboxResponseFromJSON(jsonValue));
     }
     /**
-     * Fork sandbox from paused rootfs
+     * Forks the source sandbox writable rootfs into a new paused sandbox. A paused source is forked from its current rootfs head. A running source is briefly barriered and checkpointed first; the source sandbox remains running after the fork operation completes.
+     * Fork sandbox rootfs
      */
     async apiV1SandboxesIdForkPost(requestParameters, initOverrides) {
         const response = await this.apiV1SandboxesIdForkPostRaw(requestParameters, initOverrides);
@@ -190,6 +192,7 @@ export class SandboxRootfsApi extends runtime.BaseAPI {
         return await response.value();
     }
     /**
+     * Creates an immutable snapshot record from the source sandbox writable rootfs. A paused source is snapshotted from its current rootfs head. A running source is briefly barriered and checkpointed first; the source sandbox remains running after the snapshot operation completes.
      * Create sandbox rootfs snapshot
      */
     async apiV1SandboxesIdSnapshotsPostRaw(requestParameters, initOverrides) {
@@ -218,6 +221,7 @@ export class SandboxRootfsApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => SuccessSandboxRootFSSnapshotResponseFromJSON(jsonValue));
     }
     /**
+     * Creates an immutable snapshot record from the source sandbox writable rootfs. A paused source is snapshotted from its current rootfs head. A running source is briefly barriered and checkpointed first; the source sandbox remains running after the snapshot operation completes.
      * Create sandbox rootfs snapshot
      */
     async apiV1SandboxesIdSnapshotsPost(requestParameters, initOverrides) {

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

@@ -1,5 +1,4 @@
 export * from './ApiKeysApi.js';
-export * from './AuditApi.js';
 export * from './AuthApi.js';
 export * from './ContextsApi.js';
 export * from './CredentialSourcesApi.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/apis/index.ts"],"names":[],"mappings":"AAEA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/apis/index.ts"],"names":[],"mappings":"AAEA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

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

@@ -1,7 +1,6 @@
 /* tslint:disable */
 /* eslint-disable */
 export * from './ApiKeysApi.js';
-export * from './AuditApi.js';
 export * from './AuthApi.js';
 export * from './ContextsApi.js';
 export * from './CredentialSourcesApi.js';

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

@@ -10,6 +10,8 @@
  * Do not edit the class manually.
  */
 /**
+ * Optional snapshot metadata. The source sandbox may be running or paused;
+ * running sources are checkpointed before the snapshot record is created.
  *
  * @export
  * @interface CreateSandboxRootFSSnapshotRequest

package/dist/apispec/src/models/CreateSandboxRootFSSnapshotRequest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CreateSandboxRootFSSnapshotRequest.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/models/CreateSandboxRootFSSnapshotRequest.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAGH;;;;GAIG;AACH,MAAM,WAAW,kCAAkC;IAC/C;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,4CAA4C,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,kCAAkC,CAEvH;AAED,wBAAgB,0CAA0C,CAAC,IAAI,EAAE,GAAG,GAAG,kCAAkC,CAExG;AAED,wBAAgB,+CAA+C,CAAC,IAAI,EAAE,GAAG,EAAE,mBAAmB,EAAE,OAAO,GAAG,kCAAkC,CAU3I;AAED,wBAAgB,wCAAwC,CAAC,IAAI,EAAE,GAAG,GAAG,kCAAkC,CAEtG;AAED,wBAAgB,6CAA6C,CAAC,KAAK,CAAC,EAAE,kCAAkC,GAAG,IAAI,EAAE,mBAAmB,GAAE,OAAe,GAAG,GAAG,CAW1J"}
+{"version":3,"file":"CreateSandboxRootFSSnapshotRequest.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/models/CreateSandboxRootFSSnapshotRequest.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAGH;;;;;;GAMG;AACH,MAAM,WAAW,kCAAkC;IAC/C;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,4CAA4C,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,kCAAkC,CAEvH;AAED,wBAAgB,0CAA0C,CAAC,IAAI,EAAE,GAAG,GAAG,kCAAkC,CAExG;AAED,wBAAgB,+CAA+C,CAAC,IAAI,EAAE,GAAG,EAAE,mBAAmB,EAAE,OAAO,GAAG,kCAAkC,CAU3I;AAED,wBAAgB,wCAAwC,CAAC,IAAI,EAAE,GAAG,GAAG,kCAAkC,CAEtG;AAED,wBAAgB,6CAA6C,CAAC,KAAK,CAAC,EAAE,kCAAkC,GAAG,IAAI,EAAE,mBAAmB,GAAE,OAAe,GAAG,GAAG,CAW1J"}

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

@@ -34,29 +34,29 @@ export interface CreateSandboxVolumeS3Config {
      */
     prefix?: string;
     /**
-     * Optional region override. Defaults to the storage-proxy S3 region when omitted.
+     * AWS region for the target bucket. Required for provider aws unless endpoint_url is provided.
      * @type {string}
      * @memberof CreateSandboxVolumeS3Config
      */
     region?: string;
     /**
-     * Optional endpoint override. Required for ali and r2.
+     * Optional endpoint override. Required for ali and r2. For aws, endpoint_url can be used instead of region for S3-compatible endpoints.
      * @type {string}
      * @memberof CreateSandboxVolumeS3Config
      */
     endpointUrl?: string;
     /**
-     * Optional access key override. Must be provided together with secret_key.
+     * Access key for this S3 backend volume. Required with secret_key. Stored encrypted and omitted from API responses.
      * @type {string}
      * @memberof CreateSandboxVolumeS3Config
      */
-    accessKey?: string;
+    accessKey: string;
     /**
-     * Optional secret key override. Must be provided together with access_key.
+     * Secret key for this S3 backend volume. Required with access_key. Stored encrypted and omitted from API responses.
      * @type {string}
      * @memberof CreateSandboxVolumeS3Config
      */
-    secretKey?: string;
+    secretKey: string;
     /**
      * Optional temporary credential session token.
      * @type {string}

package/dist/apispec/src/models/CreateSandboxVolumeS3Config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CreateSandboxVolumeS3Config.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/models/CreateSandboxVolumeS3Config.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAGH;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IACxC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,uCAAuC,CAAC;IACnD;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAGD;;GAEG;AACH,eAAO,MAAM,uCAAuC;;;;CAI1C,CAAC;AACX,MAAM,MAAM,uCAAuC,GAAG,OAAO,uCAAuC,CAAC,MAAM,OAAO,uCAAuC,CAAC,CAAC;AAG3J;;GAEG;AACH,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,2BAA2B,CAGzG;AAED,wBAAgB,mCAAmC,CAAC,IAAI,EAAE,GAAG,GAAG,2BAA2B,CAE1F;AAED,wBAAgB,wCAAwC,CAAC,IAAI,EAAE,GAAG,EAAE,mBAAmB,EAAE,OAAO,GAAG,2BAA2B,CAe7H;AAED,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,GAAG,GAAG,2BAA2B,CAExF;AAED,wBAAgB,sCAAsC,CAAC,KAAK,CAAC,EAAE,2BAA2B,GAAG,IAAI,EAAE,mBAAmB,GAAE,OAAe,GAAG,GAAG,CAgB5I"}
+{"version":3,"file":"CreateSandboxVolumeS3Config.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/models/CreateSandboxVolumeS3Config.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAGH;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IACxC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,uCAAuC,CAAC;IACnD;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAGD;;GAEG;AACH,eAAO,MAAM,uCAAuC;;;;CAI1C,CAAC;AACX,MAAM,MAAM,uCAAuC,GAAG,OAAO,uCAAuC,CAAC,MAAM,OAAO,uCAAuC,CAAC,CAAC;AAG3J;;GAEG;AACH,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,2BAA2B,CAKzG;AAED,wBAAgB,mCAAmC,CAAC,IAAI,EAAE,GAAG,GAAG,2BAA2B,CAE1F;AAED,wBAAgB,wCAAwC,CAAC,IAAI,EAAE,GAAG,EAAE,mBAAmB,EAAE,OAAO,GAAG,2BAA2B,CAe7H;AAED,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,GAAG,GAAG,2BAA2B,CAExF;AAED,wBAAgB,sCAAsC,CAAC,KAAK,CAAC,EAAE,2BAA2B,GAAG,IAAI,EAAE,mBAAmB,GAAE,OAAe,GAAG,GAAG,CAgB5I"}

package/dist/apispec/src/models/CreateSandboxVolumeS3Config.js

@@ -25,6 +25,10 @@ export const CreateSandboxVolumeS3ConfigProviderEnum = {
 export function instanceOfCreateSandboxVolumeS3Config(value) {
     if (!('bucket' in value) || value['bucket'] === undefined)
         return false;
+    if (!('accessKey' in value) || value['accessKey'] === undefined)
+        return false;
+    if (!('secretKey' in value) || value['secretKey'] === undefined)
+        return false;
     return true;
 }
 export function CreateSandboxVolumeS3ConfigFromJSON(json) {
@@ -40,8 +44,8 @@ export function CreateSandboxVolumeS3ConfigFromJSONTyped(json, ignoreDiscriminat
         'prefix': json['prefix'] == null ? undefined : json['prefix'],
         'region': json['region'] == null ? undefined : json['region'],
         'endpointUrl': json['endpoint_url'] == null ? undefined : json['endpoint_url'],
-        'accessKey': json['access_key'] == null ? undefined : json['access_key'],
-        'secretKey': json['secret_key'] == null ? undefined : json['secret_key'],
+        'accessKey': json['access_key'],
+        'secretKey': json['secret_key'],
         'sessionToken': json['session_token'] == null ? undefined : json['session_token'],
     };
 }

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

@@ -12,6 +12,8 @@
 import type { ForkSandboxConfig } from './ForkSandboxConfig.js';
 /**
  * Optional fork overrides. Omit config to inherit the source sandbox configuration.
+ * The source sandbox may be running or paused; running sources are checkpointed
+ * before the paused child sandbox is created.
  *
  * @export
  * @interface ForkSandboxRequest

package/dist/apispec/src/models/ForkSandboxRequest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ForkSandboxRequest.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/models/ForkSandboxRequest.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAQ7D;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;;;OAIG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,kBAAkB,CAEvF;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,GAAG,GAAG,kBAAkB,CAExE;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,GAAG,EAAE,mBAAmB,EAAE,OAAO,GAAG,kBAAkB,CAQ3G;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,GAAG,GAAG,kBAAkB,CAEtE;AAED,wBAAgB,6BAA6B,CAAC,KAAK,CAAC,EAAE,kBAAkB,GAAG,IAAI,EAAE,mBAAmB,GAAE,OAAe,GAAG,GAAG,CAS1H"}
+{"version":3,"file":"ForkSandboxRequest.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/models/ForkSandboxRequest.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAQ7D;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;;;OAIG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,kBAAkB,CAEvF;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,GAAG,GAAG,kBAAkB,CAExE;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,GAAG,EAAE,mBAAmB,EAAE,OAAO,GAAG,kBAAkB,CAQ3G;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,GAAG,GAAG,kBAAkB,CAEtE;AAED,wBAAgB,6BAA6B,CAAC,KAAK,CAAC,EAAE,kBAAkB,GAAG,IAAI,EAAE,mBAAmB,GAAE,OAAe,GAAG,GAAG,CAS1H"}

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

@@ -59,7 +59,6 @@ export interface SandboxObservabilityWatchLine {
 export declare const SandboxObservabilityWatchLineTypeEnum: {
     readonly Event: "event";
     readonly Log: "log";
-    readonly MetricSample: "metric_sample";
     readonly Watermark: "watermark";
     readonly Heartbeat: "heartbeat";
     readonly Error: "error";

package/dist/apispec/src/models/SandboxObservabilityWatchLine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SandboxObservabilityWatchLine.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/models/SandboxObservabilityWatchLine.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAC;AAQ7F;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC1C;;;;OAIG;IACH,IAAI,EAAE,qCAAqC,CAAC;IAC5C;;;;OAIG;IACH,IAAI,CAAC,EAAE,iCAAiC,CAAC;IACzC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAGD;;GAEG;AACH,eAAO,MAAM,qCAAqC;;;;;;;CAOxC,CAAC;AACX,MAAM,MAAM,qCAAqC,GAAG,OAAO,qCAAqC,CAAC,MAAM,OAAO,qCAAqC,CAAC,CAAC;AAGrJ;;GAEG;AACH,wBAAgB,uCAAuC,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,6BAA6B,CAG7G;AAED,wBAAgB,qCAAqC,CAAC,IAAI,EAAE,GAAG,GAAG,6BAA6B,CAE9F;AAED,wBAAgB,0CAA0C,CAAC,IAAI,EAAE,GAAG,EAAE,mBAAmB,EAAE,OAAO,GAAG,6BAA6B,CAajI;AAED,wBAAgB,mCAAmC,CAAC,IAAI,EAAE,GAAG,GAAG,6BAA6B,CAE5F;AAED,wBAAgB,wCAAwC,CAAC,KAAK,CAAC,EAAE,6BAA6B,GAAG,IAAI,EAAE,mBAAmB,GAAE,OAAe,GAAG,GAAG,CAchJ"}
+{"version":3,"file":"SandboxObservabilityWatchLine.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/models/SandboxObservabilityWatchLine.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAC;AAQ7F;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC1C;;;;OAIG;IACH,IAAI,EAAE,qCAAqC,CAAC;IAC5C;;;;OAIG;IACH,IAAI,CAAC,EAAE,iCAAiC,CAAC;IACzC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAGD;;GAEG;AACH,eAAO,MAAM,qCAAqC;;;;;;CAMxC,CAAC;AACX,MAAM,MAAM,qCAAqC,GAAG,OAAO,qCAAqC,CAAC,MAAM,OAAO,qCAAqC,CAAC,CAAC;AAGrJ;;GAEG;AACH,wBAAgB,uCAAuC,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,6BAA6B,CAG7G;AAED,wBAAgB,qCAAqC,CAAC,IAAI,EAAE,GAAG,GAAG,6BAA6B,CAE9F;AAED,wBAAgB,0CAA0C,CAAC,IAAI,EAAE,GAAG,EAAE,mBAAmB,EAAE,OAAO,GAAG,6BAA6B,CAajI;AAED,wBAAgB,mCAAmC,CAAC,IAAI,EAAE,GAAG,GAAG,6BAA6B,CAE5F;AAED,wBAAgB,wCAAwC,CAAC,KAAK,CAAC,EAAE,6BAA6B,GAAG,IAAI,EAAE,mBAAmB,GAAE,OAAe,GAAG,GAAG,CAchJ"}

package/dist/apispec/src/models/SandboxObservabilityWatchLine.js

@@ -18,7 +18,6 @@ import { SandboxObservabilityWatchLineDataFromJSON, SandboxObservabilityWatchLin
 export const SandboxObservabilityWatchLineTypeEnum = {
     Event: 'event',
     Log: 'log',
-    MetricSample: 'metric_sample',
     Watermark: 'watermark',
     Heartbeat: 'heartbeat',
     Error: 'error'

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

@@ -11,13 +11,12 @@
  */
 import type { SandboxObservabilityEvent } from './SandboxObservabilityEvent.js';
 import type { SandboxObservabilityLogEntry } from './SandboxObservabilityLogEntry.js';
-import type { SandboxObservabilityMetricSample } from './SandboxObservabilityMetricSample.js';
 /**
  * @type SandboxObservabilityWatchLineData
  *
  * @export
  */
-export type SandboxObservabilityWatchLineData = SandboxObservabilityEvent | SandboxObservabilityLogEntry | SandboxObservabilityMetricSample;
+export type SandboxObservabilityWatchLineData = SandboxObservabilityEvent | SandboxObservabilityLogEntry;
 export declare function SandboxObservabilityWatchLineDataFromJSON(json: any): SandboxObservabilityWatchLineData;
 export declare function SandboxObservabilityWatchLineDataFromJSONTyped(json: any, ignoreDiscriminator: boolean): SandboxObservabilityWatchLineData;
 export declare function SandboxObservabilityWatchLineDataToJSON(json: any): any;

package/dist/apispec/src/models/SandboxObservabilityWatchLineData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SandboxObservabilityWatchLineData.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/models/SandboxObservabilityWatchLineData.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAO7E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAOnF,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,oCAAoC,CAAC;AAQ3F;;;;GAIG;AACH,MAAM,MAAM,iCAAiC,GAAG,yBAAyB,GAAG,4BAA4B,GAAG,gCAAgC,CAAC;AAE5I,wBAAgB,yCAAyC,CAAC,IAAI,EAAE,GAAG,GAAG,iCAAiC,CAEtG;AAED,wBAAgB,8CAA8C,CAAC,IAAI,EAAE,GAAG,EAAE,mBAAmB,EAAE,OAAO,GAAG,iCAAiC,CAiBzI;AAED,wBAAgB,uCAAuC,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAEtE;AAED,wBAAgB,4CAA4C,CAAC,KAAK,CAAC,EAAE,iCAAiC,GAAG,IAAI,EAAE,mBAAmB,GAAE,OAAe,GAAG,GAAG,CAiBxJ"}
+{"version":3,"file":"SandboxObservabilityWatchLineData.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/models/SandboxObservabilityWatchLineData.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAO7E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAQnF;;;;GAIG;AACH,MAAM,MAAM,iCAAiC,GAAG,yBAAyB,GAAG,4BAA4B,CAAC;AAEzG,wBAAgB,yCAAyC,CAAC,IAAI,EAAE,GAAG,GAAG,iCAAiC,CAEtG;AAED,wBAAgB,8CAA8C,CAAC,IAAI,EAAE,GAAG,EAAE,mBAAmB,EAAE,OAAO,GAAG,iCAAiC,CAczI;AAED,wBAAgB,uCAAuC,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAEtE;AAED,wBAAgB,4CAA4C,CAAC,KAAK,CAAC,EAAE,iCAAiC,GAAG,IAAI,EAAE,mBAAmB,GAAE,OAAe,GAAG,GAAG,CAcxJ"}

package/dist/apispec/src/models/SandboxObservabilityWatchLineData.js

@@ -13,7 +13,6 @@
  */
 import { instanceOfSandboxObservabilityEvent, SandboxObservabilityEventFromJSONTyped, SandboxObservabilityEventToJSON, } from './SandboxObservabilityEvent.js';
 import { instanceOfSandboxObservabilityLogEntry, SandboxObservabilityLogEntryFromJSONTyped, SandboxObservabilityLogEntryToJSON, } from './SandboxObservabilityLogEntry.js';
-import { instanceOfSandboxObservabilityMetricSample, SandboxObservabilityMetricSampleFromJSONTyped, SandboxObservabilityMetricSampleToJSON, } from './SandboxObservabilityMetricSample.js';
 export function SandboxObservabilityWatchLineDataFromJSON(json) {
     return SandboxObservabilityWatchLineDataFromJSONTyped(json, false);
 }
@@ -30,9 +29,6 @@ export function SandboxObservabilityWatchLineDataFromJSONTyped(json, ignoreDiscr
     if (instanceOfSandboxObservabilityLogEntry(json)) {
         return SandboxObservabilityLogEntryFromJSONTyped(json, true);
     }
-    if (instanceOfSandboxObservabilityMetricSample(json)) {
-        return SandboxObservabilityMetricSampleFromJSONTyped(json, true);
-    }
     return {};
 }
 export function SandboxObservabilityWatchLineDataToJSON(json) {
@@ -51,8 +47,5 @@ export function SandboxObservabilityWatchLineDataToJSONTyped(value, ignoreDiscri
     if (instanceOfSandboxObservabilityLogEntry(value)) {
         return SandboxObservabilityLogEntryToJSON(value);
     }
-    if (instanceOfSandboxObservabilityMetricSample(value)) {
-        return SandboxObservabilityMetricSampleToJSON(value);
-    }
     return {};
 }