@blaxel/core 0.2.1-dev1 → 0.2.1-dev11

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

@@ -1,5 +1,5 @@
 import type { Options as ClientOptions, TDataShape, Client } from '@hey-api/client-fetch';
-import type { ListAgentsData, CreateAgentData, DeleteAgentData, GetAgentData, UpdateAgentData, ListAgentRevisionsData, GetConfigurationData, ListFunctionsData, CreateFunctionData, DeleteFunctionData, GetFunctionData, UpdateFunctionData, ListFunctionRevisionsData, GetIntegrationData, ListIntegrationConnectionsData, CreateIntegrationConnectionData, DeleteIntegrationConnectionData, GetIntegrationConnectionData, UpdateIntegrationConnectionData, GetIntegrationConnectionModelEndpointConfigurationsData, ListIntegrationConnectionModelsData, GetIntegrationConnectionModelData, ListKnowledgebasesData, CreateKnowledgebaseData, DeleteKnowledgebaseData, GetKnowledgebaseData, UpdateKnowledgebaseData, ListKnowledgebaseRevisionsData, ListLocationsData, ListMcpHubDefinitionsData, ListModelsData, CreateModelData, DeleteModelData, GetModelData, UpdateModelData, ListModelRevisionsData, ListPoliciesData, CreatePolicyData, DeletePolicyData, GetPolicyData, UpdatePolicyData, ListPrivateClustersData, CreatePrivateClusterData, DeletePrivateClusterData, GetPrivateClusterData, UpdatePrivateClusterData, GetPrivateClusterHealthData, UpdatePrivateClusterHealthData, ListAllPendingInvitationsData, ListSandboxHubDefinitionsData, ListSandboxesData, CreateSandboxData, DeleteSandboxData, GetSandboxData, UpdateSandboxData, ListSandboxPreviewsData, CreateSandboxPreviewData, DeleteSandboxPreviewData, GetSandboxPreviewData, UpdateSandboxPreviewData, ListSandboxPreviewTokensData, CreateSandboxPreviewTokenData, DeleteSandboxPreviewTokenData, StartSandboxData, StopSandboxData, GetWorkspaceServiceAccountsData, CreateWorkspaceServiceAccountData, DeleteWorkspaceServiceAccountData, UpdateWorkspaceServiceAccountData, ListApiKeysForServiceAccountData, CreateApiKeyForServiceAccountData, DeleteApiKeyForServiceAccountData, ListTemplatesData, GetTemplateData, GetTemplateContentsData, GetTemplateFileContentsData, ListWorkspaceUsersData, InviteWorkspaceUserData, RemoveWorkspaceUserData, UpdateWorkspaceUserRoleData, ListWorkspacesData, CreateWorspaceData, DeleteWorkspaceData, GetWorkspaceData, UpdateWorkspaceData, DeclineWorkspaceInvitationData, AcceptWorkspaceInvitationData, LeaveWorkspaceData, CheckWorkspaceAvailabilityData } from './types.gen.js';
+import type { ListAgentsData, CreateAgentData, DeleteAgentData, GetAgentData, UpdateAgentData, ListAgentRevisionsData, GetConfigurationData, ListFunctionsData, CreateFunctionData, DeleteFunctionData, GetFunctionData, UpdateFunctionData, ListFunctionRevisionsData, GetIntegrationData, ListIntegrationConnectionsData, CreateIntegrationConnectionData, DeleteIntegrationConnectionData, GetIntegrationConnectionData, UpdateIntegrationConnectionData, GetIntegrationConnectionModelEndpointConfigurationsData, ListIntegrationConnectionModelsData, GetIntegrationConnectionModelData, ListJobsData, CreateJobData, DeleteJobData, GetJobData, UpdateJobData, ListJobRevisionsData, ListKnowledgebasesData, CreateKnowledgebaseData, DeleteKnowledgebaseData, GetKnowledgebaseData, UpdateKnowledgebaseData, ListKnowledgebaseRevisionsData, ListLocationsData, ListMcpHubDefinitionsData, ListModelsData, CreateModelData, DeleteModelData, GetModelData, UpdateModelData, ListModelRevisionsData, ListPoliciesData, CreatePolicyData, DeletePolicyData, GetPolicyData, UpdatePolicyData, ListPrivateClustersData, CreatePrivateClusterData, DeletePrivateClusterData, GetPrivateClusterData, UpdatePrivateClusterData, GetPrivateClusterHealthData, UpdatePrivateClusterHealthData, ListAllPendingInvitationsData, ListSandboxHubDefinitionsData, ListSandboxesData, CreateSandboxData, DeleteSandboxData, GetSandboxData, UpdateSandboxData, ListSandboxPreviewsData, CreateSandboxPreviewData, DeleteSandboxPreviewData, GetSandboxPreviewData, UpdateSandboxPreviewData, ListSandboxPreviewTokensData, CreateSandboxPreviewTokenData, DeleteSandboxPreviewTokenData, StartSandboxData, StopSandboxData, GetWorkspaceServiceAccountsData, CreateWorkspaceServiceAccountData, DeleteWorkspaceServiceAccountData, UpdateWorkspaceServiceAccountData, ListApiKeysForServiceAccountData, CreateApiKeyForServiceAccountData, DeleteApiKeyForServiceAccountData, ListTemplatesData, GetTemplateData, GetTemplateContentsData, GetTemplateFileContentsData, ListWorkspaceUsersData, InviteWorkspaceUserData, RemoveWorkspaceUserData, UpdateWorkspaceUserRoleData, ListWorkspacesData, CreateWorspaceData, DeleteWorkspaceData, GetWorkspaceData, UpdateWorkspaceData, DeclineWorkspaceInvitationData, AcceptWorkspaceInvitationData, LeaveWorkspaceData, CheckWorkspaceAvailabilityData } from './types.gen.js';
 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
