@spinabot/brigade 0.1.1 → 1.0.0

package/dist/agents/heartbeat-scheduler.js

@@ -0,0 +1,366 @@
+/**
+ * Per-agent heartbeat interval scheduler.
+ *
+ * Brigade-native analogue of upstream's wall-clock heartbeat scheduler.
+ * Reads `cfg.agents.<id>.heartbeat.intervalMs` (and the `defaults` fallback)
+ * to build a `Map<agentId, AgentSchedule>` of agents that opt into
+ * periodic heartbeats. On each tick the scheduler invokes the supplied
+ * `onInterval(agentId)` callback for every agent whose `nextDueMs` has
+ * elapsed; the callback is expected to call into Step 13's
+ * `requestHeartbeatNow(...)` which the runner picks up.
+ *
+ * Phase offsets are deterministic per agent (SHA-256 of a fixed seed +
+ * the agent id, mod intervalMs) so a Brigade restart resumes its agents
+ * on the same phase rather than thundering at the same instant. The
+ * seed defaults to a stable string; tests can override via
+ * `BRIGADE_HEARTBEAT_SEED` env to nail down phase positions.
+ *
+ * Lifecycle:
+ *
+ *   const sched = createHeartbeatScheduler({ onInterval });
+ *   sched.updateConfig(cfg);     // seed the per-agent map
+ *   sched.start();               // arm the wall-clock timer
+ *   // ... gateway runs ...
+ *   sched.stop();                // clear the timer
+ *
+ * Hot config reload is supported: `updateConfig(cfg)` recomputes the
+ * agent map. Agents whose interval changed get a new `nextDueMs`;
+ * agents whose interval stayed the same keep their existing schedule
+ * so the phase doesn't reset.
+ */
+import { createHash } from "node:crypto";
+import { createSubsystemLogger } from "../logging/subsystem-logger.js";
+import { resolveGlobalSingleton } from "../shared/global-singleton.js";
+import { buildBrigadeMainSessionKey } from "./routing/session-key.js";
+const log = createSubsystemLogger("agents/heartbeat-scheduler");
+const SCHEDULER_STATE_KEY = Symbol.for("brigade.heartbeatScheduler.state");
+function createState() {
+    return { agents: new Map(), timer: null, stopped: false };
+}
+function getState() {
+    return resolveGlobalSingleton(SCHEDULER_STATE_KEY, createState);
+}
+function resolvePhaseMs(agentId, intervalMs) {
+    const seed = process.env.BRIGADE_HEARTBEAT_SEED?.trim() || "brigade";
+    const digest = createHash("sha256").update(`${seed}:${agentId}`).digest();
+    return digest.readUInt32BE(0) % Math.max(1, intervalMs);
+}
+function computeNextDueMs(now, intervalMs, phaseMs) {
+    const offsetIntoCycle = (now - phaseMs) % intervalMs;
+    const delta = offsetIntoCycle <= 0 ? -offsetIntoCycle : intervalMs - offsetIntoCycle;
+    return now + (delta || intervalMs);
+}
+/**
+ * Parse an "HH:MM" string into minutes-since-midnight. Returns `null` on
+ * anything malformed (the scheduler skips quiet-hours config that doesn't
+ * parse — fail-open rather than refusing to fire).
+ */
+function parseHHMM(value) {
+    if (typeof value !== "string")
+        return null;
+    const match = /^([0-2]?\d):([0-5]\d)$/.exec(value.trim());
+    if (!match)
+        return null;
+    const hours = Number.parseInt(match[1] ?? "", 10);
+    const minutes = Number.parseInt(match[2] ?? "", 10);
+    if (!Number.isFinite(hours) || hours < 0 || hours > 23)
+        return null;
+    if (!Number.isFinite(minutes) || minutes < 0 || minutes > 59)
+        return null;
+    return hours * 60 + minutes;
+}
+/**
+ * Minutes-since-midnight for `nowMs` in the supplied IANA timezone (or
+ * system-local when `timezone` is undefined). Used by quiet-hours to
+ * decide whether the agent is currently inside its do-not-disturb window.
+ *
+ * Intl.DateTimeFormat does the heavy lifting — TZ-aware without pulling
+ * a heavy library. Falls back to local when the timezone arg is invalid.
+ */
+function minutesSinceMidnightInTz(nowMs, timezone) {
+    const date = new Date(nowMs);
+    const options = {
+        hour12: false,
+        hour: "2-digit",
+        minute: "2-digit",
+    };
+    if (timezone)
+        options.timeZone = timezone;
+    let parts;
+    try {
+        parts = new Intl.DateTimeFormat("en-US", options).formatToParts(date);
+    }
+    catch {
+        // Bad TZ string — drop back to system-local. The operator still gets
+        // quiet hours; they just don't get TZ-shifted ones.
+        parts = new Intl.DateTimeFormat("en-US", {
+            hour12: false,
+            hour: "2-digit",
+            minute: "2-digit",
+        }).formatToParts(date);
+    }
+    const hour = parts.find((p) => p.type === "hour")?.value ?? "00";
+    const minute = parts.find((p) => p.type === "minute")?.value ?? "00";
+    // Intl returns "24" at midnight on some engines — normalise to 0.
+    const hoursNum = Number.parseInt(hour, 10);
+    const minutesNum = Number.parseInt(minute, 10);
+    const safeHours = Number.isFinite(hoursNum) ? hoursNum % 24 : 0;
+    const safeMinutes = Number.isFinite(minutesNum) ? minutesNum : 0;
+    return safeHours * 60 + safeMinutes;
+}
+/**
+ * `true` when `nowMs` falls inside the quiet window. Windows that wrap
+ * midnight (start > end, e.g. "22:00" → "07:00") are handled — both halves
+ * count as quiet.
+ */
+function isInQuietWindow(nowMs, window) {
+    const current = minutesSinceMidnightInTz(nowMs, window.timezone);
+    if (window.startMinutes === window.endMinutes)
+        return false;
+    if (window.startMinutes < window.endMinutes) {
+        return current >= window.startMinutes && current < window.endMinutes;
+    }
+    // Wraps midnight: e.g. 22:00 → 07:00.
+    return current >= window.startMinutes || current < window.endMinutes;
+}
+/**
+ * Compute the wall-clock ms for the END of the quiet window relative to
+ * `nowMs`. Used to defer `nextDueMs` until the operator's wake window
+ * opens.
+ */
+function endOfQuietWindowMs(nowMs, window) {
+    const current = minutesSinceMidnightInTz(nowMs, window.timezone);
+    let minutesUntilEnd;
+    if (window.startMinutes < window.endMinutes) {
+        // Same-day window: defer to today's end.
+        minutesUntilEnd = window.endMinutes - current;
+    }
+    else {
+        // Wraps midnight. We're inside iff current >= start OR current < end.
+        if (current >= window.startMinutes) {
+            minutesUntilEnd = 24 * 60 - current + window.endMinutes;
+        }
+        else {
+            minutesUntilEnd = window.endMinutes - current;
+        }
+    }
+    return nowMs + Math.max(60_000, minutesUntilEnd * 60_000);
+}
+function readQuietHours(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const obj = raw;
+    const startMinutes = parseHHMM(obj.start);
+    const endMinutes = parseHHMM(obj.end);
+    if (startMinutes === null || endMinutes === null)
+        return undefined;
+    const tz = typeof obj.timezone === "string"
+        ? obj.timezone.trim()
+        : typeof obj.tz === "string"
+            ? obj.tz.trim()
+            : "";
+    return {
+        startMinutes,
+        endMinutes,
+        ...(tz ? { timezone: tz } : {}),
+    };
+}
+function readHeartbeatBlock(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const hb = raw;
+    const intervalMs = typeof hb.intervalMs === "number" ? hb.intervalMs : undefined;
+    const sessionKey = typeof hb.sessionKey === "string" ? hb.sessionKey : undefined;
+    const enabled = typeof hb.enabled === "boolean" ? hb.enabled : undefined;
+    const quietHours = readQuietHours(hb.quietHours);
+    return {
+        ...(intervalMs !== undefined ? { intervalMs } : {}),
+        ...(sessionKey !== undefined ? { sessionKey } : {}),
+        ...(enabled !== undefined ? { enabled } : {}),
+        ...(quietHours ? { quietHours } : {}),
+    };
+}
+function readAgentHeartbeatConfig(cfg, agentId) {
+    const agents = cfg.agents;
+    const agentEntry = agents?.[agentId];
+    const agentHb = agentEntry && typeof agentEntry === "object" && "heartbeat" in agentEntry
+        ? readHeartbeatBlock(agentEntry.heartbeat)
+        : undefined;
+    const defaults = agents?.defaults;
+    const defaultHb = readHeartbeatBlock(defaults?.heartbeat);
+    // Per-agent overrides per-key; defaults fill the gaps. This matches how
+    // every other agents.defaults consumer in the codebase works.
+    if (!agentHb && !defaultHb)
+        return undefined;
+    const merged = {};
+    const intervalMs = agentHb?.intervalMs ?? defaultHb?.intervalMs;
+    if (intervalMs !== undefined)
+        merged.intervalMs = intervalMs;
+    const sessionKey = agentHb?.sessionKey ?? defaultHb?.sessionKey;
+    if (sessionKey !== undefined)
+        merged.sessionKey = sessionKey;
+    const enabled = agentHb?.enabled ?? defaultHb?.enabled;
+    if (enabled !== undefined)
+        merged.enabled = enabled;
+    const quietHours = agentHb?.quietHours ?? defaultHb?.quietHours;
+    if (quietHours)
+        merged.quietHours = quietHours;
+    return merged;
+}
+function listAgentIds(cfg) {
+    const agents = cfg.agents;
+    if (!agents || typeof agents !== "object")
+        return [];
+    const out = [];
+    for (const key of Object.keys(agents)) {
+        if (key === "defaults")
+            continue;
+        if (!key.trim())
+            continue;
+        out.push(key.trim());
+    }
+    return out;
+}
+export function createHeartbeatScheduler(deps) {
+    function scheduleNext() {
+        const state = getState();
+        if (state.stopped) {
+            if (state.timer)
+                clearTimeout(state.timer);
+            state.timer = null;
+            return;
+        }
+        if (state.agents.size === 0) {
+            if (state.timer)
+                clearTimeout(state.timer);
+            state.timer = null;
+            return;
+        }
+        const now = Date.now();
+        let earliest = Number.POSITIVE_INFINITY;
+        for (const agent of state.agents.values()) {
+            if (agent.nextDueMs < earliest)
+                earliest = agent.nextDueMs;
+        }
+        if (!Number.isFinite(earliest))
+            return;
+        const delay = Math.max(0, earliest - now);
+        if (state.timer)
+            clearTimeout(state.timer);
+        state.timer = setTimeout(() => {
+            void onTimerFire();
+        }, delay);
+        state.timer.unref?.();
+    }
+    async function onTimerFire() {
+        const state = getState();
+        state.timer = null;
+        if (state.stopped)
+            return;
+        const now = Date.now();
+        for (const agent of state.agents.values()) {
+            if (now < agent.nextDueMs)
+                continue;
+            // Quiet-hours suppression. When we wake inside the window, skip the
+            // fire and defer `nextDueMs` until the window's end — the operator
+            // gets one heartbeat at "wake up" time, not a backlog of suppressed
+            // fires hammering when they unsilence.
+            if (agent.quietHours && isInQuietWindow(now, agent.quietHours)) {
+                agent.nextDueMs = endOfQuietWindowMs(now, agent.quietHours);
+                log.debug("heartbeat suppressed (quiet hours)", {
+                    agentId: agent.agentId,
+                    nextDueMs: agent.nextDueMs,
+                });
+                continue;
+            }
+            try {
+                deps.onInterval({ agentId: agent.agentId, sessionKey: agent.sessionKey });
+            }
+            catch (err) {
+                log.warn("heartbeat interval callback threw", {
+                    agentId: agent.agentId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+            // Advance using the agent's phase so the schedule stays anchored
+            // rather than drifting on each tick.
+            agent.nextDueMs = computeNextDueMs(now + 1, agent.intervalMs, agent.phaseMs);
+        }
+        scheduleNext();
+    }
+    const scheduler = {
+        start: () => {
+            const state = getState();
+            state.stopped = false;
+            scheduleNext();
+        },
+        stop: () => {
+            const state = getState();
+            state.stopped = true;
+            if (state.timer)
+                clearTimeout(state.timer);
+            state.timer = null;
+        },
+        updateConfig: (cfg) => {
+            const state = getState();
+            const now = Date.now();
+            const nextAgents = new Map();
+            for (const agentId of listAgentIds(cfg)) {
+                const hb = readAgentHeartbeatConfig(cfg, agentId);
+                const intervalMs = hb?.intervalMs;
+                if (!intervalMs || !Number.isFinite(intervalMs) || intervalMs <= 0)
+                    continue;
+                // Audit 9 gap: per-agent kill-switch. Explicit `enabled: false`
+                // suppresses the agent's schedule entirely — useful for parking
+                // an agent without losing its interval config, and for the
+                // agents.defaults pattern where the default is to enable but
+                // one agent opts out.
+                if (hb?.enabled === false)
+                    continue;
+                const phaseMs = resolvePhaseMs(agentId, intervalMs);
+                const prev = state.agents.get(agentId);
+                const preserveSchedule = prev && prev.intervalMs === intervalMs && prev.phaseMs === phaseMs;
+                const nextDueMs = preserveSchedule
+                    ? prev.nextDueMs
+                    : computeNextDueMs(now, intervalMs, phaseMs);
+                // Wave L P2#5 — default sessionKey to the agent's canonical `:main`
+                // when config omits it. Without this, intervalMs-only configs
+                // produced an entry whose `sessionKey === undefined`, which the
+                // runner then skips (no session to gate / drain). Defaulting
+                // keeps the agent's primary FIFO ticking on schedule.
+                const effectiveSessionKey = hb?.sessionKey?.trim() || buildBrigadeMainSessionKey({ agentId });
+                nextAgents.set(agentId, {
+                    agentId,
+                    intervalMs,
+                    phaseMs,
+                    nextDueMs,
+                    sessionKey: effectiveSessionKey,
+                    ...(hb?.quietHours ? { quietHours: hb.quietHours } : {}),
+                });
+            }
+            state.agents.clear();
+            for (const [id, schedule] of nextAgents)
+                state.agents.set(id, schedule);
+            scheduleNext();
+        },
+        getScheduleSnapshot: () => {
+            const state = getState();
+            return Array.from(state.agents.values()).map((agent) => ({
+                agentId: agent.agentId,
+                intervalMs: agent.intervalMs,
+                nextDueMs: agent.nextDueMs,
+            }));
+        },
+    };
+    return scheduler;
+}
+/** Test-only — clear scheduler state. */
+export function resetHeartbeatSchedulerForTests() {
+    const state = getState();
+    if (state.timer)
+        clearTimeout(state.timer);
+    state.agents.clear();
+    state.timer = null;
+    state.stopped = false;
+}
+//# sourceMappingURL=heartbeat-scheduler.js.map

package/dist/agents/heartbeat-scheduler.js.map

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

package/dist/agents/heartbeat-wake.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Heartbeat wake planner.
+ *
+ * Brand-scrubbed lift of upstream's `src/infra/heartbeat-wake.ts`. Provides
+ * the wake-INTENT layer that sits in front of the heartbeat RUNNER
+ * (Step 14). Producers (`requestHeartbeatNow(...)`) call into this
+ * module; this module coalesces, priorities, schedules; eventually the
+ * registered handler (the runner from Step 14) is invoked once per
+ * coalesce window with one wake intent per target.
+ *
+ * Design choices preserved verbatim:
+ *
+ *   - **Singleton state** — one planner per JS realm (the wake state is
+ *     process-wide). Backed by `resolveGlobalSingleton` so test resets
+ *     can swap it cleanly.
+ *
+ *   - **Priority dedupe** — when two wake requests collide for the same
+ *     `(agentId, sessionKey)` target inside the coalesce window, the
+ *     higher-priority reason wins (RETRY=0 < INTERVAL=1 < DEFAULT=2 <
+ *     ACTION=3). On equal priority, the newer timestamp wins. Replaces
+ *     in place; never coalesces by *appending*.
+ *
+ *   - **Coalesce window** — 250ms default. New requests inside the
+ *     window collapse into the pending entry. Sliding window: a later
+ *     request can preempt an earlier-scheduled fire if its target's
+ *     priority demands sooner attention.
+ *
+ *   - **Retry cooldown** — a 1-second floor between handler invocations
+ *     when the runner reports `requests-in-flight`. The wake layer (NOT
+ *     the runner) owns the retry — keeps the back-off centralized so
+ *     no caller has to thread retry state.
+ *
+ *   - **Handler generation counter** — `setHeartbeatWakeHandler(null)`
+ *     bumps a generation; any disposer from a prior handler is a no-op
+ *     after the bump. Lets SIGUSR1 / config reload swap the handler
+ *     cleanly without ghost calls.
+ *
+ * What this module does NOT do:
+ *
+ *   - It does NOT enqueue work onto `command-queue.ts` — that's the
+ *     runner's job (Step 14).
+ *   - It does NOT call any LLM — purely a scheduling primitive.
+ *   - It does NOT inspect the session inbox — the runner peeks before
+ *     deciding whether to fire a turn.
+ */
+export type HeartbeatRunResult = {
+    status: "ran";
+    durationMs: number;
+} | {
+    status: "skipped";
+    reason: string;
+} | {
+    status: "failed";
+    reason: string;
+};
+export type HeartbeatWakeOptions = {
+    reason?: string;
+    agentId?: string;
+    sessionKey?: string;
+};
+export type HeartbeatWakeHandler = (opts: HeartbeatWakeOptions) => Promise<HeartbeatRunResult>;
+/**
+ * Register the heartbeat handler. Returns a disposer that clears the
+ * handler back to `null`. Calling `setHeartbeatWakeHandler(null)` (or
+ * the disposer) bumps a generation counter so any in-flight tasks
+ * stamped to the prior handler are dropped on completion.
+ *
+ * Replacing a non-null handler with a non-null handler clears stale
+ * timers + running flag — useful for SIGUSR1 / config reload paths
+ * that swap the runner mid-run.
+ */
+export declare function setHeartbeatWakeHandler(next: HeartbeatWakeHandler | null): () => void;
+export interface RequestHeartbeatOptions {
+    reason?: string;
+    coalesceMs?: number;
+    agentId?: string;
+    sessionKey?: string;
+}
+/**
+ * Queue a wake intent for the next handler fire. Coalesce + priority
+ * dedupe rules apply — see module doc.
+ *
+ * Returns nothing; failures (no handler registered) are silent — the
+ * intent stays queued and fires whenever a handler is registered.
+ */
+export declare function requestHeartbeatNow(opts?: RequestHeartbeatOptions): void;
+/** True iff there is at least one pending wake or a scheduled timer. */
+export declare function hasPendingHeartbeatWake(): boolean;
+/**
+ * Global enable/disable toggle. Brigade's heartbeat is on by default;
+ * the runner reads this flag and short-circuits to "skipped: disabled"
+ * when off. The toggle is in-memory only — set on boot from config,
+ * not persisted here.
+ */
+export declare function setHeartbeatsEnabled(enabled: boolean): void;
+export declare function areHeartbeatsEnabled(): boolean;
+/** Test-only — full reset (timers, pending, handler, enabled flag). */
+export declare function resetHeartbeatWakeStateForTests(): void;
+//# sourceMappingURL=heartbeat-wake.d.ts.map

package/dist/agents/heartbeat-wake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-wake.d.ts","sourceRoot":"","sources":["../../src/agents/heartbeat-wake.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAOH,MAAM,MAAM,kBAAkB,GAC3B;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExC,MAAM,MAAM,oBAAoB,GAAG;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE,oBAAoB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;AA+M/F;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,GAAG,MAAM,IAAI,CAuBrF;AAED,MAAM,WAAW,uBAAuB;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,uBAA4B,GAAG,IAAI,CAO5E;AAED,wEAAwE;AACxE,wBAAgB,uBAAuB,IAAI,OAAO,CAGjD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE3D;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,uEAAuE;AACvE,wBAAgB,+BAA+B,IAAI,IAAI,CAYtD"}