@blaxel/core 0.3.18 → 0.3.20-preview.286

package/dist/esm/common/settings.js

@@ -24,8 +24,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/esm/sandbox/client/sdk.gen.js

@@ -1,6 +1,61 @@
 // This file is auto-generated by @hey-api/openapi-ts
 import { formDataBodySerializer } from '@hey-api/client-fetch';
 import { client as _heyApiClient } from "./client.gen.js";
+/**
+ * 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 const postArchiveExport = (options) => {
+    return (options.client ?? _heyApiClient).post({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/archive/export',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options?.headers
+        }
+    });
+};
+/**
+ * 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 const postArchiveResume = (options) => {
+    return (options?.client ?? _heyApiClient).post({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/archive/resume',
+        ...options
+    });
+};
+/**
+ * Get the archive status
+ * Reports whether the sandbox is frozen for an archive export, and which processes were stopped for it.
+ */
+export const getArchiveStatus = (options) => {
+    return (options?.client ?? _heyApiClient).get({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/archive/status',
+        ...options
+    });
+};
 /**
  * Apply code edit
  * Uses the configured LLM provider (Relace or Morph) to apply a code edit to the original content.
@@ -120,6 +175,22 @@ export const deleteDrivesMountByMountPath = (options) => {
         ...options
     });
 };
+/**
+ * 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 const postEnvironmentReload = (options) => {
+    return (options?.client ?? _heyApiClient).post({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/environment/reload',
+        ...options
+    });
+};
 /**
  * Search for text content in files
  * Searches for text content inside files using ripgrep. Returns matching lines with context.
@@ -602,6 +673,42 @@ export const getProcessByIdentifierLogsStream = (options) => {
         ...options
     });
 };
+/**
+ * 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 const deleteProcessByIdentifierStdin = (options) => {
+    return (options.client ?? _heyApiClient).delete({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/process/{identifier}/stdin',
+        ...options
+    });
+};
+/**
+ * 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 const postProcessByIdentifierStdin = (options) => {
+    return (options.client ?? _heyApiClient).post({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/process/{identifier}/stdin',
+        ...options,
+        headers: {
+            'Content-Type': 'application/octet-stream',
+            ...options?.headers
+        }
+    });
+};
 /**
  * Upgrade the sandbox-api
  * Triggers an upgrade of the sandbox-api process. Returns 200 immediately before upgrading.

package/dist/esm/sandbox/process/process.js

@@ -1,7 +1,7 @@
 import { settings } from "../../common/settings.js";
 import { SandboxAction } from "../action.js";
 import { retryOnTransientReset } from "../../common/transient-retry.js";
-import { deleteProcessByIdentifier, deleteProcessByIdentifierKill, getProcess, getProcessByIdentifier, getProcessByIdentifierLogs, postProcess } from "../client/index.js";
+import { deleteProcessByIdentifier, deleteProcessByIdentifierKill, deleteProcessByIdentifierStdin, getProcess, getProcessByIdentifier, getProcessByIdentifierLogs, postProcess, postProcessByIdentifierStdin } from "../client/index.js";
 export class SandboxProcess extends SandboxAction {
     constructor(sandbox) {
         super(sandbox);
@@ -338,6 +338,33 @@ export class SandboxProcess extends 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 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 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 retryOnTransientReset(async () => {