@@ -111,6 +111,36 @@ export declare const listIntegrationConnectionModels: <ThrowOnError extends bool
  * Returns a model for an integration connection by ID.
  */
 export declare const getIntegrationConnectionModel: <ThrowOnError extends boolean = false>(options: Options<GetIntegrationConnectionModelData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<unknown, unknown, ThrowOnError>;
+/**
+ * List jobs
+ * Returns a list of all jobs in the workspace.
+ */
+export declare const listJobs: <ThrowOnError extends boolean = false>(options?: Options<ListJobsData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen.js").Job[], unknown, ThrowOnError>;
+/**
+ * Create job
+ * Creates a job.
+ */
+export declare const createJob: <ThrowOnError extends boolean = false>(options: Options<CreateJobData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen.js").Job, unknown, ThrowOnError>;
+/**
+ * Delete job
+ * Deletes a job by name.
+ */
+export declare const deleteJob: <ThrowOnError extends boolean = false>(options: Options<DeleteJobData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen.js").Job, unknown, ThrowOnError>;
+/**
+ * Get job
+ * Returns a job by name.
+ */
+export declare const getJob: <ThrowOnError extends boolean = false>(options: Options<GetJobData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen.js").Model, unknown, ThrowOnError>;
+/**
+ * Create or update job
+ * Update a job by name.
+ */
+export declare const updateJob: <ThrowOnError extends boolean = false>(options: Options<UpdateJobData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen.js").Job, unknown, ThrowOnError>;
+/**
+ * List job revisions
+ * Returns revisions for a job by name.
+ */
+export declare const listJobRevisions: <ThrowOnError extends boolean = false>(options: Options<ListJobRevisionsData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen.js").RevisionMetadata[], unknown, ThrowOnError>;
 /**
  * List knowledgebases
  * Returns a list of all knowledgebases in the workspace.

package/dist/client/sdk.gen.js

@@ -1,8 +1,8 @@
 "use strict";
 // This file is auto-generated by @hey-api/openapi-ts
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.listSandboxHubDefinitions = exports.listAllPendingInvitations = exports.updatePrivateClusterHealth = exports.getPrivateClusterHealth = exports.updatePrivateCluster = exports.getPrivateCluster = exports.deletePrivateCluster = exports.createPrivateCluster = exports.listPrivateClusters = exports.updatePolicy = exports.getPolicy = exports.deletePolicy = exports.createPolicy = exports.listPolicies = exports.listModelRevisions = exports.updateModel = exports.getModel = exports.deleteModel = exports.createModel = exports.listModels = exports.listMcpHubDefinitions = exports.listLocations = exports.listKnowledgebaseRevisions = exports.updateKnowledgebase = exports.getKnowledgebase = exports.deleteKnowledgebase = exports.createKnowledgebase = exports.listKnowledgebases = exports.getIntegrationConnectionModel = exports.listIntegrationConnectionModels = exports.getIntegrationConnectionModelEndpointConfigurations = exports.updateIntegrationConnection = exports.getIntegrationConnection = exports.deleteIntegrationConnection = exports.createIntegrationConnection = exports.listIntegrationConnections = exports.getIntegration = exports.listFunctionRevisions = exports.updateFunction = exports.getFunction = exports.deleteFunction = exports.createFunction = exports.listFunctions = exports.getConfiguration = exports.listAgentRevisions = exports.updateAgent = exports.getAgent = exports.deleteAgent = exports.createAgent = exports.listAgents = void 0;
-exports.checkWorkspaceAvailability = exports.leaveWorkspace = exports.acceptWorkspaceInvitation = exports.declineWorkspaceInvitation = exports.updateWorkspace = exports.getWorkspace = exports.deleteWorkspace = exports.createWorspace = exports.listWorkspaces = exports.updateWorkspaceUserRole = exports.removeWorkspaceUser = exports.inviteWorkspaceUser = exports.listWorkspaceUsers = exports.getTemplateFileContents = exports.getTemplateContents = exports.getTemplate = exports.listTemplates = exports.deleteApiKeyForServiceAccount = exports.createApiKeyForServiceAccount = exports.listApiKeysForServiceAccount = exports.updateWorkspaceServiceAccount = exports.deleteWorkspaceServiceAccount = exports.createWorkspaceServiceAccount = exports.getWorkspaceServiceAccounts = exports.stopSandbox = exports.startSandbox = exports.deleteSandboxPreviewToken = exports.createSandboxPreviewToken = exports.listSandboxPreviewTokens = exports.updateSandboxPreview = exports.getSandboxPreview = exports.deleteSandboxPreview = exports.createSandboxPreview = exports.listSandboxPreviews = exports.updateSandbox = exports.getSandbox = exports.deleteSandbox = exports.createSandbox = exports.listSandboxes = void 0;
+exports.deletePrivateCluster = exports.createPrivateCluster = exports.listPrivateClusters = exports.updatePolicy = exports.getPolicy = exports.deletePolicy = exports.createPolicy = exports.listPolicies = exports.listModelRevisions = exports.updateModel = exports.getModel = exports.deleteModel = exports.createModel = exports.listModels = exports.listMcpHubDefinitions = exports.listLocations = exports.listKnowledgebaseRevisions = exports.updateKnowledgebase = exports.getKnowledgebase = exports.deleteKnowledgebase = exports.createKnowledgebase = exports.listKnowledgebases = exports.listJobRevisions = exports.updateJob = exports.getJob = exports.deleteJob = exports.createJob = exports.listJobs = exports.getIntegrationConnectionModel = exports.listIntegrationConnectionModels = exports.getIntegrationConnectionModelEndpointConfigurations = exports.updateIntegrationConnection = exports.getIntegrationConnection = exports.deleteIntegrationConnection = exports.createIntegrationConnection = exports.listIntegrationConnections = exports.getIntegration = exports.listFunctionRevisions = exports.updateFunction = exports.getFunction = exports.deleteFunction = exports.createFunction = exports.listFunctions = exports.getConfiguration = exports.listAgentRevisions = exports.updateAgent = exports.getAgent = exports.deleteAgent = exports.createAgent = exports.listAgents = void 0;
+exports.checkWorkspaceAvailability = exports.leaveWorkspace = exports.acceptWorkspaceInvitation = exports.declineWorkspaceInvitation = exports.updateWorkspace = exports.getWorkspace = exports.deleteWorkspace = exports.createWorspace = exports.listWorkspaces = exports.updateWorkspaceUserRole = exports.removeWorkspaceUser = exports.inviteWorkspaceUser = exports.listWorkspaceUsers = exports.getTemplateFileContents = exports.getTemplateContents = exports.getTemplate = exports.listTemplates = exports.deleteApiKeyForServiceAccount = exports.createApiKeyForServiceAccount = exports.listApiKeysForServiceAccount = exports.updateWorkspaceServiceAccount = exports.deleteWorkspaceServiceAccount = exports.createWorkspaceServiceAccount = exports.getWorkspaceServiceAccounts = exports.stopSandbox = exports.startSandbox = exports.deleteSandboxPreviewToken = exports.createSandboxPreviewToken = exports.listSandboxPreviewTokens = exports.updateSandboxPreview = exports.getSandboxPreview = exports.deleteSandboxPreview = exports.createSandboxPreview = exports.listSandboxPreviews = exports.updateSandbox = exports.getSandbox = exports.deleteSandbox = exports.createSandbox = exports.listSandboxes = exports.listSandboxHubDefinitions = exports.listAllPendingInvitations = exports.updatePrivateClusterHealth = exports.getPrivateClusterHealth = exports.updatePrivateCluster = exports.getPrivateCluster = void 0;
 const client_gen_1 = require("./client.gen");
 /**
  * List all agents
@@ -390,6 +390,116 @@ const getIntegrationConnectionModel = (options) => {
     });
 };
 exports.getIntegrationConnectionModel = getIntegrationConnectionModel;
+/**
+ * List jobs
+ * Returns a list of all jobs in the workspace.
+ */
+const listJobs = (options) => {
+    return (options?.client ?? client_gen_1.client).get({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/jobs',
+        ...options
+    });
+};
+exports.listJobs = listJobs;
+/**
+ * Create job
+ * Creates a job.
+ */
+const createJob = (options) => {
+    return (options.client ?? client_gen_1.client).post({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/jobs',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options?.headers
+        }
+    });
+};
+exports.createJob = createJob;
+/**
+ * Delete job
+ * Deletes a job by name.
+ */
+const deleteJob = (options) => {
+    return (options.client ?? client_gen_1.client).delete({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/jobs/{jobId}',
+        ...options
+    });
+};
+exports.deleteJob = deleteJob;
+/**
+ * Get job
+ * Returns a job by name.
+ */
+const getJob = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/jobs/{jobId}',
+        ...options
+    });
+};
+exports.getJob = getJob;
+/**
+ * Create or update job
+ * Update a job by name.
+ */
+const updateJob = (options) => {
+    return (options.client ?? client_gen_1.client).put({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/jobs/{jobId}',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options?.headers
+        }
+    });
+};
+exports.updateJob = updateJob;
+/**
+ * List job revisions
+ * Returns revisions for a job by name.
+ */
+const listJobRevisions = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/jobs/{jobId}/revisions',
+        ...options
+    });
+};
+exports.listJobRevisions = listJobRevisions;
 /**
  * List knowledgebases
  * Returns a list of all knowledgebases in the workspace.

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

@@ -639,6 +639,22 @@ export type IntegrationRepository = {
      */
     url?: string;
 };
