smolmachines 1.29.0 → 1.31.0

package/dist/binding.d.ts

@@ -427,6 +427,11 @@ export declare class NapiMachine {
   forkBatch(names: Array<string>, ports?: Array<PortMappingConfig> | undefined | null, parallel?: number | undefined | null, freezeSource?: boolean | undefined | null): Promise<Array<NapiMachine>>
   /** Execute a command directly in the VM (not in a container). */
   exec(command: Array<string>, options?: ExecOptions | undefined | null): Promise<ExecResult>
+  /**
+   * Start a command without waiting for it and return its guest pid. It
+   * keeps running after this returns; it takes no stdin and no timeout.
+   */
+  execBackground(command: Array<string>, options?: ExecOptions | undefined | null): Promise<number>
   /**
    * Pull an OCI image and run a command inside it.
    *

package/dist/native.d.ts

@@ -145,6 +145,7 @@ export interface NapiMachine {
     fork(name: string, ports?: NativePortMapping[], checkpointable?: boolean, freezeSource?: boolean): Promise<NapiMachine>;
     forkBatch(names: string[], ports?: NativePortMapping[], parallel?: number, freezeSource?: boolean): Promise<NapiMachine[]>;
     exec(command: string[], options?: NativeExecOptions): Promise<NativeExecResult>;
+    execBackground(command: string[], options?: NativeExecOptions): Promise<number>;
     run(image: string, command: string[], options?: NativeExecOptions): Promise<NativeExecResult>;
     pullImage(image: string): Promise<NativeImageInfo>;
     listImages(): Promise<NativeImageInfo[]>;

package/dist/transport.js

@@ -425,6 +425,8 @@ class LocalTransport {
         return null;
     }
     async exec(command, opts) {
+        if (opts?.background)
+            return this.execBackground(command, opts);
         if (opts?.signal)
             return collectExec(this.execStream(command, opts), opts.signal);
         try {
@@ -434,6 +436,21 @@ class LocalTransport {
             throw (0, errors_1.wrapNativeError)(e);
         }
     }
+    /** Start a command and return at once, as the cloud does: its pid in `pid`
+     *  and as `pid=<n>` on stdout. */
+    async execBackground(command, opts) {
+        if (opts.signal) {
+            throw new errors_1.InvalidConfigError("a background command cannot be cancelled; kill its pid instead");
+        }
+        let pid;
+        try {
+            pid = await this.inner.execBackground(command, toNativeExecOptions(opts));
+        }
+        catch (e) {
+            throw (0, errors_1.wrapNativeError)(e);
+        }
+        return { pid, exitCode: 0, stdout: `pid=${pid}\n`, stderr: "" };
+    }
     async run(image, command, opts) {
         if (opts?.signal) {
             throw new errors_1.NotSupportedError("signal is not supported by run(); use exec on an image machine.");

package/dist/types.d.ts

@@ -395,8 +395,9 @@ export interface ExecOptions {
      *  Ignored (both families, as before) on older control planes and on the
      *  local target. */
     output?: "text" | "b64" | "both";
-    /** Cloud only: start the command detached and return at once with its
-     *  `pid`, leaving it running (a dev server, an agent) after the call ends. */
+    /** Start the command detached and return at once with its `pid`, leaving
+     *  it running (a dev server, an agent) after the call ends. It takes no
+     *  stdin and no timeout. */
     background?: boolean;
 }
 /** Result of a command execution. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smolmachines",
-  "version": "1.29.0",
+  "version": "1.31.0",
   "description": "Embed isolated microVM sandboxes directly in your code — no server to run.",
   "license": "Apache-2.0",
   "author": "smol-machines",
@@ -65,8 +65,8 @@
     "typescript": "^5.6.0"
   },
   "optionalDependencies": {
-    "smolmachines-darwin-arm64": "1.29.0",
-    "smolmachines-linux-x64-gnu": "1.29.0",
-    "smolmachines-linux-arm64-gnu": "1.29.0"
+    "smolmachines-darwin-arm64": "1.31.0",
+    "smolmachines-linux-x64-gnu": "1.31.0",
+    "smolmachines-linux-arm64-gnu": "1.31.0"
   }
 }