botmux 3.10.0 → 3.23.1

package/dist/core/host-overload-alert.d.ts

@@ -1,232 +0,0 @@
-/**
- * Host-overload alerting: watch the machine's 15-minute load average and memory
- * pressure, and fire a single Feishu DM to the bot owner when the host crosses
- * into an overloaded state (and one more when it recovers).
- *
- * Motivation: botmux already samples load/cpu/mem for the dashboard
- * (dashboard/resource-monitor-service.ts), but that path is purely passive — it
- * only feeds charts and never warns anyone. A cold-start that misses the 15s
- * readiness window (see the "bare-shell" false-death path) usually traces back
- * to the machine being overloaded, not to a config bug. This module turns the
- * already-collected signal into an actionable heads-up.
- *
- * Design:
- *  - Pure decision function {@link evaluateOverload} maps a reading + previous
- *    state to a next state and an optional alert action. No I/O, no timers, no
- *    Node globals — trivially unit-testable.
- *  - Hysteresis: enter at `load15 > cpuCount * enterLoadRatio` (or mem/swap over
- *    their enter thresholds); only clear once BELOW a lower exit threshold so a
- *    load hovering around the line can't flap and spam the owner.
- *  - Edge-triggered: exactly one "entered" alert per overload episode and one
- *    "recovered" alert when it ends. Steady-state (still overloaded / still
- *    healthy) produces no action.
- *  - A minimum re-alert interval guards against a long episode that dips just
- *    under the exit line and back repeatedly within a short window.
- */
-export interface OverloadThresholds {
-    /** Logical CPU count used to normalise load average (os.cpus().length). */
-    cpuCount: number;
-    /** Enter overload when load15 > cpuCount * this. Default 1.5. */
-    enterLoadRatio: number;
-    /** Leave overload only when load15 <= cpuCount * this. Default 1.0. Must be <= enterLoadRatio. */
-    exitLoadRatio: number;
-    /** Enter overload when used memory fraction (0..1) >= this. Default 0.92. */
-    enterMemUsedFrac: number;
-    /** Leave overload only when used memory fraction <= this. Default 0.85. */
-    exitMemUsedFrac: number;
-    /** Enter overload when swap-used fraction (0..1) >= this. Default 0.5. 0 disables. */
-    enterSwapUsedFrac: number;
-    /** Leave overload only when swap-used fraction <= this. Default 0.25. */
-    exitSwapUsedFrac: number;
-    /**
-     * Minimum ms between two "entered" alerts. Even if the state machine leaves
-     * and re-enters overload, suppress a fresh entered-alert within this window.
-     * Default 15 min. The recovered-alert is never rate-limited (it ends noise).
-     */
-    minReAlertMs: number;
-}
-export declare const DEFAULT_OVERLOAD_THRESHOLDS: Omit<OverloadThresholds, 'cpuCount'>;
-/** Parse a finite float from a raw env string; blank/garbage/failing-`isValid`
- *  → `fallback`. `isValid` defaults to non-negative (right for exit lines +
- *  minReAlertMs, where 0 is a legal "off"/"immediate" value); the enter
- *  thresholds pass stricter predicates (load must be > 0, mem must be in (0,1])
- *  so a degenerate `enter=0` can't sneak in — at enter=0 the 95% hysteresis
- *  clamp is still 0, breaking "exit strictly below enter" and (for mem) flapping
- *  entered/recovered every tick. Shared by {@link computeOverloadThresholds} so
- *  env-override precedence is testable without a live `process.env`. */
-export declare function parseOverloadEnvFloat(raw: string | undefined, fallback: number, isValid?: (n: number) => boolean): number;
-/** Validity predicates for the two enter dimensions — exported so tests + the
- *  config/applier layers can share the exact same rule (single source of truth). */
-export declare const isValidEnterLoadRatio: (n: number) => boolean;
-export declare const isValidEnterMemUsedFrac: (n: number) => boolean;
-/**
- * Should THIS daemon sample host pressure and own the overload alert?
- *
- * The alert is machine-level: the global `hostOverloadAlert` config names ONE
- * notifier bot, and only that bot's own daemon samples + advances the state
- * machine + DMs (it runs on this host, so no cross-daemon delivery is needed).
- * Every other daemon must no-op AND reset its local state, so that when the
- * target later switches TO this bot the state machine starts clean (no stale
- * "already overloaded" edge from a previous ownership). Pure predicate over the
- * config + this daemon's identity — the reset is the caller's responsibility.
- *
- * FAIL-CLOSED on apiOnly: a core-only (apiOnly) bot has no Feishu transport, so
- * it can never DM an admin. Even if a hand-edited config or a pre-`apiOnly`-aware
- * migration names an apiOnly bot as the target, this daemon must NOT sample —
- * it would advance the state machine and then silently drop every alert. The
- * migration also excludes apiOnly candidates; this is the runtime backstop for
- * configs that bypass it.
- *
- * @param alertCfg the global `hostOverloadAlert` block (or {} when unset).
- * @param self this daemon's identity: `larkAppId` + whether it's apiOnly.
- */
-export declare function isOverloadAlertTarget(alertCfg: {
-    enabled?: boolean;
-    targetBotAppId?: string;
-} | undefined, self: {
-    larkAppId: string;
-    apiOnly?: boolean;
-} | string): boolean;
-/** Raw inputs for {@link computeOverloadThresholds}: the host CPU count, the
- *  operator's enter thresholds from global config (already-parsed numbers or
- *  undefined), and the relevant `BOTMUX_OVERLOAD_*` env strings. Kept as plain
- *  data so the priority + hysteresis logic is pure and unit-testable. */
-export interface OverloadThresholdInputs {
-    cpuCount: number;
-    configEnterLoadRatio?: number;
-    configEnterMemUsedFrac?: number;
-    env?: {
-        enterLoadRatio?: string;
-        exitLoadRatio?: string;
-        enterMemUsedFrac?: string;
-        exitMemUsedFrac?: string;
-        minReAlertMs?: string;
-    };
-    /** Optional sink for the hysteresis-clamp warning (daemon passes logger.warn). */
-    warn?: (message: string) => void;
-}
-/**
- * Resolve the effective {@link OverloadThresholds} from env > global config >
- * built-in default for the ENTER lines, deriving the EXIT lines with hysteresis.
- *
- * Precedence (enter load/mem): a valid `BOTMUX_OVERLOAD_ENTER_*` env wins; else
- * a sane positive config value; else the built-in default. Config values are
- * re-validated defensively here (finite, positive, mem ≤ 1) so a bad persisted
- * value can't leak past the resolver.
- *
- * Hysteresis: the recover (exit) line MUST sit strictly below the enter line, or
- * a reading pinned at the threshold flaps entered/recovered every tick (enter
- * uses `>=`, recover uses `<=`). If a misconfigured exit ≥ enter, clamp it to
- * 95% of enter and warn. Swap thresholds + minReAlertMs pass through (env or
- * default). Pure: no `os`, no `process.env`, no clock.
- */
-export declare function computeOverloadThresholds(inputs: OverloadThresholdInputs): OverloadThresholds;
-/** A single sampled reading of host pressure. */
-export interface HostReading {
-    /** 15-minute load average (os.loadavg()[2]). */
-    load15: number;
-    /** Total physical memory in bytes (os.totalmem()). */
-    memTotalBytes: number;
-    /** Free physical memory in bytes (os.freemem()). */
-    memFreeBytes: number;
-    /**
-     * Swap total/used in bytes, if known. macOS/Node has no built-in swap read;
-     * pass undefined to skip the swap dimension entirely.
-     */
-    swapTotalBytes?: number;
-    swapUsedBytes?: number;
-}
-/** Which dimension(s) tripped the enter threshold — used for the alert copy. */
-export type OverloadReason = 'load' | 'memory' | 'swap';
-export interface OverloadState {
-    overloaded: boolean;
-    /** ms timestamp of the last "entered" alert we emitted (0 = never). */
-    lastEnteredAlertAt: number;
-}
-export declare const INITIAL_OVERLOAD_STATE: OverloadState;
-export interface OverloadAlertAction {
-    kind: 'entered' | 'recovered';
-    reasons: OverloadReason[];
-    reading: HostReading;
-    /** Derived, human-friendly numbers for the alert copy. */
-    metrics: {
-        load15: number;
-        loadPerCpu: number;
-        cpuCount: number;
-        memUsedFrac: number;
-        swapUsedFrac: number | undefined;
-    };
-}
-export interface OverloadEvaluation {
-    nextState: OverloadState;
-    /** Present only on a state edge that should notify the owner. */
-    action?: OverloadAlertAction;
-}
-/**
- * Core state-machine step. Given the previous state, the current reading and
- * thresholds (plus `now` for rate-limiting), return the next state and, on a
- * notable edge, the alert action to deliver.
- *
- * Transitions:
- *  - healthy → overloaded: any enter reason trips. Emit `entered` UNLESS a prior
- *    entered-alert fired within `minReAlertMs` (then flip state silently).
- *  - overloaded → healthy: only once `fullyRecovered` (all dims under exit bar).
- *    Always emit `recovered`.
- *  - no change: no action.
- */
-export declare function evaluateOverload(prev: OverloadState, reading: HostReading, thresholds: OverloadThresholds, now: number): OverloadEvaluation;
-/** Build the Feishu text body for an alert action. Kept here so it's testable. */
-export declare function formatOverloadAlert(action: OverloadAlertAction, hostLabel?: string): string;
-/** action.value.action strings emitted by the alert card buttons; the daemon's
- *  card handler matches on these. Exported so the handler and tests share the
- *  exact literals (typo-proof). */
-export declare const OVERLOAD_ACTION_CLEAN_STOPPED = "overload_clean_stopped";
-export declare const OVERLOAD_ACTION_SUSPEND_IDLE = "overload_suspend_idle";
-/** Fail-safe action on a disabled (already-run) button — clients that don't
- *  suppress disabled callbacks just get a harmless toast, no side effect. */
-export declare const OVERLOAD_ACTION_NOOP = "overload_noop";
-/**
- * Per-button state carried on the card so any daemon can rebuild it after a
- * click without external storage. `done`/`n` record whether an action already
- * ran and how many sessions it affected (−1 = not yet run). Counts are the
- * machine-wide candidate totals shown in the button labels before clicking.
- */
-export interface OverloadCardState {
-    nonce: string;
-    /** metrics for the summary line (kept compact). */
-    load15: number;
-    cpu: number;
-    mem: number;
-    swap?: number;
-    reasons: OverloadReason[];
-    /** machine-wide candidate counts (refreshed on every rebuild). */
-    stopped: number;
-    idle: number;
-    /** result of each action once run; -1 = not run yet. */
-    cleanedN: number;
-    suspendedN: number;
-}
-/** Seed initial card state from an `entered` action + counts + nonce. */
-export declare function initialOverloadCardState(action: OverloadAlertAction, counts: {
-    stopped: number;
-    idle: number;
-}, nonce: string): OverloadCardState;
-/**
- * Build the interactive Feishu overload card from card state (returns a JSON
- * string). This one builder renders BOTH the initial alert and every post-click
- * rebuild: it always shows two buttons so clicking one never removes the other.
- *
- *  - Not-yet-run button → live callback, label shows the candidate count
- *    (「🧹 清僵尸会话 (N)」). Carries the full `st` so the handler can rebuild.
- *  - Already-run button → disabled + a `✓ 已清理 X 个` label (with a `noop`
- *    fail-safe action for clients that don't suppress disabled callbacks).
- *
- * Each button also carries its own nonce claim (one-shot per action), so the
- * owner can click both buttons on one card, but neither twice.
- */
-export declare function buildOverloadAlertCard(st: OverloadCardState, hostLabel?: string): string;
-/** Display-only card for the `recovered` edge (no buttons). */
-export declare function buildOverloadRecoveredCard(action: OverloadAlertAction, hostLabel?: string): string;
-/** Grey "this alert card has expired" card (daemon restart lost the nonce, etc.). */
-export declare function buildOverloadExpiredCard(detail?: string): string;
-//# sourceMappingURL=host-overload-alert.d.ts.map

