@blaxel/core 0.3.26-preview.311 → 0.3.26-preview.313

package/dist/esm-browser/client/sdk.gen.js

@@ -750,7 +750,7 @@ export const listImages = (options) => {
 };
 /**
  * Build a container image
- * Builds a container image without creating a deployment. Returns a presigned URL for uploading source code. After upload, the image will be built and stored in the registry, but no agent, function, sandbox, or job will be created or updated.
+ * Builds or imports a container image without creating a deployment. Provide a registry image reference to download and convert an existing image, or omit image to receive a presigned URL for uploading source code. Registry imports can specify memoryMb and volumeMb for the import worker. These settings do not change the resources of workloads using the image.
  */
 export const createImage = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -2306,7 +2306,7 @@ export const getTemplate = (options) => {
 };
 /**
  * List workspace team members
- * Returns all team members in the workspace including their roles (admin or member) and invitation status.
+ * Returns all team members in the workspace including their roles (admin, member or viewer) and invitation status.
  */
 export const listWorkspaceUsers = (options) => {
     return (options?.client ?? _heyApiClient).get({

package/dist/esm-browser/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.26-preview.311";
-const BUILD_COMMIT = "a62496fa4537136926770cdd0d6e48ceb8506491";
+const BUILD_VERSION = "0.3.26-preview.313";
+const BUILD_COMMIT = "74b7740c0709370950088f3244fe2eeb2e970fca";
 const BUILD_SENTRY_DSN = "https://fd5e60e1c9820e1eef5ccebb84a07127@o4508714045276160.ingest.us.sentry.io/4510465864564736";
 const BLAXEL_API_VERSION = "2026-09-22";
 // Bun < 1.3.11 never sends connection-level WINDOW_UPDATE: the pooled h2

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

@@ -5,6 +5,7 @@ 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.
+ * A sandbox still frozen by an earlier export is exported as it is, with the process list that export saved.
  * 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.
  */
@@ -193,7 +194,7 @@ export const postEnvironmentReload = (options) => {
 };
 /**
  * Search for text content in files
- * Searches for text content inside files using ripgrep. Returns matching lines with context.
+ * Searches for text content inside files. Returns each matching line, with the lines around it when contextLines is set.
  */
 export const getFilesystemContentSearchByPath = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -277,7 +278,7 @@ export const postFilesystemMultipartByUploadIdComplete = (options) => {
 };
 /**
  * Upload part
- * Upload a single part of a multipart upload
+ * Upload a single part of a multipart upload. Re-uploading a part number replaces that part. Wait for the previous request for that part to finish before retrying.
  */
 export const putFilesystemMultipartByUploadIdPart = (options) => {
     return (options.client ?? _heyApiClient).put({
@@ -334,7 +335,8 @@ export const postFilesystemMultipartInitiateByPath = (options) => {
 };
 /**
  * Fuzzy search for files and directories
- * Performs fuzzy search on filesystem paths using fuzzy matching algorithm. Optimized alternative to find and grep commands.
+ * Ranks the files and directories under a path by how well their relative path fuzzy-matches `query` (fzf algorithm: the query's characters must appear in order, not necessarily next to each other), best match first.
+ * Fuzzy search is for "jump to file" lookups from a partial name. The `patterns` parameter is currently ignored by this endpoint; use find for exact glob filtering.
  */
 export const getFilesystemSearchByPath = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -380,9 +382,29 @@ export const getFilesystemByPath = (options) => {
         ...options
     });
 };
+/**
+ * Stat a file or directory
+ * Returns the metadata of a file or directory as headers, with no body. This checks stat availability, not permission to read file contents or list a directory. When the path does not exist or its metadata cannot be accessed, the response is an empty 200 without the X-File-Type header.
+ */
+export const headFilesystemByPath = (options) => {
+    return (options.client ?? _heyApiClient).head({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/filesystem/{path}',
+        ...options
+    });
+};
 /**
  * Create or update a file or directory
- * Create or update a file or directory
+ * Create or update a file or directory.
+ *
+ * Idempotent: an existing file is overwritten (truncated, not appended to) and an existing directory is kept, so retrying the same request is safe.
+ *
+ * Send either a JSON body (FileRequest) or `multipart/form-data` for binary files. Multipart fields, in any order: `file` (required, the file content), `permissions` (optional octal mode such as `0755`, applied when the file is created, default `0644`; an existing file keeps its mode), `path` (optional, ignored: the target is always the URL path).
  */
 export const putFilesystemByPath = (options) => {
     return (options.client ?? _heyApiClient).put({
@@ -434,7 +456,7 @@ export const getFilesystemTreeByPath = (options) => {
 };
 /**
  * Create or update directory tree
- * Create or update multiple files within a directory tree structure
+ * Create or update multiple files within a directory tree structure. Idempotent: existing files are overwritten, so retrying the same request is safe.
  */
 export const putFilesystemTreeByPath = (options) => {
     return (options.client ?? _heyApiClient).put({
@@ -575,7 +597,10 @@ export const getProcess = (options) => {
 };
 /**
  * Execute a command
- * Execute a command and return process information. If Accept header is text/event-stream, streams logs in SSE format and returns the process response as a final event.
+ * Execute a command and return process information.
+ *
+ * Streaming: with `Accept: application/x-ndjson` (or `Accept: text/event-stream`, kept for compatibility) the response is NDJSON (`Content-Type: application/x-ndjson`), not SSE: one JSON object per line, `{"type": "...", "data": "..."}`.
+ * `type` is `stdout` or `stderr` (`data` is a raw output chunk, sent as soon as the process writes it, newlines included; if the process finished before any chunk was streamed, its output is sent instead as one event per line, without the newline), `keepalive` (every 5 seconds, no data), `error` (`data` is the message, ends the stream) or `result` (last event, `data` is the ProcessResponse as a JSON string).
  */
 export const postProcess = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -595,7 +620,7 @@ export const postProcess = (options) => {
 };
 /**
  * Stop a process
- * Gracefully stop a running process
+ * Request graceful termination. Poll GET /process/{identifier} until terminal status confirms the managed process has exited.
  */
 export const deleteProcessByIdentifier = (options) => {
     return (options.client ?? _heyApiClient).delete({
@@ -627,7 +652,7 @@ export const getProcessByIdentifier = (options) => {
 };
 /**
  * Kill a process
- * Forcefully kill a running process
+ * Request forceful termination. Poll GET /process/{identifier} until terminal status confirms the managed process has exited.
  */
 export const deleteProcessByIdentifierKill = (options) => {
     return (options.client ?? _heyApiClient).delete({
@@ -659,7 +684,11 @@ export const getProcessByIdentifierLogs = (options) => {
 };
 /**
  * Stream process logs in real time
- * 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.
+ * Streams the stdout and stderr output of a process in real time: the output so far, then live output as the process writes it. Closes when the process exits or the client disconnects.
+ * By default, output is plain text with `stdout:` or `stderr:` prefixes at the start of each source stream's lines. Partial lines (e.g. prompts) are sent without waiting for a newline; their continuations have no new prefix. The other stream is not held back while a line is incomplete, and chronological order across stdout and stderr is not guaranteed.
+ * This format does not provide unambiguous framing: output from the other stream, or a `[keepalive]` marker sent every 30 seconds, can appear inside an unfinished line. A later continuation can therefore lack a prefix identifying its source. Do not rely on this text stream to reconstruct stdout and stderr separately; request NDJSON for source-preserving streaming, or use GET /process/{identifier}/logs for separate output snapshots.
+ * With `Accept: application/x-ndjson`, each line is a JSON object with `type` (`stdout`, `stderr`, `keepalive`, `restart`, `truncated`, or `error`) and optional `data`. Output records retain source identity and original bytes, including partial lines and newlines, for both retained history and live output. For `encoding: "base64"`, decode `data` before concatenating bytes per source; this occurs for binary data or a UTF-8 character split across chunks. Chunk boundaries are arbitrary and ordering is collection order, not a strict chronology across streams.
+ * `keepalive` has no output data. A quiet active stream sends an initial keepalive after attachment so clients can receive the response before sending stdin; subsequent keepalives are sent every 30 seconds. `restart` carries a supervisor restart notice, not process output. `truncated` reports a retention or slow-reader gap and must not be appended to stdout/stderr. `error` reports a streaming failure. The connection ends after the final process exit, including automatic restarts; there is no `result` record. Older processes without structured history return HTTP 409 for NDJSON; their text stream remains available.
  */
 export const getProcessByIdentifierLogsStream = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -735,7 +764,10 @@ export const postUpgrade = (options) => {
 };
 /**
  * Stream file modification events in a directory
- * Streams the path of modified files (one per line) in the given directory. Closes when the client disconnects.
+ * Streams change events for a directory until the client disconnects.
+ *
+ * The body is JSON lines (sent with `Content-Type: text/plain`): one event object per line, e.g. `{"op":"WRITE","name":"main.go","path":"/app/src","error":null}`. `op` is the fsnotify operation (CREATE, WRITE, REMOVE, RENAME or CHMOD, several can be joined with `|`), `name` the base name of the changed entry, `path` the directory containing it, and `error` is always null. A `[keepalive]` line (not JSON) is sent every 30 seconds.
+ * Only the directory's direct entries are watched. To also watch every subdirectory, including ones created later, end the path with `**`. The stream reports subsequent changes without an initial snapshot. When a new directory is detected, synthetic CREATE events are emitted for entries already present inside it to cover changes before its watch was registered.
  */
 export const getWatchFilesystemByPath = (options) => {
     return (options.client ?? _heyApiClient).get({

package/dist/esm-browser/sandbox/filesystem/filesystem.js

@@ -262,7 +262,7 @@ export class SandboxFileSystem extends SandboxAction {
     }
     async search(query, path = "/", options) {
         const formattedPath = this.formatPath(path);
-        const queryParams = {};
+        const queryParams = { query };
         if (options?.maxResults !== undefined) {
             queryParams.maxResults = options.maxResults;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@blaxel/core",
-	"version": "0.3.26-preview.311",
+	"version": "0.3.26-preview.313",
 	"description": "Blaxel Core SDK for TypeScript",
 	"license": "MIT",
 	"author": "Blaxel, INC (https://blaxel.ai)",