@blaxel/core 0.2.51-preview.125 → 0.2.52-dev.8

package/dist/esm/common/autoload.js

@@ -2,6 +2,7 @@ import { client } from "../client/client.gen.js";
 import { interceptors } from "../client/interceptors.js";
 import { responseInterceptors } from "../client/responseInterceptor.js";
 import { client as clientSandbox } from "../sandbox/client/client.gen.js";
+import { initSentry } from "./sentry.js";
 import { settings } from "./settings.js";
 client.setConfig({
     baseUrl: settings.baseUrl,
@@ -18,6 +19,8 @@ for (const interceptor of responseInterceptors) {
     client.interceptors.response.use(interceptor);
     clientSandbox.interceptors.response.use(interceptor);
 }
+// Initialize Sentry for SDK error tracking immediately when module loads
+initSentry();
 // Allow to set custom configuration for browser environment
 export function initialize(config) {
     settings.setConfig(config);

package/dist/esm/common/sentry.js

@@ -0,0 +1,181 @@
+import { settings } from "./settings.js";
+import * as Sentry from "@sentry/node";
+import { makeNodeTransport } from "@sentry/node";
+// Isolated Sentry client for SDK-only error tracking (doesn't interfere with user's Sentry)
+let sentryClient = null;
+const capturedExceptions = new Set();
+let handlersRegistered = false;
+// SDK path patterns to identify errors originating from our SDK
+const SDK_PATTERNS = [
+    "@blaxel/",
+    "blaxel-sdk",
+    "/node_modules/@blaxel/",
+    "/@blaxel/core/",
+    "/@blaxel/telemetry/",
+];
+/**
+ * Check if an error originated from the SDK based on its stack trace.
+ * Returns true if the stack trace contains any SDK-related paths.
+ */
+function isFromSDK(error) {
+    const stack = error.stack || "";
+    return SDK_PATTERNS.some((pattern) => stack.includes(pattern));
+}
+/**
+ * Initialize an isolated Sentry client for SDK error tracking.
+ * This creates a separate Sentry instance that won't interfere with any
+ * Sentry configuration the user might have in their application.
+ */
+export function initSentry() {
+    try {
+        const dsn = settings.sentryDsn;
+        if (!dsn) {
+            return;
+        }
+        // Create an isolated Sentry client that doesn't touch the global scope
+        // This allows users to have their own Sentry.init() without conflicts
+        sentryClient = new Sentry.NodeClient({
+            dsn,
+            environment: settings.env,
+            release: `sdk-typescript@${settings.version}`,
+            transport: makeNodeTransport,
+            stackParser: Sentry.defaultStackParser,
+            // No integrations - we handle error capturing manually
+            integrations: [],
+            // Disable traces for the SDK client
+            tracesSampleRate: 0,
+            // Filter errors before sending - only send SDK errors
+            beforeSend(event, hint) {
+                const error = hint.originalException;
+                if (error instanceof Error) {
+                    if (!isFromSDK(error)) {
+                        // Drop errors that don't originate from SDK
+                        return null;
+                    }
+                }
+                return event;
+            },
+        });
+        sentryClient.init();
+        // Set SDK-specific tags
+        const scope = new Sentry.Scope();
+        scope.setTag("blaxel.workspace", settings.workspace);
+        scope.setTag("blaxel.version", settings.version);
+        scope.setTag("blaxel.commit", settings.commit);
+        scope.setClient(sentryClient);
+        // Register process handlers for uncaught errors (Node.js only)
+        // Only register once to prevent memory leaks
+        if (typeof process !== "undefined" &&
+            typeof process.on === "function" &&
+            !handlersRegistered) {
+            handlersRegistered = true;
+            // For SIGTERM/SIGINT, flush before exit
+            const signalHandler = (signal) => {
+                flushSentry(500)
+                    .catch(() => {
+                    // Silently fail
+                })
+                    .finally(() => {
+                    process.exit(signal === "SIGTERM" ? 143 : 130);
+                });
+            };
+            // Uncaught exception handler - only capture SDK errors
+            const uncaughtExceptionHandler = (error) => {
+                if (isFromSDK(error)) {
+                    captureException(error);
+                }
+                // Let the default Node.js behavior handle the process exit
+            };
+            // Unhandled rejection handler - only capture SDK errors
+            const unhandledRejectionHandler = (reason) => {
+                const error = reason instanceof Error ? reason : new Error(String(reason));
+                if (isFromSDK(error)) {
+                    captureException(error);
+                }
+            };
+            process.on("SIGTERM", () => signalHandler("SIGTERM"));
+            process.on("SIGINT", () => signalHandler("SIGINT"));
+            process.on("uncaughtException", uncaughtExceptionHandler);
+            process.on("unhandledRejection", unhandledRejectionHandler);
+            // Intercept console.error to capture SDK errors that are caught and logged
+            const originalConsoleError = console.error;
+            console.error = function (...args) {
+                // Call the original console.error first
+                originalConsoleError.apply(console, args);
+                // Check if any argument is an Error from SDK and capture it
+                for (const arg of args) {
+                    if (arg instanceof Error && isFromSDK(arg)) {
+                        captureException(arg);
+                        break; // Only capture the first SDK error to avoid duplicates
+                    }
+                }
+            };
+        }
+    }
+    catch (error) {
+        // Silently fail - Sentry initialization should never break the SDK
+        if (settings.env !== "production") {
+            console.error("[Blaxel SDK] Error initializing Sentry:", error);
+        }
+    }
+}
+/**
+ * Capture an exception to the SDK's isolated Sentry client.
+ * Only errors originating from SDK code will be captured.
+ *
+ * @param error - The error to capture
+ */
+function captureException(error) {
+    if (sentryClient === null) {
+        return;
+    }
+    // Double-check that error is from SDK (defense in depth)
+    if (!isFromSDK(error)) {
+        return;
+    }
+    try {
+        // Create a unique identifier for this exception to avoid duplicates
+        const errorKey = `${error.name}:${error.message}:${error.stack?.slice(0, 200)}`;
+        if (capturedExceptions.has(errorKey)) {
+            return;
+        }
+        capturedExceptions.add(errorKey);
+        // Clean up old exception keys to prevent memory leak
+        if (capturedExceptions.size > 1000) {
+            capturedExceptions.clear();
+        }
+        // Create a scope with SDK tags and capture the exception
+        const scope = new Sentry.Scope();
+        scope.setTag("blaxel.workspace", settings.workspace);
+        scope.setTag("blaxel.version", settings.version);
+        scope.setTag("blaxel.commit", settings.commit);
+        scope.setClient(sentryClient);
+        scope.captureException(error);
+    }
+    catch {
+        // Silently fail - error capturing should never break the SDK
+    }
+}
+/**
+ * Flush pending Sentry events.
+ * This should be called before the process exits to ensure all events are sent.
+ *
+ * @param timeout - Maximum time in milliseconds to wait for flush (default: 2000)
+ */
+export async function flushSentry(timeout = 2000) {
+    if (sentryClient === null) {
+        return;
+    }
+    try {
+        await sentryClient.flush(timeout);
+    }
+    catch {
+        // Silently fail
+    }
+}
+/**
+ * Check if Sentry is initialized and available.
+ */
+export function isSentryInitialized() {
+    return sentryClient !== null;
+}

package/dist/esm/common/settings.js

@@ -1,25 +1,9 @@
 import { authentication } from "../authentication/index.js";
 import { env } from "../common/env.js";
-// Function to get package version
-function getPackageVersion() {
-    try {
-        // Check if require is available (CommonJS environment)
-        if (typeof require !== "undefined") {
-            // Try to require package.json (Node.js only, gracefully fails in browser)
-            // eslint-disable-next-line @typescript-eslint/no-require-imports
-            const packageJson = {"version":"0.2.51-preview.125","commit":"3853140a51897f5f5d076412f419c105d7f968ab"};
-            return packageJson.version || "unknown";
-        }
-        else {
-            // ESM environment - return unknown
-            return "unknown";
-        }
-    }
-    catch {
-        // Fallback for browser environments or if require fails
-        return "unknown";
-    }
-}
+// Build info - these placeholders are replaced at build time by build:replace-imports
+const BUILD_VERSION = "0.2.52-dev.8";
+const BUILD_COMMIT = "fa33ac70c1091576d0ebc47218eed9f378d94a32";
+const BUILD_SENTRY_DSN = "";
 // Function to get OS and architecture
 function getOsArch() {
     try {
@@ -52,30 +36,9 @@ function getOsArch() {
     }
     return "browser/unknown";
 }
-// Function to get commit hash
-function getCommitHash() {
-    try {
-        // Check if require is available (CommonJS environment)
-        if (typeof require !== "undefined") {
-            // Try to require package.json and look for commit field (set during build)
-            // eslint-disable-next-line @typescript-eslint/no-require-imports
-            const packageJson = {"version":"0.2.51-preview.125","commit":"3853140a51897f5f5d076412f419c105d7f968ab"};
-            // Check for commit in various possible locations
-            const commit = packageJson.commit || packageJson.buildInfo?.commit;
-            if (commit) {
-                return commit.length > 7 ? commit.substring(0, 7) : commit;
-            }
-        }
-    }
-    catch {
-        // Fallback for browser environments or if require fails
-    }
-    return "unknown";
-}
 class Settings {
     credentials;
     config;
-    _version = null;
     constructor() {
         this.credentials = authentication();
         this.config = {
@@ -130,18 +93,21 @@ class Settings {
         return this.credentials.token;
     }
     get version() {
-        if (this._version === null) {
-            this._version = getPackageVersion();
-        }
-        return this._version;
+        return BUILD_VERSION || "unknown";
+    }
+    get commit() {
+        const commit = BUILD_COMMIT || "unknown";
+        return commit.length > 7 ? commit.substring(0, 7) : commit;
+    }
+    get sentryDsn() {
+        return BUILD_SENTRY_DSN || "";
     }
     get headers() {
         const osArch = getOsArch();
-        const commitHash = getCommitHash();
         return {
             "x-blaxel-authorization": this.authorization,
             "x-blaxel-workspace": this.workspace || "",
-            "User-Agent": `blaxel/sdk/typescript/${this.version} (${osArch}) blaxel/${commitHash}`,
+            "User-Agent": `blaxel/sdk/typescript/${this.version} (${osArch}) blaxel/${this.commit}`,
         };
     }
     get name() {

package/dist/esm/common/version.js

@@ -0,0 +1,3 @@
+// This file is auto-generated during build. Do not edit manually.
+export const PACKAGE_VERSION = "0.2.50";
+export const PACKAGE_COMMIT = "4a74989dcb65a6ff8d826aed7976436c64554f6a";

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

@@ -164,6 +164,38 @@ export const getCodegenRerankingByPath = (options) => {
         ...options
     });
 };
+/**
+ * Search for text content in files
+ * Searches for text content inside files using ripgrep. Returns matching lines with context.
+ */
+export const getFilesystemContentSearchByPath = (options) => {
+    return (options.client ?? _heyApiClient).get({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/filesystem-content-search/{path}',
+        ...options
+    });
+};
+/**
+ * Find files and directories
+ * Finds files and directories using the find command.
+ */
+export const getFilesystemFindByPath = (options) => {
+    return (options.client ?? _heyApiClient).get({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/filesystem-find/{path}',
+        ...options
+    });
+};
 /**
  * List multipart uploads
  * List all active multipart uploads
@@ -273,6 +305,22 @@ 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.
+ */
+export const getFilesystemSearchByPath = (options) => {
+    return (options.client ?? _heyApiClient).get({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/filesystem-search/{path}',
+        ...options
+    });
+};
 /**
  * Delete file or directory
  * Delete a file or directory
@@ -325,6 +373,58 @@ export const putFilesystemByPath = (options) => {
         }
     });
 };
+/**
+ * Delete directory tree
+ * Delete a directory tree recursively
+ */
+export const deleteFilesystemTreeByPath = (options) => {
+    return (options.client ?? _heyApiClient).delete({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/filesystem/tree/{path}',
+        ...options
+    });
+};
+/**
+ * Get directory tree
+ * Get a recursive directory tree structure starting from the specified path
+ */
+export const getFilesystemTreeByPath = (options) => {
+    return (options.client ?? _heyApiClient).get({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/filesystem/tree/{path}',
+        ...options
+    });
+};
+/**
+ * Create or update directory tree
+ * Create or update multiple files within a directory tree structure
+ */
+export const putFilesystemTreeByPath = (options) => {
+    return (options.client ?? _heyApiClient).put({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/filesystem/tree/{path}',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options?.headers
+        }
+    });
+};
 /**
  * Stop monitoring ports for a process
  * Stop monitoring for new ports opened by a process
@@ -509,3 +609,19 @@ export const getWatchFilesystemByPath = (options) => {
         ...options
     });
 };
+/**
+ * WebSocket endpoint
+ * WebSocket endpoint for all sandbox operations
+ */
+export const getWs = (options) => {
+    return (options?.client ?? _heyApiClient).get({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/ws',
+        ...options
+    });
+};

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

@@ -1,7 +1,7 @@
-import { settings } from "../../common/settings.js";
 import { fs } from "../../common/node.js";
+import { settings } from "../../common/settings.js";
 import { SandboxAction } from "../action.js";
-import { deleteFilesystemByPath, getFilesystemByPath, getWatchFilesystemByPath, putFilesystemByPath, postFilesystemMultipartInitiateByPath, putFilesystemMultipartByUploadIdPart, postFilesystemMultipartByUploadIdComplete, deleteFilesystemMultipartByUploadIdAbort } from "../client/index.js";
+import { deleteFilesystemByPath, deleteFilesystemMultipartByUploadIdAbort, getFilesystemByPath, getFilesystemContentSearchByPath, getFilesystemFindByPath, getFilesystemSearchByPath, getWatchFilesystemByPath, postFilesystemMultipartByUploadIdComplete, postFilesystemMultipartInitiateByPath, putFilesystemByPath, putFilesystemMultipartByUploadIdPart } from "../client/index.js";
 // Multipart upload constants
 const MULTIPART_THRESHOLD = 5 * 1024 * 1024; // 5MB
 const CHUNK_SIZE = 5 * 1024 * 1024; // 5MB per part
@@ -196,6 +196,86 @@ export class SandboxFileSystem extends SandboxAction {
         }
         return data;
     }
+    async search(query, path = "/", options) {
+        const formattedPath = this.formatPath(path);
+        const queryParams = {};
+        if (options?.maxResults !== undefined) {
+            queryParams.maxResults = options.maxResults;
+        }
+        if (options?.patterns && options.patterns.length > 0) {
+            queryParams.patterns = options.patterns.join(',');
+        }
+        if (options?.excludeDirs && options.excludeDirs.length > 0) {
+            queryParams.excludeDirs = options.excludeDirs.join(',');
+        }
+        if (options?.excludeHidden !== undefined) {
+            queryParams.excludeHidden = options.excludeHidden;
+        }
+        const result = await getFilesystemSearchByPath({
+            path: { path: formattedPath },
+            query: queryParams,
+            baseUrl: this.url,
+            client: this.client,
+        });
+        this.handleResponseError(result.response, result.data, result.error);
+        return result.data;
+    }
+    async find(path, options) {
+        const formattedPath = this.formatPath(path);
+        const queryParams = {};
+        if (options?.type) {
+            queryParams.type = options.type;
+        }
+        if (options?.patterns && options.patterns.length > 0) {
+            queryParams.patterns = options.patterns.join(',');
+        }
+        if (options?.maxResults !== undefined) {
+            queryParams.maxResults = options.maxResults;
+        }
+        if (options?.excludeDirs && options.excludeDirs.length > 0) {
+            queryParams.excludeDirs = options.excludeDirs.join(',');
+        }
+        if (options?.excludeHidden !== undefined) {
+            queryParams.excludeHidden = options.excludeHidden;
+        }
+        const result = await getFilesystemFindByPath({
+            path: { path: formattedPath },
+            query: queryParams,
+            baseUrl: this.url,
+            client: this.client,
+        });
+        this.handleResponseError(result.response, result.data, result.error);
+        return result.data;
+    }
+    async grep(query, path = "/", options) {
+        const formattedPath = this.formatPath(path);
+        const queryParams = {
+            query,
+        };
+        if (options?.caseSensitive !== undefined) {
+            queryParams.caseSensitive = options.caseSensitive;
+        }
+        if (options?.contextLines !== undefined) {
+            queryParams.contextLines = options.contextLines;
+        }
+        if (options?.maxResults !== undefined) {
+            queryParams.maxResults = options.maxResults;
+        }
+        if (options?.filePattern) {
+            queryParams.filePattern = options.filePattern;
+        }
+        if (options?.excludeDirs && options.excludeDirs.length > 0) {
+            queryParams.excludeDirs = options.excludeDirs.join(',');
+        }
+        const result = await getFilesystemContentSearchByPath({
+            path: { path: formattedPath },
+            query: queryParams,
+            baseUrl: this.url,
+            client: this.client,
+        });
+        this.handleResponseError(result.response, result.data, result.error);
+        return result.data;
+    }
     async cp(source, destination, { maxWait = 180000 } = {}) {
         let process = await this.process.exec({
             command: `cp -r ${source} ${destination}`,