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

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.312";
+const BUILD_COMMIT = "45891cd9862d690bb6532b5758e75084083d511f";
 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

@@ -277,7 +277,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 +334,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({
@@ -382,7 +383,11 @@ export const getFilesystemByPath = (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 +439,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 +580,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 +603,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 +635,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 +667,8 @@ 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.
+ * 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.
  */
 export const getProcessByIdentifierLogsStream = (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.312",
 	"description": "Blaxel Core SDK for TypeScript",
 	"license": "MIT",
 	"author": "Blaxel, INC (https://blaxel.ai)",