@intelligems/sst 2.49.6-ig.9 → 2.49.8-ig.2

package/runtime/workers.d.ts

@@ -1,3 +1,4 @@
+import { EventPayload } from "../bus.js";
 declare module "../bus.js" {
     interface Events {
         "worker.started": {
@@ -11,6 +12,8 @@ declare module "../bus.js" {
         "worker.exited": {
             workerID: string;
             functionID: string;
+            /** Set for pooled workers: the id the runtime server keys on. */
+            pooledWorkerID?: string;
         };
         "worker.stdout": {
             workerID: string;
@@ -39,27 +42,45 @@ declare module "../bus.js" {
         };
     }
 }
+interface Worker {
+    workerID: string;
+    functionID: string;
+}
 export declare const useRuntimeWorkers: () => Promise<{
-    fromID(workerID: string): {
-        workerID: string;
-        functionID: string;
-    };
+    fromID(workerID: string): Worker;
     getCurrentRequestID(workerID: string): string | undefined;
+    /**
+     * Who a response belongs to. Pooled workers may hold several requests,
+     * so the request id decides; non-pooled workers are their own AWS worker.
+     */
+    resolveRequest(workerID: string, requestID?: string): {
+        awsWorkerID: string;
+        functionID: string;
+    } | undefined;
     stdout(workerID: string, message: string): void;
     exited(workerID: string): void;
-    onResponse(pooledWorkerID: string): void;
-    getAwsWorkerID(pooledWorkerID: string): string | undefined;
+    onResponse(pooledWorkerID: string, requestID?: string): void;
     isPooled(workerID: string): boolean;
-    subscribe: <Type extends "worker.started" | "worker.stopped" | "worker.exited" | "worker.stdout" | "worker.reused">(type: Type, cb: (payload: import("../bus.js").EventPayload<Type>) => void) => {
+    stats: () => {
+        workers: number;
+        inFlight: number;
+        queued: number;
+    };
+    subscribe: <Type extends "worker.started" | "worker.stopped" | "worker.exited" | "worker.stdout" | "worker.reused">(type: Type, cb: (payload: EventPayload<Type>) => void) => {
         type: keyof import("../bus.js").Events;
         cb: (payload: any) => void;
     };
     /**
-     * Trigger warmup by invoking Lambda functions with warmup payloads.
-     * This sends real requests through the IoT bridge, which naturally creates workers.
-     * @param count Number of workers to warm up (default: 15)
+     * Warm the pool by invoking a Node function with warm pings.
+     *
+     * Each ping is marked as a fan-out *child* (`__WARMER_INVOCATION__ > 1`)
+     * so the app's lambda-warmer preloads its handlers and returns instead of
+     * fanning out to `concurrency` more Lambdas, which is what turned the old
+     * 30 pings into ~900 worker creations. The count is capped at the pool
+     * size, and pings go through the normal pool path, so warmup can never
+     * hold more isolates than steady state.
      */
-    triggerWarmup(count?: number): Promise<{
+    triggerWarmup(count: number): Promise<{
         warmed: number;
         elapsed?: undefined;
     } | {
@@ -67,3 +88,4 @@ export declare const useRuntimeWorkers: () => Promise<{
         elapsed: number;
     }>;
 }>;
+export {};