+/**
+ * Job
+ */
+export type Job = {
+    events?: CoreEvents;
+    metadata?: Metadata;
+    spec?: JobSpec;
+    /**
+     * Job status
+     */
+    status?: string;
+};
+/**
+ * Job specification
+ */
+export type JobSpec = CoreSpec & unknown;
 /**
  * Knowledgebase
  */
@@ -1624,6 +1640,10 @@ export type Runtime = {
      * The Docker image for the deployment
      */
     image?: string;
+    /**
+     * The maximum number of retries for the deployment
+     */
+    maxRetries?: number;
     /**
      * The minimum number of replicas for the deployment. Can be 0 or 1 (in which case the deployment is always running in at least one location).
      */
@@ -1744,6 +1764,10 @@ export type ServerlessConfig = {
     configuration?: {
         [key: string]: unknown;
     };
+    /**
+     * The maximum number of retries for the deployment
+     */
+    maxRetries?: number;
     /**
      * The minimum number of replicas for the deployment. Can be 0 or 1 (in which case the deployment is always running in at least one location).
      */
@@ -2525,6 +2549,104 @@ export type GetIntegrationConnectionModelResponses = {
      */
     200: unknown;
 };
+export type ListJobsData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/jobs';
+};
+export type ListJobsResponses = {
+    /**
+     * successful operation
+     */
+    200: Array<Job>;
+};
+export type ListJobsResponse = ListJobsResponses[keyof ListJobsResponses];
+export type CreateJobData = {
+    body: Job;
+    path?: never;
+    query?: never;
+    url: '/jobs';
+};
+export type CreateJobResponses = {
+    /**
+     * successful operation
+     */
+    200: Job;
+};
+export type CreateJobResponse = CreateJobResponses[keyof CreateJobResponses];
+export type DeleteJobData = {
+    body?: never;
+    path: {
+        /**
+         * Name of the job
+         */
+        jobId: string;
+    };
+    query?: never;
+    url: '/jobs/{jobId}';
+};
+export type DeleteJobResponses = {
+    /**
+     * successful operation
+     */
+    200: Job;
+};
+export type DeleteJobResponse = DeleteJobResponses[keyof DeleteJobResponses];
+export type GetJobData = {
+    body?: never;
+    path: {
+        /**
+         * Name of the job
+         */
+        jobId: string;
+    };
+    query?: never;
+    url: '/jobs/{jobId}';
+};
+export type GetJobResponses = {
+    /**
+     * successful operation
+     */
+    200: Model;
+};
+export type GetJobResponse = GetJobResponses[keyof GetJobResponses];
+export type UpdateJobData = {
+    body: Job;
+    path: {
+        /**
+         * Name of the job
+         */
+        jobId: string;
+    };
+    query?: never;
+    url: '/jobs/{jobId}';
+};
+export type UpdateJobResponses = {
+    /**
+     * successful operation
+     */
+    200: Job;
+};
+export type UpdateJobResponse = UpdateJobResponses[keyof UpdateJobResponses];
+export type ListJobRevisionsData = {
+    body?: never;
+    path: {
+        /**
+         * Name of the job
+         */
+        jobId: string;
+    };
+    query?: never;
+    url: '/jobs/{jobId}/revisions';
+};
+export type ListJobRevisionsResponses = {
+    /**
+     * successful operation
+     */
+    200: Array<RevisionMetadata>;
+};
+export type ListJobRevisionsResponse = ListJobRevisionsResponses[keyof ListJobRevisionsResponses];
 export type ListKnowledgebasesData = {
     body?: never;
     path?: never;

package/dist/common/internal.d.ts

@@ -1,2 +1,2 @@
-export declare function getAlphanumericLimitedHash(input: string, maxSize: number): string;
+export declare function getAlphanumericLimitedHash(input: string, maxSize?: number): string;
 export declare function getGlobalUniqueHash(workspace: string, type: string, name: string): string;

package/dist/common/internal.js

@@ -6,12 +6,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getAlphanumericLimitedHash = getAlphanumericLimitedHash;
 exports.getGlobalUniqueHash = getGlobalUniqueHash;
 const crypto_1 = __importDefault(require("crypto"));
-function getAlphanumericLimitedHash(input, maxSize) {
-    const hash = crypto_1.default.createHash("sha256").update(input).digest("base64");
-    const alphanumeric = hash.replace(/[^a-z0-9]+/g, "");
-    return alphanumeric.length > maxSize
-        ? alphanumeric.substring(0, maxSize)
-        : alphanumeric;
+function getAlphanumericLimitedHash(input, maxSize = 48) {
+    const hash = crypto_1.default.createHash('md5').update(input).digest('hex');
+    return hash.length > maxSize ? hash.substring(0, maxSize) : hash;
 }
 function getGlobalUniqueHash(workspace, type, name) {
     const globalUniqueName = `${workspace}-${type}-${name}`;

package/dist/common/settings.d.ts

@@ -21,6 +21,7 @@ declare class Settings {
     get runInternalHostname(): string;
     get runInternalProtocol(): string;
     get blCloud(): boolean;
+    get generation(): string;
     get loggerType(): string;
     authenticate(): Promise<void>;
 }

package/dist/common/settings.js

@@ -72,7 +72,10 @@ class Settings {
         return env_js_1.env.BL_TYPE || "agents";
     }
     get runInternalHostname() {
-        return env_js_1.env.BL_RUN_INTERNAL_HOSTNAME || "";
+        if (!this.generation) {
+            return "";
+        }
+        return env_js_1.env.BL_RUN_INTERNAL_HOST || "";
     }
     get runInternalProtocol() {
         return env_js_1.env.BL_RUN_INTERNAL_PROTOCOL || "https";
@@ -80,6 +83,9 @@ class Settings {
     get blCloud() {
         return env_js_1.env.BL_CLOUD === "true";
     }
+    get generation() {
+        return env_js_1.env.BL_GENERATION || "";
+    }
     get loggerType() {
         return env_js_1.env.BL_LOGGER || "http";
     }

package/dist/jobs/jobs.js

@@ -9,17 +9,17 @@ const helpers_1 = require("yargs/helpers");
 const env_js_1 = require("../common/env.js");
 class BlJob {
     async getArguments() {
-        if (!env_js_1.env.BL_BATCH_DATA_URL) {
+        if (!env_js_1.env.BL_EXECUTION_DATA_URL) {
             const argv = await (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
                 .parseAsync();
             return argv;
         }
-        const response = await fetch(env_js_1.env.BL_BATCH_DATA_URL);
+        const response = await fetch(env_js_1.env.BL_EXECUTION_DATA_URL);
         const data = await response.json();
         return data.tasks[this.index] ?? {};
     }
     get indexKey() {
-        return env_js_1.env.BL_BATCH_INDEX_KEY ?? "TASK_INDEX";
+        return env_js_1.env.BL_EXECUTION_INDEX_KEY ?? "TASK_INDEX";
     }
     get index() {
         return env_js_1.env[this.indexKey] ? Number(env_js_1.env[this.indexKey]) ?? 0 : 0;

package/dist/mcp/client.js

@@ -63,16 +63,13 @@ class BlaxelMcpClientTransport {
                 this.onerror?.(error);
             };
             this._socket.onopen = () => {
-                logger_js_1.logger.debug("WebSocket opened");
                 resolve();
             };
             this._socket.onclose = () => {
-                logger_js_1.logger.debug("WebSocket closed");
                 this.onclose?.();
                 this._socket = undefined;
             };
             this._socket.onmessage = (event) => {
-                logger_js_1.logger.debug("WebSocket message received");
                 let message;
                 try {
                     let dataString;

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
@@ -22,7 +22,7 @@ export declare const deleteFilesystemByPath: <ThrowOnError extends boolean = fal
  * Get file or directory information
  * Get content of a file or listing of a directory
  */
-export declare const getFilesystemByPath: <ThrowOnError extends boolean = false>(options: Options<GetFilesystemByPathData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").Directory | import("./types.gen").FileWithContent, import("./types.gen").ErrorResponse, ThrowOnError>;
+export declare const getFilesystemByPath: <ThrowOnError extends boolean = false>(options: Options<GetFilesystemByPathData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").FileWithContent | import("./types.gen").Directory, import("./types.gen").ErrorResponse, ThrowOnError>;
 /**
  * Create or update file or directory
  * Create or update a file or directory
@@ -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

@@ -1,11 +1,3 @@
-export type Directory = {
-    files?: Array<File>;
-    path?: string;
-    /**
-     * @name Subdirectories
-     */
-    subdirectories?: Array<Subdirectory>;
-};
 export type ErrorResponse = {
     error?: string;
 };
@@ -14,6 +6,9 @@ export type File = {
     lastModified?: string;
     owner?: string;
     path?: string;
+    /**
+     * swagger:strfmt string
+     */
     permissions?: string;
     size?: number;
 };
@@ -28,6 +23,9 @@ export type FileWithContent = {
     lastModified?: string;
     owner?: string;
     path?: string;
+    /**
+     * swagger:strfmt string
+     */
     permissions?: string;
     size?: number;
 };
@@ -43,7 +41,6 @@ export type ProcessKillRequest = {
 export type ProcessRequest = {
     command: string;
     name?: string;
-    streamLogs?: boolean;
     timeout?: number;
     waitForCompletion?: boolean;
     waitForPorts?: Array<number>;
@@ -59,13 +56,18 @@ export type ProcessResponse = {
     status?: string;
     workingDir?: string;
 };
-export type Subdirectory = {
-    path?: string;
-};
 export type SuccessResponse = {
     message?: string;
     path?: string;
 };
+export type Directory = {
+    files?: Array<File>;
+    path?: string;
+    /**
+     * @name Subdirectories
+     */
+    subdirectories?: Array<Directory>;
+};
 export type DeleteFilesystemByPathData = {
     body?: never;
     path: {
@@ -391,12 +393,7 @@ export type GetProcessByIdentifierLogsData = {
          */
         identifier: string;
     };
-    query?: {
-        /**
-         * Stream logs
-         */
-        stream?: boolean;
-    };
+    query?: never;
     url: '/process/{identifier}/logs';
 };
 export type GetProcessByIdentifierLogsErrors = {
@@ -427,12 +424,7 @@ export type GetProcessByIdentifierLogsStreamData = {
          */
         identifier: string;
     };
-    query?: {
-        /**
-         * Stream logs
-         */
-        stream?: boolean;
-    };
+    query?: never;
     url: '/process/{identifier}/logs/stream';
 };
 export type GetProcessByIdentifierLogsStreamErrors = {
@@ -448,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-dev1",
+  "version": "0.2.1-dev11",
   "description": "Blaxel Core SDK for TypeScript",
   "license": "MIT",
   "author": "Blaxel, INC (https://blaxel.ai)",