@blaxel/core 0.3.26-preview.312 → 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.312";
-const BUILD_COMMIT = "45891cd9862d690bb6532b5758e75084083d511f";
+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({
@@ -381,6 +382,22 @@ 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.
@@ -668,7 +685,10 @@ export const getProcessByIdentifierLogs = (options) => {
 /**
  * Stream process logs in real time
  * 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.
- * Each output line starts with `stdout:` or `stderr:` and keeps its trailing newline. A partial line (e.g. a prompt) is sent as soon as it is written; when the process completes it, the rest follows without a new prefix. `[keepalive]` lines are sent every 30 seconds.
+ * 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({
@@ -744,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/package.json

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