Added a function to get the maxOldSpaceSize

Author: matt-aitken

packages/core/package.json

@@ -59,7 +59,8 @@
       "./v3/workers": "./src/v3/workers/index.ts",
       "./v3/schemas": "./src/v3/schemas/index.ts",
       "./v3/runEngineWorker": "./src/v3/runEngineWorker/index.ts",
-      "./v3/checkpoints": "./src/v3/checkpoints/index.ts"
+      "./v3/checkpoints": "./src/v3/checkpoints/index.ts",
+      "./v3/machines": "./src/v3/machines/index.ts"
     },
     "sourceDialects": [
       "@triggerdotdev/source"
@@ -180,6 +181,9 @@
       ],
       "v3/checkpoints": [
         "dist/commonjs/v3/checkpoints/index.d.ts"
+      ],
+      "v3/machines": [
+        "dist/commonjs/v3/machines/index.d.ts"
       ]
     }
   },
@@ -673,6 +677,17 @@
         "types": "./dist/commonjs/v3/checkpoints/index.d.ts",
         "default": "./dist/commonjs/v3/checkpoints/index.js"
       }
+    },
+    "./v3/machines": {
+      "import": {
+        "@triggerdotdev/source": "./src/v3/machines/index.ts",
+        "types": "./dist/esm/v3/machines/index.d.ts",
+        "default": "./dist/esm/v3/machines/index.js"
+      },
+      "require": {
+        "types": "./dist/commonjs/v3/machines/index.d.ts",
+        "default": "./dist/commonjs/v3/machines/index.js"
+      }
     }
   },
   "type": "module",

packages/core/src/v3/machines/index.ts

@@ -0,0 +1,13 @@
+import { MachinePreset } from "../schemas/common.js";
+
+/**
+ * Returns a value to be used for `--max-old-space-size`. It is in MiB.
+ * Setting this correctly means V8 spends more times running Garbage Collection (GC).
+ * It won't eliminate crashes but it will help avoid them.
+ * @param {MachinePreset} machine - The machine preset configuration containing memory specifications
+ * @param {number} [overhead=0.2] - The memory overhead factor (0.2 = 20% reserved for system operations)
+ * @returns {number} The calculated max old space size in MiB
+ */
+export function maxOldSpaceSizeForMachine(machine: MachinePreset, overhead = 0.2) {
+  return machine.memory * 1_024 * (1 - overhead);
+}