@blaxel/core 0.2.1-dev2 → 0.2.1-dev4

package/dist/sandbox/action.d.ts

@@ -15,4 +15,5 @@ export declare class SandboxAction {
     get forcedUrl(): string | null;
     get url(): string;
     handleResponseError(response: Response, data: unknown, error: unknown): void;
+    websocket(path: string): WebSocket | null;
 }

package/dist/sandbox/action.js

@@ -61,8 +61,9 @@ class SandboxAction {
     get url() {
         if (this.forcedUrl)
             return this.forcedUrl;
-        if (settings_js_1.settings.runInternalHostname)
-            return this.internalUrl;
+        // Uncomment and use this when agent and mcp are available in mk3
+        // Update all requests made in this package to use fallbackUrl when internalUrl is not working
+        // if (settings.runInternalHostname) return this.internalUrl;
         return this.externalUrl;
     }
     handleResponseError(response, data, error) {
@@ -70,5 +71,37 @@ class SandboxAction {
             throw new ResponseError(response, data, error);
         }
     }
+    websocket(path) {
+        let ws = null;
+        // Build ws:// or wss:// URL from baseUrl
+        let baseUrl = this.url.replace(/^http/, 'ws');
+        if (baseUrl.endsWith('/'))
+            baseUrl = baseUrl.slice(0, -1);
+        const wsUrl = `${baseUrl}/ws/${path}?token=${settings_js_1.settings.token}`;
+        // Use isomorphic WebSocket: browser or Node.js
+        let WS = undefined;
+        if (typeof globalThis.WebSocket !== 'undefined') {
+            WS = globalThis.WebSocket;
+        }
+        else {
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                WS = require('ws');
+            }
+            catch {
+                WS = undefined;
+            }
+        }
+        if (!WS)
+            throw new Error('WebSocket is not available in this environment');
+        try {
+            ws = typeof WS === 'function' ? new WS(wsUrl) : new WS(wsUrl);
+        }
+        catch (err) {
+            console.error('WebSocket connection error:', err);
+            throw err;
+        }
+        return ws;
+    }
 }
 exports.SandboxAction = SandboxAction;

package/dist/sandbox/client/sdk.gen.d.ts

@@ -1,5 +1,5 @@
 import type { Options as ClientOptions, TDataShape, Client } from '@hey-api/client-fetch';
