@n-dx/core 0.1.0

package/packages/hench/dist/process/memory-monitor.js

@@ -0,0 +1,268 @@
+/**
+ * Cross-platform system memory monitoring for pre-spawn checks.
+ *
+ * Provides real-time memory usage detection across macOS, Linux, and Windows
+ * by using platform-specific APIs when available and falling back to
+ * `os.freemem()`/`os.totalmem()` as a baseline.
+ *
+ * Key differences from {@link MemoryThrottle}:
+ * - **MemoryThrottle** is the entry-gate decision engine (delay/reject at run start)
+ * - **SystemMemoryMonitor** provides accurate cross-platform memory readings
+ *   and a lightweight pre-spawn check for the tool dispatch path
+ *
+ * Integration points:
+ * - Implements `SystemMemoryReader` for use as a `MemoryThrottle` backend
+ * - Standalone `checkBeforeSpawn()` for per-tool-call memory gating
+ * - `snapshot()` for API/dashboard exposure
+ *
+ * Platform behavior:
+ * - **Linux**: reads `/proc/meminfo` for `MemAvailable` (accounts for
+ *   page cache and reclaimable slab memory the kernel can reclaim)
+ * - **macOS**: uses `os.freemem()` (Darwin's `vm_stat` free pages)
+ * - **Windows**: uses `os.freemem()` (Win32 `GlobalMemoryStatusEx`)
+ *
+ * @module hench/process/memory-monitor
+ */
+import { freemem, totalmem, platform } from "node:os";
+import { readFile } from "node:fs/promises";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Default memory usage percentage that blocks process spawning. */
+const DEFAULT_SPAWN_THRESHOLD = 90;
+/** Default memory monitor configuration. */
+export const DEFAULT_MEMORY_MONITOR_CONFIG = {
+    enabled: true,
+    spawnThreshold: DEFAULT_SPAWN_THRESHOLD,
+};
+// ---------------------------------------------------------------------------
+// Platform-specific memory readers
+// ---------------------------------------------------------------------------
+/**
+ * Parse Linux `/proc/meminfo` for `MemAvailable`.
+ *
+ * `MemAvailable` is more accurate than `MemFree` because it accounts for
+ * page cache and reclaimable slab memory that the kernel can reclaim
+ * under memory pressure. Available since Linux 3.14 (2014).
+ *
+ * @returns Available memory in bytes, or `undefined` if not readable.
+ */
+async function readLinuxAvailableMemory() {
+    try {
+        const content = await readFile("/proc/meminfo", "utf-8");
+        const match = content.match(/^MemAvailable:\s+(\d+)\s+kB$/m);
+        if (match) {
+            return parseInt(match[1], 10) * 1024; // kB → bytes
+        }
+    }
+    catch {
+        // /proc/meminfo not available — fall back to os.freemem()
+    }
+    return undefined;
+}
+/**
+ * Parse macOS `vm_stat` output to compute available memory.
+ *
+ * macOS `os.freemem()` only reports "Free" pages, ignoring Inactive,
+ * Speculative, and Purgeable pages that are immediately reclaimable. This
+ * causes the system to dramatically underreport available memory — a Mac
+ * with 32 GB RAM may report only 500 MB "free" while 10+ GB of
+ * reclaimable pages sit idle.
+ *
+ * Available = (Free + Inactive + Speculative + Purgeable) * pageSize
+ *
+ * - **Free**: completely unused pages
+ * - **Inactive**: pages not recently referenced, immediately reclaimable
+ * - **Speculative**: pre-fetched file data the kernel read ahead,
+ *   immediately reclaimable
+ * - **Purgeable**: volatile caches the kernel can discard instantly
+ *
+ * @returns Available memory in bytes, or `undefined` if vm_stat fails.
+ */
+async function readDarwinAvailableMemory() {
+    try {
+        const { stdout } = await execFileAsync("vm_stat", [], { timeout: 5000 });
+        // vm_stat reports page size on the first line:
+        //   "Mach Virtual Memory Statistics: (page size of 16384 bytes)"
+        const pageSizeMatch = stdout.match(/page size of (\d+) bytes/);
+        const pageSize = pageSizeMatch ? parseInt(pageSizeMatch[1], 10) : 16384;
+        // Parse page counts from lines like:
+        //   "Pages free:         12345."
+        //   "Pages inactive:     67890."
+        //   "Pages speculative:  22222."
+        //   "Pages purgeable:    11111."
+        const parse = (label) => {
+            const re = new RegExp(`^${label}:\\s+(\\d+)`, "m");
+            const m = stdout.match(re);
+            return m ? parseInt(m[1], 10) : 0;
+        };
+        const free = parse("Pages free");
+        const inactive = parse("Pages inactive");
+        const speculative = parse("Pages speculative");
+        const purgeable = parse("Pages purgeable");
+        const availableBytes = (free + inactive + speculative + purgeable) * pageSize;
+        return availableBytes > 0 ? availableBytes : undefined;
+    }
+    catch {
+        // vm_stat not available or timed out — fall back to os.freemem()
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// SystemMemoryMonitor
+// ---------------------------------------------------------------------------
+/**
+ * Cross-platform system memory monitor.
+ *
+ * Provides accurate memory readings and a pre-spawn check that can be
+ * called before every child process creation in the tool dispatch path.
+ *
+ * Implements {@link SystemMemoryReader} so it can also serve as the
+ * backend for {@link MemoryThrottle}, ensuring consistent memory readings
+ * across both the entry-gate check and per-spawn checks.
+ *
+ * @example
+ * ```ts
+ * const monitor = new SystemMemoryMonitor({ spawnThreshold: 85 });
+ *
+ * // Quick pre-spawn check
+ * const check = await monitor.checkBeforeSpawn();
+ * if (!check.allowed) {
+ *   console.warn(`Spawn blocked: ${check.reason}`);
+ * }
+ *
+ * // Full snapshot for dashboard/API
+ * const snap = await monitor.snapshot();
+ * console.log(`Memory: ${snap.usagePercent}% used`);
+ *
+ * // As SystemMemoryReader for MemoryThrottle
+ * const throttle = new MemoryThrottle(throttleConfig, monitor);
+ * ```
+ */
+export class SystemMemoryMonitor {
+    _config;
+    _platform;
+    _freemem;
+    _totalmem;
+    _readLinuxAvailable;
+    _readDarwinAvailable;
+    constructor(config, overrides) {
+        this._config = { ...DEFAULT_MEMORY_MONITOR_CONFIG, ...config };
+        this._platform = overrides?.platform ?? platform();
+        this._freemem = overrides?.freemem ?? freemem;
+        this._totalmem = overrides?.totalmem ?? totalmem;
+        this._readLinuxAvailable = overrides?.readLinuxAvailable ?? readLinuxAvailableMemory;
+        this._readDarwinAvailable = overrides?.readDarwinAvailable ?? readDarwinAvailableMemory;
+        // Validate threshold
+        if (this._config.spawnThreshold < 0 || this._config.spawnThreshold > 100) {
+            throw new RangeError("SystemMemoryMonitor spawnThreshold must be between 0 and 100");
+        }
+    }
+    /** Current configuration (read-only copy). */
+    get config() {
+        return { ...this._config };
+    }
+    /** Detected platform. */
+    get detectedPlatform() {
+        return this._platform;
+    }
+    // -----------------------------------------------------------------------
+    // SystemMemoryReader implementation (for MemoryThrottle compatibility)
+    // -----------------------------------------------------------------------
+    /** Free system memory in bytes. Synchronous (uses OS module). */
+    freemem() {
+        return this._freemem();
+    }
+    /** Total system memory in bytes. */
+    totalmem() {
+        return this._totalmem();
+    }
+    // -----------------------------------------------------------------------
+    // Snapshot
+    // -----------------------------------------------------------------------
+    /**
+     * Take a detailed cross-platform memory snapshot.
+     *
+     * On Linux, reads `/proc/meminfo` for accurate available memory.
+     * On other platforms, falls back to `os.freemem()`.
+     */
+    async snapshot() {
+        const totalBytes = this._totalmem();
+        const freeBytes = this._freemem();
+        // Try platform-specific available memory
+        let availableBytes = freeBytes;
+        if (this._platform === "linux") {
+            const linuxAvailable = await this._readLinuxAvailable();
+            if (linuxAvailable !== undefined) {
+                availableBytes = linuxAvailable;
+            }
+        }
+        else if (this._platform === "darwin") {
+            const darwinAvailable = await this._readDarwinAvailable();
+            if (darwinAvailable !== undefined) {
+                availableBytes = darwinAvailable;
+            }
+        }
+        const toMB = (bytes) => Math.round((bytes / 1024 / 1024) * 100) / 100;
+        const usagePercent = totalBytes > 0
+            ? Math.round(((totalBytes - availableBytes) / totalBytes) * 10000) / 100
+            : 0;
+        return {
+            platform: this._platform,
+            totalBytes,
+            freeBytes,
+            availableBytes,
+            usagePercent,
+            totalMB: toMB(totalBytes),
+            freeMB: toMB(freeBytes),
+            availableMB: toMB(availableBytes),
+            timestamp: new Date().toISOString(),
+        };
+    }
+    // -----------------------------------------------------------------------
+    // Pre-spawn check
+    // -----------------------------------------------------------------------
+    /**
+     * Check whether system memory allows spawning a new child process.
+     *
+     * This is the primary integration point for the tool dispatch path.
+     * Called before every process-spawning tool (`run_command`, `git`)
+     * to prevent system-wide memory pressure.
+     *
+     * When disabled (via config), always returns `{ allowed: true }`.
+     *
+     * @returns Structured result with the decision and current memory state.
+     */
+    async checkBeforeSpawn() {
+        if (!this._config.enabled) {
+            const snap = await this.snapshot();
+            return {
+                allowed: true,
+                usagePercent: snap.usagePercent,
+                spawnThreshold: this._config.spawnThreshold,
+                availableMB: snap.availableMB,
+                totalMB: snap.totalMB,
+            };
+        }
+        const snap = await this.snapshot();
+        const allowed = snap.usagePercent < this._config.spawnThreshold;
+        return {
+            allowed,
+            usagePercent: snap.usagePercent,
+            spawnThreshold: this._config.spawnThreshold,
+            availableMB: snap.availableMB,
+            totalMB: snap.totalMB,
+            reason: allowed
+                ? undefined
+                : `System memory usage (${snap.usagePercent.toFixed(1)}%) exceeds spawn threshold ` +
+                    `(${this._config.spawnThreshold}%). ` +
+                    `Available: ${snap.availableMB.toFixed(0)}MB / ${snap.totalMB.toFixed(0)}MB total. ` +
+                    `Close other applications to free memory, or adjust the threshold with: ` +
+                    `hench config guard.memoryMonitor.spawnThreshold <number>`,
+        };
+    }
+}
+//# sourceMappingURL=memory-monitor.js.map

package/packages/hench/dist/process/memory-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-monitor.js","sourceRoot":"","sources":["../../src/process/memory-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,oEAAoE;AACpE,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAgBnC,4CAA4C;AAC5C,MAAM,CAAC,MAAM,6BAA6B,GAAwB;IAChE,OAAO,EAAE,IAAI;IACb,cAAc,EAAE,uBAAuB;CACxC,CAAC;AAqDF,8EAA8E;AAC9E,mCAAmC;AACnC,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,KAAK,UAAU,wBAAwB;IACrC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAC7D,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,aAAa;QACtD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;IAC5D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,KAAK,UAAU,yBAAyB;IACtC,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAEzE,+CAA+C;QAC/C,iEAAiE;QACjE,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC/D,MAAM,QAAQ,GAAG,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAEzE,qCAAqC;QACrC,iCAAiC;QACjC,iCAAiC;QACjC,iCAAiC;QACjC,iCAAiC;QACjC,MAAM,KAAK,GAAG,CAAC,KAAa,EAAU,EAAE;YACtC,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,EAAE,GAAG,CAAC,CAAC;YACnD,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC3B,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC,CAAC;QAEF,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACzC,MAAM,WAAW,GAAG,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAE3C,MAAM,cAAc,GAAG,CAAC,IAAI,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC,GAAG,QAAQ,CAAC;QAC9E,OAAO,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,iEAAiE;IACnE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAuBD,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,OAAO,mBAAmB;IACb,OAAO,CAAsB;IAC7B,SAAS,CAAkB;IAC3B,QAAQ,CAAe;IACvB,SAAS,CAAe;IACxB,mBAAmB,CAAoC;IACvD,oBAAoB,CAAoC;IAEzE,YACE,MAAqC,EACrC,SAAkC;QAElC,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,6BAA6B,EAAE,GAAG,MAAM,EAAE,CAAC;QAC/D,IAAI,CAAC,SAAS,GAAG,SAAS,EAAE,QAAQ,IAAI,QAAQ,EAAE,CAAC;QACnD,IAAI,CAAC,QAAQ,GAAG,SAAS,EAAE,OAAO,IAAI,OAAO,CAAC;QAC9C,IAAI,CAAC,SAAS,GAAG,SAAS,EAAE,QAAQ,IAAI,QAAQ,CAAC;QACjD,IAAI,CAAC,mBAAmB,GAAG,SAAS,EAAE,kBAAkB,IAAI,wBAAwB,CAAC;QACrF,IAAI,CAAC,oBAAoB,GAAG,SAAS,EAAE,mBAAmB,IAAI,yBAAyB,CAAC;QAExF,qBAAqB;QACrB,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,GAAG,GAAG,EAAE,CAAC;YACzE,MAAM,IAAI,UAAU,CAAC,8DAA8D,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,IAAI,MAAM;QACR,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,yBAAyB;IACzB,IAAI,gBAAgB;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,0EAA0E;IAC1E,uEAAuE;IACvE,0EAA0E;IAE1E,iEAAiE;IACjE,OAAO;QACL,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IAED,oCAAoC;IACpC,QAAQ;QACN,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;IAC1B,CAAC;IAED,0EAA0E;IAC1E,WAAW;IACX,0EAA0E;IAE1E;;;;;OAKG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAElC,yCAAyC;QACzC,IAAI,cAAc,GAAG,SAAS,CAAC;QAC/B,IAAI,IAAI,CAAC,SAAS,KAAK,OAAO,EAAE,CAAC;YAC/B,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACxD,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;gBACjC,cAAc,GAAG,cAAc,CAAC;YAClC,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC1D,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;gBAClC,cAAc,GAAG,eAAe,CAAC;YACnC,CAAC;QACH,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAC9E,MAAM,YAAY,GAAG,UAAU,GAAG,CAAC;YACjC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,GAAG,cAAc,CAAC,GAAG,UAAU,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG;YACxE,CAAC,CAAC,CAAC,CAAC;QAEN,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,SAAS;YACxB,UAAU;YACV,SAAS;YACT,cAAc;YACd,YAAY;YACZ,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC;YACzB,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC;YACvB,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC;YACjC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,kBAAkB;IAClB,0EAA0E;IAE1E;;;;;;;;;;OAUG;IACH,KAAK,CAAC,gBAAgB;QACpB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc;gBAC3C,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC;QAEhE,OAAO;YACL,OAAO;YACP,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc;YAC3C,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,OAAO;gBACb,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,wBAAwB,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B;oBACjF,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,MAAM;oBACrC,cAAc,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY;oBACpF,yEAAyE;oBACzE,0DAA0D;SAC/D,CAAC;IACJ,CAAC;CACF"}

package/packages/hench/dist/process/memory-throttle.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Memory-based execution throttling for hench.
+ *
+ * Monitors system memory usage and provides intelligent throttling
+ * decisions to prevent system resource exhaustion during task execution.
+ *
+ * Two thresholds trigger different behaviors:
+ * - **Delay threshold** (default 80%): new executions are delayed with
+ *   exponential backoff until memory drops below the threshold.
+ * - **Reject threshold** (default 95%): new executions are rejected
+ *   outright to protect system stability.
+ *
+ * Works alongside {@link ProcessLimiter} — the limiter controls
+ * concurrency via lock files, while the memory throttle adds a
+ * resource-aware gate before the limiter is even consulted.
+ *
+ * @module hench/process/memory-throttle
+ */
+/**
+ * Thrown when system memory usage exceeds the rejection threshold.
+ *
+ * Contains metadata about the current memory state so the CLI can
+ * display an actionable message.
+ */
+export declare class MemoryThrottleRejectError extends Error {
+    /** Current system memory usage as a percentage (0–100). */
+    readonly memoryUsagePercent: number;
+    /** Configured rejection threshold percentage. */
+    readonly rejectThreshold: number;
+    /** Free system memory in MB. */
+    readonly freeMemoryMB: number;
+    /** Total system memory in MB. */
+    readonly totalMemoryMB: number;
+    constructor(memoryUsagePercent: number, rejectThreshold: number, freeMemoryMB: number, totalMemoryMB: number);
+}
+/**
+ * Configuration for memory-based execution throttling.
+ */
+export interface MemoryThrottleConfig {
+    /** Enable memory throttling. When false, all checks are bypassed. */
+    enabled: boolean;
+    /** Memory usage percentage that triggers execution delays (0–100). */
+    delayThreshold: number;
+    /** Memory usage percentage that triggers execution rejection (0–100). */
+    rejectThreshold: number;
+    /** Base delay in ms when memory exceeds the delay threshold. */
+    baseDelayMs: number;
+    /** Maximum delay in ms for exponential backoff. */
+    maxDelayMs: number;
+    /** Maximum retry attempts before rejecting when throttled. */
+    maxRetries: number;
+}
+/** Default memory throttle configuration. */
+export declare const DEFAULT_MEMORY_THROTTLE_CONFIG: MemoryThrottleConfig;
+/** Throttle decision: allow, delay, or reject. */
+export type ThrottleDecision = "allow" | "delay" | "reject";
+/**
+ * Point-in-time snapshot of memory state and throttle decision.
+ * Suitable for JSON serialization and API exposure.
+ */
+export interface MemoryThrottleStatus {
+    /** Whether memory throttling is enabled. */
+    enabled: boolean;
+    /** Current system memory usage as a percentage (0–100). */
+    memoryUsagePercent: number;
+    /** Free system memory in MB. */
+    freeMemoryMB: number;
+    /** Total system memory in MB. */
+    totalMemoryMB: number;
+    /** Throttle decision based on current memory state. */
+    decision: ThrottleDecision;
+    /** Configured delay threshold percentage. */
+    delayThreshold: number;
+    /** Configured reject threshold percentage. */
+    rejectThreshold: number;
+    /** ISO timestamp of this snapshot. */
+    timestamp: string;
+}
+/**
+ * Interface for reading system memory. Defaults to `os.freemem()`/`os.totalmem()`.
+ * Injected via constructor for deterministic testing.
+ */
+export interface SystemMemoryReader {
+    /** Free system memory in bytes. */
+    freemem(): number;
+    /** Total system memory in bytes. */
+    totalmem(): number;
+}
+/**
+ * Memory-based execution throttle.
+ *
+ * Checks system memory before allowing a new hench execution to proceed.
+ * When memory is above the delay threshold, waits with exponential backoff.
+ * When memory exceeds the reject threshold, throws immediately.
+ *
+ * @example
+ * ```ts
+ * const throttle = new MemoryThrottle(config.guard.memoryThrottle);
+ *
+ * // Check before starting a run
+ * await throttle.gate(({ decision, memoryUsagePercent, delayMs }) => {
+ *   console.log(`Memory: ${memoryUsagePercent}%, decision: ${decision}`);
+ *   if (delayMs) console.log(`Delaying ${delayMs}ms...`);
+ * });
+ *
+ * // Get status for API
+ * const status = throttle.status();
+ * ```
+ */
+export declare class MemoryThrottle {
+    private readonly _config;
+    private readonly _memReader;
+    constructor(config?: Partial<MemoryThrottleConfig>, memReader?: SystemMemoryReader);
+    /** Current configuration (read-only copy). */
+    get config(): Readonly<MemoryThrottleConfig>;
+    /**
+     * Read current system memory state.
+     */
+    private _readMemory;
+    /**
+     * Determine the throttle decision based on current memory.
+     */
+    private _decide;
+    /**
+     * Get a point-in-time snapshot of memory state and throttle decision.
+     */
+    status(): MemoryThrottleStatus;
+    /**
+     * Notification callback invoked during throttling delays.
+     * Allows the caller to display progress messages.
+     */
+    gate(onThrottle?: (info: {
+        decision: ThrottleDecision;
+        memoryUsagePercent: number;
+        delayMs?: number;
+        attempt: number;
+        maxRetries: number;
+    }) => void): Promise<void>;
+    private _gateInternal;
+}

package/packages/hench/dist/process/memory-throttle.js

@@ -0,0 +1,238 @@
+/**
+ * Memory-based execution throttling for hench.
+ *
+ * Monitors system memory usage and provides intelligent throttling
+ * decisions to prevent system resource exhaustion during task execution.
+ *
+ * Two thresholds trigger different behaviors:
+ * - **Delay threshold** (default 80%): new executions are delayed with
+ *   exponential backoff until memory drops below the threshold.
+ * - **Reject threshold** (default 95%): new executions are rejected
+ *   outright to protect system stability.
+ *
+ * Works alongside {@link ProcessLimiter} — the limiter controls
+ * concurrency via lock files, while the memory throttle adds a
+ * resource-aware gate before the limiter is even consulted.
+ *
+ * @module hench/process/memory-throttle
+ */
+import { freemem, totalmem } from "node:os";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Default memory usage percentage that triggers execution delays. */
+const DEFAULT_DELAY_THRESHOLD = 80;
+/** Default memory usage percentage that triggers execution rejection. */
+const DEFAULT_REJECT_THRESHOLD = 95;
+/** Base delay in ms when memory is above the delay threshold. */
+const DEFAULT_BASE_DELAY_MS = 2000;
+/** Maximum delay in ms for exponential backoff. */
+const DEFAULT_MAX_DELAY_MS = 30000;
+/** Maximum number of retry attempts before giving up when throttled. */
+const DEFAULT_MAX_RETRIES = 10;
+// ---------------------------------------------------------------------------
+// Error types
+// ---------------------------------------------------------------------------
+/**
+ * Thrown when system memory usage exceeds the rejection threshold.
+ *
+ * Contains metadata about the current memory state so the CLI can
+ * display an actionable message.
+ */
+export class MemoryThrottleRejectError extends Error {
+    /** Current system memory usage as a percentage (0–100). */
+    memoryUsagePercent;
+    /** Configured rejection threshold percentage. */
+    rejectThreshold;
+    /** Free system memory in MB. */
+    freeMemoryMB;
+    /** Total system memory in MB. */
+    totalMemoryMB;
+    constructor(memoryUsagePercent, rejectThreshold, freeMemoryMB, totalMemoryMB) {
+        const msg = `System memory usage (${memoryUsagePercent.toFixed(1)}%) exceeds rejection threshold (${rejectThreshold}%). ` +
+            `Free: ${freeMemoryMB.toFixed(0)}MB / ${totalMemoryMB.toFixed(0)}MB total. ` +
+            `Close other applications to free memory, or adjust thresholds with: ` +
+            `hench config guard.memoryThrottle.rejectThreshold <number>`;
+        super(msg);
+        this.name = "MemoryThrottleRejectError";
+        this.memoryUsagePercent = memoryUsagePercent;
+        this.rejectThreshold = rejectThreshold;
+        this.freeMemoryMB = freeMemoryMB;
+        this.totalMemoryMB = totalMemoryMB;
+    }
+}
+/** Default memory throttle configuration. */
+export const DEFAULT_MEMORY_THROTTLE_CONFIG = {
+    enabled: false,
+    delayThreshold: DEFAULT_DELAY_THRESHOLD,
+    rejectThreshold: DEFAULT_REJECT_THRESHOLD,
+    baseDelayMs: DEFAULT_BASE_DELAY_MS,
+    maxDelayMs: DEFAULT_MAX_DELAY_MS,
+    maxRetries: DEFAULT_MAX_RETRIES,
+};
+const DEFAULT_MEMORY_READER = {
+    freemem,
+    totalmem,
+};
+// ---------------------------------------------------------------------------
+// MemoryThrottle
+// ---------------------------------------------------------------------------
+/**
+ * Memory-based execution throttle.
+ *
+ * Checks system memory before allowing a new hench execution to proceed.
+ * When memory is above the delay threshold, waits with exponential backoff.
+ * When memory exceeds the reject threshold, throws immediately.
+ *
+ * @example
+ * ```ts
+ * const throttle = new MemoryThrottle(config.guard.memoryThrottle);
+ *
+ * // Check before starting a run
+ * await throttle.gate(({ decision, memoryUsagePercent, delayMs }) => {
+ *   console.log(`Memory: ${memoryUsagePercent}%, decision: ${decision}`);
+ *   if (delayMs) console.log(`Delaying ${delayMs}ms...`);
+ * });
+ *
+ * // Get status for API
+ * const status = throttle.status();
+ * ```
+ */
+export class MemoryThrottle {
+    _config;
+    _memReader;
+    constructor(config, memReader) {
+        this._config = { ...DEFAULT_MEMORY_THROTTLE_CONFIG, ...config };
+        this._memReader = memReader ?? DEFAULT_MEMORY_READER;
+        // Validate thresholds
+        if (this._config.delayThreshold < 0 || this._config.delayThreshold > 100) {
+            throw new RangeError("MemoryThrottle delayThreshold must be between 0 and 100");
+        }
+        if (this._config.rejectThreshold < 0 || this._config.rejectThreshold > 100) {
+            throw new RangeError("MemoryThrottle rejectThreshold must be between 0 and 100");
+        }
+        if (this._config.rejectThreshold <= this._config.delayThreshold) {
+            throw new RangeError("MemoryThrottle rejectThreshold must be greater than delayThreshold");
+        }
+    }
+    /** Current configuration (read-only copy). */
+    get config() {
+        return { ...this._config };
+    }
+    // -----------------------------------------------------------------------
+    // Memory sampling
+    // -----------------------------------------------------------------------
+    /**
+     * Read current system memory state.
+     */
+    _readMemory() {
+        const free = this._memReader.freemem();
+        const total = this._memReader.totalmem();
+        const toMB = (bytes) => Math.round((bytes / 1024 / 1024) * 100) / 100;
+        const usagePercent = total > 0
+            ? Math.round(((total - free) / total) * 10000) / 100
+            : 0;
+        return {
+            usagePercent,
+            freeMB: toMB(free),
+            totalMB: toMB(total),
+        };
+    }
+    /**
+     * Determine the throttle decision based on current memory.
+     */
+    _decide(usagePercent) {
+        if (!this._config.enabled)
+            return "allow";
+        if (usagePercent >= this._config.rejectThreshold)
+            return "reject";
+        if (usagePercent >= this._config.delayThreshold)
+            return "delay";
+        return "allow";
+    }
+    // -----------------------------------------------------------------------
+    // Status
+    // -----------------------------------------------------------------------
+    /**
+     * Get a point-in-time snapshot of memory state and throttle decision.
+     */
+    status() {
+        const { usagePercent, freeMB, totalMB } = this._readMemory();
+        return {
+            enabled: this._config.enabled,
+            memoryUsagePercent: usagePercent,
+            freeMemoryMB: freeMB,
+            totalMemoryMB: totalMB,
+            decision: this._decide(usagePercent),
+            delayThreshold: this._config.delayThreshold,
+            rejectThreshold: this._config.rejectThreshold,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    // -----------------------------------------------------------------------
+    // Gate (blocking check)
+    // -----------------------------------------------------------------------
+    /**
+     * Notification callback invoked during throttling delays.
+     * Allows the caller to display progress messages.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+    gate(onThrottle) {
+        return this._gateInternal(onThrottle);
+    }
+    async _gateInternal(onThrottle) {
+        if (!this._config.enabled)
+            return;
+        for (let attempt = 0; attempt <= this._config.maxRetries; attempt++) {
+            const { usagePercent, freeMB, totalMB } = this._readMemory();
+            const decision = this._decide(usagePercent);
+            if (decision === "allow") {
+                // First attempt is immediate — no notification needed.
+                // On subsequent attempts (after delays), notify that we're proceeding.
+                if (attempt > 0) {
+                    onThrottle?.({
+                        decision,
+                        memoryUsagePercent: usagePercent,
+                        attempt,
+                        maxRetries: this._config.maxRetries,
+                    });
+                }
+                return;
+            }
+            if (decision === "reject") {
+                onThrottle?.({
+                    decision,
+                    memoryUsagePercent: usagePercent,
+                    attempt,
+                    maxRetries: this._config.maxRetries,
+                });
+                throw new MemoryThrottleRejectError(usagePercent, this._config.rejectThreshold, freeMB, totalMB);
+            }
+            // decision === "delay"
+            const delayMs = Math.min(this._config.baseDelayMs * Math.pow(2, attempt), this._config.maxDelayMs);
+            onThrottle?.({
+                decision,
+                memoryUsagePercent: usagePercent,
+                delayMs,
+                attempt,
+                maxRetries: this._config.maxRetries,
+            });
+            await sleep(delayMs);
+        }
+        // Exhausted all retries while in delay zone — check one final time
+        const { usagePercent, freeMB, totalMB } = this._readMemory();
+        const finalDecision = this._decide(usagePercent);
+        if (finalDecision === "allow")
+            return;
+        // Still throttled after max retries — reject
+        throw new MemoryThrottleRejectError(usagePercent, this._config.delayThreshold, // report against delay threshold since we timed out waiting
+        freeMB, totalMB);
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=memory-throttle.js.map

package/packages/hench/dist/process/memory-throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-throttle.js","sourceRoot":"","sources":["../../src/process/memory-throttle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE5C,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,sEAAsE;AACtE,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAEnC,yEAAyE;AACzE,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAEpC,iEAAiE;AACjE,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAEnC,mDAAmD;AACnD,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAEnC,wEAAwE;AACxE,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAClD,2DAA2D;IAClD,kBAAkB,CAAS;IACpC,iDAAiD;IACxC,eAAe,CAAS;IACjC,gCAAgC;IACvB,YAAY,CAAS;IAC9B,iCAAiC;IACxB,aAAa,CAAS;IAE/B,YACE,kBAA0B,EAC1B,eAAuB,EACvB,YAAoB,EACpB,aAAqB;QAErB,MAAM,GAAG,GACP,wBAAwB,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,mCAAmC,eAAe,MAAM;YAC7G,SAAS,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY;YAC5E,sEAAsE;YACtE,4DAA4D,CAAC;QAC/D,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;QAC7C,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF;AAwBD,6CAA6C;AAC7C,MAAM,CAAC,MAAM,8BAA8B,GAAyB;IAClE,OAAO,EAAE,KAAK;IACd,cAAc,EAAE,uBAAuB;IACvC,eAAe,EAAE,wBAAwB;IACzC,WAAW,EAAE,qBAAqB;IAClC,UAAU,EAAE,oBAAoB;IAChC,UAAU,EAAE,mBAAmB;CAChC,CAAC;AA+CF,MAAM,qBAAqB,GAAuB;IAChD,OAAO;IACP,QAAQ;CACT,CAAC;AAEF,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,cAAc;IACR,OAAO,CAAuB;IAC9B,UAAU,CAAqB;IAEhD,YACE,MAAsC,EACtC,SAA8B;QAE9B,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,8BAA8B,EAAE,GAAG,MAAM,EAAE,CAAC;QAChE,IAAI,CAAC,UAAU,GAAG,SAAS,IAAI,qBAAqB,CAAC;QAErD,sBAAsB;QACtB,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,GAAG,GAAG,EAAE,CAAC;YACzE,MAAM,IAAI,UAAU,CAAC,yDAAyD,CAAC,CAAC;QAClF,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,eAAe,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,eAAe,GAAG,GAAG,EAAE,CAAC;YAC3E,MAAM,IAAI,UAAU,CAAC,0DAA0D,CAAC,CAAC;QACnF,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YAChE,MAAM,IAAI,UAAU,CAAC,oEAAoE,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,IAAI,MAAM;QACR,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,0EAA0E;IAC1E,kBAAkB;IAClB,0EAA0E;IAE1E;;OAEG;IACK,WAAW;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAE9E,MAAM,YAAY,GAAG,KAAK,GAAG,CAAC;YAC5B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG;YACpD,CAAC,CAAC,CAAC,CAAC;QAEN,OAAO;YACL,YAAY;YACZ,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC;YAClB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC;SACrB,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,OAAO,CAAC,YAAoB;QAClC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO,OAAO,CAAC;QAC1C,IAAI,YAAY,IAAI,IAAI,CAAC,OAAO,CAAC,eAAe;YAAE,OAAO,QAAQ,CAAC;QAClE,IAAI,YAAY,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc;YAAE,OAAO,OAAO,CAAC;QAChE,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,0EAA0E;IAC1E,SAAS;IACT,0EAA0E;IAE1E;;OAEG;IACH,MAAM;QACJ,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC7D,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;YAC7B,kBAAkB,EAAE,YAAY;YAChC,YAAY,EAAE,MAAM;YACpB,aAAa,EAAE,OAAO;YACtB,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;YACpC,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc;YAC3C,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,eAAe;YAC7C,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,wBAAwB;IACxB,0EAA0E;IAE1E;;;OAGG;IACH,mEAAmE;IACnE,IAAI,CAAC,UAMK;QACR,OAAO,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,UAMlB;QACR,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO;QAElC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YACpE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YAE5C,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACzB,uDAAuD;gBACvD,uEAAuE;gBACvE,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;oBAChB,UAAU,EAAE,CAAC;wBACX,QAAQ;wBACR,kBAAkB,EAAE,YAAY;wBAChC,OAAO;wBACP,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;qBACpC,CAAC,CAAC;gBACL,CAAC;gBACD,OAAO;YACT,CAAC;YAED,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC1B,UAAU,EAAE,CAAC;oBACX,QAAQ;oBACR,kBAAkB,EAAE,YAAY;oBAChC,OAAO;oBACP,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;iBACpC,CAAC,CAAC;gBACH,MAAM,IAAI,yBAAyB,CACjC,YAAY,EACZ,IAAI,CAAC,OAAO,CAAC,eAAe,EAC5B,MAAM,EACN,OAAO,CACR,CAAC;YACJ,CAAC;YAED,uBAAuB;YACvB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CACtB,IAAI,CAAC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,EAC/C,IAAI,CAAC,OAAO,CAAC,UAAU,CACxB,CAAC;YAEF,UAAU,EAAE,CAAC;gBACX,QAAQ;gBACR,kBAAkB,EAAE,YAAY;gBAChC,OAAO;gBACP,OAAO;gBACP,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;aACpC,CAAC,CAAC;YAEH,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;QAED,mEAAmE;QACnE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC7D,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAEjD,IAAI,aAAa,KAAK,OAAO;YAAE,OAAO;QAEtC,6CAA6C;QAC7C,MAAM,IAAI,yBAAyB,CACjC,YAAY,EACZ,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,4DAA4D;QACzF,MAAM,EACN,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}