@intelligems/sst 2.49.6-ig.9 → 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/package.json

@@ -1,7 +1,7 @@
 {
   "sideEffects": false,
   "name": "@intelligems/sst",
-  "version": "2.49.6-ig.9",
+  "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 {};

package/runtime/memory-logging.js

@@ -0,0 +1,112 @@
+import os from "os";
+import { createDebugFileLogger } from "./debug-file-logger.js";
+import { DEBUG_MEMORY, POOL_SIZE, WORKER_CONCURRENCY } from "./worker-config.js";
+/**
+ * Memory tracking for `sst dev`, enabled with SST_DEBUG_MEMORY=true.
+ *
+ * Every SAMPLE_INTERVAL_MS a line goes to .sst/memory.log with the parent
+ * process's memory, the number of live workers and in-flight invocations, and
+ * the sum of what the workers last reported for themselves. Node workers report
+ * their own heap through `parentPort` after they load the bundle and after
+ * each response (see support/nodejs-runtime). Peaks are folded into the pool
+ * session summary so a run can be compared with the previous version at a glance.
+ */
+const MEMORY_LOG_FILE = process.env.SST_DEBUG_MEMORY_FILE || ".sst/memory.log";
+const SAMPLE_INTERVAL_MS = 10_000;
+const mb = (bytes) => Math.round(bytes / 1024 / 1024);
+let logger = null;
+let timer;
+const workerReports = new Map();
+const peaks = {
+    rss: 0,
+    heapUsed: 0,
+    workers: 0,
+    inFlight: 0,
+    queued: 0,
+    workerHeap: 0,
+    firstLoadMs: undefined,
+};
+function getLogger() {
+    if (!DEBUG_MEMORY)
+        return null;
+    if (!logger) {
+        logger = createDebugFileLogger({
+            filePath: MEMORY_LOG_FILE,
+            sessionName: "MEMORY",
+            sessionHeader: `POOL_SIZE=${POOL_SIZE} CONCURRENCY=${WORKER_CONCURRENCY} totalMem=${mb(os.totalmem())}MB`,
+            width: 100,
+        });
+    }
+    return logger;
+}
+export const isMemoryTrackingEnabled = () => DEBUG_MEMORY;
+/** Called by the Node handler whenever a worker posts a memory report. */
+export function recordWorkerMemory(workerID, report) {
+    if (!DEBUG_MEMORY)
+        return;
+    workerReports.set(workerID, report);
+    if (report.phase === "loaded" && peaks.firstLoadMs === undefined) {
+        peaks.firstLoadMs = report.loadMs;
+    }
+    const log = getLogger();
+    log?.log("WORKER", {
+        worker: workerID.slice(0, 8),
+        phase: report.phase,
+        heapUsedMB: mb(report.heapUsed),
+        heapTotalMB: mb(report.heapTotal),
+        externalMB: mb(report.external),
+        ...(report.loadMs !== undefined ? { loadMs: report.loadMs } : {}),
+    });
+}
+/** Called by the Node handler when a worker goes away. */
+export function forgetWorkerMemory(workerID) {
+    workerReports.delete(workerID);
+}
+function sample(stats) {
+    const log = getLogger();
+    if (!log)
+        return;
+    const usage = process.memoryUsage();
+    const { workers, inFlight, queued } = stats();
+    let workerHeap = 0;
+    for (const report of workerReports.values())
+        workerHeap += report.heapUsed;
+    peaks.rss = Math.max(peaks.rss, usage.rss);
+    peaks.heapUsed = Math.max(peaks.heapUsed, usage.heapUsed);
+    peaks.workers = Math.max(peaks.workers, workers);
+    peaks.inFlight = Math.max(peaks.inFlight, inFlight);
+    peaks.queued = Math.max(peaks.queued, queued);
+    peaks.workerHeap = Math.max(peaks.workerHeap, workerHeap);
+    log.log("SAMPLE", {
+        rssMB: mb(usage.rss),
+        heapUsedMB: mb(usage.heapUsed),
+        externalMB: mb(usage.external),
+        workers,
+        inFlight,
+        queued,
+        workerHeapMB: mb(workerHeap),
+        freeMB: mb(os.freemem()),
+    });
+}
+/** Start periodic sampling. No-op unless SST_DEBUG_MEMORY=true. */
+export function startMemorySampling(stats) {
+    if (!DEBUG_MEMORY || timer)
+        return;
+    sample(stats);
+    timer = setInterval(() => sample(stats), SAMPLE_INTERVAL_MS);
+    timer.unref();
+    process.on("exit", () => {
+        clearInterval(timer);
+        getLogger()?.close(memorySummary());
+    });
+}
+/** Peak line for the pool session summary. Empty when tracking is off. */
+export function memorySummary() {
+    if (!DEBUG_MEMORY)
+        return "";
+    return (`  memory: peakRSS=${mb(peaks.rss)}MB peakHeap=${mb(peaks.heapUsed)}MB ` +
+        `peakWorkers=${peaks.workers} peakInFlight=${peaks.inFlight} peakQueued=${peaks.queued} ` +
+        `peakWorkerHeap=${mb(peaks.workerHeap)}MB` +
+        (peaks.firstLoadMs !== undefined ? ` firstBundleLoad=${peaks.firstLoadMs}ms` : "") +
+        "\n");
+}

package/runtime/mono-build-config.d.ts

@@ -5,14 +5,17 @@
  * instead of building each handler individually. This significantly speeds up dev mode
  * by sharing compilation work across all handlers.
  *
- * Detection happens once at startup and the result is cached for the session.
+ * Detection latches on: the first check that finds the bundle enables mono
+ * build for the rest of the session. It deliberately does NOT latch off, so a
+ * caller arriving before the bundle has been written cannot disable it.
  */
 export declare const useMonoBuildConfig: () => {
     /**
-     * Whether mono build mode is enabled (detected at startup).
+     * Whether mono build mode is enabled. Re-checked until the bundle is
+     * found, so a check made before it was written does not stick.
      * When true, all Node.js handlers use the shared .mono-build bundle.
      */
-    enabled: boolean;
+    readonly enabled: boolean;
     /**
      * The mono bundle directory (.mono-build)
      */