@blaxel/core 0.2.18-preview.39 → 0.2.19-dev.158

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

@@ -733,7 +733,9 @@ export type JobMetrics = {
 /**
  * Job specification
  */
-export type JobSpec = CoreSpec & unknown;
+export type JobSpec = CoreSpec & {
+    triggers?: Triggers;
+};
 /**
  * Jobs chart
  */
@@ -2439,12 +2441,7 @@ export type TraceIdsResponse = {
  * Trigger configuration
  */
 export type Trigger = {
-    /**
-     * The configuration of the trigger
-     */
-    configuration?: {
-        [key: string]: unknown;
-    };
+    configuration?: TriggerConfiguration;
     /**
      * The id of the trigger
      */
@@ -2454,6 +2451,27 @@ export type Trigger = {
      */
     type?: string;
 };
+/**
+ * Trigger configuration
+ */
+export type TriggerConfiguration = {
+    /**
+     * The authentication type of the trigger
+     */
+    authenticationType?: string;
+    /**
+     * The path of the trigger
+     */
+    path?: string;
+    /**
+     * The retry of the trigger
+     */
+    retry?: number;
+    /**
+     * The schedule of the trigger, cron expression * * * * *
+     */
+    schedule?: string;
+};
 /**
  * Triggers to use your agent
  */

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

@@ -1,23 +1,23 @@
 export type Directory = {
-    files?: Array<File>;
-    name?: string;
-    path?: string;
+    files: Array<File>;
+    name: string;
+    path: string;
     /**
      * @name Subdirectories
      */
-    subdirectories?: Array<Subdirectory>;
+    subdirectories: Array<Subdirectory>;
 };
 export type ErrorResponse = {
-    error?: string;
+    error: string;
 };
 export type File = {
-    group?: string;
-    lastModified?: string;
-    name?: string;
-    owner?: string;
-    path?: string;
-    permissions?: string;
-    size?: number;
+    group: string;
+    lastModified: string;
+    name: string;
+    owner: string;
+    path: string;
+    permissions: string;
+    size: number;
 };
 export type FileRequest = {
     content?: string;
@@ -25,14 +25,14 @@ export type FileRequest = {
     permissions?: string;
 };
 export type FileWithContent = {
-    content?: string;
-    group?: string;
-    lastModified?: string;
-    name?: string;
-    owner?: string;
-    path?: string;
-    permissions?: string;
-    size?: number;
+    content: string;
+    group: string;
+    lastModified: string;
+    name: string;
+    owner: string;
+    path: string;
+    permissions: string;
+    size: number;
 };
 export type PortMonitorRequest = {
     /**
@@ -41,9 +41,9 @@ export type PortMonitorRequest = {
     callback?: string;
 };
 export type ProcessLogs = {
-    logs?: string;
-    stderr?: string;
-    stdout?: string;
+    logs: string;
+    stderr: string;
+    stdout: string;
 };
 export type ProcessRequest = {
     command: string;
@@ -57,22 +57,23 @@ export type ProcessRequest = {
     workingDir?: string;
 };
 export type ProcessResponse = {
-    command?: string;
-    completedAt?: string;
-    exitCode?: number;
-    name?: string;
-    pid?: string;
-    startedAt?: string;
-    status?: 'failed' | 'killed' | 'stopped' | 'running' | 'completed';
-    workingDir?: string;
+    command: string;
+    completedAt: string;
+    exitCode: number;
+    logs: string;
+    name: string;
+    pid: string;
+    startedAt: string;
+    status: 'failed' | 'killed' | 'stopped' | 'running' | 'completed';
+    workingDir: string;
 };
 export type Subdirectory = {
-    name?: string;
-    path?: string;
+    name: string;
+    path: string;
 };
 export type SuccessResponse = {
-    message?: string;
-    path?: string;
+    message: string;
+    path: string;
 };
 export type DeleteFilesystemByPathData = {
     body?: never;

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

@@ -1,4 +1,3 @@
 "use strict";
-/* eslint-disable */
 // This file is auto-generated by @hey-api/openapi-ts
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/sandbox/index.d.ts

@@ -1,3 +1,4 @@
-export { deleteFilesystemByPath, deleteNetworkProcessByPidMonitor, deleteProcessByIdentifier, deleteProcessByIdentifierKill, Directory, ErrorResponse, File, FileRequest, FileWithContent, getFilesystemByPath, getNetworkProcessByPidPorts, getProcess, getProcessByIdentifier, getProcessByIdentifierLogs, getProcessByIdentifierLogsStream, PortMonitorRequest, postNetworkProcessByPidMonitor, postProcess, ProcessRequest, ProcessResponse, putFilesystemByPath, SuccessResponse } from "./client/index.js";
+export { Directory, ErrorResponse, File, FileRequest, FileWithContent, PortMonitorRequest, ProcessRequest, ProcessResponse, SuccessResponse, deleteFilesystemByPath, deleteNetworkProcessByPidMonitor, deleteProcessByIdentifier, deleteProcessByIdentifierKill, getFilesystemByPath, getNetworkProcessByPidPorts, getProcess, getProcessByIdentifier, getProcessByIdentifierLogs, getProcessByIdentifierLogsStream, postNetworkProcessByPidMonitor, postProcess, putFilesystemByPath } from "./client/index.js";
 export * from "./filesystem/index.js";
 export * from "./sandbox.js";
+export * from "./types.js";

package/dist/sandbox/index.js

@@ -32,4 +32,5 @@ Object.defineProperty(exports, "postProcess", { enumerable: true, get: function
 Object.defineProperty(exports, "putFilesystemByPath", { enumerable: true, get: function () { return index_js_1.putFilesystemByPath; } });
 __exportStar(require("./filesystem/index.js"), exports);
 __exportStar(require("./sandbox.js"), exports);
+__exportStar(require("./types.js"), exports);
 // Re-export everything from client except ClientOptions to avoid conflict

package/dist/sandbox/process/process.d.ts

@@ -10,7 +10,7 @@ export declare class SandboxProcess extends SandboxAction {
     }): {
         close: () => void;
     };
-    exec(process: ProcessRequest): Promise<PostProcessResponse>;
+    exec(process: ProcessRequest, onLog?: (log: string) => void): Promise<PostProcessResponse>;
     wait(identifier: string, { maxWait, interval }?: {
         maxWait?: number;
         interval?: number;

package/dist/sandbox/process/process.js

@@ -61,14 +61,44 @@ class SandboxProcess extends action_js_1.SandboxAction {
             close: () => controller.abort(),
         };
     }
-    async exec(process) {
+    async exec(process, onLog) {
+        // Store original wait_for_completion setting
+        const shouldWaitForCompletion = process.waitForCompletion;
+        // Always start process without wait_for_completion to avoid server-side blocking
+        if (shouldWaitForCompletion && onLog) {
+            process.waitForCompletion = false;
+        }
         const { response, data, error } = await (0, index_js_1.postProcess)({
             body: process,
             baseUrl: this.url,
             client: this.client,
         });
         this.handleResponseError(response, data, error);
-        return data;
+        let result = data;
+        // Handle wait_for_completion with parallel log streaming
+        if (shouldWaitForCompletion) {
+            let streamControl;
+            if (onLog) {
+                streamControl = this.streamLogs(result.pid, { onLog });
+            }
+            try {
+                // Wait for process completion
+                result = await this.wait(result.pid, { interval: 50 });
+            }
+            finally {
+                // Clean up log streaming
+                if (streamControl) {
+                    streamControl.close();
+                }
+            }
+        }
+        else {
+            // For non-blocking execution, set up log streaming immediately if requested
+            if (onLog) {
+                this.streamLogs(result.pid, { onLog });
+            }
+        }
+        return result;
     }
     async wait(identifier, { maxWait = 60000, interval = 1000 } = {}) {
         const startTime = Date.now();

package/dist/sandbox/sandbox.d.ts

@@ -4,7 +4,7 @@ import { SandboxNetwork } from "./network/index.js";
 import { SandboxPreviews } from "./preview.js";
 import { SandboxProcess } from "./process/index.js";
 import { SandboxSessions } from "./session.js";
-import { SandboxConfiguration, SessionWithToken } from "./types.js";
+import { SandboxConfiguration, SandboxCreateConfiguration, SessionWithToken } from "./types.js";
 export declare class SandboxInstance {
     private sandbox;
     fs: SandboxFileSystem;
@@ -21,10 +21,10 @@ export declare class SandboxInstance {
         maxWait?: number;
         interval?: number;
     }): Promise<void>;
-    static create(sandbox: SandboxModel): Promise<SandboxInstance>;
+    static create(sandbox?: SandboxModel | SandboxCreateConfiguration): Promise<SandboxInstance>;
     static get(sandboxName: string): Promise<SandboxInstance>;
     static list(): Promise<SandboxInstance[]>;
     static delete(sandboxName: string): Promise<SandboxModel>;
-    static createIfNotExists(sandbox: SandboxModel): Promise<SandboxInstance>;
+    static createIfNotExists(sandbox: SandboxModel | SandboxCreateConfiguration): Promise<SandboxInstance>;
     static fromSession(session: SessionWithToken): Promise<SandboxInstance>;
 }

package/dist/sandbox/sandbox.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SandboxInstance = void 0;
+const uuid_1 = require("uuid");
 const index_js_1 = require("../client/index.js");
 const logger_js_1 = require("../common/logger.js");
 const index_js_2 = require("./filesystem/index.js");
@@ -8,6 +9,7 @@ const index_js_3 = require("./network/index.js");
 const preview_js_1 = require("./preview.js");
 const index_js_4 = require("./process/index.js");
 const session_js_1 = require("./session.js");
+const types_js_1 = require("./types.js");
 class SandboxInstance {
     sandbox;
     fs;
@@ -61,11 +63,45 @@ class SandboxInstance {
         }
     }
     static async create(sandbox) {
-        if (sandbox.spec?.runtime?.generation == undefined) {
-            sandbox.spec = sandbox.spec ?? { runtime: {} };
-            sandbox.spec.runtime = sandbox.spec.runtime ?? {};
-            sandbox.spec.runtime.generation = "mk3";
+        const defaultName = `sandbox-${(0, uuid_1.v4)().replace(/-/g, '').substring(0, 8)}`;
+        const defaultImage = "blaxel/prod-base:latest";
+        const defaultMemory = 4096;
+        // Handle SandboxCreateConfiguration or simple dict with name/image/memory/ports keys
+        if (!sandbox || 'name' in sandbox || 'image' in sandbox || 'memory' in sandbox || 'ports' in sandbox) {
+            if (!sandbox)
+                sandbox = {};
+            if (!sandbox.name)
+                sandbox.name = defaultName;
+            if (!sandbox.image)
+                sandbox.image = defaultImage;
+            if (!sandbox.memory)
+                sandbox.memory = defaultMemory;
+            const ports = (0, types_js_1.normalizePorts)(sandbox.ports);
+            sandbox = {
+                metadata: { name: sandbox.name },
+                spec: {
+                    runtime: {
+                        image: sandbox.image,
+                        memory: sandbox.memory,
+                        ports: ports,
+                        generation: "mk3"
+                    }
+                }
+            };
         }
+        sandbox = sandbox;
+        if (!sandbox.metadata) {
+            sandbox.metadata = { name: crypto.randomUUID().replace(/-/g, '') };
+        }
+        if (!sandbox.spec) {
+            sandbox.spec = { runtime: { image: "blaxel/prod-base:latest" } };
+        }
+        if (!sandbox.spec.runtime) {
+            sandbox.spec.runtime = { image: defaultImage, memory: defaultMemory };
+        }
+        sandbox.spec.runtime.image = sandbox.spec.runtime.image || defaultImage;
+        sandbox.spec.runtime.memory = sandbox.spec.runtime.memory || defaultMemory;
+        sandbox.spec.runtime.generation = sandbox.spec.runtime.generation || "mk3";
         const { data } = await (0, index_js_1.createSandbox)({
             body: sandbox,
             throwOnError: true,
@@ -96,7 +132,11 @@ class SandboxInstance {
     }
     static async createIfNotExists(sandbox) {
         try {
-            const sandboxInstance = await SandboxInstance.get(sandbox.metadata?.name ?? "");
+            const name = 'name' in sandbox ? sandbox.name : sandbox.metadata?.name;
+            if (!name) {
+                throw new Error("Sandbox name is required");
+            }
+            const sandboxInstance = await SandboxInstance.get(name);
             return sandboxInstance;
         }
         catch (e) {
@@ -108,7 +148,16 @@ class SandboxInstance {
     }
     /* eslint-disable */
     static async fromSession(session) {
-        return new SandboxInstance({ forceUrl: session.url, params: { bl_preview_token: session.token }, headers: { "X-Blaxel-Preview-Token": session.token } });
+        // Create a minimal sandbox configuration for session-based access
+        const sandboxName = session.name.includes("-") ? session.name.split("-")[0] : session.name;
+        const sandbox = {
+            metadata: { name: sandboxName },
+            forceUrl: session.url,
+            headers: { "X-Blaxel-Preview-Token": session.token },
+            params: { bl_preview_token: session.token }
+        };
+        // Create instance using constructor instead of direct property assignment
+        return new SandboxInstance(sandbox);
     }
 }
 exports.SandboxInstance = SandboxInstance;

package/dist/sandbox/types.d.ts

@@ -1,4 +1,4 @@
-import { Sandbox } from "../client/types.gen";
+import { Port, Sandbox } from "../client/types.gen";
 export interface SessionCreateOptions {
     expiresAt?: Date;
     responseHeaders?: Record<string, string>;
@@ -15,3 +15,10 @@ export type SandboxConfiguration = {
     headers?: Record<string, string>;
     params?: Record<string, string>;
 } & Sandbox;
+export type SandboxCreateConfiguration = {
+    name?: string;
+    image?: string;
+    memory?: number;
+    ports?: (Port | Record<string, any>)[];
+};
+export declare function normalizePorts(ports?: (Port | Record<string, any>)[]): Port[] | undefined;

package/dist/sandbox/types.js

@@ -1,2 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizePorts = normalizePorts;
+function normalizePorts(ports) {
+    if (!ports || ports.length === 0) {
+        return undefined;
+    }
+    const portObjects = [];
+    for (const port of ports) {
+        if (typeof port === 'object' && port !== null) {
+            if ('name' in port || 'target' in port || 'protocol' in port) {
+                // It's a Port-like object, ensure protocol defaults to HTTP
+                const normalizedPort = {
+                    name: typeof port.name === 'string' ? port.name : undefined,
+                    target: typeof port.target === 'number' ? port.target : undefined,
+                    protocol: typeof port.protocol === 'string' ? port.protocol : "HTTP"
+                };
+                portObjects.push(normalizedPort);
+            }
+            else {
+                throw new Error(`Invalid port type: ${typeof port}. Expected Port object or object with port properties.`);
+            }
+        }
+        else {
+            throw new Error(`Invalid port type: ${typeof port}. Expected Port object or object with port properties.`);
+        }
+    }
+    return portObjects;
+}

package/dist/telemetry/telemetry.d.ts

@@ -20,7 +20,7 @@ export interface BlaxelSpan {
     /** Record an error on the span */
     recordException(error: Error): void;
     /** Set the status of the span */
-    setStatus(status: 'ok' | 'error', message?: string): void;
+    setStatus(status: "ok" | "error", message?: string): void;
     /** End the span */
     end(): void;
     /** Get the span context (for passing to child spans) */
@@ -34,22 +34,15 @@ export interface BlaxelTelemetryProvider {
     startSpan(name: string, options?: BlaxelSpanOptions): BlaxelSpan;
     /** Flush the telemetry provider */
     flush(): Promise<void>;
+    /** Extract context from headers for manual context propagation */
+    extractContextFromHeaders?(headers: Record<string, string | string[]>): unknown;
 }
 /**
- * Registry for managing the global telemetry provider
+ * Registry for telemetry providers
  */
 declare class TelemetryRegistry {
-    private static instance;
     private provider;
-    private constructor();
-    static getInstance(): TelemetryRegistry;
-    /**
-     * Register a telemetry provider implementation
-     */
     registerProvider(provider: BlaxelTelemetryProvider): void;
-    /**
-     * Get the current telemetry provider
-     */
     getProvider(): BlaxelTelemetryProvider;
 }
 export declare const telemetryRegistry: TelemetryRegistry;
@@ -58,5 +51,18 @@ export declare const telemetryRegistry: TelemetryRegistry;
  */
 export declare function startSpan(name: string, options?: BlaxelSpanOptions): BlaxelSpan;
 export declare function withSpan<T>(name: string, fn: () => Promise<T>, options?: BlaxelSpanOptions): Promise<T>;
+/**
+ * Extract context from headers - useful for manual context propagation
+ * when you have traceparent headers but no active span
+ */
+export declare function extractContextFromHeaders(headers: Record<string, string | string[]>): unknown;
+/**
+ * Create a span with extracted context from headers
+ * This is useful when you need to manually establish trace context
+ */
+export declare function startSpanWithHeaders(name: string, headers: Record<string, string | string[]>, options?: Omit<BlaxelSpanOptions, "parentContext">): BlaxelSpan;
+/**
+ * Flush the telemetry provider
+ */
 export declare function flush(): Promise<void>;
 export {};

package/dist/telemetry/telemetry.js

@@ -4,6 +4,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.telemetryRegistry = void 0;
 exports.startSpan = startSpan;
 exports.withSpan = withSpan;
+exports.extractContextFromHeaders = extractContextFromHeaders;
+exports.startSpanWithHeaders = startSpanWithHeaders;
 exports.flush = flush;
 /**
  * No-operation implementation of Span
@@ -14,7 +16,9 @@ class NoopSpan {
     recordException() { }
     setStatus() { }
     end() { }
-    getContext() { return null; }
+    getContext() {
+        return null;
+    }
 }
 /**
  * No-operation implementation of TelemetryProvider
@@ -23,38 +27,25 @@ class NoopTelemetryProvider {
     startSpan() {
         return new NoopSpan();
     }
-    flush() {
-        return Promise.resolve();
+    async flush() { }
+    extractContextFromHeaders() {
+        return null;
     }
 }
 /**
- * Registry for managing the global telemetry provider
+ * Registry for telemetry providers
  */
 class TelemetryRegistry {
-    static instance;
     provider = new NoopTelemetryProvider();
-    constructor() { }
-    static getInstance() {
-        if (!TelemetryRegistry.instance) {
-            TelemetryRegistry.instance = new TelemetryRegistry();
-        }
-        return TelemetryRegistry.instance;
-    }
-    /**
-     * Register a telemetry provider implementation
-     */
     registerProvider(provider) {
         this.provider = provider;
     }
-    /**
-     * Get the current telemetry provider
-     */
     getProvider() {
         return this.provider;
     }
 }
-// Export singleton instance
-exports.telemetryRegistry = TelemetryRegistry.getInstance();
+// Global instance
+exports.telemetryRegistry = new TelemetryRegistry();
 // Convenience functions that delegate to the provider
 /**
  * Create a span with the registered provider
@@ -75,6 +66,31 @@ async function withSpan(name, fn, options) {
         throw error;
     }
 }
+/**
+ * Extract context from headers - useful for manual context propagation
+ * when you have traceparent headers but no active span
+ */
+function extractContextFromHeaders(headers) {
+    const provider = exports.telemetryRegistry.getProvider();
+    if (provider.extractContextFromHeaders) {
+        return provider.extractContextFromHeaders(headers);
+    }
+    return null;
+}
+/**
+ * Create a span with extracted context from headers
+ * This is useful when you need to manually establish trace context
+ */
+function startSpanWithHeaders(name, headers, options) {
+    const extractedContext = extractContextFromHeaders(headers);
+    return startSpan(name, {
+        ...options,
+        parentContext: extractedContext || undefined,
+    });
+}
+/**
+ * Flush the telemetry provider
+ */
 async function flush() {
-    await exports.telemetryRegistry.getProvider().flush();
+    return exports.telemetryRegistry.getProvider().flush();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blaxel/core",
-  "version": "0.2.18-preview.39",
+  "version": "0.2.19-dev.158",
   "description": "Blaxel Core SDK for TypeScript",
   "license": "MIT",
   "author": "Blaxel, INC (https://blaxel.ai)",