instar 1.3.233 → 1.3.235

package/dist/monitoring/ResourceLedger.js

@@ -16,8 +16,12 @@
  * emission, with a real per-event identity (not a content hash) so legitimate
  * same-millisecond events don't collapse and a restart can't replay-double-count.
  *
- * CPU/memory sampling (resource_samples) + retention is Phase B; the table and
- * its methods are not in this file yet.
+ * Phase B adds continuous CPU% + memory sampling (resource_samples) of the
+ * agent's OWN server process and its spawned session processes, written by
+ * ResourceSampler on a cadence. Same discipline: read-only, fail-open, bounded
+ * (retention prune). This closes the "instar tracks zero CPU and zero memory"
+ * gap — token usage was well-tracked (TokenLedger) but per-agent CPU/RSS was
+ * unaccounted for.
  *
  * Spec: docs/specs/per-agent-resource-ledger.md.
  */
@@ -40,10 +44,25 @@ const SCHEMA = [
     `CREATE INDEX IF NOT EXISTS idx_rle_ts ON rate_limit_events (ts)`,
     `CREATE INDEX IF NOT EXISTS idx_rle_kind_ts ON rate_limit_events (kind, ts)`,
     `CREATE INDEX IF NOT EXISTS idx_rle_source_ts ON rate_limit_events (source, ts)`,
+    // Phase B: continuous CPU% + RSS samples. One row per source per sampling
+    // tick (server + each session + an aggregate). No primary key beyond rowid:
+    // a sample is a point-in-time reading, not an idempotent event — re-inserts
+    // are real data. Bounded by retention prune (pruneOlderThan).
+    `CREATE TABLE IF NOT EXISTS resource_samples (
+     ts              INTEGER NOT NULL,
+     source          TEXT    NOT NULL,
+     pid             INTEGER,
+     cpu_percent     REAL    NOT NULL DEFAULT 0,
+     rss_bytes       INTEGER NOT NULL DEFAULT 0,
+     heap_used_bytes INTEGER
+   )`,
+    `CREATE INDEX IF NOT EXISTS idx_rs_ts ON resource_samples (ts)`,
+    `CREATE INDEX IF NOT EXISTS idx_rs_source_ts ON resource_samples (source, ts)`,
 ];
 export class ResourceLedger {
     db;
     insertEvent;
+    insertSample;
     closed = false;
     constructor(opts) {
         if (opts.dbPath !== ':memory:') {
@@ -71,6 +90,9 @@ export class ResourceLedger {
         this.insertEvent = this.db.prepare(`INSERT OR IGNORE INTO rate_limit_events
          (id, ts, kind, source, account_key, session_name, reason, detail)
        VALUES (@id, @ts, @kind, @source, @accountKey, @sessionName, @reason, @detail)`);
+        this.insertSample = this.db.prepare(`INSERT INTO resource_samples
+         (ts, source, pid, cpu_percent, rss_bytes, heap_used_bytes)
+       VALUES (@ts, @source, @pid, @cpuPercent, @rssBytes, @heapUsedBytes)`);
     }
     /** Per-event identity: ts + source + seq is unique within a process; the source
      *  prefix keeps breaker and sentinel rows from ever colliding. NOT a content
@@ -150,6 +172,134 @@ export class ResourceLedger {
          LIMIT ?`)
             .all(since, limit);
     }
+    // ── Phase B: CPU + memory samples ─────────────────────────────────────────
+    /** Record one CPU/memory sample. Never throws — observability must not break
+     *  the observed path. Negative/NaN numbers are clamped so a bad reading can't
+     *  poison aggregates. */
+    record(s) {
+        if (this.closed)
+            return;
+        try {
+            this.insertSample.run({
+                ts: s.ts,
+                source: s.source,
+                pid: typeof s.pid === 'number' && Number.isFinite(s.pid) ? Math.trunc(s.pid) : null,
+                cpuPercent: ResourceLedger.clampNonNeg(s.cpuPercent),
+                rssBytes: ResourceLedger.clampNonNeg(s.rssBytes),
+                heapUsedBytes: s.heapUsedBytes == null ? null : ResourceLedger.clampNonNeg(s.heapUsedBytes),
+            });
+        }
+        catch {
+            /* swallow — never break the observed path */
+        }
+    }
+    /** Record a batch of samples in one transaction (one tick's worth). Fail-open:
+     *  a write error rolls back this batch only and is swallowed. */
+    recordSamples(samples) {
+        if (this.closed || samples.length === 0)
+            return;
+        try {
+            const txn = this.db.transaction((rows) => {
+                for (const s of rows)
+                    this.record(s);
+            });
+            txn(samples);
+        }
+        catch {
+            /* swallow */
+        }
+    }
+    static clampNonNeg(n) {
+        return Number.isFinite(n) && n > 0 ? n : 0;
+    }
+    /**
+     * Per-source CPU% + RSS rollup over the trailing window: current (latest
+     * sample), plus avg/peak across the window, plus the synthetic `aggregate`
+     * row if present. Newest-first ordering by recency of last sample.
+     */
+    summary(sinceMs) {
+        const rows = this.db
+            .prepare(`SELECT
+           source,
+           AVG(cpu_percent) AS avgCpuPercent,
+           MAX(cpu_percent) AS peakCpuPercent,
+           AVG(rss_bytes)   AS avgRssBytes,
+           MAX(rss_bytes)   AS peakRssBytes,
+           COUNT(*)         AS sampleCount,
+           MAX(ts)          AS newestTs
+         FROM resource_samples
+         WHERE ts >= ?
+         GROUP BY source
+         ORDER BY newestTs DESC`)
+            .all(sinceMs);
+        const latest = this.db.prepare(`SELECT cpu_percent AS cpuPercent, rss_bytes AS rssBytes, heap_used_bytes AS heapUsedBytes
+       FROM resource_samples
+       WHERE source = ? AND ts >= ?
+       ORDER BY ts DESC LIMIT 1`);
+        return rows.map((r) => {
+            const cur = latest.get(String(r.source), sinceMs);
+            return {
+                source: String(r.source),
+                currentCpuPercent: cur ? Number(cur.cpuPercent) : null,
+                currentRssBytes: cur ? Number(cur.rssBytes) : null,
+                currentHeapUsedBytes: cur && cur.heapUsedBytes != null ? Number(cur.heapUsedBytes) : null,
+                avgCpuPercent: +(Number(r.avgCpuPercent ?? 0)).toFixed(2),
+                peakCpuPercent: +(Number(r.peakCpuPercent ?? 0)).toFixed(2),
+                avgRssBytes: Math.round(Number(r.avgRssBytes ?? 0)),
+                peakRssBytes: Math.round(Number(r.peakRssBytes ?? 0)),
+                sampleCount: Number(r.sampleCount ?? 0),
+                newestTs: r.newestTs ?? null,
+            };
+        });
+    }
+    /** Recent raw samples, newest first (paginated). */
+    recentSamples(opts = {}) {
+        const limit = Math.min(Math.max(opts.limit ?? 100, 1), 2000);
+        const since = opts.sinceMs ?? 0;
+        if (opts.source) {
+            return this.db
+                .prepare(`SELECT ts, source, pid, cpu_percent AS cpuPercent,
+                  rss_bytes AS rssBytes, heap_used_bytes AS heapUsedBytes
+           FROM resource_samples
+           WHERE ts >= ? AND source = ?
+           ORDER BY ts DESC LIMIT ?`)
+                .all(since, opts.source, limit);
+        }
+        return this.db
+            .prepare(`SELECT ts, source, pid, cpu_percent AS cpuPercent,
+                rss_bytes AS rssBytes, heap_used_bytes AS heapUsedBytes
+         FROM resource_samples
+         WHERE ts >= ?
+         ORDER BY ts DESC LIMIT ?`)
+            .all(since, limit);
+    }
+    /** Total number of CPU/mem samples stored. */
+    sampleCount() {
+        try {
+            const row = this.db.prepare(`SELECT COUNT(*) AS n FROM resource_samples`).get();
+            return Number(row?.n ?? 0);
+        }
+        catch {
+            // @silent-fallback-ok: read-only observability count. A DB read error must
+            // never break the observed path; "unknown count" degrades to 0, not a throw.
+            return 0;
+        }
+    }
+    /** Delete samples older than `cutoffMs`. Returns rows deleted. Fail-open. */
+    pruneOlderThan(cutoffMs) {
+        if (this.closed)
+            return 0;
+        try {
+            const res = this.db.prepare(`DELETE FROM resource_samples WHERE ts < ?`).run(cutoffMs);
+            return Number(res.changes ?? 0);
+        }
+        catch {
+            // @silent-fallback-ok: retention prune is best-effort housekeeping. A failed
+            // prune just leaves older rows for the next tick; it must not throw into the
+            // sampler's hot path.
+            return 0;
+        }
+    }
     close() {
         if (this.closed)
             return;

package/dist/monitoring/ResourceLedger.js.map

@@ -1 +1 @@
-{"version":3,"file":"ResourceLedger.js","sourceRoot":"","sources":["../../src/monitoring/ResourceLedger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ResourceLedger.js","sourceRoot":"","sources":["../../src/monitoring/ResourceLedger.ts"],"names":[],"mappings":"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"}

package/dist/monitoring/ResourceSampler.d.ts

@@ -0,0 +1,63 @@
+import type { ResourceLedger } from './ResourceLedger.js';
+export interface ResourceSamplerOptions {
+    ledger: ResourceLedger;
+    /** Returns the live session pane PIDs to sample, keyed by session id. Called
+     *  each tick; an error/empty result just means "no sessions this tick". */
+    getSessionPids: () => Array<{
+        id: string;
+        pid: number;
+    }>;
+    /** Active sampling cadence (ms). Defaults to 60_000. */
+    intervalMs?: number;
+    /** Idle sampling cadence (ms) — used when getSessionPids() is empty. Default 5min. */
+    idleIntervalMs?: number;
+    /** Retention window (ms) — samples older than this are pruned each tick. Default 7d. */
+    retentionMs?: number;
+    /** Test seam: read this process's CPU usage (microseconds). Defaults to process.cpuUsage. */
+    cpuUsageFn?: (previous?: NodeJS.CpuUsage) => NodeJS.CpuUsage;
+    /** Test seam: read this process's memory. Defaults to process.memoryUsage. */
+    memoryUsageFn?: () => NodeJS.MemoryUsage;
+    /** Test seam: monotonic clock (ms). Defaults to Date.now. */
+    now?: () => number;
+    /** Test seam: sample a batch of OS pids. Defaults to a batched `ps` call. */
+    samplePidsFn?: (pids: number[]) => Promise<Map<number, {
+        cpuPercent: number;
+        rssBytes: number;
+    }>>;
+    /** Optional error sink (defaults to a single console.warn). */
+    onError?: (err: unknown) => void;
+}
+export declare class ResourceSampler {
+    private readonly ledger;
+    private readonly getSessionPids;
+    private readonly intervalMs;
+    private readonly idleIntervalMs;
+    private readonly retentionMs;
+    private readonly cpuUsageFn;
+    private readonly memoryUsageFn;
+    private readonly now;
+    private readonly samplePidsFn;
+    private readonly onError;
+    private timer;
+    private running;
+    private started;
+    private closed;
+    private lastCpu;
+    private lastCpuAtMs;
+    constructor(opts: ResourceSamplerOptions);
+    start(): void;
+    stop(): void;
+    /** Self-rescheduling timer (NOT setInterval) so the cadence can adapt to
+     *  idle/active each tick and a slow tick can't stack. unref()'d. */
+    private schedule;
+    /** Run one sampling pass. Public for tests. Never throws. */
+    tick(): Promise<void>;
+    /**
+     * CPU% for THIS process over the interval since the last tick: the
+     * (user+system) microseconds consumed divided by the wall-clock microseconds
+     * elapsed, ×100. One fully-busy core reads ~100. Returns 0 when there's no
+     * prior baseline yet (first tick) or the clock didn't advance.
+     */
+    private computeOwnCpuPercent;
+}
+//# sourceMappingURL=ResourceSampler.d.ts.map

package/dist/monitoring/ResourceSampler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceSampler.d.ts","sourceRoot":"","sources":["../../src/monitoring/ResourceSampler.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,qBAAqB,CAAC;AAE/E,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,cAAc,CAAC;IACvB;+EAC2E;IAC3E,cAAc,EAAE,MAAM,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6FAA6F;IAC7F,UAAU,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,CAAC;IAC7D,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,MAAM,CAAC,WAAW,CAAC;IACzC,6DAA6D;IAC7D,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAClG,+DAA+D;IAC/D,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CAClC;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2C;IAC1E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkD;IAC7E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2B;IACzD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAEuC;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IAEjD,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IAGvB,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,WAAW,CAAuB;gBAE9B,IAAI,EAAE,sBAAsB;IAgBxC,KAAK,IAAI,IAAI;IAiBb,IAAI,IAAI,IAAI;IAQZ;wEACoE;IACpE,OAAO,CAAC,QAAQ;IAUhB,6DAA6D;IACvD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsG3B;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;CAqB7B"}

package/dist/monitoring/ResourceSampler.js

@@ -0,0 +1,277 @@
+/**
+ * ResourceSampler — Phase B of the per-agent ResourceLedger.
+ *
+ * A background poller (mirrors TokenLedgerPoller) that, on a cadence, samples:
+ *   (a) the agent's OWN server process — CPU% via a process.cpuUsage() delta
+ *       over the tick interval, and RSS + V8 heapUsed via process.memoryUsage();
+ *   (b) the agent's spawned session processes — by their tracked pane PIDs, via
+ *       ONE batched `ps -o %cpu=,rss= -p <pid>,<pid>,...` call (tolerating dead
+ *       PIDs), so the resource tracker is itself cheap (a single child process
+ *       per tick, no per-PID fork storm);
+ * and records each plus an `aggregate` (server + all sessions) into the
+ * ResourceLedger. After recording it prunes samples beyond the retention window.
+ *
+ * Discipline (read-only observability, identical to TokenLedgerPoller):
+ *   - Strictly off the hot path. A sampling error NEVER throws or crashes — every
+ *     OS call and DB write is guarded; a failed tick just records nothing and the
+ *     next tick retries.
+ *   - It never gates, throttles, or reaches back into any runtime flow. It only
+ *     reads `ps`/`process.*` and writes the ledger.
+ *   - The timer is unref()'d so it can never keep the process alive on its own,
+ *     and backs off while the agent is idle (no running sessions) to keep the
+ *     idle CPU floor low (Responsible Resource Usage).
+ *
+ * Spec: docs/specs/per-agent-resource-ledger.md.
+ */
+import { execFile } from 'node:child_process';
+export class ResourceSampler {
+    ledger;
+    getSessionPids;
+    intervalMs;
+    idleIntervalMs;
+    retentionMs;
+    cpuUsageFn;
+    memoryUsageFn;
+    now;
+    samplePidsFn;
+    onError;
+    timer = null;
+    running = false;
+    started = false;
+    closed = false;
+    // CPU% for the OWN process is a delta: (cpuMicros now - last) / (wallMs * 1000).
+    lastCpu = null;
+    lastCpuAtMs = null;
+    constructor(opts) {
+        this.ledger = opts.ledger;
+        this.getSessionPids = opts.getSessionPids;
+        this.intervalMs = opts.intervalMs && opts.intervalMs > 0 ? opts.intervalMs : 60_000;
+        this.idleIntervalMs =
+            opts.idleIntervalMs && opts.idleIntervalMs > 0 ? opts.idleIntervalMs : 5 * 60_000;
+        this.retentionMs =
+            opts.retentionMs && opts.retentionMs > 0 ? opts.retentionMs : 7 * 24 * 60 * 60 * 1000;
+        this.cpuUsageFn = opts.cpuUsageFn ?? ((prev) => process.cpuUsage(prev));
+        this.memoryUsageFn = opts.memoryUsageFn ?? (() => process.memoryUsage());
+        this.now = opts.now ?? (() => Date.now());
+        this.samplePidsFn = opts.samplePidsFn ?? ((pids) => samplePidsViaPs(pids));
+        this.onError =
+            opts.onError ?? ((err) => console.warn('[resource-ledger] sample error:', err));
+    }
+    start() {
+        if (this.started || this.closed)
+            return;
+        this.started = true;
+        // Prime the CPU baseline so the first real tick has a delta to compare.
+        try {
+            this.lastCpu = this.cpuUsageFn();
+            this.lastCpuAtMs = this.now();
+        }
+        catch {
+            // @silent-fallback-ok: priming the CPU baseline is best-effort. If cpuUsage
+            // is unavailable we leave the baseline null so the first real tick reports
+            // 0% rather than crashing the sampler at start.
+            this.lastCpu = null;
+            this.lastCpuAtMs = null;
+        }
+        this.schedule(this.intervalMs);
+    }
+    stop() {
+        this.started = false;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+    /** Self-rescheduling timer (NOT setInterval) so the cadence can adapt to
+     *  idle/active each tick and a slow tick can't stack. unref()'d. */
+    schedule(delayMs) {
+        if (!this.started || this.closed)
+            return;
+        const t = setTimeout(() => {
+            this.timer = null;
+            void this.tick();
+        }, delayMs);
+        t.unref?.();
+        this.timer = t;
+    }
+    /** Run one sampling pass. Public for tests. Never throws. */
+    async tick() {
+        if (this.running) {
+            // A previous tick is still in flight (slow `ps`); skip and reschedule.
+            this.schedule(this.intervalMs);
+            return;
+        }
+        this.running = true;
+        let nextDelay = this.intervalMs;
+        try {
+            const ts = this.now();
+            const samples = [];
+            // (a) Own server process — CPU% from the cpuUsage delta over wall time.
+            const ownCpuPercent = this.computeOwnCpuPercent(ts);
+            let ownRss = 0;
+            let ownHeap = null;
+            try {
+                const mem = this.memoryUsageFn();
+                ownRss = mem.rss;
+                ownHeap = mem.heapUsed;
+            }
+            catch {
+                /* memoryUsage failed — record zero rather than skip the whole tick */
+            }
+            let aggCpu = ownCpuPercent;
+            let aggRss = ownRss;
+            samples.push({
+                ts,
+                source: 'agent-server',
+                pid: process.pid,
+                cpuPercent: ownCpuPercent,
+                rssBytes: ownRss,
+                heapUsedBytes: ownHeap,
+            });
+            // (b) Spawned session processes — one batched ps call for ALL pids.
+            let sessions = [];
+            try {
+                sessions = this.getSessionPids() ?? [];
+            }
+            catch {
+                sessions = [];
+            }
+            if (sessions.length > 0) {
+                const pids = sessions
+                    .map((s) => s.pid)
+                    .filter((p) => Number.isInteger(p) && p > 0);
+                let measured = new Map();
+                if (pids.length > 0) {
+                    try {
+                        measured = await this.samplePidsFn(pids);
+                    }
+                    catch {
+                        measured = new Map();
+                    }
+                }
+                for (const s of sessions) {
+                    const m = measured.get(s.pid);
+                    if (!m)
+                        continue; // dead/unmeasurable pid — tolerate, skip
+                    aggCpu += m.cpuPercent;
+                    aggRss += m.rssBytes;
+                    samples.push({
+                        ts,
+                        source: `session:${s.id}`,
+                        pid: s.pid,
+                        cpuPercent: m.cpuPercent,
+                        rssBytes: m.rssBytes,
+                        heapUsedBytes: null, // heapUsed is only knowable for our own V8
+                    });
+                }
+            }
+            else {
+                // No running sessions → idle. Back off the cadence to keep the idle
+                // CPU floor low (Responsible Resource Usage).
+                nextDelay = this.idleIntervalMs;
+            }
+            // Aggregate = server + all sampled sessions.
+            samples.push({
+                ts,
+                source: 'aggregate',
+                pid: 0,
+                cpuPercent: +aggCpu.toFixed(2),
+                rssBytes: aggRss,
+                heapUsedBytes: null,
+            });
+            this.ledger.recordSamples(samples);
+            // Bounded retention — prune off the same cadence (cheap single DELETE).
+            try {
+                this.ledger.pruneOlderThan(ts - this.retentionMs);
+            }
+            catch {
+                /* swallow */
+            }
+        }
+        catch (err) {
+            // @silent-fallback-ok: a sampling error NEVER crashes the poller — log once
+            // and keep going; the next tick retries. Observability must not break the
+            // observed path.
+            try {
+                this.onError(err);
+            }
+            catch { /* ignore */ }
+        }
+        finally {
+            this.running = false;
+            this.schedule(nextDelay);
+        }
+    }
+    /**
+     * CPU% for THIS process over the interval since the last tick: the
+     * (user+system) microseconds consumed divided by the wall-clock microseconds
+     * elapsed, ×100. One fully-busy core reads ~100. Returns 0 when there's no
+     * prior baseline yet (first tick) or the clock didn't advance.
+     */
+    computeOwnCpuPercent(nowMs) {
+        let cpu;
+        try {
+            cpu = this.cpuUsageFn();
+        }
+        catch {
+            // @silent-fallback-ok: a CPU reading we can't take degrades to 0% for this
+            // tick (read-only observability); it must never throw into the sample loop.
+            return 0;
+        }
+        const prev = this.lastCpu;
+        const prevAt = this.lastCpuAtMs;
+        this.lastCpu = cpu;
+        this.lastCpuAtMs = nowMs;
+        if (!prev || prevAt == null)
+            return 0;
+        const wallMs = nowMs - prevAt;
+        if (wallMs <= 0)
+            return 0;
+        const cpuMicros = cpu.user + cpu.system - (prev.user + prev.system);
+        const wallMicros = wallMs * 1000;
+        const pct = (cpuMicros / wallMicros) * 100;
+        return pct > 0 && Number.isFinite(pct) ? +pct.toFixed(2) : 0;
+    }
+}
+/**
+ * Batch-sample OS pids with ONE `ps` call. macOS + Linux both support
+ * `ps -o %cpu=,rss= -p <pid>[,<pid>...]`; the `=` suffix suppresses headers so
+ * the output is just rows of "<cpu> <rss>" aligned with `-p` order... except
+ * `ps` reorders by pid, so we ask for pid too and key the result map by pid.
+ * rss is reported in KiB → bytes. Dead pids are simply absent from the output
+ * (no error). Returns an empty map on any failure (fail-open).
+ */
+function samplePidsViaPs(pids) {
+    return new Promise((resolve) => {
+        const out = new Map();
+        if (pids.length === 0) {
+            resolve(out);
+            return;
+        }
+        const pidList = pids.join(',');
+        execFile('ps', ['-o', 'pid=,%cpu=,rss=', '-p', pidList], { timeout: 5000, maxBuffer: 1024 * 1024 }, (err, stdout) => {
+            // `ps` exits non-zero when ALL pids are dead; that's not an error for us.
+            if (!stdout) {
+                resolve(out);
+                return;
+            }
+            for (const line of stdout.split('\n')) {
+                const m = line.trim().match(/^(\d+)\s+([\d.]+)\s+(\d+)$/);
+                if (!m)
+                    continue;
+                const pid = Number(m[1]);
+                const cpuPercent = Number(m[2]);
+                const rssKib = Number(m[3]);
+                if (!Number.isFinite(pid))
+                    continue;
+                out.set(pid, {
+                    cpuPercent: Number.isFinite(cpuPercent) && cpuPercent > 0 ? cpuPercent : 0,
+                    rssBytes: Number.isFinite(rssKib) && rssKib > 0 ? rssKib * 1024 : 0,
+                });
+            }
+            void err; // already tolerated
+            resolve(out);
+        });
+    });
+}
+//# sourceMappingURL=ResourceSampler.js.map

package/dist/monitoring/ResourceSampler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceSampler.js","sourceRoot":"","sources":["../../src/monitoring/ResourceSampler.ts"],"names":[],"mappings":"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"}

package/dist/monitoring/SessionWatchdog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionWatchdog.d.ts","sourceRoot":"","sources":["../../src/monitoring/SessionWatchdog.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SessionWatchdog.d.ts","sourceRoot":"","sources":["../../src/monitoring/SessionWatchdog.ts"],"names":[],"mappings":"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"}

package/dist/monitoring/SessionWatchdog.js

@@ -22,6 +22,11 @@ import { evaluateThrottleSettle, RATE_LIMIT_SETTLED_CAPTURE_LINES, RATE_LIMIT_DE
 function shellExec(cmd, timeout = 5000) {
     return spawnSync('/bin/sh', ['-c', cmd], { encoding: 'utf-8', timeout }).stdout ?? '';
 }
+import { createRequire } from 'node:module';
+// ESM module: a bare CJS `require` is undefined and throws at runtime. Bind a
+// real require via createRequire so the lazy load below is genuinely ESM-legal
+// (mirrors NativeModuleHealer.ts).
+const require = createRequire(import.meta.url);
 export var EscalationLevel;
 (function (EscalationLevel) {
     EscalationLevel[EscalationLevel["Monitoring"] = 0] = "Monitoring";