@mastra/blaxel 0.1.1 → 0.2.0-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @mastra/blaxel
 
+## 0.2.0-alpha.0
+
+### Minor Changes
+
+- Added provider-specific `blaxel` getter to access the underlying Blaxel `SandboxInstance` directly. Deprecated the generic `instance` getter in favor of the new `blaxel` getter for better IDE discoverability and consistency with other sandbox providers. ([#14166](https://github.com/mastra-ai/mastra/pull/14166))
+
+  ```typescript
+  // Before
+  const blaxelSandbox = sandbox.instance;
+
+  // After
+  const blaxelSandbox = sandbox.blaxel;
+  ```
+
+### Patch Changes
+
+- Use provider-native string process IDs directly as `ProcessHandle.pid`, removing the previous `parseInt()` workaround. ([#13591](https://github.com/mastra-ai/mastra/pull/13591))
+
+  ```typescript
+  const handle = await sandbox.processes.spawn('node server.js');
+  handle.pid; // string — the Blaxel SDK's native process ID
+  ```
+
+- dependencies updates: ([#13591](https://github.com/mastra-ai/mastra/pull/13591))
+  - Updated peerDependency `@mastra/core` to `>=1.12.0-0 <2.0.0-0`
+- Updated dependencies [[`9cede11`](https://github.com/mastra-ai/mastra/commit/9cede110abac9d93072e0521bb3c8bcafb9fdadf), [`a59f126`](https://github.com/mastra-ai/mastra/commit/a59f1269104f54726699c5cdb98c72c93606d2df), [`c510833`](https://github.com/mastra-ai/mastra/commit/c5108333e8cbc19dafee5f8bfefbcb5ee935335c), [`7296fcc`](https://github.com/mastra-ai/mastra/commit/7296fcc599c876a68699a71c7054a16d5aaf2337), [`00c27f9`](https://github.com/mastra-ai/mastra/commit/00c27f9080731433230a61be69c44e39a7a7b4c7), [`ee19c9b`](https://github.com/mastra-ai/mastra/commit/ee19c9ba3ec3ed91feb214ad539bdc766c53bb01)]:
+  - @mastra/core@1.12.0-alpha.1
+
 ## 0.1.1
 
 ### Patch Changes

package/dist/index.cjs

@@ -261,7 +261,6 @@ ${installResult.stderr}`
 }
 var BlaxelProcessHandle = class extends workspace.ProcessHandle {
   pid;
-  _identifier;
   _sandbox;
   _startTime;
   _exitCode;
@@ -269,10 +268,9 @@ var BlaxelProcessHandle = class extends workspace.ProcessHandle {
   _streamingDone = null;
   _closeStream = null;
   _killed = false;
-  constructor(pid, identifier, sandbox, startTime, options) {
+  constructor(pid, sandbox, startTime, options) {
     super(options);
     this.pid = pid;
-    this._identifier = identifier;
     this._sandbox = sandbox;
     this._startTime = startTime;
   }
@@ -289,7 +287,7 @@ var BlaxelProcessHandle = class extends workspace.ProcessHandle {
   async _resolveExitCode() {
     if (this._exitCode !== void 0) return;
     try {
-      const proc = await this._sandbox.process.get(this._identifier);
+      const proc = await this._sandbox.process.get(this.pid);
       this._exitCode = proc.status === "completed" ? proc.exitCode ?? 0 : proc.exitCode ?? 1;
     } catch {
       if (this._exitCode === void 0) {
@@ -332,7 +330,7 @@ var BlaxelProcessHandle = class extends workspace.ProcessHandle {
     this._exitCode = 137;
     this._closeStream?.();
     try {
-      await this._sandbox.process.kill(this._identifier);
+      await this._sandbox.process.kill(this.pid);
     } catch {
     }
     return true;
@@ -347,7 +345,7 @@ var BlaxelProcessManager = class extends workspace.SandboxProcessManager {
   }
   async spawn(command, options = {}) {
     return this.sandbox.retryOnDead(async () => {
-      const blaxel = this.sandbox.instance;
+      const blaxel = this.sandbox.blaxel;
       const mergedEnv = { ...this.env, ...options.env };
       const envs = Object.fromEntries(
         Object.entries(mergedEnv).filter((entry) => entry[1] !== void 0)
@@ -359,10 +357,9 @@ var BlaxelProcessManager = class extends workspace.SandboxProcessManager {
         ...Object.keys(envs).length > 0 && { env: envs },
         ...options.timeout && { timeout: Math.ceil(options.timeout / 1e3) }
       });
-      const identifier = result.pid;
-      const pid = parseInt(identifier, 10);
-      const handle = new BlaxelProcessHandle(pid, identifier, blaxel, Date.now(), options);
-      const streamControl = blaxel.process.streamLogs(identifier, {
+      const pid = result.pid;
+      const handle = new BlaxelProcessHandle(pid, blaxel, Date.now(), options);
+      const streamControl = blaxel.process.streamLogs(pid, {
         onStdout: (data) => handle.emitStdout(data),
         onStderr: (data) => handle.emitStderr(data),
         onError: (err) => {
@@ -387,9 +384,6 @@ var BlaxelProcessManager = class extends workspace.SandboxProcessManager {
     }
     return result;
   }
-  async get(pid) {
-    return this._tracked.get(pid);
-  }
 };
 
 // src/sandbox/index.ts
@@ -465,7 +459,8 @@ var BlaxelSandbox = class extends workspace.MastraSandbox {
    *
    * @example Direct file operations
    * ```typescript
-   * const blaxelSandbox = sandbox.instance;
+   * await sandbox.start();
+   * const blaxelSandbox = sandbox.blaxel;
    * await blaxelSandbox.fs.write('/tmp/test.txt', 'Hello');
    * const content = await blaxelSandbox.fs.read('/tmp/test.txt');
    * const files = await blaxelSandbox.fs.ls('/tmp');
@@ -473,19 +468,24 @@ var BlaxelSandbox = class extends workspace.MastraSandbox {
    *
    * @example Process management
    * ```typescript
-   * const blaxelSandbox = sandbox.instance;
+   * await sandbox.start();
+   * const blaxelSandbox = sandbox.blaxel;
    * const proc = await blaxelSandbox.process.exec({
    *   command: 'node server.js',
    *   waitForCompletion: false,
    * });
    * ```
    */
-  get instance() {
+  get blaxel() {
     if (!this._sandbox) {
       throw new workspace.SandboxNotReadyError(this.id);
     }
     return this._sandbox;
   }
+  /** @deprecated Use `blaxel` instead. */
+  get instance() {
+    return this.blaxel;
+  }
   // ---------------------------------------------------------------------------
   // Mount Support
   // ---------------------------------------------------------------------------