-import type { DeleteFilesystemByPathData, GetFilesystemByPathData, PutFilesystemByPathData, DeleteNetworkProcessByPidMonitorData, PostNetworkProcessByPidMonitorData, GetNetworkProcessByPidPortsData, GetProcessData, PostProcessData, DeleteProcessByIdentifierData, GetProcessByIdentifierData, DeleteProcessByIdentifierKillData, GetProcessByIdentifierLogsData, GetProcessByIdentifierLogsStreamData } from './types.gen';
+import type { DeleteFilesystemByPathData, GetFilesystemByPathData, PutFilesystemByPathData, DeleteNetworkProcessByPidMonitorData, PostNetworkProcessByPidMonitorData, GetNetworkProcessByPidPortsData, GetProcessData, PostProcessData, DeleteProcessByIdentifierData, GetProcessByIdentifierData, DeleteProcessByIdentifierKillData, GetProcessByIdentifierLogsData, GetProcessByIdentifierLogsStreamData, GetWatchFilesystemByPathData } from './types.gen';
 export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = ClientOptions<TData, ThrowOnError> & {
     /**
      * You can provide a client instance returned by `createClient()` instead of
@@ -82,9 +82,12 @@ export declare const getProcessByIdentifierLogs: <ThrowOnError extends boolean =
     [key: string]: string;
 }, import("./types.gen").ErrorResponse, ThrowOnError>;
 /**
- * Get process logs in realtime
- * Get the stdout and stderr output of a process in realtime
+ * 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.
  */
-export declare const getProcessByIdentifierLogsStream: <ThrowOnError extends boolean = false>(options: Options<GetProcessByIdentifierLogsStreamData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<{
-    [key: string]: string;
-}, import("./types.gen").ErrorResponse, ThrowOnError>;
+export declare const getProcessByIdentifierLogsStream: <ThrowOnError extends boolean = false>(options: Options<GetProcessByIdentifierLogsStreamData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<string, import("./types.gen").ErrorResponse, ThrowOnError>;
+/**
+ * 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.
+ */
+export declare const getWatchFilesystemByPath: <ThrowOnError extends boolean = false>(options: Options<GetWatchFilesystemByPathData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<string, import("./types.gen").ErrorResponse, ThrowOnError>;

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

@@ -1,7 +1,7 @@
 "use strict";
 // This file is auto-generated by @hey-api/openapi-ts
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getProcessByIdentifierLogsStream = exports.getProcessByIdentifierLogs = exports.deleteProcessByIdentifierKill = exports.getProcessByIdentifier = exports.deleteProcessByIdentifier = exports.postProcess = exports.getProcess = exports.getNetworkProcessByPidPorts = exports.postNetworkProcessByPidMonitor = exports.deleteNetworkProcessByPidMonitor = exports.putFilesystemByPath = exports.getFilesystemByPath = exports.deleteFilesystemByPath = void 0;
+exports.getWatchFilesystemByPath = exports.getProcessByIdentifierLogsStream = exports.getProcessByIdentifierLogs = exports.deleteProcessByIdentifierKill = exports.getProcessByIdentifier = exports.deleteProcessByIdentifier = exports.postProcess = exports.getProcess = exports.getNetworkProcessByPidPorts = exports.postNetworkProcessByPidMonitor = exports.deleteNetworkProcessByPidMonitor = exports.putFilesystemByPath = exports.getFilesystemByPath = exports.deleteFilesystemByPath = void 0;
 const client_gen_1 = require("./client.gen");
 /**
  * Delete file or directory
@@ -152,8 +152,8 @@ const getProcessByIdentifierLogs = (options) => {
 };
 exports.getProcessByIdentifierLogs = getProcessByIdentifierLogs;
 /**
- * Get process logs in realtime
- * Get the stdout and stderr output of a process in realtime
+ * 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.
  */
 const getProcessByIdentifierLogsStream = (options) => {
     return (options.client ?? client_gen_1.client).get({
@@ -162,3 +162,14 @@ const getProcessByIdentifierLogsStream = (options) => {
     });
 };
 exports.getProcessByIdentifierLogsStream = getProcessByIdentifierLogsStream;
+/**
+ * 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.
+ */
+const getWatchFilesystemByPath = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        url: '/watch/filesystem/{path}',
+        ...options
+    });
+};
+exports.getWatchFilesystemByPath = getWatchFilesystemByPath;

package/dist/sandbox/client/types.gen.d.ts

@@ -41,7 +41,6 @@ export type ProcessKillRequest = {
 export type ProcessRequest = {
     command: string;
     name?: string;
-    streamLogs?: boolean;
     timeout?: number;
     waitForCompletion?: boolean;
     waitForPorts?: Array<number>;
@@ -394,12 +393,7 @@ export type GetProcessByIdentifierLogsData = {
          */
         identifier: string;
     };
-    query?: {
-        /**
-         * Stream logs
-         */
-        stream?: boolean;
-    };
+    query?: never;
     url: '/process/{identifier}/logs';
 };
 export type GetProcessByIdentifierLogsErrors = {
@@ -430,12 +424,7 @@ export type GetProcessByIdentifierLogsStreamData = {
          */
         identifier: string;
     };
-    query?: {
-        /**
-         * Stream logs
-         */
-        stream?: boolean;
-    };
+    query?: never;
     url: '/process/{identifier}/logs/stream';
 };
 export type GetProcessByIdentifierLogsStreamErrors = {
@@ -451,13 +440,40 @@ export type GetProcessByIdentifierLogsStreamErrors = {
 export type GetProcessByIdentifierLogsStreamError = GetProcessByIdentifierLogsStreamErrors[keyof GetProcessByIdentifierLogsStreamErrors];
 export type GetProcessByIdentifierLogsStreamResponses = {
     /**
-     * Process logs
+     * Stream of process logs, one line per log (prefixed with stdout:/stderr:)
      */
-    200: {
-        [key: string]: string;
-    };
+    200: string;
 };
 export type GetProcessByIdentifierLogsStreamResponse = GetProcessByIdentifierLogsStreamResponses[keyof GetProcessByIdentifierLogsStreamResponses];
+export type GetWatchFilesystemByPathData = {
+    body?: never;
+    path: {
+        /**
+         * Directory path to watch
+         */
+        path: string;
+    };
+    query?: never;
+    url: '/watch/filesystem/{path}';
+};
+export type GetWatchFilesystemByPathErrors = {
+    /**
+     * Invalid path
+     */
+    400: ErrorResponse;
+    /**
+     * Internal server error
+     */
+    500: ErrorResponse;
+};
+export type GetWatchFilesystemByPathError = GetWatchFilesystemByPathErrors[keyof GetWatchFilesystemByPathErrors];
+export type GetWatchFilesystemByPathResponses = {
+    /**
+     * Stream of modified file paths, one per line
+     */
+    200: string;
+};
+export type GetWatchFilesystemByPathResponse = GetWatchFilesystemByPathResponses[keyof GetWatchFilesystemByPathResponses];
 export type ClientOptions = {
     baseUrl: `${string}://localhost:8080` | (string & {});
 };

package/dist/sandbox/filesystem.d.ts

@@ -14,5 +14,31 @@ export declare class SandboxFileSystem extends SandboxAction {
     rm(path: string, recursive?: boolean): Promise<SuccessResponse>;
     ls(path: string): Promise<Directory>;
     cp(source: string, destination: string): Promise<CopyResponse>;
+    /**
+     * Watch for changes in a directory. Calls the callback with the changed file path (and optionally its content).
+     * Returns a handle with a close() method to stop watching.
+     * @param path Directory to watch
+     * @param callback Function called on each change: (filePath, content?)
+     * @param withContent If true, also fetches and passes the file content (default: false)
+     */
+    watch(path: string, callback: (filePath: string, content?: string) => void | Promise<void>, options?: {
+        ws?: boolean;
+        onError?: (error: Error) => void;
+        withContent: boolean;
+    }): {
+        close: () => void;
+    };
+    wsWatch(path: string, callback: (filePath: string, content?: string) => void | Promise<void>, options?: {
+        onError?: (error: Error) => void;
+        withContent: boolean;
+    }): {
+        close: () => void;
+    };
+    sseWatch(path: string, callback: (filePath: string, content?: string) => void | Promise<void>, options?: {
+        onError?: (error: Error) => void;
+        withContent: boolean;
+    }): {
+        close: () => void;
+    };
     private formatPath;
 }

package/dist/sandbox/filesystem.js

@@ -111,6 +111,197 @@ class SandboxFileSystem extends action_js_1.SandboxAction {
         }
         throw new Error("Unsupported file type");
     }
+    /**
+     * Watch for changes in a directory. Calls the callback with the changed file path (and optionally its content).
+     * Returns a handle with a close() method to stop watching.
+     * @param path Directory to watch
+     * @param callback Function called on each change: (filePath, content?)
+     * @param withContent If true, also fetches and passes the file content (default: false)
+     */
+    watch(path, callback, options) {
+        if (options?.ws) {
+            return this.wsWatch(path, callback, options);
+        }
+        return this.sseWatch(path, callback, options);
+    }
+    wsWatch(path, callback, options) {
+        path = this.formatPath(path);
+        let closed = false;
+        let ws = this.websocket(`watch/filesystem${path.startsWith('/') ? path : '/' + path}`);
+        let pingInterval = null;
+        let pongTimeout = null;
+        const PING_INTERVAL_MS = 30000;
+        const PONG_TIMEOUT_MS = 10000;
+        function sendPing() {
+            if (ws && ws.readyState === ws.OPEN) {
+                try {
+                    ws.send(JSON.stringify({ type: 'ping' }));
+                }
+                catch { }
+                // Set pong timeout
+                if (pongTimeout)
+                    clearTimeout(pongTimeout);
+                pongTimeout = setTimeout(() => {
+                    // No pong received in time, close connection
+                    if (ws && typeof ws.close === 'function')
+                        ws.close();
+                }, PONG_TIMEOUT_MS);
+            }
+        }
+        if (ws) {
+            ws.onmessage = async (event) => {
+                if (closed)
+                    return;
+                let data;
+                try {
+                    data = typeof event.data === 'string' ? event.data : event.data;
+                    if (!data)
+                        return;
+                    // Accept both JSON and plain string (file path)
+                    let payload;
+                    try {
+                        payload = JSON.parse(data);
+                    }
+                    catch {
+                        payload = { name: data, event: undefined };
+                    }
+                    // Handle ping/pong
+                    if (payload.type === 'ping') {
+                        // Respond to ping with pong
+                        if (ws && ws.readyState === ws.OPEN) {
+                            try {
+                                ws.send(JSON.stringify({ type: 'pong' }));
+                            }
+                            catch { }
+                        }
+                        return;
+                    }
+                    if (payload.type === 'pong') {
+                        // Pong received, clear pong timeout
+                        if (pongTimeout)
+                            clearTimeout(pongTimeout);
+                        pongTimeout = null;
+                        return;
+                    }
+                    const filePath = payload.name || payload.path || data;
+                    if (!filePath)
+                        return;
+                    if (options?.withContent) {
+                        try {
+                            const content = await this.read(filePath);
+                            await callback(filePath, content);
+                        }
+                        catch (e) {
+                            await callback(filePath, undefined);
+                        }
+                    }
+                    else {
+                        await callback(filePath);
+                    }
+                }
+                catch (err) {
+                    if (options?.onError)
+                        options.onError(err);
+                }
+            };
+            ws.onerror = (err) => {
+                if (options?.onError)
+                    options.onError(err instanceof Error ? err : new Error(String(err)));
+                closed = true;
+                if (ws && typeof ws.close === 'function')
+                    ws.close();
+            };
+            ws.onclose = () => {
+                closed = true;
+                ws = null;
+                if (pingInterval)
+                    clearInterval(pingInterval);
+                if (pongTimeout)
+                    clearTimeout(pongTimeout);
+            };
+            // Start ping interval
+            pingInterval = setInterval(sendPing, PING_INTERVAL_MS);
+        }
+        return {
+            close: () => {
+                closed = true;
+                if (ws && typeof ws.close === 'function')
+                    ws.close();
+                ws = null;
+                if (pingInterval)
+                    clearInterval(pingInterval);
+                if (pongTimeout)
+                    clearTimeout(pongTimeout);
+            },
+        };
+    }
+    sseWatch(path, callback, options) {
+        path = this.formatPath(path);
+        let closed = false;
+        let controller = new AbortController();
+        const start = async () => {
+            const { response, data, error } = await (0, index_js_1.getWatchFilesystemByPath)({
+                path: { path },
+                baseUrl: this.url,
+                parseAs: 'stream',
+                signal: controller.signal,
+            });
+            if (error)
+                throw error;
+            const stream = data ?? response.body;
+            if (!stream)
+                throw new Error('No stream returned');
+            const reader = stream.getReader();
+            let buffer = '';
+            const decoder = new TextDecoder();
+            try {
+                while (!closed) {
+                    const { value, done } = await reader.read();
+                    if (done)
+                        break;
+                    buffer += decoder.decode(value, { stream: true });
+                    let lines = buffer.split('\n');
+                    buffer = lines.pop();
+                    for (const line of lines) {
+                        const filePath = line.trim();
+                        if (!filePath)
+                            continue;
+                        if (options?.withContent) {
+                            try {
+                                const content = await this.read(filePath);
+                                await callback(filePath, content);
+                            }
+                            catch (e) {
+                                await callback(filePath, undefined);
+                            }
+                        }
+                        else {
+                            await callback(filePath);
+                        }
+                    }
+                }
+            }
+            finally {
+                reader.releaseLock();
+            }
+        };
+        start().catch((err) => {
+            // Suppress AbortError when closing
+            if (!(err && err.name === 'AbortError')) {
+                if (options?.onError) {
+                    options.onError(err);
+                }
+            }
+            closed = true;
+            controller?.abort();
+        });
+        return {
+            close: () => {
+                closed = true;
+                controller?.abort();
+            },
+        };
+    }
     formatPath(path) {
         if (path === "/") {
             return path;

package/dist/sandbox/process.d.ts

@@ -3,7 +3,33 @@ import { SandboxAction } from "./action.js";
 import { DeleteProcessByIdentifierKillResponse, DeleteProcessByIdentifierResponse, GetProcessByIdentifierResponse, GetProcessResponse, PostProcessResponse, ProcessRequest } from "./client/index.js";
 export declare class SandboxProcess extends SandboxAction {
     constructor(sandbox: Sandbox);
+    streamLogs(identifier: string, options: {
+        ws?: boolean;
+        onLog?: (log: string) => void;
+        onStdout?: (stdout: string) => void;
+        onStderr?: (stderr: string) => void;
+    }): {
+        close: () => void;
+    };
+    wsStreamLogs(identifier: string, options: {
+        onLog?: (log: string) => void;
+        onStdout?: (stdout: string) => void;
+        onStderr?: (stderr: string) => void;
+    }): {
+        close: () => void;
+    };
+    sseStreamLogs(identifier: string, options: {
+        onLog?: (log: string) => void;
+        onStdout?: (stdout: string) => void;
+        onStderr?: (stderr: string) => void;
+    }): {
+        close: () => void;
+    };
     exec(process: ProcessRequest): Promise<PostProcessResponse>;
+    wait(identifier: string, { maxWait, interval }?: {
+        maxWait?: number;
+        interval?: number;
+    }): Promise<GetProcessByIdentifierResponse>;
     get(identifier: string): Promise<GetProcessByIdentifierResponse>;
     list(): Promise<GetProcessResponse>;
     stop(identifier: string): Promise<DeleteProcessByIdentifierResponse>;

package/dist/sandbox/process.js

@@ -1,12 +1,176 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SandboxProcess = void 0;
+const settings_js_1 = require("../common/settings.js");
 const action_js_1 = require("./action.js");
 const index_js_1 = require("./client/index.js");
 class SandboxProcess extends action_js_1.SandboxAction {
     constructor(sandbox) {
         super(sandbox);
     }
+    streamLogs(identifier, options) {
+        if (options.ws) {
+            return this.wsStreamLogs(identifier, options);
+        }
+        return this.sseStreamLogs(identifier, options);
+    }
+    wsStreamLogs(identifier, options) {
+        let closed = false;
+        let ws = this.websocket(`process/${identifier}/logs/stream`);
+        let pingInterval = null;
+        let pongTimeout = null;
+        const PING_INTERVAL_MS = 30000;
+        const PONG_TIMEOUT_MS = 10000;
+        function sendPing() {
+            if (ws && ws.readyState === ws.OPEN) {
+                try {
+                    ws.send(JSON.stringify({ type: 'ping' }));
+                }
+                catch { }
+                // Set pong timeout
+                if (pongTimeout)
+                    clearTimeout(pongTimeout);
+                pongTimeout = setTimeout(() => {
+                    // No pong received in time, close connection
+                    if (ws && typeof ws.close === 'function')
+                        ws.close();
+                }, PONG_TIMEOUT_MS);
+            }
+        }
+        if (ws) {
+            ws.onmessage = (event) => {
+                if (closed)
+                    return;
+                let data;
+                try {
+                    data = typeof event.data === 'string' ? event.data : event.data;
+                    if (!data)
+                        return;
+                    let payload;
+                    try {
+                        payload = JSON.parse(data);
+                    }
+                    catch {
+                        payload = { log: data };
+                    }
+                    // Handle ping/pong
+                    if (payload.type === 'ping') {
+                        // Respond to ping with pong
+                        if (ws && ws.readyState === ws.OPEN) {
+                            try {
+                                ws.send(JSON.stringify({ type: 'pong' }));
+                            }
+                            catch { }
+                        }
+                        return;
+                    }
+                    if (payload.type === 'pong') {
+                        // Pong received, clear pong timeout
+                        if (pongTimeout)
+                            clearTimeout(pongTimeout);
+                        pongTimeout = null;
+                        return;
+                    }
+                    if (payload.type === 'log') {
+                        const logLine = payload.log || "";
+                        if (typeof logLine === 'string') {
+                            if (logLine.startsWith('stdout:')) {
+                                options.onStdout?.(logLine.slice(7));
+                                options.onLog?.(logLine.slice(7));
+                            }
+                            else if (logLine.startsWith('stderr:')) {
+                                options.onStderr?.(logLine.slice(7));
+                                options.onLog?.(logLine.slice(7));
+                            }
+                            else {
+                                options.onLog?.(logLine);
+                            }
+                        }
+                    }
+                }
+                catch (err) {
+                    console.error('WebSocket log stream error:', err);
+                }
+            };
+            ws.onerror = (err) => {
+                closed = true;
+                if (ws && typeof ws.close === 'function')
+                    ws.close();
+            };
+            ws.onclose = () => {
+                closed = true;
+                ws = null;
+                if (pingInterval)
+                    clearInterval(pingInterval);
+                if (pongTimeout)
+                    clearTimeout(pongTimeout);
+            };
+            // Start ping interval
+            pingInterval = setInterval(sendPing, PING_INTERVAL_MS);
+        }
+        return {
+            close: () => {
+                closed = true;
+                if (ws && typeof ws.close === 'function')
+                    ws.close();
+                ws = null;
+                if (pingInterval)
+                    clearInterval(pingInterval);
+                if (pongTimeout)
+                    clearTimeout(pongTimeout);
+            },
+        };
+    }
+    sseStreamLogs(identifier, options) {
+        const controller = new AbortController();
+        (async () => {
+            try {
+                const stream = await fetch(`${this.url}/process/${identifier}/logs/stream`, {
+                    method: 'GET',
+                    signal: controller.signal,
+                    headers: settings_js_1.settings.headers,
+                });
+                if (stream.status !== 200) {
+                    throw new Error(`Failed to stream logs: ${await stream.text()}`);
+                }
+                if (!stream.body)
+                    throw new Error('No stream body');
+                const reader = stream.body.getReader();
+                const decoder = new TextDecoder();
+                let buffer = '';
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    buffer += decoder.decode(value, { stream: true });
+                    let lines = buffer.split(/\r?\n/);
+                    buffer = lines.pop();
+                    for (const line of lines) {
+                        if (line.startsWith('stdout:')) {
+                            options.onStdout?.(line.slice(7));
+                            options.onLog?.(line.slice(7));
+                        }
+                        else if (line.startsWith('stderr:')) {
+                            options.onStderr?.(line.slice(7));
+                            options.onLog?.(line.slice(7));
+                        }
+                        else {
+                            options.onLog?.(line);
+                        }
+                    }
+                }
+            }
+            catch (err) {
+                if (err && err.name !== 'AbortError') {
+                    console.error("Stream error:", err);
+                    throw err;
+                }
+            }
+        })();
+        return {
+            close: () => controller.abort(),
+        };
+    }
     async exec(process) {
         const { response, data, error } = await (0, index_js_1.postProcess)({
             body: process,
@@ -15,6 +179,25 @@ class SandboxProcess extends action_js_1.SandboxAction {
         this.handleResponseError(response, data, error);
         return data;
     }
+    async wait(identifier, { maxWait = 60000, interval = 1000 } = {}) {
+        const startTime = Date.now();
+        let status = "running";
+        let data = await this.get(identifier);
+        while (status === "running") {
+            await new Promise((resolve) => setTimeout(resolve, interval));
+            try {
+                data = await this.get(identifier);
+                status = data.status ?? "running";
+            }
+            catch {
+                break;
+            }
+            if (Date.now() - startTime > maxWait) {
+                throw new Error("Process did not finish in time");
+            }
+        }
+        return data;
+    }
     async get(identifier) {
         const { response, data, error } = await (0, index_js_1.getProcessByIdentifier)({
             path: { identifier },

package/dist/telemetry/telemetry.d.ts

@@ -55,4 +55,5 @@ export declare const telemetryRegistry: TelemetryRegistry;
  * Create a span with the registered provider
  */
 export declare function startSpan(name: string, options?: BlaxelSpanOptions): BlaxelSpan;
+export declare function withSpan<T>(name: string, fn: () => T, options?: BlaxelSpanOptions): T;
 export {};

package/dist/telemetry/telemetry.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.telemetryRegistry = void 0;
 exports.startSpan = startSpan;
+exports.withSpan = withSpan;
 /**
  * No-operation implementation of Span
  */
@@ -57,3 +58,16 @@ exports.telemetryRegistry = TelemetryRegistry.getInstance();
 function startSpan(name, options) {
     return exports.telemetryRegistry.getProvider().startSpan(name, options);
 }
+function withSpan(name, fn, options) {
+    const span = startSpan(name, options);
+    try {
+        const result = fn();
+        span.end();
+        return result;
+    }
+    catch (error) {
+        span.recordException(error);
+        span.end();
+        throw error;
+    }
+}

package/package.json

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