@blaxel/core 0.3.18 → 0.3.20-preview.286

package/dist/cjs-browser/common/settings.js

@@ -30,8 +30,8 @@ function missingCredentialsMessage() {
     return "No Blaxel credentials found. Set the BL_API_KEY and BL_WORKSPACE environment variables, or run `bl login`.";
 }
 // Build info - these placeholders are replaced at build time by build:replace-imports
-const BUILD_VERSION = "0.3.18";
-const BUILD_COMMIT = "57fc469276ceec702626782b675333c68e6bce4d";
+const BUILD_VERSION = "0.3.20-preview.286";
+const BUILD_COMMIT = "6ebbd206e01759209b37771835096c6500d9fbb9";
 const BUILD_SENTRY_DSN = "https://fd5e60e1c9820e1eef5ccebb84a07127@o4508714045276160.ingest.us.sentry.io/4510465864564736";
 const BLAXEL_API_VERSION = "2026-04-28";
 // Bun < 1.3.11 never sends connection-level WINDOW_UPDATE: the pooled h2

package/dist/cjs-browser/sandbox/client/sdk.gen.js

@@ -1,9 +1,67 @@
 "use strict";
 // This file is auto-generated by @hey-api/openapi-ts
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getWatchFilesystemByPath = exports.postUpgrade = exports.getProcessByIdentifierLogsStream = exports.getProcessByIdentifierLogs = exports.deleteProcessByIdentifierKill = exports.getProcessByIdentifier = exports.deleteProcessByIdentifier = exports.postProcess = exports.getProcess = exports.putNetworkTunnelConfig = exports.deleteNetworkTunnel = exports.getNetworkProcessByPidPorts = exports.postNetworkProcessByPidMonitor = exports.deleteNetworkProcessByPidMonitor = exports.getHealth = exports.putFilesystemTreeByPath = exports.getFilesystemTreeByPath = exports.deleteFilesystemTreeByPath = exports.putFilesystemByPath = exports.getFilesystemByPath = exports.deleteFilesystemByPath = exports.getFilesystemSearchByPath = exports.postFilesystemMultipartInitiateByPath = exports.getFilesystemMultipartByUploadIdParts = exports.putFilesystemMultipartByUploadIdPart = exports.postFilesystemMultipartByUploadIdComplete = exports.deleteFilesystemMultipartByUploadIdAbort = exports.getFilesystemMultipart = exports.getFilesystemFindByPath = exports.getFilesystemContentSearchByPath = exports.deleteDrivesMountByMountPath = exports.postDrivesMount = exports.getDrivesMount = exports.getCodegenRerankingByPath = exports.putCodegenFastapplyByPath = void 0;
+exports.getWatchFilesystemByPath = exports.postUpgrade = exports.postProcessByIdentifierStdin = exports.deleteProcessByIdentifierStdin = exports.getProcessByIdentifierLogsStream = exports.getProcessByIdentifierLogs = exports.deleteProcessByIdentifierKill = exports.getProcessByIdentifier = exports.deleteProcessByIdentifier = exports.postProcess = exports.getProcess = exports.putNetworkTunnelConfig = exports.deleteNetworkTunnel = exports.getNetworkProcessByPidPorts = exports.postNetworkProcessByPidMonitor = exports.deleteNetworkProcessByPidMonitor = exports.getHealth = exports.putFilesystemTreeByPath = exports.getFilesystemTreeByPath = exports.deleteFilesystemTreeByPath = exports.putFilesystemByPath = exports.getFilesystemByPath = exports.deleteFilesystemByPath = exports.getFilesystemSearchByPath = exports.postFilesystemMultipartInitiateByPath = exports.getFilesystemMultipartByUploadIdParts = exports.putFilesystemMultipartByUploadIdPart = exports.postFilesystemMultipartByUploadIdComplete = exports.deleteFilesystemMultipartByUploadIdAbort = exports.getFilesystemMultipart = exports.getFilesystemFindByPath = exports.getFilesystemContentSearchByPath = exports.postEnvironmentReload = exports.deleteDrivesMountByMountPath = exports.postDrivesMount = exports.getDrivesMount = exports.getCodegenRerankingByPath = exports.putCodegenFastapplyByPath = exports.getArchiveStatus = exports.postArchiveResume = exports.postArchiveExport = void 0;
 const client_fetch_1 = require("@hey-api/client-fetch");
 const client_gen_1 = require("./client.gen");