package/dist/core/host-overload-alert.d.ts.map

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

package/dist/core/host-overload-alert.js

@@ -1,354 +0,0 @@
-/**
- * Host-overload alerting: watch the machine's 15-minute load average and memory
- * pressure, and fire a single Feishu DM to the bot owner when the host crosses
- * into an overloaded state (and one more when it recovers).
- *
- * Motivation: botmux already samples load/cpu/mem for the dashboard
- * (dashboard/resource-monitor-service.ts), but that path is purely passive — it
- * only feeds charts and never warns anyone. A cold-start that misses the 15s
- * readiness window (see the "bare-shell" false-death path) usually traces back
- * to the machine being overloaded, not to a config bug. This module turns the
- * already-collected signal into an actionable heads-up.
- *
- * Design:
- *  - Pure decision function {@link evaluateOverload} maps a reading + previous
- *    state to a next state and an optional alert action. No I/O, no timers, no
- *    Node globals — trivially unit-testable.
- *  - Hysteresis: enter at `load15 > cpuCount * enterLoadRatio` (or mem/swap over
- *    their enter thresholds); only clear once BELOW a lower exit threshold so a
- *    load hovering around the line can't flap and spam the owner.
- *  - Edge-triggered: exactly one "entered" alert per overload episode and one
- *    "recovered" alert when it ends. Steady-state (still overloaded / still
- *    healthy) produces no action.
- *  - A minimum re-alert interval guards against a long episode that dips just
- *    under the exit line and back repeatedly within a short window.
- */
-export const DEFAULT_OVERLOAD_THRESHOLDS = {
-    enterLoadRatio: 1.5,
-    exitLoadRatio: 1.0,
-    enterMemUsedFrac: 0.92,
-    exitMemUsedFrac: 0.85,
-    enterSwapUsedFrac: 0.5,
-    exitSwapUsedFrac: 0.25,
-    minReAlertMs: 15 * 60_000,
-};
-/** Parse a finite float from a raw env string; blank/garbage/failing-`isValid`
- *  → `fallback`. `isValid` defaults to non-negative (right for exit lines +
- *  minReAlertMs, where 0 is a legal "off"/"immediate" value); the enter
- *  thresholds pass stricter predicates (load must be > 0, mem must be in (0,1])
- *  so a degenerate `enter=0` can't sneak in — at enter=0 the 95% hysteresis
- *  clamp is still 0, breaking "exit strictly below enter" and (for mem) flapping
- *  entered/recovered every tick. Shared by {@link computeOverloadThresholds} so
- *  env-override precedence is testable without a live `process.env`. */
-export function parseOverloadEnvFloat(raw, fallback, isValid = (n) => n >= 0) {
-    if (raw === undefined || raw.trim() === '')
-        return fallback;
-    const n = Number(raw);
-    return Number.isFinite(n) && isValid(n) ? n : fallback;
-}
-/** Validity predicates for the two enter dimensions — exported so tests + the
- *  config/applier layers can share the exact same rule (single source of truth). */
-export const isValidEnterLoadRatio = (n) => Number.isFinite(n) && n > 0;
-export const isValidEnterMemUsedFrac = (n) => Number.isFinite(n) && n > 0 && n <= 1;
-/**
- * Should THIS daemon sample host pressure and own the overload alert?
- *
- * The alert is machine-level: the global `hostOverloadAlert` config names ONE
- * notifier bot, and only that bot's own daemon samples + advances the state
- * machine + DMs (it runs on this host, so no cross-daemon delivery is needed).
- * Every other daemon must no-op AND reset its local state, so that when the
- * target later switches TO this bot the state machine starts clean (no stale
- * "already overloaded" edge from a previous ownership). Pure predicate over the
- * config + this daemon's identity — the reset is the caller's responsibility.
- *
- * FAIL-CLOSED on apiOnly: a core-only (apiOnly) bot has no Feishu transport, so
- * it can never DM an admin. Even if a hand-edited config or a pre-`apiOnly`-aware
- * migration names an apiOnly bot as the target, this daemon must NOT sample —
- * it would advance the state machine and then silently drop every alert. The
- * migration also excludes apiOnly candidates; this is the runtime backstop for
- * configs that bypass it.
- *
- * @param alertCfg the global `hostOverloadAlert` block (or {} when unset).
- * @param self this daemon's identity: `larkAppId` + whether it's apiOnly.
- */
-export function isOverloadAlertTarget(alertCfg, self) {
-    if (!alertCfg)
-        return false;
-    const selfAppId = typeof self === 'string' ? self : self.larkAppId;
-    const selfApiOnly = typeof self === 'string' ? false : self.apiOnly === true;
-    if (selfApiOnly)
-        return false; // apiOnly bots can't deliver a DM — never sample.
-    return alertCfg.enabled === true
-        && typeof alertCfg.targetBotAppId === 'string'
-        && alertCfg.targetBotAppId === selfAppId;
-}
-/**
- * Resolve the effective {@link OverloadThresholds} from env > global config >
- * built-in default for the ENTER lines, deriving the EXIT lines with hysteresis.
- *
- * Precedence (enter load/mem): a valid `BOTMUX_OVERLOAD_ENTER_*` env wins; else
- * a sane positive config value; else the built-in default. Config values are
- * re-validated defensively here (finite, positive, mem ≤ 1) so a bad persisted
- * value can't leak past the resolver.
- *
- * Hysteresis: the recover (exit) line MUST sit strictly below the enter line, or
- * a reading pinned at the threshold flaps entered/recovered every tick (enter
- * uses `>=`, recover uses `<=`). If a misconfigured exit ≥ enter, clamp it to
- * 95% of enter and warn. Swap thresholds + minReAlertMs pass through (env or
- * default). Pure: no `os`, no `process.env`, no clock.
- */
-export function computeOverloadThresholds(inputs) {
-    const cpuCount = Math.max(1, inputs.cpuCount || 1);
-    const env = inputs.env ?? {};
-    // Config enter values are re-validated with the SAME per-dimension predicates
-    // as env (load > 0, mem in (0,1]) so a bad persisted value falls through to
-    // the built-in default instead of poisoning the derived exit line.
-    const cfgEnterLoad = typeof inputs.configEnterLoadRatio === 'number' && isValidEnterLoadRatio(inputs.configEnterLoadRatio)
-        ? inputs.configEnterLoadRatio : DEFAULT_OVERLOAD_THRESHOLDS.enterLoadRatio;
-    const cfgEnterMem = typeof inputs.configEnterMemUsedFrac === 'number' && isValidEnterMemUsedFrac(inputs.configEnterMemUsedFrac)
-        ? inputs.configEnterMemUsedFrac : DEFAULT_OVERLOAD_THRESHOLDS.enterMemUsedFrac;
-    // Enter thresholds: env wins, but only if it passes the strict predicate;
-    // otherwise fall back to the (already-validated) config/default value.
-    const enterLoadRatio = parseOverloadEnvFloat(env.enterLoadRatio, cfgEnterLoad, isValidEnterLoadRatio);
-    let exitLoadRatio = parseOverloadEnvFloat(env.exitLoadRatio, DEFAULT_OVERLOAD_THRESHOLDS.exitLoadRatio);
-    const enterMemUsedFrac = parseOverloadEnvFloat(env.enterMemUsedFrac, cfgEnterMem, isValidEnterMemUsedFrac);
-    let exitMemUsedFrac = parseOverloadEnvFloat(env.exitMemUsedFrac, DEFAULT_OVERLOAD_THRESHOLDS.exitMemUsedFrac);
-    const HYSTERESIS_MARGIN = 0.95; // exit = 95% of enter when misconfigured
-    if (exitLoadRatio >= enterLoadRatio) {
-        const clamped = enterLoadRatio * HYSTERESIS_MARGIN;
-        inputs.warn?.(`[overload] BOTMUX_OVERLOAD_EXIT_LOAD_RATIO (${exitLoadRatio}) >= ENTER (${enterLoadRatio}); clamping exit to ${clamped}`);
-        exitLoadRatio = clamped;
-    }
-    if (exitMemUsedFrac >= enterMemUsedFrac) {
-        const clamped = enterMemUsedFrac * HYSTERESIS_MARGIN;
-        inputs.warn?.(`[overload] BOTMUX_OVERLOAD_EXIT_MEM_FRAC (${exitMemUsedFrac}) >= ENTER (${enterMemUsedFrac}); clamping exit to ${clamped}`);
-        exitMemUsedFrac = clamped;
-    }
-    return {
-        cpuCount,
-        enterLoadRatio,
-        exitLoadRatio,
-        enterMemUsedFrac,
-        exitMemUsedFrac,
-        enterSwapUsedFrac: DEFAULT_OVERLOAD_THRESHOLDS.enterSwapUsedFrac,
-        exitSwapUsedFrac: DEFAULT_OVERLOAD_THRESHOLDS.exitSwapUsedFrac,
-        minReAlertMs: parseOverloadEnvFloat(env.minReAlertMs, DEFAULT_OVERLOAD_THRESHOLDS.minReAlertMs),
-    };
-}
-export const INITIAL_OVERLOAD_STATE = { overloaded: false, lastEnteredAlertAt: 0 };
-function memUsedFrac(reading) {
-    if (reading.memTotalBytes <= 0)
-        return 0;
-    const used = reading.memTotalBytes - reading.memFreeBytes;
-    return Math.max(0, Math.min(1, used / reading.memTotalBytes));
-}
-function swapUsedFrac(reading) {
-    if (reading.swapTotalBytes === undefined || reading.swapUsedBytes === undefined)
-        return undefined;
-    if (reading.swapTotalBytes <= 0)
-        return 0;
-    return Math.max(0, Math.min(1, reading.swapUsedBytes / reading.swapTotalBytes));
-}
-/**
- * Which dimensions are over their ENTER thresholds right now. Non-empty ⇒ the
- * reading looks overloaded (used to trip a healthy→overloaded transition).
- */
-function enterReasons(reading, t) {
-    const reasons = [];
-    if (t.cpuCount > 0 && reading.load15 > t.cpuCount * t.enterLoadRatio)
-        reasons.push('load');
-    if (memUsedFrac(reading) >= t.enterMemUsedFrac)
-        reasons.push('memory');
-    const swap = swapUsedFrac(reading);
-    if (t.enterSwapUsedFrac > 0 && swap !== undefined && swap >= t.enterSwapUsedFrac)
-        reasons.push('swap');
-    return reasons;
-}
-/**
- * True when EVERY dimension has fallen back under its EXIT threshold — i.e. the
- * host is comfortably healthy again. Requiring all dimensions to clear (with a
- * lower exit bar than the enter bar) is the hysteresis that prevents flapping.
- */
-function fullyRecovered(reading, t) {
-    const loadOk = t.cpuCount <= 0 || reading.load15 <= t.cpuCount * t.exitLoadRatio;
-    const memOk = memUsedFrac(reading) <= t.exitMemUsedFrac;
-    const swap = swapUsedFrac(reading);
-    const swapOk = t.enterSwapUsedFrac <= 0 || swap === undefined || swap <= t.exitSwapUsedFrac;
-    return loadOk && memOk && swapOk;
-}
-function metricsFor(reading, t) {
-    return {
-        load15: reading.load15,
-        loadPerCpu: t.cpuCount > 0 ? reading.load15 / t.cpuCount : 0,
-        cpuCount: t.cpuCount,
-        memUsedFrac: memUsedFrac(reading),
-        swapUsedFrac: swapUsedFrac(reading),
-    };
-}
-/**
- * Core state-machine step. Given the previous state, the current reading and
- * thresholds (plus `now` for rate-limiting), return the next state and, on a
- * notable edge, the alert action to deliver.
- *
- * Transitions:
- *  - healthy → overloaded: any enter reason trips. Emit `entered` UNLESS a prior
- *    entered-alert fired within `minReAlertMs` (then flip state silently).
- *  - overloaded → healthy: only once `fullyRecovered` (all dims under exit bar).
- *    Always emit `recovered`.
- *  - no change: no action.
- */
-export function evaluateOverload(prev, reading, thresholds, now) {
-    const reasons = enterReasons(reading, thresholds);
-    if (!prev.overloaded) {
-        if (reasons.length === 0)
-            return { nextState: prev };
-        // healthy → overloaded edge.
-        const suppressed = now - prev.lastEnteredAlertAt < thresholds.minReAlertMs && prev.lastEnteredAlertAt > 0;
-        const nextState = {
-            overloaded: true,
-            lastEnteredAlertAt: suppressed ? prev.lastEnteredAlertAt : now,
-        };
-        if (suppressed)
-            return { nextState };
-        return {
-            nextState,
-            action: { kind: 'entered', reasons, reading, metrics: metricsFor(reading, thresholds) },
-        };
-    }
-    // Currently overloaded: stay until fully recovered.
-    if (!fullyRecovered(reading, thresholds))
-        return { nextState: prev };
-    // overloaded → healthy edge; always announce recovery.
-    return {
-        nextState: { overloaded: false, lastEnteredAlertAt: prev.lastEnteredAlertAt },
-        action: {
-            kind: 'recovered',
-            // On recovery the reasons list is whatever was still elevated at the last
-            // sample; report the (now-cleared) dimensions best-effort as empty.
-            reasons: [],
-            reading,
-            metrics: metricsFor(reading, thresholds),
-        },
-    };
-}
-const REASON_LABEL = {
-    load: 'CPU 负载',
-    memory: '内存',
-    swap: 'Swap',
-};
-/** Build the Feishu text body for an alert action. Kept here so it's testable. */
-export function formatOverloadAlert(action, hostLabel) {
-    const m = action.metrics;
-    const host = hostLabel ? `（${hostLabel}）` : '';
-    const load = `load15 ${m.load15.toFixed(1)} / ${m.cpuCount} 核 = 每核 ${m.loadPerCpu.toFixed(2)}`;
-    const mem = `内存已用 ${(m.memUsedFrac * 100).toFixed(0)}%`;
-    const swap = m.swapUsedFrac === undefined ? '' : ` · Swap ${(m.swapUsedFrac * 100).toFixed(0)}%`;
-    if (action.kind === 'recovered') {
-        return `✅ 机器负载已恢复${host}\n${load} · ${mem}${swap}\n（botmux 会话可以正常冷启动了）`;
-    }
-    const why = action.reasons.map(r => REASON_LABEL[r]).join(' + ') || '资源';
-    return (`⚠️ 机器过载告警${host}\n` +
-        `触发维度：${why}\n` +
-        `${load} · ${mem}${swap}\n` +
-        `此时 botmux 会话冷启动可能超时假死。建议：\`botmux delete stopped\` 清僵尸、挂起闲置会话、或调低各 bot 的 maxLiveWorkers。`);
-}
-/** action.value.action strings emitted by the alert card buttons; the daemon's
- *  card handler matches on these. Exported so the handler and tests share the
- *  exact literals (typo-proof). */
-export const OVERLOAD_ACTION_CLEAN_STOPPED = 'overload_clean_stopped';
-export const OVERLOAD_ACTION_SUSPEND_IDLE = 'overload_suspend_idle';
-/** Fail-safe action on a disabled (already-run) button — clients that don't
- *  suppress disabled callbacks just get a harmless toast, no side effect. */
-export const OVERLOAD_ACTION_NOOP = 'overload_noop';
-/** One-line metrics summary reused by both the text and card renderers. */
-function metricsLine(m) {
-    const load = `load15 ${m.load15.toFixed(1)} / ${m.cpuCount} 核 = 每核 ${m.loadPerCpu.toFixed(2)}`;
-    const mem = `内存已用 ${(m.memUsedFrac * 100).toFixed(0)}%`;
-    const swap = m.swapUsedFrac === undefined ? '' : ` · Swap ${(m.swapUsedFrac * 100).toFixed(0)}%`;
-    return `${load} · ${mem}${swap}`;
-}
-/** Build the machine-wide summary/metrics line from card state. */
-function stateMetricsLine(st) {
-    const load = `load15 ${st.load15.toFixed(1)} / ${st.cpu} 核 = 每核 ${(st.cpu > 0 ? st.load15 / st.cpu : 0).toFixed(2)}`;
-    const mem = `内存已用 ${(st.mem * 100).toFixed(0)}%`;
-    const swap = st.swap === undefined ? '' : ` · Swap ${(st.swap * 100).toFixed(0)}%`;
-    return `${load} · ${mem}${swap}`;
-}
-/** Seed initial card state from an `entered` action + counts + nonce. */
-export function initialOverloadCardState(action, counts, nonce) {
-    return {
-        nonce,
-        load15: action.metrics.load15,
-        cpu: action.metrics.cpuCount,
-        mem: action.metrics.memUsedFrac,
-        ...(action.metrics.swapUsedFrac === undefined ? {} : { swap: action.metrics.swapUsedFrac }),
-        reasons: action.reasons,
-        stopped: counts.stopped,
-        idle: counts.idle,
-        cleanedN: -1,
-        suspendedN: -1,
-    };
-}
-/**
- * Build the interactive Feishu overload card from card state (returns a JSON
- * string). This one builder renders BOTH the initial alert and every post-click
- * rebuild: it always shows two buttons so clicking one never removes the other.
- *
- *  - Not-yet-run button → live callback, label shows the candidate count
- *    (「🧹 清僵尸会话 (N)」). Carries the full `st` so the handler can rebuild.
- *  - Already-run button → disabled + a `✓ 已清理 X 个` label (with a `noop`
- *    fail-safe action for clients that don't suppress disabled callbacks).
- *
- * Each button also carries its own nonce claim (one-shot per action), so the
- * owner can click both buttons on one card, but neither twice.
- */
-export function buildOverloadAlertCard(st, hostLabel) {
-    const host = hostLabel ? `（${hostLabel}）` : '';
-    const why = st.reasons.map(r => REASON_LABEL[r]).join(' + ') || '资源';
-    const cleanBtn = st.cleanedN >= 0
-        ? { tag: 'button', type: 'default', disabled: true,
-            text: { tag: 'plain_text', content: `✓ 已清理 ${st.cleanedN} 个僵尸` },
-            value: { action: OVERLOAD_ACTION_NOOP } }
-        : { tag: 'button', type: 'primary',
-            text: { tag: 'plain_text', content: `🧹 清僵尸会话 (${st.stopped})` },
-            value: { action: OVERLOAD_ACTION_CLEAN_STOPPED, st: JSON.stringify(st) } };
-    const suspendBtn = st.suspendedN >= 0
-        ? { tag: 'button', type: 'default', disabled: true,
-            text: { tag: 'plain_text', content: `✓ 已挂起 ${st.suspendedN} 个闲置` },
-            value: { action: OVERLOAD_ACTION_NOOP } }
-        : { tag: 'button', type: 'default',
-            text: { tag: 'plain_text', content: `💤 挂起闲置会话 (${st.idle})` },
-            value: { action: OVERLOAD_ACTION_SUSPEND_IDLE, st: JSON.stringify(st) } };
-    return JSON.stringify({
-        config: { wide_screen_mode: true },
-        header: { template: 'red', title: { tag: 'plain_text', content: `⚠️ 机器过载告警${host}` } },
-        elements: [
-            { tag: 'div', text: { tag: 'lark_md', content: `**触发维度：**${why}\n${stateMetricsLine(st)}` } },
-            { tag: 'div', text: { tag: 'lark_md', content: `当前可降压：**僵尸会话 ${st.stopped} 个** · **闲置会话 ${st.idle} 个**` } },
-            { tag: 'hr' },
-            { tag: 'action', actions: [cleanBtn, suspendBtn] },
-            { tag: 'note', elements: [{ tag: 'lark_md', content: '清僵尸=关闭进程已退出的僵尸会话；挂起闲置=挂起空闲可恢复会话（下条消息冷恢复）。仅管理员可操作，每个按钮可点一次。' }] },
-        ],
-    });
-}
-/** Display-only card for the `recovered` edge (no buttons). */
-export function buildOverloadRecoveredCard(action, hostLabel) {
-    const host = hostLabel ? `（${hostLabel}）` : '';
-    return JSON.stringify({
-        config: { wide_screen_mode: true },
-        header: { template: 'green', title: { tag: 'plain_text', content: `✅ 机器负载已恢复${host}` } },
-        elements: [
-            { tag: 'div', text: { tag: 'lark_md', content: metricsLine(action.metrics) } },
-            { tag: 'note', elements: [{ tag: 'lark_md', content: 'botmux 会话可以正常冷启动了。' }] },
-        ],
-    });
-}
-/** Grey "this alert card has expired" card (daemon restart lost the nonce, etc.). */
-export function buildOverloadExpiredCard(detail = '') {
-    return JSON.stringify({
-        config: { wide_screen_mode: true },
-        header: { template: 'grey', title: { tag: 'plain_text', content: '⏳ 操作已失效' } },
-        elements: [{ tag: 'div', text: { tag: 'lark_md', content: detail || '这张告警卡已过期（daemon 重启或超时）。等待下一次告警即可。' } }],
-    });
-}
-//# sourceMappingURL=host-overload-alert.js.map

