@blaxel/core 0.2.31 → 0.2.32-dev.182

package/dist/client/sdk.gen.d.ts

@@ -1,5 +1,5 @@
 import type { Options as ClientOptions, TDataShape, Client } from '@hey-api/client-fetch';
-import type { ListAgentsData, CreateAgentData, DeleteAgentData, GetAgentData, UpdateAgentData, ListAgentRevisionsData, GetConfigurationData, ListCustomDomainsData, CreateCustomDomainData, DeleteCustomDomainData, GetCustomDomainData, UpdateCustomDomainData, VerifyCustomDomainData, ListFunctionsData, CreateFunctionData, DeleteFunctionData, GetFunctionData, UpdateFunctionData, ListFunctionRevisionsData, GetIntegrationData, ListIntegrationConnectionsData, CreateIntegrationConnectionData, DeleteIntegrationConnectionData, GetIntegrationConnectionData, UpdateIntegrationConnectionData, GetIntegrationConnectionModelEndpointConfigurationsData, ListIntegrationConnectionModelsData, GetIntegrationConnectionModelData, ListJobsData, CreateJobData, DeleteJobData, GetJobData, UpdateJobData, ListJobRevisionsData, ListLocationsData, ListMcpHubDefinitionsData, ListModelsData, CreateModelData, DeleteModelData, GetModelData, UpdateModelData, ListModelRevisionsData, ListPoliciesData, CreatePolicyData, DeletePolicyData, GetPolicyData, UpdatePolicyData, ListPrivateClustersData, CreatePrivateClusterData, DeletePrivateClusterData, GetPrivateClusterData, UpdatePrivateClusterData, GetPrivateClusterHealthData, UpdatePrivateClusterHealthData, ListAllPendingInvitationsData, ListPublicIpsData, ListSandboxHubDefinitionsData, ListSandboxesData, CreateSandboxData, DeleteSandboxData, GetSandboxData, UpdateSandboxData, ListSandboxPreviewsData, CreateSandboxPreviewData, DeleteSandboxPreviewData, GetSandboxPreviewData, UpdateSandboxPreviewData, ListSandboxPreviewTokensData, CreateSandboxPreviewTokenData, DeleteSandboxPreviewTokenData, StartSandboxData, StopSandboxData, GetWorkspaceServiceAccountsData, CreateWorkspaceServiceAccountData, DeleteWorkspaceServiceAccountData, UpdateWorkspaceServiceAccountData, ListApiKeysForServiceAccountData, CreateApiKeyForServiceAccountData, DeleteApiKeyForServiceAccountData, ListTemplatesData, GetTemplateData, ListWorkspaceUsersData, InviteWorkspaceUserData, RemoveWorkspaceUserData, UpdateWorkspaceUserRoleData, ListWorkspacesData, CreateWorspaceData, DeleteWorkspaceData, GetWorkspaceData, UpdateWorkspaceData, DeclineWorkspaceInvitationData, AcceptWorkspaceInvitationData, LeaveWorkspaceData, CheckWorkspaceAvailabilityData } from './types.gen.js';
+import type { ListAgentsData, CreateAgentData, DeleteAgentData, GetAgentData, UpdateAgentData, ListAgentRevisionsData, GetConfigurationData, ListCustomDomainsData, CreateCustomDomainData, DeleteCustomDomainData, GetCustomDomainData, UpdateCustomDomainData, VerifyCustomDomainData, ListFunctionsData, CreateFunctionData, DeleteFunctionData, GetFunctionData, UpdateFunctionData, ListFunctionRevisionsData, GetIntegrationData, ListIntegrationConnectionsData, CreateIntegrationConnectionData, DeleteIntegrationConnectionData, GetIntegrationConnectionData, UpdateIntegrationConnectionData, GetIntegrationConnectionModelEndpointConfigurationsData, ListIntegrationConnectionModelsData, GetIntegrationConnectionModelData, ListJobsData, CreateJobData, DeleteJobData, GetJobData, UpdateJobData, ListJobRevisionsData, ListLocationsData, ListMcpHubDefinitionsData, ListModelsData, CreateModelData, DeleteModelData, GetModelData, UpdateModelData, ListModelRevisionsData, ListPoliciesData, CreatePolicyData, DeletePolicyData, GetPolicyData, UpdatePolicyData, ListPrivateClustersData, CreatePrivateClusterData, DeletePrivateClusterData, GetPrivateClusterData, UpdatePrivateClusterData, GetPrivateClusterHealthData, UpdatePrivateClusterHealthData, ListAllPendingInvitationsData, ListPublicIpsData, ListSandboxHubDefinitionsData, ListSandboxesData, CreateSandboxData, DeleteSandboxData, GetSandboxData, UpdateSandboxData, ListSandboxPreviewsData, CreateSandboxPreviewData, DeleteSandboxPreviewData, GetSandboxPreviewData, UpdateSandboxPreviewData, ListSandboxPreviewTokensData, CreateSandboxPreviewTokenData, DeleteSandboxPreviewTokenData, StartSandboxData, StopSandboxData, GetWorkspaceServiceAccountsData, CreateWorkspaceServiceAccountData, DeleteWorkspaceServiceAccountData, UpdateWorkspaceServiceAccountData, ListApiKeysForServiceAccountData, CreateApiKeyForServiceAccountData, DeleteApiKeyForServiceAccountData, ListTemplatesData, GetTemplateData, ListWorkspaceUsersData, InviteWorkspaceUserData, RemoveWorkspaceUserData, UpdateWorkspaceUserRoleData, ListVolumesData, CreateVolumeData, DeleteVolumeData, GetVolumeData, UpdateVolumeData, ListWorkspacesData, CreateWorspaceData, DeleteWorkspaceData, GetWorkspaceData, UpdateWorkspaceData, DeclineWorkspaceInvitationData, AcceptWorkspaceInvitationData, LeaveWorkspaceData, CheckWorkspaceAvailabilityData } from './types.gen.js';
 export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = ClientOptions<TData, ThrowOnError> & {
     /**
      * You can provide a client instance returned by `createClient()` instead of
@@ -432,6 +432,31 @@ export declare const removeWorkspaceUser: <ThrowOnError extends boolean = false>
  * Updates the role of a user in the workspace.
  */
 export declare const updateWorkspaceUserRole: <ThrowOnError extends boolean = false>(options: Options<UpdateWorkspaceUserRoleData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen.js").WorkspaceUser, unknown, ThrowOnError>;
+/**
+ * List volumes
+ * Returns a list of all volumes in the workspace.
+ */
+export declare const listVolumes: <ThrowOnError extends boolean = false>(options?: Options<ListVolumesData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen.js").Volume[], unknown, ThrowOnError>;
+/**
+ * Create volume
+ * Creates a volume.
+ */
+export declare const createVolume: <ThrowOnError extends boolean = false>(options: Options<CreateVolumeData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen.js").Volume, unknown, ThrowOnError>;
+/**
+ * Delete volume
+ * Deletes a volume by name.
+ */
+export declare const deleteVolume: <ThrowOnError extends boolean = false>(options: Options<DeleteVolumeData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen.js").Volume, unknown, ThrowOnError>;
+/**
+ * Get volume
+ * Returns a volume by name.
+ */
+export declare const getVolume: <ThrowOnError extends boolean = false>(options: Options<GetVolumeData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen.js").Volume, unknown, ThrowOnError>;
+/**
+ * Update volume (Not Implemented)
+ * Update a volume by name.
+ */
+export declare const updateVolume: <ThrowOnError extends boolean = false>(options: Options<UpdateVolumeData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen.js").Volume, unknown, ThrowOnError>;
 /**
  * List workspaces
  * Returns a list of all workspaces.

package/dist/client/sdk.gen.js

@@ -2,7 +2,7 @@
 // This file is auto-generated by @hey-api/openapi-ts
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deletePrivateCluster = exports.createPrivateCluster = exports.listPrivateClusters = exports.updatePolicy = exports.getPolicy = exports.deletePolicy = exports.createPolicy = exports.listPolicies = exports.listModelRevisions = exports.updateModel = exports.getModel = exports.deleteModel = exports.createModel = exports.listModels = exports.listMcpHubDefinitions = exports.listLocations = exports.listJobRevisions = exports.updateJob = exports.getJob = exports.deleteJob = exports.createJob = exports.listJobs = exports.getIntegrationConnectionModel = exports.listIntegrationConnectionModels = exports.getIntegrationConnectionModelEndpointConfigurations = exports.updateIntegrationConnection = exports.getIntegrationConnection = exports.deleteIntegrationConnection = exports.createIntegrationConnection = exports.listIntegrationConnections = exports.getIntegration = exports.listFunctionRevisions = exports.updateFunction = exports.getFunction = exports.deleteFunction = exports.createFunction = exports.listFunctions = exports.verifyCustomDomain = exports.updateCustomDomain = exports.getCustomDomain = exports.deleteCustomDomain = exports.createCustomDomain = exports.listCustomDomains = exports.getConfiguration = exports.listAgentRevisions = exports.updateAgent = exports.getAgent = exports.deleteAgent = exports.createAgent = exports.listAgents = void 0;
-exports.checkWorkspaceAvailability = exports.leaveWorkspace = exports.acceptWorkspaceInvitation = exports.declineWorkspaceInvitation = exports.updateWorkspace = exports.getWorkspace = exports.deleteWorkspace = exports.createWorspace = exports.listWorkspaces = exports.updateWorkspaceUserRole = exports.removeWorkspaceUser = exports.inviteWorkspaceUser = exports.listWorkspaceUsers = exports.getTemplate = exports.listTemplates = exports.deleteApiKeyForServiceAccount = exports.createApiKeyForServiceAccount = exports.listApiKeysForServiceAccount = exports.updateWorkspaceServiceAccount = exports.deleteWorkspaceServiceAccount = exports.createWorkspaceServiceAccount = exports.getWorkspaceServiceAccounts = exports.stopSandbox = exports.startSandbox = exports.deleteSandboxPreviewToken = exports.createSandboxPreviewToken = exports.listSandboxPreviewTokens = exports.updateSandboxPreview = exports.getSandboxPreview = exports.deleteSandboxPreview = exports.createSandboxPreview = exports.listSandboxPreviews = exports.updateSandbox = exports.getSandbox = exports.deleteSandbox = exports.createSandbox = exports.listSandboxes = exports.listSandboxHubDefinitions = exports.listPublicIps = exports.listAllPendingInvitations = exports.updatePrivateClusterHealth = exports.getPrivateClusterHealth = exports.updatePrivateCluster = exports.getPrivateCluster = void 0;
+exports.checkWorkspaceAvailability = exports.leaveWorkspace = exports.acceptWorkspaceInvitation = exports.declineWorkspaceInvitation = exports.updateWorkspace = exports.getWorkspace = exports.deleteWorkspace = exports.createWorspace = exports.listWorkspaces = exports.updateVolume = exports.getVolume = exports.deleteVolume = exports.createVolume = exports.listVolumes = exports.updateWorkspaceUserRole = exports.removeWorkspaceUser = exports.inviteWorkspaceUser = exports.listWorkspaceUsers = exports.getTemplate = exports.listTemplates = exports.deleteApiKeyForServiceAccount = exports.createApiKeyForServiceAccount = exports.listApiKeysForServiceAccount = exports.updateWorkspaceServiceAccount = exports.deleteWorkspaceServiceAccount = exports.createWorkspaceServiceAccount = exports.getWorkspaceServiceAccounts = exports.stopSandbox = exports.startSandbox = exports.deleteSandboxPreviewToken = exports.createSandboxPreviewToken = exports.listSandboxPreviewTokens = exports.updateSandboxPreview = exports.getSandboxPreview = exports.deleteSandboxPreview = exports.createSandboxPreview = exports.listSandboxPreviews = exports.updateSandbox = exports.getSandbox = exports.deleteSandbox = exports.createSandbox = exports.listSandboxes = exports.listSandboxHubDefinitions = exports.listPublicIps = exports.listAllPendingInvitations = exports.updatePrivateClusterHealth = exports.getPrivateClusterHealth = exports.updatePrivateCluster = exports.getPrivateCluster = void 0;
 const client_gen_1 = require("./client.gen");
 /**
  * List all agents
@@ -1512,6 +1512,99 @@ const updateWorkspaceUserRole = (options) => {
     });
 };
 exports.updateWorkspaceUserRole = updateWorkspaceUserRole;
+/**
+ * List volumes
+ * Returns a list of all volumes in the workspace.
+ */
+const listVolumes = (options) => {
+    return (options?.client ?? client_gen_1.client).get({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/volumes',
+        ...options
+    });
+};
+exports.listVolumes = listVolumes;
+/**
+ * Create volume
+ * Creates a volume.
+ */
+const createVolume = (options) => {
+    return (options.client ?? client_gen_1.client).post({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/volumes',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options?.headers
+        }
+    });
+};
+exports.createVolume = createVolume;
+/**
+ * Delete volume
+ * Deletes a volume by name.
+ */
+const deleteVolume = (options) => {
+    return (options.client ?? client_gen_1.client).delete({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/volumes/{volumeName}',
+        ...options
+    });
+};
+exports.deleteVolume = deleteVolume;
+/**
+ * Get volume
+ * Returns a volume by name.
+ */
+const getVolume = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/volumes/{volumeName}',
+        ...options
+    });
+};
+exports.getVolume = getVolume;
+/**
+ * Update volume (Not Implemented)
+ * Update a volume by name.
+ */
+const updateVolume = (options) => {
+    return (options.client ?? client_gen_1.client).put({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/volumes/{volumeName}',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options?.headers
+        }
+    });
+};
+exports.updateVolume = updateVolume;
 /**
  * List workspaces
  * Returns a list of all workspaces.

package/dist/client/types.gen.d.ts

@@ -2029,6 +2029,10 @@ export type Sandbox = {
      * Sandbox status
      */
     status?: string;
+    /**
+     * TTL timestamp for automatic deletion (optional, nil means no auto-deletion)
+     */
+    ttl?: number;
 };
 /**
  * Sandbox definition for admin store operations
@@ -2083,7 +2087,9 @@ export type SandboxDefinition = {
 /**
  * Sandbox specification
  */
-export type SandboxSpec = CoreSpec & unknown;
+export type SandboxSpec = CoreSpec & {
+    volumes?: VolumeAttachments;
+};
 /**
  * Name of a Sandbox definition
  */
@@ -2464,6 +2470,63 @@ export type TriggerConfigurationTask = {
  * Triggers to use your agent
  */
 export type Triggers = Array<Trigger>;
+/**
+ * Volume resource for persistent storage
+ */
+export type Volume = {
+    events?: CoreEvents;
+    metadata?: Metadata;
+    spec?: VolumeSpec;
+    state?: VolumeState;
+    /**
+     * Volume status computed from events
+     */
+    status?: string;
+    /**
+     * Timestamp when the volume was marked for termination
+     */
+    terminatedAt?: string;
+};
+/**
+ * Volume attachment configuration for sandbox
+ */
+export type VolumeAttachment = {
+    /**
+     * Mount path in the container
+     */
+    mountPath?: string;
+    /**
+     * Name of the volume to attach
+     */
+    name?: string;
+    /**
+     * Whether the volume is mounted as read-only
+     */
+    readOnly?: boolean;
+};
+export type VolumeAttachments = Array<VolumeAttachment>;
+/**
+ * Volume specification - immutable configuration
+ */
+export type VolumeSpec = {
+    /**
+     * AWS region where the volume should be created (e.g. us-west-2, eu-west-1)
+     */
+    region?: string;
+    /**
+     * Size of the volume in MB
+     */
+    size?: number;
+};
+/**
+ * Volume state - mutable runtime state
+ */
+export type VolumeState = {
+    /**
+     * Resource this volume is attached to (e.g. "sandbox:my-sandbox", "model:my-model")
+     */
+    attachedTo?: string;
+};
 /**
  * WebSocket connection details
  */
@@ -4238,6 +4301,92 @@ export type UpdateWorkspaceUserRoleResponses = {
     200: WorkspaceUser;
 };
 export type UpdateWorkspaceUserRoleResponse = UpdateWorkspaceUserRoleResponses[keyof UpdateWorkspaceUserRoleResponses];
+export type ListVolumesData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/volumes';
+};
+export type ListVolumesResponses = {
+    /**
+     * successful operation
+     */
+    200: Array<Volume>;
+};
+export type ListVolumesResponse = ListVolumesResponses[keyof ListVolumesResponses];
+export type CreateVolumeData = {
+    body: Volume;
+    path?: never;
+    query?: never;
+    url: '/volumes';
+};
+export type CreateVolumeResponses = {
+    /**
+     * successful operation
+     */
+    200: Volume;
+};
+export type CreateVolumeResponse = CreateVolumeResponses[keyof CreateVolumeResponses];
+export type DeleteVolumeData = {
+    body?: never;
+    path: {
+        /**
+         * Name of the volume
+         */
+        volumeName: string;
+    };
+    query?: never;
+    url: '/volumes/{volumeName}';
+};
+export type DeleteVolumeResponses = {
+    /**
+     * successful operation
+     */
+    200: Volume;
+};
+export type DeleteVolumeResponse = DeleteVolumeResponses[keyof DeleteVolumeResponses];
+export type GetVolumeData = {
+    body?: never;
+    path: {
+        /**
+         * Name of the volume
+         */
+        volumeName: string;
+    };
+    query?: never;
+    url: '/volumes/{volumeName}';
+};
+export type GetVolumeResponses = {
+    /**
+     * successful operation
+     */
+    200: Volume;
+};
+export type GetVolumeResponse = GetVolumeResponses[keyof GetVolumeResponses];
+export type UpdateVolumeData = {
+    body: Volume;
+    path: {
+        /**
+         * Name of the volume
+         */
+        volumeName: string;
+    };
+    query?: never;
+    url: '/volumes/{volumeName}';
+};
+export type UpdateVolumeErrors = {
+    /**
+     * Method not allowed - volume updates are not supported
+     */
+    405: unknown;
+};
+export type UpdateVolumeResponses = {
+    /**
+     * successful operation
+     */
+    200: Volume;
+};
+export type UpdateVolumeResponse = UpdateVolumeResponses[keyof UpdateVolumeResponses];
 export type ListWorkspacesData = {
     body?: never;
     path?: never;

package/dist/common/settings.d.ts

@@ -7,6 +7,7 @@ export type Config = {
 declare class Settings {
     credentials: Credentials;
     config: Config;
+    private _version;
     constructor();
     setConfig(config: Config): void;
     get env(): string;
@@ -15,6 +16,7 @@ declare class Settings {
     get workspace(): string;
     get authorization(): string;
     get token(): string;
+    get version(): string;
     get headers(): Record<string, string>;
     get name(): string;
     get type(): string;

package/dist/common/settings.js

@@ -3,9 +3,74 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.settings = void 0;
 const index_js_1 = require("../authentication/index.js");
 const env_js_1 = require("../common/env.js");
+// Function to get package version
+function getPackageVersion() {
+    try {
+        // Try to require package.json (Node.js only, gracefully fails in browser)
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const packageJson = require("../../../package.json");
+        return packageJson.version || "unknown";
+    }
+    catch {
+        // Fallback for browser environments or if require fails
+        return "unknown";
+    }
+}
+// Function to get OS and architecture
+function getOsArch() {
+    try {
+        // Node.js environment
+        if (typeof process !== 'undefined' && process.platform && process.arch) {
+            const platform = process.platform === 'win32' ? 'windows' :
+                process.platform === 'darwin' ? 'darwin' :
+                    process.platform === 'linux' ? 'linux' : process.platform;
+            return `${platform}/${process.arch}`;
+        }
+    }
+    catch {
+        // Fall through to browser detection
+    }
+    // Browser environment - use fixed detection
+    try {
+        // @ts-ignore - navigator is available in browser environments
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+        if (typeof navigator !== 'undefined' && navigator?.platform) {
+            // @ts-ignore - navigator.platform is available in browser environments
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+            const navPlatform = navigator.platform.toLowerCase();
+            const platform = navPlatform.includes('win') ? 'windows' :
+                navPlatform.includes('mac') ? 'darwin' :
+                    navPlatform.includes('linux') ? 'linux' : 'browser';
+            const arch = navPlatform.includes('64') ? 'amd64' : 'unknown';
+            return `${platform}/${arch}`;
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+    return "browser/unknown";
+}
+// Function to get commit hash
+function getCommitHash() {
+    try {
+        // Try to require package.json and look for commit field (set during build)
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const packageJson = require("../../../package.json");
+        // Check for commit in various possible locations
+        const commit = packageJson.commit || packageJson.buildInfo?.commit;
+        if (commit) {
+            return commit.length > 7 ? commit.substring(0, 7) : commit;
+        }
+    }
+    catch {
+        // Fallback for browser environments or if require fails
+    }
+    return "unknown";
+}
 class Settings {
     credentials;
     config;
+    _version = null;
     constructor() {
         this.credentials = (0, index_js_1.authentication)();
         this.config = {
@@ -59,10 +124,19 @@ class Settings {
         }
         return this.credentials.token;
     }
+    get version() {
+        if (this._version === null) {
+            this._version = getPackageVersion();
+        }
+        return this._version;
+    }
     get headers() {
+        const osArch = getOsArch();
+        const commitHash = getCommitHash();
         return {
             "x-blaxel-authorization": this.authorization,
             "x-blaxel-workspace": this.workspace || "",
+            "User-Agent": `blaxel/sdk/typescript/${this.version} (${osArch}) blaxel/${commitHash}`,
         };
     }
     get name() {

package/dist/index.d.ts

@@ -14,3 +14,4 @@ export * from "./sandbox/index.js";
 export * from "./telemetry/telemetry.js";
 export * from "./tools/index.js";
 export * from "./tools/types.js";
+export * from "./volume/index.js";

package/dist/index.js

@@ -30,3 +30,4 @@ __exportStar(require("./sandbox/index.js"), exports);
 __exportStar(require("./telemetry/telemetry.js"), exports);
 __exportStar(require("./tools/index.js"), exports);
 __exportStar(require("./tools/types.js"), exports);
+__exportStar(require("./volume/index.js"), exports);

package/dist/sandbox/client/types.gen.js

@@ -1,4 +1,3 @@
 "use strict";
-/* eslint-disable */
 // This file is auto-generated by @hey-api/openapi-ts
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/sandbox/process/process.js

@@ -58,7 +58,7 @@ class SandboxProcess extends action_js_1.SandboxAction {
         startStream();
         // Return control functions
         return {
-            close: async () => {
+            close: () => {
                 isRunning = false;
                 // Clear reconnect timer
                 if (reconnectTimer) {

package/dist/sandbox/sandbox.d.ts

@@ -16,7 +16,7 @@ export declare class SandboxInstance {
     get metadata(): import("../client/types.gen.js").Metadata | undefined;
     get status(): string | undefined;
     get events(): import("../client/types.gen.js").CoreEvents | undefined;
-    get spec(): import("../client/types.gen.js").CoreSpec | undefined;
+    get spec(): import("../client/types.gen.js").SandboxSpec | undefined;
     wait({ maxWait, interval }?: {
         maxWait?: number;
         interval?: number;

package/dist/sandbox/sandbox.js

@@ -48,8 +48,8 @@ class SandboxInstance {
         const defaultName = `sandbox-${(0, uuid_1.v4)().replace(/-/g, '').substring(0, 8)}`;
         const defaultImage = `blaxel/${env}-base:latest`;
         const defaultMemory = 4096;
-        // Handle SandboxCreateConfiguration or simple dict with name/image/memory/ports/envs keys
-        if (!sandbox || 'name' in sandbox || 'image' in sandbox || 'memory' in sandbox || 'ports' in sandbox || 'envs' in sandbox) {
+        // Handle SandboxCreateConfiguration or simple dict with name/image/memory/ports/envs/volumes keys
+        if (!sandbox || 'name' in sandbox || 'image' in sandbox || 'memory' in sandbox || 'ports' in sandbox || 'envs' in sandbox || 'volumes' in sandbox) {
             if (!sandbox)
                 sandbox = {};
             if (!sandbox.name)
@@ -60,6 +60,7 @@ class SandboxInstance {
                 sandbox.memory = defaultMemory;
             const ports = (0, types_js_1.normalizePorts)(sandbox.ports);
             const envs = (0, types_js_1.normalizeEnvs)(sandbox.envs);
+            const volumes = (0, types_js_1.normalizeVolumes)(sandbox.volumes);
             const ttl = sandbox.ttl;
             const expires = sandbox.expires;
             sandbox = {
@@ -71,7 +72,8 @@ class SandboxInstance {
                         ports: ports,
                         envs: envs,
                         generation: "mk3",
-                    }
+                    },
+                    volumes: volumes
                 }
             };
             if (ttl) {

package/dist/sandbox/types.d.ts

@@ -1,4 +1,4 @@
-import { Port, Sandbox } from "../client/types.gen";
+import { Port, Sandbox, VolumeAttachment } from "../client/types.gen";
 import { PostProcessResponse, ProcessRequest } from "./client";
 export interface SessionCreateOptions {
     expiresAt?: Date;
@@ -15,6 +15,11 @@ export interface EnvVar {
     name: string;
     value: string;
 }
+export interface VolumeBinding {
+    name: string;
+    mountPath: string;
+    readOnly?: boolean;
+}
 export type SandboxConfiguration = {
     forceUrl?: string;
     headers?: Record<string, string>;
@@ -30,11 +35,13 @@ export type SandboxCreateConfiguration = {
     memory?: number;
     ports?: (Port | Record<string, any>)[];
     envs?: EnvVar[];
+    volumes?: (VolumeBinding | VolumeAttachment)[];
     ttl?: string;
     expires?: Date;
 };
 export declare function normalizePorts(ports?: (Port | Record<string, any>)[]): Port[] | undefined;
 export declare function normalizeEnvs(envs?: EnvVar[]): EnvVar[] | undefined;
+export declare function normalizeVolumes(volumes?: (VolumeBinding | VolumeAttachment)[]): VolumeAttachment[] | undefined;
 export type ProcessRequestWithLog = ProcessRequest & {
     onLog?: (log: string) => void;
 };

package/dist/sandbox/types.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.normalizePorts = normalizePorts;
 exports.normalizeEnvs = normalizeEnvs;
+exports.normalizeVolumes = normalizeVolumes;
 function normalizePorts(ports) {
     if (!ports || ports.length === 0) {
         return undefined;
@@ -50,3 +51,31 @@ function normalizeEnvs(envs) {
     }
     return envObjects;
 }
+function normalizeVolumes(volumes) {
+    if (!volumes || volumes.length === 0) {
+        return undefined;
+    }
+    const volumeObjects = [];
+    for (const volume of volumes) {
+        if (typeof volume === 'object' && volume !== null) {
+            // Validate that the object has the required keys
+            if (!('name' in volume) || !('mountPath' in volume)) {
+                throw new Error(`Volume binding object must have 'name' and 'mountPath' keys: ${JSON.stringify(volume)}`);
+            }
+            if (typeof volume.name !== 'string' || typeof volume.mountPath !== 'string') {
+                throw new Error(`Volume binding 'name' and 'mountPath' must be strings: ${JSON.stringify(volume)}`);
+            }
+            // Convert VolumeBinding to VolumeAttachment format
+            const volumeAttachment = {
+                name: volume.name,
+                mountPath: volume.mountPath,
+                readOnly: 'readOnly' in volume ? volume.readOnly : false
+            };
+            volumeObjects.push(volumeAttachment);
+        }
+        else {
+            throw new Error(`Invalid volume type: ${typeof volume}. Expected object with 'name' and 'mountPath' keys.`);
+        }
+    }
+    return volumeObjects;
+}

package/dist/volume/index.d.ts

@@ -0,0 +1,23 @@
+import { Volume } from "../client/index.js";
+export interface VolumeCreateConfiguration {
+    name?: string;
+    displayName?: string;
+    size?: number;
+    region?: string;
+}
+export declare class VolumeInstance {
+    private volume;
+    constructor(volume: Volume);
+    get metadata(): import("../client/types.gen.js").Metadata | undefined;
+    get spec(): import("../client/types.gen.js").VolumeSpec | undefined;
+    get status(): string | undefined;
+    get name(): string | undefined;
+    get displayName(): string | undefined;
+    get size(): number | undefined;
+    get region(): string | undefined;
+    static create(config: VolumeCreateConfiguration | Volume): Promise<VolumeInstance>;
+    static get(volumeName: string): Promise<VolumeInstance>;
+    static list(): Promise<VolumeInstance[]>;
+    static delete(volumeName: string): Promise<Volume>;
+    static createIfNotExists(config: VolumeCreateConfiguration | Volume): Promise<VolumeInstance>;
+}

package/dist/volume/index.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VolumeInstance = void 0;
+const uuid_1 = require("uuid");
+const index_js_1 = require("../client/index.js");
+class VolumeInstance {
+    volume;
+    constructor(volume) {
+        this.volume = volume;
+    }
+    get metadata() {
+        return this.volume.metadata;
+    }
+    get spec() {
+        return this.volume.spec;
+    }
+    get status() {
+        return this.volume.status;
+    }
+    get name() {
+        return this.volume.metadata?.name;
+    }
+    get displayName() {
+        return this.volume.metadata?.displayName;
+    }
+    get size() {
+        return this.volume.spec?.size;
+    }
+    get region() {
+        return this.volume.spec?.region;
+    }
+    static async create(config) {
+        const defaultName = `volume-${(0, uuid_1.v4)().replace(/-/g, '').substring(0, 8)}`;
+        const defaultSize = 1024; // 1GB in MB
+        let volume;
+        // Handle VolumeCreateConfiguration or simple config object
+        if ('spec' in config && 'metadata' in config) {
+            // It's already a Volume object
+            volume = config;
+        }
+        else {
+            // It's a VolumeCreateConfiguration
+            const volumeConfig = config;
+            volume = {
+                metadata: {
+                    name: volumeConfig.name || defaultName,
+                    displayName: volumeConfig.displayName || volumeConfig.name || defaultName
+                },
+                spec: {
+                    size: volumeConfig.size || defaultSize,
+                    region: volumeConfig.region
+                }
+            };
+        }
+        // Ensure required fields have defaults
+        if (!volume.metadata) {
+            volume.metadata = { name: defaultName };
+        }
+        if (!volume.metadata.name) {
+            volume.metadata.name = defaultName;
+        }
+        if (!volume.spec) {
+            volume.spec = { size: defaultSize };
+        }
+        if (!volume.spec.size) {
+            volume.spec.size = defaultSize;
+        }
+        const { data } = await (0, index_js_1.createVolume)({
+            body: volume,
+            throwOnError: true,
+        });
+        return new VolumeInstance(data);
+    }
+    static async get(volumeName) {
+        const { data } = await (0, index_js_1.getVolume)({
+            path: {
+                volumeName,
+            },
+            throwOnError: true,
+        });
+        return new VolumeInstance(data);
+    }
+    static async list() {
+        const { data } = await (0, index_js_1.listVolumes)({ throwOnError: true });
+        return data.map((volume) => new VolumeInstance(volume));
+    }
+    static async delete(volumeName) {
+        const { data } = await (0, index_js_1.deleteVolume)({
+            path: {
+                volumeName,
+            },
+            throwOnError: true,
+        });
+        return data;
+    }
+    static async createIfNotExists(config) {
+        try {
+            return await VolumeInstance.create(config);
+        }
+        catch (e) {
+            if (typeof e === "object" && e !== null && "code" in e && (e.code === 409 || e.code === 'VOLUME_ALREADY_EXISTS')) {
+                const name = 'name' in config ? config.name : config.metadata?.name;
+                if (!name) {
+                    throw new Error("Volume name is required");
+                }
+                const volumeInstance = await VolumeInstance.get(name);
+                return volumeInstance;
+            }
+            throw e;
+        }
+    }
+}
+exports.VolumeInstance = VolumeInstance;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blaxel/core",
-  "version": "0.2.31",
+  "version": "0.2.32-dev.182",
   "description": "Blaxel Core SDK for TypeScript",
   "license": "MIT",
   "author": "Blaxel, INC (https://blaxel.ai)",
@@ -76,10 +76,13 @@
     "vite": "^5.2.0",
     "vitest": "^1.5.0"
   },
+  "commit": "62706de9b339be30f7588150c761cc23f1067fd3",
   "scripts": {
     "lint": "eslint src/",
     "dev": "tsc --watch",
-    "build": "tsc",
+    "build": "npm run build:inject-commit && tsc",
+    "build:clean": "tsc",
+    "build:inject-commit": "node -e \"const fs=require('fs'),pkg=require('./package.json'),{execSync}=require('child_process');try{const commit=execSync('git rev-parse HEAD',{encoding:'utf8'}).trim();pkg.commit=commit;fs.writeFileSync('./package.json',JSON.stringify(pkg,null,'\\t')+'\\n');console.log('✅ Injected commit:',commit.substring(0,7))}catch(e){console.log('⚠️  Could not inject commit:',e.message)}\"",
     "test": "vitest --run",
     "test:watch": "vitest --watch"
   }