@camstack/types 1.2.361 → 1.2.363

package/dist/interfaces/addon.d.ts

@@ -1328,6 +1328,43 @@ export interface AddonExecution {
      * `0` means "no ceiling for this addon" and, being the maximum, lifts the whole runner's cap.
      */
     readonly maxOldSpaceMb?: number;
+    /**
+     * V8 young-generation semi-space in MB (`--max-semi-space-size`), for a runner
+     * whose allocation pattern V8's class default fits badly.
+     *
+     * OMITTED (the common case) → the class default: a light runner's 2 MB, a heavy
+     * runner's V8 default (64 MB on a 64-bit host). Declare it from a MEASUREMENT of
+     * the runner's GC log, never from taste. The case it exists for: a heavy runner
+     * whose live old space is small while its allocation rate is high (`stream-broker`,
+     * ~100 MB live against ~11 k RTP packets/s). V8 sizes a mark-compact's old-space
+     * headroom from the live set (~0.5×), and when that headroom is BELOW the young
+     * generation, every scavenge promotes enough to restart incremental marking —
+     * measured on the hub as ~166 major GCs a minute and not one scavenge, 45–60 % of
+     * a core. A semi-space the headroom can absorb lets V8 scavenge again
+     * (`semiSpaceMb: 8` → 176 → 20.8 majors/min, CPU 60 → 21.7 %).
+     *
+     * Range: an integer in `[1, 256]`; anything else is ignored. A runner's value is
+     * the MAXIMUM declared by any co-located addon (D2/D29): a smaller young
+     * generation than a member asked for would hand that member the churn it
+     * declared its way out of.
+     */
+    readonly semiSpaceMb?: number;
+    /**
+     * V8 initial old-space size in MB (`--initial-old-space-size`): the old-space
+     * headroom the runner STARTS with, so a heap that reaches its steady state in
+     * seconds does not spend them in back-to-back mark-compacts while V8 grows the
+     * limit from the live set.
+     *
+     * OMITTED (the common case) → V8's default (grown from the live set). Declare it
+     * with {@link AddonExecution.semiSpaceMb} and from the same measurement; the two
+     * flags are one remedy, and a semi-space V8 cannot fit under the old-space
+     * headroom buys nothing. Range: an integer in `[16, 65536]`, ignored otherwise,
+     * and clamped at spawn to the runner's old-space CEILING
+     * ({@link AddonExecution.maxOldSpaceMb} or the class default) — an initial size
+     * above the ceiling is a flag V8 refuses. A runner's value is the MAXIMUM any
+     * co-located addon declares (D2/D29).
+     */
+    readonly initialOldSpaceMb?: number;
     /**
      * Whole-process RSS budget in MB — the number the memory watchdog alarms on.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.361",
+  "version": "1.2.363",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",