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

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.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/cjs-browser/sandbox/client/sdk.gen.js

@@ -294,7 +294,7 @@ const postFilesystemMultipartByUploadIdComplete = (options) => {
 exports.postFilesystemMultipartByUploadIdComplete = postFilesystemMultipartByUploadIdComplete;
 /**
  * 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.
  */
 const putFilesystemMultipartByUploadIdPart = (options) => {
     return (options.client ?? client_gen_1.client).put({
@@ -354,7 +354,8 @@ const postFilesystemMultipartInitiateByPath = (options) => {
 exports.postFilesystemMultipartInitiateByPath = postFilesystemMultipartInitiateByPath;
 /**
  * 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.
  */
 const getFilesystemSearchByPath = (options) => {
     return (options.client ?? client_gen_1.client).get({
@@ -405,7 +406,11 @@ const getFilesystemByPath = (options) => {
 exports.getFilesystemByPath = getFilesystemByPath;
 /**
  * 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).
  */
 const putFilesystemByPath = (options) => {
     return (options.client ?? client_gen_1.client).put({
@@ -460,7 +465,7 @@ const getFilesystemTreeByPath = (options) => {
 exports.getFilesystemTreeByPath = getFilesystemTreeByPath;
 /**
  * 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.
  */
 const putFilesystemTreeByPath = (options) => {
     return (options.client ?? client_gen_1.client).put({
@@ -609,7 +614,10 @@ const getProcess = (options) => {
 exports.getProcess = getProcess;
 /**
  * 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).
  */
 const postProcess = (options) => {
     return (options.client ?? client_gen_1.client).post({
@@ -630,7 +638,7 @@ const postProcess = (options) => {
 exports.postProcess = postProcess;
 /**
  * Stop a process
- * Gracefully stop a running process
+ * Request graceful termination. Poll GET /process/{identifier} until terminal status confirms the managed process has exited.
  */
 const deleteProcessByIdentifier = (options) => {
     return (options.client ?? client_gen_1.client).delete({
@@ -664,7 +672,7 @@ const getProcessByIdentifier = (options) => {
 exports.getProcessByIdentifier = getProcessByIdentifier;
 /**
  * Kill a process
- * Forcefully kill a running process
+ * Request forceful termination. Poll GET /process/{identifier} until terminal status confirms the managed process has exited.
  */
 const deleteProcessByIdentifierKill = (options) => {
     return (options.client ?? client_gen_1.client).delete({
@@ -698,7 +706,8 @@ const getProcessByIdentifierLogs = (options) => {
 exports.getProcessByIdentifierLogs = getProcessByIdentifierLogs;
 /**
  * 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.
  */
 const getProcessByIdentifierLogsStream = (options) => {
     return (options.client ?? client_gen_1.client).get({

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

@@ -266,7 +266,7 @@ class SandboxFileSystem extends action_js_1.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/dist/cjs-browser/types/sandbox/client/sdk.gen.d.ts

@@ -119,7 +119,7 @@ export declare const deleteFilesystemMultipartByUploadIdAbort: <ThrowOnError ext
 export declare const postFilesystemMultipartByUploadIdComplete: <ThrowOnError extends boolean = false>(options: Options<PostFilesystemMultipartByUploadIdCompleteData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").SuccessResponse, import("./types.gen").ErrorResponse, ThrowOnError>;
 /**
  * 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 declare const putFilesystemMultipartByUploadIdPart: <ThrowOnError extends boolean = false>(options: Options<PutFilesystemMultipartByUploadIdPartData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").MultipartUploadPartResponse, import("./types.gen").ErrorResponse, ThrowOnError>;
 /**
@@ -134,7 +134,8 @@ export declare const getFilesystemMultipartByUploadIdParts: <ThrowOnError extend
 export declare const postFilesystemMultipartInitiateByPath: <ThrowOnError extends boolean = false>(options: Options<PostFilesystemMultipartInitiateByPathData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").MultipartInitiateResponse, import("./types.gen").ErrorResponse, ThrowOnError>;
 /**
  * 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 declare const getFilesystemSearchByPath: <ThrowOnError extends boolean = false>(options: Options<GetFilesystemSearchByPathData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").FuzzySearchResponse, import("./types.gen").ErrorResponse, ThrowOnError>;
 /**
@@ -149,7 +150,11 @@ export declare const deleteFilesystemByPath: <ThrowOnError extends boolean = fal
 export declare const getFilesystemByPath: <ThrowOnError extends boolean = false>(options: Options<GetFilesystemByPathData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").File | import("./types.gen").Directory | import("./types.gen").FileWithContent | Blob, import("./types.gen").ErrorResponse, ThrowOnError>;
 /**
  * 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 declare const putFilesystemByPath: <ThrowOnError extends boolean = false>(options: Options<PutFilesystemByPathData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").SuccessResponse, import("./types.gen").ErrorResponse, ThrowOnError>;
 /**
@@ -164,7 +169,7 @@ export declare const deleteFilesystemTreeByPath: <ThrowOnError extends boolean =
 export declare const getFilesystemTreeByPath: <ThrowOnError extends boolean = false>(options: Options<GetFilesystemTreeByPathData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").File | import("./types.gen").Directory | import("./types.gen").FileWithContent | Blob, import("./types.gen").ErrorResponse, ThrowOnError>;
 /**
  * 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 declare const putFilesystemTreeByPath: <ThrowOnError extends boolean = false>(options: Options<PutFilesystemTreeByPathData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").File | import("./types.gen").Directory | import("./types.gen").FileWithContent | Blob, import("./types.gen").ErrorResponse, ThrowOnError>;
 /**
@@ -211,12 +216,15 @@ export declare const putNetworkTunnelConfig: <ThrowOnError extends boolean = fal
 export declare const getProcess: <ThrowOnError extends boolean = false>(options?: Options<GetProcessData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").ProcessResponse[], unknown, ThrowOnError>;
 /**
  * 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 declare const postProcess: <ThrowOnError extends boolean = false>(options: Options<PostProcessData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").ProcessResponse, import("./types.gen").ErrorResponse, ThrowOnError>;
 /**
  * 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 declare const deleteProcessByIdentifier: <ThrowOnError extends boolean = false>(options: Options<DeleteProcessByIdentifierData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").SuccessResponse, import("./types.gen").ErrorResponse, ThrowOnError>;
 /**
@@ -226,7 +234,7 @@ export declare const deleteProcessByIdentifier: <ThrowOnError extends boolean =
 export declare const getProcessByIdentifier: <ThrowOnError extends boolean = false>(options: Options<GetProcessByIdentifierData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").ProcessResponse, import("./types.gen").ErrorResponse, ThrowOnError>;
 /**
  * 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 declare const deleteProcessByIdentifierKill: <ThrowOnError extends boolean = false>(options: Options<DeleteProcessByIdentifierKillData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").SuccessResponse, import("./types.gen").ErrorResponse, ThrowOnError>;
 /**
@@ -236,7 +244,8 @@ export declare const deleteProcessByIdentifierKill: <ThrowOnError extends boolea
 export declare const getProcessByIdentifierLogs: <ThrowOnError extends boolean = false>(options: Options<GetProcessByIdentifierLogsData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").ProcessLogs, import("./types.gen").ErrorResponse, ThrowOnError>;
 /**
  * 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 declare const getProcessByIdentifierLogsStream: <ThrowOnError extends boolean = false>(options: Options<GetProcessByIdentifierLogsStreamData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<string, import("./types.gen").ErrorResponse, ThrowOnError>;
 /**

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

@@ -278,11 +278,17 @@ export type FuzzySearchResponse = {
 };
 export type HealthResponse = {
     arch: string;
+    /**
+     * Build time in RFC 3339 (UTC), or "unknown" for builds without it
+     */
     buildTime: string;
     gitCommit: string;
     goVersion: string;
     lastUpgrade: UpgradeStatus;
     os: string;
+    /**
+     * API start time in RFC 3339
+     */
     startedAt: string;
     status: string;
     upgradeCount: number;
@@ -377,6 +383,9 @@ export type ProcessRequest = {
 };
 export type ProcessResponse = {
     command: string;
+    /**
+     * Completion time, same format as startedAt. Empty string while the process runs
+     */
     completedAt: string;
     exitCode: number;
     /**
@@ -389,6 +398,9 @@ export type ProcessResponse = {
     pid: string;
     restartCount?: number;
     restartOnFailure?: boolean;
+    /**
+     * Start time as an HTTP date (RFC 1123, e.g. Wed, 01 Jan 2023 12:00:00 GMT)
+     */
     startedAt: string;
     status: 'failed' | 'killed' | 'stopped' | 'running' | 'completed';
     stderr: string;
@@ -1143,12 +1155,16 @@ export type GetFilesystemSearchByPathData = {
         path: string;
     };
     query?: {
+        /**
+         * Fuzzy pattern matched against each relative path (e.g., mngo for src/main.go). When omitted, the search path itself is used as the pattern.
+         */
+        query?: string;
         /**
          * Maximum number of results to return (default: 20)
          */
         maxResults?: number;
         /**
-         * Comma-separated file patterns to include (e.g., *.go,*.js)
+         * Accepted for compatibility but currently ignored; use filesystem-find for glob filtering
          */
         patterns?: string;
         /**
@@ -1226,7 +1242,7 @@ export type GetFilesystemByPathData = {
     body?: never;
     path: {
         /**
-         * File or directory path
+         * File or directory path. Relative paths are resolved against the filesystem working directory. For example, with a working directory of /app, GET /filesystem/workspace resolves to /app/workspace. To access the absolute path /workspace over HTTP, encode its leading slash as %2F: GET /filesystem/%2Fworkspace. The double-slash form GET /filesystem//workspace also addresses /workspace.
          */
         path: string;
     };
@@ -1651,7 +1667,7 @@ export type DeleteProcessByIdentifierErrors = {
 export type DeleteProcessByIdentifierError = DeleteProcessByIdentifierErrors[keyof DeleteProcessByIdentifierErrors];
 export type DeleteProcessByIdentifierResponses = {
     /**
-     * Process stopped
+     * Process stop requested
      */
     200: SuccessResponse;
 };
@@ -1709,7 +1725,7 @@ export type DeleteProcessByIdentifierKillErrors = {
 export type DeleteProcessByIdentifierKillError = DeleteProcessByIdentifierKillErrors[keyof DeleteProcessByIdentifierKillErrors];
 export type DeleteProcessByIdentifierKillResponses = {
     /**
-     * Process killed
+     * Process kill requested
      */
     200: SuccessResponse;
 };
@@ -1775,7 +1791,7 @@ export type GetProcessByIdentifierLogsStreamErrors = {
 export type GetProcessByIdentifierLogsStreamError = GetProcessByIdentifierLogsStreamErrors[keyof GetProcessByIdentifierLogsStreamErrors];
 export type GetProcessByIdentifierLogsStreamResponses = {
     /**
-     * Stream of process logs, one line per log (prefixed with stdout:/stderr:)
+     * Process output, each line prefixed with stdout: or stderr:
      */
     200: string;
 };