langsmith 0.7.12 → 0.7.13

package/dist/_openapi_client/client.cjs

@@ -66,6 +66,7 @@ const info_js_1 = require("./resources/info.cjs");
 const online_evaluators_js_1 = require("./resources/online-evaluators.cjs");
 const datasets_js_1 = require("./resources/datasets/datasets.cjs");
 const runs_js_1 = require("./resources/runs/runs.cjs");
+const sandboxes_js_1 = require("./resources/sandboxes/sandboxes.cjs");
 const sessions_js_1 = require("./resources/sessions/sessions.cjs");
 const headers_js_1 = require("./internal/headers.cjs");
 const env_js_1 = require("./internal/utils/env.cjs");
@@ -187,6 +188,12 @@ class Langsmith {
             writable: true,
             value: new API.Info(this)
         });
+        Object.defineProperty(this, "sandboxes", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new API.Sandboxes(this)
+        });
         const options = {
             apiKey,
             tenantID,
@@ -732,3 +739,4 @@ Langsmith.Datasets = datasets_js_1.Datasets;
 Langsmith.Runs = runs_js_1.Runs;
 Langsmith.OnlineEvaluators = online_evaluators_js_1.OnlineEvaluators;
 Langsmith.Info = info_js_1.Info;
+Langsmith.Sandboxes = sandboxes_js_1.Sandboxes;

package/dist/_openapi_client/client.d.ts

@@ -12,6 +12,7 @@ import { Info, InfoListResponse } from './resources/info.js';
 import { BulkDeleteEvaluatorFailedItem, BulkDeleteEvaluatorsResponse, CreateOnlineCodeEvaluatorRequest, CreateOnlineEvaluatorRequest, CreateOnlineEvaluatorResponse, CreateOnlineLlmEvaluatorRequest, GetOnlineEvaluatorSpendResponse, OnlineCodeEvaluator, OnlineEvaluator, OnlineEvaluatorBulkDeleteParams, OnlineEvaluatorCreateParams, OnlineEvaluatorDeleteParams, OnlineEvaluatorListParams, OnlineEvaluatorRunRule, OnlineEvaluatorSpendDay, OnlineEvaluatorSpendGroup, OnlineEvaluatorSpendParams, OnlineEvaluatorType, OnlineEvaluatorUpdateParams, OnlineEvaluators, OnlineEvaluatorsOffsetPaginationOnlineEvaluators, OnlineLlmEvaluator, OnlineSpendLimit, UpdateOnlineCodeEvaluatorRequest, UpdateOnlineEvaluatorRequest, UpdateOnlineEvaluatorResponse, UpdateOnlineLlmEvaluatorRequest } from './resources/online-evaluators.js';
 import { DataType, Dataset, DatasetCloneParams, DatasetCloneResponse, DatasetCreateParams, DatasetDeleteResponse, DatasetListParams, DatasetRetrieveCsvParams, DatasetRetrieveCsvResponse, DatasetRetrieveJSONLParams, DatasetRetrieveJSONLResponse, DatasetRetrieveOpenAIFtParams, DatasetRetrieveOpenAIFtResponse, DatasetRetrieveOpenAIParams, DatasetRetrieveOpenAIResponse, DatasetRetrieveVersionParams, DatasetTransformation, DatasetUpdateParams, DatasetUpdateResponse, DatasetUpdateTagsParams, DatasetUploadParams, DatasetVersion, Datasets, DatasetsOffsetPaginationTopLevelArray, FeedbackCreateCoreSchema, Missing, SortByDatasetColumn } from './resources/datasets/datasets.js';
 import { QueryRunResponse, QueryRunResponsesItemsCursorPostPagination, ResponseBodyForRunsGenerateQuery, Run, RunQueryParams, RunQueryV2Params, RunRetrieveParams, RunRetrieveV2Params, RunSchema, RunStatsQueryParams, RunTypeEnum, Runs, RunsFilterDataSourceTypeEnum } from './resources/runs/runs.js';
+import { SandboxListResponse, SandboxResponse, SandboxStatusResponse, Sandboxes, ServiceURLResponse, SnapshotListResponse, SnapshotResponse } from './resources/sandboxes/sandboxes.js';
 import { CustomChartsSection, CustomChartsSectionRequest, RunStatsGroupBy, SessionCreateParams, SessionDashboardParams, SessionDeleteResponse, SessionListParams, SessionRetrieveParams, SessionSortableColumns, SessionUpdateParams, Sessions, TimedeltaInput, TracerSession, TracerSessionWithoutVirtualFields, TracerSessionsOffsetPaginationTopLevelArray } from './resources/sessions/sessions.js';
 import { type Fetch } from './internal/builtin-types.js';
 import { HeadersLike, NullableHeaders } from './internal/headers.js';
@@ -190,6 +191,7 @@ export declare class Langsmith {
     runs: API.Runs;
     onlineEvaluators: API.OnlineEvaluators;
     info: API.Info;
+    sandboxes: API.Sandboxes;
 }
 export declare namespace Langsmith {
     export type RequestOptions = Opts.RequestOptions;
@@ -214,4 +216,5 @@ export declare namespace Langsmith {
     export { Runs as Runs, type QueryRunResponse as QueryRunResponse, type ResponseBodyForRunsGenerateQuery as ResponseBodyForRunsGenerateQuery, type Run as Run, type RunSchema as RunSchema, type RunStatsQueryParams as RunStatsQueryParams, type RunTypeEnum as RunTypeEnum, type RunsFilterDataSourceTypeEnum as RunsFilterDataSourceTypeEnum, type QueryRunResponsesItemsCursorPostPagination as QueryRunResponsesItemsCursorPostPagination, type RunQueryV2Params as RunQueryV2Params, type RunRetrieveV2Params as RunRetrieveV2Params, type RunRetrieveParams as RunRetrieveParams, type RunQueryParams as RunQueryParams, };
     export { OnlineEvaluators as OnlineEvaluators, type BulkDeleteEvaluatorFailedItem as BulkDeleteEvaluatorFailedItem, type BulkDeleteEvaluatorsResponse as BulkDeleteEvaluatorsResponse, type CreateOnlineCodeEvaluatorRequest as CreateOnlineCodeEvaluatorRequest, type CreateOnlineEvaluatorRequest as CreateOnlineEvaluatorRequest, type CreateOnlineEvaluatorResponse as CreateOnlineEvaluatorResponse, type CreateOnlineLlmEvaluatorRequest as CreateOnlineLlmEvaluatorRequest, type GetOnlineEvaluatorSpendResponse as GetOnlineEvaluatorSpendResponse, type OnlineCodeEvaluator as OnlineCodeEvaluator, type OnlineEvaluator as OnlineEvaluator, type OnlineEvaluatorRunRule as OnlineEvaluatorRunRule, type OnlineEvaluatorSpendDay as OnlineEvaluatorSpendDay, type OnlineEvaluatorSpendGroup as OnlineEvaluatorSpendGroup, type OnlineEvaluatorType as OnlineEvaluatorType, type OnlineLlmEvaluator as OnlineLlmEvaluator, type OnlineSpendLimit as OnlineSpendLimit, type UpdateOnlineCodeEvaluatorRequest as UpdateOnlineCodeEvaluatorRequest, type UpdateOnlineEvaluatorRequest as UpdateOnlineEvaluatorRequest, type UpdateOnlineEvaluatorResponse as UpdateOnlineEvaluatorResponse, type UpdateOnlineLlmEvaluatorRequest as UpdateOnlineLlmEvaluatorRequest, type OnlineEvaluatorsOffsetPaginationOnlineEvaluators as OnlineEvaluatorsOffsetPaginationOnlineEvaluators, type OnlineEvaluatorCreateParams as OnlineEvaluatorCreateParams, type OnlineEvaluatorUpdateParams as OnlineEvaluatorUpdateParams, type OnlineEvaluatorListParams as OnlineEvaluatorListParams, type OnlineEvaluatorDeleteParams as OnlineEvaluatorDeleteParams, type OnlineEvaluatorBulkDeleteParams as OnlineEvaluatorBulkDeleteParams, type OnlineEvaluatorSpendParams as OnlineEvaluatorSpendParams, };
     export { Info as Info, type InfoListResponse as InfoListResponse };
+    export { Sandboxes as Sandboxes, type SandboxListResponse as SandboxListResponse, type SandboxResponse as SandboxResponse, type SandboxStatusResponse as SandboxStatusResponse, type ServiceURLResponse as ServiceURLResponse, type SnapshotListResponse as SnapshotListResponse, type SnapshotResponse as SnapshotResponse, };
 }

package/dist/_openapi_client/client.js

@@ -30,6 +30,7 @@ import { Info } from './resources/info.js';
 import { OnlineEvaluators, } from './resources/online-evaluators.js';
 import { Datasets, } from './resources/datasets/datasets.js';
 import { Runs, } from './resources/runs/runs.js';
+import { Sandboxes, } from './resources/sandboxes/sandboxes.js';
 import { Sessions, } from './resources/sessions/sessions.js';
 import { buildHeaders } from './internal/headers.js';
 import { readEnv } from './internal/utils/env.js';
@@ -151,6 +152,12 @@ export class Langsmith {
             writable: true,
             value: new API.Info(this)
         });
+        Object.defineProperty(this, "sandboxes", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new API.Sandboxes(this)
+        });
         const options = {
             apiKey,
             tenantID,
@@ -695,3 +702,4 @@ Langsmith.Datasets = Datasets;
 Langsmith.Runs = Runs;
 Langsmith.OnlineEvaluators = OnlineEvaluators;
 Langsmith.Info = Info;
+Langsmith.Sandboxes = Sandboxes;

package/dist/_openapi_client/resources/index.cjs

@@ -2,7 +2,7 @@
 // @ts-nocheck
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Sessions = exports.Runs = exports.OnlineEvaluators = exports.Info = exports.Datasets = void 0;
+exports.Sessions = exports.Sandboxes = exports.Runs = exports.OnlineEvaluators = exports.Info = exports.Datasets = void 0;
 var datasets_js_1 = require("./datasets/datasets.cjs");
 Object.defineProperty(exports, "Datasets", { enumerable: true, get: function () { return datasets_js_1.Datasets; } });
 var info_js_1 = require("./info.cjs");
@@ -11,5 +11,7 @@ var online_evaluators_js_1 = require("./online-evaluators.cjs");
 Object.defineProperty(exports, "OnlineEvaluators", { enumerable: true, get: function () { return online_evaluators_js_1.OnlineEvaluators; } });
 var runs_js_1 = require("./runs/runs.cjs");
 Object.defineProperty(exports, "Runs", { enumerable: true, get: function () { return runs_js_1.Runs; } });
+var sandboxes_js_1 = require("./sandboxes/sandboxes.cjs");
+Object.defineProperty(exports, "Sandboxes", { enumerable: true, get: function () { return sandboxes_js_1.Sandboxes; } });
 var sessions_js_1 = require("./sessions/sessions.cjs");
 Object.defineProperty(exports, "Sessions", { enumerable: true, get: function () { return sessions_js_1.Sessions; } });

package/dist/_openapi_client/resources/index.d.ts

@@ -2,4 +2,5 @@ export { Datasets, type DataType, type Dataset, type DatasetTransformation, type
 export { Info, type InfoListResponse } from './info.js';
 export { OnlineEvaluators, type BulkDeleteEvaluatorFailedItem, type BulkDeleteEvaluatorsResponse, type CreateOnlineCodeEvaluatorRequest, type CreateOnlineEvaluatorRequest, type CreateOnlineEvaluatorResponse, type CreateOnlineLlmEvaluatorRequest, type GetOnlineEvaluatorSpendResponse, type OnlineCodeEvaluator, type OnlineEvaluator, type OnlineEvaluatorRunRule, type OnlineEvaluatorSpendDay, type OnlineEvaluatorSpendGroup, type OnlineEvaluatorType, type OnlineLlmEvaluator, type OnlineSpendLimit, type UpdateOnlineCodeEvaluatorRequest, type UpdateOnlineEvaluatorRequest, type UpdateOnlineEvaluatorResponse, type UpdateOnlineLlmEvaluatorRequest, type OnlineEvaluatorCreateParams, type OnlineEvaluatorUpdateParams, type OnlineEvaluatorListParams, type OnlineEvaluatorDeleteParams, type OnlineEvaluatorBulkDeleteParams, type OnlineEvaluatorSpendParams, type OnlineEvaluatorsOffsetPaginationOnlineEvaluators, } from './online-evaluators.js';
 export { Runs, type QueryRunResponse, type ResponseBodyForRunsGenerateQuery, type Run, type RunSchema, type RunStatsQueryParams, type RunTypeEnum, type RunsFilterDataSourceTypeEnum, type RunQueryV2Params, type RunRetrieveV2Params, type RunRetrieveParams, type RunQueryParams, type QueryRunResponsesItemsCursorPostPagination, } from './runs/runs.js';
+export { Sandboxes, type SandboxListResponse, type SandboxResponse, type SandboxStatusResponse, type ServiceURLResponse, type SnapshotListResponse, type SnapshotResponse, } from './sandboxes/sandboxes.js';
 export { Sessions, type CustomChartsSection, type CustomChartsSectionRequest, type RunStatsGroupBy, type SessionSortableColumns, type TimedeltaInput, type TracerSession, type TracerSessionWithoutVirtualFields, type SessionDeleteResponse, type SessionCreateParams, type SessionRetrieveParams, type SessionUpdateParams, type SessionListParams, type SessionDashboardParams, type TracerSessionsOffsetPaginationTopLevelArray, } from './sessions/sessions.js';

package/dist/_openapi_client/resources/index.js

@@ -4,4 +4,5 @@ export { Datasets, } from './datasets/datasets.js';
 export { Info } from './info.js';
 export { OnlineEvaluators, } from './online-evaluators.js';
 export { Runs, } from './runs/runs.js';
+export { Sandboxes, } from './sandboxes/sandboxes.js';
 export { Sessions, } from './sessions/sessions.js';

package/dist/_openapi_client/resources/sandboxes/boxes.cjs

@@ -0,0 +1,86 @@
+"use strict";
+// @ts-nocheck
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Boxes = void 0;
+const resource_js_1 = require("../../core/resource.cjs");
+const headers_js_1 = require("../../internal/headers.cjs");
+const path_js_1 = require("../../internal/utils/path.cjs");
+class Boxes extends resource_js_1.APIResource {
+    /**
+     * Create a new sandbox from a snapshot. Provide at most one of `snapshot_id` or
+     * `snapshot_name`; if neither is provided, the server uses the default static
+     * blueprint.
+     */
+    create(body, options) {
+        return this._client.post('/v2/sandboxes/boxes', { body, ...options });
+    }
+    /**
+     * Retrieve a sandbox by name. Stale provisioning sandboxes are auto-failed.
+     */
+    retrieve(name, options) {
+        return this._client.get((0, path_js_1.path) `/v2/sandboxes/boxes/${name}`, options);
+    }
+    /**
+     * Update a sandbox's display name. The name must be unique within the tenant.
+     */
+    update(name, body, options) {
+        return this._client.patch((0, path_js_1.path) `/v2/sandboxes/boxes/${name}`, { body, ...options });
+    }
+    /**
+     * List sandboxes for the authenticated tenant, with optional filtering, sorting,
+     * and pagination.
+     */
+    list(query = {}, options) {
+        return this._client.get('/v2/sandboxes/boxes', { query, ...options });
+    }
+    /**
+     * Delete a sandbox by name or UUID. Tears down the sandbox runtime and removes the
+     * DB record.
+     */
+    delete(name, options) {
+        return this._client.delete((0, path_js_1.path) `/v2/sandboxes/boxes/${name}`, {
+            ...options,
+            headers: (0, headers_js_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Create a snapshot by capturing the current state of a sandbox or promoting an
+     * existing checkpoint.
+     */
+    createSnapshot(name, body, options) {
+        return this._client.post((0, path_js_1.path) `/v2/sandboxes/boxes/${name}/snapshot`, { body, ...options });
+    }
+    /**
+     * Create a short-lived JWT for accessing an HTTP service running on a specific
+     * port inside a sandbox. Returns a browser_url (sets auth cookie via redirect), a
+     * service_url (for use with the X-Langsmith-Sandbox-Service-Token header), the raw
+     * token, and its expiry.
+     */
+    generateServiceURL(name, body, options) {
+        return this._client.post((0, path_js_1.path) `/v2/sandboxes/boxes/${name}/service-url`, { body, ...options });
+    }
+    /**
+     * Retrieve the lightweight status of a sandbox for polling.
+     */
+    getStatus(name, options) {
+        return this._client.get((0, path_js_1.path) `/v2/sandboxes/boxes/${name}/status`, options);
+    }
+    /**
+     * Start a stopped or failed sandbox. This endpoint is not idempotent.
+     */
+    start(name, options) {
+        return this._client.post((0, path_js_1.path) `/v2/sandboxes/boxes/${name}/start`, options);
+    }
+    /**
+     * Stop a ready sandbox. This endpoint is not idempotent; the filesystem is
+     * preserved for later restart.
+     */
+    stop(name, options) {
+        return this._client.post((0, path_js_1.path) `/v2/sandboxes/boxes/${name}/stop`, {
+            ...options,
+            headers: (0, headers_js_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.Boxes = Boxes;

package/dist/_openapi_client/resources/sandboxes/boxes.d.ts

@@ -0,0 +1,458 @@
+import { APIResource } from '../../core/resource.js';
+import * as SandboxesAPI from './sandboxes.js';
+import { APIPromise } from '../../core/api-promise.js';
+import { RequestOptions } from '../../internal/request-options.js';
+export declare class Boxes extends APIResource {
+    /**
+     * Create a new sandbox from a snapshot. Provide at most one of `snapshot_id` or
+     * `snapshot_name`; if neither is provided, the server uses the default static
+     * blueprint.
+     */
+    create(body: BoxCreateParams, options?: RequestOptions): APIPromise<SandboxesAPI.SandboxResponse>;
+    /**
+     * Retrieve a sandbox by name. Stale provisioning sandboxes are auto-failed.
+     */
+    retrieve(name: string, options?: RequestOptions): APIPromise<SandboxesAPI.SandboxResponse>;
+    /**
+     * Update a sandbox's display name. The name must be unique within the tenant.
+     */
+    update(name: string, body: BoxUpdateParams, options?: RequestOptions): APIPromise<SandboxesAPI.SandboxResponse>;
+    /**
+     * List sandboxes for the authenticated tenant, with optional filtering, sorting,
+     * and pagination.
+     */
+    list(query?: BoxListParams | null | undefined, options?: RequestOptions): APIPromise<SandboxesAPI.SandboxListResponse>;
+    /**
+     * Delete a sandbox by name or UUID. Tears down the sandbox runtime and removes the
+     * DB record.
+     */
+    delete(name: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Create a snapshot by capturing the current state of a sandbox or promoting an
+     * existing checkpoint.
+     */
+    createSnapshot(name: string, body: BoxCreateSnapshotParams, options?: RequestOptions): APIPromise<SandboxesAPI.SnapshotResponse>;
+    /**
+     * Create a short-lived JWT for accessing an HTTP service running on a specific
+     * port inside a sandbox. Returns a browser_url (sets auth cookie via redirect), a
+     * service_url (for use with the X-Langsmith-Sandbox-Service-Token header), the raw
+     * token, and its expiry.
+     */
+    generateServiceURL(name: string, body: BoxGenerateServiceURLParams, options?: RequestOptions): APIPromise<SandboxesAPI.ServiceURLResponse>;
+    /**
+     * Retrieve the lightweight status of a sandbox for polling.
+     */
+    getStatus(name: string, options?: RequestOptions): APIPromise<SandboxesAPI.SandboxStatusResponse>;
+    /**
+     * Start a stopped or failed sandbox. This endpoint is not idempotent.
+     */
+    start(name: string, options?: RequestOptions): APIPromise<SandboxesAPI.SandboxResponse>;
+    /**
+     * Stop a ready sandbox. This endpoint is not idempotent; the filesystem is
+     * preserved for later restart.
+     */
+    stop(name: string, options?: RequestOptions): APIPromise<void>;
+}
+export interface BoxCreateParams {
+    delete_after_stop_seconds?: number;
+    env_vars?: {
+        [key: string]: string;
+    };
+    fs_capacity_bytes?: number;
+    idle_ttl_seconds?: number;
+    mem_bytes?: number;
+    mount_config?: BoxCreateParams.MountConfig;
+    name?: string;
+    proxy_config?: BoxCreateParams.ProxyConfig;
+    /**
+     * RestoreMemory selects how the sandbox handles a snapshot's captured memory:
+     *
+     * nil → if-present: resume from memory when the snapshot has it, else cold-boot
+     * (default). true → always: resume from memory; rejected if the snapshot has none.
+     * false → never: always cold-boot.
+     *
+     * Applies to this request only.
+     */
+    restore_memory?: boolean;
+    snapshot_id?: string;
+    snapshot_name?: string;
+    tag_value_ids?: Array<string>;
+    vcpus?: number;
+}
+export declare namespace BoxCreateParams {
+    interface MountConfig {
+        auth?: MountConfig.Auth;
+        mounts?: Array<MountConfig.SandboxapiS3BucketMountSpec | MountConfig.SandboxapiGcsBucketMountSpec | MountConfig.SandboxapiGitRepoMountSpec>;
+    }
+    namespace MountConfig {
+        interface Auth {
+            aws?: Auth.Aws;
+            gcp?: Auth.Gcp;
+        }
+        namespace Auth {
+            interface Aws {
+                access_key_id: Aws.AccessKeyID;
+                secret_access_key: Aws.SecretAccessKey;
+            }
+            namespace Aws {
+                interface AccessKeyID {
+                    type: 'plaintext' | 'opaque' | 'workspace_secret';
+                    is_set?: boolean;
+                    value?: string;
+                }
+                interface SecretAccessKey {
+                    type: 'plaintext' | 'opaque' | 'workspace_secret';
+                    is_set?: boolean;
+                    value?: string;
+                }
+            }
+            interface Gcp {
+                service_account_json: Gcp.ServiceAccountJson;
+            }
+            namespace Gcp {
+                interface ServiceAccountJson {
+                    type: 'plaintext' | 'opaque' | 'workspace_secret';
+                    is_set?: boolean;
+                    value?: string;
+                }
+            }
+        }
+        interface SandboxapiS3BucketMountSpec {
+            id: string;
+            mount_path: string;
+            s3: SandboxapiS3BucketMountSpec.S3;
+            type: 's3' | 'gcs' | 'git';
+            cache?: SandboxapiS3BucketMountSpec.Cache;
+            gcs?: SandboxapiS3BucketMountSpec.Gcs;
+            git?: SandboxapiS3BucketMountSpec.Git;
+            read_only?: boolean;
+        }
+        namespace SandboxapiS3BucketMountSpec {
+            interface S3 {
+                bucket: string;
+                region: string;
+                endpoint_url?: string;
+                path_style?: boolean;
+                prefix?: string;
+            }
+            interface Cache {
+                max_size_bytes?: number;
+                writeback_seconds?: number;
+            }
+            interface Gcs {
+                bucket: string;
+                prefix?: string;
+            }
+            interface Git {
+                remote_url: string;
+                ref?: Git.Ref;
+                refresh_interval_seconds?: number;
+            }
+            namespace Git {
+                interface Ref {
+                    name: string;
+                    type: 'branch' | 'tag';
+                }
+            }
+        }
+        interface SandboxapiGcsBucketMountSpec {
+            id: string;
+            gcs: SandboxapiGcsBucketMountSpec.Gcs;
+            mount_path: string;
+            type: 's3' | 'gcs' | 'git';
+            cache?: SandboxapiGcsBucketMountSpec.Cache;
+            git?: SandboxapiGcsBucketMountSpec.Git;
+            read_only?: boolean;
+            s3?: SandboxapiGcsBucketMountSpec.S3;
+        }
+        namespace SandboxapiGcsBucketMountSpec {
+            interface Gcs {
+                bucket: string;
+                prefix?: string;
+            }
+            interface Cache {
+                max_size_bytes?: number;
+                writeback_seconds?: number;
+            }
+            interface Git {
+                remote_url: string;
+                ref?: Git.Ref;
+                refresh_interval_seconds?: number;
+            }
+            namespace Git {
+                interface Ref {
+                    name: string;
+                    type: 'branch' | 'tag';
+                }
+            }
+            interface S3 {
+                bucket: string;
+                region: string;
+                endpoint_url?: string;
+                path_style?: boolean;
+                prefix?: string;
+            }
+        }
+        interface SandboxapiGitRepoMountSpec {
+            id: string;
+            git: SandboxapiGitRepoMountSpec.Git;
+            mount_path: string;
+            type: 's3' | 'gcs' | 'git';
+            cache?: SandboxapiGitRepoMountSpec.Cache;
+            gcs?: SandboxapiGitRepoMountSpec.Gcs;
+            read_only?: boolean;
+            s3?: SandboxapiGitRepoMountSpec.S3;
+        }
+        namespace SandboxapiGitRepoMountSpec {
+            interface Git {
+                remote_url: string;
+                ref?: Git.Ref;
+                refresh_interval_seconds?: number;
+            }
+            namespace Git {
+                interface Ref {
+                    name: string;
+                    type: 'branch' | 'tag';
+                }
+            }
+            interface Cache {
+                max_size_bytes?: number;
+                writeback_seconds?: number;
+            }
+            interface Gcs {
+                bucket: string;
+                prefix?: string;
+            }
+            interface S3 {
+                bucket: string;
+                region: string;
+                endpoint_url?: string;
+                path_style?: boolean;
+                prefix?: string;
+            }
+        }
+    }
+    interface ProxyConfig {
+        access_control?: ProxyConfig.AccessControl;
+        callbacks?: Array<ProxyConfig.Callback>;
+        no_proxy?: Array<string>;
+        rules?: Array<ProxyConfig.Rule>;
+    }
+    namespace ProxyConfig {
+        interface AccessControl {
+            allow_list?: Array<string>;
+            deny_list?: Array<string>;
+        }
+        interface Callback {
+            match_hosts: Array<string>;
+            ttl_seconds: number;
+            url: string;
+            full_request?: boolean;
+            request_headers?: Array<Callback.RequestHeader>;
+        }
+        namespace Callback {
+            interface RequestHeader {
+                name: string;
+                type: 'plaintext' | 'opaque' | 'workspace_secret';
+                is_set?: boolean;
+                value?: string;
+            }
+        }
+        interface Rule {
+            name: string;
+            aws?: Rule.Aws;
+            enabled?: boolean;
+            gcp?: Rule.Gcp;
+            headers?: Array<Rule.Header>;
+            /**
+             * MatchHosts is only accepted for header injection rules. Provider auth rules use
+             * built-in host matching.
+             */
+            match_hosts?: Array<string>;
+            match_paths?: Array<string>;
+            type?: string;
+        }
+        namespace Rule {
+            interface Aws {
+                access_key_id: Aws.AccessKeyID;
+                secret_access_key: Aws.SecretAccessKey;
+            }
+            namespace Aws {
+                interface AccessKeyID {
+                    type: 'plaintext' | 'opaque' | 'workspace_secret';
+                    is_set?: boolean;
+                    value?: string;
+                }
+                interface SecretAccessKey {
+                    type: 'plaintext' | 'opaque' | 'workspace_secret';
+                    is_set?: boolean;
+                    value?: string;
+                }
+            }
+            interface Gcp {
+                scopes: Array<string>;
+                service_account_json: Gcp.ServiceAccountJson;
+            }
+            namespace Gcp {
+                interface ServiceAccountJson {
+                    type: 'plaintext' | 'opaque' | 'workspace_secret';
+                    is_set?: boolean;
+                    value?: string;
+                }
+            }
+            interface Header {
+                name: string;
+                type: 'plaintext' | 'opaque' | 'workspace_secret';
+                is_set?: boolean;
+                value?: string;
+            }
+        }
+    }
+}
+export interface BoxUpdateParams {
+    delete_after_stop_seconds?: number;
+    fs_capacity_bytes?: number;
+    idle_ttl_seconds?: number;
+    mem_bytes?: number;
+    name?: string;
+    proxy_config?: BoxUpdateParams.ProxyConfig;
+    tag_value_ids?: Array<string>;
+    vcpus?: number;
+}
+export declare namespace BoxUpdateParams {
+    interface ProxyConfig {
+        access_control?: ProxyConfig.AccessControl;
+        callbacks?: Array<ProxyConfig.Callback>;
+        no_proxy?: Array<string>;
+        rules?: Array<ProxyConfig.Rule>;
+    }
+    namespace ProxyConfig {
+        interface AccessControl {
+            allow_list?: Array<string>;
+            deny_list?: Array<string>;
+        }
+        interface Callback {
+            match_hosts: Array<string>;
+            ttl_seconds: number;
+            url: string;
+            full_request?: boolean;
+            request_headers?: Array<Callback.RequestHeader>;
+        }
+        namespace Callback {
+            interface RequestHeader {
+                name: string;
+                type: 'plaintext' | 'opaque' | 'workspace_secret';
+                is_set?: boolean;
+                value?: string;
+            }
+        }
+        interface Rule {
+            name: string;
+            aws?: Rule.Aws;
+            enabled?: boolean;
+            gcp?: Rule.Gcp;
+            headers?: Array<Rule.Header>;
+            /**
+             * MatchHosts is only accepted for header injection rules. Provider auth rules use
+             * built-in host matching.
+             */
+            match_hosts?: Array<string>;
+            match_paths?: Array<string>;
+            type?: string;
+        }
+        namespace Rule {
+            interface Aws {
+                access_key_id: Aws.AccessKeyID;
+                secret_access_key: Aws.SecretAccessKey;
+            }
+            namespace Aws {
+                interface AccessKeyID {
+                    type: 'plaintext' | 'opaque' | 'workspace_secret';
+                    is_set?: boolean;
+                    value?: string;
+                }
+                interface SecretAccessKey {
+                    type: 'plaintext' | 'opaque' | 'workspace_secret';
+                    is_set?: boolean;
+                    value?: string;
+                }
+            }
+            interface Gcp {
+                scopes: Array<string>;
+                service_account_json: Gcp.ServiceAccountJson;
+            }
+            namespace Gcp {
+                interface ServiceAccountJson {
+                    type: 'plaintext' | 'opaque' | 'workspace_secret';
+                    is_set?: boolean;
+                    value?: string;
+                }
+            }
+            interface Header {
+                name: string;
+                type: 'plaintext' | 'opaque' | 'workspace_secret';
+                is_set?: boolean;
+                value?: string;
+            }
+        }
+    }
+}
+export interface BoxListParams {
+    /**
+     * Filter by creator identity. Only 'me' is supported.
+     */
+    created_by?: string;
+    /**
+     * Maximum number of results
+     */
+    limit?: number;
+    /**
+     * Filter by name substring
+     */
+    name_contains?: string;
+    /**
+     * Pagination offset
+     */
+    offset?: number;
+    /**
+     * Sort column (name, status, created_at)
+     */
+    sort_by?: string;
+    /**
+     * Sort direction (asc, desc)
+     */
+    sort_direction?: string;
+    /**
+     * Filter by status (provisioning, ready, failed, stopped, deleting)
+     */
+    status?: string;
+}
+export interface BoxCreateSnapshotParams {
+    name: string;
+    /**
+     * if omitted, creates a fresh checkpoint from the running VM
+     */
+    checkpoint?: string;
+    /**
+     * sandbox-local Docker image to export
+     */
+    docker_image?: string;
+    /**
+     * required for Docker image export unless the sandbox has a capacity
+     */
+    fs_capacity_bytes?: number;
+    /**
+     * IncludeMemory, when true, captures a full VM memory snapshot alongside the
+     * filesystem clone. Only honored when the sandbox is running AND Checkpoint is
+     * omitted (i.e. a fresh in-VM checkpoint is requested). Defaults to false to keep
+     * snapshots small unless memory restore is explicitly desired.
+     */
+    include_memory?: boolean;
+}
+export interface BoxGenerateServiceURLParams {
+    expires_in_seconds?: number;
+    port?: number;
+}
+export declare namespace Boxes {
+    export { type BoxCreateParams as BoxCreateParams, type BoxUpdateParams as BoxUpdateParams, type BoxListParams as BoxListParams, type BoxCreateSnapshotParams as BoxCreateSnapshotParams, type BoxGenerateServiceURLParams as BoxGenerateServiceURLParams, };
+}