package/dist/core/host-overload-alert.js.map

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

package/dist/core/idle-worker-sweeper.d.ts

@@ -1,39 +0,0 @@
-import type { DaemonSession } from './types.js';
-/**
- * Default per-bot live-session cap applied when a bot has no explicit
- * `maxLiveWorkers` configured. Keeps memory bounded out of the box: beyond this
- * many live sessions, the least-recently-used ones are suspended (CLI freed,
- * cold-resumes from transcript on the next message). A bot can override it from
- * the dashboard. NOTE: the dashboard help copy hardcodes this number
- * ('botDefaults.maxLiveWorkers*' i18n) — keep them in sync.
- */
-export declare const DEFAULT_MAX_LIVE_WORKERS = 30;
-export interface IdleWorkerSweepOptions {
-    /**
-     * Explicit per-bot cap for THIS bot (one daemon = one bot, so the whole
-     * `activeSessions` map belongs to a single bot). `undefined` (bot unset) →
-     * fall back to {@link DEFAULT_MAX_LIVE_WORKERS}. `≤0` → no cap (escape hatch:
-     * never suspend).
-     */
-    maxLiveWorkers?: number;
-}
-export interface IdleWorkerSweepResult {
-    sessionId: string;
-    reason: string;
-}
-/**
- * Count-based live-worker cap. When this bot has more live workers than its
- * configured `maxLiveWorkers`, suspend its longest-idle (by lastMessageAt),
- * not-currently-busy, resumable-backend sessions down to the cap. The CLI keeps
- * running detached; the next message / terminal open re-forks the worker
- * (daemon.ts worker-null resume path).
- *
- * Deliberately has NO idle-time threshold: the policy is "while resources
- * allow, never time out an old session" — suspension only kicks in to enforce
- * an explicit per-bot count cap. The only guard kept is correctness, not a
- * timeout: a session that is mid-turn (`lastScreenStatus !== 'idle'`) is never
- * suspended so an in-flight reply is never interrupted. If every over-cap
- * session is busy, none are suspended this round and the next sweep retries.
- */
-export declare function sweepIdleWorkers(activeSessions: Map<string, DaemonSession>, opts?: IdleWorkerSweepOptions): IdleWorkerSweepResult[];
-//# sourceMappingURL=idle-worker-sweeper.d.ts.map