+/**
+ * Export the filesystem changes to a presigned URL
+ * Archives everything the sandbox changed on top of its base image and streams it, uncompressed, to a presigned S3 PUT URL. The memory of the sandbox is not archived.
+ * The sandbox is quiesced first: the process list is saved (unless saveProcesses is false), every process is stopped, and the API then refuses the calls that would write to the filesystem. The freeze is not lifted afterwards, since an exported sandbox is meant to be restored elsewhere; call POST /archive/resume to lift it.
+ * Use dryRun to get the archive's content and exact size without stopping anything and without uploading.
+ * Set async to start the export and answer immediately, which is what archiving a large filesystem needs: the export then reports itself through GET /archive/status.
+ */
+const postArchiveExport = (options) => {
+    return (options.client ?? client_gen_1.client).post({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/archive/export',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options?.headers
+        }
+    });
+};
+exports.postArchiveExport = postArchiveExport;
+/**
+ * Lift the archive freeze
+ * Makes the API serve every route again after an export. The processes stopped for the export are not relaunched: this exists so a failed or aborted export does not leave the sandbox unusable.
+ */
+const postArchiveResume = (options) => {
+    return (options?.client ?? client_gen_1.client).post({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/archive/resume',
+        ...options
+    });
+};
+exports.postArchiveResume = postArchiveResume;
+/**
+ * Get the archive status
+ * Reports whether the sandbox is frozen for an archive export, and which processes were stopped for it.
+ */
+const getArchiveStatus = (options) => {
+    return (options?.client ?? client_gen_1.client).get({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/archive/status',
+        ...options
+    });
+};
+exports.getArchiveStatus = getArchiveStatus;
 /**
  * Apply code edit
  * Uses the configured LLM provider (Relace or Morph) to apply a code edit to the original content.
@@ -128,6 +186,23 @@ const deleteDrivesMountByMountPath = (options) => {
     });
 };
 exports.deleteDrivesMountByMountPath = deleteDrivesMountByMountPath;
+/**
+ * Reload environment from guest metadata
+ * Re-reads /bl/metadata and applies its environment to the sandbox-api process, so this process and every process started afterwards see the current values. Called by the guest init after an environment update; safe to call manually.
+ */
+const postEnvironmentReload = (options) => {
+    return (options?.client ?? client_gen_1.client).post({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/environment/reload',
+        ...options
+    });
+};
+exports.postEnvironmentReload = postEnvironmentReload;
 /**
  * Search for text content in files
  * Searches for text content inside files using ripgrep. Returns matching lines with context.
@@ -638,6 +713,44 @@ const getProcessByIdentifierLogsStream = (options) => {
     });
 };
 exports.getProcessByIdentifierLogsStream = getProcessByIdentifierLogsStream;
+/**
+ * Close a process's stdin
+ * Send EOF to the process by closing its stdin pipe. Idempotent. For stdio protocols such as MCP this is the clean shutdown path.
+ */
+const deleteProcessByIdentifierStdin = (options) => {
+    return (options.client ?? client_gen_1.client).delete({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/process/{identifier}/stdin',
+        ...options
+    });
+};
+exports.deleteProcessByIdentifierStdin = deleteProcessByIdentifierStdin;
+/**
+ * Write to a process's stdin
+ * Write the raw request body to the stdin of a process started with "stdin": true. Bytes are forwarded verbatim, so include the trailing newline your protocol expects. Sequential requests keep their order; each body is written atomically with respect to other writers. The pipe does not survive a sandbox-api restart: once it is gone this returns 409 and the process must be restarted.
+ */
+const postProcessByIdentifierStdin = (options) => {
+    return (options.client ?? client_gen_1.client).post({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/process/{identifier}/stdin',
+        ...options,
+        headers: {
+            'Content-Type': 'application/octet-stream',
+            ...options?.headers
+        }
+    });
+};
+exports.postProcessByIdentifierStdin = postProcessByIdentifierStdin;
 /**
  * Upgrade the sandbox-api
  * Triggers an upgrade of the sandbox-api process. Returns 200 immediately before upgrading.

package/dist/cjs-browser/sandbox/process/process.js

@@ -341,6 +341,33 @@ class SandboxProcess extends action_js_1.SandboxAction {
         this.handleResponseError(response, data, error);
         return data;
     }
+    /**
+     * Write raw bytes to the stdin of a process started with `stdin: true`.
+     * Bytes go through verbatim, so include the trailing newline your protocol
+     * expects (one JSON-RPC message per call for an MCP stdio server). Not
+     * retried: a duplicate write would corrupt the stream.
+     */
+    async writeStdin(identifier, data) {
+        const { response, data: result, error } = await (0, index_js_1.postProcessByIdentifierStdin)(this.withClient({
+            path: { identifier },
+            baseUrl: this.url,
+            body: data,
+            // The generated client JSON-encodes bodies by default; stdin is raw.
+            bodySerializer: null,
+        }));
+        this.handleResponseError(response, result, error);
+    }
+    /**
+     * Close the process's stdin (EOF). Idempotent. For stdio protocols such as
+     * MCP this is the clean shutdown path.
+     */
+    async closeStdin(identifier) {
+        const { response, data, error } = await (0, index_js_1.deleteProcessByIdentifierStdin)(this.withClient({
+            path: { identifier },
+            baseUrl: this.url,
+        }));
+        this.handleResponseError(response, data, error);
+    }
     async logs(identifier, type = "all") {
         // Idempotent GET: self-heal a transient connection reset.
         const data = await (0, transient_retry_js_1.retryOnTransientReset)(async () => {

package/dist/cjs-browser/types/sandbox/client/sdk.gen.d.ts

@@ -1,5 +1,5 @@
 import { type Options as ClientOptions, type TDataShape, type Client } from '@hey-api/client-fetch';
-import type { PutCodegenFastapplyByPathData, GetCodegenRerankingByPathData, GetDrivesMountData, PostDrivesMountData, DeleteDrivesMountByMountPathData, GetFilesystemContentSearchByPathData, GetFilesystemFindByPathData, GetFilesystemMultipartData, DeleteFilesystemMultipartByUploadIdAbortData, PostFilesystemMultipartByUploadIdCompleteData, PutFilesystemMultipartByUploadIdPartData, GetFilesystemMultipartByUploadIdPartsData, PostFilesystemMultipartInitiateByPathData, GetFilesystemSearchByPathData, DeleteFilesystemByPathData, GetFilesystemByPathData, PutFilesystemByPathData, DeleteFilesystemTreeByPathData, GetFilesystemTreeByPathData, PutFilesystemTreeByPathData, GetHealthData, DeleteNetworkProcessByPidMonitorData, PostNetworkProcessByPidMonitorData, GetNetworkProcessByPidPortsData, DeleteNetworkTunnelData, PutNetworkTunnelConfigData, GetProcessData, PostProcessData, DeleteProcessByIdentifierData, GetProcessByIdentifierData, DeleteProcessByIdentifierKillData, GetProcessByIdentifierLogsData, GetProcessByIdentifierLogsStreamData, PostUpgradeData, GetWatchFilesystemByPathData } from './types.gen';
+import type { PostArchiveExportData, PostArchiveExportResponse, PostArchiveResumeData, GetArchiveStatusData, PutCodegenFastapplyByPathData, GetCodegenRerankingByPathData, GetDrivesMountData, PostDrivesMountData, DeleteDrivesMountByMountPathData, PostEnvironmentReloadData, GetFilesystemContentSearchByPathData, GetFilesystemFindByPathData, GetFilesystemMultipartData, DeleteFilesystemMultipartByUploadIdAbortData, PostFilesystemMultipartByUploadIdCompleteData, PutFilesystemMultipartByUploadIdPartData, GetFilesystemMultipartByUploadIdPartsData, PostFilesystemMultipartInitiateByPathData, GetFilesystemSearchByPathData, DeleteFilesystemByPathData, GetFilesystemByPathData, PutFilesystemByPathData, DeleteFilesystemTreeByPathData, GetFilesystemTreeByPathData, PutFilesystemTreeByPathData, GetHealthData, DeleteNetworkProcessByPidMonitorData, PostNetworkProcessByPidMonitorData, GetNetworkProcessByPidPortsData, DeleteNetworkTunnelData, PutNetworkTunnelConfigData, GetProcessData, PostProcessData, DeleteProcessByIdentifierData, GetProcessByIdentifierData, DeleteProcessByIdentifierKillData, GetProcessByIdentifierLogsData, GetProcessByIdentifierLogsStreamData, DeleteProcessByIdentifierStdinData, PostProcessByIdentifierStdinData, PostUpgradeData, GetWatchFilesystemByPathData } from './types.gen';
 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
@@ -13,6 +13,24 @@ export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends
      */
     meta?: Record<string, unknown>;
 };
+/**
+ * Export the filesystem changes to a presigned URL
+ * Archives everything the sandbox changed on top of its base image and streams it, uncompressed, to a presigned S3 PUT URL. The memory of the sandbox is not archived.
+ * The sandbox is quiesced first: the process list is saved (unless saveProcesses is false), every process is stopped, and the API then refuses the calls that would write to the filesystem. The freeze is not lifted afterwards, since an exported sandbox is meant to be restored elsewhere; call POST /archive/resume to lift it.
+ * Use dryRun to get the archive's content and exact size without stopping anything and without uploading.
+ * Set async to start the export and answer immediately, which is what archiving a large filesystem needs: the export then reports itself through GET /archive/status.
+ */
+export declare const postArchiveExport: <ThrowOnError extends boolean = false>(options: Options<PostArchiveExportData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<PostArchiveExportResponse, import("./types.gen").ErrorResponse, ThrowOnError>;
+/**
+ * Lift the archive freeze
+ * Makes the API serve every route again after an export. The processes stopped for the export are not relaunched: this exists so a failed or aborted export does not leave the sandbox unusable.
+ */
+export declare const postArchiveResume: <ThrowOnError extends boolean = false>(options?: Options<PostArchiveResumeData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").QuiesceStatus, import("./types.gen").ErrorResponse, ThrowOnError>;
+/**
+ * Get the archive status
+ * Reports whether the sandbox is frozen for an archive export, and which processes were stopped for it.
+ */
+export declare const getArchiveStatus: <ThrowOnError extends boolean = false>(options?: Options<GetArchiveStatusData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").QuiesceStatus, unknown, ThrowOnError>;
 /**
  * Apply code edit
  * Uses the configured LLM provider (Relace or Morph) to apply a code edit to the original content.
@@ -69,6 +87,11 @@ export declare const postDrivesMount: <ThrowOnError extends boolean = false>(opt
  * Unmounts a previously mounted drive from the specified local path
  */
 export declare const deleteDrivesMountByMountPath: <ThrowOnError extends boolean = false>(options: Options<DeleteDrivesMountByMountPathData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").DriveUnmountResponse, import("./types.gen").ErrorResponse, ThrowOnError>;
+/**
+ * Reload environment from guest metadata
+ * Re-reads /bl/metadata and applies its environment to the sandbox-api process, so this process and every process started afterwards see the current values. Called by the guest init after an environment update; safe to call manually.
+ */
+export declare const postEnvironmentReload: <ThrowOnError extends boolean = false>(options?: Options<PostEnvironmentReloadData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").HandlerReloadResponse, import("./types.gen").ErrorResponse, ThrowOnError>;
 /**
  * Search for text content in files
  * Searches for text content inside files using ripgrep. Returns matching lines with context.
@@ -216,6 +239,16 @@ export declare const getProcessByIdentifierLogs: <ThrowOnError extends boolean =
  * Streams the stdout and stderr output of a process in real time, one line per log, prefixed with 'stdout:' or 'stderr:'. Closes when the process exits or the client disconnects.
  */
 export declare const getProcessByIdentifierLogsStream: <ThrowOnError extends boolean = false>(options: Options<GetProcessByIdentifierLogsStreamData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<string, import("./types.gen").ErrorResponse, ThrowOnError>;
+/**
+ * Close a process's stdin
+ * Send EOF to the process by closing its stdin pipe. Idempotent. For stdio protocols such as MCP this is the clean shutdown path.
+ */
+export declare const deleteProcessByIdentifierStdin: <ThrowOnError extends boolean = false>(options: Options<DeleteProcessByIdentifierStdinData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").SuccessResponse, import("./types.gen").ErrorResponse, ThrowOnError>;
+/**
+ * Write to a process's stdin
+ * Write the raw request body to the stdin of a process started with "stdin": true. Bytes are forwarded verbatim, so include the trailing newline your protocol expects. Sequential requests keep their order; each body is written atomically with respect to other writers. The pipe does not survive a sandbox-api restart: once it is gone this returns 409 and the process must be restarted.
+ */
+export declare const postProcessByIdentifierStdin: <ThrowOnError extends boolean = false>(options: Options<PostProcessByIdentifierStdinData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").SuccessResponse, import("./types.gen").ErrorResponse, ThrowOnError>;
 /**
  * Upgrade the sandbox-api
  * Triggers an upgrade of the sandbox-api process. Returns 200 immediately before upgrading.