@intelligems/sst 2.49.6-ig.8 → 2.49.8-ig.1

package/cli/commands/dev.js

@@ -401,12 +401,16 @@ export const dev = (program) => program.command(["dev", "start"], "Work on your
             import("./plugins/warmer.js").then((mod) => mod.useRDSWarmer()),
             useFunctionLogger(),
         ]);
-        // Trigger warmup by invoking Lambda functions with warmup payloads
-        // This creates workers through the real request flow
-        import("../../runtime/workers.js").then(async (mod) => {
-            const workers = await mod.useRuntimeWorkers();
-            await workers.triggerWarmup(30);
-        });
+        // Warm the pool through the real request flow. SST_WARMUP_COUNT=0
+        // turns this off; the count is capped at the pool size so warmup can
+        // never hold more isolates than steady state would.
+        const { WARMUP_COUNT } = await import("../../runtime/worker-config.js");
+        if (WARMUP_COUNT > 0) {
+            import("../../runtime/workers.js").then(async (mod) => {
+                const workers = await mod.useRuntimeWorkers();
+                await workers.triggerWarmup(WARMUP_COUNT);
+            });
+        }
     }
     catch (e) {
         await exitWithError(e);

package/constructs/AstroSite.d.ts

@@ -43,7 +43,7 @@ export declare class AstroSite extends SsrSite {
         data: {
             mode: "placeholder" | "deployed";
             path: string;
-            runtime: "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x";
+            runtime: "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x" | "nodejs24.x";
             customDomainUrl: string | undefined;
             url: string | undefined;
             edge: boolean | undefined;

package/constructs/EdgeFunction.d.ts

@@ -9,7 +9,7 @@ import { Permissions } from "./util/permission.js";
 export interface EdgeFunctionProps {
     bundle?: string;
     handler: string;
-    runtime?: "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x";
+    runtime?: "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x" | "nodejs24.x";
     timeout?: number | Duration;
     memorySize?: number | Size;
     permissions?: Permissions;

package/constructs/EdgeFunction.js

@@ -43,7 +43,7 @@ export class EdgeFunction extends Construct {
         //       them.
         this.scope = props.scopeOverride || this;
         this.props = {
-            runtime: "nodejs18.x",
+            runtime: "nodejs24.x",
             timeout: 10,
             memorySize: 1024,
             ...props,
@@ -345,11 +345,13 @@ export class EdgeFunction extends Construct {
                         S3Bucket: assetBucket,
                         S3Key: assetKey,
                     },
-                    Runtime: runtime === "nodejs22.x"
-                        ? Runtime.NODEJS_22_X.name
-                        : runtime === "nodejs20.x"
-                            ? Runtime.NODEJS_20_X.name
-                            : Runtime.NODEJS_18_X.name,
+                    Runtime: runtime === "nodejs24.x"
+                        ? Runtime.NODEJS_24_X.name
+                        : runtime === "nodejs22.x"
+                            ? Runtime.NODEJS_22_X.name
+                            : runtime === "nodejs20.x"
+                                ? Runtime.NODEJS_20_X.name
+                                : Runtime.NODEJS_18_X.name,
                     MemorySize: typeof memorySize === "string"
                         ? toCdkSize(memorySize).toMebibytes()
                         : memorySize,

package/constructs/Function.d.ts

@@ -18,6 +18,7 @@ declare const supportedRuntimes: {
     "nodejs18.x": CDKRuntime;
     "nodejs20.x": CDKRuntime;
     "nodejs22.x": CDKRuntime;
+    "nodejs24.x": CDKRuntime;
     "python3.7": CDKRuntime;
     "python3.8": CDKRuntime;
     "python3.9": CDKRuntime;
@@ -150,7 +151,7 @@ export interface FunctionProps extends Omit<FunctionOptions, "functionName" | "m
     handler?: string;
     /**
      * The runtime environment for the function.
-     * @default "nodejs22.x"
+     * @default "nodejs24.x"
      * @example
      * ```js
      * new Function(stack, "Function", {
@@ -799,7 +800,7 @@ export declare class Function extends CDKFunction implements SSTConstruct {
         type: "Function";
         data: {
             arn: string;
-            runtime: "container" | "rust" | "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x" | "python3.7" | "python3.8" | "python3.9" | "python3.10" | "python3.11" | "python3.12" | "python3.13" | "dotnetcore3.1" | "dotnet6" | "dotnet8" | "java8" | "java11" | "java17" | "java21" | "go1.x" | "go" | undefined;
+            runtime: "container" | "rust" | "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x" | "nodejs24.x" | "python3.7" | "python3.8" | "python3.9" | "python3.10" | "python3.11" | "python3.12" | "python3.13" | "dotnetcore3.1" | "dotnet6" | "dotnet8" | "java8" | "java11" | "java17" | "java21" | "go1.x" | "go" | undefined;
             handler: string | undefined;
             missingSourcemap: boolean | undefined;
             localId: string;

package/constructs/Function.js

@@ -37,6 +37,7 @@ const supportedRuntimes = {
     "nodejs18.x": CDKRuntime.NODEJS_18_X,
     "nodejs20.x": CDKRuntime.NODEJS_20_X,
     "nodejs22.x": CDKRuntime.NODEJS_22_X,
+    "nodejs24.x": CDKRuntime.NODEJS_24_X,
     "python3.7": CDKRuntime.PYTHON_3_7,
     "python3.8": CDKRuntime.PYTHON_3_8,
     "python3.9": CDKRuntime.PYTHON_3_9,
@@ -89,7 +90,7 @@ export class Function extends CDKFunction {
             .forEach((per) => {
             props = Function.mergeProps(per, props);
         });
-        props.runtime = props.runtime || "nodejs22.x";
+        props.runtime = props.runtime || "nodejs24.x";
         if (props.runtime === "go1.x")
             useWarning().add("go.deprecated");
         // Set defaults

package/constructs/Job.d.ts

@@ -100,7 +100,7 @@ export interface JobProps {
     architecture?: "x86_64" | "arm_64";
     /**
      * The runtime environment for the job.
-     * @default "nodejs18.x"
+     * @default "nodejs24.x"
      * @example
      * ```js
      * new Job(stack, "MyJob", {
@@ -109,7 +109,7 @@ export interface JobProps {
      * })
      *```
      */
-    runtime?: "nodejs" | "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x" | "container";
+    runtime?: "nodejs" | "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x" | "nodejs24.x" | "container";
     /**
      * For "nodejs" runtime, point to the entry point and handler function.
      * Of the format: `/path/to/file.function`.

package/constructs/Job.js

@@ -285,6 +285,7 @@ export class Job extends Construct {
                     "nodejs18.x": "amazon/aws-lambda-nodejs:18.2023.12.14.13",
                     "nodejs20.x": "amazon/aws-lambda-nodejs:20.2023.12.14.13",
                     "nodejs22.x": "amazon/aws-lambda-nodejs:22.2024.11.22.14",
+                    "nodejs24.x": "amazon/aws-lambda-nodejs:24.2025.12.21.13",
                 },
                 x86_64: {
                     nodejs: "amazon/aws-lambda-nodejs:16",
@@ -292,11 +293,12 @@ export class Job extends Construct {
                     "nodejs18.x": "amazon/aws-lambda-nodejs:18",
                     "nodejs20.x": "amazon/aws-lambda-nodejs:20",
                     "nodejs22.x": "amazon/aws-lambda-nodejs:22",
+                    "nodejs24.x": "amazon/aws-lambda-nodejs:24",
                 },
             };
             const image = LinuxBuildImage.fromDockerRegistry(
             // ARM images can be found here https://hub.docker.com/r/amazon/aws-lambda-nodejs
-            dockerImageMap[architecture ?? "x86_64"][runtime ?? "nodejs18.x"]);
+            dockerImageMap[architecture ?? "x86_64"][runtime ?? "nodejs24.x"]);
             project.environment = {
                 ...project.environment,
                 type: architecture === "arm_64" ? "ARM_CONTAINER" : "LINUX_CONTAINER",
@@ -415,6 +417,6 @@ export class Job extends Construct {
     }
     convertJobRuntimeToFunctionRuntime() {
         const { runtime } = this.props;
-        return runtime === "container" ? "container" : "nodejs18.x";
+        return runtime === "container" ? "container" : "nodejs24.x";
     }
 }

package/constructs/NextjsSite.d.ts

@@ -163,7 +163,7 @@ export declare class NextjsSite extends SsrSite {
         data: {
             mode: "placeholder" | "deployed";
             path: string;
-            runtime: "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x";
+            runtime: "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x" | "nodejs24.x";
             customDomainUrl: string | undefined;
             url: string | undefined;
             edge: boolean | undefined;

package/constructs/NextjsSite.js

@@ -78,7 +78,7 @@ export class NextjsSite extends SsrSite {
                 ...baseServerConfig,
                 handler: fn.handler,
                 bundle: path.join(sitePath, fn.bundle),
-                runtime: this.props.runtime ?? "nodejs18.x",
+                runtime: this.props.runtime ?? "nodejs24.x",
                 architecture: Architecture.ARM_64,
                 memorySize: this.props.memorySize ?? 1536,
                 environment: {
@@ -107,7 +107,7 @@ export class NextjsSite extends SsrSite {
             function: {
                 handler: fn.handler,
                 bundle: path.join(sitePath, fn.bundle),
-                runtime: "nodejs18.x",
+                runtime: "nodejs24.x",
                 memorySize: 1024,
                 environment: {
                     ...environment,

package/constructs/RemixSite.d.ts

@@ -101,7 +101,7 @@ export declare class RemixSite extends SsrSite {
         data: {
             mode: "placeholder" | "deployed";
             path: string;
-            runtime: "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x";
+            runtime: "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x" | "nodejs24.x";
             customDomainUrl: string | undefined;
             url: string | undefined;
             edge: boolean | undefined;

package/constructs/SolidStartSite.d.ts

@@ -80,7 +80,7 @@ export declare class SolidStartSite extends SsrSite {
         data: {
             mode: "placeholder" | "deployed";
             path: string;
-            runtime: "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x";
+            runtime: "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x" | "nodejs24.x";
             customDomainUrl: string | undefined;
             url: string | undefined;
             edge: boolean | undefined;

package/constructs/SsrFunction.d.ts

@@ -11,7 +11,7 @@ import { Duration } from "./util/duration.js";
 export interface SsrFunctionProps extends Omit<FunctionOptions, "memorySize" | "timeout" | "runtime"> {
     bundle?: string;
     handler: string;
-    runtime?: "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x";
+    runtime?: "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x" | "nodejs24.x";
     timeout?: number | Duration;
     memorySize?: number | Size;
     permissions?: Permissions;
@@ -58,7 +58,7 @@ export declare class SsrFunction extends Construct implements SSTConstruct {
         type: "Function";
         data: {
             arn: string;
-            runtime: "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x" | undefined;
+            runtime: "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x" | "nodejs24.x" | undefined;
             handler: string;
             missingSourcemap: boolean | undefined;
             localId: string;

package/constructs/SsrFunction.js

@@ -107,11 +107,13 @@ export class SsrFunction extends Construct {
             handler: handler.split(path.sep).join(path.posix.sep),
             logRetention: logRetention ?? RetentionDays.THREE_DAYS,
             code: Code.fromBucket(Bucket.fromBucketName(this, "IServerFunctionBucket", assetBucket), assetKey),
-            runtime: runtime === "nodejs22.x"
-                ? Runtime.NODEJS_22_X
-                : runtime === "nodejs20.x"
-                    ? Runtime.NODEJS_20_X
-                    : Runtime.NODEJS_18_X,
+            runtime: runtime === "nodejs24.x"
+                ? Runtime.NODEJS_24_X
+                : runtime === "nodejs22.x"
+                    ? Runtime.NODEJS_22_X
+                    : runtime === "nodejs20.x"
+                        ? Runtime.NODEJS_20_X
+                        : Runtime.NODEJS_18_X,
             architecture,
             memorySize: typeof memorySize === "string"
                 ? toCdkSize(memorySize).toMebibytes()

package/constructs/SsrSite.d.ts

@@ -139,7 +139,7 @@ export interface SsrSiteProps {
      * runtime: "nodejs20.x",
      * ```
      */
-    runtime?: "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x";
+    runtime?: "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x" | "nodejs24.x";
     /**
      * Used to configure nodejs function properties
      */
@@ -465,7 +465,7 @@ export declare abstract class SsrSite extends Construct implements SSTConstruct
         data: {
             mode: "placeholder" | "deployed";
             path: string;
-            runtime: "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x";
+            runtime: "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x" | "nodejs24.x";
             customDomainUrl: string | undefined;
             url: string | undefined;
             edge: boolean | undefined;

package/constructs/SsrSite.js

@@ -634,7 +634,7 @@ function handler(event) {
                 singletonUrlSigner ??
                     new EdgeFunction(self, "ServerUrlSigningFunction", {
                         bundle: path.join(__dirname, "../support/signing-function"),
-                        runtime: "nodejs18.x",
+                        runtime: "nodejs24.x",
                         handler: "index.handler",
                         timeout: 10,
                         memorySize: 128,

package/constructs/Stack.d.ts

@@ -47,7 +47,7 @@ export declare class Stack extends CDKStack {
      * ```js
      * stack.setDefaultFunctionProps({
      *   srcPath: "backend",
-     *   runtime: "nodejs18.x",
+     *   runtime: "nodejs24.x",
      * });
      * ```
      */

package/constructs/Stack.js

@@ -68,7 +68,7 @@ export class Stack extends CDKStack {
      * ```js
      * stack.setDefaultFunctionProps({
      *   srcPath: "backend",
-     *   runtime: "nodejs18.x",
+     *   runtime: "nodejs24.x",
      * });
      * ```
      */

package/constructs/SvelteKitSite.d.ts

@@ -121,7 +121,7 @@ export declare class SvelteKitSite extends SsrSite {
         data: {
             mode: "placeholder" | "deployed";
             path: string;
-            runtime: "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x";
+            runtime: "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x" | "nodejs24.x";
             customDomainUrl: string | undefined;
             url: string | undefined;
             edge: boolean | undefined;

package/constructs/deprecated/NextjsSite.d.ts

@@ -74,16 +74,16 @@ export interface NextjsSiteProps {
             permissions?: Permissions;
             /**
              * The runtime environment.
-             * @default "nodejs18.x"
+             * @default "nodejs24.x"
              * @example
              * ```js
              * new Function(stack, "Function", {
              *   path: "path/to/site",
-             *   runtime: "nodejs18.x",
+             *   runtime: "nodejs24.x",
              * })
              *```
              */
-            runtime?: "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x";
+            runtime?: "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x" | "nodejs24.x";
         };
     };
     /**

package/constructs/deprecated/NextjsSite.js

@@ -1039,13 +1039,16 @@ export class NextjsSite extends Construct {
         return replaceValues;
     }
     normalizeRuntime(runtime) {
+        if (runtime === "nodejs24.x") {
+            return lambda.Runtime.NODEJS_24_X;
+        }
         if (runtime === "nodejs22.x") {
             return lambda.Runtime.NODEJS_22_X;
         }
         if (runtime === "nodejs20.x") {
             return lambda.Runtime.NODEJS_20_X;
         }
-        return lambda.Runtime.NODEJS_18_X;
+        return lambda.Runtime.NODEJS_24_X;
     }
 }
 export const useSites = createAppContext(() => {

package/constructs/deprecated/cross-region-helper.js

@@ -18,7 +18,7 @@ export function getOrCreateBucket(scope) {
     const provider = new lambda.Function(stack, providerId, {
         code: lambda.Code.fromAsset(path.join(__dirname, "../../support/edge-function")),
         handler: "s3-bucket.handler",
-        runtime: lambda.Runtime.NODEJS_20_X,
+        runtime: lambda.Runtime.NODEJS_22_X,
         timeout: Duration.minutes(15),
         memorySize: 1024,
         initialPolicy: [
@@ -50,7 +50,7 @@ export function createFunction(scope, name, role, bucketName, functionParams) {
         provider = new lambda.Function(stack, providerId, {
             code: lambda.Code.fromAsset(path.join(__dirname, "../../support/edge-function")),
             handler: "edge-lambda.handler",
-            runtime: lambda.Runtime.NODEJS_20_X,
+            runtime: lambda.Runtime.NODEJS_22_X,
             timeout: Duration.minutes(15),
             memorySize: 1024,
             initialPolicy: [
@@ -88,7 +88,7 @@ export function createVersion(scope, name, functionArn) {
         provider = new lambda.Function(stack, providerId, {
             code: lambda.Code.fromAsset(path.join(__dirname, "../../support/edge-function")),
             handler: "edge-lambda-version.handler",
-            runtime: lambda.Runtime.NODEJS_20_X,
+            runtime: lambda.Runtime.NODEJS_22_X,
             timeout: Duration.minutes(15),
             memorySize: 1024,
             initialPolicy: [

package/iot.js

@@ -22,6 +22,59 @@ import { useBus } from "./bus.js";
 import { useProject } from "./project.js";
 import { useBootstrap } from "./bootstrap.js";
 import { PutObjectCommand, S3Client } from "@aws-sdk/client-s3";
+/**
+ * Re-sign the next reconnect with credentials that are still alive.
+ *
+ * The device is built with resolved credential *values*, because
+ * `aws-iot-device-sdk` takes strings rather than a provider. It keeps them in
+ * closure variables and re-signs the WebSocket URL from those on every
+ * reconnect, and nothing ever writes to them again except this call. So once
+ * the session expires, every retry presents a dead `sessionToken`, AWS IoT
+ * rejects the upgrade, and the socket closes again — forever.
+ *
+ * Measured on one machine: the connection dropped routinely five times in the
+ * first fifteen minutes and recovered each time; an hour later the credentials
+ * expired, and the next drop began **93 consecutive failed reconnects over five
+ * hours**, none of which emitted an `error` event. Nothing in the CLI said
+ * anything, and every request through the Live Lambda bridge 504'd.
+ *
+ * Every other AWS call in the process is unaffected, because `useAWSClient`
+ * passes the *provider* and the SDK calls it per request. This is the one path
+ * that holds values, so it is the one path that needs telling.
+ *
+ * **Why `close` and not `reconnect`.** The signing is synchronous and this
+ * refresh is not, so the two race. `emit("reconnect")` runs its handlers and
+ * returns — it does not await them — and `_setupStream()` signs on the next
+ * line, from whatever the variables hold at that instant. A refresh started
+ * there always loses. `close` fires one backoff interval earlier (the SDK
+ * manages its own, from `baseReconnectTimeMs` of 1s up to 128s, ignoring the
+ * `reconnectPeriod` passed in), which is ample for the resolve to land before
+ * the next attempt signs.
+ *
+ * So this wins the race by margin, not by construction. Two things bound it:
+ * `close` fires on **every** failed reconnect, not once per outage, so the
+ * values can never be more than one backoff interval stale; and the retry loop
+ * is unconditional. Making it airtight would mean keeping the stored
+ * credentials warm so the synchronous path can never read a stale one — a
+ * timer, which is machinery duplicating what the memoized provider already
+ * does. Measured recovery is five seconds, so that is not worth it yet.
+ *
+ * The provider only reaches the network within five minutes of expiry, so this
+ * is an in-memory read on most drops and one real refresh per session.
+ */
+async function refreshWebSocketCredentials(device, label) {
+    try {
+        const fresh = await useAWSCredentials();
+        // The typings mark `expiration` as required, but the implementation only
+        // assigns the three credential strings and never reads it — so this passes
+        // what the provider gave rather than inventing a date to satisfy a
+        // parameter nothing uses.
+        device.updateWebSocketCredentials(fresh.accessKeyId, fresh.secretAccessKey, fresh.sessionToken, fresh.expiration);
+    }
+    catch (err) {
+        Logger.debug(`${label} credential refresh failed`, err);
+    }
+}
 export const useIOT = lazy(async () => {
     const bus = useBus();
     const endpoint = await useIOTEndpoint();
@@ -116,6 +169,7 @@ export const useIOT = lazy(async () => {
     });
     device.on("close", () => {
         Logger.debug("IoT closed");
+        void refreshWebSocketCredentials(device, "IoT");
     });
     device.on("reconnect", () => {
         Logger.debug("IoT reconnecting...");
@@ -241,6 +295,7 @@ export const useIOTControl = lazy(async () => {
     });
     device.on("close", () => {
         Logger.debug("IoT control closed");
+        void refreshWebSocketCredentials(device, "IoT control");
     });
     device.on("reconnect", () => {
         Logger.debug("IoT control reconnecting...");

package/package.json

@@ -1,7 +1,7 @@
 {
   "sideEffects": false,
   "name": "@intelligems/sst",
-  "version": "2.49.6-ig.8",
+  "version": "2.49.8-ig.1",
   "bin": {
     "sst": "cli/sst.js"
   },
@@ -32,7 +32,7 @@
   "homepage": "https://sst.dev",
   "dependencies": {
     "@aws-cdk/aws-lambda-python-alpha": "2.201.0-alpha.0",
-    "@aws-cdk/cloud-assembly-schema": "44.5.0",
+    "@aws-cdk/cloud-assembly-schema": "48.0.0",
     "@aws-cdk/cloudformation-diff": "2.182.0",
     "@aws-cdk/cx-api": "2.201.0",
     "@aws-cdk/toolkit-lib": "1.1.1",
@@ -60,7 +60,7 @@
     "@smithy/signature-v4": "2.0.16",
     "@trpc/server": "9.18.0",
     "adm-zip": "0.5.14",
-    "aws-cdk-lib": "2.201.0",
+    "aws-cdk-lib": "2.224.0",
     "aws-iot-device-sdk": "^2.2.13",
     "aws-sdk": "^2.1501.0",
     "builtin-modules": "3.2.0",

package/runtime/handlers/node.js

@@ -12,6 +12,8 @@ import { Colors } from "../../cli/colors.js";
 import { Logger } from "../../logger.js";
 import { findAbove } from "../../util/fs.js";
 import { useMonoBuildConfig } from "../mono-build-config.js";
+import { SOURCE_MAPS, WORKER_MAX_HEAP_MB } from "../worker-config.js";
+import { forgetWorkerMemory, recordWorkerMemory } from "../memory-logging.js";
 export const useNodeHandler = () => {
     const rebuildCache = {};
     process.on("exit", () => {
@@ -40,7 +42,13 @@ export const useNodeHandler = () => {
                     ...input.environment,
                     IS_LOCAL: "true",
                 },
-                execArgv: ["--enable-source-maps"],
+                // Source maps cost memory in every isolate; opt in with SST_SOURCE_MAPS=true
+                execArgv: SOURCE_MAPS ? ["--enable-source-maps"] : [],
+                // Cap each isolate so a leaking handler kills its own worker
+                // instead of growing the whole dev process until the machine stalls
+                resourceLimits: WORKER_MAX_HEAP_MB > 0
+                    ? { maxOldGenerationSizeMb: WORKER_MAX_HEAP_MB }
+                    : undefined,
                 workerData: input,
                 stderr: true,
                 stdin: true,
@@ -52,11 +60,25 @@ export const useNodeHandler = () => {
             worker.stderr.on("data", (data) => {
                 workers.stdout(input.workerID, data.toString());
             });
-            worker.on("exit", () => workers.exited(input.workerID));
+            worker.on("message", (msg) => {
+                if (msg && msg.type === "sst.memory") {
+                    recordWorkerMemory(input.workerID, msg.report);
+                }
+            });
+            worker.on("error", (err) => {
+                Logger.debug("Worker error", input.workerID, err);
+            });
+            worker.on("exit", () => {
+                threads.delete(input.workerID);
+                forgetWorkerMemory(input.workerID);
+                workers.exited(input.workerID);
+            });
             threads.set(input.workerID, worker);
         },
         stopWorker: async (workerID) => {
             const worker = threads.get(workerID);
+            threads.delete(workerID);
+            forgetWorkerMemory(workerID);
             await worker?.terminate();
         },
         build: async (input) => {

package/runtime/handlers.d.ts

@@ -30,6 +30,10 @@ export interface StartWorkerInput {
     runtime: string;
     /** Whether this worker is using mono build mode */
     isMonoBuild?: boolean;
+    /** Invocations this worker may run at once (Node only; others run one). */
+    concurrency?: number;
+    /** Ask the worker to report its memory usage to the parent. */
+    debugMemory?: boolean;
 }
 interface ShouldBuildInput {
     file: string;

package/runtime/memory-logging.d.ts

@@ -0,0 +1,26 @@
+export interface WorkerMemoryReport {
+    rss: number;
+    heapUsed: number;
+    heapTotal: number;
+    external: number;
+    /** "loaded" right after the bundle import, "response" after an invocation. */
+    phase: "loaded" | "response";
+    loadMs?: number;
+}
+interface WorkerStatsProvider {
+    (): {
+        workers: number;
+        inFlight: number;
+        queued: number;
+    };
+}
+export declare const isMemoryTrackingEnabled: () => boolean;
+/** Called by the Node handler whenever a worker posts a memory report. */
+export declare function recordWorkerMemory(workerID: string, report: WorkerMemoryReport): void;
+/** Called by the Node handler when a worker goes away. */
+export declare function forgetWorkerMemory(workerID: string): void;
+/** Start periodic sampling. No-op unless SST_DEBUG_MEMORY=true. */
+export declare function startMemorySampling(stats: WorkerStatsProvider): void;
+/** Peak line for the pool session summary. Empty when tracking is off. */
+export declare function memorySummary(): string;
+export {};